前言¶
在 DeepSeek Harness（DSH）里和 Agent 对话时，同一类指令往往会反复出现：让模型「继续」、要「建议」、确认「采纳」某条方案，或固定一句跑测试、写提交说明的提示。每次都手打，或从笔记里复制粘贴，会打断节奏。社区里也有人把提示词写在单独文档里，但切窗口仍然麻烦。
下面介绍的是客户端插件 提示词快捷按钮（npm 包 @cdredfox/dsh-prompt-shortcuts，维护者 cdredfox）。它把常用提示词存成输入框上方的一排按钮，点一下即填入（替换）当前输入框内容；条数多时可以置顶、搜索，宽度不够时自动收进「更多」。数据写在 Host 侧的 JSON 文件里，不依赖浏览器缓存。
这是什么¶
这是一个挂在 DSH conversation.input.dock 槽位上的 Web 客户端插件——该槽位即「输入框上方的整宽条目」，与官方排队提示条同一位置。装好后，每次打开会话都能在输入框正上方看到自己的快捷按钮栏。
- 仓库：cdredfox/dsh-prompt-shortcuts
- 社区目录：SkillHub 插件页
- 分类：客户端
- 许可证：MIT（见仓库
LICENSE）
核心功能¶
输入框上方的快捷按钮栏¶
每条置顶（enabled: true）的提示词对应一个按钮。点击后替换输入框当前内容；鼠标悬停可查看完整提示词。样式使用 DSH 主题变量，随明暗主题与字号变化。
自动收纳与「更多」¶
按钮栏固定单行，排不下时不换行。未显示的条目（含手动取消置顶、或因宽度被挤下去的）进入「更多」下拉，点选同样填入输入框。
维护面板¶
点「添加指令」打开面板：卡片网格列出全部提示词，带搜索；可对单条编辑、置顶/取消置顶、删除（删除有二次确认）。点卡片本身会填入输入框。单条编辑在卡片上点「编辑」，改完「返回列表」，再点「保存」写入。
数据存储¶
提示词保存在 Host 侧 JSON 文件：
$DSH_HOME/prompt-shortcuts.json
未设置 DSH_HOME 时为 ~/.dsh/prompt-shortcuts.json。写入采用原子替换并串行排队；换浏览器或清空站点数据不会丢配置。可选插件配置项 dshHome、file 可覆盖路径。首次使用自带三条默认提示词：继续、建议、采纳。
自 1.1.0 起改存 Host 文件；1.0.x 在浏览器 localStorage 里的旧数据不会自动迁移，升级后若需保留旧数据需自行导出（见官方 README）。
Agent 工具¶
插件注册 Agent 工具 prompt_shortcuts，支持 list / save / remove，与界面共用同一存储。例如可在对话里说：「帮我加一条提示词，名字叫跑测试，内容是运行全部测试并修复失败项。」
安装与启用¶
环境要求：DSH 版本需包含 conversation.input.dock 槽位；Web 端依赖 @deepseek-ai/dsh-client-store（DSH Web 自带）。包内 index.js 与 client.js 直接可加载，无构建步骤、无额外运行时依赖。
推荐从 npm 安装稳定版（将 web 换成你实际使用的 profile，例如 tauri）：
dsh plugin --profile web add @cdredfox/dsh-prompt-shortcuts
安装完成后重启 dsh web 并刷新浏览器，按钮栏会出现在输入框上方。卸载：
dsh plugin --profile web remove @cdredfox/dsh-prompt-shortcuts
插件随 DSH 进程以当前用户权限运行；安装前建议浏览仓库源码并确认 MIT 许可证是否符合你的合规要求。
典型用法¶
| 操作 | 结果 |
|---|---|
| 点按钮栏上的提示词 | 替换输入框内容 |
| 点「更多」 | 展开未显示的提示词列表 |
| 点「添加指令」 | 打开维护面板 |
| 面板里点卡片 | 填入输入框并关闭面板 |
| 面板里点「编辑」 | 修改名称和内容 |
| 面板里点「置顶」 | 控制是否显示在按钮栏上 |
| 面板里点「删除」 | 删除（需二次确认） |
数据文件结构示例（也可手工编辑，坏行会在读取时被跳过）：
{
"shortcuts": [
{ "id": "seed-continue", "label": "继续", "prompt": "继续", "enabled": true }
]
}
调试 HTTP 接口时，可对插件路由 POST /api/dsh-prompt-shortcuts 发 JSON（token 取启动日志里 ?token= 后的值），例如列出全部：
curl -X POST "http://127.0.0.1:3080/api/dsh-prompt-shortcuts?token=$TOKEN" \
-H 'content-type: application/json' \
-d '{"action":"list"}'
适用场景与注意¶
适合谁： 经常在 DSH 里重复发送固定句式或短指令的开发者；希望把「继续 / 复盘 / 跑测试」等收口到输入框附近、又不想依赖浏览器本地存储的人。
已知限制（来自官方 README）： 提示词仅支持纯文本，无变量、模板或附件；按钮栏只负责填入，编辑须进维护面板；图标为内联 SVG，DSH 官方图标集不对插件开放导入。
DSH 生态强调「一切皆插件」；SkillHub 等社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。本插件当前在 GitHub 上星标为 0，功能与版本以仓库 README 与 npm 发布为准（package.json 中版本为 1.1.2）。
结尾¶
若你希望减少重复输入、又把提示词清单放在 Host 可备份的 JSON 里，@cdredfox/dsh-prompt-shortcuts 提供了一行快捷按钮加维护面板，并可通过 prompt_shortcuts 让 Agent 代为维护。详情见 GitHub 仓库 与 SkillHub 目录页。
