radoss_avatar
Radoss Universal Avatar
面向个人、用户自有的 Avatar 的无代码桌面设置层。
NAAS 是 Avatar 的权威来源。Hermes 是可见的设置与编排代理。SQLite + FTS5 是本地规范记忆账本。ReMe 是可选的易读投影;Ollama 被有意排除在公开产品之外。
面向非技术用户
发布后请使用已签名的桌面安装程序:
安装并打开 Radoss Universal Avatar。
为你的 Avatar 命名。
选择隐私模式。
点击 Set up my Avatar。
在浏览器中批准账户连接。不要复制任何代码或令牌。
当向导确认本地适配器后,重新打开或刷新受支持的 AI 主机。
桌面向导会在变更前创建加密的本地备份,并提供重试、回滚、隐私、断开连接、健康状态和安全控制。
该产品有三种刻意不同的连接路径:
无代码用户: 使用桌面向导和浏览器 OAuth;切勿复制代码、令牌或配置文件。
开发人员: 当需要脚本化或基于仓库的控制时,使用通用 CLI 和本地 stdio MCP 适配器。
托管 AI 用户: 使用品牌化 HTTPS MCP 网关,然后在宿主自身的 UI 中完成最终的 ChatGPT 或 Claude 账户连接。Radoss 绝不会仅凭本地文件就声称宿主账户已连接。
Related MCP server: dragon-work
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_getCLI 会自动管理受支持的本地目标:
Codex:
~/.codex/config.tomlAntigravity:
~/.gemini/config/mcp_config.jsonHermes:
~/.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。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect existing AI agents via OAuth or MCP; join a public lobby, find work and coordinate projects.
Governed personal world model and memory for your AI agent. Pair once, connect over MCP.
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
StremAI MCP: shared memory for AI coding agents. Connected agents can recall. OAuth + local stdio.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceConnects embodied devices (like StackChan, Raspberry Pi, ESP32) to AI via MCP protocol, enabling motion control with zero API cost, no PC required, and fully self-hosted.MIT
- AlicenseNot gradedqualityBmaintenanceProvides a local-first AI workspace for chatting, invoking skills, managing projects, and integrating MCP tools, with all data stored on the user's machine.2Apache 2.0
- AlicenseNot gradedqualityAmaintenanceEnables web-based AI clients like Claude, ChatGPT, and Grok to securely operate a local machine through OAuth-gated MCP tools covering files, shell, Git, databases, browser automation, and background tasks.MIT
- AlicenseNot gradedqualityAmaintenanceEnables web-based AI chat clients to securely operate a local computer through an OAuth-gated MCP endpoint, exposing governed tools for files, shell, search, Git, SQLite, browser automation, DevTools, background tasks, localhost services, clipboard, notifications, ports, Postman, and AIObox windows.MIT