Files
UHD_Media_Tool/docs/plan/README.md
T
rootandClaude Opus 5.5 b343dddbf6 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]>
2026-10-02 16:08:09 +08:00

2.6 KiB
Raw Blame History

计划与待办

这里只放正在推进的计划和待办。做完的计划、验收和发布记录直接删除,版本变化只记在 CHANGELOG;需要追溯时查 git 历史(2026-10-02 清理前的全部过程文档在 ceb66f8)。

文档放哪

内容 位置
需求基线 media_automation_requirements_architecture_v0.7.md
架构决策 docs/adr/
设计规范(界面、领域) docs/design/
怎么用、怎么运维 docs/runbook/(开发环境见 dev.md,部署见 deploy.md)
与 MoviePilot 的业务对照(持续维护) docs/porting/moviepilot-v3-comparison.md 及同目录各移植文档
版本变化 仓库根 CHANGELOG.md,每个版本几行;发布前必须写好(deno task release 会检查)
经验教训 lessons.md
证据、截图、构建日志 .local/(不进 git)

当前状态

  • 版本 v0.3.14(ceb66f8),本机测试环境已部署。此前 v0.3.8~v0.3.13 由未提交工作区部署,源码已在 v0.3.14 统一提交。
  • 开发与发布约定见仓库根 CLAUDE.md。

待办

按需要再挑,挑中后在这里写清:从哪触发、最终看到什么、哪些失败需要人工处理、用什么样本验收。

工程

  • 任务恢复的三处边界:升级前未结束任务的版本处置(发布前查在途任务版本,没有在途旧任务就不保留旧处理器);业务结果提交、run 关联、事件派发三个时点分别注入失败确认最终状态;引擎查询异常时只记录并跳过本轮,仅在明确查无 run 或终态时补投。
  • 生产模块装配的处理器来源断言(防止漏注册的任务静默回显 todo),下次改任务注册时补。
  • 大文件拆分候选,改到相关功能时顺手拆,不单独重构:packages/contracts/src/api.ts(~2700 行)、acquisition-organize/services/organize.ts(~2600)、browser/service.ts(~2400)、web/app/components/organize-wizard/organize-wizard.tsx。

业务

  • 与 MP 对照里仍未定的项,见 对照 §6.4/6.5。
  • 需求里仍是"部分实现"的:R06 通用 HTTP 失败转浏览器、真实 Cloudflare 挑战验收;R21 缓存阈值里未纳管占用的专项验收;四站与真实下载、媒体服务器的完整验收。