【免费下载链接】OpenAliceYour one-person Wall Street. An AI trading agent covering equities, crypto, commodities, forex, and macro — from research through position entry, ongoing management, to exit.项目地址https://gitcode.com/gh_mirrors/op/OpenAlice点击查看免费下载导读本文基于 OpenAlice 仓库根目录的 CHANGELOG.mdUnreleased 章节系统梳理该项目当前阶段最重要的一次架构调整——UTA-split v1交易域拆分交易相关能力被整体迁入独立的 UTA 服务Alice 通过 loopback HTTP 与两个 SDK 继续以原有公开表面工作而 Guardian 作为 L2 进程监督者统一掌管多载体的启动、健康门控与按配置热重启。读者读完本文后将掌握UTA 与 Alice 的物理/逻辑边界、Guardian 的端口协议与 restart-flag 重启机制、traderalice/uta-protocol契约包的定位以及变更日志中其余功能、修复、重构与测试条目的完整解读并可从文中的仓库相对路径直达对应源码继续深挖。一、UTA-split v1交易域从 Alice 进程中的物理拆分1.1 拆分动机与新的边界CHANGELOG 明确记载了本次架构调整的核心动作交易域被拆分为一个与 Alice 同址co-located部署的专用 UTA 服务。以下能力整体迁入services/uta/Broker 连接CCXT / Alpaca / Longbridge / IBKR TWS port 四类券商 SDK 的适配与连接管理git-like 审批状态机即Trading as Git——把交易操作建模成类似 Git 的提交/审批/同步流程详见 services/uta/src/domain/trading/git/TradingGit.tsSnapshot 调度持仓/账户快照的定时生成与存储对应 services/uta/src/domain/trading/snapshot 目录下的scheduler.ts、builder.ts、store.ts等模块FX 服务跨币种汇率计算fx-service.tsBroker SDK 封装各券商独立成目录包括 alpaca、ccxt、ibkr、longbridge、mock 以及others/leverup。从仓库目录结构看UTA 服务自身的入口位于 services/uta/src/main.tsHTTP 路由层在 services/uta/src/http如routes-trading.ts、routes-simulator.ts等这印证了UTA 是一个拥有独立进程、独立路由的服务这一事实。1.2 公开表面保持不变底层换成 HTTP adapter拆分的关键设计约束是不破坏调用方Alice 侧通过UTAManagerSDKUTAAccountSDK与 UTA 对话ctx.utaManager、19 个 AI 交易工具、UnifiedTradingAccount的方法形状全部保留只是实现从进程内直调变成了 HTTP 适配。以 UTAManagerSDK.ts 为例其头部注释明确写道该 SDK 是HTTP-backed adapter mirroringUTAManagers public surface不继承UTAManager后者已经物理移动到 UTA 进程内只镜像公开 API 的形状。几个关键行为变化同步变异步原resolve、get、size、listUTAs等同步方法全部改为 async调用方只需补一个await见 UTAManagerSDK.tsSetup hooks 变为 no-opsetSnapshotHooks、setFxService、registerCcxtToolsIfNeeded、initUTA、closeAll在 Alice 侧全部变成空操作或直接抛NotImplementedInSDK——因为快照调度器、FxService、CCXT 工具注册现在都是 UTA 自己的职责见 UTAManagerSDK.ts生命周期走 Guardian 重启协议reconnectUTA/removeUTA并不直接操作连接而是先由调用方写入accounts.json再触发triggerUTARestart()由 Guardian 对 UTA 进程执行 SIGTERM 重新拉起见 UTAManagerSDK.ts。值得注意的 v1 取舍单个 broker 的轮换会触发整个 UTA 进程重启多活跃账户用户会经历一个短暂的重新连接窗口。这是 v1 的明确 trade-off注释中注明未来可随 per-UTA 热加载一并优化UTAManagerSDK.ts。另外resolve()支持tradingOnly选项用于从无 source 的聚合中剔除data层级的 keyless 只读源如binance-readonly、okx-readonly、bybit-readonly——它们没有用户持仓与订单纳入聚合只会扩大失败面注释引用 issue #390见 UTAManagerSDK.ts。二、GuardianL2 进程监督者与三载体共享模块2.1 三个载体共用一份 L2 逻辑CHANGELOG 记载Guardian 的三个载体现在共享同一模块——scripts/guardian/{shared.ts, dev.ts, prod.mjs}。从 shared.ts 的注释可以看到三种载体devscripts/guardian/dev.ts由pnpm dev拉起built生产scripts/guardian/prod.mjs作为 Docker CMD 或本地 CLI 子进程desktop未来Electronmain进程。这一模块统一承载了 L2 的职责端口探测、子进程 spawn 与环境注入、HTTP 就绪门控waitForHttp、信号转发与级联关停installCascadeShutdown、dev 模式下的日志行前缀。2.2 端口架构与配置优先级端口在 spawn 时刻由 Guardian 一次性解析并通过环境变量注入子进程用户侧配置位于 L1 的data/config/ports.json默认 web 47331 / mcp 47332 / uta 47333 / connector 47334 / ui 5173见 shared.ts。优先级为显式环境变量OPENALICE_*_PORT ports.json 默认值值得注意的设计细节shared.ts显式配置的端口若被占用会直接报错失败fail loud而不是静默漂移到别的端口——用户钉死的值被悄悄改掉比启动失败更糟只有未配置的端口才保留从默认值向上探测的行为。ports.json缺失即未配置状态且 Alice 不得向该文件播种默认web值因为写入一个数字就是一次钉死。2.3 健康门控/__uta/healthGuardian 会在拉起 UTA 与 Alice 后以 UTA 的/__uta/health端点作为 Alice 启动的门禁Alice 的 boot 被 gate 在 UTA 健康通过之前。waitForHttp以默认 100ms 间隔轮询直到目标返回 200shared.ts。dev 模式下 Guardian 还会额外拉起 Vite。2.4 restart-flag 协议配置变更触发的 UTA 热重启这是本次架构中最具代表性的运行时机制完整协议记录在 restart-trigger.tsAlice 侧原子写data/control/restart-uta.flag先写.tmp再 rename内容为请求时刻的 ISO 时间戳Guardian 的startFlagWatcher监听到 flag 变化100ms 防抖Windows 下退化为 1s 轮询指纹比对见 shared.ts对 UTA 执行 SIGTERM → 等待退出 → 以原 spec 重新 spawnAlice 轮询/__uta/health直到返回的startedAt晚于触发前的旧值默认 20s 超时、200ms 间隔确认新进程已接管restart-trigger.ts。OptionalServiceController是这一能力在 Guardian 侧的实现它持有 UTA 子进程restart()依次完成 expectExit避免级联关停把有意重启误判为崩溃、killTreeSIGTERM8s 内未退出则 SIGKILL、重 spawn、waitForHttp就绪校验15s 超时并将新子进程通过trackReplacement重新接入级联关停的追踪列表shared.ts。killTree在 Windows 上使用taskkill /T /F整树收割避免cmd.exe包装进程被杀而真正的node孙进程仍占住端口shared.ts。2.5 Docker 与生产部署形态CHANGELOG 记载 Docker 镜像现在同时产出两个产物dist/main.jsAlice与services/uta/dist/uta.jsUTA二者在tini Guardian下运行——tini 负责容器内 PID 1 的信号转发Guardian 负责两级服务的编排与级联关停与上文prod.mjs载体的定位完全一致。三、traderalice/uta-protocolAlice 与 UTA 的长期边界契约共享的 wire 类型与 broker preset 目录被收进新的 workspace 包traderalice/uta-protocolAlice 与 UTA 两侧同时依赖它。该包的入口 packages/uta-protocol/src/index.ts 直言该协议被当作长期公共 API——即使今天 UTA 与本仓库同址未来部署可能把 UTA 迁到独立载体移动端 / 家庭服务器等届时该包就是两侧的稳定契约任何破坏性变更都需要两侧协同迁移。从包结构看它导出四类内容index.tstypestypes/manager.ts、types/broker.ts、types/git.ts、types/history.ts、types/contract-ext.ts、types/errors.ts等定义UTAClient、UTASummary、AggregatedEquity、ContractSearchHit等 wire 类型schemas运行时 schema 校验器UTA 侧消费clientclient/UTAClient.ts——Alice 侧消费的 HTTP 客户端基类brokersbrokers/preset-catalog.ts、brokers/presets.ts、brokers/search-rules.ts——broker 预设目录与合约搜索规则。CHANGELOG 中默认 crypto 切到 bybit demo、securities 切到 alpaca paper含 tickers的配置变更正是通过该包的 preset 目录落地的。此外 Broker Pack 机制把券商适配封装为可独立安装的包例如 packages/uta-broker-ccxt/src/index.ts 声明BROKER_PACK_API_VERSION 1、BROKER_ENGINE ccxt并将CcxtBroker作为统一入口导出——UTA 域内其他 broker packalpaca / ibkr / longbridge / leverup目录结构一致。四、v1 明确推迟的边界刻意不做的事CHANGELOG 专门列出三项未交付内容属于设计上有意的取舍而非遗漏Alice 与 UTA 之间的 auth gate 未启用v1 将 UTA 绑定到 127.0.0.1 并信任同主机loopback 直连无鉴权公网部署 admin-token session cookie 路径未实现目前 UTA 不具备面向公网的暴露面UTA 物理迁移尚未发生即把 UTA 挪到独立机器这一步仍未做——uta-protocol包只是为此预留契约。这三条共同界定了 UTA-split v1 的适用范围同主机、本地可信、进程级隔离。任何公网或跨主机的部署诉求都要等后续版本补齐鉴权与迁移能力。五、除 UTA-split 外的关键变更5.1 许可与整体合并Unreleased 章节中的 Merge 条目记录了两件事统一交易架构合并unified trading architecture AGPL-3.0 重新许可。后者与仓库根目录 LICENSE 及 README.md 中的声明一致——OpenAlice 现在以 AGPL-3.0 对外发布。5.2 CI 与性能CI新增 GitHub Actions workflow并修复了时间敏感的测试避免测试在特定时刻执行产生偶发失败。性能将 CCXT 初始化与启动解耦使插件无需等待交易所初始化完成即可立即启动。对照 CcxtBroker.ts 中导入的MAX_INIT_RETRIES/INIT_RETRY_BASE_MS见该文件第 34 行CCXT 连接带有指数退避重试机制解耦后启动不再被初始化阻塞。5.3 UI 打磨三轮Round 1chat input、sidebar、card systemRound 2共享组件、过渡动画、table hoverRound 3toast 系统、发送 spinner、移动端修复。5.4 交易域功能演进Features 精选与本次架构主线直接相关的核心功能条目统一交易类型引入Contract、ITradingAccount、AccountManager、TradingGit一套统一类型消除各券商之间的类型碎片统一 guard 流水线合并 crypto 与 securities 两套 guard形成可扩展的检查管线guards/目录下可见cooldown.ts、max-position-size.ts、symbol-whitelist.ts、guard-pipeline.ts等实现多账户工具路由通过source参数在多个账户间路由 AI 交易工具并新增getQuote跨全部账户聚合报价CCXT 能力扩展ticker、funding rate 查询、order book 深度查询用于流动性评估、realizedPnL修复read-only 模式允许无 key 访问行情数据Alpaca实时 quote 与原生closePosition合约解析重构resolveContract拆分为searchContractsgetContractDetails搜索与详情查询分离snapshot/FX快照调度、FX 服务随交易域整体迁入 UTA见 services/uta/src/domain/trading/snapshot 与 fx-service.ts。5.5 重构主线Refactoring 精选重构条目呈现出清晰的收敛方向与 UTA-split 的目标一致——模块归位、单一职责、消除重复CcxtAccount、AlpacaAccount各自拆分为更小的模块对应 UTA 内brokers/ccxt/下的CcxtBroker、ccxt-contracts、ccxt-tools、ccxt-types、overrides等文件拆分AI provider 侧VercelAIProvider与ClaudeCodeProvider接口对齐AgentCenter成为编排中心、Engine被删除、会话持久化统一收口到AgentCenter移除交易白名单替换为可选的 symbol-whitelist guard默认不启用wallet*重命名为trading*commit/push/sync的 source 变为可选adjustLeverage与OrderRequest.leverage被移除OrderRequest对齐 IBKR 形态并新增modifyOrder。5.6 Bug Fixes 精选按主题归类AI 工具与 MCP 侧Claude Code provider 注入 persona brain state结果为空时提取 assistant 文本--disallowedTools/--allowedTools的正确切换evolution 模式用 disallowed、普通模式恢复 allowed并支持evolutionMode热重载MCP Server 改为常开Claude Code provider 依赖它获取工具同时默认mcpPort改为 3001 保证 MCP tools server 总在启动通过--allowedTools注入 MCP 工具权限并将.claude/加入 gitignore引擎为 null 时跳过 crypto 交易工具。OpenBB / 数据侧从 provider 配置中移除 commodity修复 provider 选项列表CCXT 选项改为放在optionskey 下而非顶层展开为 equity fundamental 与 news 工具设置正确的 providernews provider 拆分并处理 204 No ContentRSS 抓取失败时重试一次按资产类别设置默认 provider替代单一全局默认值。配置与初始化侧Connectors 配置自动初始化并附带迁移默认值从sectionSchemas推导validSections防止配置 API 漂移旧版迁移时向磁盘播种platforms.jsonaccounts.jsonCCXT 按类型顺序加载 markets 并带每类重试AlpacaAccount 初始化带指数退避重试。UI/流式侧批量质量修复XSS、toggle、SSE 去重、错误反馈持久化流式工具调用文本生成期间显示思考点SSE 稳定性——指数退避自动重连会话层在工具循环期间持久化中间文本块。文档与兼容性替换 Mermaid 语法以获得更广的渲染器兼容opentypebb导出指向src/使 tsx 无需构建即可解析hono 从 4.7.4 升级到 4.12.7 解决类型不匹配后端 switch API 校验放行agent-sdkCI 中 pnpm 版本取自package.json的packageManager字段。5.7 测试基建CHANGELOG 明确给出了本轮测试规模equity indicator calculator 48 个单测、message pipeline 集成测试 42 个、core 模块单测 134 个外加交易 dispatcher 与 wallet 状态机的单测。这些测试多数散落在各模块旁的.spec.ts文件中如 services/uta/src/domain/trading/brokers/ccxt/CcxtBroker.spec.ts、src/services/uta-client/UTAManagerSDK.spec.ts另外 UTA 域内还设有__test__/e2e/目录包含 alpaca-paper、ccxt-bybit、ccxt-hyperliquid、ccxt-okx、ibkr-paper 等真实环境端到端测试services/uta/src/domain/trading/test/e2e。六、如何在本仓库中验证这些变更阅读变更全貌CHANGELOG.md 是本轮变更的唯一权威清单本文所有条目均可在其中找到原文追踪 UTA 域services/uta/src/domain/trading 是交易域的完整落点broker 适配、guard、TradingGit、snapshot、FX 全部在此理解 Alice 侧视角src/services/uta-client 下两个 SDK 展示了进程内 → HTTP的适配思路src/services/uta-supervisor/restart-trigger.ts 展示了重启协议全流程查看 L2 编排scripts/guardian/shared.ts 是端口、spawn、健康门控、级联关停与 restart-flag watcher 的统一实现scripts/guardian/prod.mjs 与 scripts/guardian/dev.ts 是两个现役载体核对契约包packages/uta-protocol/src 是 Alice ↔ UTA 的长期边界未来 UTA 若迁移独立载体改动将从这里开始。结语UTA-split v1 的实质是在保持对外 API 形状不变的前提下把交易域从 Alice 主进程中物理剥离开来。Guardian 的三载体共享模块与 restart-flag 协议保证了这一拆分在 dev、Docker、未来 desktop 三种形态下行为一致而traderalice/uta-protocol则为更远的跨载体迁移预留了契约。对使用 OpenAlice 的开发者而言理解这三层结构交易域、监督层、契约层也就理解了当前仓库的整体运行方式对想贡献代码的读者CONTRIBUTING.md 与 README.md 提供了仓库层面的进一步指引。赞分享【免费下载链接】OpenAliceYour one-person Wall Street. An AI trading agent covering equities, crypto, commodities, forex, and macro — from research through position entry, ongoing management, to exit.项目地址https://gitcode.com/gh_mirrors/op/OpenAlice点击查看免费下载相关推荐BloomRPC源码架构演进从v1到最新版的变化BloomRPC源码架构演进从v1到最新版的变化 引言从GUI客户端到架构成熟 BloomRPC作为一款 gRPC GUI客户端 Graphical Us开发工具终极指南Neon Serverless Postgres从v1到最新版本的架构演进与技术突破终极指南Neon Serverless Postgres从v1到最新版本的架构演进与技术突破 Neon是一款革命性的Serverless Postgres数据数据库后端分布式数据库云原生JAX 版本演进与变更日志深度解读从 0.1.58 到 0.11 的 API 演进全景JAX 版本演进与变更日志深度解读从 0.1.58 到 0.11 的 API 演进全景 JAX 是面向 Python NumPy 程序的可组合变换框架自人工智能机器学习深度学习编译器高性能计算上一篇终极揭秘Paints-UNDO如何用AI技术逆向解析人类绘画行为下一篇深度解析Cogito v2大语言模型开源商业新纪元的混合推理引擎创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考