1. 项目定位与用途
Open Alice 是一个文件驱动的 AI 交易代理引擎，旨在为个人交易者提供一站式交易解决方案。用户通过编辑 Markdown 和 JSON 文件来定义 AI 人设、交易任务、经纪商配置等，引擎读取这些文件并驱动 AI 进行市场分析、决策和执行。它支持加密货币和证券市场，集成多个经纪商，所有操作本地化，确保隐私和控制。核心哲学是“ vibe trading”，将 vibe coding 的读写原语直接应用于交易，无需数据库或容器，仅靠文件实现完整交易系统。
项目档案应用项目
Open Alice 文件驱动 AI 交易引擎：本地自动化交易加密货币与证券，支持多经纪商，完整安装使用指南
Open Alice 是一个文件驱动的 AI 交易代理引擎，通过编辑 Markdown 和 JSON 文件定义策略，实现本地 24/7 自动化交易。支持加密货币、股票、期权等市场，集成 CCXT、Alpaca、IBKR 等经纪商，提供守卫管道、市场数据研究、新闻聚合等功能。本页涵盖项目定位、安装步骤、使用指南和架构特点。
AI 总结
Open Alice 是一个文件驱动的 AI 交易代理引擎，通过 Markdown 和 JSON 文件定义策略，支持加密货币和证券市场，集成多个经纪商，实现本地 24/7 自动化交易与风控。
中文项目介绍
Open Alice 是一个 AI 交易代理引擎，允许用户通过读写文件（Markdown、JSON、JSONL）来定义交易策略、人设和配置，实现类似专业交易团队的能力，包括研究、量化、交易和风控，所有功能可在本地 laptop 上 24/7 运行。
它解决个人交易者缺乏专业团队支持的问题，将复杂交易系统简化为文件操作，降低门槛，提供多经纪商统一管理、Git 式交易历史审计、预执行风控守卫管道。
适用场景包括个人加密货币与证券自动化交易、市场研究与信号生成、多经纪商账户管理、基于 AI 的量化策略执行、交易行为审计与回溯。
技术特征：支持多 AI 提供商（Claude、OpenAI、Google 等）运行时切换；统一交易账户 (UTA) 抽象 broker 连接，使用 IBKR 类型系统；市场数据由 TypeScript-native OpenBB 引擎 (opentypebb) 提供，无需外部 sidecar；事件驱动 cron 系统；认知状态持久化；热重载；连接器包括 Telegram、MCP Ask 等。
详细信息与使用说明
2. 核心问题与解决方案
个人交易者通常缺乏专业的研究、量化和风控团队，导致决策依赖直觉或简单策略。Open Alice 通过 AI 代理模拟专业团队，将交易流程文件化，实现可审计、可版本控制的交易系统。解决方案包括：统一交易账户 (UTA) 抽象 broker 差异，AI 只与 UTA 交互；守卫管道进行预执行风控检查（如最大仓位、冷却时间、符号白名单）；Git 式交易历史，每笔订单有 8 字符哈希，支持 stage/commit/push；持续推理驱动的决策，结合信号混合；以及认知状态持久化，模拟大脑 frontal lobe 记忆和情绪跟踪。
3. 适用场景
适用于个人投资者进行自动化交易，尤其在多市场（crypto、equities、futures 等）和多经纪商环境下。也适合量化策略研发、市场数据研究、新闻驱动交易、以及需要严格风控和审计跟踪的场景。由于是本地运行，也适合注重数据隐私的用户。具体场景包括：加密货币跨交易所套利、美股日内交易、基于新闻的事件驱动交易、多账户统一管理、以及作为学习平台理解 AI 代理在金融领域的应用。注意项目处于实验阶段，不建议直接用于实盘大资金。
4. 安装与配置
Open Alice 基于 Node.js 和 pnpm 的 monorepo。安装步骤：1. 安装 Node.js (推荐 v18+) 和 pnpm 包管理器；2. 克隆仓库：git clone https://github.com/TraderAlice/OpenAlice.git；3. 进入目录并运行 pnpm install 安装依赖；4. 启动开发模式：pnpm dev（会自动构建内部包 @traderalice/ibkr 和 @traderalice/opentypebb）；或构建生产版本：pnpm build，然后运行 pnpm start。配置涉及编辑 default/ 目录下的人设文件 persona.default.md 和心跳任务 heartbeat.default.md，以及设置经纪商 API 密钥等敏感信息（建议通过环境变量或安全存储）。
5. 使用指南
用户主要通过修改文件与 Alice 交互：在 default/ 目录编辑 persona.default.md 定义 AI 角色、策略和约束，heartbeat.default.md 设置定期运行的任务；通过 JSON 配置文件连接经纪商（如 CCXT、Alpaca、IBKR），每个账户作为独立 UTA；使用 Telegram 连接器发送自然语言指令或接收通知；通过命令行工具（如 tradingLog、tradingShow）查看交易历史和账户状态；监控 data/brain/ 目录下的认知状态（记忆、情绪）和 data/events.jsonl 事件日志进行调试和回溯。AI 也可通过 evolution mode 获得完整项目访问权限以修改自身代码。
6. 实现特点与架构
架构特点：文件驱动核心，无数据库，所有状态（对话、事件、大脑、交易历史）持久化为文件。AI 提供商层抽象多模型支持，包括 Vercel AI SDK（集成 Anthropic、OpenAI、Google）、Codex 以及测试用 Mock 提供商。连接器系统支持 Telegram、MCP Ask 等，实现 OS 原生交互（如浏览器搜索、消息发送）。UTA 模式确保 AI 不直接接触 broker，所有订单经守卫管道检查。市场数据由 opentypebb 引擎提供，基于 OpenBB 但完全 TypeScript 实现，无外部 sidecar，覆盖股票、 crypto、商品、货币等，并提供统一符号搜索和技术指标计算。事件日志采用 JSONL 格式，支持实时订阅和崩溃恢复。整体模块化设计，添加新经纪商只需实现自注册配置 schema，无需修改框架。
思维导图
Open Alice
核心引擎
文件驱动核心
认知状态
事件日志 (JSONL)
Cron 调度
热重载
AI 提供商
Vercel AI SDK
Codex
Mock (测试)
连接器
Telegram
MCP Ask
Web (Hono)
交易账户 (UTA)
统一账户抽象
守卫管道
Git 式历史
市场数据
opentypebb 引擎
OpenBB 兼容
技术指标
新闻 RSS
经纪商适配器
IBKR (@traderalice/ibkr)
CCXT (100+ 交易所)
Alpaca (美股)
文件系统
persona.default.md
heartbeat.default.md
配置 JSON
对话 JSONL
常见问题
Open Alice 是什么？
Open Alice 是一个文件驱动的 AI 交易代理引擎，用户通过读写 Markdown 和 JSON 文件来定义交易策略、人设和配置，引擎驱动 AI 进行市场分析、决策和执行，支持加密货币和证券市场，可在本地 24/7 运行。
支持哪些市场和经纪商？
支持加密货币（通过 CCXT 集成 100+ 交易所）、美国股市（Alpaca）、以及股票、期权、期货、债券（Interactive Brokers）。每个经纪商作为独立连接器，通过统一交易账户 (UTA) 抽象，AI 不直接接触 broker。
如何安装和启动？
需要 Node.js 和 pnpm。步骤：克隆仓库后运行 pnpm install 安装依赖；开发模式运行 pnpm dev（会自动构建内部包）；生产模式运行 pnpm build 构建，然后 pnpm start。配置需编辑 default/ 目录下的人设和心跳文件，并设置经纪商 API 密钥。
AI 模型如何切换？
内置多 AI 提供商支持，包括 Vercel AI SDK（可切换 Claude、OpenAI、Google 等模型）、Codex 以及测试用 Mock 提供商。切换可在运行时进行，无需重启引擎，通过配置文件或指令选择。
是否安全？能否用于实盘交易？
项目处于实验阶段（beta），README 明确警告不保证正确性、可靠性或盈利，不承担财务损失责任。建议仅在充分理解风险、使用模拟账户或小资金测试后再考虑实盘。守卫管道提供预执行风控，但无法消除所有市场风险。