Notebook

Notebook：个人对象化知识库系统

核心用法

Notebook 是一款基于用户自定义对象类型的个人知识管理工具，采用「类型-对象」双层架构。用户首先定义关注的对象类型（如想法、项目、书籍、人物等），为每种类型配置专属字段（文本、选择、数字、日期等），随后即可创建具体对象实例。系统提供完整的 CRUD 操作、对象间双向链接、标签分类、全文检索及统计功能，数据以 YAML 格式本地存储，确保完全可控。

显著优点

• 高度灵活：突破固定模板限制，用户可定义任意对象类型与字段结构
• 本地优先：纯 YAML 文件存储，无云服务依赖，支持版本控制与迁移
• 关联能力：对象间可建立双向链接，构建网状知识结构
• 渐进扩展：支持随时添加字段、深化内容、调整类型定义
• 智能深化：内置「expand」交互模式，通过提问引导用户完善内容细节

潜在局限

• 需用户自主设计数据模型，对结构化思维有一定要求
• 无内置同步机制，多设备协作需自行搭建方案
• 依赖命令行交互，图形化管理能力有限
• 复杂查询与大型数据集性能未经充分验证

适合人群

• 追求数据主权的技术型用户与开发者
• 需要跟踪多样化非结构化信息的创作者、研究者
• 习惯命令行工作流的知识管理爱好者
• 希望避免 Notion/Roam 等 SaaS 锁定风险的用户

常规风险

• 本地文件需自行备份，误操作可能导致数据丢失
• 自定义模型设计不当可能造成后期重构成本
• 字段类型变更可能影响既有数据完整性
• 长期维护需投入持续的类型治理精力

核心用法

Notebook 是一款对象型个人知识库（Object-Based PKM）工具，采用「类型定义 → 实例创建 → 智能扩展」的工作流。用户通过 notebook type-add 自定义跟踪对象（如想法、项目、书籍、人物），每个类型可配置文本、下拉选择、数字、日期等字段。对象支持双向链接（notebook link）与深度追问扩展（notebook expand），形成网状知识图谱。

显著优点

1. 极致隐私安全：纯本地运行，零网络请求，数据存储于 YAML/JSON 文件，无云同步、无供应商锁定
2. 高度可定制：用户自主定义对象类型与字段，而非被迫适应预设模板
3. 轻量无依赖：仅依赖 js-yaml 和 uuid 两个知名安全包，代码透明可审计
4. 智能工作流：内置「引导式 onboarding + 深度追问扩展」机制，降低冷启动摩擦
5. Linkable 设计：对象间双向链接，支持跨类型关联（如「想法」链接到「项目」）

潜在缺点与局限性

• 无协作功能：本地优先意味着不支持多人实时协作或云端共享
• 无移动端同步：缺乏官方跨设备同步方案，需用户自行解决（如 Git/Syncthing）
• 功能边界清晰：定位为轻量个人知识库，不支持复杂查询、图谱可视化或全文检索
• 输入验证待加强：CLI 参数解析依赖简单正则，存在潜在 YAML 注入风险（需用户自律）

适合人群

• 隐私优先用户：拒绝云服务、追求数据主权的知识工作者
• 定制控与开发者：希望按自己思维逻辑构建 PKM 系统，而非套用 Notion/Obsidian 模板
• 轻量知识管理需求：不需要复杂功能，追求「定义 → 记录 → 链接」极简闭环
• 本地优先倡导者：认同「文件即数据库」理念，希望知识库可版本控制、可编程访问

常规风险

• 数据丢失风险：本地存储无自动备份，用户需自行建立备份机制
• 路径遍历潜在风险：若 Skill 未严格校验用户输入的路径参数，可能存在文件覆盖风险（需确认实现）
• YAML 解析特性：js-yaml 默认解析完整 YAML 语法，恶意构造的字段值可能触发意外行为