## [1.9.0-beta.33] - 2026-10-31

> 随包 Matt 技能从 v1.3.1 升到 v1.3.2：27 个技能整树重同步，19 个技能文件有改动，7 处新增「派子代理要用全新上下文窗口、不要 fork 当前对话」；技能哈希清单重算并把版本断言改成读清单 pin；18 篇中文译文整篇重译、32 篇逐段核对、50 篇逐篇由独立子代理审查；议题标签口径按票的位置补全，提示词补上全新上下文要求。测试版。

### Added

- 随包技能升到 v1.3.2 后新增的 7 处「派子代理要用全新上下文窗口、不要 fork 当前对话」要求，随技能原文与中文译文一起提供；实现者提示词（`config/prompts/map-advancement.yaml` 的 specExecute）中英文也补上同一条要求（#1725）。
- 术语表新增 subagent、context window、fresh context window、blocking edge、blocker、dependency edge、child issue、child ticket、native 依赖这几组词的定译，并明确「智能体」是废弃旧译（#1722）。

### Changed

- 随包 Matt 技能从 v1.3.1 升到 v1.3.2，27 个技能目录整树重同步（#1721、#1723）。
- 技能哈希清单 79 条按「读原文、CRLF 归一成 LF、取 utf8 sha256」重算，清单 pin 改成 v1.3.2；版本断言改成读清单里的 pin，不再硬编码版本号（#1723）。
- Markdown 后端的原文技能映射只换 pin、补相邻注释并在 pin-history 追加一条，映射生成物用生成器重算（#1723）。
- 18 篇有英文改动的中文译文整篇重译，32 篇英文未变的译文逐段核对，50 篇译文全部由没参与翻译的独立子代理逐篇审查（#1726–#1730）。
- 议题标签文档与根 `AGENTS.md` 按票的位置补全标签口径：地图只带 wayfinder 标签、地图工单在调用时给 wayfinder 类型标签、规格与实施票带 ready-for-agent、缺陷带 bug 与 needs-triage、普通票不补（#1724）。
- README、包介绍、架构契约、设计文档、术语表与提示词里写死的随包 pin 从 v1.3.1 改成 v1.3.2；ADR 只在文首补一条「2026-10-31 起随包 pin 已升 v1.3.2」，历史叙述不动（#1731）。
- 安装命令里的锁定版本从 1.9.0-beta.32 改成 1.9.0-beta.33（#1731）。

### Fixed

- 关闭票的写法：文档写清要先评论再关闭，因为对已关闭票带评论关闭会丢评论且仍返回成功（#1724）。
- 应急手写命令建票前先确认目标仓库，绝不往上游仓库建（#1724）。
- 中文译文里与新版英文原文对不上的译法：bug 核查的 confirmed/failed 改成「核实成立／核实不成立」，ADR 格式的 Considered Options／Consequences／monorepo 等按术语表统一，并补回旧译漏掉的命令、标签规则与流程段落（#1726–#1730）。
- 技能详情页门禁随原文变化调整：v1.3.2 的 `implement` 正文把 `/tdd`、`/code-review` 改成引号写法，`tests/verify-skill-detail-stack.ts` 里「真实语料必须出现普通文字斜杠技能名」的判据前提消失，删掉那条 check，保留「出现一处核一处」与历史写法回归（#1731）。
- 领域文档旧名门禁随原文变化调整：v1.3.2 的 `setup-matt-pocock-skills/SKILL.md` 主动点名旧名 `CONTEXT.md` / `CONTEXT-MAP.md`（提议用 `git mv` 改成 GLOSSARY 名），`tests/verify-1206-glossary-naming.ts` 里「技能树里一处旧名都不许有」的判据换成「旧名只许出现在带 legacy 记号的句子里」，旧名也不再算技能世界里的合法名字（#1731）。

## [1.9.0-beta.32] - 2026-10-30

> 修掉一轮真机验证查出的界面问题：Markdown 目录签太长时在行尾按字切断、设置页里没点开过的工作区开关能存住并显示「已存住」小字、已关闭票详情页给出完整本地票文件路径、本地 Markdown 的「打开链接」统一打开票所在目录；关闭与展开整扇门改成跟随式二次确认，全仓悬停提示统一锚在控件上方并按边界让位；缺核心技能套件时的黄条压成单行短句、窄窗只在行尾省略；悬停提示的限宽与排位改按渲染外框计算，贴右不再吃掉边距。测试版。

