前言¶
在 DeepSeek Harness（DSH）里，「帮我写个插件」这类需求很常见。默认路径往往是直接生成代码，结果常与已安装插件、市场目录或 GitHub 上已有实现重复，主对话还会被检索、拆解和生成过程撑得很长。
Plugcraft（dsh-plugcraft）把流程改成「先澄清需求、再查可复用实现、由你决定怎么复用，最后才在隔离子智能体里补缺口并做结构校验」。侧栏里有独立工作台页面，阶段和候选结果持续刷新，安装前需要你确认。
下面按定位、能力、安装与用法说明该插件；事实以 GitHub 仓库 README 与 package.json（当前版本 0.12.0）为准。
这是什么¶
Plugcraft 是面向 DSH 的 reuse-first（复用优先）插件创作工作台，维护者为 lixian292，许可证为 MIT。项目在社区目录归类为 工作流。
它解决的核心问题：在写新插件之前，先回答「是否真的需要从零新建」，并在安装前对生成物做结构校验，避免未经验证就静默安装。
核心功能¶
工作台对应一条固定流水线，侧栏卡片上展示五步进度：澄清（clarify）→ 搜索（search）→ 决策（decide）→ 拆解（decompose）→ 构建（build）。
澄清与结构化需求¶
将自由文本需求整理为结构化 spec，包含 surface、必须具备的能力、验收标准与约束等字段，并保存在任务上供后续步骤使用。
四层复用检索¶
搜索按「阶梯」进行，由 Host 执行检索与排序，不占用主对话上下文：
- 已安装的 DSH 插件
- 市场精选目录（缓存目录）
- GitHub 仓库
- 仓库详情
README 说明：匿名 GitHub 搜索约 10 次/分钟；配置只读 token 可提高到约 30 次/分钟（可选配置，详见仓库 Configuration 小节）。
四种复用决策¶
找到候选后，由用户四选一，不由模型代决：
- Use as-is：直接采用现有实现
- DIY on top：在现有基础上改
- Reference only：仅作参考
- From scratch：从零新建
拆解、交接与校验¶
部分匹配时，将能力拆成 capability units，每项标记为 reuse 或 gap。缺口交给 Creator 子智能体（cordis preset）在独立上下文中生成。
生成 bundle 后做结构校验（manifest、patch、client 入口、locale、icon、JavaScript 语法等），使用 node --check，不执行生成代码。安装须经你确认；任务最终以 done 或 install_failed 记录。
侧栏工作台 UI¶
- 纵向 任务卡片：目标、阶段、候选数量、最后更新时间；同一时间只展开一张卡片。
- 展开后：Overview（spec、搜索报告、决策、能力单元与交接摘要）、Candidates（默认五行，可「显示全部」）、Plan & handoff（安装 spec、Creator 状态、校验项、安装结果）。
- 页面数秒自动刷新，无单独提交按钮。
- 中文界面入口名：插件工作台（英文：Plugcraft），与 Plugins、Market、Context insights 等并列。
主对话中智能体加载 plugin-workbench skill 并调用 plugin_workbench 工具后，页面会与流水线同步更新。
安装与启用¶
环境要求（来自 README）：
- DSH 带 Web UI：dsh >= 0.2.1-rc.2（在
0.2.2-rc.1上测试过） - Node.js：22.19+ 或 24+
从 GitHub 安装（README 推荐，直至首个 npm 发布）：
dsh plugin --profile <profile> add github:lixian292/dsh-plugcraft
从 release 压缩包安装（无需 registry 账号）：在 latest release 下载 .tgz 后：
dsh plugin --profile <profile> add <path-or-url-to>/dsh-plugcraft-<version>.tgz
本地开发可在 DSH Plugins 页通过绝对路径安装 bundle（例如经 plugin_manager 的 install_bundle）。README 注明计划发布 npm 包 dsh-plugcraft，首版发布时 npm 注册不可用，当前以 GitHub 与 release 包为主渠道。
安装完成后，在侧栏打开 Plugcraft（插件工作台）即可使用。
典型用法¶
- 打开 Plugcraft 页面，对话过程中保持该页打开。
- 在任意 DSH 对话中描述插件需求，例如 README 中的日历侧栏示例：月视图、切换月份、高亮今天、事件本地保存等。
- 让流水线运行；工作台页面会填入 spec、搜索结果与当前阶段。
- 有候选时回答四选一决策问题。
- 按计划跟随能力单元与缺口；缺口生成后查看校验结果，再确认安装。
- 在 Plan & handoff 查看校验与安装结果。
便于触发的说法（摘自 README）：
- 「是否已有能做 X 的 DSH 插件？用工作台查一下。」
- 「为 X 做插件，但先查已有实现。」
- 「用 plugin workbench 做这件事。」
适用场景与注意¶
适合：需要新 DSH 插件、又希望先查市场与 GitHub 是否已有可复用实现的用户；希望检索与生成离开主对话、且安装前可看到结构校验结果的开发者。
注意：
- 插件在 当前 DSH 进程的权限 下运行；安装任何插件（含工作台生成的 bundle）前，应自行阅读源码与许可证。
- 生成代码仅做静态结构检查，不代表运行时行为安全；是否安装由你决定。
- 社区目录 SkillHub 插件页 为生态索引，与 DeepSeek / 幻方无官方从属关系。
- README 标注 16 passing 测试与 DSH 兼容性声明（
0.2.1-rc.2+、0.2.2-rc.1+compatible）。
结尾¶
Plugcraft 把「Search first, build last」落到侧栏工作台：先澄清、四层搜索、用户决策、缺口在 Creator 子智能体中补齐，再校验后安装。需要安装命令与交互细节时，以 GitHub：lixian292/dsh-plugcraft 与 目录页 为准。
