主流归档方案调研与建议¶

结论：不存在单一主流方案可以治理整个 macOS 主目录。正确做法是分层采用不同成熟体系。

调研日期：2026-10-20
适用对象：~
状态：研究稿 V1.0

1. 调研范围¶

本调研覆盖五类方案。这样可同时处理行动状态、编号、记录治理、长期保存和平台约束。

2. 核心结论¶

1. PARA 适合管理行动状态。
2. Johnny.Decimal 适合稳定编号和索引。
3. GTD 适合收件箱和定期复核。
4. ISO 15489 适合记录治理原则。
5. NARA ERM 适合记录生命周期。
6. OAIS 适合定义长期保存模型。
7. BagIt 适合形成可校验归档包。
8. NDSA 适合评估保存能力。
9. FAIR 适合数据和元数据复用。
10. Diátaxis 适合文档内容架构。
11. XDG 适合配置、数据、缓存分区。
12. Git worktree 适合源码并行工作区。
13. 3-2-1 适合备份，不适合归档。

3. 方案对照¶

4. 关键发现¶

4.1 PARA¶

PARA 有四个顶层类别：项目、领域、资源、归档。PARA 按行动状态组织，不按主题组织。

适用方式：

• 用于 Documents 内部。
• 项目完成后进入全局 archive。
• 不把 PARA 扩展到源码、工具和系统目录。

局限：

• 项目与领域容易重叠。
• 归档容易变成堆放区。
• 不能提供摘要和长期校验。

4.2 GTD¶

GTD 的第一步是捕获。第二步是判断是否可行动。不可行动的内容进入丢弃、参考或暂缓。

适用方式：

• Documents/inbox 只做短期入口。
• 每周清空收件箱。
• 每次判断行动、参考、归档或删除。

局限：

• GTD 不定义长期归档格式。
• GTD 不提供数据完整性机制。

4.3 Johnny.Decimal¶

Johnny.Decimal 使用区域、类别和唯一 ID。区域从 10-19 开始，类别使用两位数字，条目使用 AC.ID。

Johnny.Decimal 把 00-09 保留为系统管理区。标准零包括 .01 收件箱和 .09 归档。[3]

适用方式：

• 为项目、实验和归档单元分配唯一 ID。
• 建立总索引。
• 不在主目录根层复制整套十进制层级。

局限：

• 建立和维护索引有成本。
• 合并类别可能引起重排。
• 不适合 repo、tools 和 Library。

4.4 ISO 15489 与 NARA¶

ISO 15489-1:2016 关注记录的创建、捕获和管理。[5]

记录应保持四项特征：

• 真实性。
• 可靠性。
• 完整性。
• 可用性。[6]

NARA ERM Requirements V3 把生命周期分为六段：

1. 捕获。
2. 维护和使用。
3. 处置。
4. 移交。
5. 元数据。
6. 报告。[7]

适用方式：

• 定义归档责任。
• 定义保留期和处置条件。
• 保留操作日志。
• 记录元数据和来源。

局限：

• 这是治理框架，不是目录模板。
• 完整实施对个人环境过重。

4.5 OAIS、BagIt 与 NDSA¶

OAIS 把信息对象分为提交包、存档包和分发包。OAIS 还要求来源、固定性和真实性证据。[9]

BagIt 是 RFC 8493 定义的文件封装格式。BagIt 包含：

• bagit.txt
• data/
• bag-info.txt
• 有效载荷清单。
• 标签文件清单。
• 加密摘要。[10]

NDSA Levels 2.1 从五方面评估保存能力：

• 存储。
• 完整性。
• 控制。
• 元数据。
• 内容。[11]

适用方式：

• 活跃项目结束时生成提交包。
• 提交包整理为 BagIt 存档包。
• 使用时生成分发副本。
• 每季度检查摘要和恢复能力。

4.6 数据管理与文档架构¶

HKU 建议目录层级控制在三至四层。HKU 还建议每层不超过十项。[16]

Cornell 建议顶层目录包含项目名、唯一标识和年份。Cornell 还建议每个逻辑数据集合编写 README。[17]

Diátaxis 把文档分为四类：

• 教程。
• 操作指南。
• 技术参考。
• 解释。[13]

适用方式：

• 项目目录不再无限加深。
• 每个项目必须有 README。
• 知识库内部再按 Diátaxis 分类。

4.7 平台与源码¶

XDG 把配置、数据、状态和缓存分开。[14]

Git worktree 是同一仓库的附加工作树。worktree 不是独立仓库，也不是归档单元。[15]

适用方式：

• .codex、.claude、.paseo 和 Library 保持原位。
• repo 只保存 Git 源码。
• worktree 只保存并行任务状态。
• worktree 关闭前先保存提交或补丁。

5. 对上一版 00/10 方案的判断¶

上一版方案属于“数字前缀分类法”。它参考了 Johnny.Decimal 的外观，但没有完整采用其索引和标准零体系。

主要问题：

1. 00、10、20、90 混用了系统区、业务类别和归档区。
2. 编号表达的是主题，不是生命周期。
3. 主目录根层同时使用了主题编号和系统目录名。
4. 没有绑定唯一索引。
5. 没有定义归档包和校验格式。
6. 没有解决源码、工具、worktree 和备份问题。

结论：

• 数字前缀本身可以使用。
• 全套编号不应成为整个主目录的主结构。
• 只应在需要稳定标识的项目和归档单元中使用。

