dsh-preset-chat

English | 中文

为 DeepSeek Harness 增加 聊天模式 的 Agent preset bundle——与内置 standard / ptc / minimal / cordis 平级的纯对话模式。 新版 DSH 0.2.1 的图片兼容：生成结果通过独立的 Conversation 节点显示在最终回答后；图片组件与 imagegen 工具卡片均支持右键操作和会话内方向键切图。保留原生回答与工具渲染，不修改会话消息或项目文件。

Preset 提供的内容

在 cordis.patch.yml 中以一行 @deepseek-ai/dsh-agent-preset 声明（config.id: chat，行 id preset-chat）：

插件	效果
@deepseek-ai/dsh-persona	完整英文人设——“各领域顶尖、无所不能、为主人服务”；回答清晰自然、默认简体中文、Markdown 排版，带主动搜索/澄清/生图习惯（complete: true，不注入运行时上下文块）
@deepseek-ai/dsh-tool-ask-user	ask_user_question——意图含糊时先澄清再作答
dsh-preset-chat/attachments	read_uploaded_file——读取当前会话上传的文本、PDF、DOCX 和 XLSX 文档
@deepseek-ai/dsh-tool-web	web_search + web_fetch（开启抓取，搜索超时 60s）
@deepseek-ai/dsh-compaction-basic + command-compact	自动上下文压缩、工具结果裁剪、/compact 命令

profile 层能力自动可用（不归 preset 管辖）：imagegen（来自 dsh-codex）与 schedule_* 提醒工具组。上传文档可通过只读工具读取；不添加 bash、任意本地文件访问、终端、子代理、goal 或 plan-mode。

聊天模式固定为项目文件只读，并禁止沙箱提权，不继承其他模式或全局默认的写权限。/permission 可查看这一固定策略，不能将聊天模式改为可写。切出聊天模式时恢复该会话进入聊天模式前的权限；其他会话、其他模式和全局默认设置保持不变。权限及恢复记录可跨重启保留。

聊天模式不向模型自动注入当前工作目录，发送请求前的上下文刷新也不会重新带入目录。后台目录管理和文件权限仍正常工作，其他模式继续保留原生工作目录上下文。已有会话历史中的路径及用户主动提供的路径不会被删除。

聊天模式中的 imagegen 沿用现有生图服务、模型设置和参考图片处理，结果保留为聊天附件，不自动写入项目文件夹，也不提供 output_path 参数。附件、会话、人设等应用数据仍可正常保存。其他模式的生图自动保存行为保持不变。

在聊天图片的放大预览中，按键盘 ← / → 可按出现顺序切换本会话已发送和生成的图片，包括尚未滚动加载的历史图片。同一附件只出现一次，预览显示当前位置，到首尾停止切换。Esc 先关闭右键菜单，再关闭预览。

生成的图片会持续显示在本轮聊天回答下方，不随工具过程折叠；重新打开会话或重启后也能恢复。展示直接复用现有附件，不增加消息、不额外写入项目文件。

在聊天图片缩略图或放大预览上右键，可选择「在新标签页中打开图像」「添加到聊天」「复制图像」「下载副本」「在 Finder 中显示」。新标签页使用应用内文件预览；添加到聊天只加入输入框，等待手动发送；下载副本保存原图；Finder 直接定位现有附件文件，不另外复制，也不放开模型的项目写权限。此前生成的聊天图片也支持。

安装

插件管理器 → 安装 bundle → dsh-preset-chat（npm），或指定本地 tarball：

pnpm pack   # 产出 dsh-preset-chat-<version>.tgz

然后通过插件管理器安装。live profile 即时生效；内容变更需要重启 Host。

上传文件与文档问答

点击 ＋ → 文件、将文件拖入输入框，或粘贴图片，再带上问题一起发送。上传入口、附件卡片和文件存储均沿用 Harness 原有机制。图片走当前模型的原生视觉通道，因此需要选择支持图片的模型。

read_uploaded_file 可列出并读取当前会话实际发送过的文档，上下文压缩后也可读取。桌面端选择的文件以 @路径 引用发送，也支持读取。可按文件名、附件 ID 或用户明确选中的路径选择；不能读取未引用的其他本地文件。支持 UTF-8/UTF-16 的 TXT、Markdown、CSV/TSV、JSON/JSONL、YAML、XML、HTML 和日志；带文字层的 PDF；Word DOCX；Excel XLSX（工作表名称、单元格地址及显示值或缓存值，不执行公式）。旧版 DOC/XLS 请先转换。附件内容作为参考资料，不作为修改系统或用户指令的授权。

