chore: rebuild release package

.planning/sidebar-collapse-hover/findings.md

@@ -0,0 +1,44 @@
+# 调研记录
+
+## 用户需求
+
+- 顶部标题旁放置左侧菜单收起/展开按钮。
+- 固定收起后仍保留一条窄侧边触发区。
+- 鼠标移入触发区时侧栏以悬浮层临时展开，鼠标移出后自动收回。
+- 先完成通用功能，再兼容现有主题。
+
+## 视觉输入
+
+- 参考截图：`sessions/_attachments/1c730846-9ff5-4b5e-a522-afdd2c5aa9e0.png`。
+- 截图显示标题位于主内容顶栏左侧，左侧菜单与主内容之间有明确竖向边界。
+- 本任务不新增主题和图片资产，截图仅用于按钮位置与侧栏层级参考。
+
+## 工程基线
+
+- `codebase-memory-mcp` 项目 `home-cc-web` 索引状态为 `ready`，节点 3883、边 8420。
+- 任务开始时 `git status --short` 无输出，工作树干净。
+- 主题技能要求共享功能与主题专属视觉分层，并在真实浏览器覆盖动态状态和多视口。
+- Trellis 开发者为 `shiyue`；当前 Trellis 任务仍是既有的 `07-17-gilded-wasteland-theme`，按工作流规则不覆盖当前任务指针。
+
+## 初步代码定位
+
+- `public/app.js` 已有 `openSidebar()` / `closeSidebar()` 和触屏滑动逻辑，现状服务于移动端 `.open` 状态。
+- `scripts/regression.js` 的现有主题契约包含 `gilded`、`wasteland` 等侧栏断言，新增共享交互需避免破坏这些移动端规则。
+- 无障碍要求：顶部按钮需提供可访问名称、`aria-expanded`、原生键盘激活与可见焦点；窄触发条不进入 Tab 顺序。
+- `public/index.html` 已有 `#menu-btn`，位置正好在 `#chat-title` 之前；无需新增第二个按钮。
+- `#menu-btn` 当前只在 `max-width: 768px` 显示并切换 `.sidebar.open`，桌面端可复用同一按钮切换新的 `.app.sidebar-collapsed` 固定状态。
+- 桌面收起可通过“完整宽度侧栏 + 负右外边距 + translateX”仅占用窄轨道宽度；hover 时只恢复 transform，因布局占位不变，不会推动正文。
+- 主题侧栏宽度统一来自 `--sidebar-width`，包括暗金荒野的 316px；共享几何规则应继续引用变量，主题只需补触发轨颜色/阴影。
+- 通用浅色主题直接继承各自的 `--bg-secondary` / `--border-color` / `--accent`；暗色主题统一提高悬浮层阴影，`gilded` 与 `wasteland` 分别补暖铜和暗金触发轨，避免共享轨道破坏主题质感。
+
+## 浏览器证据
+
+- Firefox 152（headless + geckodriver）在 1440 桌面精细指针下：展开侧栏宽 280px、正文起点 x=280；固定收起后侧栏范围 x=-266..14、正文起点 x=14；hover 后侧栏恢复 x=0..280，正文仍保持 x=14；移出与刷新后均恢复固定收起。
+- 按钮桌面状态从 `aria-expanded=true / 收起左侧菜单` 正确切到 `false / 固定展开左侧菜单`；缓存资源实际加载 `20260718-sidebar-collapse-1`。
+- `wasteland` 1672 视口截图确认 316px 暗金侧栏悬浮完整展开并覆盖正文而不推动正文；`washi` 收起/悬浮截图确认轨道和层级正常。
+- 500px 窄屏下沿用移动抽屉：关闭时侧栏位于视口外，打开后 `aria-expanded=true` 且遮罩显示，点击侧栏外坐标后关闭；横向溢出均为 0。
+- Firefox headless 普通窗口接口的内容区最小宽度为 500px，下一轮使用 WebDriver BiDi `setViewport` 补测精确 390px。
+- WebDriver BiDi 稳态验收覆盖全部 11 个现有主题：10 个主题侧栏宽 280px，`wasteland` 为 316px；每个主题收起右边界均为 x=14、hover 左边界均为 x=0、正文起点保持 x=14、横向溢出为 0。
+- 键盘 `:focus-within` 在 1440×900 下完整展开侧栏而不改变固定状态；精确 1672×941、500×844、390×844 均通过。
+- 宽屏无 hover / 无精细指针的真实浏览器边界：即使本地持久化值为收起，侧栏仍完整显示，按钮隐藏且 `aria-expanded=true`，视觉与无障碍状态一致。
+- 独立终审在媒体状态机修订后通过，未发现剩余中高风险问题。

