Skip to content

v1.2.1 — GitHub-only distribution, R46 routing, router layout fix

Latest

Choose a tag to compare

@dhicoc dhicoc released this 14 Nov 12:08

安装

GitHub 是唯一受支持的分发通道。npm 通道已废弃(详见下文)。

# 固定版本(可复现,推荐)
dsh plugin add github:dhicoc/dsh-reverse-skill#v1.2.1

# 或跟随 main 最新提交
dsh plugin add github:dhicoc/dsh-reverse-skill

需要指定 profile 时加 --profile <name>(浏览器 UI 通常是 web)。

本次变更

路由:新增「软件解锁 / 授权绕过」类目(R46,来自 #28)

routing_zh.md 原本没有这一类,解锁|激活|注册码|keygen|许可校验 零命中,只能靠临场发挥。原 PR 只改了 Markdown,没有改单一事实源 skills/config/routing.json,而 master-route.ps1 只读该文件——所以文档上有了、运行时永远命中不到。本版补齐:

  • routing.json 新增 R46(PRIMARY = thick-client)+ priority 紧接 R32
  • 关键词带 exclude:bola|bfla|api|graphql|jwt|oauth|sso 与 激活函数|relu|sigmoid|softmax 不会被误抢(仍归 R12 / R14)
  • routing-benchmark.json 补 4 条用例(含 1 条 quick),满足「每个路由至少一条 benchmark」的硬规则
  • 英文侧 routing.md 两张表同步

布局:路由器移动到 skills/reverse-skill-router/(修复 #21)

skills/SKILL.md 声明 name: reverse-skill-router,与 agentskills.io 规范 的「name 必须等于父目录名」不符。全树审计确认这是唯一一处,其余 87 个技能本就合规。

  • 文件内指向 skills/ 层文档的引用加 ../,CTF sidecar 改 ../../
  • port.py 的 restructure_router() 前缀表补上 field-journal/、config/(原先重新 port 会产生死链)
  • verify-routing-coherence.ps1 / verify-doc-facts.ps1 / refresh-tool-index.ps1 指向新路径
  • skills/INDEX.md 重新生成
  • 运行时不变量:插件按 frontmatter name 注册,仍为 88 个技能

门禁:四道在 main 上长期报红的检查修绿

这些失败不是 port 缺陷,而是门禁假设了上游目录布局(本仓库只分发 skills/、CTF-Sandbox-Orchestrator/、lib/):

  • verify-routing-coherence.ps1:RULES.md 包根优先、skills/ 兜底;RULES_zh.md、kali/ manifest 未随包时记 [N/A] 并在 summary 单列
  • verify-doc-facts.ps1:原先直接读不存在的 RULES_zh.md 与 burp-mcp-full/,一条检查都没跑就抛错
  • verify-repository-security.py:agent 入口双解析,RULES.md 唯一必需,新增 "checked zero files" 护栏;workflow action 固定到 commit SHA
  • test-workflow-title-safety.ps1:workflow 未随包时给 [N/A] 而非崩溃
  • 两条指向未分发 docs/ 的死链改指上游 blob

每个 [N/A] 化都做了负例:删 skills/RULES.md → 重现 missing RULES.md + checked zero files,exit 1;往 manifest 注入假能力 → capability list FAIL,exit 1。

分发:正式放弃 npm 通道

  • 删除 .github/workflows/publish.yml(npm staged 发布工作流)
  • package.json 去掉只服务于 npm 发布的 prepublishOnly
  • README 安装章节改为 GitHub-only,补充「为什么不走 npm」与升级/降级/回滚流程

npm 为何永久不可用:registry 上只有 1.0.2–1.0.5,peer 全为 @deepseek-ai/dsh-skill ^0.0.1-rc.1,DSH ≥ 0.2.0 在预检阶段即拒绝;1.1.x 起的 staged 发布被 npm dual-use 内容扫描 blocked。残留 1.0.5 已标 deprecated 指向本仓库。

验证

在 DSH 0.2.2-rc.3(Windows)上用一次性 profile 实测,未触碰正在运行的 desktop profile:

  • dsh plugin add github:dhicoc/dsh-reverse-skill → + @dhicoc/dsh-reverse-skill 1.2.0(5.9s)
  • dsh plugin add github:dhicoc/dsh-reverse-skill#v1.2.0 → 解析到 1.2.0,证明 tag 固定可用
  • profile dependencies 与 dsh.profile.bundles 双侧登记;--dump-config 组合出 id: reverse-skill
  • 安装树:version 1.2.0、main lib/index.js、入口 11648 字节、88 个可发现 SKILL.md

本地门禁(全部通过):

npm test                      Verified 88 bundled skills
test-routing.ps1              ALL PASS (182)
verify-routing-coherence.ps1  ALL PASSED
verify-doc-facts.ps1          0 failure(s)
verify-doc-links.py           all links resolve
verify-repository-security.py OK
extract-summaries.ps1 -Check  INDEX.md up to date
smoke.ps1                     ALL PASS
test-parse-contracts.ps1      ALL PASSED

兼容性

DSH 0.2.2-rc.3(dsh.compatibility.dshReleases 已记录);peerDependencies 为 @deepseek-ai/dsh-skill ^0.2.0-rc.2。