插件工厂 ktziy/dsh-plugin-factory

dsh-plugin-factory

让 dsh 的 AI 自己编写 dsh 插件 —— 自举式插件生成工具

为 DeepSeek Harness（dsh）会话中的智能体提供一套完整的插件开发工具链。当你说「帮我做一个 XX 插件」时，智能体能自动生成合法代码、校验契约规范、并给出安装片段 —— 全程无需人工编写。

本插件由 deepseek 模型制作用于驱动 deepseek harness

因为该模型发布不久，模型没有相关训练数据，所以由 deepseekv4 闪光版整理后由 pro 版分发为提示词包供模型使用

注意：本插件 ai 含量高达 99.99%！！！

📦 安装

方式一：tarball（推荐，免构建）
dsh plugin --profile web add ./dsh-plugin-factory-0.3.2.tgz

方式二：Git 仓库
dsh plugin --profile web add github:ktziy/dsh-plugin-factory

方式三：NPM
dsh plugin --profile web add dsh-plugin-factory

🚀 快速开始

安装完成后，直接在 dsh 会话中对智能体说：

Use plugin_scaffold to create a plugin named weather-tool with toolName get_weather.

智能体将自动返回：
- ✅ 合法的插件骨架源码
- ✅ 可直接粘贴的 --patch 安装片段

完整工作流程和高级用法，请参阅 核心文档。

🎯 为什么需要它？

dsh 插件开发有一套严格的契约规范：
- apply(ctx) 生命周期函数
- defineTool 工具定义
- Schema DSL 硬约束

模型缺乏针对性的训练数据，直接生成代码容易出现 API 幻觉。本插件将这些契约规范打包成 「文档 + 脚手架 + 校验器」 三个工具，从源头约束智能体输出，确保生成代码的合法性。

🛠️ 工具能力

| 工具 | 功能说明 |
| plugin_doc | 按主题读取开发契约文档（core / tools / services / llm / compose / preset / client / api），支持 file= 按路径读取官方结构化参考（ref/）与官方原文（official/） |
| plugin_scaffold | 生成插件骨架，支持 6 种 kind：tool / service / event / llm-adapter / client / client-node |
| plugin_validate | 基于守卫规则静态自查（tool 的 defineTool 规则 + client 的 apply/inject/slots） |

🧠 工作原理

用户需求 ↓ 智能体调用 plugin_doc 读取契约规范 ↓ 调用 plugin_scaffold 生成合法骨架 ↓ 调用 plugin_validate 自查校验 ↓ 利用 dsh 的 fs/bash 工具落盘 ↓ 通过 dsh plugin add 加载插件 ↓ ✅ 插件就绪

📸 效果预览

待补充：docs/

✨ 开发进度

| 侧 | 类型 | 完成度 |
| Host 侧 | Tool 工具 | ✅ 文档 + 脚手架 + 校验 |
| | Service 服务 | ✅ 新增脚手架（Service 类 + declare module） |
| | 事件监听/拦截 | ✅ 新增脚手架（ctx.on + 分发模式提示） |
| | 配置 | ✅ 文档 + scaffold 带 Config 示例 |
| | LLM 适配器 | ✅ 新增脚手架（LlmAdapter + StreamChunk 协议） |
| | 打包/发布 | ✅ 文档 + 包本身是 bundle |
| Client 侧 | Client UI 插件（settings.section） | ✅ 文档 + 脚手架 + 校验 + 构建 + 挂载实测 |
| | 对话节点 UI | ✅ 新增脚手架（ConversationNodeDefinition 全套） |
| | 其他槽位 | ✅ 文档覆盖（client.md §3 完整清单）+ 两个代表模板 |

plugin_scaffold 现在支持 6 种 kind：

| kind | 说明 |
| tool | Host 工具（defineTool） |
| service | Host Service 类 |
| event | Host 事件监听 |
| llm-adapter | Host LLM 适配器 |
| client | Web UI 插件（settings.section 槽位） |
| client-node | Web UI 对话节点 |

✅ 无模型自测 6 种全部通过，编译通过，打包 29KB。

📄 License

MIT © ktziy