dsh-quick-phrases
pengtang1024/dsh-quick-phrases
在输入框旁加一排快捷短语按钮:按钮名称与真正发送的内容分开编辑,点按行为可选「直接发送」或「插入光标处」,输入框里已有草稿时总是插到光标处;有草稿时整排缩成一个小胶囊,设置里关掉「显示短语行」后连胶囊都不渲染;单条短语也可单独隐藏;位置可选输入框下方、上方或工具行右侧;管理页支持新增、改名、拖动排序、两步确认删除与恢复默认。行为全部集中在一个渲染端脚本里,无依赖、不联网,短语以明文存在 localStorage。
安装
dsh plugin --profile web add github:pengtang1024/dsh-quick-phrasesREADME
dsh-quick-phrases
给 DeepSeek Harness(DSH)的输入框加一排快捷短语按钮:继续、提交、推送、发版 这类天天要打的字,点一下就送进输入框或直接发出。按钮上显示的名称和真正发出的内容分开编辑,所以按钮可以很短,话可以很长。
Composer decoration for DeepSeek Harness: a row of quick-phrase chips whose captions and sent text are edited separately, plus a management page in Settings.

文档里的截图都是界面示意图:由
test/preview.mjs把真实组件套上宿主主题 token 渲染出来,不是真机截屏。实际观感以运行中的界面为准。
功能
- 一排短语按钮:显示名称与发送内容分离,默认四条:继续 / 提交 / 推送 / 发版。
- 点按行为可选:默认「直接发送」——输入框为空时一次点按就发出;输入框里已有文字或附件时,任何模式都改为插到光标处,不会覆盖正在写的内容。
- 显示位置可选:输入框下方(默认)、输入框上方、工具行右侧,切换即时生效。
- 可以收起:行尾一个「收起」动作;也可以让输入框一有内容就自动收起(默认),整排缩成一个小胶囊,点一下临时展开,不挡住正在写的字。
- 整排可以彻底隐藏:设置里关掉「显示短语行」后,整排从界面完全消失——连胶囊都不留,界面上什么都不显示;只有回到 设置 → 快捷短语 重新打开开关才恢复。
- 单条短语可隐藏:管理页每张卡片有一个眼睛开关,隐藏后这条按钮从短语行消失,卡片仍留在管理页并标注「已隐藏」。
- 管理页:拖动手柄排序、直接在卡片上改名、实时按钮预览与字数、两步确认删除、一键恢复默认。
- 零依赖:纯前端一个
client.js,不联网、不读写文件、不引入 npm 包,数据只存在本机localStorage。
安装
前置:DSH 桌面端或 Web 端(0.2.2 及以上)。插件没有运行时依赖,也没有构建步骤。
方式 A(npm,推荐)
dsh plugin --profile <你的 profile> add dsh-quick-phrases
装完重启 DSH(或在会话页按 Ctrl+R)。包已发布到 npm:dsh-quick-phrases,升级时把 add 换成 update dsh-quick-phrases 即可。
方式 B(插件市场)
在 DSH 里打开 Plugins → Discover → Index sources,添加本仓库的索引地址:
https://cdn.jsdelivr.net/gh/pengtang1024/dsh-quick-phrases@main/index.json
之后在 Discover 里搜索「快捷短语」即可看到本插件与版本,点安装走的就是 plugin_manager。
方式 C(本地目录)
Plugins → Add plugin → 选择本仓库目录;或让 DSH 里的 agent 执行 plugin_manager install_bundle target=/path/to/dsh-quick-phrases。本地目录安装是 link: 方式,改完 client.js 只需重载页面、不必重装。
三种方式装的是同一个 bundle,不要同时装两份:用 npm 或市场装过之后,先把本地
link:那份卸掉再换。
使用
放在哪里
| 位置 | 插槽 | 说明 |
|---|---|---|
| 输入框下方(默认) | conversation.composer.dock | 常驻在输入卡片下方的一整行,最宽松;同样与卡片内边对齐。 |
| 输入框上方 | conversation.input.dock | 卡片上方一整行;宽度与居中按宿主 dock 几何计算,和卡片文字内边对齐。 |
| 工具行右侧 | conversation.input.right | 挤进输入框底部工具行;空间有限,超出部分横向滚动。 |

