跳转至

讨论 — 知识库结构借鉴卡帕西

原文 / 原始内容

借鉴卡帕西的知识结构,构建 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 实现)