身份提示词替换 Soulize/dsh-identity-override

dsh-identity-override

一个 DeepSeek Harness 插件，只替换内置的 HARNESS_IDENTITY 提示词段落（harness:identity），换成你在 Plugins 页面配置的文本。它不改动 DSH 源文件，也不会在前后追加第二段身份指令。

安装

安装到你平时使用的那个 DSH 配置档：

dsh plugin --profile web add "github:Soulize/dsh-identity-override#main"

如果你用的是别的配置档，把 web 换成对应的配置档名。如果提示需要重启 DSH，就重启。在 Web/Desktop 里打开 Plugins -> dsh-identity-override -> identity-override -> Configure。

在多行文本框里填入替换内容，点 Save。点 Use recommended default 会把插件默认值填进编辑器；再点 Save 才会保存这次重置。值存在当前配置档里，改动对后续的提示词组装生效，不需要重新挂载插件。

默认身份

You are a capable, task-oriented AI agent that proactively uses available tools, researches existing projects and proven solutions when relevant, and delivers correct and complete results.

你也可以直接编辑插件自己的配置档行：

- id: identity-override
config:
identityText: >-
You are a capable, task-oriented AI agent that proactively uses
available tools, researches existing projects and proven solutions
when relevant, and delivers correct and complete results.

官方 @deepseek-ai/dsh-system-prompt 那一行以及它的 includeHarnessIdentity: true 设置保持原样。插件不需要禁用官方段落，也不需要改 personaPrefix。

工作原理

- Host 插件挂到官方的 system-prompt/assemble 瀑布上，替换已有命名段落的文本，保留它的位置，也保留其他所有段落、上下文、工具 schema 和变量。
- 它只对那一个段落使用 interpolate: false，这样字面量 {{variable}} 文本和多行身份消息都能用，不受 DSH 提示词变量插值的严格限制。
- 它的设置字段是易变的：保存不同的值会直接更新当前 Host，不用重新挂载，并发出 system-prompt/change 通知提示词已更新。
- 禁用或卸载后，钩子消失；后续提示词组装重新使用 DSH 原本的身份。不修改任何核心文件。
- 如果内置身份不存在（例如 includeHarnessIdentity: false），插件不会注入新段落。如果某个作用域用了 complete: true，仍以 DSH 的完整提示词约定为准。
- 编辑器里的值不能为空，空值无法保存。如果外部配置把非法值传进 Host，Host 会改用推荐默认值。

改动系统提示词开头的 token 会降低改动前后的前缀缓存复用率；稳定的替换内容对缓存更友好。已经在进行中的模型请求不受影响。

兼容性

- DeepSeek Harness >=0.2.0-rc.1（需要它的 system-prompt/assemble、Plugins 配置表单和客户端模块 API）。
- DSH 需要 Node.js >=22.19.0。
- DSH 还在开发者预览阶段，插件 API 可能随时出现破坏性变更。本插件依赖内置段落名 harness:identity。
- 配置页依赖 DSH 的 Web 客户端模块系统和托管配置档。纯无头部署没有配置页；插件仍可通过配置档 YAML 字段使用。

验证

1. 新建一个智能体会话，在第一次模型调用时检查组装后的系统提示词。内置身份应只出现一次，且内容已替换为新文本。
2. 确认原来的 You are an AI agent powered by DeepSeek Harness. 已消失，其他系统提示词段落保持不变。
3. 在 Configure 里保存另一份身份文本，然后发起新的模型调用或新建会话，再次检查组装后的提示词。
4. 禁用插件：DSH 下次组装提示词时，原始身份应恢复。

运行本地单元测试和 UI 契约测试：

npm test
npm run check

这些测试会 mock Host 服务和 UI 框架，不能替代针对运行中 DSH 安装的集成测试。

设计参考

- DSH 系统提示词源码
- DSH 提示词组装 API
- DSH 插件配置 UI

MIT 许可证。