FeatherHunter/dsh-prompt

中文 · English

别再复制粘贴——点一下，模板进对话。 24 条深度模板，/prompt 与智能推荐主动兜底。 装好即用，可自定义。

你的 ⭐ 是我夜空中最亮的星。

Stop copy-pasting — one click, template in chat.

安装 INSTALL

前置要求：DSH（DeepSeek Harness）。 在 DSH 里，你下指令、AI 干活。 dsh-prompt 把常用提示词变成随手可点的模板。

# ① 安装 DSH CLI（已装跳过）
npm install -g @deepseek-ai/dsh

# ② 安装 dsh-prompt —— --profile 必填：装进你实际使用的 DSH 入口对应的 profile
#    （装错 profile 等于没装，重启多少次都不会加载）
dsh plugin --profile web add dsh-prompt     # 用自启 web 服务（dsh web）
#     或者
dsh plugin --profile desktop add dsh-prompt   # 用 DSH Desktop 桌面应用
# 锁定最新版更稳（当前 0.2.0）：
dsh plugin --profile web add dsh-prompt@0.2.0 --registry https://registry.npmjs.org
#     或者
dsh plugin --profile desktop add dsh-prompt@0.2.0 --registry https://registry.npmjs.org

装完重启一次对应入口即生效。 桌面端完全退出重开，web 端重启后刷新页面。 零配置：装了即用，卸了即走。

👇 装完重启，输入框左侧多出这枚按钮就是成功。

进阶安装：免全局、更新不生效、交给 AI

下面命令以 web profile 为例——DSH Desktop 桌面应用用户请把所有 --profile web 换成 --profile desktop。

# 免全局安装（想更稳，像上面一样锁版本）
npx --yes @deepseek-ai/dsh plugin --profile web add dsh-prompt

# 更新被静默忽略时，显式指定官方源
dsh plugin --profile web add dsh-prompt@latest --registry https://registry.npmjs.org

复制下面这段发给你的 AI，它会确认 profile、检查环境并按需安装：

请帮我安装 DeepSeek Harness 插件 dsh-prompt。先读仓库 README：https://github.com/FeatherHunter/dsh-prompt
先确认我实际使用的 DSH 入口对应哪个 profile（DSH Desktop 桌面应用 → desktop；自启 web 服务 → web），把插件装进正确的 profile；
然后自行检查环境并按需安装（已装的跳过），完成后简要汇报结果。

升级 · 卸载（desktop profile 用户把 --profile web 换成 --profile desktop）：

dsh plugin --profile web update dsh-prompt   # 升级
dsh plugin --profile web remove dsh-prompt   # 卸载

支持的 DSH 版本 SUPPORTED DSH

开发与验证基线：DSH CLI 0.2.0-rc.2 · DSH Desktop 2.0.9。 比基线更低的 DSH 版本未验证——装得上，但能不能跑对不保证；遇到了问题欢迎提 ISSUE。

下面这段是唯一的版本声明，package.json 的 dsh.engines.dsh 与它逐字一致（npm run test:issue-42 会比对，改一处忘另一处就变红）。声明只作说明：安装时不拦版本。

dsh.engines.dsh = >=0.2.0-rc.2
dsh.cli = 0.2.0-rc.2
dsh.desktop = 2.0.9

入口一 · Prompt 按钮 PROMPT BUTTON

鼠标移到输入框左侧的 ⚡Prompt 按钮，面板自动展开（点一下也行）。 阶段 tabs + 领域筛选 + 搜索，点一条，正文进输入框。 最常用的沉在底部，离按钮最近。

👇 按钮一点，面板长这样。

入口二 · /prompt 触发源 TRIGGER

键盘党的最爱：输入框敲 /prompt，候选实时过滤。 每行写清“名称 + 标签·阶段 — 正文前 42 字”。 只记得半个名也行：/prompt 复盘。

👇 输一半，候选自动收窄。

