目录

• 效果预览
• 它解决什么问题
• 功能特性
• 界面与架构
• 安装
• 快速上手
• 配置项
• 数据与隐私
• 内置源与许可
• 添加自定义源
• 常见问题
• 目录结构
• 开发与自检
• 状态与已知限制
• 路线图
• 参与贡献
• 许可

效果预览

市场：一个浮层里浏览、搜索、收藏

三个内置源合计 2527 条（已扣除内容过滤条数）。

顶部可搜索标题 / 描述 / 正文 / 标签，右侧可选分类与排序；每条右侧是「插入 / 替换 / 详情 / ★」。 底部实时显示当前列的来源、语言、许可与标签。

源管理：连通性、许可与署名一目了然

两处值得注意的细节：

• 「状态」列显示每个源实际加载了多少条 —— 连接失败会如实报错，不静默假装成功
• 「许可」列把两个 MIT 库区分开：一个是 MIT，另一个是 MIT-plexpt （版权人不同的两个库，署名不混用）

我的：自己写、自己改

自建提示词存在本机，可编辑、可删除、可导出带走。

收藏：随手取用

添加自定义源（带可折叠说明书）

说明书讲清了怎么判断一个网址能不能用（看到的必须是带 {} / [] 的原始数据， 而不是排版好的网页），并给出可直接照抄的示例。

内容过滤与写入诊断

内容过滤默认开启，六条规则可逐条开关、可加自定义屏蔽词； 「写入字段」可在中文说明与英文原文之间切换。

它解决什么问题

用 AI 写东西时，好用的提示词总是散落在浏览器书签、笔记、别人的聊天记录里。真要用的时候要么找不到，要么复制过来还得改半天。

这个插件把「找提示词 → 用提示词」压缩成两步：

点输入框左边的「提示词导入」  →  点某一条的「插入」

功能特性

写入行为

• 默认插入中文说明（description）—— 便于阅读和二次修改
• 可在「源管理 → 高级 → 写入字段」切换为英文原文（prompt）
• 插入走 inputActions.insertText()，因此插入后可 Ctrl+Z 撤销
• 输入框已有内容时，默认插入到光标处，不覆盖你已写的内容
• 想整段替换：先 Ctrl+A 全选草稿，再点「替换」

⚠️ 能力边界（如实说明）

插件的 InputActions 只提供 captureInsertion / insertText / setDraft，没有清空草稿或设置选区的能力。 因此「替换整段」依赖用户手动全选 —— 插件无法主动清空你的草稿。 这是 DSH 当前接口的边界，不是本插件的取舍。

界面与架构

界面组成

flowchart LR
    A["输入框<br/>conversation.input.left"] --> B["「提示词导入」按钮"]
    B --> C["浮层面板<br/>conversation.input.overlay"]
    C --> D["市场"]
    C --> E["收藏"]
    C --> F["我的"]
    C --> G["源管理"]
    D --> H["insertText 写入输入框"]
    E --> H
    F --> H

界面挂在 DSH 的两个官方插槽上，不侵入对话区，也不改写其他插件的 UI。

数据流

flowchart TD
    S1["f/prompts.chat<br/>CSV · CC0"] --> N["normalize<br/>四种适配器"]
    S2["ChatGPT-Shortcut<br/>JSON · MIT"] --> N
    S3["PlexPt<br/>JSON · MIT"] --> N
    S4["自定义 JSON 源"] --> N
    N --> FL["filter<br/>内容过滤"]
    FL --> ST["storage<br/>localStorage 缓存 + 状态"]
    ST --> API["api 门面"]
    API --> UI["ui 界面层"]
    UI --> W["写入通道<br/>insertText"]

降级链：网络失败 → 用本地缓存 → 缓存也没有 → 返回可展示的错误态，不白屏、不抛未捕获异常。

安装

前置

• DeepSeek Harness 桌面端
• 插件运行时不依赖 Node（Node 只在跑开发自检时需要）

⚠️ 先分清：你在对话框里填，还是在终端里跑

这两种地方要填的内容不一样：

🔴 最常见的错误：把整条 dsh plugin --profile desktop add https://... 粘进对话框 —— 会报 「无法识别这个包名或地址：not a package name the registry accepts」。 对话框里不要那一截 dsh plugin --profile desktop add。

方式一：不用 git（推荐）

① 对话框里，只填这一行：

https://github.com/yi-yezhiqiu/dsh-prompt-market/releases/download/v0.1.1/dsh-prompt-market-0.1.1.tgz

② 或者在终端里跑：

