云端skill市场和云端agent市场可行性调研

[nieshao001]

我们团队想要为我们的项目anyclaw添加云端skill市场和云端agent市场，我们想知道把skill和agent数据放在云端相对于下载到本地的优缺点是什么，以及这个云端市场具体应该如何实现，实现方法有哪一些。

[nieshao001]

@xgopilot 帮我调研一下

[fennoai]

调研结论

结合仓库现状看，AnyClaw 目前已经有 3 个可复用基础：

• cmd/anyclaw/skill_cli.go：已经支持远程搜索、catalog、安装到本地。
• pkg/capability/skills/skillshub.go：已经有云端 skill 检索与从 GitHub 拉取 SKILL.md 的能力。
• pkg/gateway/gateway_control_plane_agents_api.go：已经支持 agent profile 的本地增删改查，但 agent 市场还没有对应的云端 catalog / install 流程。

这意味着最合理的方向不是“把 skill 和 agent 直接搬到云端运行”，而是先做“云端市场 + 本地安装/启用 + 本地执行”的混合架构。这样和项目 README 里的 local first 定位一致，改造成本也最低。

云端 vs 本地

把数据放云端的优点：

• 市场内容可实时更新，不需要随版本发版。
• 可以做评分、下载量、标签、搜索排序、版本约束、下架。
• 多端共享 catalog，Web UI 和 CLI 可以看到同一份市场数据。
• 后续可做签名、风控、兼容性校验、灰度发布。

把数据放云端的缺点：

• 引入网络依赖，搜索、详情、安装会受可用性影响。
• 安全面更复杂，尤其 skill/agent 一旦携带 prompt、权限、entrypoint，就需要做签名、来源校验、版本冻结。
• 如果直接云端执行，会和当前本地工作区、本地工具、本地权限模型冲突，复杂度会陡增。
• 离线场景会退化，和 AnyClaw 当前“本地优先”方向不完全一致。

把数据下载到本地的优点：

• 启用后可离线运行，执行稳定。
• 权限边界更清晰，和现有 skills dir、agent profile、plugin trust 模型更一致。
• 便于做版本锁定、回滚、审计。

本地方案的缺点：

• 更新滞后，需要手动刷新或升级。
• 搜索、榜单、审核、统计能力弱。
• 多机器之间难以同步。

推荐架构

推荐分 2 层：

• 云端控制面：只存 catalog 元数据，不直接承载执行态。
• 本地数据面：skill/agent 安装到本地目录或本地配置，由本地 runtime 执行。

skill 市场建议数据模型：

• 基础元数据：name、version、description、author、tags、homepage、source。
• 安全元数据：permissions、signer、checksum、min_anyclaw_version、trusted_domains。
• 分发元数据：install_type（builtin / github / registry）、entrypoint、manifest_url、readme_url。

agent 市场建议数据模型：

• 基础元数据：name、description、role、persona、avatar、category。
• 运行元数据：default_model、provider_constraints、permission_level、working_dir_policy。
• 依赖元数据：skills[]、recommended_plugins[]、required_capabilities[]。
• 安全元数据：signer、checksum、compatibility、publish_status。

3 种实现路径

1. 轻量路径，优先推荐

• skill 市场继续复用 skills.sh 风格接口。
• 新增 AnyClaw 自己的 agent catalog API。
• 安装时只是把 skill 写入本地 skills/，把 agent 写入本地 AgentProfile。
• 适合先把“发现、详情、安装、启用”闭环做出来。

优点：改动小，和现有代码最贴合。
缺点：skill 和 agent 的市场协议不统一，后期要再抽象。

2. 中期路径，统一 registry

• 设计统一的 marketplace API：/catalog/search、/catalog/{type}/{name}、/install/manifest。
• type 支持 skill、agent，返回统一 manifest。
• CLI 和 Web UI 都走统一协议。

优点：后续扩展 plugin / channel 也方便。
缺点：需要补一层 catalog 协议抽象。

3. 重路径，不建议第一阶段做

