前言¶
在 DeepSeek Harness（DSH）里做智能体或插件开发，同一段 SOP、检查清单或提示模板往往会反复用到。常见做法是复制粘贴历史会话、或把片段放在项目外的笔记里——前者难检索，后者与当前工作区脱节，也不方便随仓库版本管理。
@nangeagi/dsh-sop-capsules（社区目录名 nangeplus/dsh-sop-capsules）把可复用的 SOP / 提示片段做成「提示胶囊」，数据落在当前工作区目录下，在 Web 会话输入框上方打开面板选用，以替换或追加方式写入草稿，不自动发送。下面介绍它的定位、能力与安装用法。
这是什么¶
DeepSeek Harness 的 Web 侧插件，npm 包名 @nangeagi/dsh-sop-capsules，维护者为 NanGePlus（南哥 AGI 研习社）。当前 README 标明最新版本为 0.2.0，适配 DSH 对应版本 0.2.0-x。SkillHub 分类为「记忆」；GitHub 仓库星标为 0（以目录页为准）。
一句话：在当前工作区维护胶囊库，在会话里按分组浏览、搜索并注入到输入框。
工作区库与会话入口¶
胶囊数据落在工作区根目录下的 .dsh/sop-capsules/（库清单与分组 yaml），可随项目做版本管理或备份。
Web 端在输入框上方提供胶囊面板入口。若当前未绑定工作区，该入口会禁用并提示先选择工作区——胶囊与 workspace 绑定，避免误用其它项目的片段。
选用与管理¶
选用
- 打开面板，按分组浏览或按标题搜索。
- 选择「替换」或「追加」，将胶囊正文写入当前输入框草稿；不会自动发送消息。
- 注入后面板关闭并回到输入框；注入模式（替换 / 追加）按工作区记忆。
管理
- 分组与胶囊：新建、重命名、删除，支持拖拽排序。
- 单分组 yaml 的导出与导入，便于在环境或项目间迁移一组胶囊。
输入框斜杠样式
输入框中与当前会话指令名、内置指令声明词或技能名完全一致的 /词 会显示为引用样式；其余斜杠文本保持纯文本。这与胶囊注入互补：胶囊负责整块 SOP 注入，斜杠样式负责与 DSH 内置命名对齐时的可读性。
宿主接口（二次开发相关）¶
Web 端不直接裸读写库文件，而是通过 Typert 命名空间 sopCapsules 访问宿主能力，例如 listLibrary、getGroup、saveGroup、deleteGroup、reorderGroups 等；Web 侧经 $mount 的 ./remote 调用。若你扩展或联调插件，可参考仓库 README 中的包结构说明（src/index.ts 宿主服务、src/library-io.ts 库路径与校验、src/client/ Web 挂载与面板等）。
安装与启用¶
前提：本机已安装 DeepSeek Harness，可使用 dsh 命令行。
npm 安装并启动 Web：
dsh plugin --profile web add @nangeagi/dsh-sop-capsules
dsh web
从 GitHub 安装：
dsh plugin --profile web add github:NanGePlus/dsh-sop-capsules
卸载：
dsh plugin --profile web remove @nangeagi/dsh-sop-capsules
安装完成后用 dsh web 打开 Web 界面，绑定工作区即可在输入框上方使用胶囊入口。
典型用法¶
- 在目标项目目录下通过 DSH 选定该工作区，安装并启用插件。
- 在胶囊面板中创建分组（例如「代码审查 SOP」「发布检查清单」），新建胶囊并写入正文。
- 新开会话或继续当前会话，打开面板，搜索或点选胶囊，选择替换或追加，确认输入框草稿内容后再自行发送。
需要备份或共享某一组胶囊时，对该分组执行 yaml 导出；在新工作区或新机器上导入同一 yaml 即可恢复该组。
适用场景与注意¶
适合
- 团队在同一仓库内共用固定 SOP、提示模板，且希望与 workspace 一致。
- 个人在多项目间切换，每个项目维护各自的
.dsh/sop-capsules/。 - 已在用 DSH 0.2.0-x Web profile，需要减少重复粘贴长提示。
注意
- 插件随当前
dsh进程权限运行，安装前请阅读 GitHub 仓库 源码与 MIT 许可证，确认符合你的安全与合规要求。 - 社区插件目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本插件为社区维护的 Web 插件之一。
- 版本需与 DSH 0.2.0-x 对齐；peer 依赖涉及
@deepseek-ai/dsh-workspace、@deepseek-ai/dsh-session等 0.2.0-rc 系列，升级 DSH 时注意插件 README 中的版本说明。
结尾¶
dsh-sop-capsules 把 SOP 与提示片段收进工作区 .dsh/sop-capsules/，在 Web 会话输入框一键注入草稿，并支持分组管理与 yaml 导入导出。目录与说明见 SkillHub 插件页，源码与界面预览见 GitHub：NanGePlus/dsh-sop-capsules。
