Notebook

核心用法

Notebook 是一款本地优先的通用对象追踪系统，用户可自由定义追踪类型（如想法、项目、任务、书籍、习惯等），通过 YAML 文件存储，完全脱离云端依赖。核心操作围绕三步：定义类型（type-add）→ 创建对象（add）→ 关联扩展（expand/link）。

显著优点

1. 极致灵活：字段类型覆盖 text、longtext、select、number、date、list，支持任意自定义 schema
2. 零供应商锁定：纯 YAML + JSON 本地存储，数据完全可控，可迁移至任何系统
3. 智能深化：expand 命令通过 AI 提问引导用户完善内容，降低记录负担
4. 对象互联：link 实现跨类型关联，构建知识网络而非孤立笔记
5. 渐进式上手：预设模板（Ideas/Projects/Tasks）+ 向导式初始化，降低冷启动门槛

潜在局限

• 无原生同步：需自行解决多端同步（Git/Syncthing/网盘）
• 无可视化界面：纯 CLI 操作，对非技术用户门槛较高
• 查询能力有限：find 为简单文本搜索，无高级过滤或聚合分析
• 依赖本地环境：YAML 解析与文件管理需要稳定的文件系统权限

适合人群

• 开发者、技术写作者、研究者等偏好本地数据控制的极客用户
• 需要高度定制化知识管理且厌恶 Notion/Evernote 功能膨胀的进阶用户
• 构建个人 wiki 或 Zettelkasten 系统，重视链接思维而非文件夹层级

常规风险

• 数据丢失：无自动备份机制，需用户自行版本控制
• YAML 语法敏感：手动编辑时缩进错误可能导致解析失败
• 索引损坏：index.json 若异常需手动重建
• 扩展性天花板：海量数据（10万+对象）时文件系统性能可能下降

Notebook Skill：本地优先的通用对象知识库

核心用法

Notebook 是一款本地优先的个人知识库工具，采用「类型定义 + 对象实例」的灵活架构。用户可自定义任意对象类型（如想法、项目、任务、书籍、联系人等），并为每种类型配置字段（文本、多行文本、下拉选项、数字、日期、列表等）。所有数据以 YAML/JSON 格式存储于本地工作目录，完全脱离云端服务。

核心命令覆盖完整生命周期：

• type-add 定义新类型与字段结构
• add/list/get/edit/delete 实现对象的增删改查
• expand 通过智能提问深化内容
• link 建立对象间关联，形成知识网络
• find/stats 支持全局搜索与统计分析

显著优点

1. 零云锁定：纯本地文件存储，数据完全自主可控，无需担心服务关停或隐私泄露
2. 无限扩展：不预设模板，支持任意对象类型和字段组合，适应个人工作流的独特需求
3. 可链接性：对象间可建立引用关系，从碎片化笔记演进为结构化知识图谱
4. 深度思考：expand 指令通过 AI 提问引导用户完善内容，超越简单记录
5. 格式友好：YAML 文本格式便于版本控制、脚本处理和长期存档

潜在局限

• 无原生同步：需自行解决多设备同步（Git、Syncthing、云盘等）
• 无移动端：纯命令行/文件交互，无图形界面应用
• 依赖用户设计：缺乏预设模板，新手需投入时间思考数据结构
• 搜索能力有限：基于文件系统的简单索引，大规模数据下性能待验证

适合人群

• 重视数据主权的隐私敏感用户
• 习惯命令行和文本工作流的开发者、研究者、作家
• 需要灵活追踪非标准化信息的知识工作者
• 希望构建个人知识管理系统（PKM）但排斥 Notion/Roam 等 SaaS 工具的用户

常规风险

• 数据备份责任：本地存储意味着用户需自行承担备份义务
• 类型设计成本：结构规划不当可能导致后期重构困难
• 输入验证边界：当前版本命令行参数解析依赖正则，复杂输入可能存在边界情况（已标记为 low 风险）