前言¶

在 DSH 里写提示词，常见卡点不是「想不清楚要什么」，而是草稿缺上下文、缺输出形态、缺边界，模型一次接不住。自己反复润色又占时间。QBuddy 是 DSH 桌面端插件：在输入框右侧提供一个按钮，读当前草稿，发起一次独立的模型补全，把结果清洗后写回输入框（或等你点「应用」再覆盖）。它不参与对话——增强不进历史、不产生轮次，也不会改掉你正在聊天用的会话模型。

这是什么¶

QBuddy（包名 dsh-qbuddy-prompt-enhance）由社区维护者 dhdkfkfkf 发布，分类为客户端插件。当前版本 0.6.6，许可证 MIT。目录页：skillhub.cn/plugins/dhdkfkfkf/dsh-qbuddy-prompt-enhance；源码与说明：GitHub 仓库。

核心功能¶

下面介绍 README 中已写明、且与实现一致的能力。

输入框旁的按钮与状态¶

• 输入框为空（含只有空白）时，按钮不渲染；有内容时出现，清空后又隐藏，不占位。
• 左段：单击开始增强；运行中显示已用秒数（满 1 秒才显示，到超时预算的 80% 转警告色，默认 30 秒即第 24 秒），再点一次取消，草稿不动。
• 右段：打开菜单，切换预设、提示词模型、思考强度。
• 结果返回时：草稿未变则直接写回；增强途中你改过字则变为「应用」，由你决定是否覆盖；草稿已清空则丢弃结果。失败时悬浮提示给出原因，再按一次用同一份草稿重试。

预设与模型¶

• 四档内置预设（从保守到激进）：Qoder（qoder）、WorkBuddy 润色（workbuddy-polish）、QBuddy 默认（qbuddy）、WorkBuddy 扩写（workbuddy-expand）。内置档只读；要改文案需新建自定义预设。
• 自定义预设：数量不限，每项含 system / user 模板；user 必须含 {{draft}}，保存后立即出现在菜单。
• 三样快切：预设、增强用的 provider/model、思考强度均在菜单中修改，写入插件配置，只影响这一次增强调用，不动会话模型。

配置页¶

入口：插件详情页 → QBuddy 配置。可设 provider/model、思考强度（模型支持时）、超时（0.1–600 秒）、自定义预设的增删改。保存后输入框菜单自动重拉，无需重启。

安装与启用¶

桌面端的 desktop Profile 由 Electron 应用托管，不能用 dsh plugin add 安装，否则会报 profile "desktop" is managed exclusively by the Electron application。

桌面版（Desktop）¶

1. 界面安装（推荐）：设置 → 插件 → 安装，选择下载好的 .tgz 或填包名，启用后完全退出并重开 DSH（含托盘图标）。
2. AI 会话安装：在支持 plugin_manager 的会话里执行 install_bundle，target 传解包后含 package.json 的目录绝对路径（不能直接传 .tgz）。
3. 本地目录链接（改代码用）：插件页选本地源码目录，以 link: 链入 profile，改完重启 DSH 生效。

Web 版 / 命令行（CLI）¶

Web 版不受 Electron 托管，可用 dsh plugin（参数转给 profile 目录里的 pnpm）。本插件暂未发布到 npm；从 GitHub 装源码示例：

dsh plugin --profile web add github:dhdkfkfkf/dsh-qbuddy-prompt-enhance

其他来源（资料原文）：

# 本地 tgz（离线）
dsh plugin --profile web add file:/绝对路径/包.tgz

# 本地目录（link，改代码即生效）
dsh plugin --profile web add ./插件目录

从 GitHub 装源码时，若包需编译且 pnpm 拦截 prepare，需按报错在 profile 的 pnpm-workspace.yaml 里加 allowBuilds；本插件为纯 JS、无构建步骤，一般无需此步。

从旧版升级（0.6.6 起）¶

Loader 入口 id 从 prompt-enhance-v2 改为 dsh-qbuddy-prompt-enhance。升级前请删掉 profile cordis.patch.yml 里 id: prompt-enhance-v2 条目，避免同一插件加载两次。

典型用法¶

1. 在 DSH 输入框里写下草稿（按钮出现后可见）。
2. 需要时在按钮右侧菜单选择预设、增强模型或思考强度。
3. 点左段开始增强；若运行过久可再点取消。
4. 若中途改过字，左段会显示「应用」，确认后再覆盖当前草稿。
5. 需要长期策略或自定义 preset 时，打开 QBuddy 配置 一次性配好。

内置四档含义（菜单与配置页顺序一致）：

配置项概要¶

cordis.patch.yml 入口 id 为 dsh-qbuddy-prompt-enhance。常用键包括：enabled（默认 true）、preset（默认 qbuddy）、customPresets、provider / model（留空则跟随默认模型）、reasoningEffort、timeoutMs（默认 30000，允许 100–600000）。带 volatile 的字段在 Loader 中就地更新，切档、切模型不必重挂载整条插件。

适用场景与注意¶

适合谁：经常在 DSH 里写长提示、希望少手工补结构、又希望增强与正式对话分离的开发者。

权限与安全：插件以当前 DSH 进程权限运行；安装前应自行查看源码与 MIT 许可证。增强路由仅接受本机同源请求，请求体上限 256 KB；草稿在 system 中视为不可信数据；日志不记录草稿正文。插件不读附件、剪贴板、选区或历史消息，只发一次补全、不调用工具。

已知限制（资料原文）：仅整体替换纯文本草稿，无选区替换；非流式；依赖宿主 LLM 服务（无服务时路由 501）；输入框收进活动面板时工具条隐藏，按钮不可见；预设与模板存于 profile，不跨设备同步。

结尾¶

QBuddy 把「把草稿写成模型能接住的形状」收成输入框旁的一键操作：四档内置预设、任意自定义预设，以及增强专用的模型与思考强度快切，且不污染对话历史与会话模型。需要安装包、配置细节与设计说明时，请以仓库 README 为准。

• 社区目录：https://www.skillhub.cn/plugins/dhdkfkfkf/dsh-qbuddy-prompt-enhance
• GitHub：https://github.com/dhdkfkfkf/dsh-qbuddy-prompt-enhance