.planning/sidebar-collapse-hover/progress.md

@@ -0,0 +1,19 @@
+# 进度日志
+
+- 2026-07-18：确认交互语义，读取仓库、Trellis、计划跟踪及主题架构规范。
+- 2026-07-18：确认代码索引可用且工作树干净，建立持久化计划。
+- 2026-07-18：独立计划审查补充无障碍要求后通过；完成侧栏、顶栏按钮、移动端抽屉和主题覆盖入口定位。
+- 2026-07-18：复用标题旁现有菜单按钮实现桌面固定状态、本地持久化、移动端原行为与动态无障碍状态；JS 语法检查通过。
+- 2026-07-18：加入 14px 窄触发轨、hover/focus-within 临时展开和 reduced-motion 降级；共享交互层置于全部主题样式之后。
+- 2026-07-18：补齐浅色/暗色语义适配、gilded 暖铜轨、wasteland 暗金轨，并更新 CSS/JS cache bust；移动端规则保持隔离。
+- 2026-07-18：新增 sidebar-collapse 专项回归目标，覆盖 DOM、无障碍、持久化、响应式分支、轨道交互、主题隔离与 cache bust；专项回归通过。
+- 2026-07-18：旧主题首轮回归暴露 cache-bust 断言未同步，已更新 gilded/wasteland 契约，待重跑。
+- 2026-07-18：第二轮回归补齐共享暗色选择器中的 gilded，再保留其后置暖色阴影覆盖。
+- 2026-07-18：第三轮统一验证通过：app/regression 语法、sidebar-collapse、gilded-theme、wasteland-theme、全量 regression、git diff --check。
+- 2026-07-18：Firefox headless 首轮因默认无精细指针而无法进入桌面交互分支，未产生产品侧失败结论；准备使用显式桌面指针能力重测。
+- 2026-07-18：Firefox 第二轮已执行主要桌面/主题/移动状态，最终遮罩关闭因 WebDriver 中心点落在侧栏下被拦截；改用侧栏外坐标重测。
+- 2026-07-18：Firefox 第三轮完成 washi 1440 展开/收起/hover/移出/刷新持久化、wasteland 1672 主题悬浮、gilded/wasteland 500 窄屏抽屉与遮罩关闭；截图已人工复核，横向溢出为 0。
+- 2026-07-18：独立终审要求收敛 JS/CSS 媒体状态机；已拆分移动抽屉与桌面可收起模式，并明确 aria-expanded 只表达固定/抽屉状态，临时预览不修改它。
+- 2026-07-18：媒体状态机修订后的首轮专项回归因旧函数名正则失败，已同步测试契约。
+- 2026-07-18：修订后再次通过语法、sidebar-collapse、gilded-theme、wasteland-theme、全量 regression 与 git diff --check。
+- 2026-07-18：Firefox BiDi 最终验收通过全部 11 个主题、键盘 focus、1672/1440/500/390 视口、移动遮罩关闭及 wide-no-hover 边界；独立终审通过，任务完成。

.planning/sidebar-collapse-hover/task_plan.md