管理页
设置 → 快捷短语:上面四项决定位置、点按行为、短语行是否显示、以及输入框有内容时怎么收起;下面一条短语一张卡片。

- 拖动左侧
⠿手柄排序,或用↑/↓一格一格挪;列表顺序就是按钮的从左到右顺序。 - 卡片顶部那行是显示名称,直接点进去改;下面大框是发送内容。
- 卡片底部实时显示按钮预览和字数,名称太长一眼就能看出来。
- 每张卡片右上角的眼睛开关这条短语的显隐:关掉后按钮从短语行消失,卡片留在管理页并标上「已隐藏」,再点一次恢复。
- 页面上方的显示短语行开关:关掉 = 整排彻底隐藏(界面上连胶囊都没有),开关旁标出「整排已隐藏」;重新打开时顺带清掉之前「收起」留下的折叠状态,直接回到整排。
✕第一次只进入「确认」态(4 秒后自动撤回),再点一次才真正删除。- 新增短语会追加空卡片并聚焦名称;恢复默认在左侧,点一次进入确认态,再点一次恢复内置四条。
英文界面同样可用(跟随 DSH 界面语言)。
收起与隐藏
短语行占地方,但不该挡着打字。两种收起方式:
- 点行尾的 收起(
收起 ▾)—— 立刻收成一个小胶囊,再点胶囊临时展开; - 设置里把「输入框有内容时」保持默认的 自动收起:输入框里一有文字或附件,整排自动缩成胶囊;也可以改成「保持显示」。
收起后只留一个小胶囊 ▸ 快捷短语,点一下就能展开;带草稿时展开点按钮仍然插到光标处,不会覆盖你写的内容。

收起和彻底隐藏不是一回事:
- 收起只把整排折成小胶囊,胶囊还在输入框旁,点一下就回来;
- 彻底隐藏是设置里的「显示短语行」开关关掉:整排从界面完全消失,连胶囊都不留,界面上什么都不显示。恢复只能回到 设置 → 快捷短语 把开关打开(打开时会顺带清掉折叠状态,直接回到整排)。
单条短语则在管理页用眼睛开关隐藏;短语行的从左到右顺序与卡片顺序保持一致。
数据与隐私
短语、位置、点按行为、收起状态、自动收起选项与「整排彻底隐藏」状态分别存在 localStorage 的六个键里:
| 键 | 内容 |
|---|---|
dsh.quick-phrases.v1 | 短语列表(id / label / text / hidden) |
dsh.quick-phrases.placement.v1 | 显示位置 |
dsh.quick-phrases.click.v1 | 点按行为 |
dsh.quick-phrases.collapsed.v1 | 整排是否收起(1 / 0) |
dsh.quick-phrases.autohide.v1 | 输入框有内容时收起还是保持显示 |
dsh.quick-phrases.hidden.v1 | 整排是否彻底隐藏(1 / 0,1 时什么都不渲染) |
按 DSH Web 端的站点存储隔离;换机器或清空站点数据会丢。插件没有网络请求、没有 eval、不读写文件,也不向 Host 注册任何服务。
开发
node --check client.js # 语法
node test/smoke.mjs # 行为测试:假 React + 真 client.js,无依赖
node test/preview.mjs # 把真实组件渲染成 /tmp/*.html(深色/浅色)
node test/preview.mjs --shot # 再用无头 Chromium 截图
preview.mjs 默认从 Playwright 缓存里找 Chromium,可用 DQP_CHROME=/path/to/chrome 覆盖;主题 token 从宿主 app.asar 读取,可用 DQP_ASAR 覆盖(找不到时仍会输出未着色 HTML)。
目录结构:
client.js 客户端插件全部逻辑(ModuleLoader 工厂 + 三个插槽组件)
index.js Host 侧空壳(export function apply() {})
cordis.patch.yml bundle 插入行
locale/{zh,en}.json 插件管理器里的标题/描述/详情
docs/DETAIL*.md 中英文使用说明(插件详情页展示)
docs/ARCHITECTURE.md 实现说明:插槽、数据层、样式与测试
test/smoke.mjs 行为测试
test/preview.mjs 预览与截图
文档
许可证
MIT © 2026 pengtang1024