跳转到主要内容

​
插件目录

插件目录是 Fased 的公共 Skills 注册中心。Skills 是包含 SKILL.md 文件（以及可选辅助文件）的文件夹。你可以在网页应用中浏览 Skills，也可以使用 CLI 来搜索、安装、更新和发布 Skills。 网站：clawhub.com

​
适用人群（新手友好）

如果你想为 Fased 智能体添加新功能，插件目录是查找和安装 Skills 的正常路径。你不需要了解后端的工作原理。你可以：
  • 使用自然语言搜索 Skills。
  • 将 Skills 安装到你的工作区。
  • 之后使用一条命令更新 Skills。
  • 通过发布 Skills 来备份你自己的 Skills。

​
快速入门（非技术人员）

推荐使用浏览器 UI：
  1. 打开 Agents，选择要使用 skill 的 Agent。
  2. 打开 Agent > Skills。
  3. 在 Agent > Skills 中搜索。
  4. 点击结果，先审查来源、archive scan、权限、依赖安装计划和 wallet/mining 风险。
  5. 选择安装到共享 library 或该 Agent 工作区。
  6. 修复 readiness blocker（依赖、API key/env、config path）。
  7. 允许该 Agent 使用该 skill。
CLI 高级流程：
  • clawhub search "calendar"
  • fased skills marketplace install <skill-slug>
  • fased skills marketplace update <skill-slug> --dry-run

​
安装 CLI

任选其一： 
npm i -g clawhub

pnpm add -g clawhub

​
在 Fased 中的定位

推荐路径是 Agent > Skills，因为它会显示安装目标、审查结果、依赖健康和每 Agent access。CLI 直接安装时，Fased 从 <workspace>/skills、~/.fased/skills、内置和额外目录加载 Skills，并会在下一个会话中生效。 安装只表示 SKILL.md 已写入 library 或工作区。它不会自动安装依赖、授权 Agent、打开工具、授予钱包或启用 Mining。请在 Agent > Skills、Agent > Tools 和 Wallets > Skill Grants 中分别完成这些步骤。 有关 Skills 加载、共享和权限控制的更多详情，请参阅 Skills。

​
服务功能

  • 公开浏览Skills 及其 SKILL.md 内容。
  • 基于嵌入向量（向量搜索）的搜索，而不仅仅是关键词匹配。
  • 支持语义化版本号、变更日志和标签（包括 latest）的版本管理。
  • 每个版本以 zip 格式下载。
  • 星标和评论，支持社区反馈。
  • 审核钩子，用于审批和审计。
  • CLI 友好的 API，支持自动化和脚本编写。

​
CLI 命令和参数

常规 Fased 安装和更新请优先使用 fased skills marketplace install 和 fased skills marketplace update，这样在启用 Skills 前会检查来源、归档扫描警告和权限变更。下面的命令记录原始目录 CLI，用于搜索、发布、同步和高级注册表操作。 全局选项（适用于所有命令）：
  • --workdir <dir>：工作目录（默认：当前目录；回退到 Fased 工作区）。
  • --dir <dir>：Skills 目录，相对于工作目录（默认：skills）。
  • --site <url>：网站基础 URL（浏览器登录）。
  • --registry <url>：注册中心 API 基础 URL。
  • --no-input：禁用提示（非交互模式）。
  • -V, --cli-version：打印 CLI 版本。
认证：
  • clawhub login（浏览器流程）或 clawhub login --token <token>
  • clawhub logout
  • clawhub whoami
选项：
  • --token <token>：粘贴 API 令牌。
  • --label <label>：为浏览器登录令牌存储的标签（默认：CLI token）。
  • --no-browser：不打开浏览器（需要 --token）。
搜索：
  • clawhub search "query"
  • --limit <n>：最大结果数。
安装：
  • clawhub install <slug>
  • --version <version>：安装指定版本。
  • --force：如果文件夹已存在则覆盖。
更新：
  • clawhub update <slug>
  • clawhub update --all
  • --version <version>：更新到指定版本（仅限单个 slug）。
  • --force：当本地文件与任何已发布版本不匹配时强制覆盖。
列表：
  • clawhub list（读取 .clawhub/lock.json）
发布：
  • clawhub publish <path>
  • --slug <slug>：Skills 标识符。
  • --name <name>：显示名称。
  • --version <version>：语义化版本号。
  • --changelog <text>：变更日志文本（可以为空）。
  • --tags <tags>：逗号分隔的标签（默认：latest）。
删除/恢复（仅所有者/管理员）：
  • clawhub delete <slug> --yes
  • clawhub undelete <slug> --yes
同步（扫描本地 Skills + 发布新增/更新的 Skills）：
  • clawhub sync
  • --root <dir...>：额外的扫描根目录。
  • --all：无提示上传所有内容。
  • --dry-run：显示将要上传的内容。
  • --bump <type>：更新的版本号递增类型 patch|minor|major（默认：patch）。
  • --changelog <text>：非交互更新的变更日志。
  • --tags <tags>：逗号分隔的标签（默认：latest）。
  • --concurrency <n>：注册中心检查并发数（默认：4）。

​
智能体常用工作流

​
搜索 Skills

clawhub search "postgres backups"

​
下载新 Skills

fased skills marketplace install my-skill-pack

​
更新已安装的 Skills

fased skills marketplace update --dry-run
fased skills marketplace update --approve-permission-change

​
备份你的 Skills（发布或同步）

对于单个 Skills 文件夹： 
clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest
一次扫描并备份多个 Skills： 
clawhub sync --all

​
高级详情（技术性）

​
版本管理和标签

  • 每次发布都会创建一个新的语义化版本 SkillVersion。
  • 标签（如 latest）指向某个版本；移动标签可以实现回滚。
  • 变更日志附加在每个版本上，在同步或发布更新时可以为空。

​
本地更改与注册中心版本

更新时会使用内容哈希将本地 Skills 内容与注册中心版本进行比较。如果本地文件与任何已发布版本不匹配，CLI 会在覆盖前询问确认（或在非交互模式下需要 --force）。

​
同步扫描和回退根目录

clawhub sync 首先扫描当前工作目录。如果未找到 Skills，它会回退到已知的旧版位置（例如 ~/fased/skills 和 ~/.fased/skills）。这样设计是为了在不需要额外标志的情况下找到旧版 Skills 安装。

​
存储和锁文件

  • 已安装的 Skills 记录在工作目录下的 .clawhub/lock.json 中。
  • 认证令牌存储在目录 CLI 配置文件中（可通过 CLAWHUB_CONFIG_PATH 覆盖）。

​
遥测（安装计数）

当你在登录状态下运行 clawhub sync 时，CLI 会发送一个最小快照用于计算安装次数。你可以完全禁用此功能： 
export CLAWHUB_DISABLE_TELEMETRY=1

​
环境变量

  • CLAWHUB_SITE：覆盖网站 URL。
  • CLAWHUB_REGISTRY：覆盖注册中心 API URL。
  • CLAWHUB_CONFIG_PATH：覆盖 CLI 存储令牌/配置的位置。
  • CLAWHUB_WORKDIR：覆盖默认工作目录。
  • CLAWHUB_DISABLE_TELEMETRY=1：禁用 sync 的遥测功能。
已有 .clawhub lockfile 会继续保留，因此已安装的 Skills 仍可更新。