对话前缀定制 Phantom-Algo/dsh-custom-conversation-prefix

DSH 自定义系统提示词与对话前缀

当前插件版本 0.0.9。修复了这个问题：首条真实问题发出后、模型还没输出时，聊天页错误显示最后一条预设助手回复。前缀不再参与聊天回复、过程计数和工具状态，模型上下文与独立轨迹保留。详见 0.0.9 验证记录。0.0.8 的「自动上下文」「工具」会话控制继续保留。

首版支持 DeepSeek Harness 0.2.1-rc.3，构建提交 be72761ee1a6736ebcdf4f3739363b083ae53c98。插件通过 Host、Client 两个入口加载，无需修改 DSH 源码或安装包。

已实现

- 独立「提示词与前缀」管理页：搜索、新建、保存、复制、删除及修订冲突检查。同类标题唯一，保存时做 trim 与 Unicode NFC 规范化。
- 系统模板与前缀独立选择。新建会话默认沿用 DSH 系统提示词、不使用前缀。
- DSH 复用空白会话时，原生新建按钮和它当前的快捷键会先恢复本插件的默认选择；已开始的会话保留锁定快照。该入口适配针对当前版本的公开语义属性，宿主升级后需重验。
- 系统提示词完整替换，{{...}} 原文保留；自动上下文和工具可独立配置，后台权限执行继续沿用宿主。
- 自动上下文可逐项禁用工作目录、环境策略、技能目录、时间及工作区指令等自动贡献，包括 required 上下文；用户主动输入、附件引用、显式技能调用和预设历史保持原样。
- 工具菜单按当前 Agent 预设列出实际可用工具，可搜索和多选禁用；模型定义与实际执行同时限制，覆盖 PTC 的 run_code 与嵌套调用。禁用插件后恢复宿主默认行为，设置不修改预设或宿主全局配置。
- 多轮 user / assistant 历史，以及 assistant 工具调用与 tool 结果；结构、字段、调用 ID 和并行结果时序校验。
- 消息表单与 JSON 编辑、字段错误定位；选择器右侧「预览」可定位到管理页对应模板的只读详情。草稿修改在离开编辑项时通过 DSH 弹窗确认，切换其他面板保留当前浏览器内草稿。
- 选择器支持点击外部、Escape 收起；模板列表提供垃圾箱及删除确认。新建前缀的两条消息为空内容，使用「你好」「你好，我是 DeepSeek，有什么可以帮到您？」作为占位提示，右下角可随时添加消息。
- 首条真实输入接纳后锁定；会话日志保留模板内容快照。续聊、重启、模式重建、分叉及历史替换后不会再次注入。
- 中断初始化在下次请求前恢复完整历史；预设工具不经过执行调度器。
- 轨迹通过消息身份独立显示预设角色，预设工具标明「预设历史，未执行」；真实用户、助手、工具与上下文沿用宿主标签。
- 使用 DSH 原生 Button / Input、CSS Modules 和主题变量；管理页支持深浅色。

开发与离线体验

需要 Node.js 22.19+ 与 pnpm。所有命令在本项目目录执行。

pnpm install --frozen-lockfile
npm run check
npm run dev:installed

dev:installed 使用本机安装的 DSH 启动隔离 Web profile，配置、模板、会话与请求捕获全部位于项目 .cache/，不读取正式 DSH 的账号和历史。打开终端打印的本机地址，在模型选择器选择「插件验收模型（离线）」，即可验证发送流程，无需 API Key。退出用 Ctrl+C。

该模式使用安装包中的实际后端与 UI，但不是 Electron 窗口壳测试。启动脚本默认为 macOS 的 /Applications/DeepSeek Harness.app/.../dsh；可通过 DSH_CLI 指定 CLI，通过 DSH_ASAR 指定安装包，通过 DSH_TEST_PORT 指定本机端口。

构建与安装

npm run build
mkdir -p releases
npm --cache .cache/npm pack --pack-destination releases

当前产物为 releases/dsh-custom-conversation-prefix-0.0.9.tgz。lib/index.js 是 Host ESM 入口，lib/client.js 是 DSH window.__ModuleLoader__ 格式的 Client 入口；React 与宿主库不重复打包。

已获用户授权并安装到本机正式 Desktop profile，原配置已备份，原有会话恢复正常。其他环境安装时先完全退出 DeepSeek Harness，再运行：

node scripts/install-profile.mjs \
--profile "$HOME/.dsh/profiles/desktop" \
--package ./releases/dsh-custom-conversation-prefix-0.0.9.tgz \
--pnpm "$HOME/.dsh/dsh-runtimes/dsh-primary-runtime/dependencies/pnpm/bin/pnpm.cjs"

