luoome

织机 + 罗网 — 汇聚网罗有价值的信息数据，在面对变化的市场时提供准确的建议。

luoome 是一个本地优先的个人投资管理 advisor agent。它把"账户、持仓、交易、行情、战法、风控、笔记、建议"这些能力全部以 tool 的形式暴露出来，同时把多源数据织成结构化的、可追溯的投资建议。

• 作为 TUI 在终端盯盘、看建议

• 作为 Web 在浏览器查看仪表盘（含多账户下拉 + 校准表）

• 作为 MCP server 被 Claude Desktop / OpenClaw / Hermes 等 agent 直接调用，并让它们替你做"分析 → 建议 → 行动"的推理

名字

luoome = 织机 + 罗网

• 织：把分散的行情、财报、新闻、战法信号、历史持仓织成一张连贯的认知

• 罗：把市场里有价值的信息数据罗（网）进来，不漏关键信号

• me：me，你（用户）是这一切的中心，不是旁观者

面对不断变化的市场，luoome 不替你下单，但会主动告诉你：哪里有机会、哪里有风险、哪些决策需要你确认。

设计原则

• Advisor-first：每一份数据最终都服务于"可执行的投资建议"，不是堆数据。

• Agent-first：所有能力都是 tool，没有"只能人用、agent 用不了"的功能。

• Local-first：数据在本地 SQLite，默认无云同步。

• Schema-driven：Zod schema 是 tool I/O 的事实来源，自动生成 TypeScript 类型、MCP tool 定义、OpenAI function calling schema。

• Workflow ≠ Tool：tool 是原子能力，workflow 是组合；workflow 内置编排，tool 暴露给上层 agent。

• No magic：每个数据源 / 适配器 / LLM 都显式可插拔，运行时可见。

• Human-in-the-loop：建议 ≠ 行动。advice 永远不直接触发交易；下单始终需要人确认。

它做什么

数据维度（读 + 写）

• 账户（多账户、真实/模拟）

• 持仓、交易、笔记、预警

• 行情快照、日线、技术指标

• 战法规则 + 战法信号

• 风控指标（VaR、Sharpe、最大回撤、集中度）

分析维度（只读）

• PnL、风险敞口、行业暴露

• 战法扫描 + 信号评分

• 多源行情交叉验证

• LLM 推理总结（每日复盘、个股分析）

建议维度（核心）

• 个股建议：基于技术面 + 基本面 + 战法信号 + LLM 综合判断，输出 buy / sell / hold / watch / avoid 决策

• 持仓建议：每个持仓的继续持有 / 加仓 / 减仓 / 清仓建议

• 市场观点：每日大盘观点、行业轮动、热点板块

• 风险预警：跌破止损位、触发风控规则、异常波动

• confidence 自校准：历史 advice 按信心桶聚合 hitRate，告诉你系统 confidence 是否被高估

每条建议都带：决策 + 信心度 + 有效期 + 核心论点 + 支持证据 + 反证 + 风险点 + 免责声明。

仓库结构

Bun workspace monorepo：

packages/
  core/        纯领域类型 + 不变量（无 IO）
  db/          Drizzle schema + repository 实现
  tools/       Tool 注册表 + Zod → TS/MCP/OpenAI 自动生成
  adapters/    行情 / LLM / 通知 / 券商 等外部依赖适配
  workflows/   内置编排：review / scan / diagnose / advise
  mcp/         MCP server，把 tool registry 暴露给外部
  cli/         命令行入口
  tui/         opentui 应用
apps/
  web/         Hono + 同源静态仪表盘
homebrew/
  luoome.rb    Homebrew formula（brew tap KowL/luoome && brew install luoome）

环境变量

文档

状态

v0.5.0 — Multi-Market & Polish（HEAD 67df4b4）

已完成 7 块（按 ROADMAP 顺序）：

1. 真实行情接线（LUOOME_MARKET_PROVIDER=real：A 股 Eastmoney 主 → Tencent 备 → Mock 兜底）

2. 真实 LLM 接线（LUOOME_LLM_PROVIDER=openai-compatible / anthropic，缺 key 启动期报错）

3. 持仓 / 交易录入 4 个 write tool：add_trade / add_holding / update_holding / close_holding

4. K 线成交量量纲统一为股（×100）

5. buildMockContext 时间炸弹修复（业务时钟 max(锚点, 真实时间)）

6. 多账户切换 UI（W3）：3 mock 账户 + TUI [a] 弹层 + Web 顶栏下拉 + POST /api/account/select

7. confidence 自校准（W4）：新 tool get_confidence_calibration（10 桶聚合 hitRate / avgPnl / avgConfidence）+ TUI [c] + Web 复盘页校准表

数据：27 tool（read 14 / advice 3 / write 5 / external 4 / trade 0 永不暴露）

测试：460 vitest + 107 test:all + 7 TUI smoke 全部通过；typecheck / lint clean