dsh-custom-mode

dsh plugin --profile web add dsh-custom-mode

dsh-custom-mode

[English](README.md) | 中文

在 DeepSeek Harness（dsh）里编辑助手的系统提示词、基础模式和插件开关，为不同任务保留独立助手。

<p align="center">

<img src="https://raw.githubusercontent.com/BOWLUNA/dsh-custom-mode/main/docs/images/header.png" width="820" alt="dsh-custom-mode">

</p>

[安装](#安装并完成首次请求) · [首次使用](#验证完整路径) · [更新](#plugin-updates) · [截图](#使用截图) · [兼容](#兼容与版本) · [求助](#帮助与文档)

编辑与草稿保护

本节说明2.3.1的编辑与草稿保护行为；安装前请先确认发布版本中已有该精确版本。

点击页首「新建助手…」即可定位到既有新建表单并聚焦名称输入框。仍需选择起步设置、填写名称并提交表单；创建成功前，当前选中的助手仍是编辑对象。文字仍在组合输入时不会用Enter提交，普通Enter可提交完成的名称。

草稿仅保存在当前浏览器文档的内存中，离开并返回设置页时仍可继续编辑。它不是磁盘备份：刷新文档、关闭标签页或重启/卸载插件可能丢失未保存编辑；确认离开后的文本无法靠离页提醒恢复。先复制或导出重要草稿；有待保存编辑时复制助手，须确认副本使用已保存配置，原草稿继续保留。

恢复起步提示词、导入文件或载入已保存历史只替换提示词草稿；会覆盖未保存提示词时，先确认替换，取消则保留原文。仍需保存才写入文件。

保存报告冲突时，先复制完整草稿，再明确选择「放弃修改并重新读取」。普通读取会保留脏草稿及其原基线，不能解除冲突；请将重新载入的文件与复制文本对比后，再应用确实需要的编辑。

安装并完成首次请求

本说明描述版本 2.3.1。安装或更新前，先确认发布版本中已有该精确版本，并核对[精确宿主结果与验收边界](docs/CURRENT_COMPATIBILITY.zh.md)。

先安装 DeepSeek Harness，并在宿主自己的界面中配置可用模型。用 dsh --version 对照兼容记录中的精确宿主版本。本插件不安装宿主，也不配置模型凭据。

Web / CLI

钉住插件版本；只写包名可能在 pnpm 发布冷却期解析到旧版：

dsh --version
dsh plugin --profile web add dsh-custom-mode@2.3.1

用原有启动方式重启为该 Web profile 提供服务的进程。本地 CLI 的既有启动形式是 dsh web --port 3081 --no-open；选择空闲端口，打开该进程打印的地址。只重启这个实例。安装 bundle 不会刷新已经运行的宿主。

桌面端与 Windows

在桌面应用的 Plugins（插件） 页安装 dsh-custom-mode@2.3.1，然后重启应用。本项目脚本明确拒绝 --profile desktop，不要手改它的 profile 文件。Windows/Electron 与 Web 分别验收，详见兼容记录。

Windows 上可在 PowerShell 中用宿主提供的 dsh 执行上面的 npm 安装命令。只有可选的 clone 安装脚本需要 Git Bash，另需 Node.js 和 npm。PATH 中没有 dsh 时，使用宿主自带启动器，或将 dsh 替换为 node "<host-install>/node_modules/@deepseek-ai/dsh/lib/bin.js"。除非宿主确实装在本插件目录中，否则不要把这个路径指向插件目录。

验证完整路径

1. 打开设置 → 自定义模式，检查显示版本。页面能打开只是第一步。

2. 点击页首「新建助手…」聚焦新建表单，选择写作等起步设置，输入容易辨认的名称，再点「新增助手」；新建的助手会成为编辑对象。

3. 临时把提示词设为 下一次就绪检查只回复 CUSTOM_MODE_READY。，保存并等页面确认已应用。若提示文件已保存但应用失败，先点「重试生效」。

4. 新建一个会话，打开该会话的模式/助手选择器，明确选择刚才命名的助手。通过 DSH 中已经配置的模型发送 就绪检查。

5. 成功意味着助手可以选择、没有预设损坏告警，并返回预期就绪回复且不出现提示词组装错误。检查后恢复自己的提示词。失败时先看[当前自救步骤](docs/TROUBLESHOOTING.zh.md#当前自救步骤)。

使用截图

截图来自隔离DSH Web实例中的插件 2.2.6，助手内容均为合成数据。它们展示编辑页，不展示新增的更新控件。[截图来源与边界](docs/images/README.md)。

<table align="center">

<tr>

<td align="center"><img src="https://raw.githubusercontent.com/BOWLUNA/dsh-custom-mode/main/docs/images/05-assistant-manager.png" width="360" alt="新建助手"><br>新建助手</td>

<td align="center"><img src="https://raw.githubusercontent.com/BOWLUNA/dsh-custom-mode/main/docs/images/03-system-prompt.png" width="360" alt="系统提示词编辑区"><br>编辑系统提示词</td>

</tr>

<tr>

<td align="center"><img src="https://raw.githubusercontent.com/BOWLUNA/dsh-custom-mode/main/docs/images/01-mode-switch.png" width="360" alt="基础模式选择"><br>选择基础模式</td>

<td align="center"><img src="https://raw.githubusercontent.com/BOWLUNA/dsh-custom-mode/main/docs/images/02-plugin-switches.png" width="360" alt="原生插件开关"><br>调整插件开关</td>

</tr>

</table>

查看新会话的助手选择器。

各项选择分别做什么

设置页选中的助手是正在编辑的对象。选中或新建它不会改变新会话使用的助手。首次激活时，插件可能把缺失的默认值补为内置 custom；已经存在的默认值保持不变。新建写作助手后，仍需在会话选择器中选它。

先选择新建时的起步设置；新助手以标准模式创建。创建后，可以在它的编辑区调整基础模式与各项插件开关。

起步设置 · 初始行为

开发 · 官方标准模式，工具按出厂设置。

写作 · 官方标准模式；终端关闭，文件工具开启。

聊天 · 官方标准模式；文件与终端关闭。

提示词保存在 prompt.md，下一步组装模型输入时会重读。历史与文件导入先载入草稿，保存才落盘。底层文件已变化时，过期保存会被拒绝。custom_prompt 写同一个文件前需要批准。关闭身份/persona 行也会关闭该提示词的注入。

<a id="plugin-updates"></a>

升级、clone 开发与卸载

页首显示运行中的插件版本。宿主提供原生更新能力时，点「检查更新」让宿主查询可用版本。有推荐版本后，「在插件管理中更新」会打开官方插件详情，由它承接确认、进度与结果；自定义页不直接安装包。离开前先保存待处理草稿，并处理生效/读取告警。

0.2.1-rc.2、0.2.1-rc.4、0.2.0-rc.2和0.1.7-rc.2没有原生版本查询API，可用「打开插件详情」或「更新指引」，再按下方固定版本方式手动更新。文件、tarball与源码链接安装继续由原来源管理，不会因检查更新而悄悄转成npm。权限拒绝、网络失败、版本被筛除或结果不完整都不代表已是最新。「磁盘安装版本」与运行版本不同，不能据此认定新代码已运行。

通过Web宿主的原生插件页从2.2.6更新，或更新失败后恢复到2.2.6时，请重启该宿主一次，再核对运行版本与助手是否可用。旧版热停止可能留下助手注册记录。

手动更新注册表安装时，使用上面的固定版本npm命令并选择已发布版本，再重启宿主、核对运行版本。GitHub Releases也提供插件.tgz、仅供预设导入的归档和SHA256SUMS。安装下载的归档前先核对散列；仅供预设导入的归档没有设置页。

该命令仅适用于Web/CLI。桌面用户必须使用应用实际提供的更新路径；应用没有更新入口时，不要改用Web CLI命令或手改桌面profile文件。

源码开发按[隔离准备步骤](CONTRIBUTING.zh.md#隔离开发)进行。可选的./install.sh --profile web保留源码链接方式，已有提示词、元数据和组成不被覆盖。本地包/代码回滚与恢复路径见[包与发布资产](docs/PUBLISHING.zh.md#包与发布资产)。

./uninstall.sh 移除插件但保留助手数据。--purge 明确删除受管助手目录及提示词，使用前请自行备份。2.3.1中，宿主卸载失败或其结果无法核实时，会停止清理与purge、保留剩余文件并以错误退出；处理报告的宿主错误后再重试。桌面端卸载仍使用应用内Plugins页。

兼容与版本

声明的宿主范围：>=0.1.5-rc.2 <0.2.0-0 || >=0.1.6-alpha.1 <0.2.0-0 || >=0.1.7-alpha.1 <0.2.0-0 || >=0.2.0-0 <0.3.0-0 || >=0.2.1-alpha.1 <0.3.0-0 || >=0.2.2-alpha.2 <0.3.0-0

插件版本走独立的稳定 x.y.z 版本线，不镜像 DSH。2026-11-04 公开宿主标签为 latest=0.2.1-rc.5、next=0.2.2-rc.1、alpha=0.2.2-alpha.3。标签会移动，声明范围与已完成检查是两件事。实测范围见[精确版本、验收边界与历史证据](docs/CURRENT_COMPATIBILITY.zh.md)。

发布必须通过兼容性与浏览器工作流。单元、真实提示词组件、打包安装和浏览器检查分别覆盖不同边界。Windows/Electron、真实模型回复、GPU 执行都必须单独留证，不能从页面截图或单元计数推断。headless 不启动使用 agent preset 的会话。

插件市场

各目录的发现与审核规则不同。2026-10-09 的上架结果属于历史记录，不能据此保证今天每个市场都能搜索到。上面的固定版本安装仍是直接入口。[市场接口与限制](docs/MARKETPLACES.zh.md) 说明只读适配器；它不执行目录提供的 shell 命令，也不提交收录。

帮助与文档

• [故障排查](docs/TROUBLESHOOTING.zh.md) — 当前自救在前，历史故障在后。
• 报告故障或建议功能。
• [安全报告](SECURITY.zh.md) — 仅公开请求私下渠道，不发布漏洞细节。
• 发布版本与[变更记录](CHANGELOG.zh.md)。
• [贡献指南](CONTRIBUTING.zh.md) — 隔离开发与检查。
• [架构](docs/ARCHITECTURE.zh.md) — 提示词读取与宿主耦合点。
• [发布](docs/PUBLISHING.zh.md) — 既有发布门禁与读回证据。
• [AGENTS.md](AGENTS.md) — 仓库代理约定。

许可证

[MIT](LICENSE)