纯聊天预设 DonaldKellett/dsh-chat-preset

dsh-chat-preset

为 DeepSeek Harness（DSH）准备的纯聊天智能体预设和 code-tutor 技能。

Chat 预设把 DSH 会话变成一个普通聊天机器人。它能读你输入的文字和你上传的图片，能搜索和抓取网页，还能通过一个技能充当编程讲师。它没有文件系统工具、没有 shell、没有后台任务、没有子代理、没有计划模式、没有目标——所以它读不了也改不了你的工作目录，也驱动不了 DSH 所在的那台机器。

- preset/chat.patch.yml —— 预设声明。
- skills/code-tutor/SKILL.md —— 技能。

目录

- 你能得到什么
- 环境要求
- 安装
- 使用 Chat 预设
- 卸载
- Chat 预设能做什么、不能做什么
- code-tutor 技能
- 验证安装
- 仓库结构
- 开发
- 持续集成
- 测试环境
- 故障排查
- 许可证

你能得到什么

Chat 预设

一个名为 Chat 的会话预设，可以按会话选择，和内置的 standard、ptc、minimal、cordis 预设一样。在它里面，智能体：

| 能力 | 状态 |
| 读你输入的提示词 | 是 |
| 看你上传或粘贴的图片 | 是 |
| web_search（DeepSeek 搜索） | 是 |
| web_fetch（公开的 HTTP/HTTPS 页面） | 是 |
| 加载 code-tutor 技能 | 是 |
| 在 UI 里向你提澄清问题 | 是 |
| 长对话压缩 | 是 |
| 读写文件（read、write、edit、glob、grep） | 否 |
| 运行 shell 命令（Bash / PowerShell） | 否 |
| 后台任务和终端 | 否 |
| 子代理、工作流、委派 | 否 |
| 计划模式、目标、待办 | 否 |
| 读 AGENTS.md / 项目指令 | 否 |

子插件的准确清单是 preset/chat.patch.yml 里的七行：

@deepseek-ai/dsh-persona
@deepseek-ai/dsh-skill-filesystem (scans only the Chat skill root)
@deepseek-ai/dsh-tool-skill
@deepseek-ai/dsh-tool-web (search + fetch)
@deepseek-ai/dsh-compaction-basic ┐ one cordis:group
@deepseek-ai/dsh-compaction-tool-result-pruner ┘ carrying an isolate realm
@deepseek-ai/dsh-tool-ask-user

两行压缩配置共用一个 cordis:group 行，该行携带 isolate: { compaction: true, toolResultPruner: true }。这是硬性要求，不是装饰：DSH 预设不能把服务发布到根 realm，而这两行提供的正是 compaction 和 toolResultPruner 服务。没有这个 realm，DSH 会拒绝整个预设，报错 Preset services require isolate realms: compaction, toolResultPruner.，它永远不会进入会话选择器。realm 还给每个预设修订版配了自己的压缩后端，所以两个跑在不同修订版上的活动会话永远不会共用同一个。

其他东西一律不挂载。尤其是，这个预设刻意不挂载 dsh-tool-fs、dsh-tool-fs-search、dsh-tool-bash、dsh-tool-pwsh、dsh-tool-jobs、dsh-terminal，也不挂载子代理/工作流/Ralph 委派那一组、dsh-tool-todo、dsh-plan-mode、目标那一组、dsh-tool-present（它把文件当交付物发布）、dsh-agent-instructions（它从工作目录里读 AGENTS.md）、插件管理器，以及任何文件系统后端。

code-tutor 技能

一个编程教学技能：模型当讲师，你当学生。它把代码改动连同精确位置一起交给你，讲解每段代码做什么、为什么能跑通；如果是从零开始写，它只给最精简的「Hello World」脚手架，再加接下来几步。它绝不甩给你一个完整的成品文件，也绝不替你实现整个项目。

这个技能还带一条明确、无条件的指令：绝不读、写、编辑或删除文件，绝不碰操作系统——哪怕外层 harness 提供了这些工具。这让它可以移植：你可以把 skills/code-tutor/ 搬到另一个沙箱更弱的 harness 里，讲师照样会拒绝替你写作业。

环境要求

