Agent Skills
返回列表
💻

Fabric 工作区 HTTP API

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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` 字段的产品或自动化搭建者