@@ -0,0 +1,37 @@
+# 左侧菜单收起与悬浮展开
+
+## 目标
+
+在不改变现有会话业务逻辑的前提下，为桌面端左侧菜单增加固定收起/展开按钮；收起后保留窄触发条，鼠标移入临时悬浮展开，移出恢复收起，并兼容所有现有主题。
+
+## 阶段
+
+1. **COMPLETE** — 建立基线并定位侧栏、标题栏与主题入口
+2. **COMPLETE** — 实现固定收起状态与顶部标题旁按钮
+3. **COMPLETE** — 实现窄触发条和移入悬浮展开、移出收回
+4. **COMPLETE** — 补齐现有主题及桌面/窄屏样式兼容
+5. **COMPLETE** — 增加侧栏交互、无障碍与主题契约回归测试
+6. **COMPLETE** — 执行语法、专项回归和全量相关测试
+7. **COMPLETE** — 使用真实浏览器验收多主题与关键交互状态
+
+## 关键决策
+
+- 固定状态和悬浮预览状态分离，悬浮不修改用户固定选择。
+- 功能层使用共享 DOM/JS/CSS，主题层只覆盖语义变量或受主题 ID 限定的视觉声明。
+- 移动端沿用现有响应式侧栏逻辑，避免桌面悬浮规则破坏触屏操作。
+- 顶部按钮提供可访问名称、`aria-expanded`、键盘原生激活与可见焦点；悬浮触发条不进入 Tab 顺序，避免 hover-only 交互阻断键盘用户。
+
+## 错误记录
+
+- 第一次把共享侧栏交互层移动到 CSS 文件末尾时，补丁上下文误用了相邻的暗金主题选择器，未命中且未产生文件改动；随后按精确边界重新移动。
+- 首轮旧主题专项回归因 `gilded` / `wasteland` 契约仍断言旧 cache-bust URL 而失败；同步更新为本次版本后重跑。
+- 第二轮 `wasteland` 回归识别到新增共享暗色 `:is(...)` 未列出 `gilded`，违反既有“共享暗色选择器包含全部暗色主题”契约；已纳入后再由专属变量覆盖暖色阴影。
+- 首轮 Firefox headless 验收会话默认报告无精细指针，桌面按钮按媒体查询隐藏并导致 WebDriver 点击失败；改为在桌面验收会话显式模拟 `fine + hover` 指针能力。
+- 第二轮 Firefox 已完成主要状态测量，但 WebDriver 点击移动遮罩时选择了被侧栏覆盖的元素中心点并被拦截；改用侧栏外 `x=350` 的真实指针点击验证关闭。
+- 独立终审发现 JS 的移动输入判断与桌面收起 CSS 能力条件不完全一致，宽屏无 hover 设备可能出现视觉与 aria 状态不一致；拆分 drawer / desktop-collapse 媒体对象并与 CSS 对齐。
+- 状态机修订后首轮 sidebar-collapse 回归仍匹配旧 `isMobileInputMode()` 函数名而失败；断言同步为 drawer → desktop-collapse 两分支顺序后重跑。
+
+## 完成结论
+
+- 7 个阶段全部完成；独立终审复核通过。
+- 无新增主题、资产或远程运行时依赖；所有现有主题共用功能层，富视觉主题仅覆盖轨道视觉。

.planning/wasteland-narrow-position-tuning/findings.md

@@ -0,0 +1,10 @@
+# 调研记录
+
+- 当前 721–1100px 与 ≤720px 最终值均为 90% 50%。
+- 用户实机反馈 90% 仍“有点太靠左”，需要小幅降低百分比，让背景图向右回移。
+- 85% 位于已验收的 82% 与 90% 候选之间，属于小步微调，避免退回旧 70% 的偏右构图。
+- 两个窄屏区间已同步为 85% 50%，cache bust 更新为 `20260718-wasteland-bg-right-3`，回归契约同步锁定最终高保真层。
+- 用户在 85% 浏览器验收前明确指定“75% 试试”；跳过 85% 的无效视觉验收，两个窄屏区间直接改为 75% 50%，cache bust 推进到 `20260718-wasteland-bg-right-4`。
+- Firefox 实际 CSS 验收：1101px 保持桌面居中；1100/1022/721/720/590/390px 均命中 75% 50%，断点连续且横向溢出为 0。
+- 75% 相比 90% 让骑士明显向右回移；390px 主体位于中右区域，590px 法杖圆环更接近右侧裁切线，符合本轮明确的向右调整要求。
+- 独立终审确认 75% 最终层叠、cache right-4、回归契约与上一轮侧栏功能均无阻断问题。

.planning/wasteland-narrow-position-tuning/progress.md

@@ -0,0 +1,11 @@
+# 进度日志
+
+- 2026-07-18：收到 90% 仍偏左的反馈，建立 85% 微调计划。
+- 2026-07-18：独立计划审查批准；确认两个窄屏区间、回归和 cache bust 当前均为 90% / right-2。
+- 2026-07-18：实现 90%→85%，同步两个窄屏区间、cache right-3 与全部相关回归断言。
+- 2026-07-18：用户指定改试 75%；在 85% 浏览器验收前直接切换到 75%，同步 cache right-4 与回归。
+- 2026-07-18：75% 版本 wasteland/sidebar 专项与 diff check 通过，进入真实浏览器与全量回归。
+- 2026-07-18：Firefox BiDi 完成 1101/1100/1022/721/720/590/390px 验收，computed position 为预期 75%，截图人工复核通过。
+- 2026-07-18：首轮最终全量回归断言通过但在 60 秒边界退出 124，进入拆分重跑。
+- 2026-07-18：拆分重跑后全量回归和 diff check 正常退出 0；工程与浏览器验收完成。
+- 2026-07-18：75% 最终独立复审通过，任务完成。

.planning/wasteland-narrow-position-tuning/task_plan.md

