提示库（Prompt Library）

好提示词，不应该只用一次。

DSH Web UI 插件：把散落在聊天、备忘录、网页和文档里的提示词集中保存，用标签、收藏、置顶、 最近使用、评分和搜索快速找到，并复制或安全插入当前会话草稿。数据默认只保存在本机浏览器； AI 辅助评价由用户主动触发，复用 DSH 已配置的模型服务，仅作为第二视角参考。

• 产品定位与验收：见需求书；实现契约与决策记录：见同级 DESIGN.md
• 依赖：DeepSeek Harness 0.2.2-rc.1（客户端插件机制、sidebar.panellist / main / conversation.input.right 槽位、inputActions.captureInsertion()/insertText()、 ctx.locale、ctx.llm、ctx.agentDefaultModel、ctx.webServer）

功能

侧栏整页管理面板

左侧栏「提示库」图标打开整页管理：

• 导航：全部提示词、收藏、最近使用、未评分、待复评；质量筛选 4 星及以上 / 3 星及以上； 标签列表（含计数）与标签管理（新建、重命名、上移/下移排序、删除；删除只移除分类关系， 不会删除提示词）。
• 列表：搜索（标题、正文、标签；忽略英文大小写，可与视图/标签/评分筛选组合）、 排序（默认 / 最近更新 / 最近使用 / 评分从高到低 / 评分从低到高，下方注明规则）、 标题、摘要、标签、评分、收藏/置顶标识；空态、首用欢迎、无结果一键清除筛选。
• 详情：完整正文（默认纯文本、保留换行；可切换 Markdown 渲染预览，只读、偏好在浏览器记住）、 使用场景、标签、个人评分与评价备注、AI 辅助评价、编辑/复制正文/收藏/置顶/删除/分享按钮。
• 新建 / 编辑：标题和正文必填（纯空白拒绝）；正文多行原样保留；多标签；关闭有未保存 修改的编辑弹层会先确认；保存失败保留草稿并说明原因，不出现虚假成功。
• 删除：二次确认。
• 窄窗口：列表与详情分步展示；弹层、按钮、焦点和键盘操作适配触控与桌面。

输入框快捷入口

会话输入框工具栏新增「提示库」按钮，点击打开轻量选择面板（不离开当前会话）：

• 分类页签：全部 / 置顶 / 收藏 / 最近使用（默认「全部」，带数量，键盘 ←/→ 可切换）； 搜索标题/正文/标签时自动展示匹配结果；每行展示标题、标签和个人评分。
• 草稿按钮与快捷面板的「保存草稿」会通过宿主 useInput 订阅实时草稿，输入内容后按钮立即可用、 悬浮说明与捕获内容都是当前草稿（不依赖可能过期的 slot 快照）。
• 预览完整正文后，可「复制正文」或「插入输入框」（在光标/选区处插入，可撤销，不自动发送， 不覆盖整份草稿）。
• 复制/插入成功后显示不打断操作的「用后评分」入口。
• 当前 DSH 无安全插入接口时明确降级为复制（不通过 DOM 模拟输入）。

快速收录（Quick capture）

目标：看到好内容，几秒存下来；分类、评分和 AI 评价都可以以后再做。 先保存、再整理，原文不改写。

• 入口
  • 整页管理面板头部「快速收录」；
  • 输入框旁快捷面板「快速收录」「保存草稿为提示词」（悬浮即显示说明）；
  • 会话输入框工具栏「存草稿」图标按钮（仅图标、悬浮/聚焦即时显示说明；整份草稿快照）；
  • 对话中选中文本后的浮层「收录为提示词」（通过 DSH 公开的 ctx.uiConversation.interactions + conversation.chat.text-interaction 扩展点）。
