docs(changelog): 0.2.0 adds W9 and front-end wave features, fixes and known limits

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

CHANGELOG.md

@@ -4,7 +4,7 @@
 
 ## [0.2.0] - 2026-09-28
 
-Agent 上游全覆盖与订阅登录、控制台信息架构重排、定时任务看板、全站文案第二轮审校。基线见 `docs/plan/08-v0.2-closeout.md`(W8-A)、`docs/design/{console-ia,pi-providers,agent-ui-reference}.md`、`docs/runbook/{schedules,agent}.md`。
+Agent 上游全覆盖与订阅登录、控制台信息架构重排、定时任务看板、全站文案第二轮审校;W9 与前端波补上站点中心、订阅重做、统一规则、命名模板、全局搜索、文件管理 v2 与统一任务页。基线见 `docs/plan/08-v0.2-closeout.md`(W8-A 与"W10 集成记录")、`docs/plan/09-visual-qa.md`、`docs/design/{console-ia,site-center,subscriptions,naming-template,file-manager-v2,pi-providers,agent-ui-reference}.md`、`docs/runbook/{schedules,agent,sites,rules}.md`。
 
 ### Agent
 
@@ -20,6 +20,13 @@ Agent 上游全覆盖与订阅登录、控制台信息架构重排、定时任
 
 ### 控制台信息架构
 
+- IA-3 定稿(前端波 FE-1):侧栏 5 组 14 项(概览、资源、订阅、整理、系统);待处理不进侧栏,改为顶栏收件箱(角标 + 按类型分组的下拉)。
+- 引擎面板、定时任务、身份与元数据不再单独入口;旧地址全部重定向到任务页、任务页"计划"页签和媒体概览。
+- 统一"任务"页:定时、事件、手动、Agent 触发的运行在一条流里,页签为全部 / 进行中 / 失败 / 计划,来源与业务对象可筛选。
+- 任务详情抽屉:业务摘要、时间线、相关审计,引擎步骤折叠在最后;未结束可取消,已结束可重跑。
+- 首页按正在进行、需要处理、媒体概览、计划、最近完成与失败、缓存与保留、来源健康、运行状态重组。
+- 新增运行状态页:进程心跳、事件循环延迟、SSE 连接数、数据库、磁盘与挂载根,带 1 小时到 7 天的趋势。
+- 以下为 IA-1 / IA-2 阶段的调整,部分入口已被 IA-3 收编:
 - 侧栏改为 7 组 19 项(概览、资源、订阅、下载、整理、Agent、系统),按业务流程排列;新增"定时任务"入口。
 - 站点工作台合并快照与账号:详情页 4 个页签(整理视图 / 原站视图 / 快照与 Feed / 账号)。
 - 原"下载与任务"拆分为下载队列、下载计划、业务任务三页;订阅页"收录策略"页签独立为收录规则页。
@@ -34,6 +41,55 @@ Agent 上游全覆盖与订阅登录、控制台信息架构重排、定时任
 - 支持立即执行、跳过本次、开关与周期自定义(`customized` 标记,改过之后再登记不覆盖,`PATCH {reset:true}` 恢复默认);自定义巡检可增删,内置任务只能停用。
 - 调度器中断恢复:新执行者拿到锁时,把上一个执行者留下的 `running` 状态改为 `failed`。
 
