dsh-modes · 模式管理

English | 中文

DeepSeek Harness（dsh）的模式管理器。它在 Web 界面的设置里加一个「模式管理」页：用开关决定每个模式能做什么，按模式编辑系统提示词和模型读到的工具描述，按模式管理技能（可以保存版本、新建技能，或从 Codex、Claude Code 和任意文件夹导入），用模板新建自己的模式，dsh 升级后一键合并官方更新。

它能帮你做什么

• 看懂每个模式：每个模式一张卡片，标出它能做的事（运行命令、读写文件、上网、子代理……），不用展开就能比较。
• 用开关决定能力：15 项能力各一个开关，比如关掉「运行命令」，或者把文件设成只读。不用面对几十个插件名。
• 改提示词：按模式编辑系统提示词，可以预览、保留历史版本；还可以让改动立刻作用到正在运行的会话，或者允许模型在对话里改（每次保存都要你批准）。
• 改工具描述：改写模型看到的任意工具的描述，可以一次改多个模式；一键把一个工具、一个模式或全部恢复成内置原文。工具本身的定义不会被修改。
• 新建自己的模式：从「开发、写作、聊天、只读调研」四个模板起步，或者复制任意现有模式。
• 按模式控制技能：按模式或在所有模式里开关某个技能，把某个模式固定在技能的某个已保存版本上，并保留可以查看、恢复、删除的版本历史。开关和固定版本都不会移动技能文件。
• 新建和导入技能：在页面里写一个新技能，或者从 Codex、Claude Code、任意文件夹批量复制技能进来。导入的技能来源有变化时，页面会提示，可以一键重新导入。
• 更新插件本身：页面会告诉你本插件有新版本，确认后用 DSH 自己的安装器升级。
• 跟上 dsh 升级：dsh 更新内置模式后，一键把官方的变化合并进来，同时保留你的修改；有插件加载失败时，一键关掉出问题的那几个。

安装

需要 dsh 的 Web 界面（dsh web），兼容的版本见兼容性。

dsh plugin --profile web add dsh-modes

如果你是从 dsh 源码运行的，在源码目录里把命令换成 pnpm dsh plugin --profile web add dsh-modes。装好后重新启动 dsh web，打开 设置 → 模式管理。

快速上手

1. 打开 设置 → 模式管理，看看内置的几个模式：卡片上的小标签就是它们能做的事。
2. 点右上角 新建模式，选「只读调研」，直接点创建。
3. 新模式的卡片会展开到「能力」页：「运行命令」是关的，「文件」打开但「允许修改文件」是关的。
4. 点卡片上的 用它新建会话，让它改一个文件：这个模式里没有写文件、编辑文件或运行命令的工具，它只能读和搜索。
5. 回到这张卡片的「提示词」页，改一句提示词并保存。新开的会话就会用上它；想让正在运行的会话也立刻用上，打开下方的「即时生效」。

功能说明

模式列表

每个模式一张卡片：

• 卡片头：名称和描述，以及「默认」「自定义」标记。
• 能力标签：它能做的事，例如「运行命令 · 只读文件 · 网页」。
• 状态行：已启用的插件数、有几个会话在用、改过几项，以及是否开了即时生效。
• 按钮：「用它新建会话」用这个模式开一个新会话。「⋯」菜单里是其他操作：设为默认、复制、查看配置（YAML）、编辑信息、恢复内置、删除。
• 提示条：有需要你处理的事时，卡片上会出现一条，例如「内置模式有更新」「有插件加载失败」「有未保存的提示词草稿」，并带处理按钮。

点卡片可以展开，里面有「能力」「提示词」「全部插件」三个标签页。

能力

• 打开一项能力，会把它恢复成内置模式里的样子：按运行环境自动开关的插件（例如 Bash 和 PowerShell）恢复成「自动」；官方本来就关着的插件（例如 Codex 子代理）仍然关着。
• 关闭一项能力，会关掉它包含的所有插件。
• 只开了一部分插件的能力会标「部分开启」。
• 模式里没有的能力不会显示，例如 dsh 0.2.1 之前没有「定时提醒」。

提示词

