dh-ai cli 数字海南 AI 命令工具

AI 工具

面向研发团队的命令行 AI 工具，支持技能调用、文档处理和研发辅助流程。

概述

@szhn/ai-cli 使用文档

数字海南 AI 辅助开发工具集，提供统一的命令行入口，集成多个 AI 辅助开发子模块。

概述

npm 包名：@szhn/ai-cli
CLI 名称：dh-ai
兼容命令：ai-cli（仅供旧脚本继续使用，新文档统一使用 dh-ai）

子命令列表

子命令	说明
`dh-ai info`	查看 dh-ai、已安装 Skills 和插件的版本与状态
`dh-ai upgrade`	一键升级 dh-ai 和已安装的 Skills；`dh-ai upgrade <skill>` 只升级指定 Skill
`dh-ai skill`	AI 编码 skills 管理——为项目初始化/升级/删除预设的 AI 编码规范
`dh-ai agent`	AI Agent 管理——为项目初始化/升级/删除预设的 AI Agent 角色
`dh-ai files`	规范文档管理——将预设 Markdown 规范文件安装到项目

安装

没有 dh-ai 时，先安装 Node.js 长期支持版，重新打开终端，运行 node -v 和 npm -v 确认可用，再按下面步骤安装。安装后运行 dh-ai --version 验证。

1) 配置私有源

bash

npm config set @szhn:registry https://npmmirror.digitalhainan.com.cn/

2) 安装

全局安装（推荐）：

bash

npm i -g @szhn/ai-cli@latest

全局安装后才能在任何目录直接使用 dh-ai，WorkBuddy 等 AI 工具也能调用，并且可以用 dh-ai upgrade 一键升级。

只想固定在某个前端项目里使用时，也可以装成项目依赖，之后用 npx dh-ai 执行；这种方式不能使用 dh-ai upgrade，需要在项目里自行升级依赖：

bash

npm i -D @szhn/ai-cli@latest

`upgrade` — 一键升级

bash

dh-ai upgrade

先把 dh-ai 升到最新版本，再更新用户目录下已安装的 Skill 和 WorkBuddy 插件，在哪个目录运行都可以。Skill 随 dh-ai 一起发布，所以 Skill 修复了问题，也是运行这一条命令更新。

只升级某一个 Skill：

bash

dh-ai upgrade dh-document-review

会同时更新用户目录里的这个 Skill，以及当前目录里用 --scope project 装的这个 Skill。项目级安装只在所在目录可见，dh-ai upgrade 不会自动找到别的目录里的安装，需要进入那个项目再运行。

只查看将会升级哪些内容：

bash

dh-ai upgrade --dry-run

从 0.10.24 及更早版本升级

旧版本不认识 dh-ai upgrade <skill> 的 Skill 参数，第一次运行只会升级 dh-ai 本身，升级完成后再运行一次同样的命令即可。

`info` — 查看安装信息

bash

dh-ai info

输出包括：

dh-ai 当前版本、最新版和更新状态
已安装 Skills 的来源版本、安装位置、使用工具和内容状态
WorkBuddy dh-ai-design 插件的当前版本、最新版和启用状态

Skills 目前没有独立语义版本号：内置 Skill 显示随 dh-ai 发布的版本，远程 Skill 显示内容仓库版本。网络不可用时仍会显示本机信息，并标记为尚未联网确认。

skill 子命令

AI 编码 skills 管理工具，可一键将预设编码规范写入项目的 AI 工具目录。

支持模块：common、frontend、backend、ui、office
支持工具：Codex、Qoder、WorkBuddy、Lingma、Trea、Claude、Cursor、GitHub Copilot 等

`skill init` — 初始化 skills

在项目目录执行：

bash

dh-ai skill init

已知完整名称时可以直接安装，不进入选择流程：

bash

dh-ai skill init ui/dh-ui-mastergo-vibe
dh-ai skill init frontend/dh-fe-mastergo
# 以下三个需要 dh-ai 0.10.23 或更高版本
dh-ai skill init frontend/vue-doctor
dh-ai skill init common/dh-cm-qa-flow
dh-ai skill init office/dh-document-review

画布生成设计稿：ui/dh-ui-mastergo-vibe（依赖 mastergo-vibe-mcp，说明见在 MasterGo 里生成设计稿）
设计稿转前端代码：frontend/dh-fe-mastergo（依赖 mastergo-magic-mcp，说明见 MasterGo 设计稿转 Vue）
Vue 项目健康检查：frontend/vue-doctor（说明见 vue-doctor）
改完代码测一测：common/dh-cm-qa-flow（按需求和 git 改动整理测试方案，用真实浏览器逐条检查页面并生成带截图的中文报告；需 Node.js 18+ 和 Git，见 dh-cm-qa-flow）
智能操作手册生成：office/dh-office-operation-manual（说明见办公提效）
文档内容检查：office/dh-document-review（需要 dh-ai 0.10.25+ 和 Python 3.9+；默认 19 个复核维度，CMT 65 词显式选用。格式、隐私和当前限制见使用说明）