- DeepSeek Harness，版本 0.2.0-rc.2（见测试环境）。
- 一个支持 agent-preset 的配置档。这个预设是一行 @deepseek-ai/dsh-agent-preset，随附的 web bundle（浏览器界面和桌面应用都用它）会提供。默认的 desktop 配置档就符合要求。
- 一份 DeepSeek 凭据。预设复用聊天模型用的同一个 DEEPSEEK_API_KEY（或托管账户凭据）；web_search 由 DeepSeek 搜索服务商用同一份凭据提供。
- 不需要第三方插件或额外包。 预设挂载的一切都随 DSH 一起发布。
- 安装脚本和校验脚本需要：Node.js 22+（桌面应用自带的 Node 在 Windows 和 macOS 上会自动找到），以及 PowerShell 5.1+ 或 POSIX shell（Linux/macOS 上用 bash，Windows 上用 Git Bash）。

安装

克隆仓库，然后按你的 shell 运行安装脚本。安装脚本是幂等的：再跑一次会替换掉上一次的安装。

Windows（PowerShell）

PowerShell 默认的执行策略会拦截本地脚本，所以要用 -ExecutionPolicy Bypass 调用（脚本本身不需要提权）：

git clone https://github.com/DonaldKellett/dsh-chat-preset.git
cd dsh-chat-preset
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1

Linux、macOS，或 Windows 上的 Git Bash

git clone https://github.com/DonaldKellett/dsh-chat-preset.git
cd dsh-chat-preset
./scripts/install.sh

安装器做了什么

1. 把技能复制到 "$DSH_HOME/presets/chat/skills/code-tutor/SKILL.md"。
这是 Chat 预设扫描的唯一根目录，正因如此，code-tutor 成了它内部唯一可用的技能。
2. 把同一个技能复制到 "$DSH_HOME/skills/code-tutor/SKILL.md" —— 标准用户技能根目录 ——这样你也能在内置的 standard、ptc、minimal、cordis 预设里使用 code-tutor，在任何工作区、以及其他 DSH 界面里都能用。传 --no-global-skill（-NoGlobalSkill）可跳过这一步。
3. 把预设声明追加到目标配置档的 cordis.patch.yml，用 # >>> dsh-chat-preset ... >>> / # <<< dsh-chat-preset <<< 标记包起来。
该文件里原有的内容一律不动。写入的块是 UTF-8、不带字节序标记，文件原有的换行符也保持不变，所以除了新增的块，文件跟原来一模一样 —— 安装后再卸载，能逐字节还原。

$DSH_HOME 默认是 ~/.dsh。需要的话可以覆盖配置档或 home：

./scripts/install.sh --profile desktop --dsh-home /home/me/.dsh

powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1 -Profile desktop -DshHome C:\Users\me\.dsh

激活

重启 DeepSeek Harness。 预设名单在启动时组装，所以正在运行的实例看不到新预设。
重启后，Chat 预设会出现在预设名单里（Settings → Agent presets），也会出现在输入框的预设选择器里。
应用和系统重启后它依然保持安装状态 —— 这里没有任何东西是会话状态。

使用 Chat 预设

1. 新建一个会话。
2. 在预设选择器里选 Chat（或者在 Settings → Agent presets 里把它设为默认）。
3. 跟它对话。随便上传图片、粘贴截图 —— 模型能直接看到。可以要求 /code-tutor，也可以直接问编程问题，任务匹配时模型会自己加载技能。

只有在会话还是空白、第一轮对话开始之前，才能选择预设。

卸载

./scripts/uninstall.sh

powershell -ExecutionPolicy Bypass -File .\scripts\uninstall.ps1

卸载器只删除本项目安装的东西：

- 配置档 cordis.patch.yml 里受管理的预设块（你其他的条目和注释都保留）；
- "$DSH_HOME/presets/chat/skills/code-tutor"，以及它创建后已变空的 presets/chat/ 目录树；
- "$DSH_HOME/skills/code-tutor"，除非你传 --keep-global-skill（-KeepGlobalSkill）。

它绝不会删除 $DSH_HOME/skills 目录本身，所以你放在那里的其他技能都能留下。
之后重启 DeepSeek Harness，把预设从名单里移除。

安装/卸载循环可以放心重复：干净卸载后再全新安装，能复现出完全相同的状态。

Chat 预设能做和不能做的事

保证