### Added

- 设置页工作区总览里，名单上登记了但这次没点开过的工作区行，两个开关下面多显示一行右对齐小字「已存住，打开该工作区后生效」（英文同义），等这个工作区被打开、临时记录合并后自动消失（#1654、#1640）。
- 悬停提示新增统一定位规则：默认锚在触发控件正上方，上方放不下翻到下方，点左右贴边时整块向内移；所有调用点不再自己传方位（#1652、#1653）。
- 真机验证工具台搬进仓库（`scripts/real-machine/`），补上冻结候选与清理批次两条命令（#1645）。
- 真机验证工具台再补两条窗口能力：有头窗口必须真全屏才能下空间结论；三款窗口尺寸预设（宽屏真全屏／窄窗外框宽 800／矮窗高 600），设完还核对插件真的进了那一支布局（#1637）。

### Fixed

- Markdown 多目录那一排目录签名太长时整颗胶囊被挤到下一行：外层改回块级布局并给足行高，胶囊改成行内元素、只在最前最后封口，放不下时在行尾按字切断，两截都能看见；超长名显示宽度按 19 个数字字符设上限并以省略号收尾，悬停提示与读屏名仍是全名（#1639）。
- 设置页里登记了但没点开过的工作区，点「状态栏胶囊」「deck 工具箱」两个开关没有反应：写设置时按名单路径先落一条带 `unopened: true` 的临时记录，读设置时也按名单路径再问一次，重进设置页与重启 DSH 后状态都在；设置文件新增 `unopened` 字段，只认 `true`（#1641）。
- 已关闭规格下的已关闭子票，详情页「执行」「新会话」「复制链接」「在跟踪器打开」给出的地址退成 `#编号`：拼地址时用详情页自己取回的票数据补一层，四个入口都给出完整本地票文件路径（#1649）。
- 同一个「打开链接」按钮，中文文件名走开目录、纯 ASCII 文件名走 `explorer /select`，用户看到两种结果：后端契约新增 `openIssue: 'folder'`，本地 Markdown 后端统一打开票文件所在目录（#1650）。
- 关闭与展开整扇门会弹全屏居中确认框挡住画面：改成锚在按钮旁的小浮层，标题写清这次要关（或开回）整个门、正文列清受影响三处；点外面、按退出键、点「取消」一律不写设置，确认后按「先关右侧面板、再写工具箱关」执行，开回来按「先写工具箱开、再显示胶囊、最后打开右侧面板」执行；贴边时自动翻到下方并整块内移（#1655）。
- 悬停提示有的朝上有的朝下、屏幕顶部与左右边缘常常不让位；红色关闭按钮的提示改用平实说法（#1652、#1653）。
- 缺核心技能套件时的黄条正文照抄整段安装说明（还带编号列表），窗口一窄就折成多行、把按钮挤到下一行：文案收成一句短句，黄条按内容自适应宽度但不超窗口，窄窗只在正文行尾省略，按钮与关闭叉始终留在同一行（#1661）。
- 悬停提示的限宽按内容盒算、外框实际多出 26 像素，贴右的长提示整体右移 7–13 像素、右缘距被吃到 −0.43 像素：改成 `box-sizing: border-box` 直接约束渲染外框，定位改用带小数的外框矩形并统一取整与边界夹取，默认上限 320（#1660）。
- #1649 门禁在 Windows 上通过后仍被判红：Node 24.19 的 libuv 在动态 import 后立刻 `process.exit` 时会断言，改成通过时自然退出、只在失败时退出码 1。

### Changed

- 发布工具链自证：构建后拍文件指纹、发布前补跑一次、发布后从 registry 拉回逐文件对账，并核对 `beta`／`latest` 两个标签；发布 token 改从临时文件读取，命令行与会话记录不再出现明文；发布前清单票检查新增正文与评论记录一致性判据（#1646、#1647、#1648）。
- 五条冒烟并进 `npm run verify:parallel` 末尾；固定构建工作目录并加门禁钉死两种入口产物逐字节一致；设置页两个文字开关的点按与临时记录合并失败留下常驻日志；胶囊门禁判据收窄到三个分支（#1643、#1644、#1642、#1651）。
- `suggest_next_steps` 工具的说明词收紧到只留调用时机与写法要求（#1656）。
- 黄条形状改动后，669 门禁的 D1 反证与门禁归属表跟着同步（#1662）。
- 词典补全界面词条并新增悬停提示方位一条；致谢表与 Star History 日常更新。

