Fabric 工作区 HTTP API
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-fabric-api。
技能介绍
要解决什么问题
当你在自动化脚本或 Clawdbot 里需要操作 Fabric 工作区——把用户口述的 Markdown 落成记事本、建文件夹归类、加书签,或按模糊描述找回某条内容——直接翻 OpenAPI 很容易踩坑:记事本走 POST /v2/notepads 而不是 /v2/notes,创建时 parentId 必填,标签必须是对象数组而不是字符串。
技能如何工作
技能围绕 https://api.fabric.so,用 X-Api-Key 鉴权(环境变量 FABRIC_API_KEY),并给出可复制的 curl + heredoc 模板,避免 JSON 引号问题。
核心能力包括:
- 创建记事本:
POST /v2/notepads,用户标题映射为name,正文用text传 Markdown;未指定目录时默认parentId: "@alias::inbox"。 - 建文件夹 / 书签:
POST /v2/folders、POST /v2/bookmarks。 - 浏览与搜索:用
POST /v2/resources/filter列出某文件夹子资源;用POST /v2/search处理「关于某某的那篇笔记」这类模糊检索。 - 标签:
GET /v2/tags列举;创建用POST /v2/tags;创建资源时仅用[{"name":"x"}]或[{"id":"..."}],校验失败可先省略再在后续接口挂标签。
调试时建议 curl 加 --fail-with-body,便于看清 4xx 响应体;遇到 429 应退避重试,且不要盲目重试创建请求以免重复资源。细节以技能目录内 fabric-api.yaml OpenAPI 为准。
适用边界
这是 HTTP/curl 调用规范,不负责 Fabric 客户端 UI 或 OAuth 登录流。403/404 多与订阅权限、parentId/资源 ID 错误或端点写错有关;复杂结构化内容需了解 ydoc 字段,而非常规 Markdown 场景用 text 即可。
使用场景
- 对话里用户说「把这段 Markdown 存进 Fabric 收件箱」,需按 notepads 接口创建并带上 parentId
- 自动化脚本要在指定 Fabric 文件夹下批量建子文件夹,再写入书签链接
- 用户只记得笔记主题关键词,需用 search 接口检索再读出对应资源
- 创建记事本时标签格式报错,需先省略 tags 创建,再用 /v2/tags 单独挂标签
适合人员
- 已用 Clawdbot 等 agent 编排任务、且工作流依赖 Fabric 作为笔记归档后端的工程师
- 写 shell 脚本同步外部内容到 Fabric,需要正确 parentId 与别名(inbox/bin)的运维或数据录入同学
- 对接 Fabric OpenAPI 时反复遇到 400 标签或 404 端点,希望按规范 curl 模板排障的后端开发者
- 为团队定制「口述即入库」能力,要把用户标题映射到 API `name` 字段的产品或自动化搭建者