docs: 清理过程文档,CHANGELOG 补齐 0.3.8–0.3.14
- 删除 docs/plan 下 00–18 的计划、评审、验收、发布记录与升级证据,docs/spikes 与 spikes 验证代码
(保留 spikes/movieclaw-src 本地克隆),以及 4 份一次性审查 / 调研;全部可在 ceb66f8 查到
- MP 对照移到 docs/porting/moviepilot-v3-comparison.md;经验教训改为 docs/plan/lessons.md(补第 25 条)
- docs/plan/README.md:文档放哪、当前状态、待办
- 引用改写:代码注释指向在维护的文档,其余注明已删除与 git 位置;清掉原有 6 个失效链接
- README 开头改为当前状态与入口;CHANGELOG 补齐 0.3.8–0.3.14 与工程变更
Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
rootandClaude Opus 5.5 committed
1 parent
11ca2f01ff
commit
b343dddbf6
36 files changed
+156
-76
No files matched your search
@@ -2,7 +2,7 @@
|
||||
|
||||
继续开发前，先逐项核对现有业务与 MoviePilot v3 的处理逻辑。每项同时说明业务结果、失败边界、本项目差异和需要补的证据；完成对照后再讨论实现调整。本文是当前对照记录，尚未完成的项目明确列为待核对。
|
||||
|
||||
日期：2026-10-01。本项目业务代码基线：`8013196e3f5e6a8c4ea0cd26cf77294a82a13ddd`，`v0.3.7`。前置材料：[开发情况基线](13-development-baseline.md)、[工程检查](14-engineering-review.md)。初始对照阶段只读源码并更新文档；后续用户授权的实现状态见第 4、5 节。
|
||||
日期：2026-10-01。本项目业务代码基线：`8013196e3f5e6a8c4ea0cd26cf77294a82a13ddd`，`v0.3.7`。前置材料：开发情况基线（已删除，见 git `ceb66f8`）、工程检查（已删除，见 git `ceb66f8`）。初始对照阶段只读源码并更新文档；后续用户授权的实现状态见第 4、5 节。
|
||||
|
||||
## 1 参考基线和判定方法
|
||||
|
||||
@@ -12,12 +12,12 @@
|
||||
| 参考发布版本 | `v3.0.10-1`，提交 [`0aa857173f77de31c7c8d9d2e12052d99f37bcc1`](https://github.com/jxxghp/MoviePilot/tree/0aa857173f77de31c7c8d9d2e12052d99f37bcc1)，2026-09-28；`version.py` 已核对 |
|
||||
| 分支查询 | 本轮只读查询时 `v3` 分支为 `5741d3c56d761d87868d4f2d0515ac5c498f94d6`；本报告采用上面的发布标签，后续逐项核对不随分支移动 |
|
||||
| 本地参考位置 | `/tmp/umt-moviepilot-v3-review-20261001`，独立浅克隆，未改上游源码 |
|
||||
| 旧资料 | [既有移植文档](../porting/moviepilot-transfer.md)使用 `e6820a8`／早期 v3.0.0；原参考仓库保持不变，旧样本结论不直接升级为本轮结论 |
|
||||
| 旧资料 | [既有移植文档](moviepilot-transfer.md)使用 `e6820a8`／早期 v3.0.0；原参考仓库保持不变，旧样本结论不直接升级为本轮结论 |
|
||||
| 证据范围 | 阅读当前源码、迁移和测试断言；没有启动 MP 服务或运行上游测试，也没有对本项目新增故障注入 |
|
||||
|
||||
MP 是优先采用的业务参考；用户已确认尽量复用其成熟业务逻辑和实现，存在明确需求差异时再讨论调整。最终行为仍由本项目需求和用户确认决定。两边使用不同任务和数据机制，只比较同一场景的业务结果，不因模块名字相近就认定能力相同。已有 MP 差分样本、运行记录和有意偏离登记继续保留，按各自提交解释。
|
||||
|
||||
每项记录五件事：触发场景；MP 的明确处理分支；本项目正式调用路径；差异属于实现缺口、验收缺口、有意调整还是暂不适用；拟采用的规则及最小验证场景。源码结论、未复现影响和讨论建议分开。参考行为与来源登记沿用 [移植规范](../porting/license-and-provenance.md)。
|
||||
每项记录五件事：触发场景；MP 的明确处理分支；本项目正式调用路径；差异属于实现缺口、验收缺口、有意调整还是暂不适用；拟采用的规则及最小验证场景。源码结论、未复现影响和讨论建议分开。参考行为与来源登记沿用 [移植规范](license-and-provenance.md)。
|
||||
|
||||
## 2 顺序和进度
|
||||
|
||||
@@ -57,7 +57,7 @@ MP 是优先采用的业务参考；用户已确认尽量复用其成熟业务
|
||||
|
||||
升级兼容也有明确范围：MP 的分类检查点 v1→v2 迁移遇到已有执行状态、执行载荷或步骤证据时不重写旧计划，继续使用已知旧版本解码路径。这支持「保留已经产生的执行证据」的规则，不能据此承诺任意旧 handler 都能继续执行。见 [检查点迁移](https://github.com/jxxghp/MoviePilot/blob/0aa857173f77de31c7c8d9d2e12052d99f37bcc1/database/versions/d8f2b6a4c1e7_3_0_28.py#L290)。
|
||||
|
||||
本项目刮削双写控制流已确认，但本轮没有故障注入证明实际受影响。上一轮线上只读检查未发现未结束的旧版刮削 run，也没有 `scrape_record` 记录；该时点结论不代替升级策略。见 [工程检查 §2](14-engineering-review.md#2-建议优先核对的恢复边界)。
|
||||
本项目刮削双写控制流已确认，但本轮没有故障注入证明实际受影响。上一轮线上只读检查未发现未结束的旧版刮削 run，也没有 `scrape_record` 记录；该时点结论不代替升级策略。见 工程检查 §2（已删除，见 git `ceb66f8`）。
|
||||
|
||||
### 3.2 精确来源
|
||||
|
||||
@@ -112,7 +112,7 @@ MP 还在 [test_transfer_planning_checkpoint.py](https://github.com/jxxghp/Movie
|
||||
|
||||
目录接管参考 MP `app/application/transfer/monitor/snapshot.py`、`poller.py`：先快照现状，再比对新增／变化；完整存量作为单独手动操作。我们采用数据库持久快照、已有识别与整理计划，一条配置一个来源路径。同分类可配置多条不同来源，综艺归 tv；只有复制与移动。qB 标签继续使用现有任务管理和实例范围。
|
||||
|
||||
当前源码已接入分类编辑和测试、来源选择、自动／固定分类、qB 配置标签、快照与存量向导。已有路径绑定保留，不按新规则迁移旧库；源离线保留基线，已知 qB 任务不被目录扫描重复接管。具体入口和分批限制见 [整理手册](../runbook/organize.md)。测试使用本项目临时目录与隔离 PG，不是运行 MP 服务；未完成浏览器截图审查；后续 v0.3.9 已发布，见 [发布记录](18-organize-release.md)。
|
||||
当前源码已接入分类编辑和测试、来源选择、自动／固定分类、qB 配置标签、快照与存量向导。已有路径绑定保留，不按新规则迁移旧库；源离线保留基线，已知 qB 任务不被目录扫描重复接管。具体入口和分批限制见 [整理手册](../runbook/organize.md)。测试使用本项目临时目录与隔离 PG，不是运行 MP 服务；未完成浏览器截图审查；后续 v0.3.9 已发布，见 发布记录（已删除，见 git `ceb66f8`）。
|
||||
|
||||
其他主题仍按第 2 节逐项讨论。这轮只补齐与已讨论整理功能有关的分类、标签与目录接管行为，不宣称整个下载隔离、清理、订阅和智能体业务对照已完成。
|
||||
|
||||
@@ -228,11 +228,11 @@ MP 手动添加入口识别失败时返回 `requires_confirmation`；前端 `Add
|
||||
- 用本机 Chromium 与真实 React 组件验证单旧版默认选择、无选择禁用洗版、勾选洗版、切回正常、未知资源二次确认、串流外按钮交接；API 为 fixture，未产生真实下载，页面无未捕获异常。
|
||||
- web production build、server compile 与空环境二进制模块自检通过。局部证据存于本机 `.local/manual-download-ui/`。
|
||||
|
||||
以上业务回归主要为源码与隔离环境验证。随后于 2026-10-01 发布 v0.3.10，线上 `0060` 迁移、HTTP／HTTPS、管理员接口及 6 个生产页面冒烟通过，未触发真实下载或媒体整理；镜像、备份与验证证据见 [发布记录](18-organize-release.md#v0310-手动下载与入库发布)。
|
||||
以上业务回归主要为源码与隔离环境验证。随后于 2026-10-01 发布 v0.3.10，线上 `0060` 迁移、HTTP／HTTPS、管理员接口及 6 个生产页面冒烟通过，未触发真实下载或媒体整理；镜像、备份与验证证据见 发布记录（已删除，见 git `ceb66f8`）。
|
||||
|
||||
### 5.7 v0.3.11 体验修复
|
||||
|
||||
搜索资源标题接入与站点工作台同一详情抽屉与读取接口，复用按需详情抓取和缓存，不增加第二套解析器。详情抽屉仍提供下载选项、库存和 Agent 入口。桌面浏览器的最大化规则修复后，上下黑边消失。已部署并经过组件交互、生产真实缓存详情接口与 HTTPS 页面验证，范围和证据见 [发布记录](18-organize-release.md#v0311-搜索详情与桌面黑边修复)。
|
||||
搜索资源标题接入与站点工作台同一详情抽屉与读取接口，复用按需详情抓取和缓存，不增加第二套解析器。详情抽屉仍提供下载选项、库存和 Agent 入口。桌面浏览器的最大化规则修复后，上下黑边消失。已部署并经过组件交互、生产真实缓存详情接口与 HTTPS 页面验证，范围和证据见 发布记录（已删除，见 git `ceb66f8`）。
|
||||
|
||||
## 6 整理使用方式与文件管理器专项研究（2026-10-02）
|
||||
|
||||
|
||||
Reference in new issue
Block a user