ArcGIS Pro ATBX 工具箱加密

要解决什么问题

发布 ArcGIS Pro 自定义工具箱时，.atbx 里内嵌的 Script Tool 往往带着明文 tool.script.execute.py。只要别人解压或浏览工具箱结构，源码就会被直接看到。GUI 里逐个点加密既慢，又容易漏掉 validate 脚本或搞错密码策略。本技能把流程锁在 .atbx 专用管线：不引导你去改 .pyt、不默认走 arcpy.EncryptPYT，也不靠「点界面点到手酸」完成批量发布。

技能如何工作

在 Windows + ArcGIS Pro 自带 Python 环境下，通过捆绑脚本调用 AfCore.dll 原生加密入口，批量处理内嵌脚本：

• scripts/batch_encrypt_atbx.py：对 tool.script.execute.py 加密，可按需包含 tool.script.validate.py
• scripts/inspect_atbx.py：查看单个 .atbx 或对比明文/加密归档结构
• scripts/validate_atbx_runtime.py：用 ArcPy 导入加密工具箱、列出工具，可选冒烟执行
• scripts/doctor_atbx_environment.py：检查 Python、arcpy、AfCore 导出是否就绪

典型顺序是：确认输入全是 .atbx（或含 .atbx 的文件夹）→ 环境不明先跑 doctor → 结构不明先 inspect → 按你的口令策略加密 → 再 inspect + ArcPy 验证 → 汇报输出路径、口令来源方式、跳过项与残留风险。

口令规则写得很硬：你明确给了口令就用你的；没给则用 --generate-password --no-password-prompt 在内存里生成高熵口令，不打印、不存储、输出里也不可恢复——这是源码保护发布，不是密钥管理系统。

适用边界与注意点

• 工具若只 外链 .py、没有内嵌 tool.script.execute.py，需要先走发布流程把脚本嵌进 .atbx，否则本技能无法替你「凭空加密」。
• 加密后 pw 必须留在 tool.content，不要手删或手改；ArcGIS Pro 靠它识别加密载荷。
• 已有 pw 的工具箱默认跳过；要重加密需显式 --force。覆盖发布物要用户明确接受才用 --overwrite；原地替换建议 --in-place 并保留备份。
• 若报告里 password_source 为 generated:undisclosed，不要声称能找回口令——工具仍可运行，但带口令的源码查看/编辑路径被刻意关闭。
• 成功标准包括：加密脚本出现 ArcGIS 识别的密文头（如 00022e68）、ArcPy 能导入、代表性工具在安全参数下可跑，且发布包中排除未加密源码与备份。