dsh-reverse-skill

安装：请从 GitHub 安装，不要从 npm 安装。 npm registry 上的 @dhicoc/dsh-reverse-skill 停留在 1.0.x，其 peer 依赖（@deepseek-ai/dsh-skill ^0.0.1-rc.1）与 DSH 0.2.0-rc.2 不兼容，从 npm 安装会被安装器判为「不兼容，可能导致崩溃」。本仓库 main 分支始终是与当前 DSH 兼容的版本。

安装命令：dsh plugin add github:dhicoc/dsh-reverse-skill

reverse-skill 的完整 DeepSeek Harness（dsh）插件版。 把上游 zhaoxuya520/reverse-skill（27k★，MIT）全部 88 个 SKILL.md 原样封装成一个 dsh Cordis 插件，随包分发、随插件加载，无需手动维护候选清单。

---

适用范围（请遵守）

本仓库内容仅用于 授权的 逆向工程、渗透测试与安全研究。使用者须确保对目标系统拥有合法授权。一切未授权行为与本仓库无关。

本包包含具有合法安全用途、同时也可能被滥用的内容（渗透测试技术、参考资料与辅助脚本），属 npm 所称的 dual-use（军民两用）内容。仓库根目录的 DISCLOSURE 文件对此作了完整说明。

---

目录结构

dsh-reverse-skill/
├── src/
│   └── index.ts                 # 数据驱动的 Cordis 插件：递归扫描并注册全部 SKILL.md
├── skills/                      # 46 个领域技能（上游 skills/ 1:1 复制）
│   ├── SKILL.md                 # 路由技能 reverse-skill-router（上游根 SKILL.md）
│   ├── pentest-tools/           # 含嵌套子技能 src-hunter 等
│   └── reverse-engineering/     # 含嵌套子技能 dsl-vm-reverse 等
├── CTF-Sandbox-Orchestrator/    # 42 个 CTF 赛道技能
├── port.py                      # 归一化脚本（上游 → 本仓库的搬运/前导matter修正）
├── package.json
├── tsconfig.json
├── DISCLOSURE                   # 双用途内容声明（内容与用途说明）
└── LICENSE                      # MIT（与上游一致）

相对路径：src/index.ts 通过 fileURLToPath(new URL('../skills', import.meta.url)) 定位资源（编译后 lib/index.js 同样成立，因为 skills/ 与 lib/ 同属包根目录的相邻子目录）。注意这里不能再套一层 dirname()——../skills 这个 URL 已经指向目录本身，多套 dirname 会把它截断成包根目录，从而把 node_modules 里的 SKILL.md 也算进来。

---

安装（插件形态）

请从 GitHub 安装，不要从 npm 安装——原因见文首。本仓库已声明 dsh.bundle manifest（见 cordis.patch.yml），一行命令即可安装并激活：

dsh plugin add github:dhicoc/dsh-reverse-skill

npm install @dhicoc/dsh-reverse-skill 不可用：registry 上的 1.0.x 与当前 DSH 不兼容，且此包已不再向 npm 发布新版本（受 npm 发布前扫描策略限制）。

安装后 dsh 会读取 cordis.patch.yml 把 reverse-skill 这个 Cordis 插件插入当前 profile，启动时自动注册 88 个技能。若你想在 profile / package 配置里手动引用，名称是 @dhicoc/dsh-reverse-skill（这是安装后的引用名，不是可从 npm 安装的包名）：

# dsh 配置（示例，键名可能因版本而异）
plugins:
  - "@dhicoc/dsh-reverse-skill"

加载后，插件在 apply(ctx) 里调用 ctx.skills.registerProvider(...)，把 88 个技能注册进 ctx.skills。模型可通过 ctx.skills → tool-skill 自动调用，用户也可通过技能名手动调用（受各 SKILL.md 的 user-invocable 控制）。

从源码构建（可选）

lib/ 已随仓库提交，从 GitHub 安装无需构建。仅在你需要自行编译时才执行下面两条命令（这里的 npm install 只装开发依赖，与安装插件无关）：

# 安装 peer 依赖（cordis / dsh-skill 由 dsh 运行时提供，这里用于类型与构建）
npm install
npm run build        # tsc → 生成 lib/ 与 lib/types/

package.json 中已声明：

"main": "lib/index.js",
"types": "lib/types/index.d.ts",
"peerDependencies": {
  "@deepseek-ai/cordis": "~4.0.4",
  "@deepseek-ai/dsh-skill": "^0.2.0-rc.2"
}

（可选）非插件回退：直接当 preset 用

本仓库同时携带完整的 skills/ 与 CTF-Sandbox-Orchestrator/ 目录，可作为 preset 直接挂载，无需构建：

skills:
  local:
    customSkillDirs:
      - "./dsh-reverse-skill/skills"
      - "./dsh-reverse-skill/CTF-Sandbox-Orchestrator"

dsh 技能发现优先级（先命中先生效）：项目 .dsh → 项目 .agents → customSkillDirs → 用户 .dsh → 用户 .agents。插件路径使用本仓库自带的递归 scanner（能发现根 skills/SKILL.md 路由器与嵌套子技能）；若改用可选 preset 回退（dsh 扁平发现，只扫直接子目录），根 SKILL.md 路由器不在子目录内、不会被发现——因此推荐用插件路径。

---

插件工作原理（数据驱动，零手写清单）

src/index.ts 不做任何硬编码候选列表，而是：

…