fabric-api

Fabric API Skill 是一套面向 Fabric.so 知识管理平台的自动化接口工具，允许用户通过标准 HTTP API 对工作空间中的笔记（notepads）、文件夹、书签等资源进行创建、搜索和管理操作。

核心用法

该技能基于 curl 命令行工具与 Fabric API 进行交互，提供了完整的 CRUD 操作支持。用户可以通过简单的 JSON 配置创建便签内容（支持 Markdown 格式）、组织文件夹结构、保存网络书签，以及利用搜索功能快速定位历史资源。所有操作均通过 X-Api-Key 头部进行身份验证，并严格遵循 RESTful 设计规范。特别值得注意的是，技能明确指出了常见的 API 陷阱，例如必须使用 /v2/notepads 而非 /v2/notes 创建笔记，以及 parentId 参数的必要性。

显著优点

首先，该技能采用纯文档化设计，仅包含 Markdown 说明和 YAML 配置文件，无任何可执行脚本，从根本上消除了代码注入和恶意执行风险。其次，安全实践规范，强制使用环境变量 FABRIC_API_KEY 存储敏感凭证，避免了密钥硬编码带来的泄露风险。第三，提供了详尽的 curl 模板和错误处理建议（如 --fail-with-body 参数），降低了用户的使用门槛。第四，支持灵活的资源组织方式，包括标签系统和别名定位（如 @alias::inbox），便于构建结构化的知识管理体系。

潜在缺点与局限性

作为 T3 级社区来源项目，该技能由个人开发者维护，非 Fabric 官方出品，长期维护和兼容性保障存在一定不确定性。功能上完全依赖 Fabric 官方 API 的可用性和网络连接，离线场景无法使用。此外，API 调用存在速率限制（429 错误），高频自动化场景需要自行实现退避重试机制。用户还需自行申请和管理 API Key，增加了初始配置复杂度。

适合的目标群体

主要面向 Fabric.so 的重度用户、知识管理自动化爱好者以及需要将 Fabric 集成到现有工作流的开发者。特别适合那些希望通过脚本批量创建笔记、自动归档网页书签或构建个人知识库自动化管道的用户。对于企业团队，也可用于构建内部知识共享的自动化流程。

使用风险

常规风险包括：外部服务依赖导致的单点故障（Fabric 服务不可用将直接影响功能）；API 版本变更可能导致的接口不兼容；API Key 管理不当可能导致的数据泄露风险；以及网络延迟对实时性的影响。建议用户妥善保管 API Key，实施最小权限原则，并关注 Fabric API 的更新日志。

核心用法

fabric-api 是一个纯 Markdown 文档型技能，旨在帮助用户通过 HTTP API 与 Fabric.so 工作空间进行交互。它不提供可执行代码，而是提供详尽的 curl 命令模板和 API 使用指南，覆盖以下核心操作：

• 创建笔记（Notepad）：通过 POST /v2/notepads 端点，支持 markdown 内容、标签和父级文件夹指定
• 创建文件夹：通过 POST /v2/folders 端点，支持嵌套结构
• 创建书签：通过 POST /v2/bookmarks 端点，保存网页链接并附加标签
• 浏览资源：通过 POST /v2/resources/filter 列出文件夹内容
• 全文搜索：通过 POST /v2/search 进行模糊匹配查询

所有操作均使用 FABRIC_API_KEY 环境变量进行身份验证，默认指向官方 api.fabric.so 域名。

显著优点

1. 零代码执行风险：纯文档型技能（T-MD 分类），无可执行脚本、无动态加载、无依赖风险
2. 安全凭证管理：强制使用环境变量管理 API 密钥，无硬编码敏感信息
3. 官方 API 集成：所有端点均指向 Fabric.so 官方服务，TLS 加密传输
4. 详尽的文档：包含常见错误排查、标签安全模式、速率限制处理等实用指南
5. 来源可信：来自 GitHub 组织 clawdbot，有明确的维护者和版本历史

潜在缺点与局限性

1. 功能受限：仅为文档参考，不封装高级功能如批量操作、自动同步、离线缓存
2. API 版本依赖：示例基于特定 API 版本，Fabric 官方更新后可能需要手动调整
3. 无错误恢复机制：curl 模板需用户自行处理重试逻辑和错误解析
4. 速率限制敏感：高频调用可能触发 429 限制，需手动实现退避策略

适合人群

• 熟悉命令行和 curl 的开发者
• 需要轻量级 Fabric.so 集成、不愿引入重型 SDK 的用户
• 注重安全透明、希望完全控制 API 调用的技术用户
• CI/CD 流水线需要自动化 Fabric 内容管理的场景

常规风险

• API 密钥泄露风险：需妥善保管 FABRIC_API_KEY 环境变量
• 误操作风险：直接调用生产 API，创建/删除操作不可逆
• 网络依赖：完全依赖 Fabric.so 服务可用性和网络连接
• 无本地缓存：所有操作实时联网，无离线能力