CODEX KNOWLEDGE

Obsidian JSON Memory System

2026/04/26 4 min read CODEX KNOWLEDGE DOCUMENT WRITING SYSTEM INDEX OBSIDIAN WORKSPACE REGISTRY LOCAL TOOLING REGISTRY OBSIDIAN PERFORMANCE STATE OBSIDIAN WORKSPACE REGISTRY SCHEMA

Obsidian JSON Memory System

这份文档定义当前 Obsidian / 本地工具知识层的结构化 JSON 记忆系统。

1. 设计目标

目标不是把所有说明都写进 JSON，而是把未来会反复查询、反复同步、适合程序读取的稳定事实抽出来。

采用双层：

  • Markdown：解释为什么、怎么用、边界是什么
  • JSON：记录结构化事实、路径映射、当前状态、入口关系

2. 当前三类核心 JSON

2.1 obsidian-workspace-registry.json

负责记录：

  • full vault / performance vault 路径
  • 热区 / 冷区分层
  • junction 映射
  • 模式定义
  • 插件配置档位

2.2 local-tooling-registry.json

负责记录：

  • Obsidian / VS Code / pwsh 的稳定入口
  • profile 文件路径
  • vault 切换脚本路径
  • 常用 shell command 名称

2.3 obsidian-performance-state.json

负责记录：

  • 当前推荐模式
  • 已应用的性能优化层
  • 量化证据
  • 剩余风险

3. 维护规则

3.1 什么时候必须更新 JSON

以下变化发生时，同任务必须同步更新至少一个 JSON 文件：

  • vault 路径变更
  • 模式切换脚本变更
  • 热区 / 冷区边界变更
  • 插件策略变更
  • 本地工具稳定入口变更
  • 性能策略或风险状态发生变化

3.2 什么时候还要更新 schema

如果 JSON 字段结构变化，而不仅是值变化，则必须同任务更新对应 schema。

3.3 什么时候还要更新 Markdown

如果变更影响人类理解路径或工作流，则同时更新：

  • document-writing-system-index.md
  • 本文档
  • 相关入口说明文档

4. 当前入口

5. 系统收益

这套系统的作用是减少三类重复劳动：

  • 重复找路径
  • 重复确认当前生效状态
  • 重复解释本地结构给程序或未来维护者

6. 自动校验

当前专用校验脚本：

  • E:\My Project\Atramenti-Console\codex\plugins\obsidian\validate-obsidian-json-memory-system.ps1

校验范围至少包括：

  • 核心 JSON 与 schema 可解析
  • workspace / tooling / performance state 关键路径存在
  • performance vault 热区 junction 存在
  • launcher / wrapper / profile 文件存在
  • 文档注册表和推荐入口包含 JSON 记忆系统
  • 全局规则 / 注释规则 / MEMORY 已写入相应门禁与事实