• 系统提示词：编辑这个模式的系统提示词，点按钮插入 {{model}} 等变量，输入时实时检查变量是否可用；「预览完整系统提示词」可以看到模型实际收到的全部内容。
• 高级设置：结尾提示词（追加在工具说明、工作区规则之后）、「只用开头这段作为完整提示词」、「附带运行时上下文」。
• 保存：点「保存」或按 ⌘/Ctrl + Enter。以上内容都要保存后才生效。
• 历史版本：每次保存都会记一个版本（最多 30 个），标明是在设置页、对话中还是别处改的，任何版本都能载回编辑器。
• 导入导出：支持导入、导出 .md 文件。
• 恢复内置：「恢复内置提示词」会先问一次。
• 不怕丢：没保存的修改会作为草稿留在浏览器里，刷新页面也不会丢；如果你编辑期间提示词在别处被改了，保存会被拒绝，并让你选择载入最新内容，或用自己的版本覆盖。

「在对话中」一栏有两个开关，点一下就保存，对之后新建的会话生效：

• 即时生效：保存提示词后，正在运行的会话从下一步起就使用新提示词。
• 允许在对话里修改提示词：你可以直接对模型说「把你的提示词改成……」。模型通过 mode_prompt 工具读取或修改这个模式的提示词，每次保存前都会弹出审批。

工具描述

打开「设置 → 模式管理 → 工具描述」。这里改写的是工具的描述，也就是告诉模型这个工具做什么、什么时候用的那段文字。工具本身的定义不会被修改，所以内置原文随时可以恢复。

• 选模式：顶部的「模式」菜单和技能页共用，页面会在这个浏览器里记住你的选择。选一个模式就只改它；选「所有模式」会出现模式列表，勾选改动要应用到哪些（一开始全部勾选）。一个都不勾时，列表显示所有可编辑模式的工具，此时不能保存。代码模式（PTC）和由其他插件声明的模式会列出并写明原因，不能选；如果在技能页选的模式在这里不能用，页面会说明并显示所有模式。模式卡片菜单里的「编辑工具描述」会打开这个页面并选中该模式。
• 批量修改：可以把一个工具同时改给多个模式，也可以改好几个工具后用「保存全部」一起保存。草稿会保留到你保存或放弃，切到别的页面再回来也还在。每个工具展开后能看到内置原文、它在每个已勾选模式里的状态，以及可以载回编辑框的更早版本。
• 一键恢复：可以恢复一个模式里的一个工具、所有已勾选模式里的一个工具、已勾选模式的全部，或所有模式的全部。每一种都会先确认。恢复就是去掉你的修改，所以内置原文会原样回来。
• 内置说明已更新：dsh 升级后，如果某个工具的内置描述和你修改时依据的不一样，会显示「内置说明已更新」。你的修改仍然生效；展开「内置原文」对照，再选择恢复，或重新保存以接受新的内置文字作为基准。
• 复制：复制模式时，会一起复制它的工具描述修改。
• 限制：描述最多 20000 字，不能为空（想还原请用恢复）。只改描述，不会改工具名和参数。列表显示的是每个模式注册的工具，不需要先打开会话。

技能

打开「设置 → 模式管理 → 技能」，这里列出各模式能找到的所有技能，以及它的描述和文件位置。

