dsh-superinput 0.0.0-stage → 0.7.0

package/CHANGELOG.md

@@ -0,0 +1,140 @@
+# Changelog
+
+本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [0.7.0] - 2026-11-02
+
+### 发布工程（补 0.6.0 之后未归档的提交）
+
+- `files` 白名单补入 `server.js`——此前 `index.js` 动态 import 的核心文件
+  不在 npm 产物里，发布出去必然加载失败。
+- `modules` 改为 `modules/*.js`，新增 `.npmignore` 排除 `.mimosa` 工具状态与
+  日志、tarball；清掉 `modules/.mimosa` 本地残留。
+- 移除 `files` 中并不存在的 `README.en.md`；描述从「八个模块 / 片段管理器」
+  校正为当前七模块。
+- 新增 `build` / `check` / `test` npm scripts，发布前可直接跑生成器、语法
+  检查与冒烟测试。
+
+### prompts 划选菜单增强
+
+- 选区浮层改为横排三动作：**复制**、**添加到对话**（追加进输入框草稿）、
+  **存为模板**；左缘对齐选区，右侧防溢出。
+- 文档级单例 host + 安装守卫：宿主重挂载导致 apply 重跑时不再叠加多个浮层。
+
+## [0.6.0] - 2026-11-01
+
+### 吸收上游三件新功能（市场对标项）
+
+- enhancer 0.3.0：✨ 面板新增「参考会话上下文」开关——增强时把最近一轮
+  对话拼进改写参考，消解指代、贴合当前讨论（对标市场 dsh-prompt-rewriter
+  205★ 的关键差异点）。
+- cost 0.9.0：费用弹卡顶部新增「官方余额」行（选配 DeepSeek 开放平台
+  apiKey，10 分钟缓存；调用明细弹窗已有）。
+- picker 0.12.5：模型行相对价格 ×N 标记（上一版已并入，本版无新变更）。
+- 同批配套：dsh-compaction-control 0.3.0 压缩前自动落档（套件外独立插件）。
+
+## [0.5.0] - 2026-11-01
+
+### 移除消息目录与会话导出（用户裁定）
+
+- **outline（消息目录）与 exporter（会话导出 Markdown）整体移除**——上线
+  不到半天被用户判定不需要。套件回到七模块：cost / picker / enhancer /
+  followup / voice / prompts / hub。
+- 多帧 zstd 会话日志直读与 /diag 通道经验保留在案（followup 与 prompts）。
+
+## [0.4.0] - 2026-11-01
+
+### 新增三模块 + 两处既有模块增强；移除草稿与片段（用户裁定）
+
+- **outline（消息目录）**：状态行「目录」按钮 → 按用户消息列大纲（/outline
+  端点直读会话日志），点击 TreeWalker 定位正文滚动跳转。
+- **exporter（会话导出）**：标题栏 ⬇ 按钮 → /markdown 端点把整会话（用户+
+  助手，连续助手快照去重）导出为 Markdown 下载；真机用真实会话日志验证
+  （outline 4 条 / md 6527 字节 / 下载头正确）。
+- **prompts 划选存模板**：对话正文划选后浮「存为模板」（selectionchange
+  驱动，dblclick 选词后才成形），原生 DOM 渲染（React h() 产物过
+  replaceChildren 会被强转成 "[object Object]"，真机踩过）。
+- **cost 预算超限系统通知**：预算跨线 100% 时每周期弹一次系统通知（80%
+  只走既有 UI 变色）。
+- **picker 模型行价格标记**：按 dsh-cost /prices 档价算相对当前模型的 ×N
+  倍数（>1 暖色），10 分钟缓存，取不到不显示。
+- **移除 drafts（草稿快照/↑召回）与 snippets（片段管理器）**：用户裁定
+  没什么用。诊断通道从 snippets /diag 迁到 prompts /diag（落
+  superinput-debug.log）；hub 总览同步移除片段区；既有 snippets.json
+  数据保留不再使用。
+- 冒烟扩展：exporter 端点（缺参 400 / 未知会话 404）+ 九模块 apply。
+
+## [0.3.4] - 2026-11-01
+
+### 修复：/ 模板命令插入后草稿残留触发行（真机验证发现）
+
+- 真机全链路验证（0.3.1 的 / 命令功能首次实机走查）：注册 → 官方 / 菜单
+  「指令」组出现（label 中文可搜）→ 回车执行 → 模板入草稿，全部通过；
+  唯一毛刺是 action 执行时草稿里还留着刚敲的 `/e2e`，官方壳清 token 与
+  我们的 setDraft 时序竞争。修法：首行是无空格的 `/xxx` 就剥掉再接正文，
+  两种时序下都只留模板内容。同轮确认使用计数（2次）与 / 按钮激活态正常。
+
+## [0.3.3] - 2026-11-01
+
+### 修复：followup chips 流式回合不实时渲染（自 dsh-followup 0.3.4 再生成）
+
+- turn-tail 组件的 `isLatestTurn` effect 把 `boxRef.current` 捕获进闭包，
+  流式重渲染重建回合尾容器后旧节点脱离 DOM，`contains` 恒 false——POST 与
+  渲染都被挡，刷新才恢复。check() 改为每次现读 ref（真机四轮 CUA 实测：
+  修复前两轮失败、修复后实时渲染 + 点 chip 填草稿全通过）。
+- 客户端关键决策点 diag 落盘（snippets-debug.log 的 `followup:` 行）。
+- 同轮真机验证：voice 模块叠加层在官方语音录音态正常出现/退出。
+
+## [0.3.2] - 2026-11-01
+
+### 修复：enhance /rewrite 请求期 "cannot get property \"llm\" without inject"
+
+- **真机实锤（套件顶层 inject 授权不可靠的第二例）**：0.3.0 修复的
+  tools.register 报错是 apply 期同款问题；本版发现 0.3.1 起的运行期版本——
+  /rewrite 处理器把**外层 ctx** 传给 rewriteWithLlm，ctx.llm 在套件宿主里
+  抛 cannot get property "llm" without inject，✨ 点增强永远 502（之前客户端
+  出错只写 console，看起来就是「点了没反应」）。
+- 修法（沿用 followup 模块的成熟模式）：webServer 嵌套作用域改成
+  `ctx.inject(['webServer', 'llm'], ...)`、处理器改传 `webCtx`；工具 execute
+  改传所在 `['llm','tools']` 作用域；pre-step 路径在嵌套作用域里捕获
+  `llmRef`，未就绪时 fail-open 放行原文。上游 dsh-prompt-enhancer 0.2.9
+  同步修复（独立安装形态同样受益），客户端增强失败从静默 console 改为
+  按钮短暂红 ✕ + title 带原因，4 秒消退。
+
+## [0.3.1] - 2026-11-01
+
+### prompts 模板库：使用排序 / 导入导出 / 斜杠命令
+
+- **最近使用排序**：点插入即计数（`uses` / `usedAt`），面板收藏组与全部组内
+  按「最近使用 → 创建时间」排序，标题旁显示使用次数。
+- **JSON 导入导出**：面板头部 ↓/↑ 两个按钮；导出走浏览器下载落系统下载目录
+  （`dsh-prompts-YYYY-MM-DD.json`），导入弹系统文件选择框。服务端 `/import`
+  按 id 合并：同 id 冲突保留 `at`（更新时间）较新的一方，id 不在库中按原 id
+  收编（跨机重复导入可去重），空 body / 非法载荷拒绝，条目上限 5000。
+- **注册为 / 斜杠命令**：模板行新增 `/` 切换按钮（opt-in，避免淹没官方菜单）。
+  标记的模板经官方 `ctx.commandUi.register` 注册为 action 命令（`tpl-<slug>`
+  前缀防撞宿主命令，标题即 label，/ 菜单按 label 模糊匹配中文可搜）；执行时
+  经草稿桥插入，内置动态变量（日期/时间/星期）自动取值，手填变量保留 `{{名}}`
+  由用户行内改。同名冲突按官方约定 fail loud，这里 try/catch 留痕跳过；
+  标题修改/删除在面板刷新时注销重注册。
+- **修复**：prompts 设置持久化引用了未导入的 `dirname`，每次防抖写盘都抛
+  ReferenceError 被空 catch 吞掉——设置从来没落过盘。补导入后持久化恢复。
+- **测试**：新增 `scripts/smoke.mjs`——桩服务逐模块 apply + prompts 端到端
+  18 项断言（含导入合并/冲突/非法载荷），自动备份并恢复真实存储，随时可跑。
+
+## [0.1.0] - 2026-10-31
+
+### 首个版本：六模块超级输入框套件
+
+- 由 dsh-cost / dsh-power-picker / dsh-prompt-enhancer / dsh-followup /
+  dsh-siri-voice 机械搬迁 + 新模块 **snippets（片段管理器）** 组成：
+  自动捕获 dsh 窗口内复制（copy 事件，指纹去重、上限 200 条、收藏不限），
+  dock「片段」按钮弹官方样式面板（搜索 / 收藏 / 删除 / 点击追加到草稿）。
+  能力边界：宿主无系统剪贴板桥，只捕获 dsh 窗口内复制。
+- 服务端：Config 嵌套命名空间（config.cost.* 等，默认值经 schemastery
+  嵌套解析验证）；peer 注入并集 llm+tools；模块级 try/catch 隔离。
+- 客户端：单 __ModuleLoader__ 入口 + 六工厂内联，factory/apply 双层隔离。
+- 生成器 `scripts/build-suite.mjs`：上游包更新后重跑即再生成（幂等），
+  自动补 inject 再导出与缺失 Config 的空 schema 兜底。
+- 验证：全文件语法通过；宿主环境 import 通过；嵌套 Config 解析断言通过
+  （cost/followup/snippets/voice 默认值逐项核对）。

