edit | blame | history | raw

用户目标

只读评估 Txtflowy 是否适合重命名为 P1-Txtflowy,并判断是否应把源码独立收敛到 P1-Txtflowy/src;重点检查 Git 边界、any-block/.git 嵌套仓、构建入口、Obsidian 本地安装复制路径,以及文档 / 原型 / requirements 与代码目录的关系。

已完成事项

  • 读取父项目 INDEX.mdCODEGRAPH.md02-P/plan-progress.markdown 与研发规则。
  • 核实 Txtflowy 当前 Git 边界:父仓根是 /Users/ar/Projects/ExcalidrawXTxtflowy/ 当前未被父仓纳管。
  • 核实 Txtflowy/any-block 是独立 Git 仓库,当前分支 Txtflowy,远端是 https://github.com/any-block/any-block.git
  • 核实当前有效源码仍主要位于 Txtflowy/any-block/src/...,顶层 Txtflowy/src/ 为空目录。
  • 核实构建入口从 any-block/package.json 进入 src/Obsidian/package.json,产物输出到 any-block 根目录的 manifest.jsonmain.jsstyles.css
  • 核实 Obsidian 本地安装文档和发布文档均写死了 Txtflowy/any-block 路径与测试库安装方式。
  • 核实已有 clean extraction 方案明确要求:长期形态应为独立轻量插件,AnyBlock 只保留为参考 / 归档。
  • 核实文档存在漂移:requirements、GTD、CHANGELOG 声称已创建 docs/product-*.mddocs/technical-architecture.md,但当前文件缺失。

关键决策

  • 结论:适合重命名为 P1-Txtflowy,但不适合把当前 any-block 整仓直接视为未来 src/
  • 最稳妥目标形态:P1-Txtflowy 作为独立治理单元,活跃源码放到根级 src/(或等价单插件源码目录),any-block 仅作为冻结参考,不再作为长期运行时主线。
  • 迁移顺序应为:
  1. 先确定 Git 治理边界;
  2. 再做目录重命名;
  3. 再做 clean extraction,把 Txtflowy 专属代码抽到新 src/
  4. 最后把 any-block 转为 archive/references/
  • 不建议一步到位把当前 any-block/src 直接挪成 P1-Txtflowy/src,因为会同时打断 Git 历史、构建输出、文档路径和验证路径。

文件变更

  • 新增本会话记录:
  • /Users/ar/Projects/ExcalidrawX/.codex-sessionhistory/2026-06-25-Txtflowy迁移评估.md

未决问题

  • P1-Txtflowy 是否要正式初始化为独立 Git 仓库,还是继续作为父仓中的独立目录存在。
  • any-block 参考代码最终保留方式:独立 archive 仓、普通参考目录、还是外部链接文档。
  • 缺失的 docs/product-*.mddocs/technical-architecture.md 是否需要先补齐,作为迁移前文档基线。

后续建议

  • 推荐目标目录:
  • P1-Txtflowy/src/:独立插件活跃源码
  • P1-Txtflowy/docs/:规则、迁移、发布、架构文档
  • P1-Txtflowy/requirements/:需求归档
  • P1-Txtflowy/prototype/:原型
  • P1-Txtflowy/snapshots/:视觉或行为快照
  • P1-Txtflowy/archive/any-block-fork/:冻结参考,不参与主构建
  • 迁移前提:
  • 明确 Git 主仓边界;
  • 列出所有绝对路径和 Txtflowy/any-block 硬编码引用;
  • 先定义新构建入口与产物路径;
  • 为 Obsidian 本地安装保留同一插件 id txtflowy 与同一测试库安装目标。