协作风格配置 Diluka/dsh-persona

dsh-persona

dsh-persona 是 DeepSeek Harness 的双端插件，为模型请求加上一层可配置的协作风格。它面向安装或使用 DSH Web 的人，带一个小设置页，用来选择编码智能体怎么跟你沟通。

插件在顺序 5 处贡献一个面向协作的系统提示词区块，位置在 DSH 的核心身份与部署配置档前缀之后。它负责引导任务归属、基于证据的工作、进度汇报和语气；核心提示词、工具策略、安全规则和运行时行为仍由 DSH 掌管。

它加了什么

- 由配置档支撑的 dsh-persona 插件设置，用于选中的风格和共享提示词。
- 宿主侧的系统提示词区块，名为 dsh-persona:style。
- DSH Web 设置里的一节，插件行运行时用来配置风格。
- 两个内置风格选项，界面显示中文：友好协作 和 务实直接。
- 一个可编辑的通用提示词块，会拼在选中风格之前。

当前 UI 有意不做最终注入提示词的预览。你分别配置共享块和选中的风格；宿主在请求时渲染最终的提示词区块。

安装

需要 Node.js 22 或更高版本。兼容基线是 DSH 0.2.0-rc.2，与开发依赖一致。CI 的 Web 冒烟测试用同一个版本验证包安装与启动。

从仓库把插件装进 DSH Web 配置档：

dsh plugin --profile web add github:Diluka/dsh-persona

重启 DSH Web 配置档，让 Cordis 补丁挂载插件，然后打开现有的 DSH Web GUI。

如果这个包之后发布到 npm，可以用包名安装，配置档目标不变：

dsh plugin --profile web add dsh-persona

设置页

在 DSH Plugins 管理器里用 dsh-persona 组件行启动或停止插件。该行运行时，打开 DSH Web，进入：

Settings -> 沟通风格

取决于当前 UI 语言或导航标签，这一节也可能显示为 Communication Style。

这个专用页面目前提供：

- preset：保存选中的内置风格。
- 风格选择器：用 DSH 风格的下拉触发器，而不是浏览器原生 select 控件。
- 风格提示词预览：紧跟在选择器后面，显示完整的只读风格提示词。
- shared：编辑风格之前应用的通用提示词块；这个编辑器出现在最后。
- 重置操作：恢复继承来的通用提示词（插件默认值，除非组合提供了别的）；保存后生效。

改动通过所选配置档的 DSH Settings 表单持久化，并作用于后续的模型请求。如果某个智能体预设注册了 complete 系统提示词区块，DSH 会有意省略其他区块，包括这层风格；插件不会绕过这个预设约定。

运行时存储

运行时选项位于配置档的 dsh-persona 插件条目中，通过 DSH Settings 表单编辑。根 Config 标记为 volatile，因此编辑后无需重启即可更新提示词层。

挂载插件时仍可提供组合默认值：

- id: dsh-persona
name: dsh-persona
config:
preset: pragmatic
shared: |-
Work Presentation

- Keep the user clearly informed about ongoing actions without unnecessary detail.

设置页面的编辑会持久化到所选配置档的 Cordis 组合。清除覆盖项后，会恢复从组合继承的值。

安全与范围

dsh-persona 是风格层，不是智能体行为的控制平面。

- 它只追加一个额外的系统提示词段落，不替换 DSH 的核心提示词。
- 它引导完成已授权的工作、提出聚焦的问题、使用证据、验证变更并沟通结果。
- 它不实现记忆、偏好学习、聊天记录蒸馏或长期用户画像。
- 它不授予工具、不更改沙箱或审批策略，也不扩大文件/网络访问权限。
- 内置风格文本为只读，确保已安装的行为保持可预测；用户改为自定义 shared 块。

最终权限仍归 DSH 的宿主组合、活动智能体配置、工具定义、沙箱策略、审批策略和模型路由。

风格

默认的通用提示词鼓励借助 DSH 可用工具和交互功能，养成类似 Codex 的协作习惯：

- 将实现请求贯穿检查、变更、相关校验和清晰结果；尊重提问、审查和仅规划类请求。
- 根据上下文做出常规、可逆的决定，并在现有授权范围内继续工作。遇到重大选择或所需审批尚未解决时，先询问。
- 在后续跟进中保留目标和已完成的工作；用证据从失败中恢复，并报告真正的阻塞。
- 检查相关源码，在支持时批量处理独立工作，保持变更范围收敛，并保留无关的用户编辑。
- 给出简洁的进度更新，区分已完成的工作、观察到的校验结果和剩余的不确定性。

