WanchunLian/dsh-draft-polish

dsh-draft-polish

DSH（DeepSeek Harness）Web 插件：把输入框里还没发出的口语化草稿，一键润色成更专业、更顺口的表达 —— 默认快路径只出「核心意思」一版，想要其它风格再按需展开。替换回输入框后由你确认再发送。AI 只帮你把话说到位，绝不替你发言。

✨ 功能特性（轻量化版）

• 轻：默认只出 核心意思 一版（快、省），不再一次拉 8 段；想要其它视角在面板里按需展开、逐条生成。
• 简洁：compact 560px 面板，主卡一个「用这版替换」主按钮；7 个视角折叠进「更多风格」次级入口，不抢主视觉。
• 多选降级为高级能力：展开的视角卡可勾「并入」，勾选 ≥2 才浮现「合并 N 版替换」（带 【视角】 标题拼接）；平时主路径零干扰。
• 口语清洗：去掉口头禅、重复、乱序，还原事实主干，不编造用户没说过的事实。
• 替换可反悔：走官方 setDraft 通道，Ctrl+Z 可撤销回原始草稿。
• 绝不阻塞发送：LLM 挂掉 / 超时 / 拒答时，只提示「可原样发送」，主消息链路零影响。

🖱️ 使用流程（小白版，3 步）

1. 写：在输入框里输入或语音转写一段话（口语化、有口头禅没关系）。
2. 点：点输入框右侧的「✨ 润色」→ 稍等片刻弹出「润色结果」，默认已给你一版核心意思。
3. 换：看着合适点「用这版替换」→ 回输入框检查、删改 → 点发送。

想要别的风格？面板里点「想要其它风格？」→ 挑个视角「生成这版」，同样可「用这版」或勾「并入」后「合并 N 版替换」。 不想要任何一版？直接关面板（Esc / 点遮罩），输入框原样保留，不影响发送。

📁 目录结构

dsh-draft-polish/
├── cordis.yml              # bundle patch（loader entries 挂载）
├── package.json            # dsh.bundle / dsh.client 声明（客户端半边自动发现）
├── lib/
│   ├── index.js            # 宿主半边：fenced 路由 + payload 白名单（/draft-polish/api/*）
│   ├── polish-core.js      # 润色编排器（单视角生成 / 全量 8 段兼容 / 解析）
│   ├── prompts.js          # 8 套角色模板 + 公共系统提示词（纯数据）
│   └── client.js           # 浏览器半边：compact 面板 + 草稿快照锁定 + 回填
├── test/
│   └── polish-core.test.mjs# P0 回归：上下文红线 / 白名单 / 边界（node:test，npm test）
├── docs/design.md          # 完整架构设计文档（含 M0–M4 实测记录）
└── README.md               # 本文档

🔧 安装部署（技术版）

前置要求

• Node.js 20+（实测 v22.22.2 ✅）
• @deepseek-ai/dsh（0.1.1-rc.2，npx @deepseek-ai/dsh web 可启动）
• DSH profile 目录（Windows 默认 C:\Users\<你>\.dsh\profiles\web）

步骤

1. 进入插件目录（本项目根）：

   cd D:\mycode\dsh\dsh-draft-polish
   

2. 以 link: 协议装进 profile（实时生效，改代码无需重装）：

   cd C:\Users\wanch\.dsh\profiles\web
   npm install link:D:\mycode\dsh\dsh-draft-polish
   

3. 确认 profile 的 package.json 已含依赖与 bundle 注册：

   // profiles\web\package.json（示例，插件包名会随 link 自动写入 dependencies）
   { "dependencies": { "dsh-draft-polish": "link:..." } }
   

   bundle 注册项（dsh.profile.bundles 追加包名）如缺失，参考同机官方 bundle 写法补齐。

4. 启动 DSH Web：

   npx @deepseek-ai/dsh web
   

   浏览器打开 http://127.0.0.1:3456，输入框工具行右侧即出现「✨ 润色」按钮。

⚠️ 若改动 cordis.yml / package.json 的 bundle 声明，需重启 dsh web 生效；仅改 lib/*.js 无需重启（link 实时）。

🔌 宿主路由契约（浏览器半边经同源 fetch 调用，宿主侧 fenced）

• 失败统一信封：{ ok:false, error:{ code, message } }
• Payload 白名单（上下文红线）：两个路由只接受上表列出的字段；夹带 sessionId / conversation / history 等任何会话上下文字段 → 一律 400 UNEXPECTED_FIELD（见 lib/index.js 的 assertOnlyKeys）。
• 安全：路由带 DNS-rebinding / CSRF fence（Host 必须 loopback 或受信 + Origin 同源），浏览器进程不直连 ctx.llm。

🔒 隐私边界（你关心的那条线，已锁死）

• 只发草稿快照：浏览器半边在【点击按钮那一刻】锁定草稿快照（lockedRef），面板开着期间你继续输入的内容、正在进行的对话、历史消息，一律不会出现在任何 LLM 请求里——面板里的「更多风格」逐条生成同样只用这份快照。
• 不夹带会话：请求体只有 { draft, roleId }，宿主侧白名单强制校验（见上）。
• 不泄露正文日志：宿主侧不打草稿正文日志；本地 profile 数据由 DSH 官方机制管理。
• 回归测试兜底：npm test 的用例锁死「messages 只含 1 条 user = 草稿」与「多余字段 400」，防止未来改动把上下文拼回去。

🛡️ 降级行为（设计铁律：润色失败绝不阻塞发送）

⚙️ 可调参数（lib/polish-core.js）

✅ 测试与验收记录

缺陷记录：

• 多选默认勾选曾因数组多包一层（[defs] 嵌套）导致永不勾选，已修复并复测（见 docs/design.md 第 17 节）。
• V2 修复的真实泄漏隐患：旧版面板打开后的「重试」读的是实时输入框内容——用户面板开着继续打字，重试会把新输入带进请求。已改为快照锁定（见上「隐私边界」）。

🧑‍💻 开发说明

• 浏览器半边与宿主半边分离：UI 只做展示与回填，LLM 能力全部收口宿主路由（lib/index.js），DSH rc 版 API 演进只改宿主一处。
• 角色模板为纯数据（lib/prompts.js），与代码解耦，可热调措辞。
• 插件随 ctx 生命周期自动清理（路由经 ctx.effect 注册），卸载无残留。

📄 License

MIT