• 新建技能：点「新建技能」，填名字（小写字母、数字和连字符）、一句话描述，选放在哪（~/.dsh/skills 只给 DSH 用，~/.agents/skills 和其他 Agent 工具共用），再勾选在哪些模式开启。页面会生成 <文件夹>/<名字>/SKILL.md，并直接打开编辑器。
• 导入：「导入技能」会列出 ~/.codex/skills、~/.claude/skills 和 ~/.claude/plugins 里 Claude Code 插件带的技能；切到「文件夹」可以填一个路径（一个技能文件夹，或装着多个技能的文件夹；Windows「复制为路径」带的引号也能识别）。每一项都标明状态：可导入、已导入、来源有更新、已有同名技能（可以改名导入，或者先给现有技能存一个版本再覆盖）、名字 DSH 不认（按建议的名字导入，并改写副本里的 name）。Codex 自带的技能默认折叠、不勾选，因为它们依赖 Codex 自己的工具。
• 导入是复制：文件会复制到你选的文件夹，在 DSH 里修改不会动到来源。指向技能外部的链接、.git 和 .DS_Store 不会复制。之后来源有变化，技能那一行会显示「来源有更新」，展开后点「从来源重新导入」，会先把当前文件存成一个版本再覆盖。
• 按模式查看：顶部的「模式」菜单（和工具描述页共用）可以选所有模式或某个模式。选中某个模式时，列表只显示这个模式能找到的技能，并显示开着几个；每一行的开关和版本下拉框直接作用于这个模式；「全部打开」「全部关闭」（关闭前会确认）作用于列出的所有技能。模式卡片菜单里的「管理技能」会直接打开这个模式的视图。
• 开关：查看所有模式时，技能那一行右侧的开关会在所有模式里关闭它；查看单个模式时，这个总开关在展开区里。展开后，每个有技能工具的模式各有一个开关；找不到这个技能或没有技能工具的模式会标明不受影响。
• 未开启「技能」能力的模式：这样的模式没有技能工具，技能对它不起作用，所以不会出现在按模式的开关里。页面顶部会列出这些模式，并给出「开启」按钮，效果和模式卡片「能力」页签里的开关一样。用「聊天」模板新建的模式默认没开这项能力。
• 固定版本：每个模式都有一个版本下拉框：「当前文件」或某个已保存的版本。固定后，这个模式用的是那个版本的描述和正文，资源文件也来自保存的副本；其他模式仍然用当前文件。
• 版本：「保存当前为新版本」会复制技能的文件（最多 1000 个文件、25 MB），可以写备注。在页面里编辑文件或恢复某个版本之前，都会先把当前文件存成一个版本，并标明来源。「查看」显示版本里的 SKILL.md；「恢复到文件」把它复制回当前文件，版本里没有的文件会保留；有模式正在使用的版本不能删除。
• 编辑 SKILL.md：在页面里直接编辑。如果文件在你编辑期间被改动，除非你选择覆盖，否则不会写入。
• 只读的技能：node_modules 里的技能属于 DSH 或某个插件，可以按模式关闭、保存版本，但不能编辑或恢复它的文件。~/.agents/skills 里的技能和其他 Agent 工具共用，编辑前页面会提示。
• 复制：复制模式时会一起复制它的技能设置；「恢复内置」和删除模式会清除这些设置，已保存的版本保留。

全部插件

列出模式里的每个插件，适合需要逐个调整的情况：

• 页面内可以搜索，也可以只看改动过的插件。
• 按运行环境切换的插件可以选「自动 / 开 / 关」。
• 改过的插件可以单独「还原」。
• 「详情」里能看到行 id、模块和完整配置。

新建模式

每个模板都带一段起步提示词，按界面语言选中文或英文。名称和 ID 会自动填好，之后都可以改。

跟上 dsh 升级

• 同步内置更新：dsh 升级后，改过的内置模式，以及基于内置模式创建的自定义模式，会提示「内置模式有更新」。同步前会列出新增、移除和有官方更新的插件；确认后：
  • 你没动过的插件跟随官方；
  • 你改过的设置保留你的值；
  • 新增的插件在模板模式里默认关闭。
• 一键修复：模式里有插件加载失败时，整个模式会用不了。卡片上会列出失败的插件和原因，一键只关掉这几个，模式就能恢复使用。
• 删除前提醒：删除自定义模式前，会告诉你有多少个打开的和已保存的会话在用它；删除后，这些会话就打不开了。

更新

页面会检查本插件有没有新版本，并且可以直接安装。

• 检查：打开页面时，插件向 DSH 配置的 npm 仓库（国内镜像也行）询问 dsh-modes 的最新版本，最多每 12 小时一次。请求里只有包名。可以用页面底部的「自动检查更新」关掉；「立即检查」仍然可用。本地开发安装（link:）从不检查。
• 升级：有新版本时，页面顶部出现横幅和「升级…」按钮。确认后，由 DSH 自己的安装器从仓库下载那个版本的压缩包并安装，过程中显示进度，可以点「取消安装」。安装失败或被取消时，安装器会把 profile 的文件还原。只会提供 latest 正式版，不会升到预发布版本；压缩包地址必须是这个包在应答的那个仓库里的文件。
• 升级之后：通常新版本在重启 dsh 后生效（网页版重新运行 dsh web；桌面应用退出后重新打开），正在运行的会话不受影响，你的模式和修改都会保留。有些 DSH 版本会当场替换插件，这时页面会请你刷新。横幅里会给出退回旧版本的命令。
• 从 GitHub 安装的：横幅显示命令 dsh plugin --profile web add github:xiaohai-78/dsh-modes，没有升级按钮。
• 手动升级：Plugins 页面 →「添加插件」→ 粘贴 https://registry.npmjs.org/dsh-modes/-/dsh-modes-<版本号>.tgz；或者在终端运行 dsh plugin --profile web add dsh-modes@latest。不带 @latest 的命令什么都不会做，因为 DSH 会保留安装时的版本。
• 旧版本：在加入更新检查之前发布的版本没有横幅，需要先手动升级一次。

