个人知识库体系 · 搭建模板（Skill）
〇、阅读指南（先读这里，再决定往下读多少）
按需求深度分层读，不要一次读完全部文档：
| 你的目标 | 只需要读 | 其余可跳过 |
|---|---|---|
| 把模板交给用户用（30 秒） | 本文件「一、这是什么」 | 全部 |
| 帮用户把模板改成他的领域 | references/worked-example.md（照抄作业） |
cloud-setup |
| 用户要多端同步 | references/cloud-setup.md |
worked-example |
| 报错、异常、用不出 | references/faq.md（先查故障排查表） |
全部 |
| 深度定制（增删卡片/改字段） | references/structure.md |
— |
一、这是什么
一套个人知识库体系的「搭建模板 + 方法论」。它把知识管理拆成三层结构：
- 卡片层（CARDS）：把知识/方法变成一张张可检索的卡片——决策清单、检查清单、SOP 流程、主题库、收件箱、明确不做。
- 清单层（CHECKLISTS）：每张"清单卡"背后是可打勾的执行清单，用完即勾，系统自动统计「有效率」。
- 主题库层（THEME_LIBS）：跨书/跨课聚合的精华知识，按主题沉淀，遇到问题时一键调阅。
配套一个单文件网页（assets/knowledge-console.html），内置：关键词搜索、按类型分组、打勾执行、30 秒记录（有效/无效 + 原因）、月度复盘报告、使用率/有效率角标、过期提醒、导出/导入备份、可选的云端多端同步。
附带示范：assets/demo-video-kb.html 是同一套模板填进「短视频创作」场景的成品示范，可直接当模板看，也可照着改成用户自己的领域。
二、什么时候用（触发场景）
用户表达以下任一意图时，自动加载本 Skill（无需用户手动指定）：
- "我想搭一个自己的知识库 / 第二大脑"
- "怎么把读过的书、踩过的坑、验证过的方法沉淀下来，别每次从头想"
- "给我一个知识管理的模板，我自己填内容"
- "帮我把这些散乱的笔记体系化"
- "我想要一个能打勾、能复盘、能追踪'哪条方法有效'的清单工具"
能力边界（必须先向用户说清）：
- 本 Skill 提供的是模板 + 方法 + 工具，不是现成产品：示例内容是占位的，用户必须替换成自己的内容（或让 AI 按
references/worked-example.md代填）。 - 浏览器要求：Chrome / Edge 等现代浏览器双击即用；
file://直开时"打开 md 文件"等本地链接受限，完整能力需线上部署（改BASE_PATH）。 - 数据存于浏览器
localStorage（约 5MB，纯文本记录可用数年）；不要往里存图片/视频。浏览器隐私模式或禁用存储时记录无法保存（页面会明确提示）。 - 云端同步需使用者自己的 WorkBuddy 应用与两张数据表；模板默认纯本机，不配云端也能完整使用。
三、怎么用（给 AI 的操作流程）
- 直接给模板：把
assets/knowledge-console.html交给用户（发文件或告知路径）。用户双击即可用——纯本机localStorage，零配置、零联网。 - 改成自己的：按
references/worked-example.md的完整案例照抄改数据层三处：CARDS、CHECKLISTS、THEME_LIBS；字段规范见references/structure.md。 - 接云端（可选）：按
references/cloud-setup.md填endpoint+publishableKey，实现手机/电脑同步。不填则一直纯本机。
四、FAQ / 反模式 / 故障排查
常见问题、错误用法（反模式）、报错对照表统一在 references/faq.md。遇到问题先查它，不要凭空猜测，也不要向用户索要本文件里已有的信息。
五、核心设计原则（这套体系为什么好用）
- 知识卡片化、索引化：别堆成长文，一张卡解决一类问题。
- 方法必须可执行：每张清单能打勾，每条使用记录能追「有效/无效 + 原因」。
- 反馈闭环：月度复盘自动指出「哪些清单待修订、哪些从没用过、哪些已验证健康」，让知识库越用越准，而不是越积越乱。
- 主题库跨源聚合：一条知识只挂一个主题，保留来源可回原文。
- 防踩坑区（明确不做）：把试过没用的事写下来，防止反复踩同一个坑。
六、脱敏与版权说明（重要）
本模板已彻底脱敏，可直接分享：
- 不含任何原作者的业务数据、个人账号、二维码、云端凭证。
- 不含任何书籍/课程的原文版权内容——
THEME_LIBS/CARDS/CHECKLISTS均为通用示例占位，用户自行替换成自己的内容。 - 云端
endpoint/publishableKey默认为空（纯本地模式），必须由使用者填自己的 WorkBuddy 应用配置。
七、文件索引
assets/knowledge-console.html— 单文件知识台通用模板（双击即用）assets/demo-video-kb.html— 「短视频创作」场景示范版references/worked-example.md— 照抄作业：20 分钟把模板改成你自己的领域（含可直接粘贴的代码片段）references/structure.md— 数据字段规范与「增删卡片 / 改清单 / 改主题库」配方references/cloud-setup.md— 云端多端同步的配置步骤与数据表结构references/faq.md— FAQ、反模式、故障排查对照表
八、版本
- 1.1.0：按 TRACE 评测优化——云端报错分类提示 + 断线自动补传 + 存储禁用明确提示；新增阅读指南、触发场景、能力边界、FAQ/反模式、照抄作业案例。
- 1.0.0：初版。
九、分享给别人（两种途径）
- 途径 A（最简单）：把 Skill 文件夹
personal-knowledge-console/整个发给对方，放到对方~/.workbuddy/skills/即可；或直接发assets/knowledge-console.html双击用。 - 途径 B（上架技能市场）：在 WorkBuddy 技能市场发布，其他人一键安装。发布动作需使用者确认/授权。
