Gini Agent：会记忆、会学习的个人智能体
一个本地优先、会记忆会成长的个人智能体，通过审批门控和对话内交互控件，让你随时掌控它的行动。
证据显示有审批门控、用户确认、敏感数据保护（如密钥不进入对话）、数据流透明（文档描述）、回滚（导入前归档）。但依赖安全仅部分（有补丁和信任列表，但未提供漏洞扫描证据），来源归属仅部分（有安全联系邮箱，但发布者未验证）。
自洽性良好（文档与代码结构一致），依赖可用性有锁文件和CI，失败消息有文档（如macOS Tahoe的提示）。
受众和场景明确（个人代理），能力边界有文档（如消息桥接不活跃），触发精度有CLI命令，环境适配有macOS/Linux/Docker说明。
信息架构清晰（文档索引），安装说明详细，命名稳定（版本0.3.0），示例和FAQ有，已知限制有（如macOS Tahoe），许可证MIT，版本变更日志有，维护责任部分（有安全联系但发布者未验证）。
输出可用性高（交互控制），边际价值高（记忆和学习），成本效益合理（本地模型）。
声明可追溯（文档和ADR），交叉来源部分（有CI和测试），事实与推断分离（文档区分设计意图和现状）。
- 发布者身份未验证，需谨慎对待供应链风险。
- 依赖安全仅部分证据，建议检查漏洞扫描和依赖更新策略。
- 静态审查未执行运行测试，实际行为需验证。
这个 Agent 能做什么，适合哪些场景？
Gini Agent 是一个本地优先的运行时（runtime）和个人智能体，核心是一个单一 Bun 进程的网关（gateway），负责状态、对话、任务、审批、记忆等所有数据。它提供多种客户端界面：Next.js 网页应用、CLI、Expo 移动应用、MCP 接口和消息桥接。Gini 支持多种模型提供商（OpenAI、Anthropic、Bedrock、Azure、OpenRouter、DeepSeek、Codex 和本地），并默认使用本地嵌入、重排序和语音转文字。它通过审批机制保护文件、终端和代码工具，并提供对话内的安全输入控件（如密钥字段、浏览器接管确认）和发送前确认。该项目的目标是成为一个产品级的智能体，而非仅是一个聊天界面，其运行时是唯一的记录系统。
Gini 的运行时是网关，每个实例是一个 Bun 进程。它支持持久化聊天、运行、任务、审批、审计事件、作业、记忆和技能。用户可以运行 gini chat new 开始对话，gini approvals 审查待处理审批。它通过 gini provider set 配置模型提供商，或通过交互式 gini setup。Gini 支持并行实例（gini --instance sandbox run）和临时测试实例（gini smoke）。它提供命令行工具，可管理记忆、作业、连接器、提供者、快照和导入。用户可以通过 gini import apply openclaw 从 openclaw 迁移。Gini 还提供远程访问（隧道模式）和 Docker 部署。
- 需要自动化个人工作流并确保敏感操作（如发送消息、购买）经过明确批准的个人用户。
- 需要在多个设备上控制智能体，包括桌面和手机，并通过隧道远程访问的用户。
- 需要管理多个并行实例，隔离不同项目或任务环境的开发者。
- 希望从 openclaw 迁移到新平台并保留历史记录、记忆和技能的用户。
- 需要记忆和技能学习能力，让智能体从任务结果中改进的用户。
这个 Agent 有哪些优点和局限？
- 本地优先，数据存储在你的机器上，隐私可控。
- 支持多种模型提供商，包括本地服务器，避免供应商锁定。
- 记忆和技能学习能力，智能体从任务结果中改进。
- 对话内提供安全控件（如密钥字段），敏感信息不经过模型或日志。
- 安装需要 Bun 和可能的系统级依赖，对非技术用户有门槛。
- 首屏安装向导需要手动配置模型提供商，过程可能复杂。
- 消息桥接（Telegram/Discord）标记为未积极维护，依赖它们有风险。
- macOS 26 存在启动自动重启问题，需要手动介入（
gini autostart kick）。
如何安装或部署这个 Agent？
安装脚本：curl -fsSL https://raw.githubusercontent.com/Open-Curiosity/gini-agent/main/scripts/install.sh | bash。macOS 安装程序自动启用自启动并打开 /setup 页面。Linux 用户需手动运行 gini setup 然后 gini start。需要设置至少一个模型提供商的 API 密钥，可通过交互式 gini setup 或 gini provider set（例如 gini provider set openai gpt-5.4-mini）。
如何使用这个 Agent？
安装后，网页端访问 http://127.0.0.1:7777，运行时 http://127.0.0.1:7778。使用 gini chat new 开始对话，gini approvals 审查审批，gini status 查看状态和 URL。更新使用 gini update。从源码运行：bun install、bun run gini install、bun run gini start。
常见问题
Gini 是否支持云端部署？
docs/deployment-docker.md），支持在容器内无头运行，并使用 Xvfb 提供真实浏览器。如何确保我的 API 密钥安全？
~/.codex/auth.json 读取。对话内的安全字段直接发送到网关，不经过模型或日志。Gini 是否支持多用户？
Gini 是否支持从其他平台导入数据？
gini import 命令（plan 和 apply）。