深度金融研究的自主代理

德克斯特 🤖

Dexter是一位自主的金融研究员，边工作边思考、规划和学习。它通过任务规划、自我反思和实时市场数据进行分析。可以想象成Claude Code，但专门为金融研究设计。

目录

• 👋 概述
• ✅ 前提条件
• 💻 安装方法
• 🚀 How to Run
• 📊 如何评估
• 🐛 调试方法
• 📱 如何使用WhatsApp
• 🤝 如何贡献
• 📄 许可

⚠️ 免责声明

这个项目是仅供教育、娱乐和信息参考.它并非用于真实交易或投资。

• 非财务、投资、税务或法律建议
• 不保证准确性、完整性或适合任何用途
• 输出可能不正确、不完整或过时
• 创作者和贡献者不承担任何经济损失或损害的责任
• 在做出投资决策前，请咨询持证理财顾问
• 过往表现不代表未来结果

👋 概述

Dexter将复杂的财务问题转化为清晰的、逐步的研究计划。它使用实时市场数据执行这些任务，核对自身工作，并不断优化结果，直到得到一个有信心、有数据支持的答案。

• 智能任务规划：自动将复杂查询分解为结构化的研究步骤
• 自主执行：选择并执行合适的工具来收集财务数据
• Self-Validation：检查自身工作并迭代直到任务完成
• 实时财务数据：访问损益表、资产负债表和现金流量表
• 安全特征：内置环路检测和步进限制以防止失控执行

✅ 前提条件

• Bun运行时（v1.0或更高版本）
• OpenAI API 密钥（获取here)
• Financial Datasets API key （gethere)
• Exa API key (get here）——可选，用于网页搜索

安装Bun

如果你还没安装Bun，可以用curl安装：

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

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

安装后，重启终端并确认 Bun 是否安装：

bun --version

💻 安装方法

1. 克隆仓库：

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

1. 用Bun安装依赖：

bun install

1. 设置环境变量：

# Copy the example environment file
cp env.example .env

# Edit .env and add your API keys (if using cloud providers)
# 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)

# Institutional-grade market data for agents
# FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key

# (Optional) If using Ollama locally
# OLLAMA_BASE_URL=http://127.0.0.1:11434

# Web Search (Exa preferred, Tavily fallback)
# EXASEARCH_API_KEY=your-exa-api-key
# TAVILY_API_KEY=your-tavily-api-key

🚀 How to Run

以互动模式运行《嗜血法医》：

bun start

或者用观察模式进行开发：

bun dev

📊 如何评估

Dexter包含一套评估套件，用于将经纪人与财务问题数据集进行测试。评估采用LangSmith进行跟踪，采用LLM作为评判方法进行评分正确性。

bun run src/evals/run.ts

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

评估跑者会实时显示进展、当前问题和跑步准确率统计数据。结果会被记录到LangSmith进行分析。

🐛 调试方法

Dexter logs all tool calls to a scratchpad file for debugging and history tracking. Each query creates a new JSONL file in .dexter/scratchpad/.

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

每个文件包含换行分隔的JSON条目跟踪：

• init：原始查询
• tool_result：每个工具调用，包含参数、原始结果和LLM摘要
• thinking： 代理人推理步骤

{"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"}

这使得检查代理人收集了哪些数据及其对结果的解读变得容易。

📱 如何使用WhatsApp

通过WhatsApp与Dexter聊天，将手机连接到网关。你发给自己的消息会由Dexter处理，回复也会被发送到同一个聊天频道。

# Link your WhatsApp account (scan QR code)
bun run gateway:login

# Start the gateway
bun run gateway

然后打开WhatsApp，进入你自己的聊天（给自己发消息），问Dexter一个问题。

有关详细的安装说明、配置选项和故障排除，请参见WhatsApp Gateway README.

🤝 如何贡献

1. 分支仓库
2. 创建功能分支
3. 提交你的修改
4. 推向分支
5. 创建拉取请求

📄 许可

该项目采用MIT许可证授权。

文章来源：https://github.com/virattt/dexter