docs(plan): INT-3 integration record and changelog

Co-Authored-By: Claude Opus 5.5 <[email protected]>

CHANGELOG.md

@@ -4,6 +4,25 @@
 
 ## [Unreleased]
 
+### 新增
+- 媒体详情页对照 MP:季 / 集列表、每集标题 / 简介 / 播出日 / 剧照,作品库与 TMDB 预览共用;标题 / 简介按设置 `metadata.languages` 回退(缺省 zh-CN → zh-SG → zh-TW → zh-HK → en-US),另存中文名;`POST /media-entities/{id}/refresh?full=1` 拉全部季的每集信息(MD-1)。
+- 新建档(订阅建档、搜索 / TMDB 预览页建档、整理向导、手动指定未登记的 TMDB 身份)当场按语言链取标题 / 简介,并自动入队一次 full 刷新(INT-3)。
+- 存储预算与保留:`settings.storage`(PG / 图片 / 备份 / 会话证据预算,各类流水保留天数,缓存有效期)、定时清理任务、`GET /system/storage` 与健康页存储等级,图片缓存按容量 LRU;设置页「自动化 → 存储与保留」可改(CACHE-2 / INT-3)。
+- 计划页从任务页拆出:自动任务紧凑列表 + Agent 巡检卡片;`GET /schedules` 给每个巡检带最近 100 次会话的费用与模型汇总(FE-6 / INT-3)。
+
+### 变更
+- `cache.tmdbMaxSize` 缺省 256 → 5000,迁移 0051 把仍是旧缺省的已存设置一并调整;`cache.tmdbTtlHours`、`cache.emptyResultTtlSec`、`identity.poolArchiveDays` 弃用,设置页不再显示(由 `storage.cacheTtl` / `storage.retentionDays` 取代)(CACHE-2 / INT-3)。
+- 设置页布局:分区标题层级、标签左 / 控件右的表单行、每块独立保存条、吸顶导航与锚点定位(FE-7)。
+- 部署:postgres 内存参数与容器内存上限(CACHE-2)。
+
+### 修复(BR-3 浏览器服务重启后自愈)
+- camofox 重启后会话操作遇到 404 / 410 自动重连:重新注入账号 Cookie、新开标签页回到原地址并重试一次;失败返回 503 `browser_reconnect_failed`。`POST /browser/sessions/{id}/reconnect` 幂等。
+- 桌面模式打开时先确认会话;画面 5 秒未出图自动重连一次(INT-3)。
+
+### 修复(HH-2 憨憨 RSS 与详情页)
+- RSS 标题「[分类]名称[副标题][大小][上传者]」在站点适配层拆开;旧 RSS 行按需重新规范化;详情页补全豆瓣信息、截图、MediaInfo 里的 IMDb / TMDB、上传时间与文件清单。
+- 原站视图空闲时显示「自动化」,最近有自动化操作才显示「Agent」。
+
 ### 修复(ID-2 身份匹配对照 MoviePilot)
 - 憨憨 RSS 标题的分类前缀「[电视剧]」「[动漫]」「[音乐]」被当成中文名,经别名召回把多部剧的资源并入同一部作品;分类词、单字、停用词不再作为片名或别名参与比对,自动绑定也不再登记它们。存量用 `scripts/identity-reevaluate.ts --rollback-wrong` 撤销(缺省只读)。
 - 副标题与 RSS 内嵌描述里的中文名、别名参与匹配;中英名任一精确 + 年份精确即高证据,续作 / 章节序号与季号参与区分,同级多候选按年份精确、命中的名称文字种数取舍;评分权重成表可覆盖。

docs/plan/08-v0.2-closeout.md