dsh plugin --profile desktop add https://github.com/yi-yezhiqiu/dsh-prompt-market/releases/download/v0.1.1/dsh-prompt-market-0.1.1.tgz

✅ 这条不需要 git —— 它直接下载 Release 附件（实测 2 秒装完）。 如果你机器上没装 git，用这条。

方式二：从 GitHub 仓库安装（需要 git）

① 对话框里填：

github:yi-yezhiqiu/dsh-prompt-market

（写成 https://github.com/yi-yezhiqiu/dsh-prompt-market 也可以）

② 或者在终端里跑：

dsh plugin --profile desktop add github:yi-yezhiqiu/dsh-prompt-market

⚠️ 这种方式要求本机已安装 git —— pnpm 要靠它拉取仓库。 没装的话会失败，报错形如：

[ERROR] Command failed with exit code 1: git ls-remote "https://github.com/..."
'git' 不是内部或外部命令，也不是可运行的程序或批处理文件。

遇到这个就改用「方式一」，或者先装 git（winget install Git.Git）。

方式三：本地目录安装

先在本地克隆（或直接下载仓库 ZIP 解压），再安装那个目录：

git clone https://github.com/yi-yezhiqiu/dsh-prompt-market.git
dsh plugin --profile desktop add "<刚克隆出来的目录>"

dsh 不在 PATH 时，用 DSH 安装目录下的垫片：

"<DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "<目录>"

方式四：软链接（开发者）

mklink /D "<DSH profile>\node_modules\dsh-prompt-market" "<本仓库路径>"

改代码后只需重启 DSH，不用重装。

🔄 安装后必须完全退出并重新打开 DSH —— profile 是启动期加载的。

ℹ️ DSH 的插件安装实际由 pnpm 完成。插件包没有 prepare 构建脚本， 所以不需要在 pnpm-workspace.yaml 里配置 allowBuilds。

验证安装

重启后，输入框左侧应出现「提示词导入」按钮，点开应有四个页签。

快速上手

1. 点输入框左侧「提示词导入」
2. 在「市场」页签搜索你想要的场景（如「写作」「翻译」「代码审查」）
3. 点某条右侧的「插入」—— 文本进入输入框
4. 按需补充细节，然后发送
5. 常用的点 ⭐ 收藏，下次直接在「收藏」页签取
6. 自己常写的提示词，去「我的」页签新建保存

配置项

「源管理」页签内可调：

数据与隐私

卸载不会自动清掉数据 —— 需要清干净时在开发者工具里删除 dsh-prompt-market: 前缀的键。

内置源与许可

完整的版权行与许可正文见 THIRD-PARTY-NOTICES.md。

📌 内容不随包分发。 插件在运行时从 CDN 拉取这些源的数据并缓存在用户本机； 本仓库不包含任何上游提示词内容。

添加自定义源

「源管理 → 添加自定义源」里填入任意返回 JSON 数组的地址，插件会自动识别常见字段名：

GitHub 上的 JSON 请用 jsDelivr 镜像（raw.githubusercontent.com 在部分网络环境不可达）：

https://cdn.jsdelivr.net/gh/<用户名>/<仓库名>@main/<文件路径>.json

添加页里有可折叠的详细说明书，讲清了判据、示例与常见坑。

常见问题

目录结构

（仓库根目录就是插件包根 —— pnpm 会在这里找 package.json）

package.json                 包元数据：dsh.bundle.patch + dsh.client
cordis.patch.yml             profile 层补丁（一行 insert 挂载本插件）
index.js                     Host 半身（ESM）
client.js                    ★ 浏览器半身（装配产物，DSH 唯一加载的客户端入口）
core/                        数据层
├── *.js                     9 个可独立阅读的单元
├── browser.js               浏览器半身成品源码（免构建，可直接内联）
├── selftest-node.js         数据层自检（Node 运行）
└── check-data-layer.ps1     静态自检（无需 JS 运行时）
ui/                          界面层
├── 00-core.js … 80-client-shell.js
├── check-ui.ps1             界面静态自检
└── DESIGN.md                界面设计契约
lib/write-draft.js           低层写入封装（仅探针 / 诊断用）

README.md / README-en.md / README-ja.md     三语文档
docs/DEVELOPMENT.md          开发与装配说明
docs/images/                 截图
CHANGELOG.md                 更新日志
CONTRIBUTING.md              贡献指南
THIRD-PARTY-NOTICES.md       上游许可与署名
LICENSE                      MIT
.github/ISSUE_TEMPLATE/      issue 模板

为什么可以没有构建步骤

