Milady 个人 AI 助理
本地优先的私人 AI 伴侣与助理，管理会话、工具与消息渠道，不联网上传隐私。
加分项：CI 工作流默认最小权限（contents: read，按需覆盖）、信任分级门控、同仓库 PR 限制、修复次数上限、API 默认绑定 127.0.0.1 并给出 token 建议。扣分项：README 将 ELIZA_TRADE_PERMISSION_MODE=agent（自主交易）与 user（人工确认）并列展示且未声明默认值，钱包私钥直接放 .env，Edge TTS 默认会连微软云需主动设 MILADY_DISABLE_EDGE_TTS=1 关闭（默认外呼而非默认关闭），agent 工作流授予 Bash(*) 全量工具。
加分项：README 与 package. 的命令、端口、版本信息基本一致，且有契约测试（app-registrations）与 doctor/--verbose/--debug 诊断路径、安装重试逻辑。扣分项：核心依赖大量使用 alpha dist-tag（@elizaos/* 'alpha'、beta 漂移标签）和 github: 直接引用，锁定的可复现性与可用性证据不足。
加分项：明确场景（本地优先个人助手）、明确边界声明（'not a full IDE'、Linux 仅 tarball x86_64）、聊天命令和热键定义清晰、覆盖 Windows 长路径/端口冲突等环境细节。扣分项：平台矩阵中 iOS 仍为 coming soon，部分场景（云模式）依赖外部 elizacloud.ai 文档，本仓库内证据不完整。
加分项：文档架构非常完善（docs/ 多个 WHY 文档、按主题链接）、安装路径覆盖 curl/npm/brew/源码/桌面并含校验和步骤、MIT 许可证全文、明确列举已知限制（无 AppImage/deb 等）。扣分项：四个 bin 名称并存（milady/miladyai/milady-ai/milady.ai）稳定性存疑，版本为 2.0.0-alpha.140 且无 CHANGELOG 证据，发布方未经验证。
加分项：多界面输出（TUI/仪表盘/WebChat）、SSE 渐进更新设计、token/成本显示、电池能耗调优的产品主张清晰。扣分项：所有输出主张均为静态描述，无执行验证；重型依赖栈（Electron/Three/Capacitor）的维护成本相对于个人助手价值偏高，成本收益依赖未验证的性能主张。
加分项：README 声明大多附带 docs/ 内部链接，契约测试可静态核对部分主张。扣分项：'Signed and notarized'、CI badge、 CodeFactor 等外部主张无法在本仓库内核实；营销化语气（'she's alive'、'cracked'）与事实性陈述混杂，事实与推断分离度低。
- 不要在 .env 中长期存放 EVM 私钥：README 展示的自主交易模式（ELIZA_TRADE_PERMISSION_MODE=agent）一旦配置即允许代理用对话指令买卖代币，请确认默认值并优先使用 user 确认模式。
- Edge TTS 默认会连接微软云；若要求本地隐私，请显式设置 MILADY_DISABLE_EDGE_TTS=1。
- 核心 @elizaos/* 依赖锁定在 alpha/beta 浮动标签上，版本可漂移；生产使用前应固定精确版本并审查锁文件。
- 对外网络绑定（MILADY_API_BIND=0.0.0.0）时若无 MILADY_API_TOKEN，任何可达者都能完全控制代理与钱包端点——README 已警告，务必照做。
- 发布方未经企业注册表验证；'signed and notarized' 等安装包主张需自行用 SHA256SUMS 校验。
- agent 工作流给 Claude 授予 Bash(*) 全量工具权限，虽然限制在本仓库 CI 且有信任分级，仍应审阅其提交内容。
这个 Agent 能做什么，适合哪些场景？
Milady 是一个构建在 elizaOS 之上的个人 AI 助理，默认本地运行，也可接入 Eliza Cloud 或自建远程后端。它通过 Gateway 控制面管理会话、工具与消息渠道，支持 Telegram、Discord 等平台，并提供 WebChat 仪表盘（默认端口 2138）与终端 TUI。产品特色包括电池感知的桌面 3D 头像（VRM / 高斯泼溅渲染）、Edge TTS 语音，以及内置的 BSC 链上交易能力（通过 PancakeSwap 执行 EXECUTE_TRADE 动作）。模型侧支持 Anthropic、OpenAI、OpenRouter、Gemini、Ollama 本地模型等十余家提供商。提供桌面安装包（macOS、Windows、Linux）、Android 应用、npm 包和源码构建多种安装方式，采用 MIT 许可证。
Milady 以 milady 命令启动交互式 TUI，或用 milady start 以纯服务器模式运行 API 服务。首次运行引导用户选择角色名与说话风格、接入模型提供商（如 Anthropic、OpenAI 或本地 Ollama），随后在 localhost:2138 打开仪表盘、在 ws://localhost:18789/ws 启动 Gateway。它通过 Gateway 连接 Telegram、Discord、微信 Webhook（端口 18790）等聊天渠道，管理多会话并展示 token 用量与成本。内置聊天命令如 /status、/new、/compact、/think、/model 可在任意会话中控制推理等级与模型切换。插件系统（milady plugins install）可扩展功能，例如从 Binance Skills Hub 安装 meme-rush 技能追踪 Pump.fun 和 Four.meme 的新币。配置 EVM_PRIVATE_KEY 后，EXECUTE_TRADE 动作可在 PancakeSwap 上按指令买卖 BSC 代币。桌面版通过 Electrobun 提供 3D VRM 头像，并在后台轮询、WebGL 渲染和电池感知画质上做了节能优化。
- 想在 Telegram 或 Discord 上运行一个 24 小时在线、有人设和语音的个人 AI 机器人的独立用户
- 重视隐私、希望用 Ollama 本地模型完全离线运行助理、不向云端发送数据的开发者
- BSC 生态用户，需要助理代为在 PancakeSwap 买卖代币或追踪 Pump.fun 新币发射
- 想要一个带 3D 头像、语音同步、在笔记本电池模式下低功耗运行的桌面 AI 伴侣的用户
- 需要在 VPS 或家庭服务器上自托管后端、前端远程连接的进阶用户（通过 MILADY_API_BIND 与 MILADY_API_TOKEN 部署）
这个 Agent 有哪些优点和局限？
- 本地优先架构：API 默认绑定 127.0.0.1，配合 Ollama 可完全不依赖云端运行，隐私可控
- 支持十余家模型提供商（Anthropic、OpenAI、OpenRouter、Gemini、Groq、DeepSeek、Ollama 等），切换只需改配置或环境变量
- 渠道覆盖广：Telegram、Discord、微信 Webhook、WebChat、终端 TUI 同一套 Gateway 管理
- 差异化功能：内置 BSC/PancakeSwap 交易动作、Binance Skills Hub meme 代币追踪、VRM 3D 头像与电池感知渲染
- 桌面/iOS 构建要求切换到本地 elizaOS 源码模式（bun run eliza:local），增加构建复杂度
- 文档明确指出 @elizaos/plugin-ollama 与当前 AI SDK 存在版本不兼容，必须绕道 Ollama 的 OpenAI 兼容端点
- 启用 BSC 交易需导入 EVM 私钥，自主交易模式（ELIZA_TRADE_PERMISSION_MODE=agent）存在资金风险
- 若将 API 绑定到 0.0.0.0 而不设 token，任何人可完全控制仪表盘、代理与钱包端点
- Linux 桌面版仅提供 x86_64 tarball 安装器，无 AppImage/deb/Snap/Flatpak
如何安装或部署这个 Agent？
推荐桌面用户从 GitHub Releases 下载对应平台安装包（macOS Apple Silicon/Intel、Windows、Linux tarball，Android 上架 Google Play），安装包已签名公证，可通过 SHA256SUMS.txt 校验。命令行安装：curl -fsSL https://get.milady.ai | bash && milady setup；Windows 用 irm https://get.milady.ai/install.ps1 | iex；或 npm install -g miladyai；macOS/Linux 也可用 Homebrew：brew tap milady-ai/tap && brew install milady-ai/tap/milady（或 --cask 安装桌面版）。源码构建需要 Node.js >= 22、Bun、Git，克隆后运行 ./install，再 bun run build。从源码构建桌面版（build:desktop / build:ios）需先执行 bun run eliza:local 切换到本地 elizaOS 源码模式。
如何使用这个 Agent？
运行 milady 启动交互式引导：选择角色与说话风格、连接大脑（Anthropic / OpenAI / Ollama，需相应 API key 或本地模型）、随后仪表盘在 http://localhost:2138 可用。常用命令：milady start（服务器模式）、milady setup、milady configure、milady doctor、milady models（查看已配置提供商）、milady plugins install <name>。会话内可使用 /status、/model <id>、/think <level>、/compact 等命令。若要将 API 暴露到网络，必须设置 MILADY_API_TOKEN（如 echo "MILADY_API_TOKEN=$(openssl rand -hex 32)" >> .env），否则任何能访问服务器的人都可获得完整权限。配置文件位于 ~/.local/state/milady/milady.。
这个 Agent 与同类方案有什么区别？
README 自述产品定位并非完整 IDE，与 Cursor 等重型开发工具的对比取决于工作负载；其北极星是作为本地助理的『每瓦特优秀体验』。
常见问题
必须付费使用云服务吗？
我的 API 密钥和数据存在哪里？
~/.local/state/milady/milady.，密钥可放在同目录的 .env 文件中。API 服务器默认只绑定 127.0.0.1 回环地址，外部无法访问。可以用完全本地的模型吗？
链上交易安全吗？
远程访问后端最安全的方式是什么？
tailscale serve --https=443 http://127.0.0.1:2138，并沿用 MILADY_API_TOKEN 作为访问密钥，避免公开端口。