风格选择器改变语气，同时保留相同的共享工作指引：

- friendly / 友好协作：温和、耐心的解释和亲切的协作，不做例行表扬，也不增加额外确认步骤。
- pragmatic / 务实直接：直接给出结论、具体建议，并简洁讨论相关权衡。

这些提示词引导行为；它们不复制 Codex 的运行时，也不保证相同的模型表现。DSH 的活动模式、工具可用性和审批规则仍然适用。
升级时，显式配置的 shared 值会保留，包括空字符串。没有 shared 值的配置档会自动使用新默认值。如果配置档保存了覆盖值，先保留你仍然需要的自定义指令，然后在 Settings -> 沟通风格 里使用 恢复默认共通提示词（Reset shared prompt）并保存。重置会恢复继承的组合值，找不到时回退到已安装插件的默认值；如果组合本身提供了旧的 shared 块，更新或删除该组合值即可采用新默认值。

DSH 组件行开关属于无样式层的情况；插件 Config 只包含选中的样式和共通提示词。

架构概览

本仓库是 DSH 插件包，不是独立的 Web 应用。

- 宿主入口：注册由设置驱动的运行时行为，并贡献渲染后的 systemPrompt 区块。
- 提示词模型：把共通/样式渲染逻辑与 DSH 副作用分开。
- 客户端入口：在 DSH Web 内注册 settings.section UI，通过 configForms 读取 dsh-persona 条目，只写入易变字段。
- 配置档补丁：把插件挂载到 DSH 组合中，可带默认值。

运行时，宿主读取易变的插件 Config，把共通提示词块与选中的只读样式提示词合并，再把结果作为样式区块追加到后续模型请求。客户端只编辑配置档配置，不负责提示词注入。

卸载

从 DSH Web 配置档中移除插件：

dsh plugin --profile web remove dsh-persona

移除后重启 DSH Web 配置档，组合就不再挂载该插件。

样式选项属于配置档的插件配置，而不是独立的运行时设置存储。剩余的组默认值或覆盖值由该配置档的 Cordis 补丁管理。

开发与验证

安装依赖并运行项目检查：

pnpm install --frozen-lockfile
pnpm check

不发布，只验证包内容：

pnpm pack:dry-run

测试覆盖纯提示词逻辑、模拟的 Host 接线、真实的 Cordis/system-prompt 注册、易变 Config 解析、设置表单策略清理、字面量 {{...}} 文本，以及完整提示词优先级。

CI 会打包插件，用 DSH 0.2.0-rc.2 把该 tarball 安装到临时 DSH Web 配置档，启动 dsh web，如果服务器无法访问或提前退出就判定失败。这个冒烟测试验证的是包安装和服务器启动，不是浏览器交互。

本地验证流程：

1. 把插件安装或链接到 DSH Web 配置档。
2. 重启该 DSH 配置档，让 Cordis 补丁挂载。
3. 打开现有的 DSH Web GUI，通常是 http://127.0.0.1:3080。
4. 确认 DSH Plugins 管理器显示 dsh-persona 正在运行，且 Settings -> 沟通风格 可用。
5. 选择样式，编辑 shared，确认后续模型请求体现了样式层。
6. 在 DSH Plugins 管理器里停用 dsh-persona 组件行，确认设置页面和样式层消失；重新启用该行即可恢复。

不要通过启动替代的 Vite 服务器来验证这个包；DSH Web 为插件提供运行时启动上下文。

当前范围

现已包含：

- 全局 DSH 样式提示词层；
- dsh-persona 中由配置档支持的 preset 和 shared 配置；
- 组件行运行时专属的 DSH Web 设置区块；
- 用于选择样式的 DSH 风格自定义下拉菜单；
- 可编辑的公共提示词块，支持重置；
- 只读的 friendly 和 pragmatic 样式提示词；
- 中文样式标签 友好协作 和 务实直接；
- 设置界面中不提供最终注入提示词预览。

等有具体需求后再做：

- 用户自定义样式；
- 样式包导入/导出；
- 按智能体、按会话或按工作区覆盖；
- 提示词 diff/历史界面；
- 记忆或偏好学习功能；
- 针对运行中的 DSH 配置档做更丰富的浏览器 E2E 覆盖。