Qoder 使用 Magic 读稿转 Vue 时，推荐一键安装并配置：

bash

dh-ai skill init frontend/dh-fe-mastergo --tool qoder --scope user

这条命令会从 dh-ai 安装内置的 dh-fe-mastergo 和 Magic MCP，写入 Qoder 配置，并在首次配置时提示输入一次个人 Token；不需要访问公司 GitLab。需要从头清理时执行：

bash

dh-ai skill remove --skill frontend/dh-fe-mastergo --tool qoder --scope user

删除会同时清理该 Skill 和由它自动写入的 Magic MCP 配置；旧版 dh-ai mastergo magic setup/remove 仍作为兼容命令保留。

直接安装会识别本机已有的 AI 工具，并默认安装到用户目录，所有项目都能用，dh-ai upgrade 也会自动更新。可用 --tool 指定目标。

--scope project 会改为只装到当前目录：换个目录就用不到，dh-ai upgrade 也不会自动更新它，需要进入该目录运行 dh-ai upgrade <skill>。只有 Skill 必须跟着某个项目走时才用它；不要在 WorkBuddy 里用，WorkBuddy 每个任务都会新建目录（dh-ai 0.10.26 起在这种目录里安装会给出提示）。

交互流程：

选择要安装的模块（common / frontend / backend / ui / office）
选择具体的 skills
选择目标 AI 工具
选择安装位置：当前工作目录（仅对当前项目生效，默认）或用户目录（对所有项目全局生效）
若存在同名文件，提示是否覆盖

说明：

如果项目根目录缺少 DESIGN.md，命令会给出提醒，请按需运行 dh-ai files init 安装规范文件。
MasterGo 两条链路：
- 写画布 → dh-ui-mastergo-vibe
- 读稿写 Vue → dh-fe-mastergo

预演模式（不实际写入）：

bash

dh-ai skill init --dry-run

`skill update` — 升级已安装的 skills

交互选择升级：

bash

dh-ai skill update

按模块升级：

bash

dh-ai skill update --module frontend

升级单个 skill：

bash

dh-ai skill update --skill frontend/dh-fe-performance

预演模式：

bash

dh-ai skill update --dry-run

`skill remove` — 删除已安装的 skills

交互模式（先选模块，再选模块内 skills）：

bash

dh-ai skill remove

按模块删除：

bash

dh-ai skill remove --module backend

删除单个 skill：

bash

dh-ai skill remove --skill backend/dh-be-apione-usage

预演模式：

bash

dh-ai skill remove --dry-run

`skill list` — 列出 skills

列出所有可用 skills（已安装的用 ✔ 标绿）：

bash

dh-ai skill list

只显示当前项目已安装的 skills：

bash

dh-ai skill list --installed

`skill status` — 检查版本状态

检查已安装的 skills 是否有更新可用，逐一对比本地文件与最新源文件内容：

bash

dh-ai skill status

输出示例：

  ✔  common/git-commit        claude   已是最新
  ✗  backend/code-generator   cursor   有更新可用  → dh-ai skill update
  !  ui/design-system         github   源文件缺失（skill 包版本过旧）

状态说明：

状态	含义
`✔ 已是最新`	本地文件与包内源文件一致
`✗ 有更新可用`	内容存在差异，运行 `dh-ai skill update` 升级
`! 源文件缺失`	当前安装的 `@szhn/ai-cli` 版本不包含此 skill，请升级包

模块说明

模块	说明
`common`	通用规范（代码风格、Git 提交等）
`frontend`	前端开发规范
`backend`	后端开发规范
`ui`	UI/UX 设计规范
`office`	办公提效能力（操作手册、文档生产等）

文件路径规则

skills 安装后按以下结构写入目标目录：

text

{tool-dir}/skills/{skill-id}/SKILL{ext}

AI 工具	目录	文件扩展名
Agent	`.agents/skills`	`.md`
Lingma	`.lingma/skills`	`.md`
Trea	`.trea/skills`	`.md`
Claude	`.claude/skills`	`.md`
Cursor	`.cursor/skills`	`.md`
GitHub Copilot	`.github/skills`	`.md`

示例：

.github/skills/dh-fe-performance/SKILL.md
.cursor/skills/dh-cm-code-style/SKILL.md
.claude/skills/dh-be-apione-usage/SKILL.md

agent 子命令

AI Agent 管理工具，可将预设角色说明安装到项目或用户目录。

支持工具：Agent、Lingma、Trea、Claude、Cursor、GitHub Copilot