client.js 由 core/browser.js 的 9 个数据单元 + ui/ 的 8 个界面单元， 按 ui/80-client-shell.js 模板装配而成。

界面代码是手写的 window.__ModuleLoader__.load({ id, factory }) 形式 —— 没有打包器、没有 JSX、没有 TypeScript，源码即产物。因此装配结果也纳入了版本控制。

开发与自检

:: 语法检查（全仓库 .js；自动跳过 core/.browser-parts 的两个拼装片段）
node check-syntax.js

:: 权威判据：装配区段 ↔ browser.js 单元区段，逐行一致
node core/build-client-bundle.js --check

:: 数据层自检（真跑算法）
node core/selftest-node.js

:: 数据层静态自检（无需 JS 运行时的结构断言）
powershell -NoProfile -ExecutionPolicy Bypass -File core/check-data-layer.ps1

:: 界面静态自检
powershell -NoProfile -ExecutionPolicy Bypass -File ui/check-ui.ps1

⚠️ 一致性判据只看「区段对区段」：client.js 的 PM-CORE-INLINE 区段 ↔ browser.js 的单元区段，逐行一致（忽略行首缩进与空行）。 不要拿 client.js 整文件去比 browser.js 整文件（前者是装配产物、含壳层与 UI 区，长度本就无关）， 也不要拿 browser.js 去比 core/*.js（单元体是精简重写版，逐行 diff 必然误报）。

状态与已知限制

本项目经过独立评审（三轮，阻塞项已全部闭合）与真机实测。以下是如实声明：

✅ 已实测（真机运行确认）

按钮可见 · 面板四页签 · 插入为中文 · 写入后可发送 · 关面板草稿保留 · Ctrl+Z 可撤销 · 写入字段切换 · 详情关闭 · 自定义源说明书 · 许可与署名分源呈现 · 打包可安装性（pack.ps1 / verify-package.ps1 退出码 0）· 各静态自检退出码 0 · 三个内置源逐条解析 —— 原始条数 prompts-chat-csv 2165 / chatgpt-shortcut-zh 279 / plexpt-prompts-zh 124，扣除内容过滤后为 2140 / 267 / 120，合计 2527

最后一项由两条独立路径互相印证：Node 侧实跑数据层（verify-sources.js）， 与真机界面显示的条数完全吻合。

📦 安装路径：已由第三方机器验证（不是维护者自测）

这一项长期处于「未实测」。而它暴露过两个真实缺陷，都是靠别人的反馈才发现的：

1. v0.1.0 的包根在 plugin/ 子目录 ⇒ 从仓库地址装不上；
2. 文档只写了「需要 git」，却没给不装 git 的办法 ⇒ 没装 git 的人直接被挡在门外。

维护者本机自测通过 ≠ 别人能装上。 这条记录保留在此，提醒后来者。

🟨 未实测（设计正确，但未取得运行期证据）

断网降级 · 重启后收藏与自建持久化 · 内容过滤对真实中文条目的运行期生效 · 条件「替换」动作

这些不是「有问题」，而是「没验证过」。我们不把它们写成「已验证」。

🔴 交付后发现并修复的真实缺陷

这个缺陷恰好落在上面「未实测」清单里（原「三个源逐条解析的完整性」一项）， 而且是由用户的真机截图发现的，不是由任何自检脚本发现的。

原代码注释写着「防止 8 MB 级文件把编辑器拖死；已决定避开」—— 也就是说，设计时假定内置源都是小文件。这个假设被运行期证据推翻了。

这就是「未实测」三个字的真实含义：它不是「大概没问题」，而是「可能真的坏着」。

已知限制

路线图

• [ ] 提示词变量填充（{{变量}} 占位与填写面板）
• [ ] 收藏分组 / 文件夹
• [ ] 支持 Gitee 及任意 CORS 友好的 JSON 源
• [ ] 内置源可增删排序
• [ ] 界面自检 A14 的 WARN 清零（与下一次装配一并处理）

路线图是计划，不是承诺。有优先级需求请开 issue。

参与贡献

欢迎 issue 与 PR，请先读 CONTRIBUTING.md。

特别欢迎：

• 🐛 报告未实测清单里那些场景的实测结果（无论通过还是失败，都有价值）
• 🌐 补充内置提示词源（请附上上游许可与版权人）
• 🌍 翻译 README（目前有中文、英文、日文）

许可

本插件代码以 MIT 发布，见 LICENSE。

内置数据源的许可与署名见 THIRD-PARTY-NOTICES.md —— 分发或修改本插件时请一并保留。