@y1x1n/dsh-prompt-optimizer 0.3.15 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/README.en.md +245 -212
- package/README.md +63 -28
- package/README.simple.md +136 -136
- package/cordis.patch.yml +5 -5
- package/lib/client.js +732 -519
- package/lib/controller.js +109 -35
- package/lib/index.js +262 -63
- package/lib/prompt.js +147 -43
- package/package.json +71 -74
package/README.md
CHANGED
|
@@ -18,7 +18,8 @@ DeepSeek Harness 插件:在会话输入框(发送栏)旁提供一个「优化」
|
|
|
18
18
|
|
|
19
19
|
- [功能](#功能)
|
|
20
20
|
- [安装](#安装)
|
|
21
|
-
- [从
|
|
21
|
+
- [从 npm 安装(推荐,最简)](#从-npm-安装推荐最简)
|
|
22
|
+
- [从 Release 安装(tarball,免构建)](#从-release-安装tarball免构建)
|
|
22
23
|
- [本地源码安装(tarball)](#本地源码安装tarball)
|
|
23
24
|
- [从 GitHub 安装](#从-github-安装)
|
|
24
25
|
- [卸载](#卸载)
|
|
@@ -38,15 +39,16 @@ DeepSeek Harness 插件:在会话输入框(发送栏)旁提供一个「优化」
|
|
|
38
39
|
| | |
|
|
39
40
|
|---|---|
|
|
40
41
|
|  |  |
|
|
41
|
-
|  |  |
|
|
42
43
|
|
|
43
44
|
## 功能
|
|
44
45
|
|
|
45
46
|
- 发送栏工具行右侧新增「优化」按钮(输入为空时禁用,优化中带呼吸动画);等待期间面板实时显示当前阶段(等待模型响应 / 分析诊断 / 输出优化稿)与已用秒数,完成后模型徽章处展示总用时。
|
|
46
47
|
- 点击后实时读取当前会话的 provider/model 发起辅助调用;**分析与优化结果逐段流式显示**在输入卡上方的面板里,不用干等整段生成。
|
|
47
48
|
- **双策略优化**:无上下文(空会话/关闭携带)时按**结构模板**规范化改写(角色/任务/约束/输出格式);有上下文时自动切换为**提炼目的 + 顺势润色**——先通读会话近期对话提炼真实意图,保留草稿原始表达框架打磨,不套模板,不重复追问上下文已给出的信息,且**已否决方向不再重提**(禁入集合)。
|
|
48
|
-
- **保真纪律**(借鉴 Fishsb/dsh-prompt-enhancer):语义等价底线、来源可回溯(推断处以「如无特别说明/默认」标注)、输出前逐要素**保真自检**防漂移且**保真自检优先于长度纪律**(简单任务目标
|
|
49
|
+
- **保真纪律**(借鉴 Fishsb/dsh-prompt-enhancer):语义等价底线、来源可回溯(推断处以「如无特别说明/默认」标注)、输出前逐要素**保真自检**防漂移且**保真自检优先于长度纪律**(简单任务目标 500 字符内;优化稿就是提示词本身——不复述原稿、不加多余解释;要素缺失比冗长更严重),并带 few-shot 示例稳定输出风格。
|
|
49
50
|
- **轻量记忆链**:在我们产出的优化稿上继续修改后再点优化,自动携带上一轮结果作为延续参考(沿用已确认决策,只围绕变化点调整);同文重试、跨会话、上轮格式退化的结果都不带(格式退化仅在完整模式判定,快速模式恒视为合规),发送或关闭面板后自然归零;跟随「携带上下文」开关,关闭后不携带。
|
|
51
|
+
- **优化稿先行(0.5.0)**:完整模式的输出顺序改为**先优化稿、后诊断分析**——最关心的交付物先流式到达,等待期即可复制取走,分析随后补上;配合默认快速模式(仅优化稿),长文本从点击到可用的等待显著缩短。
|
|
50
52
|
- **斜杠命令安全**:「/goal 帮我……」这类输入只优化正文,替换时自动拼回命令前缀,不会把命令词改坏;只敲命令没有正文时直接提示、不发无意义请求。
|
|
51
53
|
- **上下文感知**:默认携带当前会话的近期对话作为参考(**用户消息优先保底**——agentic 会话里 assistant 步骤碎片远多于用户输入,纯按时间取样会把你的真实诉求挤出去),总量 ≤8 条 / 1600 字符;上下文仅供模型理解意图,提示词中明确禁止其回答或延续上下文;空会话自动退化为模板策略。可在设置卡关闭。
|
|
52
54
|
- 结果面板:**分析诊断**(五维度:目标清晰度/上下文/约束/结构/输出规格)+ **优化后的完整提示词**;操作:**替换输入框**(可**撤回**,在替换内容上继续编辑时撤回入口自动失效)/ 复制 / 重新优化 / 关闭。**发送消息后或清空输入框时面板自动关闭。**
|
|
@@ -56,23 +58,28 @@ DeepSeek Harness 插件:在会话输入框(发送栏)旁提供一个「优化」
|
|
|
56
58
|
- 面板样式全部走 Harness 官方设计令牌(`--dsw-alias-*`),明暗主题自动跟随。
|
|
57
59
|
- 长草稿友好:输出上限默认跟随输入长度自动抬升(按本地 token 估算,完整模式 ×2 / 快速模式 ×1.5,32768 封顶);真截断时也会展示已生成部分并明确提示,不会整段消失。
|
|
58
60
|
- 格式容错:模型输出的标记变体(如 `<<< ANALYSIS >>>`)能正确解析;完整模式不遵守格式时降级展示并给出警示;快速模式只有单段落,无论模型是否输出标记都视为合规(不弹警示、记忆链照常携带)——对不输出标记的第三方/免费模型友好,且其原始流可直接实时逐字预览(标记出现前)。
|
|
59
|
-
- 设置 → 插件配置 →
|
|
61
|
+
- 设置 → 插件配置 → 「提示词优化」页(平铺行布局,分「模型 / 调用参数 / 上下文」三组;所有改动可一步撤销——底部「撤销上一次修改」,内存栈最近 20 次;底部右侧为 GitHub 仓库入口):
|
|
60
62
|
- **模型**:优化用模型(**跟随当前会话**(默认),或从模型目录固定一个,provider/model 下拉、目录可手动刷新)/ 回退模型(主路由零产出失败时自动 failover,面板徽章显示「· 已回退」,悬停可见失败原因)/ 模型连通性(「测试连接」,32 token / 20s 封顶探活,显示实际路由与耗时)
|
|
61
|
-
- **调用参数**:输出语言(中文 / English)
|
|
63
|
+
- **调用参数**:输出语言(中文 / English);优化模式:**快速**(默认,仅优化,输出 token 约减半)/ 完整(分析 + 优化);推理强度:降到最低档(默认,推理模型首 token 前的空转显著缩短)/ 跟随会话;最大输出 Token(默认 8192)、超时时间(默认 120s)、采样温度(默认 0.2,悬停见设计依据);输出上限自适应开关(默认开)
|
|
62
64
|
- **上下文**:携带上下文开关(默认开):关闭后仅看草稿本身,不读取会话历史
|
|
63
65
|
|
|
64
66
|
## 安装
|
|
65
67
|
|
|
66
68
|
前提:已安装 `dsh` CLI(`npx @deepseek-ai/dsh web` 可用的环境)。
|
|
67
69
|
|
|
68
|
-
### 从
|
|
70
|
+
### 从 npm 安装(推荐,最简)
|
|
69
71
|
|
|
70
72
|
```sh
|
|
71
|
-
|
|
72
|
-
dsh plugin --profile web add ./y1x1n-dsh-prompt-optimizer.tgz
|
|
73
|
+
dsh plugin --profile web add @y1x1n/dsh-prompt-optimizer
|
|
73
74
|
```
|
|
74
75
|
|
|
75
|
-
|
|
76
|
+
### 从 Release 安装(tarball,免构建)
|
|
77
|
+
|
|
78
|
+
到 [Releases 页面](https://github.com/Y1X1n/dsh-prompt-optimizer/releases/latest) 下载 `y1x1n-dsh-prompt-optimizer-<版本号>.tgz`,再安装本地文件:
|
|
79
|
+
|
|
80
|
+
```sh
|
|
81
|
+
dsh plugin --profile web add ./y1x1n-dsh-prompt-optimizer-<版本号>.tgz
|
|
82
|
+
```
|
|
76
83
|
|
|
77
84
|
### 本地源码安装(tarball)
|
|
78
85
|
|
|
@@ -103,37 +110,59 @@ dsh plugin --profile web remove @y1x1n/dsh-prompt-optimizer
|
|
|
103
110
|
|
|
104
111
|
## 兼容性
|
|
105
112
|
|
|
106
|
-
>
|
|
107
|
-
>
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
113
|
+
> **当前版本(v0.5.0)适配 DeepSeek Harness**:
|
|
114
|
+
>
|
|
115
|
+
> | dsh 版本 | 优化路由 / 模型调用 | 设置页(含 GitHub 入口) | 发送栏按钮 / 结果面板 |
|
|
116
|
+
> |---|---|---|---|
|
|
117
|
+
> | **0.2.0-rc.2(Web + 官方桌面端)** | ✅ 实测 | ✅ 实测(volatile 配置 + 原生风格设置卡) | ✅ 实测 |
|
|
118
|
+
> | **0.1.5-rc.2** | ✅ 实测 | ✅ 实测 | ✅ 实测 |
|
|
119
|
+
> | **0.1.5-rc.1** | ✅ 实测 | ✅ 实测 | ✅ 实测 |
|
|
120
|
+
> | **0.1.2-rc.1 / 0.1.2-alpha.5** | ✅ 实测 | ✅ 实测 | ✅ 实测 |
|
|
121
|
+
> | **0.1.1-rc.2 及以下**(0.1.0-rc.7+) | ✅ 实测 | ✅ 实测 | ✅ 实测 |
|
|
122
|
+
>
|
|
123
|
+
> 同一份构建覆盖 0.1.0-rc.7 至 0.2.0 全线;此标注自 v0.3.15 起在每个 Release 说明中固定维护,更早 Release 的说明已回溯补注。
|
|
124
|
+
|
|
125
|
+
- **v0.4.0 适配 dsh 0.2.0-rc.2(2026-10-03,Windows,真实 profile 端到端)**:①设置迁移——0.2.0 移除 `settingsScope` 服务与 `settings.plugin.item` 槽位,设置改由宿主按插件 Config schema 自动生成表单;本插件 Config 全字段声明 `.volatile()`(volatile 字段经引用 cell 原位更新,**修改设置不重挂载插件**),客户端经 `configForms` 读写,设置卡同时注册 0.2.0 的 `settings.plugins.tab` 与 0.1.x 的 `settings.plugin.item` 双槽位,宿主各自渲染认识的那一个;②设置卡按 0.2.0 官方设计语言重做(平铺行布局、官方同款分段控件与开关、`configure({auto:false})` 关闭宿主原生表单避免重复);③消息源 `kind:'plugin'` 以结构断言跨过 0.2.0 收窄后的联合类型(运行时按 merge-extensible 容忍);④已在 **0.2.0-rc.2 Web**(按钮、SSE 面板、模型目录 RPC、设置卡读写与撤销、配置写入 profile 补丁且插件不重启)与**官方桌面端**(Electron `DeepSeek Harness 0.2.0-rc.2`,desktop profile 经应用自带 CLI 安装,发送栏按钮与设置卡 UIA 实测)通过验证。
|
|
126
|
+
- **llm 调用标注会话 id(v0.4.0 修复 opencode)**:opencode(`opencode-go`)要求请求携带 `x-opencode-session` 会话头,pi-ai 适配器仅在 `GenerateOptions.sessionId` 存在时注入——插件的一次性调用原本不带,被 API 以缺少请求头拒绝(表现为 opencode 无法测试连接/优化)。现客户端优化请求携带会话 id 由 Host 标注(费用等会话级计量随之正确归属),探活标注固定合成 id;其余适配器视其为模型不可见的传输元数据,不外发。
|
|
127
|
+
- **会话标注恒存在(v0.5.0 补强 opencode)**:v0.4.0 的标注依赖客户端携带会话 id,个别宿主形态不向槽位组件投递 `sessionId` 时请求体会缺失、opencode 依旧报「缺少请求头」。0.5.0 起 Host 侧兜底:客户端未携带(或为空白)时标注合成 id `prompt-optimizer-one-shot`,任何调用路径都满足会话头要求;客户端正常携带时仍用真实会话 id(计量归属不变)。注意旧 profile 里装的插件(0.3.x 及更早)不含修复,升级到 0.5.0+ 并重启宿主/刷新页面。
|
|
128
|
+
- **官方桌面端安装**:桌面应用首次启动初始化 `desktop` profile 后,完全退出应用,用应用自带 CLI 安装并重启:`"E:\Deepseek-Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add @y1x1n/dsh-prompt-optimizer`(macOS/Linux 路径见应用安装目录);不要用 npm 版 CLI 管理桌面保留 profile。
|
|
129
|
+
|
|
130
|
+
- 开发基线:`@deepseek-ai/*` **0.2.0-rc.2**(v0.4.0 起,`sync:types` 与 devDeps 钉同一版本);此前基线为 **0.1.5-rc.1**(v0.3.17 起)。已实测通过 **0.1.0-rc.8**(2026-08-20,Windows,真实 profile 安装 + Web 路由/客户端 bundle/会话历史 RPC/端到端 LLM 调用)、复测通过 **0.1.1-rc.2**(2026-08-27)、适配并通过 **0.1.2-rc.1 与 0.1.2-alpha.5**(2026-09-05/06)、**0.1.5-rc.1**(2026-09-10,真实 profile 端到端冒烟:组合层注入、路由 SSE、client bundle、发送栏按钮与结果面板、设置卡片)与 **0.1.5-rc.2**(2026-09-11,全链路复测:组合层注入、Host 加载、路由契约 405/400/200、SSE 端到端 155 帧 delta、四种策略路径、client bundle 槽位与设置卡 API 全部通过,69 项测试全绿)。
|
|
131
|
+
- 已在 **macOS** 端通过自动化实测(2026-09-02,macOS 26.5(Darwin 25.5.0),Node.js v26.0.0,`npm install --legacy-peer-deps` 后 `sync:types` / `typecheck` / `build` / `npm test` 全部通过,62 项测试全绿);CI 现同时在 ubuntu-latest 与 macos-latest 上跑 typecheck + 全量测试(@ruijiaang-lab,#3)。
|
|
132
|
+
- **dsh-settings API 兼容层**:0.1.2 线重写了设置 API(独立函数 `installSettingsSection` 移除,改为 `ctx.settings` 服务的 `installSection` 方法)。0.3.16+ 运行时按能力探测自动分派:新 API 存在则走新接口,否则内联等价实现(register+watch+卸载回落),settings 服务整体缺席时回落组合层配置。
|
|
133
|
+
- **客户端类型面随 0.1.2/0.1.5 迁移**(v0.3.17 适配):`dsh-client-runtime` 包已从上游移除,`ClientContext` 即 cordis 的 `Context`;`SettingsScope` 迁至 `@deepseek-ai/dsh-client-ui-settings/client`(其 `SettingsScopeBinder` 自带 `ctx.settingsScope` 的 Context 合并,插件不再重复声明,否则合并冲突);`ctx.slots` 的合并由 `@deepseek-ai/dsh-client-ui-renderer/client` 提供。`HistoryEntry` / `ModelProviderGroup` 迁入未发布的 `dsh-api-session-controller`,插件改在 `src/client/host-faces.ts` 自带最小结构面,不再追上游类型。
|
|
134
|
+
- **会话模型与目录(v0.3.17 起真实可用)**:模型目录走连接层通用 RPC `session/modelCatalog`(`/api` 通道,载荷信封要求恰好一个纯对象 `args` 字段,零参方法即 `{ args: {} }`);「跟随会话」读取官方会话模型目录服务 `ctx.modelDirectories`(`dsh-client-ui-model-selection` 提供,与 /model 弹窗共用同一份目录,其 `current` 即会话实际将使用的模型)。该服务经**独立的可选 inject** 捕获——不能并进主 inject,否则无此服务的宿主会让客户端永远等不到就绪;缺席时回落 Host 回退解析。
|
|
135
|
+
- **会话历史(上下文)仍是缺口**:`connection.api.sessions.history` 这一旧查询面在发布版(0.1.0-rc.7 → 0.1.5)从未声明、浏览器运行时也不提供,插件按可选结构面调用,缺席时按无上下文优化并告警;真实路径需要 `session/follow`/`session/page` 流(还要先从 follow 首帧取 `throughSeq`),待接入。
|
|
136
|
+
- **客户端槽位 props 双形态**:0.1.2 起 composer 槽位改为 session scope,组件经 standard hooks(`useInput`/`useSession`)读取会话与草稿状态,注册需采用「注入回调内 scope 化注册 + `inject(sessionId)` 钩子」的官方双层形态。组件按 props 形态自动分派(0.1.2 走 hooks,旧版读直传快照),两种宿主共用同一份构建。
|
|
137
|
+
- **client bundle 注册 id**:`lib/client.js` 的 loader id 必须等于插件 npm 包名(宿主 client-modules 按包名校验注册);client 注入列表已随 0.1.2 移除已合并的 `dsh-client-runtime`。0.1.5 起 bundle 以 `/plugins/??<id>/client.js,…&rev=<hash>` 组合 URL 提供,单插件裸路径不再单独暴露(以 boot manifest 里的组合 URL 为准)。
|
|
111
138
|
- HTTP 载体服务名在发布版间漂移过(npm 0.0.1-rc.x 类型包叫 `httpServer`,0.1.0-rc.x 运行时叫 `webServer`):本插件用 `ctx.inject` 同时等待两个名字,且不做静态硬依赖——即使服务名再次变化,也只会使本插件的路由不注册(10 秒后日志告警),不会拖垮整个 Harness 启动。
|
|
112
|
-
- **客户端协议口径**:`/dsh-prompt-optimizer/optimize` 预校验失败返回 400/405/409/413(普通 JSON),成功后进入 SSE 流,模型错误经 `error` 事件传达;`/dsh-prompt-optimizer/test-model` **无论成败一律 HTTP 200**,由 body 的 `ok` 字段区分(探活是应用层语义,刻意不走传输层状态码)——对接方请以 `ok`
|
|
139
|
+
- **客户端协议口径**:`/dsh-prompt-optimizer/optimize` 预校验失败返回 400/405/409/413(普通 JSON)、并发超限返回 429,成功后进入 SSE 流,模型错误经 `error` 事件传达;`/dsh-prompt-optimizer/test-model` **无论成败一律 HTTP 200**,由 body 的 `ok` 字段区分(探活是应用层语义,刻意不走传输层状态码)——对接方请以 `ok` 为准。请求体必须是 JSON **对象**:`null`/标量/数组一律 400。
|
|
113
140
|
- 客户端与 Host 需同版本(SSE 协议是私有约定):升级插件后请重启 `dsh web` 并刷新浏览器页面。
|
|
114
141
|
|
|
115
142
|
## 常见问题
|
|
116
143
|
|
|
117
144
|
- **点了「优化」没有反应?** 打开浏览器 Console 查看 `[dsh-prompt-optimizer]` 开头的日志;常见原因是未配置任何模型(先在 设置 → 模型 里配好提供方),或面板所需的上游槽位尚未就绪(刷新页面)。
|
|
118
145
|
- **提示「未找到可用模型」?** 会话没有选择可路由的模型,且设置卡里也没有固定模型;两者补其一即可。也可以展开设置卡点「测试连接」确认路由可用。
|
|
146
|
+
- **设置卡显示「模型目录加载失败」?** v0.3.17 起目录改走宿主 `session/modelCatalog` RPC,正常应能列出全部提供方与模型;仍失败时提示会附上具体原因(点「刷新」重试)。注意「跟随会话」依赖宿主的会话模型目录服务(`ctx.modelDirectories`),个别宿主形态缺席时优化调用会回落到 Host 的第一个可用路由(Console 有对应告警)。
|
|
119
147
|
- **结果被截断?** 面板会出现截断提示;默认开启的「输出上限自适应」会按草稿长度自动抬升上限,仍不够再到设置卡调高「最大输出 Token」。
|
|
120
148
|
- **换了会话模型没生效?** 每次点击都会实时查询会话当前模型;若仍不对,看 Console 是否有 `会话模型查询失败` 的警告(此时会用第一个可用路由兜底)。注意:设置卡里固定了模型时会话选择不生效。
|
|
121
149
|
- **优化调用偶发超时 / RATE_LIMIT 失败?** 这类瞬态错误的重试由宿主在**提供方层**统一处理(dsh 0.1.1+ 的提供方配置内置重试策略,默认覆盖 `RATE_LIMIT / SERVER / TIMEOUT / TRANSPORT / EMPTY_RESPONSE`)。到 设置 → 模型 → 对应提供方 里调整重试次数与退避,而不是调本插件的「超时时间」——后者只管单次调用的总时长。
|
|
150
|
+
- **opencode(opencode-go)模型仍提示「缺少请求头」?** 需要 v0.5.0+ 且宿主为 0.2.x 线(pi-ai 适配器才会按 `GenerateOptions.sessionId` 注入 `x-opencode-session` 会话头)。确认 profile 里装的插件版本 ≥0.5.0(`dsh plugin --profile <profile> list`),升级后重启宿主/刷新页面;个别宿主不向槽位投递会话 id 时,0.5.0 起 Host 会兜底标注合成 id,不再依赖客户端携带。
|
|
122
151
|
- **设置页找不到卡片?** 0.3.0 的严格枚举 schema 与旧版设置文档冲突会导致卡片不渲染,0.3.1 起已修复(未知枚举值自动回落默认);确认版本 ≥0.3.1 并刷新页面。
|
|
123
152
|
- **卸载后按钮还在?** 插件集合变更需重启 `dsh web` 才生效;刷新页面不够。
|
|
124
153
|
|
|
125
154
|
## 验证状态
|
|
126
155
|
|
|
127
|
-
已在真实环境验证(dsh 0.1.0-rc.8 实测 + 0.1.1-rc.2 复测,Windows,详见「兼容性」);v0.3.9–0.3.11 另在**第三方免费模型**(openrouter 的 `minimax/minimax-m3:free`,不输出标记格式)上完成端到端实测:模板/意图双策略、保真逐要素保留、待补充标记、记忆链与取消保留等行为均按设计工作,并据此修复了快速模式的格式误报。
|
|
156
|
+
已在真实环境验证(dsh 0.1.0-rc.8 实测 + 0.1.1-rc.2 复测,Windows,详见「兼容性」);macOS 端自动化实测通过(2026-09-02,macOS 26.5,62 项测试全绿,CI 亦常驻 macos-latest 跑全量测试);**v0.3.16 起 0.1.2 线(dsh 0.1.2-rc.1 / 0.1.2-alpha.5)完成端到端实测**(发送栏按钮、结果面板、设置卡片、优化路由与 SSE);**v0.3.17 起 0.1.5-rc.1 完成端到端实测**(2026-09-10,Windows,真实 profile + 浏览器驱动:发送栏「优化」按钮随输入启停、点击后面板打开并按 SSE 透传上游错误、设置卡片折叠摘要与展开配置齐全),**并在 0.1.5-rc.2 上完成全链路复测**(2026-09-11:组合层注入、Host 加载、路由契约、SSE 端到端、四种策略路径、client bundle 槽位与设置卡 API 全项通过);v0.3.9–0.3.11 另在**第三方免费模型**(openrouter 的 `minimax/minimax-m3:free`,不输出标记格式)上完成端到端实测:模板/意图双策略、保真逐要素保留、待补充标记、记忆链与取消保留等行为均按设计工作,并据此修复了快速模式的格式误报。
|
|
128
157
|
|
|
129
|
-
- 组合层加载:`--dump-config` 出现 `# == dsh-prompt-optimizer` 层;
|
|
158
|
+
- 组合层加载:`--dump-config` 出现 `# == @y1x1n/dsh-prompt-optimizer` 层;
|
|
130
159
|
- Host:启动日志 `[dsh-prompt-optimizer] loaded`,优化路由与测试路由的 400/405/409/413 各路径行为正确,SSE 流式输出实测正常;
|
|
131
|
-
- Client:bundle 被 client-modules
|
|
160
|
+
- Client:bundle 被 client-modules 扫描收录并出现在页面 boot manifest(0.1.5 起以 `/plugins/??<ids>&rev=<hash>` 组合 URL 提供),插件行出现在模块清单中;
|
|
132
161
|
- 端到端:真实调用 `ctx.llm`(DeepSeek 路由)完成「分析 + 优化」,标记解析正确(`wellFormed: true`)。
|
|
133
|
-
- 自动化测试(`npm test`,共
|
|
134
|
-
- `test/smoke.mjs`:
|
|
135
|
-
- `test/prompt.test.mjs`:
|
|
136
|
-
- `test/controller.test.mjs`:
|
|
162
|
+
- 自动化测试(`npm test`,共 85 例):
|
|
163
|
+
- `test/smoke.mjs`:35 项 Host 冒烟用例(真实 cordis Context + mock 服务,覆盖路由解析优先级、空字符串/畸形配置、400/405/409/413、非对象 JSON 体拒绝、SSE 事件流、SSE 阶段错误不逃出路由、并发上限 429、载体服务只挂载一次、max-tokens 截断、超时、快速模式与默认模式、推理钳档(按强度序数而非展示顺序)、旧版设置文档归一化、连接测试、会话标注兜底、回退链与回退原因透传、tool-calls 防御、输出上限自适应、上下文注入与硬开关、策略选择、记忆链注入与截断、来源围栏);
|
|
164
|
+
- `test/prompt.test.mjs`:24 项元提示词解析用例(标记空白变体、降级路径、空 OPTIMIZED 段不回退、标记字样不进入结果、未闭合思考块不污染解析、流式实况解析、新旧两种输出顺序、流式缓冲压缩(单段/两段式)、token 估算 CJK 覆盖、上下文载荷与预算收敛、策略分叉、保真纪律与示例、记忆链载荷);
|
|
165
|
+
- `test/controller.test.mjs`:26 项客户端纯逻辑用例(SSE 帧解析与损坏帧跳过、合帧节流、连接中断、跳过会话查询、撤回流转、retry 保留斜杠前缀、close 中止、cancel 取消保留已生成部分及其状态门槛、客户端超时看门狗、历史提取过滤与失败降级、斜杠前缀拆分与空命令拦截、记忆链传递与门槛、发送即关闭判定、耗时记录、上下文取样用户消息保底、新输出顺序的流式预览与压缩兜底)。
|
|
137
166
|
|
|
138
167
|
## 工作原理
|
|
139
168
|
|
|
@@ -142,14 +171,16 @@ dsh plugin --profile web remove @y1x1n/dsh-prompt-optimizer
|
|
|
142
171
|
→ Client 拆分斜杠命令前缀(/goal 等只优化正文),并行拉取当前会话模型选择
|
|
143
172
|
(session.models RPC,每次点击实时查询;设置里固定了模型时跳过,Host 固定值优先)
|
|
144
173
|
与会话近期对话(session.history RPC,最近 8 条/1600 字符封顶,可在设置卡关闭)
|
|
145
|
-
→ POST /dsh-prompt-optimizer/optimize { text, provider, model, reasoningEffort, context?, previous? }
|
|
146
|
-
(
|
|
174
|
+
→ POST /dsh-prompt-optimizer/optimize { text, sessionId, provider, model, reasoningEffort, context?, previous? }
|
|
175
|
+
(sessionId = 发起会话 id,Host 标注到 llm 调用;缺席时 Host 兜底合成 id。
|
|
176
|
+
previous = 轻量记忆链:在优化稿上修改后再优化时携带的上轮结果)
|
|
147
177
|
→ Host 以系统元提示词调用 ctx.llm.stream()
|
|
148
178
|
(路由解析:设置固定值 → 会话选择 → 第一个可用路由;可配回退路由,零产出失败自动 failover;
|
|
149
179
|
策略分叉:有上下文走「提炼目的+润色」,无上下文走「结构模板」;
|
|
150
180
|
输出上限默认按输入 token 估算抬升;默认推理钳最低档/低温度)
|
|
151
|
-
→ text-delta 经 SSE
|
|
152
|
-
(按 <<<
|
|
181
|
+
→ text-delta 经 SSE 逐段推送,面板实时显示「优化结果 / 分析诊断」两段
|
|
182
|
+
(按 <<<OPTIMIZED>>> / <<<ANALYSIS>>> 标记增量解析,容忍标记空白变体、与标记顺序无关;
|
|
183
|
+
0.5.0 起完整模式优化稿先流式到达)
|
|
153
184
|
→ done 事件携带最终解析结果;max-tokens 结束带 truncated 标记;回退发生时附 fallbackReason
|
|
154
185
|
→ 一键替换输入框(可撤回,自动拼回斜杠前缀)/ 复制 / 重新优化(改稿续接带上轮结果,同文全新生成);发送消息后面板自动关闭
|
|
155
186
|
→ 优化中 Esc = 取消(cancelled 态,保留已生成的部分);客户端看门狗在 Host 无响应时兜底超时
|
|
@@ -186,11 +217,13 @@ dsh-prompt-optimizer/
|
|
|
186
217
|
│ └── client/
|
|
187
218
|
│ ├── index.tsx # Client 入口:槽位注册
|
|
188
219
|
│ ├── controller.ts # 按钮/面板共享的状态机与 SSE 消费(独立产物,可单测)
|
|
220
|
+
│ ├── host-faces.ts # 宿主客户端服务的最小结构面(自带定义,跨版本稳定)
|
|
189
221
|
│ ├── i18n.ts # 界面文案 zh/en 字典,跟随 DSH 界面语言
|
|
190
222
|
│ ├── OptimizeButton.tsx # 发送栏按钮
|
|
191
223
|
│ ├── ResultDock.tsx # 输入卡上方的结果面板(流式实况 + 撤回)
|
|
192
|
-
│ ├── SettingsCard.tsx #
|
|
193
|
-
│
|
|
224
|
+
│ ├── SettingsCard.tsx # 设置页(模型/调用参数/上下文 三组行)
|
|
225
|
+
│ ├── SparkleIcon.tsx # 手绘 ✨ 图标
|
|
226
|
+
│ └── GitHubIcon.tsx # GitHub 图标(设置页底部仓库入口)
|
|
194
227
|
├── scripts/build.mjs # esbuild:Host ESM + Client lazy-CJS factory + 两个测试用产物
|
|
195
228
|
├── scripts/sync-types.mjs
|
|
196
229
|
├── scripts/prompt-probe.mjs # 提示词实证探针:对运行实例发真实优化请求(PROBE_ROUTE=provider/model 可指定路由)
|
|
@@ -201,6 +234,8 @@ dsh-prompt-optimizer/
|
|
|
201
234
|
|
|
202
235
|
- HTTP 路由注册在 dsh 自带的 Web 服务器上。默认监听 `127.0.0.1`;若把 dsh 暴露到局域网(`0.0.0.0`),本插件的优化接口同样可被局域网调用——它会消耗你配置的模型额度,请知悉。
|
|
203
236
|
- 两条路由均带**来源围栏**:带 `Origin` 头的请求(浏览器 POST 必带)必须与 `Host` 同源,且 `Host` 必须是回环地址或本机实际地址——网页侧的跨站伪造请求(CSRF)与 DNS rebinding 会被 403 拒绝;不带 `Origin` 的命令行调用不受影响。
|
|
237
|
+
- 优化路由带**并发上限**(同时最多 3 个在途调用),超出直接 `429`;每次优化都是一次真实计费的模型调用,该上限用于挡住多标签页/脚本刷调用。
|
|
238
|
+
- SSE 阶段每 15 秒发送注释帧心跳(`: ping`),避免经反向代理/隧道访问时被空闲超时掐断(注释帧不含数据,客户端解析器天然忽略)。
|
|
204
239
|
- 插件不持有任何 API Key:模型调用全部经由 Harness 已配置的 `ctx.llm` 路由。
|
|
205
240
|
|
|
206
241
|
## 贡献者
|
package/README.simple.md
CHANGED
|
@@ -1,136 +1,136 @@
|
|
|
1
|
-
# 🐣 小白版:三分钟用上「提示词优化」
|
|
2
|
-
|
|
3
|
-
[← 返回完整中文文档](README.md) | [English](README.en.md)
|
|
4
|
-
|
|
5
|
-
> 这页是写给第一次接触 dsh 插件的朋友的,全程大白话,不讲技术细节。
|
|
6
|
-
> 想看完整功能说明、兼容性、测试覆盖?请回[完整版 README](README.md)。
|
|
7
|
-
|
|
8
|
-
## 目录
|
|
9
|
-
|
|
10
|
-
- [这是个啥?](#这是个啥)
|
|
11
|
-
- [开始前,你要有这三样东西](#开始前你要有这三样东西)
|
|
12
|
-
- [三步装好](#三步装好)
|
|
13
|
-
- [怎么用](#怎么用)
|
|
14
|
-
- [常见小问题](#常见小问题)
|
|
15
|
-
- [卸载](#卸载)
|
|
16
|
-
|
|
17
|
-
---
|
|
18
|
-
|
|
19
|
-
## 这是个啥?
|
|
20
|
-
|
|
21
|
-
一句话:**帮你把发给 AI 的话写得更好。**
|
|
22
|
-
|
|
23
|
-
你在 DeepSeek 对话框里打了一句"帮我写周报",总觉得太笼统、AI 回答不给力?
|
|
24
|
-
装了这个插件,输入框旁边会多一个 ✨「优化」按钮。点一下,它自动把你的话改写成一份表达清晰、要求明确的提示词,像打字机一样一段段显示出来,满意就一键替换。
|
|
25
|
-
|
|
26
|
-
**它长这样:**
|
|
27
|
-
|
|
28
|
-
| 输入框旁的按钮 | 点完之后的效果 |
|
|
29
|
-
|---|---|
|
|
30
|
-
|  |  |
|
|
31
|
-
|
|
32
|
-
---
|
|
33
|
-
|
|
34
|
-
## 开始前,你要有这三样东西
|
|
35
|
-
|
|
36
|
-
1. **一台装了 Node.js 的电脑**(Node 18 或更新版本)
|
|
37
|
-
2. **dsh 命令行** —— 就是能在终端跑 `npx @deepseek-ai/dsh web` 的环境
|
|
38
|
-
3. **配好的模型** —— 在 dsh 网页版的 设置 → 模型 里,已经配好至少一个模型提供方(比如 DeepSeek 官方 API)
|
|
39
|
-
|
|
40
|
-
> 三样里缺哪样?先把 [dsh 本体](https://github.com/deepseek-ai)跑起来 —— 本插件是装在它上面的「小挂件」,本体没有它也无处安放。
|
|
41
|
-
|
|
42
|
-
---
|
|
43
|
-
|
|
44
|
-
## 三步装好
|
|
45
|
-
|
|
46
|
-
### 第 1 步:下载插件包
|
|
47
|
-
|
|
48
|
-
打开 [Releases 页面](https://github.com/Y1X1n/dsh-prompt-optimizer/releases/latest)
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
>
|
|
71
|
-
|
|
72
|
-
---
|
|
73
|
-
|
|
74
|
-
## 怎么用
|
|
75
|
-
|
|
76
|
-
就三下:
|
|
77
|
-
|
|
78
|
-
1. **打字**:在输入框里随便写一句话,比如"帮我写周报"
|
|
79
|
-
2. **点按钮**:点 ✨「优化」
|
|
80
|
-
3. **选结果**:等几秒,面板会出现两段内容 ——「分析诊断」和「优化结果」
|
|
81
|
-
- 觉得好 → 点 **「替换输入框」**,你的草稿就变成优化后的版本了
|
|
82
|
-
- 不满意 → 点 **「重新优化」**,再生成一版
|
|
83
|
-
- 点错了?→ 点 **「撤回」**,一键回到替换前
|
|
84
|
-
|
|
85
|
-
### 几个实用小开关(可选)
|
|
86
|
-
|
|
87
|
-
在 设置 → 插件配置
|
|
88
|
-
|
|
89
|
-
-
|
|
90
|
-
- **想固定用某个模型优化?** 「优化用模型」里选一个,不选就跟随当前会话
|
|
91
|
-
- **优化出来的结果想换英文?** 「输出语言」里切
|
|
92
|
-
|
|
93
|
-
---
|
|
94
|
-
|
|
95
|
-
## 常见小问题
|
|
96
|
-
|
|
97
|
-
<details>
|
|
98
|
-
<summary><b>点了 ✨ 没反应?</b></summary>
|
|
99
|
-
|
|
100
|
-
多半是模型没配好。去 **设置 → 模型** 配好至少一个提供方,再试。
|
|
101
|
-
还不行就按 F12 打开浏览器控制台,找 `[dsh-prompt-optimizer]` 开头的红色日志,拿去[提 issue](https://github.com/Y1X1n/dsh-prompt-optimizer/issues)。
|
|
102
|
-
</details>
|
|
103
|
-
|
|
104
|
-
<details>
|
|
105
|
-
<summary><b>装完找不到 ✨ 按钮?</b></summary>
|
|
106
|
-
|
|
107
|
-
重启 `dsh web` 了吗?插件装完**必须重启**才生效,光刷新网页不够。
|
|
108
|
-
</details>
|
|
109
|
-
|
|
110
|
-
<details>
|
|
111
|
-
<summary><b>升级插件后要做什么?</b></summary>
|
|
112
|
-
|
|
113
|
-
重启 `dsh web`,然后刷新浏览器页面(建议 Ctrl+F5 强刷)。
|
|
114
|
-
</details>
|
|
115
|
-
|
|
116
|
-
<details>
|
|
117
|
-
<summary><b>结果跑到一半断了/被截断?</b></summary>
|
|
118
|
-
|
|
119
|
-
设置卡里把「最大输出 Token」调高一点(默认 8192,最长 32768)。
|
|
120
|
-
</details>
|
|
121
|
-
|
|
122
|
-
更多问题看[完整版常见问题](README.md#常见问题)。
|
|
123
|
-
|
|
124
|
-
---
|
|
125
|
-
|
|
126
|
-
## 卸载
|
|
127
|
-
|
|
128
|
-
```sh
|
|
129
|
-
dsh plugin --profile web remove @y1x1n/dsh-prompt-optimizer
|
|
130
|
-
```
|
|
131
|
-
|
|
132
|
-
然后重启 `dsh web`。
|
|
133
|
-
|
|
134
|
-
---
|
|
135
|
-
|
|
136
|
-
觉得好用?给[仓库](https://github.com/Y1X1n/dsh-prompt-optimizer)点个 ⭐ 就是最大的支持。有问题欢迎[提 issue](https://github.com/Y1X1n/dsh-prompt-optimizer/issues)。
|
|
1
|
+
# 🐣 小白版:三分钟用上「提示词优化」
|
|
2
|
+
|
|
3
|
+
[← 返回完整中文文档](README.md) | [English](README.en.md)
|
|
4
|
+
|
|
5
|
+
> 这页是写给第一次接触 dsh 插件的朋友的,全程大白话,不讲技术细节。
|
|
6
|
+
> 想看完整功能说明、兼容性、测试覆盖?请回[完整版 README](README.md)。
|
|
7
|
+
|
|
8
|
+
## 目录
|
|
9
|
+
|
|
10
|
+
- [这是个啥?](#这是个啥)
|
|
11
|
+
- [开始前,你要有这三样东西](#开始前你要有这三样东西)
|
|
12
|
+
- [三步装好](#三步装好)
|
|
13
|
+
- [怎么用](#怎么用)
|
|
14
|
+
- [常见小问题](#常见小问题)
|
|
15
|
+
- [卸载](#卸载)
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## 这是个啥?
|
|
20
|
+
|
|
21
|
+
一句话:**帮你把发给 AI 的话写得更好。**
|
|
22
|
+
|
|
23
|
+
你在 DeepSeek 对话框里打了一句"帮我写周报",总觉得太笼统、AI 回答不给力?
|
|
24
|
+
装了这个插件,输入框旁边会多一个 ✨「优化」按钮。点一下,它自动把你的话改写成一份表达清晰、要求明确的提示词,像打字机一样一段段显示出来,满意就一键替换。
|
|
25
|
+
|
|
26
|
+
**它长这样:**
|
|
27
|
+
|
|
28
|
+
| 输入框旁的按钮 | 点完之后的效果 |
|
|
29
|
+
|---|---|
|
|
30
|
+
|  |  |
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## 开始前,你要有这三样东西
|
|
35
|
+
|
|
36
|
+
1. **一台装了 Node.js 的电脑**(Node 18 或更新版本)
|
|
37
|
+
2. **dsh 命令行** —— 就是能在终端跑 `npx @deepseek-ai/dsh web` 的环境
|
|
38
|
+
3. **配好的模型** —— 在 dsh 网页版的 设置 → 模型 里,已经配好至少一个模型提供方(比如 DeepSeek 官方 API)
|
|
39
|
+
|
|
40
|
+
> 三样里缺哪样?先把 [dsh 本体](https://github.com/deepseek-ai)跑起来 —— 本插件是装在它上面的「小挂件」,本体没有它也无处安放。
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## 三步装好
|
|
45
|
+
|
|
46
|
+
### 第 1 步:下载插件包
|
|
47
|
+
|
|
48
|
+
打开 [Releases 页面](https://github.com/Y1X1n/dsh-prompt-optimizer/releases/latest),下载文件名形如 `y1x1n-dsh-prompt-optimizer-<版本号>.tgz` 的插件包。
|
|
49
|
+
|
|
50
|
+
### 第 2 步:安装
|
|
51
|
+
|
|
52
|
+
打开终端,进到下载文件所在的目录,运行(把 `<版本号>` 换成你下载的文件实际名字):
|
|
53
|
+
|
|
54
|
+
```sh
|
|
55
|
+
dsh plugin --profile web add ./y1x1n-dsh-prompt-optimizer-<版本号>.tgz
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
### 第 3 步:重启
|
|
59
|
+
|
|
60
|
+
关掉 `dsh web` 重新启动,打开网页版界面。
|
|
61
|
+
|
|
62
|
+
**装好了!** 输入框旁边是不是多了一个 ✨ 按钮?
|
|
63
|
+
|
|
64
|
+
> 也可以直接从 npm 装:`dsh plugin --profile web add @y1x1n/dsh-prompt-optimizer`(装完同样要重启)。
|
|
65
|
+
|
|
66
|
+
> **用官方桌面端(DeepSeek Harness 桌面应用)?** 装法不一样:桌面应用先启动一次让它初始化,然后**完全退出应用**,用应用自带的 dsh 命令安装,再重新打开应用。Windows 自带命令在 `E:\Deepseek-Harness\resources\runtime\cli\bin\dsh.cmd`(macOS/Linux 在应用安装目录里找),命令形如:
|
|
67
|
+
>
|
|
68
|
+
> ```sh
|
|
69
|
+
> dsh plugin --profile desktop add ./y1x1n-dsh-prompt-optimizer-<版本号>.tgz
|
|
70
|
+
> ```
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
## 怎么用
|
|
75
|
+
|
|
76
|
+
就三下:
|
|
77
|
+
|
|
78
|
+
1. **打字**:在输入框里随便写一句话,比如"帮我写周报"
|
|
79
|
+
2. **点按钮**:点 ✨「优化」
|
|
80
|
+
3. **选结果**:等几秒,面板会出现两段内容 ——「分析诊断」和「优化结果」
|
|
81
|
+
- 觉得好 → 点 **「替换输入框」**,你的草稿就变成优化后的版本了
|
|
82
|
+
- 不满意 → 点 **「重新优化」**,再生成一版
|
|
83
|
+
- 点错了?→ 点 **「撤回」**,一键回到替换前
|
|
84
|
+
|
|
85
|
+
### 几个实用小开关(可选)
|
|
86
|
+
|
|
87
|
+
在设置的「内置插件」页 → 「提示词优化」里(旧版 dsh 在 设置 → 插件配置):
|
|
88
|
+
|
|
89
|
+
- **等待时间**:0.5.0 起默认就是**快速**模式(只要优化结果,等待约减半);想附带看「分析诊断」再切到完整模式
|
|
90
|
+
- **想固定用某个模型优化?** 「优化用模型」里选一个,不选就跟随当前会话
|
|
91
|
+
- **优化出来的结果想换英文?** 「输出语言」里切
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## 常见小问题
|
|
96
|
+
|
|
97
|
+
<details>
|
|
98
|
+
<summary><b>点了 ✨ 没反应?</b></summary>
|
|
99
|
+
|
|
100
|
+
多半是模型没配好。去 **设置 → 模型** 配好至少一个提供方,再试。
|
|
101
|
+
还不行就按 F12 打开浏览器控制台,找 `[dsh-prompt-optimizer]` 开头的红色日志,拿去[提 issue](https://github.com/Y1X1n/dsh-prompt-optimizer/issues)。
|
|
102
|
+
</details>
|
|
103
|
+
|
|
104
|
+
<details>
|
|
105
|
+
<summary><b>装完找不到 ✨ 按钮?</b></summary>
|
|
106
|
+
|
|
107
|
+
重启 `dsh web` 了吗?插件装完**必须重启**才生效,光刷新网页不够。
|
|
108
|
+
</details>
|
|
109
|
+
|
|
110
|
+
<details>
|
|
111
|
+
<summary><b>升级插件后要做什么?</b></summary>
|
|
112
|
+
|
|
113
|
+
重启 `dsh web`,然后刷新浏览器页面(建议 Ctrl+F5 强刷)。
|
|
114
|
+
</details>
|
|
115
|
+
|
|
116
|
+
<details>
|
|
117
|
+
<summary><b>结果跑到一半断了/被截断?</b></summary>
|
|
118
|
+
|
|
119
|
+
设置卡里把「最大输出 Token」调高一点(默认 8192,最长 32768)。
|
|
120
|
+
</details>
|
|
121
|
+
|
|
122
|
+
更多问题看[完整版常见问题](README.md#常见问题)。
|
|
123
|
+
|
|
124
|
+
---
|
|
125
|
+
|
|
126
|
+
## 卸载
|
|
127
|
+
|
|
128
|
+
```sh
|
|
129
|
+
dsh plugin --profile web remove @y1x1n/dsh-prompt-optimizer
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
然后重启 `dsh web`。
|
|
133
|
+
|
|
134
|
+
---
|
|
135
|
+
|
|
136
|
+
觉得好用?给[仓库](https://github.com/Y1X1n/dsh-prompt-optimizer)点个 ⭐ 就是最大的支持。有问题欢迎[提 issue](https://github.com/Y1X1n/dsh-prompt-optimizer/issues)。
|
package/cordis.patch.yml
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
# dsh-prompt-optimizer 组合层:把 Host 插件行插入当前组合。
|
|
2
|
-
# 插件行按包名引用,由 Node 模块解析在 profile 的 node_modules 中找到本包。
|
|
3
|
-
- insert:
|
|
4
|
-
- id: prompt-optimizer
|
|
5
|
-
name: '@y1x1n/dsh-prompt-optimizer'
|
|
1
|
+
# dsh-prompt-optimizer 组合层:把 Host 插件行插入当前组合。
|
|
2
|
+
# 插件行按包名引用,由 Node 模块解析在 profile 的 node_modules 中找到本包。
|
|
3
|
+
- insert:
|
|
4
|
+
- id: prompt-optimizer
|
|
5
|
+
name: '@y1x1n/dsh-prompt-optimizer'
|