@@ -112,3 +112,49 @@ v0.2 收尾阶段四个子代理(憨憨修复、AGUI-2、BR-2、SEARCH-2 / META-
 
 - 真实憨憨详情页核对(见上)与用户栈重建(0046–0049 迁移)待用户执行。
 - 开发库残留的 `hhclub-wt` 临时 worktree(`ac47867`,在会话 scratchpad 下)未删,不影响仓库。
+
+## INT-3 记录(2026-09-29)
+
+BR-3 已先行合并(`80f0fa0`)。本轮把六个 worktree 分支依次 `git merge --no-edit` 到 main,再补集成清单。
+
+### 合并顺序与冲突
+
+| 顺序 | 分支 | 合并提交 | 冲突与解决 |
+| --- | --- | --- | --- |
+| 1 | `cache2`(CACHE-2) | `eb9cfaa` | 无 |
+| 2 | `md1`(MD-1) | `b633eb5` | `contracts/settings.ts` 元数据分区字段表:保留 md1 新增的 `metadata.languages`,去掉 md1 带回的已弃用 `cache.tmdbTtlHours` |
+| 3 | `id2`(ID-2) | `f30600e` | `adapters/tmdb/index.ts`:md1 的 `details` / `translations` 与 id2 的 `recall` 导出并存 |
+| 4 | `hh2`(HH-2) | `f41cd96` | 基于 BR-3 之前的 main,和 BR-3 在 `browser/service.ts`、`contracts/browser.ts`、`desktop-view.tsx`、`site-origin-view.tsx` 冲突:`RecoveryState` / 会话视图同时保留 BR-3 的 `needsReconnect` / `reconnect` 与 HH-2 的 `lastAutomationAt`;前端 import 用 HH-2 的 `controllerLabel` / `agentActive`,保留 BR-3 的 `reconnect.tsx` |
+| 5 | `fe-settings`(FE-7) | `161e6e7` | 无 |
+| 6 | `fe6`(FE-6) | `4d850c1` | 无 |
+
+合并后 typecheck 直接通过,没有语义冲突。`deno.lock` 在根 `deno check` 与 web typecheck 之间会来回变(web 依赖是否写入),`0a8bfbb` 按 web 版本提交。
+
+### 迁移
+
+只有 cache2 带迁移(0050),其余分支没有迁移,不需要重排编号。集成补丁新增 0051、0052。开发库(55433)依次执行,`gen:types` 已更新。
+
+| 迁移 | 来源 | 内容 |
+| --- | --- | --- |
+| `0050_storage_retention` | CACHE-2 | 存储预算 / 保留相关表与索引 |
+| `0051_tmdb_cache_size` | INT-3 `fe05138` | 已存设置里 `cache.tmdbMaxSize` 仍是旧缺省 256 的改成 5000(用户库当前是 256) |
+| `0052_agent_run_created_by` | INT-3 `e681fce` | `agent_run (created_by, created_at desc)` 索引,供巡检汇总 |
+
+### 清单完成状态
+
+- [x] `cache.tmdbMaxSize` 缺省 5000(含已存值迁移,runbook / porting 文档同步)。
+- [x] 设置页「自动化 → 存储与保留」接 `settings.storage`:存储预算、流水数据保留、缓存有效期三张卡;元数据分区去掉 `cache.tmdbTtlHours`、`cache.emptyResultTtlSec`、`identity.poolArchiveDays`。
+- [x] 新建档立即应用语言回退链并入队 full 刷新:`/files/entity-from-candidate`(订阅建档、搜索 / TMDB 预览建档、整理向导)与手动指定未登记的 TMDB 身份;幂等键 `refreshMetadata:created:{id}`。RSS 自动识别新建的作品不入队 full(量大),仍按追踪刷新。
+- [x] 桌面模式打开时先调幂等 `POST /browser/sessions/{id}/reconnect`;画面 5 秒未加载或视频流未出帧,每个会话自动重连一次并重建桌面连接。
+- [x] `GET /schedules` 的 agent_check 项带 `agentRuns`(最近 100 次会话的上次 / 平均费用、近 7 天次数与费用、模型分布、最近 3 次),计划页卡片与首页计划带改用它,删掉前端的会话列表拉取。
+- [x] HH-2 用例 `rss-normalize` 的旧 RSS 行首见时间取"现在",会排在下一个用例的快照前面,第 1 次 ci 失败;固定首见时间后通过(`53790cb`)。
+
+### ID-2 回滚脚本 dry-run(用户库,只读)
+
+连接加 `default_transaction_read_only=on`,不带 `--apply`:
+
+- 待识别合并事项 1 条(Archives S01 2009),预估 0/1 可自动确认。
+- 3 个分类词站点别名涉及 3 部作品:「东北有个周东北(2026)」绑定 35 条,误并入 29 条(Irreplaceable / 无可替代、Spring of the Blade、A Prophet、Spark of the Long March / 星火征途 的各版本),要删别名「电视剧」「Spark of the Long March」「Irreplaceable」「A Prophet」「Spring of the Blade」;「炼气十万年」删「动漫」、「心动的信号」删「综艺」,这两部绑定都核对通过。
+- 合计解除 29 条资源绑定、删除 7 个站点别名;这些作品下 15 个内容单元无资源引用(脚本不删)。
+
+`--apply` 待用户确认,且要在用户栈重建(新识别规则 + 0050–0052 迁移)之后执行,解除的资源才会按新规则复查。