Unicity AgentSphere

Unicity 网络上的 Web3 钱包与代理平台,集加密货币钱包、私信、群聊和市场于一体。

Star 数
★ 9.6k
最近更新
2 天前
主语言
TypeScript

30 秒速览

运行形态
网页应用自托管服务
可在哪里用
平台专用
费用
免费,无需付费服务
上手难度
中 · 需要几步配置
开始前需要
Node.js 20+npmDockerShell / 命令行网络访问本地文件系统
典型场景
普通用户:在 Unicity 网络上进行快速低成本的加密货币转账,并跟踪余额和交易历史。
不适合
  • 只使用以太坊等其它区块链的用户
  • 需要完全去中心化、不依赖任何中继服务的团队
  • 希望自由修改和分发代码的开发者(私有许可)

这个 Agent 能做什么,适合哪些场景?

Unicity AgentSphere 是一个专为 Unicity 网络设计的 Web3 钱包和代理平台,集成了加密货币钱包、私信(DM)、群聊和市场功能。它提供快速低成本的状态转换、代币管理、余额跟踪、收款通知和 @用户名 标签系统。平台实现了 Connect 协议(ConnectHost),支持 dApp 通过 iframe 或弹出窗口连接,并基于权限访问钱包功能。此外,它还支持 unicity-connect:// 深度链接,可在聊天中打开 dApp。代理系统支持通过 iframe 加载外部 dApp,群聊功能基于 NIP-29 实现。技术栈包括 React 19、TypeScript、Vite 7、TanStack Query、Tailwind CSS 4 等。项目需要 Node.js 20+,可通过 npm 或 Docker 运行。

AgentSphere 提供完整 Web3 钱包功能,包括 Unicity 代币转移、余额查询、交易历史、收款通知、Nametag 管理。它通过 Connect 协议实现 dApp 连接,支持 iframe 和弹出窗口模式,用户可授权特定权限。深度链接协议将 unicity-connect:// 转换为 https://,供用户在 iframe 或浏览器中打开 dApp。代理系统通过 /agents/custom?url= 加载自定义 iframe 代理。群聊功能使用 NIP-29,通过 WebSocket 实时通信,支持公共和私有群组。代理使用 @unicitylabs/sphere-sdk 进行所有钱包操作,包括 L3、Nostr 和 IPFS。

  1. 普通用户:在 Unicity 网络上进行快速低成本的加密货币转账,并跟踪余额和交易历史。
  2. dApp 开发者:使用 Connect 协议(iframe 或弹出窗口)将你的 dApp 集成到 AgentSphere 钱包中,请求发送代币、签名或 DM 等操作。
  3. 用户:在私信中接收来自 dApp 的 unicity-connect:// 链接,一键在 Sphere 内或浏览器中打开。
  4. 社区成员:通过 NIP-29 加入公共群聊,参与实时讨论,使用邀请码创建或加入私有群组。
  5. 开发者:通过 /agents/custom?url= 将外部 dApp 作为 iframe 代理加载,扩展平台功能。

如何安装或部署这个 Agent?

安装要求 Node.js 20+。步骤:

  1. 克隆仓库:git clone https://github.com/unicity-sphere/sphere
  2. 进入目录:cd sphere
  3. 安装依赖:npm install
  4. 复制环境变量文件:cp .env.example .env
  5. 配置 .env 中的变量(如 VITE_WELCOME_AGENT_NAMETAG)。
  6. 启动开发服务器:npm run dev

或者使用 Docker:docker compose up(运行在 3010 端口)。

如何使用这个 Agent?

