dsh-skill-compat-plus

dsh plugin --profile web add dsh-skill-compat-plus

dsh-skill-compat-plus




把 Claude Code / Codex / ZCode 的技能目录挂进 DeepSeek Harness（dsh）。 一个插件，让 dsh 直接看到你已有生态里的 agent skills——无需复制、无需迁移、改动即时生效。

它是什么

dsh 官方的技能发现只扫描 .dsh/skills、.agents/skills、~/.dsh/skills 等自有目录。而 Claude Code（~/.claude/skills）、Codex CLI（~/.codex/skills）、ZCode（~/.zcode/skills）各自维护着大量高质量技能。本插件以 SkillProvider 形式（ctx.skills.registerProvider）把这些目录作为只读来源挂进 dsh 的技能注册表：

• 模型可用：导入技能进入 skill 工具的目录（catalog），模型按需加载；
• 用户可斜杠调用：user-invocable 技能自动获得 dsh 原生的 /name 手势入口；
• 热更新：目录里新增/修改/删除技能文件，无需重启即可生效（chokidar + 存在性轮询）；
• 零侵入：只读挂载，不复制、不改写你的任何文件；卸载即恢复原状。

功能

• 三家来源默认全开，目录不存在时静默跳过：
• claude-code：~/.claude/skills（用户级）+ <项目根>/.claude/skills（项目级，按最近 .git 祖先探测）
• codex：~/.codex/skills（旧约定目录；Codex 新官方 ~/.agents/skills dsh 原生已扫，不重复挂载）
• zcode：~/.zcode/skills（用户级）+ <项目根>/.zcode/skills（项目级）
• frontmatter 字段映射（详见下表）：when_to_use → whenToUse、宽松布尔、Codex agents/openai.yaml 的 policy.allow_implicit_invocation 等
• 名称规范化：外来名不符合 dsh kebab-case 时自动 slug 化（如 _references → references、code_review → code-review），可关闭
• description 合成：Claude 允许缺省 description，而 dsh 必填——自动取正文首段合成（可关闭）
• 优先级体系：dsh 原生技能永远压过同名导入技能；项目级导入压过用户级导入
• 诊断聚合：无效文件、命名冲突等按问题集合变化输出 warn，不刷屏
• YAML 用官方同款 yaml 包解析——块标量（>-、|）、嵌套 metadata 都能正确处理

字段映射表

外来字段 · Claude Code · Codex · ZCode · 映射到 dsh

name · 可选（缺省取目录名） · 必填 · 可选（缺省取目录名） · 必填；缺省用目录名，不合规则 slug 化

description · 可选 · 必填 · 可选 · 必填；缺失时从正文首段合成（可关）

when_to_use · 有 · 无 · 有 · whenToUse（snake → camel）

disable-model-invocation · 有 · 无 · 无 · invocation.modelInvocable

user-invocable · 有 · 无 · 无 · invocation.userInvocable

agents/openai.yaml 的 policy.allow_implicit_invocation: false · 无 · 有 · 无 · invocation.modelInvocable: false

allowed-tools / disallowed-tools · 有 · 有（空格分隔） · 无 · 保留在 metadata（dsh 无对应物）

model / effort / hooks / paths / shell / argument-hint 等 · 有 · 无 · 无 · 保留在 metadata

license / compatibility · 有 · 有 · 容忍 · 保留在 metadata

metadata（map） · 有 · 有 · 有 · 原样保留

整个原始 frontmatter 会全量保真进 metadata，不做静默丢弃。

优先级（rank，越小越优先）

来源 · 目录 · rank · 语义

dsh 原生 project-dsh · <项目根>/.dsh/skills · 100 · 永远压过导入

dsh 原生 project-agents · <项目根>/.agents/skills · 200 · 永远压过导入

claude-code 项目级 · <项目根>/.claude/skills · 210 · 输给 dsh 原生项目级

zcode 项目级 · <项目根>/.zcode/skills · 220 · 同上

dsh 原生 custom · Config.customSkillDirs · 300 ·

extraDirs · 任意目录 · 300（可按目录覆盖） · 与官方 custom 同档

dsh 原生 user-dsh · ~/.dsh/skills · 400 ·

claude-code 用户级 · ~/.claude/skills · 450 · 输给 dsh 原生用户级

codex 用户级 · ~/.codex/skills · 460 ·

zcode 用户级 · ~/.zcode/skills · 470 ·

