DeepSeek Harness 插件

CTX666666/dsh-prompt-polish

Star 数 ★ 1 分类 UI 增强 收录于 2026-10-27

输入框润色按钮:用当前会话正在使用的模型改写草稿,四种风格,代码层保真校验确保数字、版本、路径、URL、引号内容与代码标识符逐字保留,支持一键还原,无需自备 API Key。

安装

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:CTX666666/dsh-prompt-polish

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

提示词润色 Prompt Polish

给 DeepSeek Harness 输入框加一个 Work Buddy 同款的「润色提示词」按钮。

左键把你正在写的草稿改写成更清晰的提示词,用的就是当前对话已经在用的模型;右键切换风格。

English


它做什么

按钮位于输入框右侧的控制位——也就是模型选择器前面那一个,和 Work Buddy 的位置一致——只做一件事:

把你正在看的这份草稿,改写成更有效的提示词。

  • 用对话自己的模型。 没有额外的模型选择器,也没有隐藏的默认值。Host 先读 Session 持久化的 modelSelection 投影,再读 Client 从模型位报上来的选择,最后才回落到 profile 默认值。无论落到哪一个,都是你本来就在用的那个模型。
  • 四种风格,右键切换,跨刷新记住:平衡(默认)、精简、详细、代码。
  • 忠实度守卫,始终开启。 原文里每一个具体事实——数字、版本号、路径、URL、引号内字符串、代码标识符——都必须原样保留,且改写不得超出该风格的长度预算。守卫失败只重试一次并附上明确纠正说明;它是闸门,不是循环。
  • 对话上下文,始终开启。 从 Session 日志读取最近几轮,让改写知道「它」指的是什么。除了你配置的 llm 服务,不往任何地方发数据。
  • 一键还原。 改写成功后按钮变成还原箭头,原文始终只差一次点击。一旦你编辑了结果,这份备份就被丢弃——已经没有可还原的内容了。

行为细节

状态 你会看到
草稿为空、也没改写成功过 按钮隐藏(与 Work Buddy 一致)
草稿有内容 星芒图标;悬停显示提示语和当前风格
正在改写 转圈;再点一次取消并恢复草稿
改写成功 还原箭头;点击恢复原文
改写失败 草稿原样不动;原因显示在提示语里
adjudicating / submitting 阶段 按钮禁用

风格菜单也支持 Shift+F10 或菜单键打开,点击外部、Esc、窗口失焦时关闭。

安装

直接从 GitHub 安装,一条命令,不用克隆:

dsh plugin add github:CTX666666/dsh-prompt-polish

或者克隆整个仓库(包含所有子目录),再安装这个本地目录:

git clone https://github.com/CTX666666/dsh-prompt-polish.git
dsh plugin --profile <你的profile> add /path/to/dsh-prompt-polish

Windows 路径含空格时使用双引号包裹。也可下载 GitHub 的完整 ZIP 并解压;不要只下载根目录文件。

两种方式都一样:bundle 自带 dsh.bundle.patch,安装时一步插入 Host 行与 Client bundle,无需额外注册。

装好后下次输入框渲染时按钮就会出现。不需要重新构建,也不需要额外依赖——原因见下。

环境要求

  • DeepSeek Harness,且输入框暴露 conversation.input.right 插槽与 llm、webServer 服务。
  • Client bundle 注入了 @deepseek-ai/dsh-client-ui-conversation 与 @deepseek-ai/dsh-client-locale,因此需要这两个包在场(标准 Web/Desktop profile 自带)。

为什么没有构建步骤

两半都以纯 JavaScript 直接发布,这是刻意的:

  • Host 半边 是 src/index.js,一个导出 inject 与 apply 的 ES 模块。它不从 Harness 包导入任何东西——workspace 安装的 bundle 会按 workspace 而不是运行中的安装来解析裸导入,所以它需要的那套很小的请求词汇,是照着 llm 服务文档里的纯对象形状自己拼的。
  • Client 半边 是 src/client.js,一个经典脚本,用 window.__ModuleLoader__.load({ id, factory }) 自行注册,并通过 loader 的模块表解析 react。

没有打包器,没有转译器,安装前没有任何要跑的命令。src/ 里读到的就是你实际加载的。

依赖

