Dexter 🤖

Dexter 是一个自主财务研究 Agent，它能在工作时进行思考、规划和学习。它通过任务规划、自我反思和实时市场数据来执行分析。可以将其理解为专门为财务研究而构建的“Claude Code”。

👋 概述

Dexter 接收复杂的财务问题，并将其转化为清晰、分步骤的研究计划。它使用实时市场数据执行这些任务，检查自己的工作成果，并不断优化结果，直到得出有数据支持的可靠结论。

核心能力：

智能任务规划：自动将复杂查询拆解为结构化的研究步骤。
自主执行：选择并执行合适的工具以收集财务数据。
自我验证：检查自身工作并进行迭代，直至任务完成。
实时财务数据：支持访问损益表、资产负债表和现金流量表。
安全特性：内置循环检测和步骤限制，防止执行失控。

✅ 前置条件

Bun 运行时 (v1.0 或更高版本)
OpenAI API key (点击获取)
Financial Datasets API key (点击获取)
Exa API key (点击获取) - 可选，用于网络搜索

安装 Bun

如果你尚未安装 Bun，可以使用 curl 进行安装：

macOS/Linux:

curl -fsSL https://bun.com/install | bash

Windows:

powershell -c "irm bun.sh/install.ps1|iex"

安装完成后，重启终端并验证 Bun 是否安装成功：

bun --version

💻 如何安装

克隆代码仓库：

git clone https://github.com/virattt/dexter.git
cd dexter

使用 Bun 安装依赖：

bun install

配置环境变量：

# 复制示例环境变量文件
cp env.example .env

# 编辑 .env 并填入你的 API keys（如果使用云服务）
# OPENAI_API_KEY=your-openai-api-key
# ANTHROPIC_API_KEY=your-anthropic-api-key (optional)
# GOOGLE_API_KEY=your-google-api-key (optional)
# XAI_API_KEY=your-xai-api-key (optional)
# OPENROUTER_API_KEY=your-openrouter-api-key (optional)

# 机构级市场数据接口；AAPL, NVDA, MSFT 为免费
# FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key

# (可选) 如果在本地使用 Ollama
# OLLAMA_BASE_URL=http://127.0.0.1:11434

# 网络搜索 (推荐 Exa，备选 Tavily)
# EXASEARCH_API_KEY=your-exa-api-key
# TAVILY_API_KEY=your-tavily-api-key

🚀 如何运行

在交互模式下运行 Dexter：

bun start

或者使用开发监听模式：

bun dev

📊 如何评估

Dexter 包含一套评估工具，用于根据财务问题数据集测试该 Agent。评估过程使用 LangSmith 进行追踪，并采用 LLM-as-judge（大模型作为评判者）的方法来给准确性评分。

运行所有问题：

bun run src/evals/run.ts

运行随机抽样数据：

bun run src/evals/run.ts --sample 10

评估运行器会显示一个实时 UI，展示进度、当前问题和运行准确率统计。结果将记录到 LangSmith 中以便进一步分析。

🐛 如何调试

Dexter 会将所有工具调用记录到暂存盘（scratchpad）文件中，方便调试和历史追踪。每次查询都会在 .dexter/scratchpad/ 目录下创建一个新的 JSONL 文件。

暂存盘位置：

.dexter/scratchpad/
├── 2026-01-30-111400_9a8f10723f79.jsonl
├── 2026-01-30-143022_a1b2c3d4e5f6.jsonl
└── ...

每个文件包含按行分隔的 JSON 条目，用于追踪：

init：原始查询
tool_result：带有参数、原始结果和 LLM 总结的每次工具调用
thinking：Agent 的推理步骤

暂存盘条目示例：

{"type":"tool_result","timestamp":"2026-01-30T11:14:05.123Z","toolName":"get_income_statements","args":{"ticker":"AAPL","period":"annual","limit":5},"result":{...},"llmSummary":"Retrieved 5 years of Apple annual income statements showing revenue growth from $274B to $394B"}

这使得检查 Agent 到底收集了哪些数据以及它是如何解读结果的变得非常容易。

📱 如何配合 WhatsApp 使用

通过将你的手机连接到网关，你可以通过 WhatsApp 与 Dexter 聊天。你发送给自己的消息会被 Dexter 处理，回复内容会发送回同一个对话框。

快速开始：

# 连接你的 WhatsApp 账号（扫描二维码）
bun run src/whatsapp/gateway.ts

🤝 如何贡献

欢迎提交 Issue 和 Pull Requests！请查看 CONTRIBUTING.md 了解更多详情。

📄 许可协议

本项目采用 MIT 许可协议开源。