`agent init` — 初始化 agents

在项目目录执行：

bash

dh-ai agent init

交互流程：

选择要安装的 agents
选择目标 AI 工具
选择安装位置：当前工作目录（仅对当前项目生效，默认）或用户目录（对所有项目全局生效）
若存在同名文件，提示是否覆盖

预演模式（不实际写入）：

bash

dh-ai agent init --dry-run

`agent update` — 升级已安装的 agents

交互选择升级：

bash

dh-ai agent update

升级单个 agent：

bash

dh-ai agent update --agent frontend-developer

预演模式：

bash

dh-ai agent update --dry-run

`agent remove` — 删除已安装的 agents

交互删除：

bash

dh-ai agent remove

删除单个 agent：

bash

dh-ai agent remove --agent backend-developer

预演模式：

bash

dh-ai agent remove --dry-run

`agent list` — 列出 agents

列出所有可用 agents（已安装的用 ✔ 标绿）：

bash

dh-ai agent list

只显示当前项目已安装的 agents：

bash

dh-ai agent list --installed

`agent status` — 检查版本状态

检查已安装的 agents 是否有更新可用：

bash

dh-ai agent status

状态说明与 skill status 一致：

状态	含义
`✔ 已是最新`	本地文件与包内源文件一致
`✗ 有更新可用`	内容存在差异，运行 `dh-ai agent update` 升级
`! 源文件缺失`	当前安装的 `@szhn/ai-cli` 版本不包含此 agent，请升级包

文件路径规则

agents 安装后按以下结构写入目标目录：

text

{tool-dir}/agents/{agent-id}{ext}

AI 工具	目录	文件扩展名
Agent	`.agents/agents`	`.md`
Lingma	`.lingma/agents`	`.md`
Trea	`.trea/agents`	`.md`
Claude	`.claude/agents`	`.md`
Cursor	`.cursor/agents`	`.md`
GitHub Copilot	`.github/agents`	`.md`

示例：

.github/agents/frontend-developer.md
.claude/agents/technical-architect.md

files 子命令

规范文档管理工具，可将包内预设的 Markdown 规范文件（如设计规范、开发规范）一键安装到项目目录。

`files list` — 列出可用文件

bash

dh-ai files list

输出示例：

  ◦  DESIGN.cn.md              设计规范 — Rock 设计体系（数字海南）
  ◦  DESIGN.md                 Design System — Rock Design System (Digital Hainan)

`files init` — 安装到项目

交互式选择文件并安装（会询问目标目录）：

bash

dh-ai files init

直接指定目标目录（跳过询问）：

bash

dh-ai files init --output docs

预演模式（不实际写入）：

bash

dh-ai files init --dry-run

交互流程：

勾选要安装的 Markdown 文件（默认全选）
输入目标目录（相对项目根目录，留空则写入根目录）
若存在同名文件，提示是否覆盖

运行要求

Node.js >=16.0.0

安装

安装 dh-ai cli

配置公司 npm 源并全局安装最新版。

npm config set @szhn:registry https://npmmirror.digitalhainan.com.cn/
npm i -g @szhn/ai-cli@latest

GitLab

详细信息

类型: 命令行工具
入口: GitLab

@szhn/ai-cli 使用文档 ​

概述 ​

子命令列表 ​

安装 ​

1) 配置私有源 ​

2) 安装 ​

upgrade — 一键升级 ​

info — 查看安装信息 ​

skill 子命令 ​

skill init — 初始化 skills ​

skill update — 升级已安装的 skills ​

skill remove — 删除已安装的 skills ​

skill list — 列出 skills ​

skill status — 检查版本状态 ​

模块说明 ​

文件路径规则 ​

agent 子命令 ​

agent init — 初始化 agents ​

agent update — 升级已安装的 agents ​

agent remove — 删除已安装的 agents ​

agent list — 列出 agents ​

agent status — 检查版本状态 ​

文件路径规则 ​

files 子命令 ​

files list — 列出可用文件 ​

files init — 安装到项目 ​

运行要求 ​

@szhn/ai-cli 使用文档

概述

子命令列表

安装

1) 配置私有源

2) 安装

`upgrade` — 一键升级

`info` — 查看安装信息

skill 子命令

`skill init` — 初始化 skills

`skill update` — 升级已安装的 skills

`skill remove` — 删除已安装的 skills

`skill list` — 列出 skills

`skill status` — 检查版本状态

模块说明

文件路径规则

agent 子命令

`agent init` — 初始化 agents

`agent update` — 升级已安装的 agents

`agent remove` — 删除已安装的 agents

`agent list` — 列出 agents

`agent status` — 检查版本状态

文件路径规则

files 子命令

`files list` — 列出可用文件

`files init` — 安装到项目

运行要求