## [1.9.0-beta.31] - 2026-10-29

> GitLab 后端可以选用了；胶囊状态栏与 deck 工具箱能按工作区开关；登录状态暂时确认不了时面板可见会自己复查，网络恢复后黄条自己消失；断网时已绑 GitHub 的工作区看不到黄条的问题一并修好；冷启动首条链先等后端选择；缺 gh 时的提示先问装没装；初始化跑完后提示条自己消失；GitHub 工作区地图详情能取回子票。测试版。

### Added

- 后端选择、Dock 头部切换与状态条三处不再把 GitLab 标成「筹备中」，可以直接选用（#1600）。
- 工作区入口新增地图薄查口，一次取回整张地图的键、标题、状态、标签、认领与阻塞（#1603、#1604、#1605）。
- 状态栏胶囊与 deck 工具箱可以按工作区分别开关：设置页「工作区后端总览」每行两个开关，胶囊尾部可折叠或关掉整个 deck；关掉的工区里 deck 工具一并收起（#1612）。

### Fixed

- 登录状态暂时确认不了时（例如刚断网）黄条一直留着，网络恢复后要人手点「重新检查」：面板可见时每 30 秒最多自动复查一次，恢复后自己消失（#1474、#995）。
- 断网时已绑 GitHub 的工作区看不到「登录状态暂时确认不了」的黄条，状态栏一直停在「该工作区还没有设置」：后端选择改读真实判定（#1625）。
- 初始化跑完后提示条不消失：链重算钩子改看当前显示的会话（#891、#1220）。
- 切回旧会话时建议气泡有时补不出来，个别坏条目按宽松解析（#1420）。
- Markdown 目录签名过长时换行丢字；容器行编号为 0 时被判成空，新会话提示词缺地图链接（#1596、#1597）。
- Windows UNC 工作区在规范化时被小写化成不存在的路径（#1498）。
- 技能探测的 force 透传丢失、失效广播没清缓存（#1227）。
- 冷启动进已绑 GitHub 的工作区时，状态栏首条链不等后端选择、空键回包被丢弃：改为选择落定后补发一次（#1626）。
- 人手点「重新检查」撞上后台正在跑的链求值时结果混用：改为先等它收尾、再自己算一轮（#1622）。
- 多目录仓库开新会话时新会话链接串到另一个规格目录：地址去歧义失败时改为报错，不再静默回退（#1595）。
- 本地 Markdown 后端地图薄查返回的行地址是空串：改为指向真实文件路径（#1611）。
- 像素卡片里的结案章盖到粘性顶栏上：卡片加隔离层级，卡内 z-index 只在卡内比较（#1630）。
- GitHub 工作区的地图详情取不到子票，已关闭地图的详情页卡片区为空：取子票的入口不再被共享的写作通道判断拦掉 GitHub 后端（#1636）。
- 缺 gh 时的提示不管装没装都让去安装：改成先确认装没装、再按结果分流，并写明界面「重新检查」不刷新进程环境（#1621）。
- 没装 glab 时抄了一堆各系统安装命令：改为只给官方文档一个入口（#1189）。

### Changed

- GitLab 房的父子归属与阻塞降级改用隐藏标记承载，正文里的可见行不再当判据（#1599）。
- 出站闸接上日志上下文，排队与冷却日志真正落盘；写超时不再重放（#1224）。
- 界面动效时长收进唯一令牌模块并加常驻门禁；面板统计数字与 GitHub 现场对账门禁扩大（#1236、#1242）。
- 读票与读阻塞边改成并发发出，按实际发出的请求数报账（#1610）。
- 提示词统一加入「从第一性原理出发」的元提示句：19 条注入面、22 个模板覆盖，机械模板不动。
- 内部整理：配额与限流诊断日志核心行常驻、逐笔细节只进 debug；时间参数只剩 stepWaitMs 一个键；出站读写按子命令白名单判定；宿主日志格键收成共享模块并加单源门禁（#1627、#1629、#1614、#1620）；真机验证清单规则补上登记场景与发布前检查（#1628）。

## [1.9.0-beta.29] - 2026-10-28

> 新会话不再复用已归档空白会话，顶栏不再卡在选择工作区；排队等待收进出站准入闸，四条出站路共用预算与到期归还；四处打开文件夹收成一个共用入口，空目录不再发无效调用。测试版。

### Fixed