dsh 原生 user-agents / bundled · ~/.agents/skills / 内置 · 500 / 600 ·

同名技能裁决由 dsh 官方注册表完成（rank → provider 注册序 → list 内顺序），本插件只负责给出确定的 rank。

安装

方式 · 命令 / 操作

CLI（npm 包） · dsh plugin --profile <你的profile> add dsh-skill-compat-plus

桌面端 · 插件页安装 dsh-skill-compat-plus，或：ELECTRON_RUN_AS_NODE=1 "/d/DeepSeek Harness/DeepSeek Harness.exe" --expose-internals "D:/DeepSeek Harness/resources/app.asar/dsh/node_modules/@deepseek-ai/dsh-desktop-host/lib/cli.js" plugin --profile desktop add dsh-skill-compat-plus（Git Bash，先完全退出应用含托盘）

git 直装（始终最新 main） · dsh plugin --profile <你的profile> add git+https://github.com/shuxidemosheng/dsh-skill-compat-plus.git

本地 tgz · npm pack 后 dsh plugin --profile <你的profile> add file:D:/AIcoding/dsh-skill-compat-plus/dsh-skill-compat-plus-0.1.0.tgz

配置

配置写在 cordis.patch.yml 的 entry config 下（profile 层可覆盖，整体替换语义）：

键 · 默认 · 说明

providerName · skill-compat-plus · provider 注册名（runtime 为保留字，不可用）

sources.claude · true · boolean 或 { enabled?, project?, root?, rank? }

sources.codex · true · 同上

sources.zcode · true · 同上

extraDirs · [] · { path, label?, rank? }[]，任意额外技能目录

watch · true · 文件变化热更新

watchUsePolling · false · 网络盘/特殊文件系统上开启轮询监视

watchStabilityThresholdMs · 200 · awaitWriteFinish 稳定阈值

watchPollIntervalMs · 100 · awaitWriteFinish 轮询间隔

watchMaxProjects · 128 · 项目根监视 LRU 上限

slugifyNames · true · 关闭后不合规名直接 skip

synthesizeDescription · true · 关闭后缺 description 的技能直接 skip

未知配置键会直接报错（fail-fast，不做静默忽略）。

本地开发

# Git Bash
npm install
npm test              # vitest，32 个用例（含 Windows 路径、真实时序 watch 测试、与上游文法的对拍）
npm run build         # tsc d.ts + esbuild bundle（yaml/chokidar 为外部运行时依赖）
node scripts/smoke.mjs   # 用构建产物直接扫描本机真实技能目录并打印清单

安全

• 本插件只读外部技能目录：唯一的写操作是 chokidar/fs.watchFile 的监视句柄。
• 技能内容由 dsh 官方 skill 工具管线加载，本插件不执行任何技能内代码。
• 产物最小化：yaml/chokidar 作为运行时依赖（由 plugin-manager 安装进 profile），构建产物只含第一方代码——安全扫描面与攻击面都最小。
• Mimosa 深度扫描封印（2026-10-11，v0.1.0，最终产物）：
• 发布前复核：scanId scan-2026-10-11T10-22-46.363Z-046924c5dc3e，seal sha256:8b6abe1217fbf677d8f9577792cf63a89ba5c97b04f85c6ae67027340a0f93a7，findings 0，依赖风险 0
• seal: sha256:f35ddf0890c53725a25589f8515b20f3b13025d213f8901af52a28d2dc77ccf1
• findings 0，依赖风险 0。
• 历史记录：最初的 472KB 自包含产物曾报 6 条静态 advisory（scanId scan-2026-10-11T09-25-20.462Z-3a00d7a1835b，全部位于当时打包进去的上游闭包——yaml scalar 解析器、@deepseek-ai/schemastery、@deepseek-ai/dsh-skill 注册表内部，属静态污点分析对官方包内部实现的误报模式）。据此改为外部依赖方案后复扫归零。

已知限制

• Claude/ZCode 插件包内部的技能（~/.claude/plugins、~/.zcode/cli/plugins/cache 等）不在默认发现范围，可用 extraDirs 手动挂载；自动识别（.claude-plugin/plugin.json 等）留待后续版本。
• 项目级只扫描最近 .git 祖先一级（对齐 dsh 官方）；ZCode 式的 CWD→worktree 多级扫描不做。
• Claude Code 的嵌套 <subdir>/.claude/skills、--add-dir、企业托管目录不支持。
• `all

…(truncated)