dsh-plugin-dev

DeepSeek Harness（DSH）插件开发的执行型技能（Agent Skill，标准 SKILL.md 格式）。

dsh-plugin-dev 是给"要写一个 dsh 插件的模型"看的手册 + 可执行闸门：先选范式，再照骨架抄，最后过安全/发布纪律。它把 9 个真实插件项目的一手源码分析 + 社区前 30 项目形态审计 + 5 个生态技能的验证精华 固化成一份带可执行门禁的技能。

这是什么

项	说明
技能名	dsh-plugin-dev（目录名即技能名，kebab-case）
语言	中文正文 + 英文 description（触发词）
形态	Agent Skill（按 dsh-plugin-schemes 五形态 属 Skill，非 npm bundle）
依赖	见下方 REQUIRED BACKGROUND

安装（DSH）

# 克隆到受管技能目录（与 dsh-foundations 等兄弟技能同目录）
git clone --depth 1 https://github.com/Fabian-698/dsh-plugin-dev.git ~/.dsh/skills/dsh-plugin-dev
# 或手动放置：把 SKILL.md + references/ + scripts/ + assets/ 一起放到
#   ~/.dsh/skills/dsh-plugin-dev/
#   ~/.agents/skills/dsh-plugin-dev/   （rank500，Claude Code/Codex 等也扫）

其他 agent（Claude Code / Codex / Gemini CLI / opencode）放到各自扫描的 skills 目录即可，本技能只依赖文件 + shell 工具。

REQUIRED BACKGROUND（先装兄弟技能）

本技能按 skill-decomposition 交叉引用模式 拆分自 monolith，依赖同一家族的兄弟技能：

兄弟技能	作用
dsh-foundations	安全红线 + 一切皆插件心智模型（必读前置）
dsh-config-assembly	装配侧闸门 verify-patch.mjs（打包后验证树能不能装配）
dsh-session-logs	会话日志闸门 verify-session.mjs（日志能不能恢复）

缺兄弟技能时本技能仍可独立使用，但 verify-patch / 会话日志验证步骤会缺失。

内容结构

dsh-plugin-dev/
├── SKILL.md                      # 技能入口：范式速选 + 闸门用法 + 安全纪律
├── references/
│   ├── plugin-dev.md             # 范式手册（317→380 行，含生态回填）
│   ├── dev-testing.md            # 四层测试场景库
│   └── ecosystem.md              # 社区生态雷达（前 30 项目形态/机制/盲区）
├── scripts/
│   ├── verify-plugin.mjs         # 插件闸门（P1-P13，零依赖，退出码 0/1）
│   └── scaffold-plugin.mjs       # 标准桩件生成器（--form toolkit|ui-panel|hybrid|daemon-loop）
├── assets/                       # 三件套模板（闭包工厂/最简 patch/dual-face package）
└── tools/
    └── sync-upstream.sh          # 刷新协议：重拉上游生态 → 审计 → 增量报告

特色

• 六类范式速选：UI 全家桶 / 工具型 / 编排型 / 安装器型 / host-only / 服务宿主型 / 桥接型 / provider 替换型 / 生成式 UI 型 / 纯分发型
• 可执行闸门 verify-plugin.mjs P1-P13：包名命中、patch 最简性、exports 自洽、client 闭包工厂、平台白名单、files、无 shell 降级、环回 fence、跨插件 import、版本就绪、工具名去重、形态识别、发布面
• 安全纪律 13 条：环回 fence、凭据服务端、原子写 0600、spawn allowlist、SSRF 硬化、渲染/DOM 沙箱、日志脱敏等
• 生态回填（2026-08-25，已过 skill-sentry 审计）：§0 五形态决策树、§5.1 schema 铁律、§3.5 GUI 坑、§3.6 slot 四步 + Conversation Node、§2.5 双 tsc、§4.1 HTTP 契约、§8.1/8.2 持久化与从零安装

维护：刷新协议

本技能的回填内容全部标注了来源（源自 dsh-io/dsh-plugin-skill 等）。上游生态更新时，跑：

tools/sync-upstream.sh            # 重拉上游 → 审计 → 对比已合并内容 → 增量报告
tools/sync-upstream.sh --accept   # 认可后更新 last-sync 快照

详见 tools/upstream-manifest.json（哪些上游喂哪些章节）。

生态回填来源（致谢）

上游	回填章节
dsh-io/dsh-plugin-skill	§5.1 schema DSL 铁律
JasperGuWP/dsh-plugin-schemes	§0 五形态选型决策树
Zn-Dk/dsh-plugin-creator	§3.5 GUI 实战坑
NanmiCoder/dsh-agent-teams	§2.5 / §3.6 / §4.1 / §8.1 / §8.2 官方契约

License

MIT © 2026 Fabian-698