核心用法
得到大脑（Get笔记）Skill 是连接官方 OpenAPI 的个人知识管理工具，提供六大核心能力：
1. 多模态笔记保存（/note save）
- 文本速记：直接输入内容生成笔记
- 链接收藏：自动提取网页标题、正文与摘要，支持异步轮询处理
- 图片存储：获取上传凭证后保存图片笔记
- 内置防重与限流保护，建议创建间隔 1 分钟以上
2. 语义搜索召回（/note search）
- 全局语义搜索：基于向量相似度检索全库笔记
- 知识库限定搜索：在指定知识库内精准召回相关内容
3. 笔记生命周期管理（/note list）
- 分页浏览、详情查看、内容更新、删除与分享链接创建
- 严格区分内链（
biji.com/note/{id}，私有）与分享链接（share_note/{id}，公开）
4. 知识库运营（/note kb）
- 创建/订阅知识库、批量添加/移除笔记
- 订阅博主内容、关注直播动态，构建结构化知识体系
5. 标签体系（/note tag）
- 为笔记添加或删除标签，支持灵活分类
6. OAuth 配置（/note config）
- 引导用户完成 API Key 与 Client ID 授权，支持可选的 Owner ID 白名单校验
---
显著优点
- 官方 API 直连：由得到大脑团队提供开放接口，数据同步可靠，非爬虫方案
- 语义搜索能力：基于向量Embedding的语义召回，优于传统关键词匹配
- 异步任务保障：链接/图片保存采用任务轮询机制，确保数据完整入库
- 安全设计完善：支持私有笔记白名单校验、群聊隐私保护、错误码分级处理
- 大数精度处理：针对 int64 笔记 ID 提供 JSON 解析防护，避免 JavaScript 精度丢失
---
潜在缺点与局限性
- 会员门槛：非会员触发 10201 错误，需引导付费开通
- 限流约束：高频创建易触发 QPS 限流（错误码 10202），需 backoff 重试
- 异步延迟：链接/图片笔记需 10-30 秒轮询等待，非即时生效
- ID 处理复杂：JavaScript 环境需手动替换正则处理大整数，增加接入成本
- 依赖三方服务：API 可用性受制于得到大脑服务端状态
---
适合人群
- 得到大脑重度用户，希望通过 AI Agent 自动化笔记 workflows
- 需要构建个人知识库并进行语义检索的知识工作者
- 追求「看到即保存」的链接收藏爱好者
- 希望打通多平台内容聚合的进阶用户
---
常规风险
- 隐私泄露风险：笔记内容属个人敏感数据，需在可信环境配置 API Key，避免硬编码泄露
- 误操作风险：批量删除、知识库移除等操作不可逆，建议二次确认
- 服务中断风险：官方 API 变更或下线可能导致 Skill 失效
- 会员续费依赖：核心功能绑定付费会员，存在持续成本
- 数据归属风险：笔记数据存储于得到大脑服务端，需关注其隐私政策变更