- 无文件系统访问。 没有挂载文件系统后端，也没有注册文件系统工具，所以模型看不到 read、write、edit、read_image、glob 和 grep。也不存在「随处可读」的后门，因为预设的作用域里根本没有文件系统服务。
- 无命令执行。 没有挂载 shell、终端、后台任务或子进程工具。
- 无工作区指令。 没有挂载 dsh-agent-instructions，所以 AGENTS.md 和类似文件永远不会被读取。
- 无运行时上下文泄漏。 persona 行设置了 includeRuntimeContext: false，所以模型收不到工作区、沙箱、审批或委派快照。
- 只有一个技能。 预设的技能服务商设置了 includeDefaultRoots: false，跳过项目根目录（<project>/.dsh/skills、<project>/.agents/skills）、用户根目录（$DSH_HOME/skills、~/.agents/skills）以及内置的办公技能。它唯一的 customSkillDirs 条目是专用的 Chat 技能根目录。
- 无第三方代码。 每一行都是随 DSH 一起发布的官方 @deepseek-ai/dsh- 包。运行时不会拉取、构建或安装任何东西。

已知限制

- 上传的非图片文件在 Chat 里读不了。 普通文件附件到达模型时，只有名称、大小和只读存储路径。读取该路径需要 read 工具，而随附的文件系统后端（dsh-fs-local、dsh-fs-sandbox）没有读取路径白名单——它们只限制写入。因此，为了支持上传而挂载 read，会让智能体读到机器上的任何文件，这违背了预设的初衷。这个取舍是刻意为了隔离而做的：Chat persona 会让模型直接说明它读不了该文件，并请你粘贴文本，或者改用启用了文件系统的预设来完成该任务。图片不受影响——它们会原生送达模型。
- 网络是真实的出站通道。 web_fetch 可以请求任何公开的 HTTP/HTTPS URL，所以模型放进 URL 的任何内容都会离开本机。DSH 的 HTTP fetch 服务商会拦截非公开目标，但抓取前不会请求确认。预设就是这样刻意发布的；如果你更希望只搜索，请在 preset/chat.patch.yml 里设置 fetch: false 并重新安装。
- 预设不是操作系统级沙箱。 它移除的是智能体的工具，并不对 DSH 进程做沙箱隔离。DSH 自身的沙箱与审批设置仍然作用于整个进程。
- 沙箱模式在这里不起作用。 因为 Chat 没有挂载任何文件或 shell 工具，会话的权限模式没有可作用的对象。
- 从 GUI 编辑预设会把它固定下来。 设置 → Agent presets 可以把某个预设的完整配置覆盖写入 profile 补丁。如果你在那里编辑 Chat，GUI 的副本会压过受管块，重新运行 install.sh 不会改动正在使用的预设，除非先移除那条覆盖配置。建议直接编辑 preset/chat.patch.yml 再重新安装。

code-tutor 技能

用 /code-tutor 显式调用它，或者当你的请求符合它的描述时，让模型自行加载。

导师会：

1. 给出修复、改进或扩展你所展示代码所需的代码；
2. 明确说明每处改动放在哪里——文件、函数、类、方法或行号范围——编辑工作留给你；
3. 解释每一段代码：它做什么、为什么可行、为什么放在那个位置、需要注意什么；
4. 对于从零开始的工作，只给出最小的「Hello World」脚手架，解释其中每个组成部分，并列出接下来两到三步。

导师不会：

1. 一上来就粘贴完整的更新后源文件；
2. 用没有解释的代码、光秃秃的 diff 或一个链接来回答；
3. 替你构建完整、可运行、非平凡的项目。

导师绝不能（这条规则写在技能本身里，所以它会随技能一起进入其他 harness）：

1. 读取、写入、编辑、创建、移动、重命名、复制或删除任何文件或目录；
2. 与操作系统交互——不执行 shell 命令、不启动进程、不安装、不联网、不改动系统状态；
3. 请求上述任何操作的权限。

只能基于你粘贴到对话里或作为图片上传的内容工作。导师需要看什么时，会让你粘贴过来。

因为技能文本无条件带有这三条规则，把它安装到没有智能体沙箱的 harness 里也是安全的：即使文件工具和 shell 工具可用，指令也要求拒绝使用它们。

验证安装

scripts/verify.mjs 对已安装的预设执行离线结构检查，不需要运行中的 DSH 实例。

./scripts/verify.sh

powershell -ExecutionPolicy Bypass -File .\scripts\verify.ps1

