dsh-preset-minimal-prompt
Verified@zhiqiangme/dsh-preset-minimal-prompt · v26.11.5 · MIT · Web UI
(已停止维护,请改用 @zhiqiangme/dsh-presets-zh)精简系统提示词和宿主上下文,保留标准工具、AGENTS.md 与 Skills,自动说明使用中文。
Install
dsh plugin add @zhiqiangme/dsh-preset-minimal-prompt Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Published to npm without a public repository. Inspect the package contents before installing.
Tags
Readme
@zhiqiangme/dsh-preset-minimal-prompt
[!WARNING] 本插件已停止维护。 26.11.5 是最后一个版本,之后不再修复问题,也不再跟进 DSH 标准模式的变化;已安装的版本可以继续使用,但 DSH 升级后可能失效。
请改用
@zhiqiangme/dsh-presets-zh(中文预设):dsh plugin --profile desktop add @zhiqiangme/dsh-presets-zh中文预设没有和本插件完全相同的模式,按需要选:
- 要保留标准工具、AGENTS.md 与 Skills,选「中文标准」。它带完整操作说明,系统提示词比本插件长。
- 要最短的提示词,选「中文极简」。它只有持久终端、图片读取与上下文压缩,不注入 AGENTS.md 与 Skills。
中文预设不迁移、也不卸载本插件,两者可以同时启用。切换后不再需要本插件时,先在「插件」页关闭「极简提示词」组件,再卸载本插件;已有会话保留创建时的组合,不受影响。
给 DSH 自动新增 「极简提示词」(preset id minimal-prompt):使用中文极简系统提示词;保留标准工具、AGENTS.md 和 Skills。可选宿主上下文与内置极简模式一样关闭,工作区、技能、时间与模型切换的已知自动说明在写入会话日志前中文化。
装上插件后不需要手动改 cordis.patch.yml,插件加载时会自动向 Agent preset 注册表注册这个模式。
这个模式是什么
| 内容 | 来源 |
|---|---|
| 系统提示词(system message) | 固定为 你是一名乐于助人的软件工程助手。 |
| 工具 | 标准模式:read / write / edit / glob / grep / pwsh / jobs / schedule / skill / goal / plan / subagent / workflow / todo / web / present 等 |
| AGENTS.md | 标准模式:由 agent-instructions 注入,原文不变,已知的开头说明和首个来源标签中文化 |
| Skills | 标准模式:skill-filesystem + tool-skill,含技能目录 |
| 时间 | 保留真实时间、时区和间隔,自动说明中文化 |
| 运行时上下文 | 与内置极简模式一致,includeRuntimeContext: false;保留宿主标记为 required 的工作目录、团队等事实,省略可选的安装路径、Web 地址、权限说明等 |
| 沙箱 / 审批 | 仍由宿主按实际策略执行;关闭可选文字说明不改变权限 |
| 标准系统提示词里的工具说明、团队说明、MCP 说明 | 不写入;complete: true 会抑制所有其他 system prompt 段落 |
工具 schema 仍会随工具集完整发送,所以模型知道自己能调用什么;但标准模式系统提示词里的长篇操作说明不会出现。这是“极简提示词 + 标准工具”的预期代价。
安装
从 npm 安装(推荐)
先完全退出 DSH 桌面版(托盘图标也要退出),然后:
dsh plugin --profile desktop add @zhiqiangme/dsh-preset-minimal-prompt
重新打开 DSH,插件加载后会自动注册新模式。装到 Web / CLI 时把 desktop 换成 web / headless。
从源码安装
在仓库根目录运行:
.\install-plugins.cmd --action install --plugins minimal-prompt --profiles desktop --yes
或让安装脚本选择“全部”,新插件会出现在列表中。
安装后的行为
- 插件 bundle 的
cordis.patch.yml先挂载插件自身。 lib/index.js在agentPresets服务就绪后检查是否已经有同 id 的声明式预设。- 没有冲突时调用
agentPresets.register(PRESET),注册「极简提示词」。 - 停用插件行或卸载插件时,注册会被释放;之后新建的任务不再提供这个模式。已有会话保留启动时的组合,不受影响。
如果已经手动加过 minimal-prompt
如果你之前按手工方式往 cordis.patch.yml 加过:
- insert:
- id: preset-minimal-prompt
name: '@deepseek-ai/dsh-agent-preset'
config:
id: minimal-prompt
...
插件会检测到这条声明并跳过自动注册,避免同一个 minimal-prompt 出现两份(重复 id 会让其中一份显示加载失败)。
要让插件接管这个模式:
- 删除
cordis.patch.yml里包含preset-minimal-prompt的那段- insert:块; - 重启 DSH,或在插件页把本插件停用再启用;
- 插件会重新注册并成为该模式的唯一来源。
启用、停用与卸载
- 停用:在 DSH 插件页停用
dsh-preset-minimal-prompt行,或设置页禁用对应 bundle。新模式从后续新会话中消失。 - 卸载:
dsh plugin --profile desktop remove @zhiqiangme/dsh-preset-minimal-prompt
卸载后插件编辑过的 profile 配置不会残留(本插件不写 profile 文件);如果之前有手动声明,手动声明仍然保留。
插件更新
插件页本插件的卡片显示当前运行版本与 npm 最新版本,按宿主接口在不在选择更新途径,不写死 DSH 版本号,也不自己跑 pnpm:
- 版本检查走宿主路由
/plugins/dsh-preset-minimal-prompt/version,同时问 npm 官方源与 npmmirror,取较高者,缓存 10 分钟;「检查更新」绕过缓存。 - 官方接口(
pluginManager有listVersions/updateBundle):先用listBundles核对本插件的更新资格,再选最新的兼容、未弃用正式版,把精确版本和同一注册表交给updateBundle。锁、卸载、安装与失败恢复都归宿主;只有实际装上目标版本才显示成功。 - dshmarket 兜底:宿主还没有官方接口时(如 DSH 0.2.1-rc.5),装了 dshmarket 就交给它的公开更新 API v1(只传纯包名),卡片轮询任务进度;发布冷却期挡下时给「强制更新」。Web 版市场支持时显示「立即重启 DSH」。
- 两条路都没有、或宿主拒绝卸载正在运行的本插件(
bundle-in-use)时,展开「按指定版本安装」:复制@zhiqiangme/dsh-preset-minimal-prompt@版本号,在「插件」页本插件详情里先关闭「极简提示词」组件,再卸载本插件,通过「添加插件」安装,装好后重新打开该组件。官方更新被拒时宿主已把本插件移出启用列表,卡片会用setBundleEnabled补回;dshmarket 会自己补回。 - 本地
file:/link:安装请更新源码并重新运行安装脚本;DSH 托管的安装随宿主更新。
和标准模式保持同步
本插件的 lib/preset.js 是 DSH 标准模式插件列表的快照,安装时不需要读取 DSH 安装目录。这样它能离线安装、可审计,也不会因为 DSH 升级时文件路径变化而加载失败。
已适配 DSH 0.2.2 的子代理配置:list_agents 由控制插件统一提供,不再引用已移除的 /list-agents 子路径;子代理模型选择与发现使用新的 modelSelection、modelDiscovery 配置。
代价是:DSH 升级后,如果标准模式新增或删除了工具,插件不会自动跟着变。升级 DSH 后可以:
- 对比新版本
@deepseek-ai/dsh-web-app/presets/standard.patch.yml的plugins列表; - 更新
lib/preset.js,只改persona为极简配置,其余行保持标准模式; - 运行
npm test和下面的运行时验证。
test/preset.test.mjs 会检查关键行是否存在,但不会连接 DSH 安装目录,所以 CI 不需要 DSH。
运行时验证
本仓库的测试不依赖 DSH。需要确认插件在真实 DSH 中能注册时,可以:
- 在一个测试 profile 中安装本插件;
- 启动 Web profile,调用
agentPresets/list,确认返回minimal-prompt且没有broken; - 新建一个
minimal-prompt会话,确认:- system message 是
你是一名乐于助人的软件工程助手。; request/header.tools与同 profile 的 standard 会话一致;- user messages 保留 AGENTS.md 和技能原文,已知框架说明使用中文;
- runtime-context 与内置极简模式一样省略可选宿主信息;通用英文标题与 required 事实仍由宿主生成;
- 模型切换通知保留切换事实,具体路由继续记录在来源元数据与请求头中。
- system message 是
实现说明
cordis.patch.yml只插入插件自身,不直接插入 preset 声明;这样代码可以先检查 profile 里已有的手写声明,避免重复 id。lib/index.js使用ctx.loader.entries()检查未禁用的@deepseek-ai/dsh-agent-preset行,再查一次agentPresets.list(),都没有才注册。lib/preset.js是纯数据对象,不依赖 YAML 解析器或 DSH 内部文件。lib/context.js作为预设内的插件注册公开事件监听器,仅格式化有明确来源且格式已知的自动消息。按 agent 隔离,在进入会话日志之前处理;普通消息和未知格式保持原样。- AGENTS.md 正文、技能目录块和技能正文不作内容替换。用户内容中的 DSH 字样仍会发送,工具 schema 也保留原始标识和描述。
- 平台相关的 shell 行在加载时求值:Windows 启用
tool-pwsh,其他平台启用tool-bash。 tool-plugin-manager与tool-plugin-market保持标准模式的默认禁用状态。
已知限制
调整提示词只能减少不必要的宿主信息,不能证明或保证第三方服务兼容。网络、模型、工具 schema 和历史长度仍可能影响请求。
既有会话里的上下文、压缩摘要和模型切换记录不会被改写。验证新组合请新建会话;旧会话仍可能携带之前的信息。
宿主升级后未知格式的自动消息会原样保留,避免误改用户内容;内置运行时快照的通用英文标题不在本插件的替换范围内。
没有客户端 UI;模式卡片由 DSH 的 Agent preset 页面统一展示,显示名称和描述来自
PRESET。预设是标准模式的静态快照;DSH 升级后需要手动同步工具列表。
如果 profile 里已经有同 id 的手写声明,插件会跳过注册而不是覆盖它;需要按上面的步骤移除手写声明。
已有会话不会因为插件安装/停用而改变组合;只有新建会话会读取当前注册表。
开发
cd dsh-preset-minimal-prompt
node --test test/*.test.mjs
只依赖 Node 内置模块和 @deepseek-ai/cordis peer;测试使用 fake host,不需要 DSH 或网络,覆盖预设注册、上下文汉化及插件更新的官方与 dshmarket 两条路。