• 云端托管 agent/skill 配置，客户端按需拉取，甚至远程执行。
• 引入账号体系、租户、同步、远程沙箱、云端审计。

问题：这已经接近“云端 agent 平台”而不是“本地优先工作台增强”，成本和风险都明显更高。

具体落地建议

第一阶段建议只做“云端市场，本地执行”：

• skill：保留当前安装模型，补充 marketplace metadata + 签名/校验 + 更新检查。
• agent：新增 agent catalog、agent install、agent update，安装结果落到本地 AgentProfile。
• UI：市场页展示 skills 和 agents 两个 tab，支持搜索、详情、安装、启用。
• CLI：建议补 anyclaw agent search、anyclaw agent install、anyclaw agent info。

第二阶段再做：

• 版本升级策略：固定版本、自动检测更新、手动升级。
• 信任体系：签名、公钥、发布者认证、权限提示。
• 兼容性：AnyClaw 版本约束、模型/供应商约束、平台约束。

关键风险

• 安全风险：agent/skill 本质上会影响 prompt、权限和执行行为，必须有签名、校验和权限确认。
• 可重复性风险：如果只记录“最新版本”，用户环境会漂移，建议安装时写入版本和 checksum。
• 供应链风险：当前 skill 安装依赖远端内容拉取，后续建议引入 manifest 签名和内容摘要。
• 兼容性风险：不同 agent 依赖不同模型、skill、plugin，不做约束会导致“能安装不能运行”。

建议的最终判断

建议采用：云端 catalog + 本地安装 + 本地执行 + 本地缓存。
不建议第一阶段采用：云端托管运行时 或 纯云端 agent/skill。

原因很直接：它最符合当前仓库已有实现，也最符合 AnyClaw 的 local first 产品定位。

下一步可开发项

• 增加统一 marketplace manifest 结构，先覆盖 skill 与 agent。
• 给 agent 增加和 skill 对称的 search/install/info 命令。
• 网关增加 marketplace API 代理层，供 Web UI 使用。
• 安装链路增加签名、checksum、权限确认、兼容性校验。
• 本地缓存 catalog，支持离线浏览最近一次市场数据。

未做的事：本次仅完成方案调研，没有修改代码，也没有接入外部市场服务。

View job run

[nieshao001]

@xgopilot 你的建议不错，可以继续细化拆分，给出一条条具体的功能实现方面的清单嘛

[fennoai]

结论

建议继续按 云端 catalog + 本地安装 + 本地执行 + 本地缓存 落地，不建议第一阶段做云端运行时。仓库现状也支持这个方向：cmd/anyclaw/skill_cli.go 已有远程 skill search/install/catalog，pkg/capability/skills/skillshub.go 已有对 skills.sh 的检索与安装能力，pkg/gateway/gateway_control_plane_agents_api.go 已有本地 agent 配置 CRUD。

第一阶段必须做的功能清单

1. 市场数据模型统一

• 定义统一 marketplace manifest，区分 type=skill|agent。
• 公共字段：name、version、description、author、tags、homepage、source、publish_status。
• 安全字段：checksum、signer、signature、min_anyclaw_version、trusted_domains。
• 运行字段：permissions、entrypoint、default_model、provider_constraints、working_dir_policy。
• 依赖字段：skills[]、plugins[]、required_capabilities[]。

2. 云端 catalog API

• GET /marketplace/search?type=skill|agent&q=&page=&page_size=
• GET /marketplace/items/{type}/{name}
• GET /marketplace/items/{type}/{name}/versions
• GET /marketplace/items/{type}/{name}/manifest
• GET /marketplace/items/{type}/{name}/readme
• 返回值里必须带版本、摘要、权限、依赖、兼容性、安装来源。

3. skill 市场补齐

• 保留现有 skills.sh 搜索能力，但对外统一包装成 marketplace skill。
• 新增 skill detail 接口，不只是 search 列表。
• 安装前增加 checksum 校验。
• 安装前增加权限预览与确认。
• 安装后写入本地 installed.json 或等价索引，记录 name/version/source/checksum/install_time。
• 新增 skill update、skill uninstall、skill upgrade --check。

