SuperAPI AI 工具集

shire

Shire 是一个让 AI 智能体持久化运行与协作的基础设施层。与常见的“下达指令—执行—输出”模式不同,Shire 中的智能体在会话之间保持存在,能够自主发现彼此并协作,在昨天的工作基础上继续推进,用户可像与真实团队共事一样提供反馈、迭代和调整方向。它不锁定单一模型供应商,支持 Claude Code、OpenCode、Pi Agent 和 Codex 等智能体运行框架。主要能力包括:智能体自主通信与直接消息、共享上下文;社区维护的预构建智能体模板目录;所有智能体共用的共享文件系统;一次性或周期性的定时任务;可配置到 Discord、Slack 或 Telegram 的告警通道;按智能体持久化的自定义技能;多项目架构;带流式更新的实时仪表盘;可选的用户名/密码认证。Shire 通过 npm 全局安装,无需其他依赖,数据存储在 ~/.shire/,默认使用 SQLite,智能体作为本地进程运行,无需外部服务。

访问官网

工具介绍

用途

Shire 定位为“智能体生活并繁荣的地方”,是一个面向 AI 智能体的基础设施层。大多数 AI 智能体工具遵循同一模式:用户给出指令,智能体执行,返回输出,随后智能体消失,下次再从零开始。Shire 试图改变这一点——让智能体在会话之间持久存在,彼此自主通信,并在既有工作成果上继续构建。用户提供反馈、迭代、调整方向,体验更接近与一个真实团队协作。

主要能力

  • 兼容任意模型:不锁定单一 AI 供应商,支持 Claude Code、OpenCode、Pi Agent 和 Codex 等智能体运行框架(harness)。Shire 作为基础设施层,用户可自行选择适合工作流的模型。
  • 智能体自主通信:智能体可自行发现同伴并协作,无需编排器(orchestrator)。支持直接消息、共享上下文,实现智能体之间的真实团队协作。
  • 社区目录:可浏览并部署社区维护的预构建智能体模板库(由 agency-agents 提供支持),快速启动一支有能力的团队。
  • 共享驱动器:所有智能体共用的公共文件系统,便于围绕共享产物开展协作。
  • 定时任务:通过一次性或周期性定时消息自动化智能体工作,可设置自定义间隔,让智能体自动运行。
  • 告警通道:当智能体需要关注时获得通知,可按项目配置将告警发送到 Discord、Slack 或 Telegram。
  • 智能体技能:上传自定义工具和指令以扩展智能体能力,技能按智能体在会话之间持久保存。
  • 多项目架构:将智能体组织到不同项目中,每个项目拥有自己的共享驱动器、设置和环境。
  • 实时仪表盘:通过带流式更新的实时 Web UI 监控、聊天和管理智能体。
  • 可选认证:使用用户名/密码登录保护实例,基于 JWT,支持自动令牌刷新、速率限制和安全 Cookie 处理;本地使用时默认禁用。

使用方式

通过 npm 全局安装 Shire,无需其他依赖:

npm install -g agents-shire

安装后访问 localhost:8080 打开仪表盘。该命令会为对应平台(macOS、Linux 或 Windows)安装独立二进制文件,所有数据存储在 ~/.shire/。

配置智能体运行框架

Shire 支持多种智能体运行框架,每个智能体在仪表盘中配置对应的框架类型。

Claude Code:安装 Claude Code 并通过以下方式之一完成认证。

OpenCode:安装 OpenCode 并设置所使用供应商的 API 密钥。OpenCode 会从环境变量和 .env 文件自动检测 API 密钥;Shire 自动管理 OpenCode 服务器进程,无需手动执行 opencode serve。注意模型格式:OpenCode 要求 provider/model 格式(例如 anthropic/claude-sonnet-4-6、openrouter/google/gemini-2.5-pro),这与其他只接受模型名称的框架不同。完整支持的供应商和模型列表见 OpenCode 供应商文档。

Pi Agent:使用 @mariozechner/pi-coding-agent SDK,支持多种 AI 供应商。将所需供应商的 API 密钥设置为环境变量,也可将密钥存放在 ~/.pi/agent/auth.json(优先于环境变量)。完整支持的供应商和订阅服务列表见 Pi Agent 文档。

Codex:安装 Codex CLI 并设置 OpenAI API 密钥。Codex 使用 OpenAI 模型(例如 o4-mini、gpt-4.1、codex-mini),详见 Codex 文档。

开发环境启动

开发模式下需要按所用框架安装对应依赖:Claude Code(仅在使用 claude_code 框架时)、OpenCode(仅在使用 opencode 框架时)、Codex CLI(仅在使用 codex 框架时)。默认使用 SQLite 存储,智能体作为本地进程运行,无需外部服务,所有数据存储在 ~/.shire/。

认证配置

默认情况下 Shire 不启用认证,适合本地开发。若要保护共享或远程实例,同时设置 SHIRE_USERNAME 和 SHIRE_PASSWORD。启用后,仪表盘会显示登录页,所有 API/WebSocket 连接都需要有效的 JWT 令牌;签名密钥在首次启动时自动生成于 ~/.shire/.jwt-secret。

构建与发布

Shire 通过 npm 以独立二进制文件分发,无需运行时依赖。构建命令会将后端编译为独立二进制文件,并预构建前端资源。发布通过 GitHub Actions 自动化,打标签即可触发工作流,构建各平台二进制并发布:@agents-shire/cli-darwin-arm64(macOS Apple Silicon)、@agents-shire/cli-darwin-x64(macOS Intel)、@agents-shire/cli-linux-x64(Linux x64)、@agents-shire/cli-linux-arm64(Linux ARM)、@agents-shire/cli-win32-x64(Windows x64),以及安装正确二进制文件的元包 agents-shire。

适用场景

适合希望让 AI 智能体长期存在、跨会话积累工作成果,并让多个智能体自主协作的用户;适合需要按项目组织智能体、共享文件与上下文、设置定时任务和告警通知的团队或个人;也适合希望自由选择底层模型供应商、在本地运行智能体而不依赖外部服务的开发者。

限制

资料未提供具体的收费、价格、性能指标或效果数据。认证默认关闭,用于共享或远程实例时需自行配置用户名和密码。不同运行框架对模型格式和 API 密钥的配置要求不同,需按对应文档设置。