- 点「新增 BUG」等开新会话的入口后，新会话没有选中工作区、提示词没注入：插件挑空白会话复用时只验了还在名单里、没验有没有被归档，草稿写进了看不见的归档会话。复用闸门升级为先读归档名单再挑候选，已归档的跳过；上次复用失败残留的草稿这次清掉改走新建（#1580）。
- 四处打开文件夹入口各写一份失败处理，空目录也会向宿主发无意义的调用：收成 `src/client/views/shared/openFolder.ts` 的共用函数，空目录直接在界面侧拦下，宿主回失败或调用异常统一交回调用方提示（#1582）。
- 低置信声明只留证据、不再参与后端判定：撤回 hint 方案，按方案 A 收口，界面不再把正文提及说成人选（#1572）。
- 本地 Markdown 环境检查把同一 `.scratch` 根目录扫两遍：房间预检与宿主链各列一次，收成一趟检查共用一趟列举结果（#1585）。

### Changed

- 排队最多等多久原来由每个出口各写一份：房间客户端与宿主各有一套到点赛跑，平台通道与临时执行路连上限都没有。出站准入闸新增 `waitMs` 预算，排队到点先摘下再抛排队超时错误，放行、取消、冷却、到点四条路径都清计时器，晚到的名额由队列自然补位；错误码一处定义，排队预算只给 GitHub、GitLab 恢复不设上限（#1570）。
- 标签检查目录与运行时清单重新对齐：删掉已退役的旧标签检查死项，GitHub 房检查表改成由检查目录派生并冻结对象身份，手抄副本漂移会被门禁抓住（#1223）。
- 票号徽标门禁删掉一条空断言，按住五处旧式手写徽标的固定数量（#1564）；卡片演示页快照重出，16 态与三张卡恢复渲染；版本管理与交给 AI 原型只落在 `docs/` 下，不改运行时代码。

## [1.9.0-beta.28] - 2026-10-27

> 本地 Markdown 后端下「在跟踪器打开」恢复可用：票开对应 md 文件、地图与规格开所在文件夹；GitLab 与本地工作区的仓库身份补齐，取数与详情不再报 refId missing；票详情页失败横幅主行说人话；技能详情正文里的技能名入口可点。测试版。

### Fixed

- 本地 Markdown 后端下第 4 颗按钮「在跟踪器打开」点了没反应：八处视图按地址前缀行内分流、Markdown 容器地址为空、失败又被空 catch 吞掉。接口契约新增 `openIssue` / `openContainer` 两个后端声明，界面按声明决定渲染成链接还是按钮并走同一打开入口；Markdown 容器地址补进快照直取；`wf.openFolder` 新增 `{ file }` 参数，由宿主用 `plat.path.dirname` 取父目录，票对应到 md 文件、地图与规格对应到 `map.md` / `spec.md` 所在文件夹（#1557）。
- GitLab 工作区取数、详情、评论、认领报「无法解析目标仓库（refId missing）」：会话补身份的刷新实现把远端定位写死只给 GitHub；抽成共享 `src/tracker/session/repo-ref.ts` 四步补齐（判定自带 → describe → getRepoKey → owner/name 再问 describe），刷新与 deck 工具共用，装配层不再拼域名（#1583）。
- 快照缓存、刷新排程、地图子票、按页翻票、探针五处只问注册表 describe，答不出 refId 就把空身份送进房间；统一走 `resolveRepoRefForCwd`（describe 答不出时开只读会话从 `opened.repoRef` 取身份），宿主三处装配补 `openSession`（#1584）。
- 本地 Markdown 工作区的票详情与评论报 refId missing：会话装配只从注册实例取 `describe` / `issueAddress`，而这两条只挂在模块对象上，取到 `undefined` 后抛错又被吞成「没拿到身份」；改成模块对象优先、实例兜底（#1581）。
- 票详情页顶部红条把后端整段技术回话铺在主行：network 且原文不少于 48 字时主行改说人话，完整原文收进「原始说明」折叠区；折叠条也不再重复整段原文（#1573）。
- 技能详情正文里的 `/tdd`、`/code-review` 点不开：普通文字层补「斜杠 + 名单查表」入口，斜杠前的连字符不再挡住技能名（#1556）。
- 本地后端票号徽标在长目录下把斜杠一起省略：拆分点移到斜杠前，上限 136px 收到 85px，斜杠与编号始终完整（#1579）。

### Changed

