Repository navigation
v0.1.0 · 首次发布
首次发布
dsh-plugin-dev-mpff 是一个 dsh(DeepSeek Harness)第三方插件开发 skill:从零写出一个插件、证明它生效、把它发出去。
取用形态是裸目录束 —— 把仓库根的 dsh-plugin-dev-mpff/ 整个目录取走即可。本仓不提供安装路径(读者自己会装、靠 AI 发现),也不提供副本对齐:按目录束取用的取用者与仓库之间没有可比版本面。
覆盖面
- 入口
SKILL.md:7 条硬约束 + 「任务 → 文件」路由表 + 5 步流程(每步带完成判据)。 - 9 册
references/:环境发现 · 包与装配 · 扩展点选择 · 逐文件建包 · 前端半边 · 验证闭环 · 发布与分发 · 静默失效排查 · 上游漂移重核。 - 可复制起点
templates/:host-only/(5 文件)·frontend/(6 文件)。 - 端到端夹具
examples/hello-plugin/(6 文件),配scripts/verify-e2e.mjs的 15 步闭环。 - 四个脚本:
scripts/dsh-env.mjs(环境发现)·scripts/check-plugin.mjs(静态自检,含--self)·scripts/verify-assembly.mjs(装配验证)·scripts/verify-e2e.mjs(端到端)。
发布时的门禁现状(可自己复算):
node "<skill-directory>/scripts/check-plugin.mjs" --self ⇒ ok: true,problems[] 里 error 计数 0,exit 0
node "<skill-directory>/scripts/verify-e2e.mjs" ⇒ 报告「装上了 / mount 了 / 卸干净了」三条
已知边界
本版不是全验证版。每一处边界都就地写在成品自带的 ## 边界 段里(不散落在 issue 面),且每处都附「自己复算的办法」。下面 5 处是强制标注:
| 就地段 | 未验的是什么 |
|---|---|
references/env-discovery.md 的 ## 边界 |
npx @deepseek-ai/dsh 与源码 pnpm dsh 两条 CLI 候选未真跑,只是推断可用;注册表 InstallLocation 只在 Windows 一台机器上验过 |
references/extension-points.md 的 ## 边界 |
上游不存在扩展点穷尽清单,本册不承诺穷尽,是已证实清单 + 就地校验方式 |
references/build-a-package.md 的 ## 边界 |
bundle.patch 与行 id 的官方推荐写法无证据,给的是本规格决定,不是上游规则 |
references/frontend-plugin.md 的 ## 边界 |
前端骨架只到 node --check + manifest 形状 + boot 期图组合,未做端到端渲染验证 |
references/release-and-distribution.md 的 ## 边界 |
真实 github: 远端安装、zip 安装路径、plugin update 后的调和均未实测 |
另有 4 处可写边界,同样就地写在各自 ## 边界 段:
references/package-and-assembly.md——applyEntryPatches的历史只有一条旁证,标残留风险。references/verification-loop.md—— C 档(工具真出现在工具列表 / 钩子真拦到一次调用)未跑通:本机没有模型凭据,只拿到MISSING_CREDENTIAL。references/failure-modes.md—— 表里有三条来自第三方自述,不是实测。references/drift-recheck.md—— 落后量未复算 · 多段并列 peer 区间未实测 · 站点差集未全量 diff。
模板侧对偶:templates/frontend/client.js 首行带同一句「未做端到端渲染验证」边界。
版本面
版本号只有一处 = GitHub Releases 的 tag。README 不写版本号,也不写历次改动,只留一句指向 Releases 的指针。升 v1.0.0 的唯一条件:至少一次外部取用者的实测回报。