开发使用:
- npm run dev:启动开发服务器(http://localhost:5173)
- npm run build:TypeScript 编译 + Vite 生产构建
- npm run preview:预览生产构建
- npm run lint:运行 ESLint
- npm run test:运行 Vitest 测试

配置环境变量:
- VITE_WELCOME_AGENT_NAMETAG=kbbot(欢迎 DM 代理名称)
- VITE_WELCOME_DELAY_MS=4000(欢迎 DM 延迟)

通过 Connect 协议连接 dApp:在 iframe 或弹出窗口中启动连接,用户批准权限。
使用深度链接:在 DM 中发送 unicity-connect:// 链接,以在 Sphere 或浏览器中打开。

这个 Agent 有哪些优点和局限?

优点
  • 专为 Unicity 网络设计,提供快速低成本的状态转换和代币管理。
  • 实现 Connect 协议,支持 iframe 和弹出窗口模式,方便 dApp 集成。
  • 支持多种代理类型,包括 iframe 代理,可扩展性高。
  • 集成了 NIP-29 群聊,支持实时消息和邀请码。
局限
  • 仅适用于 Unicity 网络,不支持其他区块链。
  • 依赖特定中继(wss://sphere-relay.unicity.network)进行群聊,存在中心化风险。
  • 许可证为私有,代码可能无法自由使用或修改。
  • 仅支持 Node.js 20+,要求较新。

这个 Agent 与同类方案有什么区别?

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Unicity AgentSphere 当前 40 · 缺口较多 网页应用免费 ★ 9.6k 2 天前 TypeScript —
Amazon Q CLI(已停维护,迁移至 Kiro CLI) 46 · 缺口较多 命令行工具免费 + 模型费 ★ 2k 5 个月前 Rust —
Ripple Community Wallet(瑞波社区钱包) 34 · 缺口较多 网页应用免费 ★ 2.3k 3 个月前 TypeScript —
Sphere SDK 53 · 缺口较多 代码库 / SDK免费 ★ 5.4k 1 天前 TypeScript —

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
40/ 100 五分制 2.0 / 5
信任安全 10/29
可靠稳定 6/14
适用触发 9/18
规范维护 8/18
有效结果 4/13
证据核验 3/8
查看各维度的扣分理由
信任安全10 / 29 · 1.7/5

证据显示有权限请求和用户确认机制(如连接审批弹窗),但未详细说明最小权限原则;数据流透明度有限,敏感数据处理(如种子短语)未充分说明;依赖安全未审计;外部影响(如部署)有说明但回滚机制缺失;来源归属仅通过README提及Unicity Labs,未验证。

可靠稳定6 / 14 · 2.1/5

自一致性较好,有CI和测试;依赖可用性未验证;失败消息在测试中有体现,但产品中未充分说明。

适用触发9 / 18 · 2.5/5

受众和场景明确(Web3钱包和代理平台),能力边界部分说明(如代理类型),触发精度(如深链接)有描述但不够精确;环境适配有Docker和部署配置。

规范维护8 / 18 · 2.2/5

信息架构清晰,安装说明存在,命名稳定性未验证,示例和FAQ缺乏,已知限制未明确,许可证为私有项目,版本和变更日志缺失,维护责任未明确。

有效结果4 / 13 · 1.5/5

输出可用性未充分说明,边际价值有描述但未量化,成本效益未分析。

证据核验3 / 8 · 1.9/5

声明可追溯性有限,跨来源佐证不足,事实与推断分离不明确。

风险与缓解建议
  • 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
  • 未验证的发布者身份,需谨慎对待。
  • 敏感数据处理(如种子短语)未充分说明,需审查。
  • 依赖安全未审计,存在潜在风险。
  • 回滚机制缺失,部署失败可能影响可用性。
证据充分度:低 评估于 2026年8月11日 审查版本 8a59c0a7f325 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →

常见问题

我需要什么环境来运行 AgentSphere?
需要 Node.js 20+,以及 npm 和 Docker(可选)。
AgentSphere 支持哪些网络?
目前仅支持 Unicity 网络,依赖其 L3 和 Nostr 基础设施。
如何将我的 dApp 集成到 AgentSphere?
实现 Connect 协议,使用 iframe 或弹出窗口模式连接,并请求所需权限。
群聊是否依赖中心化服务器?
群聊使用 NIP-29 中继,默认中继为 wss://sphere-relay.unicity.network,可能成为单点故障。
在 GitHub 查看 ↗ 安装 ↓

相关 Agents