- 新会话决策链新增常驻诊断日志事件 #134 `newsession.decide`：一次「在新会话打开」记一行（入口种类、cwd 来源、工作区编号来路、快照登记项数、复用还是新建、入参档、成败），只记散列与计数（`a65498e8`）。
- 导览文档按当天代码重核，541 条引用中修正 296 行路径与行号（#1531）；发布目录 README 跟随根 README 的星史日期重新生成；致谢表与 Star History 日常更新（`0da8d16d`、`94381254`、`d76e93cc`）。

## [1.9.0-beta.27] - 2026-10-27

> 票面工具恢复可用：列票回执不再夹带 `undefined` 导致整笔失败；单票默认薄读、整段正文写回要带指纹；在办表搬进独立的 `deck_work_route` 工具；读超时不再把排队算进预算。测试版。

### Fixed

- `deck_issue_list` 成功回执里的两个 `undefined` 键让宿主把工具整笔判成非无损 JSON；现已去掉，并补九工具无损门禁（#1559）。
- 升级后子票读不出来、详情与评论开会话失败：详情与评论复用同一套后端判定，GitLab 认领不再把文档提及当声明（#1555）；Markdown 认领改成与判定层同一套解析器（#1572）。
- 读操作超时把排队时间算进 12 秒预算、命令还没发出去就判超时；排队只等自己的上限，上限先到如实说「还在排队、一次没跑」（#1560）。
- 环境检查「已关联 GitHub 仓库」只认 origin，origin 为 GitLab、GitHub 是第二 remote 时恒红（#1566）。
- GitHub 房 20 处 `-F` 写法把纯数字 owner 类型推断成数字、GraphQL 变量错误没判解析失败、`env` 兜底文案不分原因（#1571）。
- 环境检查的探针开会话不带链求值定下的后端，只读会话拿不到后端（#1505）。
- 状态栏胶囊窄栏下先丢票号：目录先让位，编号尾巴始终完整（#1563）。
- npm 安装时被要求授权构建、失败提示点名无关的包（#1568）。
- 接手/补充两条提示词首行挂错技能，改回 `/triage`（#1577）。

### Added

- 新增 `deck_work_route` 工具：在办表从写回执里移出，按会话分组读取，缺省看近 24 小时、`includeStale: true` 看近 30 天；`workRouteDetail` 参数退役（#1561）。

### Changed

- `deck_issue_get` 缺省只回摘要与总数，整票正文用 `body: 'full'` 读、回执带 `data.body.digest`；改整段正文必须带上这个指纹（#1562）。

## [1.9.0-beta.26] - 2026-10-26

> 票号徽章的上限从 180px 收紧到 136px：长目录现在才会真的压成省略号，编号那截始终完整。测试版。

### Fixed

- 面板上的票号徽标（列表行、详情页头、地图头、在办表首列、状态栏胶囊单子）在长目录工作区里看不出省略效果：上限 180px 比最长的那批目录还宽，永远碰不到线。收到 136px 后目录段变省略号、编号保持完整，悬停仍给完整编号（#1511）。

## [1.9.0-beta.25] - 2026-10-26

> 工作路线里地图/规格行显示完整编号（`#目录/00`）并可点进容器详情；在办表列宽按内容自适应、每列设上限。测试版。

### Fixed

- 本地 Markdown 后端：面板与状态栏胶囊里的地图/规格行写完整编号，点 00 行进容器详情（#1553、#1550）。

### Changed

- 在办表首列按编号长度分档（56~192px）；标题列 150~320px、会话列 104~200px，到上限不再变宽，超出走省略号；浮层最小宽 680px（#1553）。

## [1.9.0-beta.24] - 2026-10-26

> 日志走 dsh-log 0.4.1 唯一实现（#1143）：宿主缺包时显式报错不再静默回退；横幅折叠默认收起。测试版，没有用户可见的新功能。

### Changed

- 旧日志三件套删除，十一扇日志门禁改测包内行为（#1143）。
- 没点过展开的工作区横幅默认收起，点过展开的继续记住。

## [1.9.0-beta.23] - 2026-10-26

> GitHub 通路止血：REST 备路超时放宽到 30 秒中央档；整仓列表一页 50 条并去掉列表用不到的评论字段，绕开对端约 3 秒掐大查询的线。测试版，没有用户可见的新功能。

### Fixed