4. agent 市场补齐

• 新增 agent catalog/search/info/install/update/uninstall 命令。
• agent 安装结果落本地 AgentProfile，不要直接云端运行。
• 安装时自动检查依赖 skills、provider、permission level。
• 支持 agent manifest 中引用多个 skills，并给出缺失依赖提示。
• 支持 agent 的头像、persona、role、默认模型、权限级别、工作目录策略导入。

5. CLI 命令清单

• anyclaw marketplace search <query> --type skill|agent
• anyclaw marketplace info <type> <name>
• anyclaw skill update <name>
• anyclaw skill uninstall <name>
• anyclaw agent search <query>
• anyclaw agent install <name>
• anyclaw agent info <name>
• anyclaw agent update <name>
• anyclaw agent uninstall <name>

6. Web 控制台清单

• 市场页拆成 Skills 和 Agents 两个 tab。
• 支持搜索、标签筛选、排序、详情页、版本选择。
• 详情页展示权限、依赖、兼容性、发布者、更新时间。
• 安装弹窗展示权限确认、安装位置、依赖检查结果。
• 已安装项展示当前版本、可升级状态、启用状态。

7. 本地缓存与离线能力

• catalog 搜索结果缓存到本地。
• 支持 last synced at 展示。
• 离线时允许查看最近一次缓存的 catalog 和详情。
• 安装包或 manifest 拉取失败时，优先回退本地缓存。

第二阶段建议做的功能清单

1. 发布端能力

• 发布者上传 manifest。
• 服务端校验字段完整性、版本合法性、checksum。
• 发布状态流转：draft、reviewing、published、deprecated、removed。
• 支持下架、冻结版本、标记风险版本。

2. 信任与安全体系

• 引入签名校验和发布者公钥。
• 首次安装非可信发布者时给出强提醒。
• 高危权限单独二次确认。
• 记录安装审计日志、升级审计日志、卸载审计日志。

3. 兼容性治理

• AnyClaw 版本约束校验。
• 模型供应商约束校验。
• OS/架构约束校验。
• 依赖的 skill/plugin/channel 可用性校验。

4. 运营能力

• 下载量、评分、收藏、推荐位。
• 热门榜、最新发布榜、编辑推荐。
• 搜索排序策略和标签体系。

研发拆分建议

1. manifest/schema

• 先定义统一 schema 和本地安装记录结构。
• 这是 skill 和 agent 共用的基础层，优先做。

2. marketplace client

• 封装 catalog 查询、详情获取、manifest 拉取、checksum 校验。
• skill 和 agent 共用同一套 client，避免后面再重构。

3. installer

• skill installer 负责下载、校验、写入本地目录、更新索引。
• agent installer 负责下载、校验、依赖检查、写入 AgentProfile。

4. gateway api

• 网关新增 marketplace 代理接口，供 Web UI 调用。
• 避免前端直接请求多个远端源。

5. ui marketplace

• 先做列表页、详情页、安装弹窗。
• 第二步再加升级、卸载、筛选、榜单。

验收清单

• 能搜索 skill 和 agent。
• 能查看详情、权限、依赖、兼容性。
• 能安装到本地，且安装结果可持久化。
• 能升级、卸载、回滚到指定版本。
• 离线时能浏览最近一次 catalog 缓存。
• 非兼容版本、缺失依赖、签名不合法时能阻止安装并给出明确错误。

推荐的最小闭环

如果只做一个最小可上线版本，我建议按这个顺序：

1. 统一 manifest schema。
2. agent catalog API。
3. anyclaw agent search/install/info。
4. UI 市场页的 Agents tab。
5. 安装前权限确认 + checksum 校验。
6. 本地缓存 + 更新检查。

这轮只做了需求细化，没有改代码，也没有创建 PR。如果需要，我下一步可以继续把这份清单再拆成 后端接口任务 / CLI 任务 / UI 任务 / 数据结构任务 四张开发任务表。

View job run