@@ -0,0 +1,27 @@
+# 暗金窄屏背景位置二次微调
+
+## 目标
+
+根据用户最新反馈把暗金荒野窄屏背景最终调整为 75%，让骑士进一步向右移动；同步两个窄屏区间、缓存与回归。
+
+## 阶段
+
+1. **COMPLETE** — 确认用户反馈与当前 90% 基线
+2. **COMPLETE** — 调整为 75% 并同步缓存与回归契约
+3. **COMPLETE** — 执行专项全量测试与多窄屏浏览器验收
+4. **COMPLETE** — 完成独立复审并清理临时跟踪文件
+
+## 完成结论
+
+- 最终采用用户指定的 75% 50%。
+- 两个窄屏区间、缓存、回归、浏览器验收和独立复审均已完成。
+
+## 范围
+
+- 只改 `wasteland` 高保真窄屏 `body background-position`、cache bust 和对应回归。
+- 不修改背景资产、DOM、消息布局、侧栏功能或其他主题。
+
+## 错误记录
+
+- 同步计划文案时首次补丁未包含 CSV 的实际时间戳列而未命中；源码未受影响，随后按完整行精确更新。
+- 首轮最终全量回归已输出 `Regression checks passed`，但进程在 60 秒边界退出 124，后续 diff check 未执行；拆开命令后重跑。

.planning/wasteland-narrow-right-focus/findings.md

@@ -0,0 +1,44 @@
+# 调研记录
+
+## 用户输入
+
+- 目标主题：`wasteland`（暗金荒野）。
+- 目标状态：窄屏。
+- 目标方向：优先显示背景图右侧，而不是当前偏左裁切。
+- 参考截图：`sessions/_attachments/ebfd9a2e-e73e-425a-87da-fe79b17964ec.png`、`sessions/_attachments/c8ab2b98-5543-4a99-8cf1-b4e14eafff45.png`。
+
+## 资产角色
+
+- 现有运行时背景：`public/assets/themes/wasteland/background.webp`，保持原文件不变。
+- 两张会话附件仅作视觉对照，不进入 `public/`，本任务无派生资产。
+
+## 代码与视觉基线
+
+- 背景源为 1672×941 WebP，SHA-256：`ee52b136294a7a31181b67e209253fefe7ace8c2b76885e45621484fecb802cb`。
+- 最终高保真组件层在 `public/style.css` 文件后部再次声明 `html[data-theme='wasteland'] body`，因此早期同名规则不是最终修改点。
+- 当前只有 `max-width: 720px` 使用 `background-position: center, center, 70% 50%`；约 1022px 的用户截图未命中该断点，仍使用桌面 `center`，导致可见区域偏向源图中部。
+- 第一张截图表现为右侧窄条只露出骑士局部；第二张截图是目标构图：可见区域覆盖源图右半部，骑士落在可见区域左侧，右侧圆环与留白同时保留。
+- 初步判断应优先把既有 70% 右侧聚焦扩展到更宽的窄屏区间，而不是修改背景资产或消息层。
+- 现有 `wasteland-theme` 回归在 `scripts/regression.js` 中明确断言 720px / 70%，新增断点或调整数值必须同步契约。
+- 工作树已有上一轮侧栏功能的 `app.js` / `index.html` / `style.css` / `regression.js` 未提交改动；本任务只追加背景定位相关最小差异。
+
+## 候选裁切对比（590×767）
+
+- 50%：骑士大部分被裁到右侧边缘，左侧暗空区过多，不符合“显示右边”。
+- 70%：骑士主体进入画面，但仍偏右，右侧圆环与法杖显示不足。
+- 82%：骑士与圆环都进入画面，构图开始接近第二张参考图。
+- 90%：源图右侧区域更完整，骑士向左移动、右侧圆环基本完整，方向符合需求。
+- 下一步补测 100%（`right center`），在 90% 与 100% 中选择不会让骑士过度贴左的最终值。
+- 子代理核对确认：最终桌面规则位于高保真层，721–1100px 当前无专属定位；现有回归可能匹配早期旧规则产生假阳性，必须收窄到高保真层最终规则。
+- 100% / `right center` 最接近第二张参考图：骑士进入左半，法杖与右侧圆环完整保留，右侧区域表达最明确；选为最终值。
+- 断点策略：新增 721–1100px 右侧聚焦以覆盖用户约 1022px 的截图，同时把现有 ≤720px 最终规则从 70% 收敛为 `right center`，保证窄屏连续。
+- 用户实机反馈 `right center` 让主体“有点太靠左”；最终回调为 90% 50%，在原 70% 与 100% 之间保留右侧圆环，同时让骑士回到更自然的位置。
+
+## 最终浏览器验收
+
+- Firefox 152 + WebDriver BiDi 使用实际 CSS（无内联覆盖）验证：1101px 保持桌面 `50% 50%`；1100、1022、721、720、590、390px 均为第三层 `90% 50%`。
+- 721→720 两侧 computed position 一致，没有断点跳位；所有视口横向溢出为 0。
+- 1022×844：骑士位于中右区域，右侧圆环完整进入画面；590×767：骑士相较 100% 明显向右回移；390×844：主体靠左但未贴边，右侧法杖与圆环仍保留。
+- 浏览器实际加载 `style.css?v=20260718-wasteland-bg-right-2` / `app.js?v=20260718-wasteland-bg-right-2`，CSS 与背景 WebP 请求均为 HTTP 200。
+- 本任务未创建新主题、未改 DOM、未改资产；验收清单中的新主题注册、派生资产、动态组件状态均不适用，相关既有主题专项与全量回归用于确认未回归。
+- 独立终审确认最终层叠、主题隔离、cache bust、回归契约和上一轮侧栏功能均无阻断问题。

