Fabric笔记管理

技能简介

通过HTTP API与Fabric工作区交互，支持创建笔记、文件夹、书签，以及搜索和浏览资源。

业务背景

Fabric笔记管理通过HTTP API将个人知识库与业务流程打通，员工无需切换界面即可在Fabric工作区中沉淀会议纪要、项目文档和参考资料。统一的内容创建与检索入口减少信息碎片化，确保团队知识资产集中存储、结构清晰，提升协作效率与知识复用率。

落地案例：项目经理收到客户需求后，直接调用API在"客户项目"文件夹下创建markdown格式的需求分析笔记，并附加相关竞品调研书签。后续团队成员可通过关键词搜索快速定位该笔记，避免邮件或本地文件来回传递造成的版本混乱。

能做什么

• 创建markdown格式的笔记并指定存放位置
• 新建文件夹组织内容结构
• 保存网页书签并附加标签
• 按关键词搜索现有资源
• 浏览指定文件夹内的子资源

使用说明

安装准备

1. 获取Fabric API密钥（FABRIC_API_KEY）
2. 确保系统已安装curl

配置示例

{"skills":{"entries":{"fabric-api":{"enabled":true,"apiKey":"YOUR_FABRIC_API_KEY"}}}}

基础调用格式

curl -sS --fail-with-body "https://api.fabric.so/v2/ENDPOINT" \
  -H "X-Api-Key: $FABRIC_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{ "payload": "here" }
JSON

关键注意点

• 笔记创建端点为/v2/notepads而非/v2/notes
• 未指定目标文件夹时，默认使用@alias::inbox
• 标签格式为对象数组，如[{"name":"标签名"}]

输入与输出

见下方输入与输出表格。

风险提示

• API密钥泄露可能导致工作区数据被访问或篡改
• 重复提交创建请求可能产生重复内容（无内置幂等机制）
• 429限流时需主动退避重试，避免触发更严格限制
• 错误的parentId或resourceId会返回404，需确认UUID正确性

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/tristanmanchester/fabric-api/SKILL.md
来源类型：GitHub仓库