运行时依赖为零。Client 半边需要 react,由 Harness loader 提供;Host 半边什么都不需要。

目录结构

dsh-prompt-polish/
├── src/
│   ├── index.js            # Host 半边:HTTP 路由 + 润色流水线
│   └── client.js           # Client 半边:输入框里的按钮
├── docs/
│   └── IMPLEMENTATION.md   # 复刻说明书:契约、提示词原文、边界
├── locale/
│   ├── en.json             # 插件卡元数据(锚点语言)
│   └── zh.json             # 中文元数据
├── assets/
│   └── icon.svg            # 插件图标
├── scripts/
│   └── check.mjs           # 零依赖自检脚本
├── .github/
│   ├── workflows/ci.yml
│   └── ISSUE_TEMPLATE/
├── cordis.patch.yml        # bundle 补丁:一行 Host
├── package.json
├── README.md               # 英文说明
├── README.zh.md            # 本文件
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE
├── .gitattributes
└── .gitignore

复刻说明书

docs/IMPLEMENTATION.md 是「照着再实现一遍」的文档:行为契约、 逐字的 system 与 user 提示词、四档风格指令、上下文块格式、保真闸正则、模型兜底链、 十五条边界、十四项自测。写给另一个工程师——或另一个模型——让它不必先读 src/ 就能在别的宿主上复现。

只要提示词原文、不打算做完整插件的话,直接跳到该文档 §11。

自检

npm run check

解析 JavaScript 与 JSON、核对清单指向的文件,再运行 27 项 HTTP 和组件状态回归测试。不需要 npm install。单独运行 node scripts/check.mjs 只检查语法与文件清单;这些测试使用受控模型输出,不代表真实 Harness 安装及模型服务已经完成端到端验收。

它如何调用模型

  1. POST /dsh-prompt-polish/polish,请求体 { text, style, sessionId?, provider?, model?, reasoningEffort? }。
  2. Host 选定路由(见上文「它做什么」),拼出系统提示、用户提示、风格指令与最近上下文块。
  3. 一次 ctx.llm.stream() 调用,temperature: 1。只累加 text-delta 分片;finish 为 kind: 'error' | 'aborted' 时按失败上报。
  4. 结果先清洗(剥掉一层围栏代码块或包裹引号),再过忠实度守卫。失败时附带明确纠正说明重试一次,说明里点名缺失的 token 和长度上限。
  5. 返回 { ok: true, text, provider, model, style, fidelity, contextUsed },或 { ok: false, code, error },code 取值 empty_input、no_model、llm_error、aborted、empty_result、fidelity_failed、invalid_request、not_found、method_not_allowed、internal。一次修正后保真仍失败时不返回替换文本,保留原草稿。

润色期间编辑草稿、切换会话或进入提交阶段会使旧请求失效。取消请求会通知 Host 中止上游生成;首次调用与修正重试共用 60 秒时限。

只读 text-delta 与 finish,所以流式返回推理块的上游不会带来额外开销。

隐私

  • 草稿、最近上下文块和改写结果都会发往你自己配置的 llm 上游——那就是模型调用本身。
  • 除此之外不发往任何地方。没有埋点,没有统计,没有本插件自己的远程端点。
  • 唯一持久化的是所选风格,存在浏览器 localStorage 的 dsh-prompt-polish.style 下。
  • 本插件不保存、不读取、不转发任何凭据。

兼容性

Client 半边面向 @deepseek-ai/dsh-client-ui-conversation 声明的插槽契约。若未来 Harness 挪动该插槽,按钮会不再出现,而不会弄坏输入框——注册包在 ctx.effect 里,卸载时干净释放。

贡献

见 CONTRIBUTING.md。一句话:npm run check 必须通过,行为变更需要在 CHANGELOG.md 里补一句说明。

仓库地址

git clone https://github.com/CTX666666/dsh-prompt-polish.git

清单里的 repository、homepage、bugs、author 已指向该仓库。安装者只需克隆和安装,无需初始化仓库或推送文件。

package.json 故意保留 "private": true:本插件的分发形式是一个由 DSH profile 安装的目录 (或 git URL),不是 npm 上的包。该标记只是防止误 npm publish,不影响 clone、fork 与安装。

许可

MIT

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。