它会检查：配置档补丁能否解析为 Cordis 条目列表 YAML（包括 !!js 表达式）；Chat 预设行是否存在、已启用、标识唯一，并且恰好声明了允许列表中的七个子插件，不含任何被禁止的文件系统/shell/操作系统能力族；skill-filesystem 是否仍然只扫描 Chat 技能根目录且 includeDefaultRoots: false；已安装的技能文件是否与仓库副本一致；Chat 技能根目录是否恰好暴露 code-tutor。

要做完整 YAML 校验，先安装开发依赖（pnpm install 或 npm install）；没有它，验证器会退回结构检查并说明这一点。包装脚本先在 PATH 里找 Node.js，然后到桌面应用自带的运行时里找；把 DSH_BUNDLED_NODE 设为可执行文件路径可以覆盖这一查找。传入 --quiet（-Quiet）可让每项检查只输出一行。

仓库结构

preset/chat.patch.yml Chat 预设声明（一个 Cordis 补丁列表）。
skills/code-tutor/SKILL.md code-tutor 技能。
scripts/install.{sh,ps1} 把预设 + 技能安装到 DSH home。
scripts/uninstall.{sh,ps1} 只删除 install 添加的内容。
scripts/verify.{sh,ps1} 安装后的结构检查（包装脚本）。
scripts/verify.mjs 校验器本体（Node.js）。
scripts/check-yaml.mjs 全仓库 YAML + 预设形状校验（CI）。
scripts/live-check.mjs 维护者工具：用 DSH 自己的 Loader、表达式求值器和插件 schema 加载预设。
tests/preset-shape.test.mjs node:test 测试套件，覆盖预设和技能。
.github/workflows/validate.yml CI：YAML/JSON 语法、测试、shellcheck、actionlint。
.github/ CI 配置。
package.json 仅开发工具（js-yaml）；不发布任何内容。
.gitattributes 换行符规范化（LF，.ps1 除外）。

这里没有源代码，也没有自定义插件。预设是纯配置，由 DSH 的 Cordis Loader 读取；技能是 Markdown。没有任何东西需要编译，所以没有构建步骤，也没有构建产物需要提交——.gitignore 和 .gitattributes 一起在每个平台上拦截编译输出，以防将来某次改动引入自定义插件。

开发

不安装任何东西也能校验仓库： bash
pnpm install # only needed once, for js-yaml
pnpm run check:yaml # YAML dialect + preset shape + skill frontmatter
pnpm test # the same guarantees through node --test

重新跑一遍安装，并端到端验证： bash
./scripts/install.sh && ./scripts/verify.sh

维护者：拿真实 harness 校验预设

scripts/check-yaml.mjs 只能证明 YAML 格式正确。scripts/live-check.mjs 更进一步：它用 harness 自己的 entry-list schema 加载 preset/chat.patch.yml，用 Loader 自己的求值器计算每个 !!js 表达式，从 app.asar 导入每个子插件包，拿每个插件自己的 Config schema 校验对应行，在干净的 Cordis 上下文里激活每个插件，然后挂载真实的 skill-filesystem 服务商，对接一个桩技能注册表，确认能发现 code-tutor——且只能发现 code-tutor。

它必须在 DeepSeek Harness 的 Electron 二进制里运行，因为只有这个二进制能从 app.asar 里读出模块： powershell $env:ELECTRON_RUN_AS_NODE = 1 & "C:\Users\<you>\AppData\Local\Programs\DeepSeek Harness\DeepSeek Harness.exe" .\scripts\live-check.mjs bash
ELECTRON_RUN_AS_NODE=1 "/Applications/DeepSeek Harness.app/Contents/MacOS/DeepSeek Harness" \
./scripts/live-check.mjs

某个子行失败，就意味着 DSH 会在名册里把预设标成 broken （dsh --profile <name> --dump-config 也能看到），所以每次改完预设都要跑一遍。

修改预设

preset/chat.patch.yml 是唯一事实来源。
改完它之后，要同步更新 scripts/check-yaml.mjs 和 scripts/verify.mjs 里镜像的允许列表 —— 这两个文件都写明了允许和禁止的子插件 —— 然后重新安装、重新验证。live-check 是权威测试，用来确认新加的行真的能用。

持续集成

.github/workflows/validate.yml 在每次 push 和 pull request 时运行，环境是 ubuntu-latest：