• 收录弹层：自动聚焦正文；正文是唯一必填项；标题按正文首个非空行自动生成（≤40 个可见字符， 超长加省略号）；标题可直接手动改写（标记为「已手动修改」、正文变化不再覆盖），点「恢复自动标题」 标题旁常驻「自动生成」按钮：手动修改后点击可撤回为当前正文的自动建议，替换前会二次确认（替换 / 保留当前标题），已是自动标题时按钮禁用；清空标题时输入框保持为空（可正常删除到最后一个字符），保存时仍使用自动建议；标签复用已有标签、可稍后整理； 「更多选项」含使用场景与来源说明；显示「保存到：收件箱」。Ctrl/Cmd+Enter 保存（输入法组合期间 不触发），Esc 关闭时对未保存内容二次确认；保存中防重复提交；保存失败保留全部输入并显示原因。 ｜ 成功后才显示「已收录」，提供「查看」（跳到管理面板并选中该条）和「继续收录」（清空正文/标题/ 来源/场景/标签、重新聚焦正文，不继承上一条标签）。
• 收件箱：快速收录默认进入「收件箱」整理状态（不是标签）；收件箱条目同样支持搜索、复制、插入、 评分和加标签；详情页可「标记整理完成」或「重新移回收件箱」，与评分/标签/收藏/置顶互不影响； 旧数据升级默认「已整理」，不会被批量塞进收件箱。
• 重复提醒：保存前只比较正文。正文完全相同提示「此内容已收录」；仅首尾空白或换行编码不同提示 「疑似重复」；内部空格/缩进/大小写差异不算重复。可选择「查看已有」（弹层内预览，不丢失当前 未保存内容）、「返回继续编辑」或「仍然另存」。另存创建独立条目，不继承已有评分/使用次数/AI 评价。
• 来源元数据：记录来源类型（手动粘贴 / 输入框草稿 / 对话消息）、收录时间、可选来源说明， 输入框/对话来源还会记录来源会话 id（消息 id 字段已预留，受接口限制目前无法获得）。来源信息独立 保存，不随复制/插入正文，不上传；详情页可尝试「打开来源会话」，会话已不可用时给出明确反馈且 正文仍然可用。收录时间与创建/更新时间语义分开，后续编辑不改变收录时间。
• 限制（当前 DSH 0.2.2-rc.1）：输入框没有安全的选区读取接口，因此「存草稿」收录整份草稿 并在弹层说明（若只需选区，请复制后使用快速收录）；没有通用「单条消息操作菜单」扩展点，因此 不支持从消息菜单收录整条消息，可用选中文本收录替代；两点均不使用宿主 DOM 强行模拟。 首版不提供 AI 辅助整理/改写（保存成功后仍可使用详情页现有的 AI 评价）。

正文显示：纯文本 / Markdown 预览

• 默认按纯文本显示（white-space: pre-wrap），完全保留原始换行、空白与 Markdown 标记字面值。
• 详情页和快捷面板预览可切换到 Markdown 渲染（只读预览，偏好保存在 dsh-prompt-library:ui/v1 的 bodyRender）：支持标题、段落与换行、粗体/斜体/删除线、 行内代码与围栏代码块、无序/有序列表、引用、表格、水平线、安全链接（仅绝对 http(s):// / mailto:，新窗口打开）。
• 安全边界：渲染基于 React 文本节点，不使用 HTML 解析或 dangerouslySetInnerHTML； 正文里的 HTML/脚本按字面文本显示，不执行；图片 Markdown 不加载远程图片，按字面显示。
• 复制、插入、搜索、CSV/JSON 导出、AI 评价始终使用原始 Markdown 文本，渲染只影响阅读。

提示词与评分

• 收藏与置顶互相独立；默认排序置顶优先、同组按更新时间倒序；显式排序不被置顶插队。
• 「最近使用」严格按最后使用时间倒序，置顶不改变顺序；只有复制或插入成功才记录使用， 查看/编辑/评分/AI 评价都不计为使用。
• 1～5 星个人评分、允许半星、可修改/清除；支持键盘操作与明确的无障碍标签； 未评分与低分严格区分。
• 评价备注单独保存；复制/插入只复制正文。
• 正文版本关联：正文变化后保留旧评分与备注，标记为「待复评」；旧评分可查看但不参与当前 版本的评分排序与 4 星+/3 星+ 筛选；重新评分或点「沿用原评分」后解除。 标题、使用场景、标签、收藏、置顶变化不使评分失效。
• 个人评分说明：反映你自己的实际使用体验，不代表提示词在所有模型和任务中都有效。

AI 辅助评价（可选，需 Host 半可用）