.planning/wasteland-narrow-right-focus/progress.md

@@ -0,0 +1,13 @@
+# 进度日志
+
+- 2026-07-18：确认只调整暗金主题窄屏背景裁切，建立持久化计划。
+- 2026-07-18：计划经独立审查批准；本地定位最终 720px / 70% 规则与回归断言，确认背景源尺寸/hash，开始浏览器候选对比。
+- 2026-07-18：Firefox BiDi 在 590×767 对比 50/70/82/90%，90% 最符合右侧聚焦方向；继续补测 100% 后定稿。
+- 2026-07-18：补测 100% 后确认 `right center` 最接近第二张参考图，进入主题隔离实现。
+- 2026-07-18：在高保真主题层新增 721–1100px 右侧聚焦，并把 ≤720px 最终规则改为 `right center`；CSS/JS cache bust 更新为 `20260718-wasteland-bg-right-1`。
+- 2026-07-18：回归收窄到最终高保真层，锁定两个窄屏区间的 `right center` 与新 cache bust；wasteland/sidebar/gilded 三个专项通过。
+- 2026-07-18：首轮全量回归因 60 秒超时退出 124，无断言失败输出，进入环境诊断与替代入口重跑。
+- 2026-07-18：直接 Node 入口全量回归在 60 秒内通过；语法、三个专项、全量回归与 diff check 均通过。
+- 2026-07-18：根据用户实机反馈将 100% 回调到 90%，同步两个窄屏区间、回归断言与 cache bust `20260718-wasteland-bg-right-2`，重新进入验证。
+- 2026-07-18：最终 Firefox 验收覆盖 1101/1100/1022/721/720/590/390px，90% 右侧聚焦连续且无溢出；最终全量回归再次通过，等待独立复审。
+- 2026-07-18：独立复审通过；任务完成，准备清理临时 TODO CSV。

.planning/wasteland-narrow-right-focus/task_plan.md

@@ -0,0 +1,30 @@
+# 暗金主题窄屏背景右侧聚焦
+
+## 目标
+
+仅调整 `wasteland` 暗金荒野主题在窄屏下的背景图横向裁切，让源图右侧区域优先进入视口，达到用户第二张参考图的构图倾向；不改消息、侧栏或其他主题。
+
+## 阶段
+
+1. **COMPLETE** — 建立脏工作树基线并定位窄屏背景规则
+2. **COMPLETE** — 用真实浏览器对比候选背景定位值
+3. **COMPLETE** — 实现暗金主题窄屏右侧聚焦并更新缓存版本
+4. **COMPLETE** — 补充窄屏背景定位回归契约
+5. **COMPLETE** — 执行主题专项、全量回归与静态检查
+6. **COMPLETE** — 完成多窄屏真实浏览器视觉验收与独立复审
+
+## 范围边界
+
+- 只修改 `html[data-theme='wasteland'] body` 的窄屏 `background-position` 及对应 cache bust / 回归。
+- 参考截图只用于构图对照，不作为运行时资产；不复制、不裁切、不修改现有背景源图。
+- 保留当前工作树中上一轮侧栏功能的未提交改动，不覆盖或重排无关区块。
+
+## 完成结论
+
+- 用户反馈 100% 太靠左后，最终采用 90% 50%。
+- 6 个阶段全部完成，独立终审通过；未新增或修改背景资产。
+
+## 错误记录
+
+- `codebase-memory-mcp` 本轮调用返回 `Transport closed`；按仓库降级规则使用本地 `rg` / `sed` 完成定位。
+- 首轮 `npm run regression` 在 60 秒门禁处退出 124，专项均已通过且未输出断言失败；检查残留进程后改用直接 Node 入口重跑。