协作风格配置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.1.5-rc.1（npm latest）；开发依赖和 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

设置页面

主开关位于：

Settings -> 插件 -> dsh-persona

当 enabled 关闭时，专用的沟通风格设置页面不会被注册，提示词层也不会被追加。

启用后，打开 DSH Web 并转到：

Settings -> 沟通风格

根据当前 UI 语言或导航标签，该区段也可能显示为 Communication Style。

该专用页面目前提供：

- preset：存储所选的内置风格。
- 风格选择器：使用 DSH 风格的下拉触发器，而非浏览器原生的 select 控件。
- 风格提示词预览：在选择器之后直接显示完整的只读风格提示词。
- shared：编辑在风格之前应用的通用提示词块；该编辑器出现在末尾。
- 重置操作：将通用提示词恢复为插件默认值。

更改通过 DSH 设置存储，并应用于后续的模型请求。如果某个代理预设注册了 complete 系统提示词区段，DSH 会有意省略额外的区段，包括此风格层；该插件不会绕过该预设约定。

运行时存储
运行时配置存储在 DSH 设置命名空间中：

dsh-persona

该命名空间包含渲染提示词层所需的面向用户的选项，包括该层是否启用、选择了哪种风格，以及共享的提示词文本。

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

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

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

从 Web 页面保存的设置会通过同一个 dsh-persona 命名空间在运行时生效。

安全性与范围

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

- 它追加一个额外的系统提示词部分；它不会替换 DSH 的核心提示词。
- 它专注于沟通风格、协作语气、进度更新、验证摘要以及下一步措辞。
- 它不实现记忆、偏好学习、聊天历史蒸馏或长期用户画像。
- 它不授予工具、不更改沙箱或审批策略，也不扩大文件/网络访问权限。
- 内置风格文本为只读，以确保已安装的行为保持可预测；用户改为自定义共享块。

实际权限仍归属于 DSH 的宿主组合、活动智能体配置、工具定义、沙箱策略、审批策略以及模型路由。

风格

默认的通用提示词是一个更大的 Codex 风格输出指导块，已针对 DSH 重写。它涵盖简洁的队友语气、具体的进度更新、命令输出摘要、验证状态以及自然的下一步，同时保留 DSH 特有的措辞。

风格选择器会添加一个完整的、适配 DSH 的 Codex 人格模板：

- friendly / 友好协作：针对团队士气、支持性协作、结对、入职引导以及温和升级进行优化。
- pragmatic / 务实直接：充当一个深度务实、高效的 DSH 编码队友，具备明确的推理、严谨性以及简洁的权衡讨论。

对于无风格层的情况，插件使用 enabled: false，而不是暴露第三个风格选项。

架构概览

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

- 宿主入口：注册由设置支持的运行时行为，并贡献渲染后的 systemPrompt 部分。
- 提示词模型：将共享/风格渲染逻辑与 DSH 副作用保持分离。
- 客户端入口：在 DSH Web 内为 dsh-persona 命名空间注册一个 settings.section UI。
- Profile 补丁：将插件挂载到 DSH 组合中，并可选提供默认值。

在运行时，宿主读取设置，将通用提示词块与所选只读风格提示词组合，并将结果作为风格部分追加到未来的模型请求中。客户端只写入设置；它不负责提示词注入。

卸载

从 DSH Web profile 中移除该插件：

dsh plugin --profile web remove dsh-persona
移除插件后重启 DSH Web 配置文件，这样组合就不再挂载该插件。

如果运行时设置仍保留在 DSH 设置存储中，一旦插件被移除，它们就处于惰性状态。重新安装插件时，可能会复用现有的 dsh-persona 命名空间值，具体取决于本地 DSH 设置存储的保留方式。

开发与验证

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

pnpm install --frozen-lockfile
pnpm check

在不发布的情况下验证包内容：

pnpm pack:dry-run

测试覆盖纯提示逻辑、模拟的 Host 接线，以及固定版本 DSH 的真实 Cordis、系统提示和设置服务：实时变更、禁用/重置、可选提供者的附加/分离，以及卸载清理。它们还验证包含 {{...}} 的共享文本保持字面量，以及完整提示预设保留控制权。

CI 还会打包插件，将该 tarball 安装到临时 DSH Web 配置文件中，启动 dsh web，如果服务器无法访问或提前退出则失败。此冒烟测试证明的是包安装和服务器启动，而非浏览器交互。

有用的本地验证流程：

1. 将插件安装或链接到 DSH Web 配置文件中。
2. 重启该 DSH 配置文件，以便挂载 Cordis 补丁。
3. 打开现有的 DSH Web GUI，通常为 http://127.0.0.1:3080。
4. 确认 Settings -> 插件 -> dsh-persona 显示主开关。
5. 启用它并确认 Settings -> 沟通风格 出现。
6. 禁用它并确认专用的 沟通风格 页面消失。
7. 重新启用它，选择一种风格，编辑 shared，然后验证后续模型请求反映该风格层。

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

当前范围

现在包含：

- 全局 DSH 风格提示层；
- dsh-persona 中由设置支持的运行时配置；
- 带有主开关的 DSH Web 插件配置卡片；
- 仅在启用时加载的专用 DSH Web 设置部分；
- 用于选择风格的 DSH 风格自定义下拉菜单；
- 可编辑的通用提示块，支持重置；
- 只读的 friendly 和 pragmatic 风格提示；
- 中文风格标签 友好协作 和 务实直接；
- 设置 UI 中不显示最终注入提示预览。

推迟到有具体需求时再做：

- 用户自定义风格；
- 风格包的导入/导出；
- 按代理、按会话或按工作区的覆盖；
- 提示差异/历史 UI；
- 记忆或偏好学习功能；
- 针对运行中的 DSH 配置文件的更丰富的浏览器 E2E 覆盖。