- REST 备路不再被 12 秒读档砍断：新增中央键 `githubRestReadMs: 30000`，接到 GitHub 房全部 REST 出站口；主路读档不动。
- 列表查询瘦身：页大小 100 → 50（中央 `listPageSize`），`LIST_QUERY` 去评论字段（单票详情与评论翻页不受影响）；索引扫描与命名守护跟随契约。

## [1.9.0-beta.22] - 2026-10-26

> 这一版把工作区里两笔已完成的修复带上：markdown 读票时按被引文件补回引用标题（#1537），出站通路冷却按服务与读写档分开记、GitHub 故障不再挡住 GitLab 与本地 git（#1007 复核）。测试版，没有用户可见的新功能。

### Added

- 读票时被引用的其它票只有编号也能看到标题与状态：markdown 后端读票时按被引文件回填 `blockedBy` 的 title 与 state（#1537）。

### Fixed

- GitHub 出站失败后的冷却只挡 GitHub：冷却改为按「服务 + 读写档」各记一份，GitLab 与本地 git 不再被一起挡住；成功清零也只清本服务本桶（#1007 复核）。

## [1.9.0-beta.21] - 2026-10-26

> 这一版只修更新面板的一处误报：升级在安装途中被打断、之后从插件商店重装好同一版本，设置页仍一直显示「更新失败」。随 `dsh-plugin-update` 0.18.39 的失败结算判据带上（上游 #245），插件自身行为没有变化。

### Fixed

- 更新面板不再把「目标版本已经装好并在运行」的旧失败当成当前失败：面板、入口徽标与安装按钮改问同一个结算判据，失败记录只留一行中性历史，不再显示失败横幅、最后手段与为那次失败准备的手工命令（dsh-plugin-update #245）。
- 依赖 `dsh-plugin-update` 从 `^0.18.38` 升到 `^0.18.39`，客户端取值与入口面板按已安装包重新派生。

## [1.9.0-beta.20] - 2026-10-26

> 这一版修「GitHub 仓库因为分支名里带 gitlab 就被 GitLab 后端同时认领，登录状态一直停在暂时确认不了」的问题（#1533），并带上 #1434、#1187 与 #1007 的出站冷却修缮。

### Fixed

- 认领一个工作区只看 `.git/config` 里 `[remote ...]` 段的远端地址：分支名等其它文字不再构成认领依据，GitHub 仓库不会再被 GitLab 后端同时认领，读会话 multi-match 造成的登录状态黄条不再出现（#1533）。
- 写工作区文件成功后删掉老的 `docs/agents/workspace.json`；删不掉不影响写的成功，回执带 `legacyDeleted` 与警告（#1434）。
- GitLab 工作区的环境检查补上「glab 已登录」与「仓库可达」两条判定（#1187）。
- GitHub 出站失败后的冷却、排队段到点与迟到名额归还都按真实出站通道记，读写不再混用（#1007）。
- 面板先整体隐藏 effort 徽标：编号已经带目录，徽标里的目录名与它重复（`57338cac`）。
- 内部：时间参数门禁重新接回验证链，9 个散落的裸时间值收进中央配置、界面动画时长由门禁的样式表逐行登记（无用户可见行为变化）。

## [1.9.0-beta.19] - 2026-10-26

> 这一版把 AI 工具的额度判定改成只看服务端真实剩余（#1527），并带上主线已合入的建议气泡补出、面板表格渲染、技能详情页链接等改动。

### Added

- AI 工具回执在越过每小时提醒线时新增 `warnings`（`cost.warnings`）：说清已用多少点/条、提醒线在哪、服务端这一桶还剩多少（#1527）。
- 面板 Markdown 渲染器支持 GFM 表格，ISSUE 详情页的表格按表格显示（#1524）。
- 切回后台会话时，从历史事件重放里补出最后一组没上过屏的建议气泡（#1526）。

### Fixed

- AI 工具不再因为插件自设的每小时份额拒绝仍有余量的调用：准入只看「这一笔扣完会不会跌破服务端上限的 5% 保底」，读数未知时先放行（#1527）。
- 单次硬顶（600 点 / 400 条 / 60 张子票）的拒绝文案补上服务端这一桶还剩多少（#1527）。
- 技能详情页正文里的随包 md 文件名、双引号写出的技能名都能点开看原文（#1522 / #1520）。
- 本地 Markdown 环境检查拆成三项固定判据，预检与链上共用同一份实现，每项各留一条预检日志（#1513）。
- 建票一次写对：错模板拒建、阻塞边去井号、新建必带状态、一个目录只放一种容器（#1507 / #1509 / #1510）。

