提示词增强 ecircle6/dsh-prompt-enhance-local

dsh-prompt-enhance-local

license
dsh-plugin

本仓库是 zzy6-a/dsh-prompt-enhance（MIT）的本地加固 fork，经逐行审计后做了安全修复与功能裁剪，只保留一件事：

Composer 里的一键提示词增强——写完一句话，点一下 ✨，口语草稿被改写成目标明确、结构化的专业提示词，可一键撤销。

与上游的差异（v0.2.0 起）

安全修复（3 项）

| # | 上游问题 | 本 fork 的处理 |
| 1 | Origin 校验用 startsWith('localhost')，http://localhost.evil.com 这类恶意站点可绕过同源栅栏，盗用模型额度 | 改为 URL.hostname 精确匹配回环集合 {127.0.0.1, localhost, ::1, [::1]} 或与 Host 头完全相等；附回归单测 |
| 2 | 无 Origin 头的请求（裸 curl、本机任意进程）直接放行 | 强制要求 Origin 头；同时校验浏览器的 sec-fetch-site（如发送必须为 same-origin） |
| 3 | 往 ~/.dsh/super-injector/*.log 落盘诊断日志 | 彻底删除文件写入，改用宿主 ctx.logger——对文件系统零写入 |

另新增内存限流（10 次/分钟，固定窗口，无依赖、不落盘），把“本机进程伪造头刷额度”的残余风险压到有界速率。诚实说明：回环 HTTP 没有真正的认证手段（DSH GUI 本身也无认证），本插件防到“顺手滥用”级别。

功能裁剪（只留核心）

- ❌ 删除“按最近对话生成”（空草稿策略）→ 连带彻底不读取 sessions，硬依赖降到 3 个（webServer/llm/settings）；空草稿一律置灰/拒绝
- ❌ 删除自定义 system 模板设置
- ❌ 删除落盘日志
- ✅ 保留：✨ 一键增强、↩ 撤销、五种改写风格、模型跟随/固定、总开关、芯片置灰保护

功能

| ✨ 一键增强 | 读取当前草稿 → 按风格改写（默认结构化：目标 / 范围 / 产出 / 约束 / 验收）→ 整稿替换 |
| ↩ 一键撤销 | 草稿没被手动改动前，撤销按钮一直在，点一下恢复原文 |
| 🎛 五种改写风格 | 结构化（默认）· 补全细节 · 更简洁 · 更详细 · 加约束 |
| 🧭 模型可跟随可固定 | 默认跟随当前会话的模型；也可固定一个便宜的模型专跑改写 |
| 🧩 芯片保护 | 草稿含 @文件引用、/命令、skill 芯片时按钮置灰（整稿替换会切断这些引用） |

使用

1. 在输入框写下你的想法（一句口语也可以），比如 把日志页的时间筛选换成下拉；
2. 点模型选择器左边的 ✨；
3. 按钮变成 ···，完成后草稿被替换为改写后的提示词；
4. 不满意就点旁边的 ↩ 撤销，恢复原文。

设置

设置 → 左侧 提示词增强：

| 设置项 | 选项 | 默认 |
| 启用提示词增强按钮 | 开 / 关 | 开 |
| 改写风格 | 结构化 / 补全细节、明确目标 / 更简洁 / 更详细 / 加约束 | 结构化 |
| 模型 | 跟随当前会话 / 固定 provider + model | 跟随当前会话 |

配置存在宿主设置命名空间 prompt-enhance-local，改完立即生效（无需重启）。

工作原理

composer 草稿 ──POST /api/dsh-prompt-enhance-local/enhance──▶ host 半区（Origin + sec-fetch-site 栅栏 + 限流 + 64KB/12000字/90s 三重上限） │
system = 风格内置模板（本地常量）
│
ctx.llm.stream（一次性调用，不写会话日志） │ 改写后的提示词 ◀──────── JSON ──────┘ │
inputActions.setDraft(text) ← 整稿替换（可撤销）

- 一次性模型调用：hand-built 请求，不进会话日志、不进 agent 上下文；
- 模型路由优先级：设置里固定 → 会话最近一次主模型调用 → 宿主默认模型；
- 服务端只做三件事：取风格模板、调用模型、剥掉多余代码围栏；不落盘、不读会话、不发往任何第三方 endpoint。

抗 harness 更新（设计 + 自检）

插件按“DSH 会一直进化”设计：

1. 最小 API 面：只依赖 3 个官方 seam（webServer.register / llm.stream / settings.register），本地自带结构声明，构建只依赖 schemastery 一个包——上游类型怎么变都不影响编译安装；
2. 官方扩展点：按钮挂官方槽位 conversation.input.right，写回用官方 inputActions.setDraft；槽位 kit 缺失时只警告不崩溃（最坏结果是按钮不出现，插件不拖累 profile）；
3. 降级链：模型路由 固定设置 → 会话最近路由 → 宿主默认，任何一环缺失都有明确错误码；
4. 升级后自检（每次升级 DSH 后跑一次，.tgz

构建 bash
npm run build # host：scripts/build.sh（tsc）；client：tsdown

Windows 下没有 bash 时，等价的两条命令（本仓库实测）： powershell
node node_modules/typescript/bin/tsc -p tsconfig.json # host → lib/index.js
node node_modules/tsdown/dist/run.mjs # client → lib/client.js

host 半区改完要重启 dsh web（宿主按模块导入，不热更）；client 半区改完只需刷新页面：宿主每 500ms stat 一次 lib/client.js，重新哈希后自动换掉 boot graph 里的 entry 版本（见 @deepseek-ai/dsh-client-hmr）。

排障：整个 Web GUI 停在“Failed to load plugins”

浏览器里 HARNESS / Failed to load plugins / dsh-prompt-enhance-local / web boot: 1 entry did not activate / dsh-prompt-enhance-local: import failed——是 client bundle 的注册 id 与包名不一致，与 host 半区无关。

宿主为每个 dsh.client 包生成一行 boot entry，entry id == 包名；浏览器 Loader 用这个 id 调 loader.internal.import()，而 bundle 只有在
window.__ModuleLoader__.load({ id }) 注册过同名 factory 时才解析得出来。注册成
别的名字（例如 dsh-prompt-enhance）→ 找不到 factory → 该 entry 直接 FAILED → boot 审计拒绝启动 → 整个 UI 只剩 boot 页。

已在 tsdown.config.ts 里把 id 从 package.json#name 派生（不再手写第二个名字）， test/client-bundle.test.mjs 是第一道回归闸门。自检： bash
node --test test/client-bundle.test.mjs # 断言注册 id == 包名 + externals 全在基座里
node scripts/probe-boot-graph.mjs # 只读线上探针：核对宿主实际发出去的 row / rev / 注册 id
head -3 lib/client.js # 期望 id: "dsh-prompt-enhance-local"

scripts/probe-boot-graph.mjs 直接读宿主 SSE 通道 /plugins/events（DSH_BASE=http://127.0.0.1:3081 可换地址），逐项检查 boot graph 里有没有这一行、row 的构建代、combo 脚本里的注册 id、以及启动批次脚本是否 200——全是无副作用 GET，不会触发模型调用。要用宿主令牌才能拿到的 index 页面它不碰。

host 半区是否活着，用 node scripts/verify.mjs（405/403/400/413 四道护栏）判断；它通过而 UI 仍然失败，问题一定在 client bundle。

安全边界（一句话版）

唯一网络行为 = 把你的草稿发给你自己配置的模型路由；同源栅栏拒绝一切外来请求；限流封顶；不落盘、不读会话、无第三方 endpoint、无 eval、无动态加载。

License

MIT © 2026 ecircle6（本 fork）；上游 dsh-prompt-enhance © 2026 zzy6-a，MIT 许可，版权声明保留在 LICENSE。