维基工作区摘要
摘要
本文档为xcxnotes维基工作区的整体说明,涵盖架构设计、当前运行状态、操作指南、核心资源与后续规划。
三层架构概览
xcxnotes维基采用三级目录分层架构,结构如下:
xcxnotes/
├── input/ ← 输入层: 原始源文件 (只读)
├── wiki/ ← 维基层: LLM 生成和维护的页面
└── output/ ← 输出层: 衍生内容和导出文件
当前状态
已完成事项
- ✅ 创建三层目录结构
- ✅ 设置核心文件 (index.md, log.md, SCHEMA.md)
- ✅ 摄入第一篇源文件 (Karpathy LLM Wiki Gist)
- ✅ 创建概念页面、实体页面、摘要页面
- ✅ 编写架构设计文档
- ✅ 编写各层说明文档
维基统计数据
| 类别 | 数量 | 备注 |
|---|---|---|
| 总页面 | 6 个 | - |
| 实体页面 | 1 个 | Andrej Karpathy |
| 概念页面 | 1 个 | LLM Wiki Pattern |
| 摘要页面 | 1 个 | Karpathy Gist |
| 核心文件 | 3 个 | 索引、日志、规范 |
| 源文件 | 1 个 | - |
待办事项
- ⏳ 整理现有文件夹到 input/raw/
- ⏳ 逐步摄入重要文档
- ⏳ 扩展实体和概念页面
- ⏳ 创建比较分析页面
- ⏳ 生成输出内容 (幻灯片、报告等)
- ⏳ 建立定期维护流程
操作指南
添加新源文件
- 将文件放入
input/raw/目录 - 通知 LLM 执行源文件摄入处理
- 检查自动生成的对应维基页面
查询知识
- 查看 维基索引 定位相关页面
- 或直接向 LLM 提出知识查询需求
查看知识网络
- 在 Obsidian 中打开图视图功能
- 直观查看各维基页面之间的关联连接
核心页面列表
工具集成方案
- Obsidian: 维基主要编辑与浏览工具
- Obsidian Git: 工作区版本控制工具
- Local REST API: 维基程序化访问接口
- Dataview: 维基内容动态查询插件
- Marp: 维基衍生幻灯片生成工具
后续规划建议
- 整理现有内容: 将 01-06 文件夹的存量内容整理迁移至
input/raw/目录 - 优先摄入核心文档: 筛选高价值重要文档优先完成摄入转化
- 建立维护习惯: 定期添加新源文件并执行维基更新维护
- 开展知识探索: 基于已构建的维基内容开展查询与关联探索
- 生成衍生输出: 基于维基内容生成第一份幻灯片或报告类产出
参考资料
- 原始灵感来源: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
- 架构设计详情: Wiki 架构设计
- 工作流程规范: SCHEMA