• 仅由用户在详情页/编辑页主动点击触发；不自动、不批量；评价语言跟随界面语言（中文界面使用需求书给定的中文评审指令，英文界面使用等价英文指令）。
• 调用前显示所用模型/provider，说明将发送标题、正文、使用场景（不含个人评价备注、 其他提示词、会话历史），并提示可能产生模型费用。
• 评价调用会为该短评审任务自动选择模型可用的最低 reasoning effort（如 off/low）并保留 独立输出预算，避免思考 token 占满 max_tokens 导致「模型输出被截断」；不支持 reasoning 元数据的适配器会省略该字段，按服务默认执行。
• 评价正文最多 200 个可见字符（按 Unicode 码点，标点计入，空白不计），超限时最多自动 压缩一次并再次校验；仍超限则报错，不展示超长正文。
• 依据目标清晰度、上下文充分性、约束合理性、输出要求和可复用性，给出优点、潜在问题和一条 优先改进建议；不给 AI 星级，不声称已验证效果，不执行提示词数据中的指令。
• 固定提示：「AI 评价仅供参考，实际效果请以你的使用体验为准。」
• 评价展示生成时间与模型；支持重新生成/删除；重新生成成功才替换旧结果，失败保留旧结果； 不改变个人评分、收藏、置顶或排序。
• 评价与提交时的标题/正文/场景快照绑定；这些输入变化后显示「内容已修改，建议重新评价」； 标签/收藏/置顶/个人评分变化不影响。编辑页对未保存草稿的评价不会覆盖已保存版本的评价， 只有保存内容与评价输入一致时才关联。

导入 / 导出

• CSV（用于交换）：列 title,body,tags,usage,rating,note,organize,sourceNote（也接受中文表头别名，如 整理状态、来源说明）。 多标签编码为 JSON 数组字符串（如 ["写作","代码"]），因此标签名内的逗号、引号不会 被错误拆分；按 RFC 4180 处理中文、引号、逗号和跨行正文；评分限定 0.5 步进的 1～5 星。 导出时对 = + - @ 等公式前导字符加 ' 防护，导入时对称还原（见下文限制）。 提供字段说明与可下载模板；导入前预览新增/重复/无效数量及原因，确认后才写入； 重复项按「标题+正文完全相同」识别并跳过，不静默覆盖；CSV 无法保留正文版本关联， 导入的评分一律按「待复评」保守处理。
• JSON（用于完整备份/迁移）：保留提示词、标签及排序、收藏、置顶、使用时间与次数、 个人评分/备注及评分版本关联、AI 评价（正文、模型、生成时间、输入快照）和数据版本号。 恢复前校验格式与版本，可选择合并（跳过同 id 重复，不覆盖已有）或替换； 替换需二次确认，且写入失败不会破坏现有数据。
• 兼容旧数据：缺少评分按未评分、缺少 AI 评价显示尚未评价、缺少版本关联不伪造有效性； 不会自动调用 AI 补齐历史评价。

数据保存位置与隐私

• 数据保存在当前浏览器当前访问地址的 localStorage：
  • 提示词/标签/评分/AI 评价/整理状态/收录来源：键 dsh-prompt-library/v1
  • 界面偏好（视图/筛选/排序/正文显示方式）：键 dsh-prompt-library:ui/v1
• 快速收录的来源信息（来源类型、收录时间、可选来源会话 id、来源说明）只随提示词本地保存； 不默认上传、不自动同步，CSV 导出不包含来源会话标识，JSON 备份完整保留。
  • 清理站点数据、更换浏览器、更换访问地址（如端口变化）、更换设备或使用隐私模式， 都可能导致数据不可见或丢失；请用 JSON 完整备份迁移。
• 不默认上传、不自动启用第三方同步；首版不含 iCloud 或其他云同步。
• 存储失败、容量不足、数据损坏均有明确提示，不静默重置或覆盖原始数据：数据损坏时暂停写入， 提供原始数据下载，只有用户明确确认后才重置。
• AI 评价只在用户主动点击时执行：仅发送标题、正文、使用场景；不发送个人评价备注、其他 提示词或会话历史；不创建/发送/污染会话消息；评价任务不启用工具调用。模型调用在 Host 侧经 ctx.llm 完成，前端不接触密钥。
• 提示词正文是用户数据，不自动执行，不注入系统提示词，不注入所有会话。

AI 评价的模型接入与配置

• Host 半挂载时通过 ctx.inject(['llm']) 使用当前 DSH 已配置的模型服务，不额外保存密钥。
• 模型选择顺序：
  1. 插件行配置 provider + model（可选，见下）；
  2. 当前 DSH 的默认模型（ctx.agentDefaultModel.currentSelection()，即设置里的默认模型）；
  3. 已注册 provider 的第一个可用模型。 都不可用（未配置任何模型/模型服务缺失/旧版本 DSH 无相关接口）时，界面明确提示 「AI 评价不可用」，管理、评分、复制、导入导出等功能不受影响。
