dsh-prompt-enhance-local
本仓库是 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 芯片时按钮置灰（整稿替换会切断这些引用） |
使用
- 在输入框写下你的想法（一句口语也可以），比如
把日志页的时间筛选换成下拉；
- 点模型选择器左边的 ✨；
- 按钮变成
···，完成后草稿被替换为改写后的提示词；
- 不满意就点旁边的 ↩ 撤销，恢复原文。
设置
设置 → 左侧 提示词增强：
| 设置项 | 选项 | 默认 |
|---|
| 启用提示词增强按钮 | 开 / 关 | 开 |
| 改写风格 | 结构化 / 补全细节、明确目标 / 更简洁 / 更详细 / 加约束 | 结构化 |
| 模型 | 跟随当前会话 / 固定 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 会一直进化"设计：
- 最小 API 面：只依赖 3 个官方 seam（
webServer.register / llm.stream / settings.register），本地自带结构声明，构建只依赖 schemastery 一个包——上游类型怎么变都不影响编译安装；
- 官方扩展点：按钮挂官方槽位
conversation.input.right，写回用官方 inputActions.setDraft；槽位 kit 缺失时只警告不崩溃（最坏结果是按钮不出现，插件不拖累 profile）；
- 降级链：模型路由 固定设置 → 会话最近路由 → 宿主默认，任何一环缺失都有明确错误码；
- 升级后自检（每次升级 DSH 后跑一次，<1 分钟）：
node scripts/verify.mjs # 默认打 http://127.0.0.1:3080
node scripts/verify.mjs --rate # 额外验证限流（会吃掉当分钟配额）
DSH_BASE=http://host:port node scripts/verify.mjs # 自定义地址
只发无副作用请求（永远走不到模型调用），验证 5 道护栏：405 方法 / 403 无 Origin / 403 伪造 Origin / 400 空草稿 / 413 超长。任一失败退出码 1，并打印排查顺序。
兼容矩阵：DSH ≥ 0.1.5-rc.1（2026-09-24 本地实测通过）。
安装（本地 profile）
# 方式一：本地 link（开发态，改完源码重启即生效）
cd ~/.dsh/profiles/web
# package.json → dependencies 加：
# "dsh-prompt-enhance-local": "link:D:/_02_MyProjectSpace/DeepseekSpace/2-dsh_plugin/dsh-prompt-enhance"
# package.json → dsh.profile.bundles 加：
# "dsh-prompt-enhance-local"
# 再建符号链接并重启 dsh web
# 方式二：打包安装
npm pack # 产出 dsh-prompt-enhance-local-<version>.tgz
构建
npm run build # host：scripts/build.sh（tsc）；client：tsdown
Windows 下没有 bash 时，等价的两条命令（本仓库实测）：
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 是第一道回归闸门。自检：
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。