改动什么时候生效

• 所有改动都只对之后新建的会话生效，正在运行的会话保持原样。唯一的例外是开启了「即时生效」的模式：它保存的提示词文字会从下一步起作用到正在运行的会话。
• 技能：一个模式第一次设置时会加上本插件的一行，所以只对新会话生效；之后的改动会从下一步起作用到这个模式正在运行的会话。输入框的 / 菜单要刷新页面后才更新列表。
• 新建和导入的技能：DSH 会监听技能文件夹，新技能不用重启，从下一步起就会出现在正在运行的会话的技能目录里；输入框的 / 菜单要刷新页面后才显示。
• 工具描述：一个模式第一次被改写时，会给它加上本插件的一行，所以这次改动只对新会话生效；之后每次保存或恢复，都会从下一步起作用到这个模式正在运行的会话。
• 改动写在当前 dsh profile 的 cordis.patch.yml 里，用同一个 profile 打开的其他窗口也会看到。Desktop 应用用的是另一个 profile，不受影响。
• 每次操作的结果显示在页面底部的提示条里；出错的提示会一直留着，直到你关闭。保存工具描述或技能设置后，提示条还会说明什么时候生效：已有设置的模式从下一步起作用到正在运行的会话，模式第一次设置则只对新会话生效，此时如果只涉及一个模式，会带一个「用它新建会话」按钮。第一次设置之前就已开始的会话，之后的改动也不会作用到它，需要新建会话。

兼容性

以上版本都实际安装测试过，包括用本地假模型检查发给模型的真实请求。插件用到的 dsh 接口还没有稳定，其他版本可能需要适配。

常见问题

改了开关或提示词，但对话里没变化？ 改动只对之后新建的会话生效，用「用它新建会话」开一个新的试试。只有开启了「即时生效」的模式，提示词文字才会作用到正在运行的会话。

dsh 升级后某个模式用不了了？ 展开那个模式的卡片，如果提示有插件加载失败，点「关闭这些插件」；如果提示「内置模式有更新」，点「同步内置更新」。

改乱了，怎么回到原样？

• 单个插件：在「全部插件」里点「还原」；
• 提示词：在「历史版本」里载回任意旧版本，或点「恢复内置提示词」；
• 整个内置模式：在「⋯」菜单里选「恢复内置」。

在对话里让模型改提示词，没有反应？ 「允许在对话里修改提示词」只对打开之后新建的会话生效。另外，dsh 的审批策略如果设为「从不」（例如无人值守运行），保存会被拒绝。

插件的数据存在哪里？

• 模式配置：在 profile 的 cordis.patch.yml 里；
• 同步基准和提示词历史：在 profile 目录下的 .dsh-modes/ 文件夹里；
• 未保存的草稿：只在当前浏览器里。

卸载

dsh plugin --profile web remove dsh-modes

卸载后，被本插件改过的模式仍能正常使用。本插件往内置模式里加的每一行，保存时都带一个条件：插件包不在了，这一行就自动关闭。开了「即时生效」的模式还会多一行官方的身份行，提示词和你保存的一样，只在插件卸载后才启用。卸载后：

• 技能设置、工具描述的修改和「允许在对话里修改提示词」不再生效，技能和工具回到原样。
• 开了「即时生效」的模式保留你最后保存的提示词，变成普通的提示词。
• 对内置模式的其他修改，比如关掉的插件、改过的提示词，会保留下来。想完全还原，就在卸载前对这些模式点「恢复内置」。
• 自己新建的模式会随插件一起消失。
• profile 目录下的 .dsh-modes/ 文件夹会保留，重新安装后所有设置都能回来；想清理可以删掉它。