### Changed

- 每小时 AI 顶（2000 点 / 1500 条）从硬性拒绝降为提醒，越过提醒线照常执行（#1527）。
- 工作路线胶囊把规格容器也画成容器；面板上的票号带上目录（#1518 / #1511）。
- BUG 建单提示词升到 v15，先扫全 BUG 单查重、候选交报告人确认、正文固定写查重记录（#1461）。
- 随包技能的中文译文搬进独立目录，并加门禁保证 50 篇一篇不缺。

## [1.9.0-beta.18] - 2026-10-25

> 这一版把 #1418 的探测与按族准入修好（P1 与两轮复核整改），并带上主线已合入的本地 Markdown 后端原文布局迁移、关票原因入口等改动。

### Fixed

- 刷新探测不再按「客户端记住的每个工作区」全量扇出、每一拍全仓翻页：只探人正在看的那一个工作区；连续无变化时后台拍（60/60/120/300/600 秒）与面板开着时的活跃拍（5/5/10/25/50 秒）各自退避，有变化或人回到前台立刻回原节奏。GraphQL 份额不再被无产出烧穿（#1418）。
- 限流闸按「这次操作真正会出的通道（含前置读）」分族：建票两族都要（写 REST、建前锚回查 GraphQL），改票 / 标签 / 认领 / 关票 / 重开 / 父子边只看 GraphQL，评论与阻塞边两条路任一。一族见底不再停掉另一族能做的操作；见底文案写清缺的是哪种额度、还剩多少、约几点恢复（#1418）。
- deck 工具开会话前的预检按族逐个试，不再被一族见底误挡；预检失败时先给闸的人话，不再只回原因代号（#1418 复核）。
- 本地 Markdown 后端的票文件按随包技能原文布局落盘，一个目录只允许一份 `map.md`；旧布局、混合布局与重复编号票继续能读，读不懂的版本号留下 `bad-format` 降级日志（#1480 系列、#1486、#1487、#1488、#1499、#1500）。

### Changed

- 关票工具支持 `closeReason`：地图子票写进 Answer 段并在地图补决策指针，实施票追加成评论，旧布局写 Close reason 行（#1495）。
- 链快照跨会话共享缓存时，按当前会话重算沙箱相关判定，客户端在途去重按会话分键（#1492）。
- deck 工具的范围参数统一成 `effort` 与 `feature`（#1485）。
- `deck_issue_patch` 的工具定义拆成单独文件 `issue-patch-definition.ts`，`issue-patch.ts` 从 359 有效行降到 319（行为零变化），文件粒度门禁回到绿。

# Changelog

格式为 Keep-a-Changelog 子集：有新版时面板第 02 章更新日志自动展示本文件对应版本一节；缺文件或取不到时只给中性提示，安装不受影响。分类用 Added、Fixed、Changed、Security 必显展开，Deprecated、Removed 折叠，Unreleased 与空节忽略。

## [1.9.0-beta.17] - 2026-10-25

> 这一版把三组使用者能感觉到的改动一起发到 npm 官方源：本地账本不再把 GitHub GraphQL 调用记成 REST 请求（#1482）、改票关票之后面板不用等整份重建（#1472）、同一工作区多会话时链快照不再串沙箱判定（#1483），另补齐会话号转发（#1478）。

### Fixed

- 本地账本把 GraphQL 调用记成 REST 请求、把 rest 桶虚增到写保留线以下、进而把 deck 工具整体拒掉的问题修好：GraphQL 只记点数、按回包 `rateLimit.cost` 取真实成本（拿不到时按 1 点估并在日志里标 `estimate`），REST 才记请求条数；`gh.exec` 日志新增 `points` 与 `pointSource` 两格，能直接看出每笔记账是真实成本还是估算。
- 改票、关票之后面板要等兜底探测才刷新、连做多次写只刷新第一次的问题修好：写事件补取数做成真的（点名补行每次写都补、扫描类取数仍按 10 秒合并），下一次探针直接交回补丁。
- 同一个工作区开着两个会话时，链快照会把一个会话量出的沙箱判定（能不能写临时目录）当成另一个会话的答案；现在宿主按当前会话重算这几项，客户端跨会话命中先秒显再补问。
- 客户端第二个 `wf.chain` 调用点补上会话号，多会话时不再按错会话的沙箱许可判断（#1478）。

