dsh-htb-skills
HTB（Hack The Box）打靶技能库，封装为 DeepSeek Harness 插件。
这是一个社区项目，并非 DeepSeek 官方插件，也不代表 DeepSeek 的认可或背书。
是什么
- 114 张技能卡：从 Reasonix Studio 的 HTB 技能库移植，覆盖 Web / AD-Windows / Linux / 数据库 / 云 / 取证等 10 个领域；
- 插件形态：包内自带
skills/ 树，通过官方 @deepseek-ai/dsh-skill-filesystem 的 provider 机制注册为名为 htb 的技能提供者——技能随包版本化、git 管理，编辑即时热重载，不写任何文件进 ~/.dsh/skills；
- 三层结构：T1 路由卡进会话目录；T2 深度卡 / T3 参考卡带
disable-model-invocation: true 隐藏，按名精确加载；htb-skill-index 是全部卡名的领域×层级总索引。
安装
# 1. 克隆本仓库
git clone https://github.com/qingsiweisan/dsh-htb-skills.git
# 2. 安装到 DSH profile（link 安装，本地改代码即时生效）
dsh plugin --profile web add link:./dsh-htb-skills
# 或从 npm 安装：
# dsh plugin --profile web add dsh-htb-skills
# 3. 重启 dsh web，新建会话即可看到 htb-skill-index 等 T1 卡
Linux / Kali 同理，路径换成克隆目录即可。
注意：插件挂载后，~/.dsh/skills 里的同名散装技能会与插件里的卡重复（同名时 preset 层会遮蔽全局层）。迁移时先备份再清空散装目录：
mv ~/.dsh/skills ~/.dsh/skills.bak # 确认插件生效后再删除
目录结构
dsh-htb-skills/
├── package.json # dsh.bundle.patch 指向 cordis.patch.yml
├── cordis.patch.yml # 注入 host 插件行：- id: htb-skills
├── src/index.js # 插件本体：注册 htb skill provider（无浏览器半区）
├── skills/ # 114 张技能卡（SKILL.md + frontmatter）
│ ├── htb-skill-index/ # 总索引（T1，进目录）
│ ├── box-startup/ # T1 路由卡示例（含 key-state 产物规范）
│ └── ... # T2/T3 卡带 disable-model-invocation: true
├── docs/
│ ├── CARD-NORMS.md # 卡片写作规范（可解析工件/漏洞形状/语义 rubric/子代理隔离）
│ └── ARCHITECTURE.md # 架构与变异点地图（机制域 vs 内容域，改框架先读它）
└── scripts/
├── triage_skills.py # 分层/修 whenToUse/修坏链/重生成索引卡（末尾自动跑路由审计）
├── fix_yaml.py # 全量 YAML 引号规范 + PyYAML 校验（幂等：解码后重转义）
├── audit_routing.py # 路由完整性审计（只读）：名字唯一性/MAPPING 双向一致/
│ # tier 与 disable-model-invocation 一致/索引卡新鲜度/跨卡引用可解析
└── verify_run.py # 判定层：flag/cred 捕获事件的确定性复核（读磁盘 transcript）
卡片的 frontmatter 约定
---
name: web-attacks
description: 'Web 攻击综合手册：OWASP 2025 映射→…'
whenToUse: '目标有 HTTP/HTTPS 攻击面时：…'
# T2/T3 卡额外带这一行；T1 卡不写：
disable-model-invocation: true
metadata: { domain: web, tier: T1 }
---
domain 取值：meta / web / ad-win / linux / db / cloud / creds / forensics / network / toolstier 取值：T1（进目录）/ T2（深度，按名加载）/ T3（参考与题源，按名加载）
维护
改完技能后跑一遍校验链（需 pip install pyyaml；三个脚本都幂等，可重复跑）：
python scripts/fix_yaml.py # 规范引号 + 校验全部 frontmatter
python scripts/triage_skills.py # 分层元数据 + 重生成索引卡（末尾自动跑路由审计）
python scripts/audit_routing.py # 路由审计：引用解析/索引一致性（任一错误退出码 1）
audit_routing.py 检查的路由面：卡名合法且唯一、目录名与卡名一致（警告）、MAPPING 与磁盘双向覆盖（索引不会挂空、不会漏卡）、metadata.tier 与 disable-model-invocation 一致、索引卡与 MAPPING 生成内容逐字节一致（STALE-INDEX）、卡内 backtick/[[wiki]]/中文路由关键词（加载/详见/见/查…）引用的名字全部可解析（DANGLING-REF），以及引号翻倍回归守卫（QUOTE-RUN-CORRUPTION）。
新增一张卡 = 在 skills/ 下建目录 + 写 SKILL.md + 在 scripts/triage_skills.py 的 MAPPING 里登记 domain/tier，重跑校验链。插件 watch 默认开启，编辑后无需重启。
发布到 GitHub / npm
git init
git add .
git commit -m "dsh-htb-skills: initial HTB skill library plugin"
gh repo create dsh-htb-skills --public --source=. --push # 或手动 git remote add + push
- 建议给仓库加 dsh-plugin topic 方便被发现（官方生态指引）；
- 发布 npm：
npm publish，之后两台机器都可以 dsh plugin --profile <name> add dsh-htb-skills 安装；
- 升级 =
git pull（link 安装）或 dsh plugin --profile <name> update dsh-htb-skills（npm 安装）。
兼容范围
- DeepSeek Harness
0.1.0-rc.x（与 @deepseek-ai/dsh-skill-filesystem ^0.1.0-rc.6 对齐）；
- Node
^22.19.0 || >=24.0.0；
- Harness 仍处于开发者预览期，升级后如有破坏性变更请对照上游
skill-filesystem 的导出再使用。
许可证
MIT。技能卡内容移植自 Reasonix Studio 的个人技能库。