入口三 · 智能悬浮卡 SMART CARD

你不用找模板，模板来找你。 输入框里正常描述任务，命中关键词自动推荐。 默认开启，设置页可关；只看本地词表，不联网。

模板一览 TEMPLATES

随包 24 条预制模板，覆盖四大领域与三个阶段。 只读，删不掉改不坏，放心点。 想改哪条，复制为自定义再改。

👇 24 条全貌在设置页一次看完。

自定义与管理 CUSTOM

自己的话术存成模板：设置页一点新增，标题 + 正文写好即存。 常用置顶（最多 5 条），删除一次确认。 自定义与预制分开存，升级不丢。

👇 新增弹窗长这样，填完点添加。

隐私 PRIVACY

只存本地浏览器，零网络上报。 删插件即删数据。

本地诊断日志（默认关，只写你自己的电脑）

排查故障时，本插件会写一份结构化日志到本机 <DSH 家目录>/logs/dsh-prompt/YYYY-MM-DD.log（Windows 上是 C:\Users\<你>\.dsh\logs\dsh-prompt\）。开关在 设置 → 插件 → 提示词模板，默认关；关着的时候只记错误与告警，打开后才记信息与调试。开关以宿主为准，刷新页面不会改变它。

• 绝不记录模板名称与提示词正文——日志只记事件名、事件级别、计数、布尔值、时长与不可逆的短散列；模板身份只记一个 8 位散列。字段白名单写在仓库的 event-list.dsh-prompt.json，白名单之外的字段在客户端与宿主两侧各拦一次，写不进文件。
• 绝不自动上报。日志只落本机磁盘，导出要你自己点「导出日志」（下载成文件）或「复制正文」（进剪贴板）才会离开插件。
• 不自动清理：日志按天一个文件，不轮转也不自动删除；「清空日志」按钮删掉全部日志文件（两步确认）。
• 日志能力失败不影响插件本身：目录写不进去时自动降级到系统临时目录，再失败就彻底不落盘，只往 stderr 告警一次。

常见问题 FAQ

更新之后还是旧版本？

先显式指定官方源装一次（desktop 用户把 --profile web 换成 --profile desktop）：

dsh plugin --profile web add dsh-prompt@latest --registry https://registry.npmjs.org

装完重启对应入口。 桌面端完全退出重开，web 端重启后刷新页面（Ctrl+F5）。

装完没看到 Prompt 按钮？

先确认插件装进了当前入口对应的 profile（装错等于没装）。 桌面应用对应 --profile desktop，web 服务对应 --profile web。 确认无误后重启一次再看。

自定义模板与用量存在哪？会上传吗？

存在本地浏览器，不上传。 换浏览器或清数据会丢，常用模板备一份正文。

有英文文档吗？截图为什么是中文？

有，见 English。 截图首版中英共用一套，后续补英文截图。

作者的其他作品 MORE

喜欢这个插件的话，这些可能你也用得上：

dsh-opencode-palette —— 34 款 opencode 经典配色一键换装 DSH，即点即换，重启不丢

dsh-plugin-ui-debug —— 用真实 Chrome 无头浏览器，给 DSH 插件 UI 做闭环调试

dsh-mattpocock-skills-deck —— 25 个工程技能包，面板上直接调用，无需手动装技能

dsh-chinese-skill-patch —— 让 DSH 直接用中文技能名，技能不必改英文名

---

有问题、有想法？提交 ISSUE，用法交流、新模板点子、需求与 Bug 都欢迎

个人作品，与 DeepSeek Harness 官方没有关系。 MIT © FeatherHunter

致谢 THANKS

感谢每一位点星、提 Issue 的朋友，是你们让这个工具箱一点点变好。

dsh-prompt 还在等第一位外部贡献者。 提交 Issue、PR 或分享自定义模板，你的名字就会出现在这里。 已经做过的朋友，请直接告诉我。