如果设置了 DSH_HOME，把 --profile 改成该目录下的 profiles/desktop。该脚本会核对既有 profile 的 pnpm 主版本并沿用原 store；版本不符时停止，可用 --pnpm /absolute/path/to/pnpm.cjs 指定宿主包管理器。本机宿主路径为 $HOME/.dsh/dsh-runtimes/dsh-primary-runtime/dependencies/pnpm/bin/pnpm.cjs。脚本会备份 profile 的 manifest / lockfile，将安装包按 SHA-256 保存在 profile 的 .prefix-packages/ 后安装并添加 bundle；不编辑宿主源码。安装脚本依赖注册表下载包自身的 Zod 依赖；不会发布到 npm，也不会执行依赖安装脚本。重启后在侧栏打开「提示词与前缀」。

回滚：退出 DSH，从脚本打印的备份目录恢复 package.json 和原有 lockfile，再运行 profile 依赖安装。会话内的原生消息仍保留；禁用插件后不会继续强制使用自定义 system。

使用

1. 在管理页建立系统模板，或在「对话前缀」页建立消息数组。工具历史必须包含完整的调用与结果配对。
2. 返回一个尚未发送的新会话。在模式选择器旁分别选择系统模板和前缀。选择完成以 Host 持久化确认后的显示为准。
右侧「自动上下文」「工具」可选全部启用、全部禁用或部分禁用；部分禁用时搜索并勾选目标，点击「应用」保存。「取消」、Escape 或点击菜单外部会放弃尚未应用的菜单选择。
3. 发送第一条真实消息。配置变为只读，输入区上方可展开快照；更换配置需新建会话。
4. 已选模板有新版本时，会话仍使用原先快照，可在未发送时重新选择以更新。删除模板不会改变已有快照。

示例前缀：

[
{ "role": "user", "content": "查询示例库存。" }, { "role": "assistant", "content": null, "tool_calls": [ { "id": "example_1", "type": "function", "function": { "name": "lookup_stock", "arguments": "" } } ] }, { "role": "tool", "tool_call_id": "example_1", "content": "" }, { "role": "assistant", "content": "示例库存为 12。" } ]

lookup_stock 不必是当前可执行工具。这里保存的是历史示例，插件不会执行该调用。前缀不能包含 system / developer、图片或音频；未知字段会报错，不会静默丢弃。

存储与兼容性

模板保存在宿主 storage domain custom_conversation_prefix，通过其既有 backend 持久化。选择、修订快照、应用 ID、摘要与初始化进度保存在会话的 ignorable plugin record 中；原生历史消息可在插件缺席时读取，不依赖自定义消息投影解释器。

安装版仅接受 kind=model 的 assistant。经用户确认，预设 assistant 使用 provider=dsh-prefix / model=user-authored，流记录为空数组，不声称发生了真实模型请求。预设工具 ID 添加 application ID 命名空间；tool/call 与 tool/result 日志用于宿主恢复校验，结果 meta 及快照明确记录合成来源。模型调用与工具执行都不在导入过程中发生。

初始化在公开 agent/request 钩子中执行：step 已打开，真实 user 还未追加。恢复未完成前缀时，保留 system 首节点，用公开 surface replacement 隐去半段历史和宿主自动补出的中断结果，再从快照重建；整个过程完成并 flush 后才允许模型请求。

自动上下文控制覆盖注册式运行环境和已识别的自动消息来源。DSH 0.2.1-rc.3 会在接纳请求前补回 required 事实，因此插件对公开的 SystemPrompt.refreshContext 方法安装可撤销的返回值适配；不编辑宿主源码、私有注册表或冻结后的请求。模型发送前只读核验禁用结果，未知自动来源或后加载插件绕过过滤时明确阻止发送。宿主升级需要重新验证。禁用后台环境信息不改变实际文件权限和审批规则。

可在插件配置中设置 maxMessages（默认 200，上限 2000）和 maxCharacters（默认及上限 100 万 UTF-16 代码单元）。配置变小后，超限的旧快照会在应用前被拒绝。JSON 边界另有请求体长度上限。

存在其他有效 complete section 时，宿主会明确报告冲突。DeepSeek 推理配置的工具历史可能需要 reasoning / replay 字段，首版明确拒绝这类组合，不伪造推理内容。其他提供方也可能有额外约束，静态格式通过不等于远端服务器必然接纳。

测试结果、真实请求概要与界面截图见 兼容性报告。已完成正式 Electron 安装、重启、模板保存、独立选择、深浅色、窄窗口和键盘操作验收；33 项基础测试及官方自动压缩后的磁盘恢复通过。未执行真实提供方请求，未使用正式 API Key。

轨迹兼容性

独立消息通过公开的 Conversation Definition 和 trajectory target 独占事件处理。0.2.1-rc.3 的轨迹标签类型尚未开放扩展，插件使用版本限定的 DOM 展示适配呈现角色标签、详情与时间轴颜色；不改写 Session 日志或模型请求。升级宿主后应先运行 npm run check，复核事件独占规则和展示锚点。聊天页通过独立 chat target 定义过滤预设历史事件，防止它们结算为真实回复或进入工具状态；真实消息沿用宿主展示。