Skip to content

v0.1.0 · 首次发布

Choose a tag to compare

@MPFF0104 MPFF0104 released this 10 Oct 17:06
· 7 commits to main since this release

首次发布

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 的唯一条件:至少一次外部取用者的实测回报。