dsh-connect-doubao 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,85 +1,245 @@
-# 更新记录
-
-本文件记录每个发布版本对用户可见的变化。版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
-
----
-
-## 0.3.0 — 2026-11-02
-
-> 相对 `0.2.0` 的 15 个提交。这一版把插件从「只能纯聊天」推到了「能生图、能续聊、
-> 能让模型通过提示词层模拟去调工具」，并修掉了一个从项目第一天就存在的设置持久化缺陷。
-
-### 新增
-
-- **豆包生图（Seedream 5.0）** —— 模型选择器里新增「豆包 生图（Seedream 5.0）」。
-  生成结果以 Markdown 图片形式追加在回复正文里，可直接预览与保存。
-  实测一次请求返回 3 张 2848×1600 图片（右下角带「豆包 AI生成」水印）。
-  注意 URL 后缀是 `.jpeg` 但字节是 PNG，保存时按内容判格式。
-- **模型清单自动发现** —— 不再硬编码模型名。插件直接读豆包客户端的本地缓存
-  （`menuConfV2`，V8 structured clone 编码），豆包上线新模型时清单会自动跟上。
-  缓存解析失败时自动回退到内置静态清单，`doctor` 会显示当前用的是哪一种。
-  「工作任务」专属模型按名称前缀自动隐藏。
-- **真会话续聊** —— 同一个 DSH 会话的第二轮起只发送增量消息，由豆包服务端维护线程内存，
-  不再每轮重发全部历史。实测第二轮只发 20 个字符，服务端仍能答出上一轮的内容。
-- **深度思考分离** —— 开启深度思考后，思考过程走 `reasoning_content` 而不是混进正文。
-- **实验性工具调用（提示词层模拟）** —— 让豆包能驱动 DSH 的本地工具（读写文件等）。
-  默认**关闭**，设置卡片里有独立开关。实现方式是在提示词里注入工具契约，再把模型输出的
-  ` ```doubao-tool ` 围栏解析回标准 `tool_calls`。实测 5 次调用、坏 JSON 0 次、5/5 轮收敛。
-- **设置卡片新增工具开关段落** —— 与模型清单分开保存，避免「换模型」和「放开文件权限」
-  共用一次确认；关不掉的权限开关是比误开更坏的失败。
-
-### 修复
-
-- **设置保存失败（从项目第一天就存在）** —— 症状是点开关报
-  `保存失败：host did not persist the value`，或看起来保存成功但刷新后回退。
-  根因不在 schema：本插件的 fiber 在 DSH 0.2.1 上**永远停在 `state 1`（LOADING）**，
-  宿主因此从不给它挂 `runtime.Config`，`describe()` 直接过滤掉命名空间，任何写入都失败于
-  `No configurable plugin entry "dsh-connect-doubao"`。
-  **这意味着历史上这个插件的设置一次都没能落盘过，包括手工改 `cordis.patch.yml` 的那些。**
-  现在两个开关改存插件自己的 `~/.dsh/dsh-connect-doubao.settings.json`，
-  写入是先写临时文件再原子重命名，读取不依赖任何宿主服务在线。
-- **工具契约导致幻觉** —— 温和措辞的契约下，模型会回「已完成修改：…」但**磁盘根本没动**。
-  这是最坏的失败模式：用户以为文件改了。契约已改为硬性规则（第一条回复必须是工具调用、
-  严禁在没有 `[tool result]` 时声称完成），实测从 0/2 提升到 2/2。
-- **多步编辑互相污染** —— 局部替换链会让第 N 次编辑失效于第 N+1 次，最终文件出现重复行。
-  契约加入「每次修改后重新读取文件再决定下一步」后，同一任务 1 次 edit + 1 次 read 收敛。
-- **回复首字丢失** —— 回复开头在 `STREAM_MSG_NOTIFY`、增量在 `STREAM_CHUNK`，
-  旧代码只取一边导致「1+1」变成「+1」。已抽出 `assembleReplyText` 统一拼接。
-- **对话模式根本不通** —— `agent_mode` 常量写反（1/2 互相搞错），每一轮都被路由到
-  豆包的任务 agent，直接回 `710010702`。已按 CDP 抓到的真实请求体整体重写。
-
-### 改进
-
-- **改动说明改为逐条列出** —— 工具执行完成后不再只说「已修改」，而是按「哪个文件 → 改了什么 →
-  为什么」逐条说明，多处改动分别列出。
-- **请求体形状有测试钉住** —— 18 个断言全部取自 CDP 抓包而非由被测常量反推，
-  防止 `agent_mode` 这类常量再次静默回归。
-
-### 已知限制
-
-- **选不到 2.1 Pro / 2.1 Lite**。服务端**不校验** `model_item_key`（四种真 key 和一个不存在的
-  key 耗时与长度无可测差异），模型由服务端按产品/模式/账号决定。目录已收缩为
-  「快速 / 2.1 Turbo·专家 / 生图」三项，Pro/Lite 只能在豆包客户端自己的「工作任务」里用。
-- **「工作任务 · 本地电脑」调不到**。协议层字段（`runtime_type: 2`、`sandbox_id`、`device_name`）
-  都能发对，但执行者是需要 App 进程内 CUA 运行时的组件，外部客户端一律
-  `710010702`。插件默认走纯对话模式，`DSH_DOUBAO_TASK=1` 才尝试任务模式。
-- **工具模拟只在豆包自身不具备的能力上可靠**。让它「查天气」时它会改用自带联网搜索，
-  不调用我们的工具。
-- **Windows only**。凭据解密依赖 DPAPI。
-
-### 测试
-
-- 10 个测试文件、**112 个用例**全绿（其中本版新增 `store.test.ts` 15 例、
-  `save-route.test.ts` 11 例，覆盖文件合并语义、原子写入、字段白名单、Origin 校验与 500 契约）。
-- `doctor` 五项全绿：凭据 29 cookie / 账号通过 / shim OK / 额度 / 模型发现。
-
----
-
-## 0.2.0
-
-- 修复对话模式完全不通（`agent_mode` 常量写反）。
-- 请求体按 CDP 抓包重写。
-
-## 0.1.1 / 0.1.0
-
-- 首个可用版本：凭据复用（DPAPI + AES-GCM）、provider 注册、只读额度卡片。
+# 更新记录
+
+本文件记录每个发布版本对用户可见的变化。版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
+
+---
+
+## 0.4.0 — 2026-11-05
+
+> 稳定性与额度准确性批次：让「回答」在中断时说实话，让「停止」真的停下上游，让凭据不再经过
+> 子进程环境变量，让设置卡片不再对任何本机页面敞开；额度读数改成看「还剩多少」，并把一直在
+> 扣的活动赠送额度显示出来；卡片重做了一遍视觉。全部改动都带回归测试（新增 36 例，全仓
+> 187 例）。
+
+### 修复
+
+- **断流被当成完整回答** —— 豆包服务端提前断开连接时，插件只把缓冲区里已收到的那半截
+  文本当结果返回，并照样写 `finish_reason: "stop"` 和 `[DONE]`。用户看到的是一个语法
+  通顺、语义中断的回答，没有任何迹象表明它被截断了。现在以 `SSE_REPLY_END` 作为唯一
+  的完成依据：连接先断而该帧未到，就报「回答不完整（已收到 N 字符）」而不是假装成功。
+  特意**不可重试** —— 重试会新开一条线程，把这条线程上的上下文丢掉，比重打一次更糟。
+- **停止按钮停不下上游** —— 客户端断开后没有任何东西通知豆包那边停止生成，那一轮会一直
+  跑到结束，额度照扣，答案没人看。现在响应关闭即 `abort()`，并顺着 `fetch` 传到 socket。
+  顺带补上空闲看门狗：`DOUBAO_STREAM_IDLE_TIMEOUT_MS`（300 秒）此前定义了却从没被使用，
+  流静默这么久会主动中止，而不是把请求永远挂着。
+- **所有认不出的失败都被说成网络问题** —— 分类器对未知错误一律 `network`，shim 又把它
+  标成可重试的 `TIMEOUT`，于是 400、鉴权失败、插件内部异常都会触发宿主的整套重试，
+  最后给出一句「检查网络」。现在按 HTTP 状态与失败来源分类（401/403 → 会话失效、
+  429 → 额度耗尽、4xx → 上游错误不可重试、5xx 与连接失败 → 可重试、其余 → 上游错误），
+  只有真正的传输失败才会被建议重试，错误信封里也带上 `x-should-retry`。
+- **深度思考内容永远为空** —— 帧处理层把 `onThinking` 回调漏掉了（shim 侧的
+  `reasoning_content` 分支早就写好了），开启深度思考时只能看到答案、看不到推理过程。
+- **凭据明文进了子进程环境变量** —— DPAPI 调用把整个会话以 base64 塞进
+  `DSH_DOUBAO_DPAPI_BLOB` 交给 PowerShell，存活了 `Add-Type` 编译那 0.5–1 秒；
+  `...process.env` 还把本机所有 API key 一起带了过去。现在改为 stdin 传入、环境变量走
+  白名单，`powershell.exe` 也从 `System32` 绝对路径启动而不是靠 PATH 查找。
+- **一个坏 profile 会让后面所有候选都不再尝试** —— 候选遍历里 `decryptFromProfile` 没有
+  自己的 try/catch，某个目录的 `Local State` 损坏会直接冒到外层，把 D 盘上真正可用的
+  profile 全跳过。现在逐个隔离，失败信息里带上具体目录。
+
+- **一次会话失效要等十二小时才自愈** —— 加密的凭据副本在磁盘上缓存 12 小时，服务端
+  已经判定失效的 session 会被反复读回来，每次请求都以同一种方式失败；用户按提示重新
+  登录，插件仍然拿旧副本，直到 TTL 到期。现在服务端说会话失效就删掉盘上副本，让重新
+  登录立刻生效。顺带挡住时钟回拨：缓存时间在未来（改过系统时间、双系统、主板电池没电）
+  一律视为过期，否则 TTL 永远算不出一个正数。
+- **额度接口不可用时每一轮对话都要多等一次失败** —— 额度是对话前的前置检查，而失败的
+  结果从来不进缓存，于是接口挂掉的每一轮都要再付一次注定失败的往返，正好压在首字节
+  之前。失败结果现在缓存 30 秒：够短，恢复延迟只有一轮；够长，能把这种反复打穿。
+- **设置卡片对本机任何网页敞开** —— 四条路由只校验 Origin 是不是 loopback，而浏览器
+  在**同源**请求里根本不发 Origin 头，于是「没有 Origin」被当成可信 —— 本机另一个端口
+  上的页面（或任何能解析到 127.0.0.1 的页面）都能改掉模型开关和数据目录。现在 Host
+  必须是 loopback（挡住把域名解析到 127.0.0.1 的 DNS rebinding），带
+  `sec-fetch-site: cross-site` 的请求直接拒绝，写请求还必须带一个自定义头 —— 自定义头
+  会触发 CORS 预检，而这几条路由从不应答预检，跨源页面因此发不出这个请求。同源正常
+  使用完全不受影响。
+- **声明了类型声明文件，但那文件从来不存在** —— `package.json` 的 `types` 指向
+  `lib/index.d.ts`，构建却关着 `dts`，任何按类型使用这个包的人都会碰到一个空引用。
+  现在真的生成声明文件（`lib/index.d.ts` 等 5 个），`types` 与 `exports` 两条路径
+  都对得上。同时把 `lib/` 移出版本管理：tsdown 用内容哈希给共享 chunk 命名，每构建
+  一次整批文件就改名，diff 里看不出任何真实改动；发布不受影响（`prepack` 会构建，
+  `files` 从 tarball 里取 `lib`）。
+
+- **额度卡片的「重置时间」是编出来的** —— 这台账号的套餐只返回一个周额度，且窗口的
+  `start_time`/`end_time` 都是 0（服务端不给时间戳）。旧代码于是拿「现在」当窗口起点、
+  加上一个名义周期当重置时刻，卡片显示「6 天后重置」—— 真实重置可能就在二十分钟后。
+  同一份载荷里还带着 `total_amount: "2,100"` / `used_amount: "0"` 这种带千分位的金额，
+  旧代码完全没读，一旦 `used_percent` 缺失就只能显示 0%。现在：窗口还没开始计时就照实
+  说「开始使用后计时」（豆包客户端本身就是这个措辞），有时间戳就显示倒计时，两者都没
+  有才说「重置时间未知」；金额解析后作为百分比的兜底来源。顺带修掉 `doctor` 把「这个
+  套餐没有 5 小时窗口」判成失败的误报 —— 账号形态不是插件故障，只有额度真正读不出来
+  才算失败。
+- **真正在消耗的那份额度没被显示** —— 额度接口返回三个 section，旧代码只读
+  `window_limit_section`。这台账号的「活动赠送额度」（`incentive_quota_section`，
+  已用 782 / 1,600、11 月 21 日 09:46 到期）因此完全不出现在卡片上：用户看到「近 7 天
+  已用 0%」，以为额度一点没动，实际上已经在扣赠送额度了。现在两个 section 一起读，
+  赠送额度单独一行、用「已用 782 / 1,600 · 16d 后到期」这种带金额的写法，排在常规窗口
+  前面。
+
+### 新增
+- **卡片改成看「还剩多少」，并自己走动** —— 进度条过去画的是消耗比例（越用越满），
+  与「还剩多少」的直觉相反；现在画剩余量，用完即为空，颜色阈值也按剩余量给。数字从
+  「已用 782 / 1,600」改成「剩 818 / 1,600」，倒计时由本地时钟每秒从绝对时刻重算 ——
+  既不用每秒请求，也不会因为标签页放久了而漂移。轮询从 5 分钟缩到 30 秒，且只在卡片
+  可见时进行，切回标签页立刻刷一次；轮询走 POST 绕过宿主 5 分钟缓存，否则每 30 秒
+  拿回的都是同一份读数。
+- **卡片重做了一遍视觉** —— 原来五个分区的高度、字号、边框几乎一样，眼睛找不到落点。
+  现在整张卡是一片带极淡高光的表面，分区之间用一条发丝线分隔而不是各自套框；每个额度
+  窗口是一块独立的面板，一行的重点只有一个：右边那个「还剩下多少」。倒计时和「已用
+  X / Y」退到第二行，不再和主数字抢宽度。进度条改成带方向感的渐变并带一点辉光，数字
+  改用等宽字形 —— 每秒跳动的倒计时不会再让整行左右抖。
+
+### 测试
+- `tests/upstream-terminal.test.ts`（12 例）：终止帧、跨 chunk 拆帧、截断判定、思考透传、
+  失败分类与重试矩阵。
+- `tests/shim-lifecycle.test.ts`（5 例）：客户端断开、正常结束后关闭、空闲超时、活动续命、
+  释放后不再触发。
+- `tests/auth-dpapi.test.ts`（4 例）：源码级守住「明文不进 env」「不走 PATH」两条约束。
+- `tests/save-route.test.ts`（+4 例）：缺写入头、非 loopback Host、跨站标记三种拒绝路径，
+  以及「同源 GET 不带 Origin 仍然放行」这条必须保持可用的例外。
+- `tests/quota.test.ts`（8 例）：用真实载荷做固定数据 —— 只有周额度、时间戳为 0、
+  另含「活动赠送额度」组（782 / 1,600、只有到期时间、window_type 3）；覆盖「不伪造
+  重置时刻」「未开始计时标注 startsOnUse」「赠送额度只报到期」「金额推算百分比」
+  「真实时间戳原样透传」五条契约。
+
+## 0.3.1 — 2026-11-02
+
+> 相对 `0.3.0` 的 3 个提交。修「User Data 不在 C 盘就读不到登录信息」，并补上手动指定目录的
+> 入口 —— 之前只能靠环境变量。
+
+### 新增
+
+- **手动指定豆包数据目录** —— 设置卡片新增「豆包数据目录」一段，带「选择目录…」按钮
+  （桌面端弹系统原生文件夹对话框）和「改回自动探测」。装豆包时把数据目录改到 D 盘、
+  或事后手动搬走的人，现在可以自己指路，不用再设环境变量 `DSH_DOUBAO_PROFILE`。
+  段落里会显示当前用的是哪个目录，以及探测到的全部候选（带来源：
+  `manual` / `env` / `appdata` / `process` / `scan`）。
+  - 选中的路径在写入前会校验目录里是否有 `Default\Network\Cookies`，选错当场提示并**拒绝保存**；
+  - 选中的目录后来被删掉或搬走，会自动退回自动探测，不会把凭据加载卡死；
+  - 指到 `User Data` 本身或它的父目录（例如 `D:\Doubao`）都可以，后者会自动往下找一层。
+  - 浏览器形态的宿主没有原生目录对话框，按钮会明确报错而不是静默失败。
+
+### 修复
+
+- **User Data 不在 C 盘就读不到登录信息** —— 凭据查找曾硬编码
+  `%LOCALAPPDATA%\Doubao\User Data`，把数据放到 D 盘（安装器提供这个选项，也有人事后手动搬）
+  的机器会报 `Doubao user profile not found`，而报错里显示的路径恰恰是用户根本没有的那个。
+  现在改为五层回退：卡片里手动选的目录 → 环境变量 `DSH_DOUBAO_PROFILE` → AppData 候选 →
+  运行中客户端的 `--user-data-dir` → 限时扫盘（深度 4、1.5 秒预算、跳过系统目录）。
+  顺序按**代价**而非准确度排：常见情况 4 次 `existsSync` 就命中，不会为 0.8 秒的进程探测
+  拖慢每次冷启动。返回候选**列表**而非单一路径，因为「复制而非移动」会留下空壳 profile —
+  凭据加载逐个尝试，取第一个真正解出可用会话的。
+- **手动指定的目录失效后会永久留空** —— 覆盖值现在每次都会重新校验，失效的选点自动落回
+  自动探测，不再遮蔽真正可用的 profile。
+- **提示文案里的 Windows 路径少了一层反斜杠** —— `Default\Network\Cookies` 写在单引号字符串里
+  会被当成转义序列，浏览器实际看到的是 `DefaultNetworkCookies`，正好是最需要准确的那句话。
+  已补转义，并加了 `scripts/check-locale-literals.mjs` 直接检查构建产物里的字面量
+  （`npm run check` 会自动跑）。
+
+### 测试
+
+- 11 个测试文件、**151 个用例**全绿（0.3.0 是 132 例）。新增覆盖：`profileDir` 的存取与非法
+  类型、`/__save` 对目录存在性的校验（选错目录必须 400 且不写盘）、`/profile` 只读路由
+  （空结果返回 `null` 而不是空字符串）、手动覆盖的优先级与失效回退。
+- `doctor` 五项全绿；`doctor --json` 的 `credentials.data.profile` 会显示来源，
+  现在多一个 `via manual`。
+
+---
+
+## 0.3.0 — 2026-11-02
+
+> 相对 `0.2.0` 的 15 个提交。这一版把插件从「只能纯聊天」推到了「能生图、能续聊、
+> 能让模型通过提示词层模拟去调工具」，并修掉了一个从项目第一天就存在的设置持久化缺陷。
+
+### 新增
+
+- **豆包生图（Seedream 5.0）** —— 模型选择器里新增「豆包 生图（Seedream 5.0）」。
+  生成结果以 Markdown 图片形式追加在回复正文里，可直接预览与保存。
+  实测一次请求返回 3 张 2848×1600 图片（右下角带「豆包 AI生成」水印）。
+  注意 URL 后缀是 `.jpeg` 但字节是 PNG，保存时按内容判格式。
+- **模型清单自动发现** —— 不再硬编码模型名。插件直接读豆包客户端的本地缓存
+  （`menuConfV2`，V8 structured clone 编码），豆包上线新模型时清单会自动跟上。
+  缓存解析失败时自动回退到内置静态清单，`doctor` 会显示当前用的是哪一种。
+  「工作任务」专属模型按名称前缀自动隐藏。
+- **真会话续聊** —— 同一个 DSH 会话的第二轮起只发送增量消息，由豆包服务端维护线程内存，
+  不再每轮重发全部历史。实测第二轮只发 20 个字符，服务端仍能答出上一轮的内容。
+- **深度思考分离** —— 开启深度思考后，思考过程走 `reasoning_content` 而不是混进正文。
+- **实验性工具调用（提示词层模拟）** —— 让豆包能驱动 DSH 的本地工具（读写文件等）。
+  默认**关闭**，设置卡片里有独立开关。实现方式是在提示词里注入工具契约，再把模型输出的
+  ` ```doubao-tool ` 围栏解析回标准 `tool_calls`。实测 5 次调用、坏 JSON 0 次、5/5 轮收敛。
+- **设置卡片新增工具开关段落** —— 与模型清单分开保存，避免「换模型」和「放开文件权限」
+  共用一次确认；关不掉的权限开关是比误开更坏的失败。
+- **手动指定豆包数据目录** —— 设置卡片新增「豆包数据目录」一段，带「选择目录…」按钮
+  （桌面端弹原生文件夹对话框）和「改回自动探测」。装豆包时把数据目录改到 D 盘、或者事后
+  手动搬走的人，现在可以自己指路，不用再设环境变量。选中的路径在写入前会校验
+  `Default\Network\Cookies` 是否存在，选错当场提示且不落盘；已选的目录后来被删掉会自动
+  退回自动探测。段落里会列出当前用着哪个目录、以及探测到的全部候选。
+
+### 修复
+
+- **设置保存失败（从项目第一天就存在）** —— 症状是点开关报
+  `保存失败：host did not persist the value`，或看起来保存成功但刷新后回退。
+  根因不在 schema：本插件的 fiber 在 DSH 0.2.1 上**永远停在 `state 1`（LOADING）**，
+  宿主因此从不给它挂 `runtime.Config`，`describe()` 直接过滤掉命名空间，任何写入都失败于
+  `No configurable plugin entry "dsh-connect-doubao"`。
+  **这意味着历史上这个插件的设置一次都没能落盘过，包括手工改 `cordis.patch.yml` 的那些。**
+  现在两个开关改存插件自己的 `~/.dsh/dsh-connect-doubao.settings.json`，
+  写入是先写临时文件再原子重命名，读取不依赖任何宿主服务在线。
+- **工具契约导致幻觉** —— 温和措辞的契约下，模型会回「已完成修改：…」但**磁盘根本没动**。
+  这是最坏的失败模式：用户以为文件改了。契约已改为硬性规则（第一条回复必须是工具调用、
+  严禁在没有 `[tool result]` 时声称完成），实测从 0/2 提升到 2/2。
+- **多步编辑互相污染** —— 局部替换链会让第 N 次编辑失效于第 N+1 次，最终文件出现重复行。
+  契约加入「每次修改后重新读取文件再决定下一步」后，同一任务 1 次 edit + 1 次 read 收敛。
+- **回复首字丢失** —— 回复开头在 `STREAM_MSG_NOTIFY`、增量在 `STREAM_CHUNK`，
+  旧代码只取一边导致「1+1」变成「+1」。已抽出 `assembleReplyText` 统一拼接。
+- **对话模式根本不通** —— `agent_mode` 常量写反（1/2 互相搞错），每一轮都被路由到
+  豆包的任务 agent，直接回 `710010702`。已按 CDP 抓到的真实请求体整体重写。
+- **User Data 不在 C 盘就读不到登录信息** —— 凭据查找曾硬编码
+  `%LOCALAPPDATA%\Doubao\User Data`，把数据放到 D 盘（安装器提供这个选项，也有人事后手动搬）
+  的机器会报 `Doubao user profile not found`。现在改为五层回退：设置卡片里手动选的目录 →
+  环境变量 `DSH_DOUBAO_PROFILE` → AppData 候选 → 运行中客户端的 `--user-data-dir` → 限时扫盘。
+  顺序按**代价**而非准确度排：常见情况 4 次 `existsSync` 就命中，不会为 0.8 s 的进程探测
+  拖慢每次冷启动。返回的是候选**列表**而非单一路径，因为「复制而非移动」会留下空壳 profile —
+  凭据加载会逐个尝试，取第一个真正能解出可用会话的。
+
+### 改进
+
+- **改动说明改为逐条列出** —— 工具执行完成后不再只说「已修改」，而是按「哪个文件 → 改了什么 →
+  为什么」逐条说明，多处改动分别列出。
+- **请求体形状有测试钉住** —— 18 个断言全部取自 CDP 抓包而非由被测常量反推，
+  防止 `agent_mode` 这类常量再次静默回归。
+
+### 已知限制
+
+- **选不到 2.1 Pro / 2.1 Lite**。服务端**不校验** `model_item_key`（四种真 key 和一个不存在的
+  key 耗时与长度无可测差异），模型由服务端按产品/模式/账号决定。目录已收缩为
+  「快速 / 2.1 Turbo·专家 / 生图」三项，Pro/Lite 只能在豆包客户端自己的「工作任务」里用。
+- **「工作任务 · 本地电脑」调不到**。协议层字段（`runtime_type: 2`、`sandbox_id`、`device_name`）
+  都能发对，但执行者是需要 App 进程内 CUA 运行时的组件，外部客户端一律
+  `710010702`。插件默认走纯对话模式，`DSH_DOUBAO_TASK=1` 才尝试任务模式。
+- **工具模拟只在豆包自身不具备的能力上可靠**。让它「查天气」时它会改用自带联网搜索，
+  不调用我们的工具。
+- **Windows only**。凭据解密依赖 DPAPI。User Data 可以不在 C 盘（见上文五层回退）。
+  浏览器形态的宿主没有原生目录对话框，「选择目录…」会明确报错而不是静默失败，
+  那种环境请用 `DSH_DOUBAO_PROFILE`。
+
+### 测试
+
+- 11 个测试文件、**151 个用例**全绿。本版新增三个文件：`store.test.ts` 20 例（文件合并语义、
+  原子写入、无临时文件残留、`profileDir` 存取与非法类型）、`save-route.test.ts` 20 例
+  （字段白名单、Origin 校验、值形状、500 契约、`profileDir` 的路径存在性校验、`/profile`
+  只读路由）、`profile.test.ts` 25 例（五层探测优先级、去重、扫描深度与时间预算、
+  手动覆盖的优先与失效回退）。
+- `doctor` 五项全绿：凭据 29 cookie / 账号通过 / shim OK / 额度 / 模型发现。
+  `doctor --json` 的 `credentials.data` 现在同时给出 `profile`（用的是哪个、`via env|appdata|
+  process|scan|manual`）与 `candidates`（全部候选），定位"读不到登录信息"时先看这两项。
+
+---
+
+## 0.2.0
+
+- 修复对话模式完全不通（`agent_mode` 常量写反）。
+- 请求体按 CDP 抓包重写。
+
+## 0.1.1 / 0.1.0
+
+- 首个可用版本：凭据复用（DPAPI + AES-GCM）、provider 注册、只读额度卡片。