Unicity AgentSphere
Unicity 网络上的 Web3 钱包与代理平台，集加密货币钱包、私信、群聊和市场于一体。
证据显示有权限请求和用户确认机制（如连接审批弹窗），但未详细说明最小权限原则；数据流透明度有限，敏感数据处理（如种子短语）未充分说明；依赖安全未审计；外部影响（如部署）有说明但回滚机制缺失；来源归属仅通过README提及Unicity Labs，未验证。
自一致性较好，有CI和测试；依赖可用性未验证；失败消息在测试中有体现，但产品中未充分说明。
受众和场景明确（Web3钱包和代理平台），能力边界部分说明（如代理类型），触发精度（如深链接）有描述但不够精确；环境适配有Docker和部署配置。
信息架构清晰，安装说明存在，命名稳定性未验证，示例和FAQ缺乏，已知限制未明确，许可证为私有项目，版本和变更日志缺失，维护责任未明确。
输出可用性未充分说明，边际价值有描述但未量化，成本效益未分析。
声明可追溯性有限，跨来源佐证不足，事实与推断分离不明确。
- 未验证的发布者身份，需谨慎对待。
- 敏感数据处理（如种子短语）未充分说明，需审查。
- 依赖安全未审计，存在潜在风险。
- 回滚机制缺失，部署失败可能影响可用性。
这个 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。
- 普通用户：在 Unicity 网络上进行快速低成本的加密货币转账，并跟踪余额和交易历史。
- dApp 开发者：使用 Connect 协议（iframe 或弹出窗口）将你的 dApp 集成到 AgentSphere 钱包中，请求发送代币、签名或 DM 等操作。
- 用户：在私信中接收来自 dApp 的 unicity-connect:// 链接，一键在 Sphere 内或浏览器中打开。
- 社区成员：通过 NIP-29 加入公共群聊，参与实时讨论，使用邀请码创建或加入私有群组。
- 开发者：通过 /agents/custom?url= 将外部 dApp 作为 iframe 代理加载，扩展平台功能。
这个 Agent 有哪些优点和局限？
- 专为 Unicity 网络设计，提供快速低成本的状态转换和代币管理。
- 实现 Connect 协议，支持 iframe 和弹出窗口模式，方便 dApp 集成。
- 支持多种代理类型，包括 iframe 代理，可扩展性高。
- 集成了 NIP-29 群聊，支持实时消息和邀请码。
- 仅适用于 Unicity 网络，不支持其他区块链。
- 依赖特定中继（wss://sphere-relay.unicity.network）进行群聊，存在中心化风险。
- 许可证为私有，代码可能无法自由使用或修改。
- 仅支持 Node.js 20+，要求较新。
如何安装或部署这个 Agent？
安装要求 Node.js 20+。步骤：
- 克隆仓库：git clone https://github.com/unicity-sphere/sphere
- 进入目录：cd sphere
- 安装依赖：npm install
- 复制环境变量文件：cp .env.example .env
- 配置 .env 中的变量（如 VITE_WELCOME_AGENT_NAMETAG）。
- 启动开发服务器：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 或浏览器中打开。