+### 站点中心
+
+- 站点页是站点的唯一入口:添加站点向导、站点卡片与列表、单站详情。
+- 凭证管理:账密、Cookie、API Key(馒头)、Passkey、TOTP,同账号同类凭证原地替换。
+- 账号数据:上次登录、上传 / 下载、分享率、等级、VIP、账号状态,新表 `site_user_data`(迁移 0031)保存历史并画走势图。
+- NexusPHP 账密登录走 takelogin;验证码或二次验证失败时开待处理事项,提示改用 Cookie。
+- 手动"检测健康"与"用凭证刷新登录状态";Agent 能力新增 `site.list`、`site.health_check`、`site.refresh_login`、`site.user_data`,执行类需要持续授权。
+
+### 订阅
+
+- 订阅总览按状态分组(追更中、待搜索、已完成、暂停、待定),可按上次更新和缺集数排序。
+- 覆盖矩阵:每条订阅对照库内已有和订阅要求,按季 / 集和版本目标逐格显示。
+- 多版本目标逐个显示缺失,可开"自动补全其他版本"并设补全预算。
+- 订阅表单 v2:基本与高级两页,旧字段读入时归一化。
+
+### 规则
+
+- 收录策略与偏好标签合为一个"规则"页:硬条件、软偏好、优先级阶梯、排除分层显示。
+- 规则组 `rule_group` / `rule_atom`(迁移 0033)与 `/rules` 端点;兼容 MoviePilot 规则字符串的解析与序列化,内置关键字。
+- 规则字符串与分层卡片双向同步;可对最近已识别的资源或粘贴的标题试算命中层与拒绝原因。
+- 偏好标签作为规则的展示形态保留抑制记录;`/console/preferences` 重定向到规则页。
+- 升级判断按订阅引用的规则组重算当前资产的优先级。
+
+### 命名模板
+
+- 模板引擎:Jinja 安全子集,支持 MoviePilot 的命名变量与目录布局。
+- 全局、库根、作品三级覆盖,模板按版本保存(迁移 0032);整理与文件管理按覆盖链生成目标路径。
+- 设置页命名表单:变量清单、示例、实时预览;库根和作品可单独覆盖。
+
+### 全局搜索
+
+- `GET /search` 聚合本地作品、TMDB 候选、已启用站点的资源(限流、15 秒超时、并发合并、短缓存、库存叠加)与页面跳转。
+- 顶栏搜索框与 `Ctrl/⌘+K` 命令面板;`/console/search` 结果页可按站点、分辨率、来源、大小、免费、H&R 筛选和排序,资源行可下载或交给 Agent。
+
+### 文件管理 v2
+
+- 后端补齐 G1–G9:按 TMDB 候选就地建作品、最小体积(设置项 `organize.minSizeBytes`)、目标已存在时的处理、命名来源、建议文件名。
+- 目录树可折叠,下载目录在前;列表显示作品与季集、解析提示、目录计数;右键菜单按适用性显示或禁用并说明原因。
+- 共享整理向导:文件与作品 → 选项 → 预览并执行;文件管理、下载任务、整理记录都从这里整理。
+- 目录展开成逐个视频整理时,同目录同主干的字幕和外挂音轨随行进计划。
+- 整理向导执行多组后跳到 `/console/organize?ids=`,只列本次的记录。
+
+### 实时与系统
+
+- outbox 事件(Feed、待处理、下载、整理)投递成功后镜像到 SSE,首页、收件箱、任务流、Feed 列表随之刷新。
+- 进程心跳表与 `/system/health`、健康历史;引擎 runs 补关联业务对象与触发来源。
+- `/dashboard` 补作品、剧集、季、集、资产计数与版本目标满足率。
+- `/engine/runs` 支持 `triggeredBy` 筛选与多值 `status`,任务页的来源筛选和"进行中"页签改为服务端分页。
+
 ### 文案与术语
 
 - 全站第二轮文案审校:控制台、设置、Agent、服务端消息统一术语表用词(待处理 / 待识别 / 整理记录 / 运行记录 / 凭证 / 子会话 / Agent 上游),精简说明文字、空态、确认按钮与 toast。
@@ -47,6 +103,14 @@ Agent 上游全覆盖与订阅登录、控制台信息架构重排、定时任
 - 设置页深链改用分区 hash 定位,不再依赖 `?tab=` 查询参数(旧链接仍可打开,经重定向落到新分区)。
 - Agent 汇报的下载任务链接直接指向下载详情页,不再先探测业务任务详情再判断是否为下载任务。
 - 生产容器静态 ffprobe 升级到 9.0.2;`.gitignore` 忽略 compose override 文件。
+- 视觉走查 17 项(`docs/plan/09-visual-qa.md`):改密时旧密码错误不再被踢回登录页;预览失败时不能再执行整理;手机上 Feed 表不再把操作列挤出屏幕;操作者、原因、用途等不再显示内部 id 与英文代码。
+- 手动整理成功入库后,处于"需处理"的版本目标回到核验,再按实际入库资产落定;同一下载任务的整理冲突事项自动关闭。
+- 自定义 Base URL 的 Agent 上游"测试"不再把状态改成可用,提示用"最小补全"确认端点可达。
+- 新作品首次下载的计划用途记为"补缺",不再是"升级"。
+- 按 TMDB 建档时同事务写入元数据,别名按规范化文本去重。
+- 更新站点账号凭证不再因 secret 重名报 500;馒头刷新登录在站点地址是 IP 时不再拼出非法地址。
+- 表单保存失败时提示第一处问题并滚动到出错字段;移动 / 复制选到源所在目录时直接提示,不再发出注定失败的预览请求。
+- 数据库迁移只内省目标 schema,并行测试在共用库上删 schema 时不再偶发"schema 不存在"。
 
 ### 已知限制
 
@@ -59,6 +123,12 @@ Agent 上游全覆盖与订阅登录、控制台信息架构重排、定时任
 - 身份页"待识别"详情抽屉的提示句仍写"选择候选或忽略",未识别类(无候选)读起来不准确,留给下一轮文案。
 - 旧 `settings.pi` 字段只是弃用未删除,真正删除需要一次迁移清理里面的旧键。
 - 原站视图仍是占位(IA-1 遗留)。
+- 观众站定义没有 H&R 选择器,资源的 H&R 一律显示"未知"(视觉走查 U8)。
+- 界面文案中文句子里的半角 `,;:` 与全角 `。` 并存,尚未定全站标点规范(视觉走查 U11)。
+- Agent 悬浮按钮在滚动途中仍会盖住页面右下角的控件,页面末尾已留出高度(视觉走查 U6)。
+- 订阅还没有 `subscription.*` outbox 事件,订阅页不随后台变化实时刷新。
+- `/engine/runs` 的 `triggeredBy` 在服务端逐行推断后筛选,单次请求最多检查 2000 行,命中稀少时一页可能少于 `limit`。
+- 定时任务运行记录没有对应的引擎 run id,卡片与任务之间按业务对象关联。
 - 控制台账户弹层的二次验证(TOTP)开启时只显示密钥与 otpauth 链接,不渲染二维码。
 
 ## [0.1.0] - 2026-09-28