Radoss Universal Avatar

面向个人、用户自有的 Avatar 的无代码桌面设置层。

NAAS 是 Avatar 的权威来源。Hermes 是可见的设置与编排代理。SQLite + FTS5 是本地规范记忆账本。ReMe 是可选的易读投影；Ollama 被有意排除在公开产品之外。

面向非技术用户

发布后请使用已签名的桌面安装程序：

1. 安装并打开 Radoss Universal Avatar。

2. 为你的 Avatar 命名。

3. 选择隐私模式。

4. 点击 Set up my Avatar。

5. 在浏览器中批准账户连接。不要复制任何代码或令牌。

6. 当向导确认本地适配器后，重新打开或刷新受支持的 AI 主机。

桌面向导会在变更前创建加密的本地备份，并提供重试、回滚、隐私、断开连接、健康状态和安全控制。

该产品有三种刻意不同的连接路径：

• 无代码用户： 使用桌面向导和浏览器 OAuth；切勿复制代码、令牌或配置文件。

• 开发人员： 当需要脚本化或基于仓库的控制时，使用通用 CLI 和本地 stdio MCP 适配器。

• 托管 AI 用户： 使用品牌化 HTTPS MCP 网关，然后在宿主自身的 UI 中完成最终的 ChatGPT 或 Claude 账户连接。Radoss 绝不会仅凭本地文件就声称宿主账户已连接。

Related MCP server: bodybridge

CLI 开发路径

该包已为公开 npm 发布做好准备，但尚未发布。在验证拥有该包名的 npm 账户后，使用以下命令发布已验证的 tarball：

cd /path/to/radoss-universal-avatar
npm login
npm publish --access public

通用 CLI 与 NAAS 源代码仓库分开维护。其公开源代码仓库为 innosaint-uche/radoss-universal-avatar。

如需从检出副本进行本地开发：

cd /path/to/radoss-universal-avatar
node bin/radoss.mjs setup
node bin/radoss.mjs setup status
node bin/radoss.mjs doctor
# Validate the deployed HTTPS MCP gateway without exposing a token
node bin/radoss.mjs mcp conformance https://mcp.naavos.radoss.agency/mcp --bearer-env RADOSS_GATEWAY_TOKEN --status-tool avatar_get

CLI 会自动管理受支持的本地目标：

• Codex: ~/.codex/config.toml

• Antigravity: ~/.gemini/config/mcp_config.json

• Hermes: ~/.hermes/profiles/avatar/config.yaml，独立的 avatar 配置

每个目标都会接入本地 radoss_avatar MCP 服务器。Hermes 仍是可见的编排器；默认 Hermes 配置不会被静默替换。

连接边界

本地代理使用受保护的 stdio MCP。已部署的 HTTPS Streamable HTTP 网关位于 https://mcp.naavos.radoss.agency/mcp，提供 OAuth、基于 D1 的租户所有者强制执行以及 MCP 生命周期检查。两个独立活跃用户的租户验收仍是独立的公开发布门禁。规范 Worker 源仍是 Hostinger/Coolify 品牌路由背后的实现细节。ChatGPT 和 Claude 账户连接仍由宿主管理；本地配置文件无法证明在线 ChatGPT 或 Claude 连接。

托管客户端所需的远程边界和发布证据在 docs/REMOTE_MCP_GATEWAY_CONTRACT.md 中定义。本地 sidecar 绝不可直接作为公共连接器暴露。

经过验证的本地 Hugging Face 流程会完成浏览器 OAuth、验证提供方账户、通过 macOS Keychain 助手存储凭据，并单独验证 Hermes 的 OAuth 自有缓存。它绝不会在设置状态或代理配置中打印或存储令牌值。

验证

npm test
npm audit
npm pack --dry-run

证据契约和发布门禁请参阅 docs/NO_CODE_SETUP.md，Tauri 打包边界请参阅 desktop-setup/README.md。

当前的开发人员、本地验证和客户发布边界请参阅 docs/RELEASE_STATUS.md。

通用 QA

可复用的浏览器和线上界面 E2E 测试属于中央外部 ~/.radoss-qa 测试工具。每个项目只需贡献一个描述其真实 URL 和契约的小型适配器；它不会向项目添加 Playwright、浏览器二进制文件或 Rust。Rust 仅由中央 Tauri 或工件适配器在需要进程、IPC、文件系统或签名证据时使用。安装通用开发环境后，请参阅本地测试工具的 README。