• 可选固定模型（编辑 ~/.dsh/profiles/<profile>/cordis.patch.yml 中本插件行）：

  - id: prompt-library
    name: '@wngzwng/dsh-prompt-library'
    config:
      provider: deepseek-account
      model: deepseek-flash
  

• 费用：AI 评价使用你的模型账号发起一次（超长时最多两次）普通模型调用，可能产生模型费用； 调用前界面会写明所用模型。评价任务不传 tools、不传 sessionId，不会在会话里产生消息。

安装

前置：已安装 DSH（0.2.2-rc.1 及以上、0.3.0 以下）。

从插件市场安装（推荐）：在 DSH 的「插件市场」中搜索「提示库」，一键安装。

手动安装：从 Releases 下载 wngzwng-dsh-prompt-library-1.0.0.tgz，然后：

dsh plugin --profile web add https://github.com/wngzwng/dsh-prompt-library/releases/download/1.0.0/wngzwng-dsh-prompt-library-1.0.0.tgz

从源码开发：

git clone https://github.com/wngzwng/dsh-prompt-library.git
cd dsh-prompt-library
node build-client.mjs          # 把 core.js 与 src/*.js 嵌入 client.js
# 在 DSH 中安装本目录（会话里让 Agent 执行，或 Plugin Manager 选择目录）
#   plugin_manager install_bundle target: <仓库绝对路径>

安装后如界面没有立即变化，重启 DSH 或刷新页面。左侧栏出现「提示库」图标；会话输入框工具区 出现「提示库」快捷入口。卸载插件不会删除浏览器里的数据（重新安装可见）。

开发

构建、测试与实现细节见 DESIGN.md。

已知限制与兼容性

• 只支持 DSH 0.2.2-rc.1 的公开扩展接口；更老版本若缺少 conversation.input.right、 captureInsertion/insertText、ctx.llm 或 ctx.webServer，快捷入口/AI 评价会明确降级 （插入不可用→复制；AI 不可用→提示），管理功能不受影响。
• 插入仅从输入框旁快捷面板发起：整页面板不在 composer 作用域，拿不到 inputActions， 因此详情页提供「复制正文」；请从输入框快捷面板执行“插入输入框”。
• 快速收录的接口限制：输入框没有安全的选区读取接口，「存草稿」收录整份草稿并在弹层说明； 没有通用「单条消息操作菜单」扩展点，不能从消息菜单收录整条消息，可用选中文本收录替代； 没有公开的“跳到具体消息”接口，来源可打开来源会话，消息 id 仅保留字段与说明；这些限制均不通过 DOM 模拟绕过。
• AI 辅助整理/改写不在首版：收录过程不调用 AI；保存后可在详情页使用现有 AI 评价（用户主动触发）。
• 数据仅在当前浏览器当前 origin；不跨设备同步。多标签页同时编辑时以最后一次成功写入为准 （storage 事件会刷新其他标签页的显示，但不做冲突合并）。
• CSV 公式注入防护：导出时对以 = + - @ \t \r 开头的字段加前导 '，导入时仅当 ' 后紧跟 这些字符才去掉一个 '。因此“原文本身以 '= 等开头”的字段往返会少一个 '；其余文本 （含中文、多行、引号、逗号）往返不变。需要严格无损迁移时请用 JSON。
• CSV 不包含 AI 评价和正文版本号；导入评分按「待复评」处理（不会误认为当前版本有效评分）。
• AI 评价不保证模型响应质量；仅在配置了可用模型时可用，且每次调用都可能计费；Host 路由为本机 HTTP exact 路由（与其它本地插件同一模式），带 Origin/Host 校验，不向浏览器返回密钥。
• 整页面板使用宿主 main 槽位高度（height:100%）；若某个自定义组合没有给主面板高度， 三栏可能显示为塌陷，常规 DSH Web/桌面组合不受影响。

English summary

Prompt Library for the DeepSeek Harness Web UI: a sidebar page to save/tag/favorite/pin/rate and search prompts (with half-star personal ratings and version-aware "needs re-rating" state), plus a quick picker beside the composer to copy or safely insert a prompt into the current draft. Data is stored in this browser's localStorage; CSV export/import is for exchange and JSON for full backups. Quick capture saves pasted text, the whole composer draft, or selected chat text into an Inbox with an auto title, duplicate warnings and independent source metadata. An optional, user-triggered AI review uses the DSH model service on the Host half only (no keys in the browser) and is shown as a clearly-labelled reference, never as a personal rating.

许可证

MIT © 2026 wngzwng