前言¶

DSH 的理念是「一切皆插件」，用的时间长了，$DSH_HOME 下面会积累不少 skills、bundle 插件和市场能力。这些东西散落在不同路径，说明大多是英文 README，隔一段时间想找「哪个技能适合做某件事」，往往要翻目录、翻聊天记录。常见的应对有两种：写脚本把环境全量导出成清单，或者纯手工维护笔记。前者噪声大，后者费时间，而且都没有解决「条目来源是否可信、说明是否准确」的问题。

下面介绍 catalog-capabilities-zh。它走的是另一条路：默认精选模式，只把用户确认过的条目写进文档，为 skills、插件和市场能力维护一份有来源依据的中文说明目录。

这是什么¶

catalog-capabilities-zh 由 MeowTnT3r 维护，MIT 许可，定位是面向 Codex 与 DeepSeek Harness 的公开能力目录：编排当前 Agent 已有的可信安装器，为 skills、插件和市场能力维护一份有来源依据的中文说明目录。

对 DSH 用户来说，仓库根目录同时是一个 DSH bundle 插件，安装后注册同名 runtime skill，并把 CLI 切换为 --agent dsh 适配器。

设计上它不自己重写下载或安装逻辑。明确要求安装时，调用当前环境已有的可信安装器——Codex 的 skill-installer / 插件管理能力，或 DSH 的 dsh plugin；目标已经安装时，只核验并更新中文说明；只有链接而没有安装意图时，只做检查和介绍。

核心功能¶

1、精选模式为默认。不自动全量收录当前环境，只有用户确认的条目才进入文档。扫描现有环境只作为发现辅助，列出 skills、插件和市场路径，以及「技能包 → 子技能」的关系，用户挑选后再写入；render --all 或 --catalog-mode full 才是显式的全量收录。

2、add-source 支持手动登记本地目录、GitHub、npm 或内联 JSON。

3、文档模式两种：package（默认，按技能包组织，子技能在包详情中列出）与 individual（子技能单独进入功能分类）。

4、条目可按中文名、原始名、标签、别名、使用范围或触发词搜索；也支持自然语言筛选与推荐已收录的 skill、插件或市场能力。筛选是只读操作，只有用户明确要求安装时才进入安装编排。

5、--agent dsh adapter 会扫描 $DSH_HOME/skills 以及 $DSH_HOME/profiles/<profile>/node_modules 中的 DSH bundle 插件。

6、inspect-link 只读取公开 GitHub 仓库的 README 与 SKILL.md 元数据，不执行仓库代码；discover-links 只读发现外部分组链接，用户确认后可经 --linked-root 登记为独立根目录。

7、内嵌 Python CLI 仅需 Python 3.8+，且只使用标准库。

安装与启用¶

要求 pnpm 在 PATH 上（dsh plugin 会转发给 pnpm），engines 要求 node >=18、dsh >=0.1.0-rc.6。执行下面的命令把仓库作为插件装进 web profile：

dsh plugin --profile web add github:MeowTnT3r/catalog-capabilities-zh

安装后重启 dsh web，在会话里输入 $catalog-capabilities-zh，或直接用自然语言要求扫描、筛选或维护中文能力目录。

插件内嵌的 Python CLI 只用标准库，Python 3.8–3.10 会自动使用内置 TOML 回退解析器，不要求安装 Python 3.11。

Windows 上要注意一点：DSH 0.1.0-rc.6 在 Windows 转发本地文件参数时，含空格路径可能被拆成多个 pnpm 参数。项目位于这类路径时，不要用 dsh plugin --profile web add .，先 npm pack，把生成的 .tgz 移到无空格路径再安装：

npm pack
# 将生成的 catalog-capabilities-zh-<version>.tgz 移到无空格路径后：
dsh plugin --profile web add C:\dsh-pack\catalog-capabilities-zh-1.0.0.tgz

