dsh-prompt-market

DeepSeek Harness 提示词市场插件

在对话框里一键浏览、搜索、收藏提示词 —— 选中即写入输入框

简体中文 | English | 日本語

目录

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

效果预览

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

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

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

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

两处值得注意的细节：

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

我的：自己写、自己改

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

收藏：随手取用

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

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

内容过滤与写入诊断

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

它解决什么问题

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

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

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

功能特性

写入行为

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

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

界面与架构

界面组成

flowchart LR
A["输入框conversation.input.left"] --> B["「提示词导入」按钮"]
B --> C["浮层面板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.chatCSV · CC0"] --> N["normalize四种适配器"]
S2["ChatGPT-ShortcutJSON · MIT"] --> N
S3["PlexPtJSON · MIT"] --> N
S4["自定义 JSON 源"] --> N
N --> FL["filter内容过滤"]
FL --> ST["storagelocalStorage 缓存 + 状态"]
ST --> API["api 门面"]
API --> UI["ui 界面层"]
UI --> W["写入通道insertText"]

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

安装

前置

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

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

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

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

方式一：一行命令（推荐，已发布到 npm）

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

dsh-prompt-market

② 或者在终端里跑：

dsh plugin --profile desktop add dsh-prompt-market

> ✅ 不需要 git，也不需要记住任何网址。
> 已发布到 npm：
>
> 🌏 网络受限时：在「添加插件」对话框里把「安装源」选成
> 中国大陆镜像源（npmmirror），就能从国内镜像装。
>
> 💡 万一 npm 装不了（离线、被墙、registry 不可达），
> 改用下方的方式二（Release 附件直链）。

方式二：Release 附件直链（不需要 git，兜底）

① 对话框里填：

https://github.com/yi-yezhiqiu/dsh-prompt-market/releases/latest/download/dsh-prompt-market.tgz

② 或者在终端里跑：

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

> ✅ 这条也不依赖 git —— 它直接下载 Release 附件（实测数秒）。
> 适合完全离线或 registry 不通的场景。
>
> 📌 网址里的 latest 由 GitHub 在请求时解析，始终指向最新版本，所以这个链接长期有效。

方式三：从 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 安装目录下的垫片：

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

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

mklink /D "\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

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

常见问题

插入的是英文，我看不懂

默认插入的其实是中文说明。若某些条目的中文说明为空，插件会回落到英文原文。

可以在「源管理 → 高级 → 写入字段」确认当前设置；也可以在「我的」里把它改写成中文后保存。

输入框里已有内容，插入会覆盖吗？

不会。 默认插入到光标处，你已写的内容保留。

想整段替换：先 Ctrl+A 全选草稿，再点「替换」。

插错了能撤回吗？

可以，Ctrl+Z。 插入走的是 DSH 官方承诺「可撤销的纯文本编辑」的那条通道。

关掉面板，我写了一半的草稿还在吗？

在。 面板是浮层，不会动你的草稿。

这个插件会联网上传我的东西吗？

不会。 它只向源列表里的地址发 GET 请求来拉取提示词数据；你的收藏、自建、草稿等内容从不离开本机。
诊断日志里只记长度和哈希，不记内容。

加了自定义源，但一条都读不出来

按顺序检查：

1. 地址返回的是JSON 数组吗？（不是对象、不是 HTML 页面）
2. 用了 raw.githubusercontent.com 吗？换成 cdn.jsdelivr.net 镜像
3. 字段名在自动识别列表里吗？不在的话在源配置里指定 listPath
4. 条目是不是被内容过滤挡掉了？（源管理里能看到过滤计数）

某一条提示词被误过滤了

去「源管理 → 内容过滤」，逐条关闭规则，或把该条的关键词从自定义屏蔽词里去掉。

换电脑后收藏还在吗？

用「导入导出」把数据导出成 JSON 带走，在新机器上导入即可。数据存在浏览器 localStorage 里，不跟随账号。

卸载后我的收藏会没吗？

不会自动删除（localStorage 独立于插件）。想清干净就在开发者工具里删掉 dsh-prompt-market: 前缀的键。

目录结构

（仓库根目录就是插件包根 —— 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 的人直接被挡在门外。
>
> 维护者本机自测通过 ≠ 别人能装上。 这条记录保留在此，提醒后来者。

🧪 官方端到端验证（dsh-plugin-dev verify）：已跑，失败归属已查清

在 DSH 0.2.0-rc.2 上跑了官方 CLI 的端到端验证
（打包 → 装进一次性 profile → 真实 headless 回合 → 卸载）：

该失败与插件无关：换成一个 apply 为空的对照插件跑同一套流程，
失败步骤、报错文字、suggestions 逐字相同。
同时定位到两个工具侧问题：--base / --headless 默认钉死在 0.1.7-rc.2（在 0.2.x 上被拒）；
冒烟的接受条件不覆盖 TRANSPORT，于是这一步实际验的是模型 API 可达性。

完整记录（含复现方式）：docs/OFFICIAL-VERIFY.md

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

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

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

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

> 这个缺陷恰好落在上面「未实测」清单里（原「三个源逐条解析的完整性」一项），
> 而且是由用户的真机截图发现的，不是由任何自检脚本发现的。
>
> 原代码注释写着「防止 8 MB 级文件把编辑器拖死；已决定避开」——
> 也就是说，设计时假定内置源都是小文件。这个假设被运行期证据推翻了。
>
> 这就是「未实测」三个字的真实含义：它不是「大概没问题」，而是「可能真的坏着」。

已知限制

路线图

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

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

参与贡献

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

特别欢迎：

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

许可

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

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

如果这个插件帮到了你，给个 ⭐ 是最好的支持