用途：直接操作 Fabric.so 官方 CLI，或在已有授权的 Fabric 连接器可用时使用该连接器，完成搜索、读写笔记/链接/文件、任务管理和项目记忆维护。不要把它包装成第二套命令目录，也不要把规划器的读取标签当作访问控制保证。
验证工具与工作区：fabric --version、fabric --help、fabric --json workspace current、fabric --json workspace list、fabric search --help。先确认这是 Fabric.so 而非同名程序；版本与帮助为本地检查，工作区检查会访问账户状态。任何写入前核对退出状态与返回的工作区；工作区名可能歧义，应保留提供商 ID。切换工作区会改变持久 CLI 上下文，需串行操作或使用明确的单命令作用域并重新确认目标。
安装与认证：官方安装脚本为 https://fabric.so/cli/install.sh，授权安装前先下载检查，不要默认将远程代码管道进 shell。优先浏览器登录。fabric auth <api-key> 会把密钥暴露在进程参数与历史记录中，应使用受支持的受保护认证方式，不要把凭据记入笔记。不要臆造已安装 CLI 未记录的环境支持。
搜索与取证：fabric --json search "project notes"、fabric --json search "design" --tag work、fabric --json path、fabric --json path "Inbox/Reports"。搜索用于候选内容，path 浏览已知文件夹；注意查询、标签、工作区和分页限制。摘要片段不等于完整来源，详细总结需通过受支持的 CLI/API/连接器动作获取原文，不要把 Fabric AI 助手解释当作源文档，也不要假设搜索已穷尽。fabric ask 属于委托代理执行，自然语言“只读”提示或旧的 ask-read 标签并不能禁用工具、写入或付费推理，仅在明确范围下使用。
保存与类型：授权写入时按已知类型使用 note、link、file；save 会自动推断类型，形似路径的文本可能被当作文件上传而非创建笔记，使用前先验证。note 命令的位置参数文本是正文而非标题，标题只能通过已安装命令公布的标志设置。上传前检查具体字节与附件范围，保留目标约束与返回 ID，并尽量按 ID 核验。
任务与变更：读取 fabric --json task list，在完成/编辑/删除前解析出确切任务。删除、切换工作区和远程助手执行都需要真实用户范围授权。分别检查 stdout、stderr、退出状态与响应结构。解析失败时不要在不带 --json 的情况下重跑变更，它可能已成功；应保存原始结果、按 ID/当前状态对账并报告未知结果。创建、保存或委托 ask 不假设存在未记录的幂等性。
项目记忆：仅在用户或既定项目指令授权时使用 memory 与 handoff，检索小范围相关内容，保留来源，先起草精简笔记再保存。不要上传原始会话，也不要信任启发式脱敏能清除所有密钥。
收尾：报告已确认的工作区、找到/更改的 ID、相关源内容与未决结果。生成的补全脚本是可执行 shell 代码，执行或写入启动文件前先检查。当前官方来源复核于 2026-09-13；应用 SDK 开发请使用 fabric-api，而非这些终端操作。