DeepSeek HarnessHub
提交插件

Hwayn-pixel/dsh-copilot ↗★ 1

dsh-copilot-plugin

A co-pilot for your DSH agent's instructions: read the system prompt as sections, write your own house rules into it, catch the rules that contradict each other, keep a logbook of every change - and roll it all back.

Agent 协作界面扩展
包名
dsh-copilot-plugin
兼容性
待验证
版本
0.2.3
许可证
MIT
最近更新
2026年10月1日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Hwayn-pixel/dsh-copilot

说明文档

阅读完整 README ↗

dsh-copilot

npm license ci DSH

npm: dsh-copilot-plugin · one-line install: dsh plugin --profile web add dsh-copilot-plugin

一个"副驾驶"，不是"自动驾驶"。 A co-pilot, not an autopilot.

dsh-copilot 给 DSH 的 system prompt 配了一位副驾驶：它让你看清这份说明书由哪些段组成、 写下你自己的家规、并点名重复与臃肿。它不替你改，也不打分——方向盘始终在你手里。

它做什么

看得见把当前 system prompt 按段摊开：每段叫什么、来自谁、多少字节、原文长什么样。走的是真实的 ctx.systemPrompt.assemble()，不是猜的。
改得动「我的家规」：写一段话，选它落在 prompt 的哪个位置（靠前 / 中间 / 靠后）。改完立刻生效，不用重启——因为每段的正文是一个 provider，在每次组装时才读取。
解得开「体检」：同一条话出现在两段以上、两条互相矛盾（一个有「要」、一个有「不要」）、某段特别长、规则开着却没写正文……只看事实，不替你做决定。
退得回所有贡献都来自本插件自己的段名（copilot:pre / copilot:mid / copilot:post）。关掉开关或卸载插件，一切回到原样——它从不改写别人的段。

为什么段名不叫 deployment:persona-prefix

DSH 允许一个段按名字遮蔽同名段（这正是"预设可以盖掉部署 persona"的机制）。dsh-copilot 故意不使用这种遮蔽：副驾驶是加一层你的声音，不是悄悄替换机长的声音。想覆盖 persona， 请用 DSH 自己的预设机制——那才是它的正门。

安装

# npm 上的包名是 dsh-copilot-plugin（原因见下）
dsh plugin --profile web add dsh-copilot-plugin

# 本地开发（link 方式，改完 build 即可）
dsh plugin --profile web add -w .    # 在插件目录里执行

# 重启 web 宿主
dsh --profile web --no-open

# 浏览器硬刷新（Ctrl+F5）

打开 设置 → 副驾驶。

本地 link 安装时，插件目录的 node_modules 里需要有 @deepseek-ai/schemastery（DSH 自带的 那份即可）；从 npm 正式安装时由依赖声明自动解决。

⚠️ 给 DSH 插件作者的一条血泪经验（已验证）：DSH 的插件 id 不支持 npm 作用域名。 包名叫 @hwayn/dsh-copilot 时，宿主照常加载（路由都通），但客户端半会被悄悄丢出加载清单—— 设置页直接消失，前端一点报错都没有。名字必须三处一字不差、且不带作用域： package.json 的 name、cordis.patch.yml 里的 name、profile 的 dependencies 键 + dsh.profile.bundles。 所以这个仓库叫 dsh-copilot，npm 上叫 dsh-copilot-plugin。

怎么退回去

  • 只要临时静默：设置页里关掉「启用」——本插件不再往 prompt 里写任何字，别的都不动。
  • 完全卸载：把 node_modules 里的链接删掉、从 profile 的 dsh.profile.bundles 里去掉 dsh-copilot，然后重启宿主。已写入过的家规留在 profile 的设置文档里，可以手动清。
  • 本插件从不修改别的插件贡献的段，所以“退回去”不需要任何补丁。

接口（主机半）

  • GET /dsh-copilot/prompt → { ok, enabled, sections:[{name,bytes,text}], rendered, bytes, tools, contexts, ours, bands } 返回当前真实组装出的提示词。:3080/dsh-copilot/prompt 可以直接 curl，方便排查。

设置命名空间：ui-copilot。

字段默认含义
enabledtrue总开关。关掉后本插件不往 prompt 里写任何字
rules[][]{ id, title, text, band: pre|mid|post, enabled }

段落落点（数值取自 DSH 的 SECTION_ORDERS 空闲档位）：

bandorder位置
pre700deployment persona 之后、工具说明之前
mid5500所有工具段之后
post10150prompt 末尾、persona suffix 之前

已知限制（诚实清单）

  • 只增不改：目前能新增段，不能删除或改写别的插件贡献的段。要让某段"消失"目前只能靠 DSH 自己的配置（例如关掉那个插件），或者写一条家规去纠正它。
  • 体检是启发式：重复检测看的是"长度 ≥30 的规范化行在不止一段里出现"。它只找线索， 不是判决。
  • 预览里的 {{变量}}：主机半优先用 dsh-system-prompt 的 renderPrompt() 插值；如果那个包 在 profile 里解析不到，就退化成"原样拼接"（保留 {{model}} 之类），此时预览不等于最终文本。
  • 组装预览是在没有具体 agent scope 的情况下调用的，所以 tools 常显示 0——真实会话里的工具段 属于各次请求的 scope。

状态

🌱 v0.0.1 · 2026-09-30 夜。地基：@deepseek-ai/dsh-system-prompt 的 ctx.systemPrompt （段注册表 + assemble()）。已实测：注册三段 → UI 改写 → 提示词内容随之变化 → 删除后归零。

作者：Hwayn（幻弈）