Iva 个人助理
在 Telegram 中整理消息、长期记忆并执行个人与办公任务。
按维度查看评分与理由
证据清楚说明普通用户安装、默认拒绝的 Telegram 白名单、userbot 只读开关、插件仅限所有者从终端安装、入站注入筛查、出站密钥脱敏以及云端模型/转录、GitHub 镜像等数据流，因此数据流透明度可给满分。更新采用构建、探测、切换和回滚，破坏性 CRM 去重测试还验证先备份、故障恢复与防符号链接逃逸，回滚证据充分。扣分点是代理 shell 继承完整进程环境并以安装用户权限运行，文档正文、userbot 聊天和浏览器输出存在未筛查路径；部分 userbot 写操作只受提示词约束，外部发送也未显示统一的逐次确认机制。依赖有精确版本、审计修复声明和安全测试脚本，但所给材料没有锁文件、供应链校验或持续漏洞处置证据。来源归于 smixs，并说明项目沿革和私密漏洞渠道，但发布者身份仍未知。
README、SECURITY、package 元数据和测试材料对版本、运行环境、安全边界及恢复行为基本一致；固定随机种子、属性测试、故障注入和大量回归用例进一步支撑内部一致性。错误处理描述具体，包括工具模式降级、提醒失败回退、诊断包、明确配置错误和更新中断恢复，因此失败消息给满分。依赖可用性仅能由声明的 Node 24、eve、云服务及安装流程静态推断；对 Telegram、模型、Deepgram、搜索和 Google 服务的运行时不可用情形没有完整的统一降级证据，故扣分。
材料明确覆盖企业主、专业人士、管理者和日常生活，并列出语音、CRM、文档、提醒、搜索等具体场景；提供多模型、多搜索提供商、可选向量、技能、MCP、插件、读写模式及自定义规则，受众与环境适配较强。安全文档坦率划定筛查盲区、插件信任边界、云 API 边界和 userbot 风险，能力边界充分。扣分在于触发与确认主要依赖自然语言、技能提示和模式配置，且 joins、invites、联系人导入、reactions 等 userbot 操作未被服务器 guardrail 包裹；环境主要承诺 Ubuntu/Debian、systemd 和 Node 24，跨平台适配有限。
README 具有清晰导航、架构、功能、安装、成本、文档、版本历史和许可入口，并提供英文/俄文文档、首分钟示例、FAQ、故障排除和大量使用场景。包名、CLI、版本号及发布记录一致，MIT 正文完整；已知限制包括 userbot beta/封禁风险、筛查缺口、只支持最新版本和云端数据暴露，均明确披露，故大部分项目满分。维护责任仅给二分：提供漏洞邮箱、GitHub 私密报告、响应预期、issue/PR 路径和最新版本支持策略，但没有经验证的组织身份、多人维护结构或正式长期维护承诺。
输出面向 Telegram 原生富文本、清单、表格、文档链接、提醒和 Obsidian 兼容 Markdown，且记忆文件可直接查看和迁移，静态设计上的可用性强。相较普通聊天机器人，分层长期记忆、个人 CRM、可操作提醒、Google Workspace 和本地可控资料库构成明确增量价值。成本披露包含模型、VPS、语音及多提供商选择，但月费数字、实际节省和端到端效果仅为项目方声明，未有独立运行或比较数据，因此成本收益不满分。
主要主张能追溯到明确的文档章节、版本记录、包版本、安全政策及针对前置元数据、恢复和故障注入的测试代码；测试还使用固定 seed 并明确断言恢复性质，所以可追溯性充分。材料能区分事实边界、已知缺口、beta 风险和营销用例，没有把静态证据说成已执行结果，事实与推断分离较好。扣分在于交叉佐证主要来自同一仓库自身，且许多核心产品主张只由 README/变更记录描述，所给代码片段并未覆盖 Telegram 桥、脱敏器、安装器、更新器或完整端到端行为。
- 代理 shell 继承进程环境，遭注入的回合可能直接读取模型、Telegram、Google 等密钥；应使用独立低权限账户、最小化环境变量并限制主机文件权限。
- PDF/DOCX 正文、userbot 读取的聊天和 agent-browser 输出未经过统一注入筛查；不要把这些来源视为可信指令。
- 个人 Telegram userbot 违反 Telegram 服务条款并可能导致限流或封号；优先启用只读模式，且避免高价值主账号。
- 插件代码与插件中的 bash 可访问安装环境的全部密钥；只安装已审阅的插件，并把插件视为与主代理同等信任。
- 一键安装示例从 main 分支直接通过 curl 管道执行；部署前应下载审阅并固定到明确版本或提交。
- 本评估仅依据所给静态文件，未执行安装、测试、代理流程或依赖审计。
这个 Agent 能做什么，适合哪些场景？
Iva 是一个自托管的 Telegram 助理，通过长轮询接收文字、语音、照片、转发内容和决定，无需公网 HTTPS、域名或 webhook。它把对话逐字写入兼容 Obsidian 的 Markdown 仓库，并通过每日、每周、每月和每年摘要以及 CORE.md 和类型化卡片形成分层记忆。系统由两个 systemd 用户服务、两个 watchdog 定时器和五个 eve 内部计划任务运行，搜索索引使用 Node.js 24 内置的 SQLite。它能够调用网页搜索、Google Workspace、提醒、文件和自定义技能，也能连接 MCP 服务器。数据与密钥保存在用户自己的服务器上，但模型推理和语音转写仍依赖用户选择的云服务。适合希望以 Telegram 为入口、接受自行运维，并重视可检查 Markdown 记忆的个人或小型团队。
Telegram bridge 通过长轮询接收消息，将每天的用户内容和 Iva 回复逐字追加到 daily/YYYY-MM-DD.md。语音、音频和视频留言可由 Deepgram nova-3 转写，照片交给所选模型提供商的视觉模型描述；转发文本、网页、搜索结果、语音转写、图片说明等部分输入会经过提示注入检查。每天 04:00 的 nightly rollup 把日记逐层提炼为 daily、weekly、monthly 和 yearly 摘要，并更新 contacts、projects、decisions、ideas、notes 等卡片；不超过 1,200 字符的 CORE.md 会进入每次提示。检索默认结合 BM25 和链接图重排，也可用一个密钥启用向量模式。助理可以创建和管理一次性或重复提醒，通过 gws CLI 操作 Gmail、Calendar、Drive、Sheets、Docs 和 Tasks，并使用 Tavily、Exa、Parallel 或 Brave 搜索网页。它还支持以技能文件扩展流程、连接 MCP 服务，以及通过测试版 userbot 读取、搜索或代表个人 Telegram 账户发送内容；所有 Outbox 输出都经过秘密信息脱敏。
- 需要维护客户关系的经营者，把会谈结论和联系人偏好保存为卡片，数月后询问某位客户的约定和跟进方式。
- 经常在路上的管理者，将五分钟语音留言交给 Iva 转写，并整理为任务清单、邮件草稿和会议卡片。
- 使用 Google Workspace 的小团队，在 Telegram 中根据价格表制作报价、调整折扣并生成可分享的 Google Doc。
- 知识工作者把照片、长篇转发和日常想法归档到兼容 Obsidian 的 Markdown 仓库，再按含义检索。
- 消息繁多的 Telegram 用户选择启用测试版 userbot，汇总群聊、查找未读信息，并在理解封号风险后受控地代发回复。
这个 Agent 有哪些优点和局限？
- 记忆以用户拥有的普通 Markdown 文件保存，包含逐字日记、分层摘要、CORE.md 和类型化卡片，可直接用于 Obsidian并接受审查。
- 自托管且通过 Telegram 长轮询工作，不需要域名、公网 HTTPS 或 webhook；安装器提供一条命令的部署路径。
- 明确支持四种模型提供商，并可插接四种网页搜索服务、Google Workspace、技能和 MCP，降低单一模型提供商锁定。
- 提醒采用原子状态迁移和独立投递检查，计划任务会留下诊断事实，升级采用构建、探测、切换和回滚流程。
- 对多类外部输入提供提示注入检查，Outbox 提供秘密信息脱敏，用户白名单为空时默认不回复任何人。
- 需要自行维护 Ubuntu/Debian 主机、Node.js 24、systemd 服务、环境变量、模型凭据和更新流程，不是免运维的托管产品。
- 隐私边界并非完全本地：模型推理和 Deepgram 转写是用户选择并付费的云 API；Deepgram 缺失时不能转写语音。
- 安全过滤并不覆盖所有输入：文档正文、userbot 读取的聊天和 agent-browser 输出未筛查，媒体标题的风险标签也尚未传递给模型。
- 个人 Telegram userbot 仍是粗糙的测试版，自动化个人账户违反 Telegram 服务条款，发送操作可能导致限流或封号。
- 默认运行费用约为每月 14–15 美元的表述只对应特定 Go 模型和 VPS 组合；其他提供商、模型与搜索服务可能产生不同费用。
如何安装或部署这个 Agent？
准备一台 Ubuntu 或 Debian 服务器，并以普通用户而非 root 安装。先从 @BotFather 获取 Telegram bot token，然后运行：
curl -fsSL https://raw.githubusercontent.com/smixs/iva-agent/main/install.sh | bash按照向导填写 bot token，并选择 OpenCode Go、Ollama Cloud、OpenRouter 或 OpenAI（ChatGPT 订阅）作为模型提供商；如需语音转写，再提供 Deepgram 密钥。向机器人发送一条消息，向导会从该消息识别 Telegram ID、完成配置并在聊天中确认启动。全新 VPS 若仍以 root 登录，可先运行：
bash <(curl -fsSL https://raw.githubusercontent.com/smixs/iva-agent/main/bootstrap.sh)该脚本创建启用 lingering 的 sudo 用户、更新系统并配置防火墙、fail2ban 和 SSH 加固；随后用新用户登录并运行正式安装命令。源码安装可执行：
git clone https://github.com/smixs/iva-agent.git ~/iva
cd ~/iva && bash install.sh如何使用这个 Agent？
安装完成后，先给机器人发送一条文字或语音消息；当天的逐字记录会出现在仓库的 daily/ 目录。随后发送一条值得长期记忆的信息，例如“Marina at Acme wants the revised quote by Friday — she never picks up the phone.”，再询问“how should I follow up with Marina?”以验证卡片记忆和检索。发送照片或转发长文可请求说明或摘要；使用 /menu 配置模型、回复样式、语音和维护选项，使用 /usage 查看模型步骤的用量。Google Workspace 通过已安装的 gws CLI 和聊天内引导完成密钥配置。自定义流程可放入技能文件，MCP 服务的密钥保存在 .env；个人账户 userbot 必须显式启用，并可通过环境变量设置为只能读取。