### Changed

- 写后刷新的取数失败统一走同一个出口（`refresh.patch` 记真实原因），失败原文里的绝对路径整段换成 `<path>`，不把工作区路径写进日志。
- 删掉 `deltaRefresh` 上生产入口从来不传的 `openSession` 守卫——它让行级增量在真机上恒回 `no-transport`。

## [1.9.0-beta.16] - 2026-10-24

> 这一版把四组改动一起发到 npm 官方源：布局答案只剩工作区文件一处真源（#1449）、刷新探测修好并把失败说出来（#1418）、deck 工具 `map-plan-create` 的边方向写清（#1421）、面板与状态栏胶囊共用取数时刻并带上两处体验修正（#1440、#1471、#1467）。

### Fixed

- 刷新后台的探测被 GitHub 单页条数上限整页拒绝、失败又只在日志里留一个散列的问题修好：翻页条数夹到 100、索引扫描带 `since` 增量窗口、被拒时自动降档重发并记 `read.degraded`；探测失败会在面板上如实显示原因，成功即撤。
- `deck_map_plan_create` 的 `edges` 方向写反问题：参数说明与回执都写清「谁把关系写进谁、朝哪边」；`type` 写成不认识的值以前会静默按阻塞边处理，现在整批拒写、一张票都不动（`deck_map_link` 同口径）。
- 面板与状态栏胶囊取数时刻不一致、304 快照回包缺工作区根的问题修好：两处改用同一个取数时刻并共用新鲜度配色，胶囊悬停能看到这个时刻。

### Changed

- 布局答案（初始化小卡问的「共用一套用语，还是各有各的用语？」）从此只存工作区文件（`docs/agents/workspace.yaml`）：换机器、换浏览器打开同一个仓库都不用重答；写不进去时界面如实提示「没有写入权限」，不再偷偷记在本机。旧的宿主 `choices.json` 与浏览器本地记录不再被读取，也不会被物理删除。
- 建议气泡浮层底色单独一档（深色更轻更透、浅色更白）；推荐下一步的提醒改成「回复前最后一步」的判断口径。

## [1.9.0-beta.15] - 2026-10-24

> `1.9.0-beta.14` 只打过 git 标签、没有发到 npm（发版前发现门禁归属表没跟着更新）；本版按干净工作树重生成归属表后发布，对使用者来说两版内容相同。

### Fixed

- 顶部「登录状态暂时确认不了 — 点右侧重试」的黄条点多少次「重新检查」都不会消失的问题修好：检查链求值环境时现在会把会话交来的完整操作上下文带进房间，登录状态与仓库可达两项不再永远停在「暂时确认不了」，环境回到 10/10，黄条在全部确认后消失。

### Changed

- 内部构建锁整理（缓存命中不再拿锁、接管即停、超时与释放补齐日志），对使用者没有可见变化。
- 建议气泡按会话保留：切到别的会话再切回来，之前还没点走的建议不会消失（只在内存里留最近 32 组，不落盘，也不碰会话保活接口）。
- 悬停浮层里的评分泡改贴理由第一行开头，理由折行后从评分正下方接着排，一眼看得出「多优先」和「为什么建议」是同一条信息。

## [1.9.0-beta.13] - 2026-10-24

### Added

- 下一步建议可以排优先级：`suggest_next_steps` 每条建议可选 `priority`（0 到 10 分），界面按分从高到低往左排，没打分的排最后。
- 理由浮层里先显示推荐分数、再显示理由；选项框与浮层加了磨砂底。
- 下一步建议优先从技能角度给：工具说明、参数与 `/ask-matt` 规则统一要求提示词开头写 `/xxxx` 技能。

### Changed

- 下一步建议气泡的锚点从状态胶囊改为跟输入框走，输入框高度变化时自动重新量位置。

### Fixed

- 登录状态黄条在环境检查还有一步没确认时误显示成 8/8 全绿、点「重新检查」没有反应的问题修好。
- 点开票详情报 `repo.refId missing`、只剩短名读不到票面的问题修好；详情与评论的读路径改用只读会话补好的仓库引用。

## [1.7.43] - 2026-10-06

### Added

- 版本管理页新增更新按钮：只取回远端跟踪引用，不合并，不碰工作树；成功后自动重读，身份行领先与落后即为本次更新后的数量。

### Changed

- 构建默认不再同步已装插件目录，新版本只由人自己升级。
