abab996/dsh-plugin-dev

README 摘要

dsh-plugin-dev — DSH 插件开发规范 Skill（防崩溃指南） 一个给 AI 看的 Skill：教模型安全、规范地开发 DeepSeek Harness（DSH）插件，把「操作失误 → 整个 DSH 崩溃」的常见陷阱固化成注意事项。这不是一个 npm 插件包，而是一份会随会话自动加载进模型上下文的开发规范。 痛点：为什么需要这个 Skill 在 DSH 中开发插件时，模型常常因为操作失误，把整个 DSH 搞崩溃： - 直接改 node modules 里的 DSH 核心包 ：为了给新 settings namespace 加白名单，手改 dsh-host-apiproxy 的源码，升级即失效，改错即崩； - client 插件打成裸 ESM ：浏览器端插件必须打成 window. ModuleLoader .load(...) 手接格式，直接用 tsdown 默认产物会让 web 端直接崩溃； - cordis.patch.yml 格式写错 ：新增插件行必须用 - insert: 嵌套格式，写成裸的顶层 - id: 行会解析失败； - dsh.client.inject 漏列服务 ：apply 里用了 settings / UI 原语却没把提供包写进 inject，加载顺序错、服务未就绪即崩； - 手搓 div/input ：WebUI 必须用 DSH 的 UI 原语（Menu / Button / Input / DisclosureRow / Pill…），否则与主题割裂、行为不一致； - 类型当值导入 ： import type 与 import 混用导致构建 MISSING EXPORT 失败； - 重复注册 ：settings namespace / systemPrompt section / command name 重复注册直接抛错； - 安装方式错误 ：改了插件代码还反复 uninstall / reinstall，而不是用本地 file: junction 软链部署。 这些错误往往不会只报一个温和的错误——轻则插件加载失败，重则 整个 DSH 崩溃、当前会话中断、配置损坏 ，开发体验被彻底打断。 本 Skill 解决的就是这个问题 ：把「防崩溃注意事项 + 正确开发流程」固化为模型必读的规范，让模型在动手写代码之前就被告知这些陷阱，按规范开发、按流程验证，而不是靠试错把 DSH 搞崩。 它是什么 - 一个 Agent Skill （目录包： SKILL.md + references/ + scripts/ ），DSH 会在会话中自动发现并加载； - 加载后，模型会自动遵循其中的规范：三大核心事实（Cordis 插件契约 / host 与 agent 双平面 / agent preset 机制）、8 条崩溃陷阱、7 步开…

分类