| Job | 做什么 |
| config-syntax | 用 js-yaml 按 harness 入口列表方言（含 !!js 标签）解析每个 YAML 文件，用 jq 解析每个 JSON 文件；然后断言 Chat 预设的结构 —— 恰好是允许列表里的七个子插件、不含任何被禁的文件系统/shell 家族、技能根目录固定、includeDefaultRoots: false。如果校验过程改写了已跟踪的文件，就失败。 |
| tests | 运行 node --test，把预设结构、技能 frontmatter、仓库卫生检查作为一套测试重跑一遍。 |
| shellcheck | 用 ShellCheck 检查 scripts/.sh，级别 --severity=warning，取自 ShellCheck 维护者自己发布的 release tarball，锁定 v0.11.0。 |
| actionlint | 用 rhysd/actionlint 检查工作流文件本身，跑在它自己维护的 Docker 镜像里。 |

能用现成的第一方工具或广泛使用的工具就用；缺口用普通 shell 命令（curl、tar、jq、node）补上，不额外引入没必要的第三方封装。没有 build job，因为没什么可构建的。

测试环境

| DSH 版本 | 0.2.0-rc.2（宿主协议版本 4） |
| DSH 界面 | DeepSeek Harness 桌面应用（Electron），配置档 desktop |
| 内置运行时 | Node.js 24.18.1，pnpm 11.7.0 |
| 已验证的操作系统 | Windows 11 x64 |
| 大概率可用 | 同一 DSH 版本下的 macOS 和 Linux。预设本身与操作系统无关 —— 里面没有路径、没有按平台区分的行、也没有 shell 命令。只有安装脚本有操作系统之分，POSIX（.sh）和 PowerShell（.ps1）两个版本都随附。 |
| 第三方依赖 | 无。 每一行插件都是 DSH 内置的第一方 @deepseek-ai/dsh- 包。 |
| Node.js（宿主） | 只用于 scripts/*.mjs 和 CI。桌面应用内置的 Node 在 Windows 和 macOS 上会自动找到；否则装 Node.js 22+。 |
| 技能安装的可移植性 | skills/code-tutor/ 是纯 Markdown 加 YAML frontmatter，没有 DSH 专有语法，所以也能复制到 ~/.agents/skills/code-tutor/（共享智能体配置）或任何其他技能根目录。 |
预设定义用的是 !!js dshHomePath('presets/chat/skills')，而不是写死的路径，所以在任何机器、任何操作系统上都会跟随 $DSH_HOME（找不到时回退到 ~/.dsh）。

疑难解答

Chat 预设没有出现在名册里。
重启 DeepSeek Harness —— 名册在启动时组装。如果还是没有，运行 ./scripts/verify.sh，检查 $DSH_HOME/profiles/desktop/cordis.patch.yml 里是否存在托管块。

预设出现了，但标记为损坏。
某个子行挂载失败。运行 scripts/live-check.mjs（见 开发）看是哪一个、为什么。最可能的原因是 DSH 版本变了，插件包名或配置 schema 跟着改了。

设置里显示 Preset services require isolate realms: <name>. 某个子插件提供了服务，却没有包在隔离域里，于是 DSH 拒绝挂载预设，它也就不会出现在会话选择器里。你改动随附配置时会碰到这个问题：把两个 compaction 行留在 cordis:group 行内，该行的 isolate 映射里要写明 compaction 和 toolResultPruner。如果你新增了另一个提供服务的插件，用 live-check.mjs 激活它 —— 它会指出服务名，以及该加哪一条 isolate 条目。plugin.provide 不会列出这些名字，所以光读插件元数据不够。

我在 GUI 里改了设置，预设就消失了。
设置 → Agent presets 会把预设的完整配置覆盖写进配置档补丁。删掉那条覆盖（或者干脆在那个页面里编辑 Chat），然后重新运行安装脚本。

智能体说读不了我上传的 PDF。
这是已知的取舍，不是 bug —— 见 已知限制。让它基于粘贴的文本干活，或者这个任务换用启用了文件系统的预设。

web_search 返回服务商错误。
搜索和聊天共用同一份 DeepSeek 凭据。检查你的账号或 DEEPSEEK_API_KEY。

PowerShell 拒绝运行脚本。
用 powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1，或者在 Git Bash 里跑 Bash 版本。

许可证

MIT © Donald Sebastian Leung