GitHub、npm 包名以及本身不含空格的本地路径不受这个 rc.6 启动器问题影响，正式安装优先使用前面的 GitHub 命令。

典型用法¶

会话里最常见的用法是自然语言筛选。例如：

$catalog-capabilities-zh 帮我筛选前端技能
$catalog-capabilities-zh 帮我找适合前端重构和 UI 设计的技能
$catalog-capabilities-zh 有哪些能力可以生成图片或处理 PDF？
$catalog-capabilities-zh 从现有技能里推荐几个适合调试复杂 Bug 的，并说明区别

筛选时会综合中文名称、原始标识、功能分类、标签、别名、使用范围、能力效果和典型触发词，返回匹配项的安装状态、适用场景和主要限制。默认只搜已选中的精选条目，search <关键词> --all 搜索全部扫描结果。

直接操作 CLI 时，先发现环境，再完成配置：

python skills/catalog-capabilities-zh/scripts/catalog_capabilities.py discover --dsh-home ~/.dsh --format json

python skills/catalog-capabilities-zh/scripts/catalog_capabilities.py configure --agent dsh --dsh-home ~/.dsh --dsh-profile web --config ~/.dsh/catalog-capabilities-zh/config.json --catalog ~/.dsh/CAPABILITIES.zh-CN.md

只想了解某个仓库时，用 inspect-link 检查公开仓库元数据，不执行任何代码：

python skills/catalog-capabilities-zh/scripts/catalog_capabilities.py inspect-link --url https://github.com/owner/repo --format json

系统/内置技能默认不收录。用户显式要求时，先 scan --include-system，再 select --add <id> 收录。

工作流程的边界是明确的：明确要求安装并提供目标时，编排可信安装器、验证后写说明；目标已安装时，只核验并撰写说明；只给链接没有安装意图时，只做检查和介绍。多 skill 仓库会先展示候选清单并要求选择，不会默认全部安装；已存在的 skill 不会被自动覆盖，检测到远程差异时只提示更新。

配置与文件位置¶

首次配置会在系统配置目录保存 config.json 和 state.<profile>.json：

• Windows：%APPDATA%\catalog-capabilities-zh\
• macOS：~/Library/Application Support/catalog-capabilities-zh/
• Linux：${XDG_CONFIG_HOME:-~/.config}/catalog-capabilities-zh/

设置 CAPABILITY_CATALOG_CONFIG 可以覆盖配置文件位置。profile 只记录扫描根目录、目录文档位置和选项，不保存账号或令牌。

DSH runtime skill 默认把配置放在 $DSH_HOME/catalog-capabilities-zh/config.json，手册默认放在 $DSH_HOME/CAPABILITIES.zh-CN.md。

适用场景与注意¶

适合同时维护较多 skills 和插件、希望沉淀一份中文说明目录的 DSH 用户；也适合「先看介绍再决定装不装」的场景——只给链接时它只读仓库元数据做检查和介绍，不会替你按下安装键。

安全边界需要清楚：

• GitHub README 和第三方 metadata 都作为不可信资料读取；不执行仓库内脚本、README 命令或未知安装程序。
• 安装仍受 Agent 的联网、全局目录写入和账号权限审批约束。
• 扫描只进入用户确认的根目录；子级链接先发现、后确认，不会被静默跟随。
• 目录更新使用文件锁、原子替换和单份备份。

和所有 DSH 插件一样，插件以当前 dsh 进程的权限运行，安装前建议先浏览源码和许可证，确认符合自己的使用要求。

小结¶

catalog-capabilities-zh 的价值在于把「装了什么、能干什么、来自哪里」沉淀成一份自己确认过的中文目录，同时不越权替用户做安装决定。项目属于社区作品，与 DeepSeek、幻方没有官方从属关系。

• 目录页：https://www.skillhub.cn/plugins/MeowTnT3r/catalog-capabilities-zh
• GitHub：https://github.com/MeowTnT3r/catalog-capabilities-zh