解析上限：单文件 20 MiB、PDF 300 页、提取文本 200 万字符、表格 10 万个非空单元格及 1000 列。每次返回最多 16000 字符，并用 next_offset 继续读取。解析在独立且受内存限制的工作线程中进行，30 秒超时。扫描版 PDF 需要 OCR；文档内嵌图片和复杂版式不由文本读取工具还原。

子人设

子人设与基础人设使用同一套指代：“你 / you”指模型，“用户 / the user”指使用者。内置人设遵循这个约定；升级不会改写用户自定义的人设文案。

人设文案的末尾留了一个模板槽——…{{sub_persona}}——由本 bundle 的运行时随行按会话从配置好的身份库里填入。两种选择方式，都在模型的能动性之外：

选择器——在新会话页面，选中「聊天模式」后，项目文件夹、模式右侧会出现同一行的子人设下拉。选择「基础人设」或配置好的身份；选中其他模式时隐藏该下拉。它复用原生模式选择的状态与菜单组件，不另占一行。选择器不要求开启开发者工具。选择会自动保存为新会话默认人设。进入会话后，输入框原权限下拉的位置显示人设下拉，可直接选择下一轮回答的人设；其他模式仍显示权限下拉。

斜杠命令——执行完全不经过模型：

/persona            # 列出可用子人设，并标出当前身份
/persona 面试官      # 切换（支持精确、大小写不敏感、唯一子串匹配）
/persona -          # 回到基础人设

新会话默认选择和每个会话的选择分别持久化，重启后恢复。切换从下一轮回答起生效；已经生成中的回答及其工具续接保持原人设。因此两个会话可以同时持有两个不同身份。工具能力不受影响——身份属于提示词工程，不是模型自己决定要不要调用的能力。

在人设下拉中选择「管理人设…」，即可新增、编辑、重命名和删除子人设。重命名保留现有选择；删除后，使用它的默认选择和会话从下一轮回到基础人设。保存失败会显示错误；多个窗口同时编辑时会提示重新载入，避免覆盖他人的修改。

内置身份来自 chat-personas 行的 config.personas，界面保存的修改优先。人设库和选择通过 Harness 的 storageDomain 原子保存，独立于安装包；更新 bundle 不会清空它们。该行挂在 profile 层，由 config.presets 限定生效范围（默认仅 chat）。选择器是本 bundle 的 Web 半区（lib/client.js，经 dsh.client 声明），通过 /api/chatPersonas/* 这条 Connection RPC 通道与 node 半区通信。

会话选择采用原生的逐条存储，保存时不再重写整张会话表。旧选择在首次加载时迁移，中断后可安全重试。启动时只清理在原生实时与持久化存储中均确认不存在的会话记录；归档会话及读取失败的记录保留。删除自定义人设不再留下删除标记；内置人设保留屏蔽标记，防止重新出现。菜单在打开、窗口获得焦点及修改成功后刷新，保留有限的启动重试，不进行常驻轮询。

dsh.client.inject 描述客户端插件图中的依赖边，不等同于每个 require。本 bundle 保留原生的空声明，React、React DOM 和基础控件沿用 Host 提供的基础模块；所需 Cordis 服务由客户端导出中的注入声明管理。不把普通模块名随意添加为插件依赖边，以免改变启动顺序。

验证

在本仓库执行 npm ci、npm test。测试使用本地 React/jsdom 依赖及已安装 Desktop 的运行时与 Conversation 构建产物，不依赖其他源码 checkout。其他安装位置可通过 DSH_TEST_EXECUTABLE 和 DSH_TEST_RUNTIME 指定；缺少 Desktop 运行时会明确报错。

自定义

修改 cordis.patch.yml（人设文案、子人设库、工具列表、order、description），重新打包安装即可。行 id preset-chat 是 Loader 编辑地址；config.id: chat 是写入会话的标识符。

说明

• lib/index.js 通过每个 agent context 的服务注入子上下文——agent.ctx.inject(['systemPrompt', 'commands'], …)——注册 sub_persona 提示词变量与 /persona 命令，因此两者都限定在单个 agent 作用域内。读取 agent 工厂上下文未声明的服务会抛错而不是返回 undefined，而可选链挡不住会抛错的 getter；0.7.0 正是踩了这一点，导致所有模式的会话创建与恢复一起失败。
• 提示词变量的 provider 若返回 undefined，会导致引用它的整个 section 渲染失败，所以除逐 agent 的提供者外，还注册了一个返回 '' 的全局兜底提供者。
• 需要带 agent-preset 体系（@deepseek-ai/dsh-agent-preset）的 DSH profile。

许可

MIT