更新时间：2026-08-21 16:21:28 | 阅读：39 | 收藏：0 收藏 # Windows 使用指南 > **读者**：已从产品页下载 Custom-Pack-Tool 官方程序的客户或客户侧运维。 > **不包含**：源码编译、`build.sh` 打安装包、上传发版——那些是厂商交付流程。 ## 你需要准备什么 | 项目 | 说明 | |------|------| | 系统 | Windows 10/11 或 Server（64 位） | | 程序 | 产品页提供的 Windows 官方可执行文件 | | 权限 | 普通用户即可打包；注册/卸载右键菜单可能需要管理员权限 | | 网络 | 检查更新时需要联网；日常打包可离线 | ## 安装与启动 1. 从产品页下载 Windows 版官方程序，放到固定目录（例如 `D:\tools\Custom-Pack-Tool\`）。 2. 双击运行可执行文件，进入交互主菜单；也可在命令行中运行该程序。 3. 查看帮助： ```text 程序名.exe -h ``` 建议不要每次从临时下载目录运行，以免路径变更后右键菜单失效。 ## 主菜单常用项 | 选项 | 作用 | 说明 | |------|------|------| | `1` | 选择配置文件打包 | 程序可用时可选 | | `2` | 注册 Windows 右键菜单 | 部分环境下可用 | | `3` | 卸载 Windows 右键菜单 | 与注册对应 | | `0` | 退出 | — | 若某项提示暂不可用，按产品页或供应商交付说明处理即可，帮助中心不展开该流程。 ## 注册右键菜单 在主菜单选 `2`，将注册「Custom-Pack」右键项。之后可对 `.cspk.*.json` 配置文件右键选择该项，直接按该配置打包。 注意： - 仅识别本工具配置文件名：`.cspk.` 开头且以 `.json` 结尾（如 `.cspk.default.json`）。 - 对普通 `a.json` 右键不会当作本工具配置。 - 换电脑或移动了程序路径后，请重新注册一次右键菜单。 卸载：主菜单选 `3`。 ## 命令行快速用法 在程序所在目录或已加入 PATH 的情况下： ```text 程序名.exe 启动交互菜单 程序名.exe -h 显示帮助 程序名.exe --update 检查并下载最新版本 程序名.exe .cspk.default.json 使用指定配置直接打包 ``` ## 验收清单 - [ ] 双击可进入主菜单，版本信息正常显示 - [ ] 主菜单 `1` 能选到配置并打出 zip - [ ]（可选）注册右键后，对 `.cspk.*.json` 右键打包成功 ## 常见问题 | 现象 | 处理 | |------|------| | 某功能提示暂不可用 | 按产品页或供应商说明处理；勿在公开渠道粘贴密钥类信息 | | 右键没有 Custom-Pack | 确认已执行过菜单 `2`；必要时以管理员重新注册 | | 右键后提示仅支持 `.cspk.*.json` | 配置文件名不符合规则，请先在菜单中新建或改名 | | 打包失败 / 找不到文件 | 检查配置中 `include` 路径相对 `base_dir` 是否存在 | 相关文档： - [配置文件说明](/doc-39) - [打包操作指南](/doc-40) 评论区