0.8.0 及更早版本保存的行没有这个条件。卸载前请先升级，并启动一次 dsh：插件启动时会给它改过的每个内置模式补上条件。如果卸载后某个模式已经用不了（模式列表里找不到它，或者新建会话报 agent-preset/invalid: ... never started），重新安装本插件，或者先换一个模式。

已知限制

• 同步依赖记录：同步内置更新依赖上次保存时记下的内置插件列表。用 0.5.0 之前的版本改过的模式没有这份记录，第一次同步时，和官方不一致的地方都会按你的修改保留；之后每次保存都会补上记录。
• 为其他工具写的技能：DSH 只读取 name、description、whenToUse、metadata、disable-model-invocation 和 user-invocable；其他字段（比如 Claude Code 的 allowed-tools、model）不起作用。依赖其他工具自带功能的技能（比如 Codex 的生图）可以导入，但在 DSH 里可能用不了。
• 导入扫描的位置：$CODEX_HOME/skills（默认 ~/.codex/skills）、$CLAUDE_CONFIG_DIR/skills（默认 ~/.claude/skills），以及 ~/.claude/plugins 往下六层以内的 skills/<名字>/SKILL.md；同一个插件缓存了多个版本时，只列最近改动的那份。项目里的技能（比如 <项目>/.claude/skills）请用「文件夹」导入。单文件形式的 <名字>.md 技能不会列出。
• Windows 上覆盖：文件是逐个覆盖的，中途出错会留下新旧混合的文件。可以在这个技能的版本列表里恢复导入前自动保存的版本。
• 刚写入的技能：页面会等 0.8 秒让 DSH 的文件监听发现它，再读取列表。如果新技能仍显示「这个模式找不到它」，点「刷新」。
• 即时生效的范围：只作用于提示词的开头和结尾两段文字；「完整提示词」「运行时上下文」两项仍然只对新会话生效。
• 对话改提示词的范围：mode_prompt 只读写提示词的开头这段。
• 列出的技能：页面列出的是不指定工作区时各模式能找到的技能：用户级、自定义目录和包里自带的技能。项目里的技能（<项目>/.dsh/skills、<项目>/.agents/skills）取决于会话的工作区，不会列出。
• 在所有模式里关闭的技能：这需要每个模式里都有本插件的一行，所以每个内置模式都会被写入一份 profile 覆盖。
• 和其他技能插件的先后：这一行的条目排序值是 -1000。如果别的插件在同一作用域里注册了排序值更小的条目，它会胜过本插件。
• 被隐藏技能的信息：一个技能在所有模式里都被隐藏后，页面显示的是它最后一次可见时的描述和文件位置。
• 更新检查：需要能连上仓库。连不上时页脚会显示检查失败。镜像可能比 npm 慢，最新版本可能晚一点才出现。
• 升级后的版本记录：在页面里升级后，依赖在 package.json 里记成压缩包地址，而不是版本号。这不影响使用和以后的升级。
• 新版本启动失败：DSH 不会继续运行旧版本。请在终端运行横幅里给出的退回命令。
• 代码模式（PTC）：暂不支持工具描述。代码模式里，模型读到的工具描述是生成出来的 SDK 文本里的注释，修改不会改写它。
• 会话启动时才注册的工具：列表来自每个模式注册的工具。只在会话启动时才注册的工具（例如 subagent），要等这个模式的会话发出第一次请求后才会出现。
• 会复述工具描述的插件：把描述抄进提示词的插件（例如 tool-activator 的 <available_tools> 列表）仍然显示内置原文；发给模型的工具定义带的是你的修改。
• 手工修改文件：插件读取 tool-descriptions.json 后会缓存，只有在页面保存后才会重新读取。手工改过这个文件后请重启 dsh。文件损坏时会报错，不会被覆盖。
• 会话统计：删除前统计已保存的会话要读取每个会话的记录，会话很多时最多统计 8 秒，没统计完会显示「至少 N 个」。
• 权限：写操作只依赖 dsh 自带的登录校验。

npm test

许可证

MIT