智能操作手册生成 ​

dh-office-operation-manual 用来把一个网页、一个本地运行项目，或用户提供的截图和操作步骤整理成可交付的操作手册。

它不是固定的网页测试脚本。它先了解页面和用户要写的范围，再生成一章样稿，用户确认后才批量生成完整手册。

能做什么 ​

• 根据网址或本地项目梳理菜单、页面和操作步骤；
• 用实际页面截图说明操作；
• 隐藏截图中的系统 Logo；
• 将截图和正文中的系统名称替换成用户确认的名称；
• 遮盖手机号、账号、邮箱、IP、Token 等敏感信息；
• 生成 Markdown、Word、截图和校验报告；
• 没有自动化浏览器时，接收人工截图、录屏或操作说明。

默认只读，不新增、修改、删除、审批、导入或发布业务数据。

安装 ​

1. 准备 Node.js 环境 ​

首次使用请先安装 Node.js 长期支持版，要求 Node.js 20 或更高版本。安装后重新打开终端，检查 Node.js 和 npm 是否可用：

node -v
npm -v

2. 安装或升级 dh-ai CLI ​

CLI 的 npm 包名是 @szhn/ai-cli，安装后的命令是 dh-ai，不是 dh-cli。以下命令全局安装 CLI，不会修改业务项目依赖；已安装的用户也可用同一命令升级。

旧版可能不识别 office 模块，并误报 skill 名称格式应为 <module>/<id>：

npm install -g @szhn/ai-cli@latest --registry=https://npmmirror.digitalhainan.com.cn/
dh-ai --version

如果使用 nvm，切换 Node 后可能命中不同的全局 CLI。请在执行安装命令的同一终端确认版本；升级 CLI 不需要修改业务项目依赖。

如果提示 npm: command not found，请先完成第 1 步。如果无法访问公司 npm 源，请检查公司网络或 VPN 连接。dh-ai --version 正常输出版本号后，再继续安装 Skill。

3. 安装 Skill ​

在终端执行，在哪个目录执行都可以：

dh-ai skill init office/dh-office-operation-manual

Skill 会装到用户目录，并自动装给本机已有的 WorkBuddy、Qoder、Cursor 等工具，之后每个项目、每个 WorkBuddy 任务都能直接用。只想装给 Qoder：

dh-ai skill init office/dh-office-operation-manual --tool qoder

指定其他客户端时，把 qoder 换成对应工具名称。安装完成后，完全退出并重新打开当前 AI 工具。

不建议加 --scope project：装在某个项目目录里的 Skill 换个目录就用不到，dh-ai upgrade 也不会更新它；WorkBuddy 每个任务都会新建目录，问题更明显。

4. 验证安装 ​

检查安装状态，确认列表中包含 office/dh-office-operation-manual：

dh-ai skill status

升级或删除 Skill ​

升级 dh-ai 和所有已装的 Skill：

dh-ai upgrade

删除：

dh-ai skill remove --skill office/dh-office-operation-manual

使用方式 ​

安装后直接描述目标即可，例如：

根据 https://example.com 生成一份操作手册。
系统名称改为“综合管理平台”，截图隐藏 Logo，先生成一章样稿。

本地项目：

根据当前项目生成操作手册。
先读取项目启动说明，启动前先询问我，默认只读。

也可以只提供素材：

我会提供截图和操作步骤，请整理成 Word 和 Markdown 操作手册。
系统名称改为“综合管理平台”，并遮盖账号、手机号和邮箱。

Skill 会先确认什么 ​

在打开页面、启动项目或批量截图之前，Skill 会先返回确认单。至少包括：

• 系统正式名称；
• 是否修改正文和截图中的旧名称；
• Logo 是隐藏、替换还是保留；
• 需要编写的模块和用户角色；
• 脱敏内容；
• 是否允许写操作，默认只读；
• 输出格式和参考文档。

系统名称没有提供时，Skill 不会从 URL、项目名或页面 Logo 中猜测。

确认摘要类似下面这样：

我准备按以下规则生成：
- 系统名称：综合管理平台
- 截图：隐藏 Logo，正文和截图一起替换旧名称
- 数据：只读，不提交表单
- 范围：首页、查询、详情
- 输出：Word、Markdown、处理后截图

请回复“确认”，或直接修改其中一项。

两次确认 ​

第一次确认 ​

确认数据源、系统名称、Logo、脱敏、模块范围和写操作权限。没有确认记录时不开始批量截图。

第二次确认 ​

Skill 先完成一个代表性模块的样稿。你需要确认：

• 系统名称替换效果；
• Logo 是否已经处理；
• 敏感信息遮盖范围；
• 截图大小和标注方式；
• 文字详细程度和文档排版。

确认样稿后，Skill 才会继续生成其他章节。

浏览器要求 ​

Skill 会按当前环境选择可用的浏览器工具：

1. AI 工具已经提供的浏览器或 MCP；
2. 已安装的 ego-browser；
3. 用户确认后安装的 Playwright；
4. 人工截图和操作说明模式。

没有浏览器时不会伪造操作结果。只能根据用户提供的素材生成，并把章节状态标记为“用户提供”或“未验证”。

Playwright 是可选依赖。只有用户确认后才安装 npm 依赖和 Chromium。登录、验证码、扫码和二次确认由用户完成，登录状态不会写入交付文档。

交付目录 ​

operation-manual-output/
├── confirmation.json
├── inventory.md
├── operation-manual.md
├── operation-manual.docx
├── validation-report.json
├── README.md
└── screenshots/

Word 文档会参考用户提供的手册排版，但不会把原手册正文、Logo、页眉、页脚或元数据复制进共享 Skill。

注意事项 ​

• 原始未脱敏截图只放在临时目录，不直接交付；
• Canvas、图片文字或跨域 iframe 无法可靠改名时，Skill 会停下来请求确认；
• 无权限、没有数据或无法执行的功能标记为“受阻”或“未验证”；
• 不要把账号、密码、Cookie、Token 或真实业务数据放进操作手册；
• 生产环境默认只读，写操作必须单独确认。