package/README.md

@@ -1,3 +1,39 @@
-# Temporary Holding Version
+# dsh-superinput
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+dsh（DeepSeek Harness）**超级输入框套件**：一个插件，七个输入区模块，模块级失败隔离。
+
+| 模块 | 功能 | 来源 |
+|---|---|---|
+| **cost** | 费用引擎：状态行费用 pill、官方用量旁的费用按钮+弹卡、月底预测、设置页统计/预算/导出、历史回填、官方价格同步、汇率自动刷新、预算超限系统通知 | 原 dsh-cost |
+| **picker** | 模型选择器接管 + 推理强度滑条 + 模型行相对价格标记（×N） | 原 dsh-power-picker |
+| **enhancer** | 提示词增强按钮：点一下把草稿增强成结构化提示词，悬浮调强度，支持发送时自动增强 | 原 dsh-prompt-enhancer |
+| **followup** | 回合尾跟进建议 chips | 原 dsh-followup |
+| **voice** | 语音输入 | 原 dsh-siri-voice |
+| **prompts** | Prompt 模板库：手动保存常用模板，{{变量}} 占位符插入，内置 {{日期}}/{{时间}}/{{星期}}/{{剪贴板}} 动态变量；最近使用排序、JSON 导入导出、可 opt-in 注册为 / 斜杠命令；划选正文浮出「复制 / 添加到对话 / 存为模板」三动作菜单 | 新模块 |
+| **hub** | 设置总览：各模块生效配置聚合展示 + 运行时调节 | 新模块 |
+
+`dsh-compaction-control` 不在套件内（宿主配置补丁层 + /compact 命令桥，保持独立插件）。
+片段管理器（snippets）0.4.0、草稿（drafts）/消息目录（outline）/会话导出（exporter）0.5.0 起
+按用户决定移除；既有 snippets.json 数据保留在原处不再使用。
+
+## 架构
+
+- 服务端 `index.js` 聚合七个模块的 Config（嵌套命名空间 `config.cost.*` 等）并逐模块 try/catch 调用；peer 注入取并集（`llm`、`tools`）。
+- 客户端 `client.js` 是单 `__ModuleLoader__` 入口：七个工厂内联（由 `scripts/build-suite.mjs` 从上游各包机械生成），factory 与 apply 双层 try/catch。
+- 跨模块协作保持原机制：调用来源分账走 `globalThis.__dshPluginCall` 5s 窗口；各模块调试日志维持原路径（`~/.dsh/cost-debug.log` 等）。
+
+## 安装
+
+```powershell
+dsh plugin --profile desktop add <本目录绝对路径>
+```
+
+从五个独立插件迁移：先装套件、确认 bundles 里有 `dsh-superinput`、重启验证，再移除旧插件（避免同槽位双注册冲突）。装完完整重启 dsh。
+
+## 上游更新
+
+改了 `packages/dsh-*` 的源码后，在套件目录重跑 `node scripts/build-suite.mjs` 再生成 `modules/` 与 `client.js`（幂等）。
+
+## License
+
+MIT