digital-garden-cultivator

数字花园培育者

设计、管理并发展数字花园，将其打造为不断生长的知识库。数字花园是相互连接的笔记集合，会自然生长，注重持续演进而非追求完美。

它是什么

一种知识管理方法，通过数字花园：

• 构建随时间不断演进的动态知识库
• 通过双向链接连接笔记
• 在将想法正式整理成文档前进行孵化
• 创建信息导航的探索路径
• 跟踪内容成熟度和维护需求

快速开始

计算花园指标

python -m memory_palace.garden_metrics path/to/garden.json --format brief

**验证：**运行 python --version，确认 Python 环境正常。

输出格式

• json - 完整的 JSON 格式指标
• brief - 单行摘要
• prometheus - Prometheus exposition 格式

适用场景

• 构建随时间不断演进的动态知识库
• 通过双向链接连接笔记、技能和宫殿
• 在将想法正式整理成文档前进行孵化
• 创建信息导航的探索路径
• 管理内容生命周期（幼苗 → 生长中 → 常青）

不适用场景

• 创建记忆宫殿 结构 - 使用 memory-palace-architect
• 评估新知识
  • 使用 knowledge-intake
• 创建记忆宫殿 结构 - 使用 memory-palace-architect
• 评估新知识
  • 使用 knowledge-intake

内容成熟度等级

等级	状态	描述
幼苗	新建/粗略	初步想法、不完整的思考
生长中	发展中	正在积极完善
常青	成熟	稳定、完善的内容

核心工作流

1. 收集来源 - 汇总笔记、书签和想法
2. 规划结构 - 定义花园的组织方式
3. 创建链接 - 建立双向连接
4. 安排维护 - 制定维护频率
5. 记录产出 - 将成熟的想法转化为正式文档

花园布局模板

garden:
  sections: ["research", "patterns", "experiments"]
  plots:
    - name: "My First Note"
      purpose: "reference"  # reference | evergreen | lab
      maturity: "seedling"  # seedling | growing | evergreen
      inbound_links: []
      outbound_links: []
      last_tended: "2025-11-24T10:00:00Z"

**验证：**使用 --help 标志运行命令，确认其可用。

维护频率

操作	频率	目的
快速修剪	每 2 天	移除失效链接、修正拼写错误
过时内容审查	闲置 7 天后	评估内容时效性
归档	闲置 30 天后	移至归档或删除

成功指标

• 链接密度 - 每条内容的平均链接数
• 双向覆盖率 - 双向链接占所有链接的百分比
• 新鲜度 - 各区域距上次更新的时间
• 成熟度比例 - 常青内容 / 内容总数

详细资源

• 链接模式：参见 modules/linking-patterns.md
• 维护指南：参见 modules/maintenance.md
• 指标集成：参见 modules/maintenance.md

集成

• memory-palace-architect - 在宫殿结构中容纳花园
• knowledge-locator - 搜索花园内容
• session-palace-builder - 根据会话洞见播种花园

故障排除

常见问题

提交前钩子失败 运行 SKIP=... git commit 暂时跳过钩子，然后修复问题

合并冲突 使用 git merge --abort 重置，然后仔细解决冲突

提交被拒绝 检查钩子输出，并在再次提交前修复报告的问题

完成标准

• 在目标 garden.json 上运行 python -m memory_palace.garden_metrics 不报错，并输出链接密度、双向覆盖率、 新鲜度和成熟度比例
• 识别出过时笔记（闲置超过 7 天），并列出供用户审查
• 为范围内的每条笔记指定一个成熟度等级： seedling、growing 或 evergreen
• 报告失效链接和孤立笔记，以便在维护过程中修剪 或重新连接
• 如果 garden.json 不存在或格式错误，应报告错误及搜索过的路径， 而不是静默完成