6. 建议的分层架构¶

7. 推荐主目录边界¶

~/
├── Applications/       # macOS 应用
├── Desktop/            # 短期工作台
├── Documents/          # 活跃文档
├── Downloads/          # 入站隔离区
├── Library/            # 系统托管
├── Movies/
├── Music/
├── Pictures/
├── Public/
├── repo/               # Git 源码
├── workspace/          # 活跃非 Git 工作区
├── tools/              # 工具和 SDK
├── bin/                # 命令入口
├── archive/            # 长期归档
└── .*/                 # 工具托管配置

根目录不再新增主题文件夹。

8. 推荐 Documents 结构¶

Documents/
├── inbox/              # 待分类
├── projects/           # 有完成条件的项目
├── areas/              # 长期责任
├── resources/          # 可复用知识
└── assets/             # 媒体和共享资产

规则：

• inbox 每周清空。
• projects 只放当前项目。
• areas 放持续职责，例如财务、健康、设备。
• resources 放跨项目参考资料。
• assets 放图片、音视频和共享附件。
• 完成项目整体移入 archive。

9. 推荐标识¶

标识采用“类型、年份、序号、短名”格式。

PRJ-2026-001-covio
EXP-2026-004-worktree-analysis
ARC-2026-012-macos-control-center

规则：

• ID 一旦分配，不再改变。
• 标题可以修改，ID 不修改。
• 归档时沿用原项目 ID。
• 文件正文不能依赖目录层级传达关键信息。
• 每个项目必须有 README.md。

10. 推荐归档包¶

完成项目按 BagIt 形成存档包。

archive/
└── 2026/
    └── PRJ-2026-001-covio/
        ├── bagit.txt
        ├── bag-info.txt
        ├── manifest-sha256.txt
        ├── tagmanifest-sha256.txt
        └── data/
            ├── README.md
            ├── deliverables/
            ├── evidence/
            └── metadata/

bag-info.txt 至少记录以下字段：

归档包只读。恢复时复制到 workspace。修改后生成新的分发副本。

11. 内容权威来源¶

12. 运行时目录¶

repo/
├── Covio/
├── Lidsleep/
├── ObsidianVault/
├── kmp-translator/
└── _worktrees/
    └── Covio/
        └── task-156/

规则：

• repo 保持扁平。
• 一个目录对应一个仓库。
• 不使用主题子目录重组现有仓库。
• 新 worktree 放入 repo/_worktrees/<repo>/<task>。
• 旧 worktree 用 Git 或 Paseo 工具管理。
• 清理 worktree 前检查未提交内容。

13. 当前基线¶

14. 实施原则¶

1. 先建立备份。
2. 再建立规则。
3. 然后建立清单。
4. 先试运行，后迁移。
5. 每批只移动一类对象。
6. 每批保留摘要。
7. 不手工移动 worktree。
8. 不归档生成物。
9. 不把归档当备份。
10. 删除前保留审批记录。

15. 已采用决策¶

以下四项已于 2026-10-20 采用。

16. 调研来源¶

1. Tiago Forte, “The PARA Method”, updated 2026-04-15. https://fortelabs.com/blog/para/
2. Johnny.Decimal, “Introduction”. https://johnnydecimal.com/documentation/introduction
3. Johnny.Decimal, “The standard zeros”. https://johnnydecimal.com/documentation/the-standard-zeros
4. Getting Things Done, “What is GTD?”. https://gettingthingsdone.com/what-is-gtd/
5. ISO, “ISO 15489-1:2016 Records management”. https://www.iso.org/standard/62542.html
6. Digital Curation Centre, “ISO 15489”. https://www.dcc.ac.uk/guidance/briefing-papers/standards-watch-papers/iso-15489
7. U.S. National Archives, “Universal ERM Requirements V3”. https://www.archives.gov/records-mgmt/policy/universalermrequirements
8. The National Archives UK, “Policy and process”. https://www.nationalarchives.gov.uk/information-management/manage-information/policy-process/
9. CCSDS, “Reference Model for an Open Archival Information System”, CCSDS 650.0-M-3, 2024; ISO 14721:2025. https://ccsds.org/Pubs/650x0m3.pdf
10. RFC 8493, “The BagIt File Packaging Format V1.0”. https://www.rfc-editor.org/rfc/rfc8493.html
11. NDSA, “Levels of Digital Preservation V2.1”, March 2026. https://ndsa.org/publications/levels-of-digital-preservation/
12. GO FAIR, “FAIR Principles”. https://www.go-fair.org/fair-principles/
13. Diátaxis. https://diataxis.fr/
14. freedesktop.org, “XDG Base Directory Specification”. https://specifications.freedesktop.org/basedir-spec/latest/
15. Git, “git-worktree Documentation”. https://git-scm.com/docs/git-worktree
16. University of Hong Kong, “Research Data Management: Data Organization”, updated 2026-06-18. https://libguides.lib.hku.hk/rdm/organize
17. Cornell Data Services, “File management” and “Writing READMEs for Research Data”. https://data.research.cornell.edu/file-management/
18. CISA, “Back Up Business Data”. https://www.cisa.gov/audiences/small-and-medium-businesses/secure-your-business/back-up-business-data
19. Apple, “File System Programming Guide”. https://developer.apple.com/library/archive/documentation/FileManagement/Conceptual/FileSystemProgrammingGuide/FileSystemOverview/FileSystemOverview.html