讨论 — 知识库结构借鉴卡帕西¶
原文 / 原始内容¶
借鉴卡帕西的知识结构,构建 wiki 和 raw 其中 raw 是原始的素材, wiki 是结构化的知识。 我希望实现: 1. 能不断迭代改进,并且问题和改进有记录和总结 2. 如果我提出新的功能 需求 ,raw 里如何记录?wiki 里如何梳理?数据结构?api 接口?我希望不仅适合不断改进优化,也适合多人协作,后端看到就知道需要做什么。 3. 这个库我想同步 github,但是备份不同步,代码和只是内容要同步 4. 所有的只是文档要有索引 每个文档要有 title 以及 元描述 标签等,便于我后续在 obsidian 中查看以及让 AI 学习了解知识库
请分析我的需求,梳理文件夹的梳理结构,注意:区别于卡帕西的知识库,这里还包含代码和构建后的内容以及版本备份。
上下文¶
- 当前版本 v0.10.22
- 之前已建立
docs/{wiki, rules, issues}/三层体系 - 用户在使用 obsidian 管理个人知识库
- 项目可能要走多人协作(暗示后端独立开发)
我的初步理解¶
用户想要的核心点: 1. raw 是入口:粘贴即可,捕获一切(用户/AI 都低门槛写入) 2. wiki/specs 是出口:结构化,多人协作可读 3. 改进有记录:迭代过程可追溯(已有 issues + 开发日志) 4. github 同步:代码 + 文档同步,备份不同步 5. obsidian + AI 友好:frontmatter + tags + 索引
需要新增的: - raw/ 层(原始素材,包括 conversations / feedback / ideas) - specs/ 层(功能规格,介于 raw 和 wiki 之间,多人协作的契约) - 所有文档加 YAML frontmatter - .gitignore 隔离 backup/
处理方向¶
- 归入 spec → SPEC-001-知识库改造
- 同时归档作为 raw/conversation(本文件)— 让原始诉求可溯源
处理后回链¶
→ SPEC-001-知识库改造(v0.10.22 实现)