核心用法
Capacities Skill 是专为个人知识管理工具 Capacities 设计的 API 集成方案，通过四个核心端点实现与"第二大脑"的无缝交互：
1. 每日笔记（Daily Notes）：支持向当日笔记快速添加想法、任务或任意 Markdown 格式内容，适合捕捉灵感与日程管理
2. 网页收藏（Web Links）：一键保存网页 URL 至指定空间，构建个人阅读库与参考资料体系
3. 智能搜索（Lookup）：通过关键词检索对象 ID，实现笔记内容的精准定位与关联
4. 空间概览（Space Info）：获取空间内所有对象类型与结构信息，便于理解知识库架构
显著优点
- 原生 Markdown 支持：内容录入采用标准 Markdown 格式，兼容性强，迁移成本低
- 无代码操作：基于 curl 的简洁 HTTP 请求设计，技术门槛低，易于脚本化与自动化
- 空间灵活切换：支持多空间管理，未指定时自动使用默认空间，适应个人与团队协作场景
- 实时同步：直接调用官方 API，数据即时写入云端，多端同步无延迟
潜在局限
- 只写为主：当前接口以创建和查询为主，暂不支持复杂编辑、版本回溯或批量删除操作
- 结构化受限：缺乏对 Capacities 核心功能如双向链接、属性字段、数据库视图的深度操控
- 依赖桌面端配置：API Token 需从桌面应用获取，纯移动端用户配置流程受限
- 速率限制未明示：官方未公开 API 调用频次限制，高频自动化场景存在不确定性
适合人群
- Capacities 重度用户，追求自动化工作流（如配合 Raycast、Alfred 快速记录）
- 需要将外部信息源（RSS、浏览器）定向汇入个人知识库的整合型用户
- 习惯命令行或脚本工具的技术爱好者与效率工具玩家
- 跨平台内容采集需求强烈的知识工作者
常规风险
- Token 泄露风险：API Token 具备完整写入权限，若硬编码于公开仓库或日志中，可能导致数据被篡改或删除
- 空间误操作：未正确配置
CAPACITIES_SPACE_ID时，内容可能写入非预期空间，建议生产环境显式指定 - API 稳定性：Capacities 为较新的笔记工具，API 版本迭代可能引入破坏性变更，需关注官方更新公告