Skip to content

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

或让安装脚本选择“全部”,新插件会出现在列表中。

安装后的行为

  1. 插件 bundle 的 cordis.patch.yml 先挂载插件自身。
  2. lib/index.js 在 agentPresets 服务就绪后检查是否已经有同 id 的声明式预设。
  3. 没有冲突时调用 agentPresets.register(PRESET),注册「极简提示词」。
  4. 停用插件行或卸载插件时,注册会被释放;之后新建的任务不再提供这个模式。已有会话保留启动时的组合,不受影响。

如果已经手动加过 minimal-prompt

如果你之前按手工方式往 cordis.patch.yml 加过:

- insert:
    - id: preset-minimal-prompt
      name: '@deepseek-ai/dsh-agent-preset'
      config:
        id: minimal-prompt
        ...

插件会检测到这条声明并跳过自动注册,避免同一个 minimal-prompt 出现两份(重复 id 会让其中一份显示加载失败)。

要让插件接管这个模式:

  1. 删除 cordis.patch.yml 里包含 preset-minimal-prompt 的那段 - insert: 块;
  2. 重启 DSH,或在插件页把本插件停用再启用;
  3. 插件会重新注册并成为该模式的唯一来源。

启用、停用与卸载

  • 停用:在 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 后可以:

  1. 对比新版本 @deepseek-ai/dsh-web-app/presets/standard.patch.yml 的 plugins 列表;
  2. 更新 lib/preset.js,只改 persona 为极简配置,其余行保持标准模式;
  3. 运行 npm test 和下面的运行时验证。

test/preset.test.mjs 会检查关键行是否存在,但不会连接 DSH 安装目录,所以 CI 不需要 DSH。

运行时验证

本仓库的测试不依赖 DSH。需要确认插件在真实 DSH 中能注册时,可以:

  1. 在一个测试 profile 中安装本插件;
  2. 启动 Web profile,调用 agentPresets/list,确认返回 minimal-prompt 且没有 broken;
  3. 新建一个 minimal-prompt 会话,确认:
    • system message 是 你是一名乐于助人的软件工程助手。;
    • request/header.tools 与同 profile 的 standard 会话一致;
    • user messages 保留 AGENTS.md 和技能原文,已知框架说明使用中文;
    • runtime-context 与内置极简模式一样省略可选宿主信息;通用英文标题与 required 事实仍由宿主生成;
    • 模型切换通知保留切换事实,具体路由继续记录在来源元数据与请求头中。

实现说明

  • 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 两条路。

许可

MIT