StockTracker 是一个本地优先的个人投资记录、组合核算和 AI 投研工作台。
它帮助你记录交易、核算真实持仓成本、跟踪行情和收益，并让 AI Agent 基于你的真实持仓、交易记录和公开市场数据做克制的投研分析。数据默认保存在本机 SQLite，不需要账号，不默认上传到云端。
快速开始 · 桌面客户端 · Docker 运行 · 核心能力 · AI Agent · 文档 · 免责声明
以下截图使用脱敏 demo 数据生成，不包含真实持仓或交易记录。
| 组合总览 | 持仓列表 |
|---|---|
 |
 |
| 个股详情 | AI 对话 |
|---|---|
 |
 |
大多数投资工具擅长展示价格，但不回答持仓核算的具体问题：真实成本是多少、手续费和分红怎么算进去。
StockTracker 的重点是把这些问题算清楚：基于 FIFO 核算每笔卖出的真实盈亏，持仓成本含手续费摊薄；AI Agent 按需读取你的真实持仓批次和交易记录做分析，而不是泛泛聊股票。数据默认存在本机 SQLite，不需要账号，不上传到云端。
StockTracker 适合：
- 想自己记录股票、ETF、基金或加密资产交易的个人投资者。
- 关心 FIFO、手续费、分红和真实成本核算的人。
- 希望数据默认留在本机，并能自行备份和迁移的人。
- 想把 AI 用在自己的持仓和交易复盘上，而不是泛泛聊天的人。
- 愿意 self-host，并接受第三方行情接口偶尔波动的人。
StockTracker 不适合：
- 高频交易、自动下单或券商账户同步。
- 多用户云端协作、跨设备实时同步或团队后台。
- 对行情实时性和准确性有严格合规要求的生产交易终端。
- 想获得确定性投资建议、收益承诺或自动买卖指令的场景。
- 本地 SQLite 持久化，默认不依赖云端账号。
- 支持 A 股（含 ETF）、港股、美股、基金、加密资产的统一记录模型。
- 支持买入、卖出、分红和加密资产收益记录。
- 固定基于 FIFO 计算卖出盈亏明细，并按券商摊薄口径计算当前持仓成本、浮动盈亏和总盈亏。
- 按市场自动计算手续费，支持用户配置费率。
- 聚合腾讯财经、Nasdaq、Yahoo Finance、Stooq、Alpha Vantage 等股票行情源。
- 加密资产报价和 K 线优先使用 Binance，失败回退 Coinbase。
- 支持 K 线、技术指标、估值字段、新闻和大盘概览。
- 内置汇率服务，支持多币种持仓统一折算。
- 多数据源自动降级，最终兜底到 Manual 手动输入模式。
- 内置 AI 对话、组合分析、个股分析和大盘分析。
- AI Agent Runtime 按需调用 Skill，不把全部持仓粗暴塞进上下文。
- 交易复盘内置事实账本、成本收益、仓位风险、行情位置和行为纪律等分析框架，并可解释道氏理论、趋势跟随、均值回归等常见方法论。
- 支持未持仓标的查询，自动解析名称、代码和市场并抓取外部行情。
- 支持公开网页搜索和受控网页抓取，用于新闻、公告、财报和大盘事件补充。
- 提供受控的 AI Agent Trace 调试视图，方便排查意图识别和 Skill 调用链路。
- 使用 pnpm，项目会阻止 npm/yarn 安装以保持 lockfile 一致。
- 支持 Electron 桌面客户端（macOS / Windows），下载安装即用。
- 支持 Docker / Docker Compose 本地运行。
- 支持中文 / 英文 UI 切换，语言偏好保存在浏览器本地。
- 支持 OpenAI-compatible 和 Anthropic-compatible 模型服务。
- 提供服务端结构化日志和外部接口 smoke test，便于排查上游接口变化。
环境要求：
- Node.js 18+
- pnpm
- macOS / Linux / Windows
git clone https://github.com/byte92/stocktracker.git
cd stocktracker
pnpm install
pnpm dev启动后访问：
pnpm dev 默认使用 3218，如果端口被占用会自动向后查找可用端口，并在终端输出实际地址。建议启动后先完成 AI 模型配置，以启用对话、组合分析、标的分析和大盘分析等核心体验。
更多开发、环境变量、数据库和测试说明见 开发指南。
不需要命令行或 Docker 环境，下载安装即可使用。
前往 GitHub Releases 下载对应平台的安装包：
| 平台 | 格式 | 安装方式 |
|---|---|---|
| macOS | .dmg |
双击打开，拖拽到 Applications |
| Windows | .exe |
运行安装向导 |
首次打开会引导配置 AI 服务（可跳过），数据保存在本地，不需要账号。
如需从源码构建桌面客户端：
# macOS
pnpm electron:build:mac
# Windows
pnpm electron:build:win构建产物在 dist-electron/ 目录下。
开发模式调试：
# 先构建 Next.js standalone
pnpm build
# 启动 Electron 开发模式
pnpm electron:dev更多说明见 Electron 桌面客户端设计。
StockTracker 的核心体验依赖 AI 对话和分析能力，建议把模型连接信息放在 .env.local：
cp .env.example .env.local常用变量：
AI_PROVIDER=openai-compatible
AI_BASE_URL=https://api.openai.com/v1
AI_MODEL=gpt-4.1-mini
AI_API_KEY=sk-...如果 .env.local 中的 AI 配置完整，服务端会优先使用环境变量；设置页中的连接配置会作为本地兜底。Temperature、Max Context Tokens、新闻增强和 AI 分析语言仍由设置页控制。
如果你只想把它作为本地服务跑起来，可以直接使用 Docker Compose：
git clone https://github.com/byte92/stocktracker.git
cd stocktracker/docker
docker compose up -d --build启动后访问：
如需修改宿主机端口，可把 docker/.env.example 复制为 docker/.env 并修改 HOST_PORT。AI 模型配置仍放在根目录 .env.local；Docker Compose 会读取 .env.local 并注入容器。没有 docker/.env 时端口默认使用 3218。
容器默认把 SQLite 数据保存在 docker/data/finance.sqlite 中，重启不会丢失。更多说明见 Docker 部署指南。
StockTracker 的 AI 不是通用聊天机器人，而是围绕个人持仓和股票数据工作的投研 Agent。
用户问题
-> Planner 识别意图、市场和需要的数据
-> security.resolve 解析名称、代码和候选标的
-> Skill Registry 选择本地持仓、行情、技术指标、网页搜索等能力
-> Executor 按需读取数据
-> Context Composer 组装最小必要上下文
-> LLM 流式生成回复
当用户询问个股新闻、公告、利好利空，或 A 股大盘今日政策、盘面新闻时，Agent 会按需调用公开网页搜索。搜索结果会作为带标题、链接、摘要和搜索时间的候选来源进入回答上下文。
- Next.js App Router + React + TypeScript
- Electron（桌面客户端）
- Zustand
- SQLite + better-sqlite3
- Tailwind CSS
- lightweight-charts / Recharts
- Playwright
- pnpm
- Docker / Docker Compose
flowchart TB
User["用户 / 浏览器"] --> App["Next.js App Router"]
App --> Store["Zustand 状态层"]
App --> Api["API Routes"]
Store --> Api
Api --> SQLite["SQLite 本地数据库"]
Api --> Finance["收益 / 手续费 / FIFO 计算"]
Api --> DataSources["行情、K 线、新闻、汇率数据源"]
App --> AgentUI["AI 对话与分析界面"]
AgentUI --> Agent["AI Agent Runtime"]
Agent --> Planner["Planner 意图识别"]
Agent --> Skills["Skill Registry"]
Skills --> SQLite
Skills --> DataSources
Agent --> LLM["OpenAI / Anthropic 兼容模型服务"]
Electron["Electron 桌面客户端"] --> |"子进程"| App
Docker["Docker / Docker Compose"] --> App
Docker --> SQLite
欢迎提交 Issue、改进文档、补充测试、优化 UI、修复行情源、扩展 Skill 或完善 Agent Runtime。
提交 PR 前请阅读 CONTRIBUTING.md。
StockTracker 提供的是交易记录、数据整理和辅助分析工具，不构成任何投资建议。行情、估值、新闻和 AI 输出可能存在延迟、遗漏或错误。请独立判断风险，并对自己的投资决策负责。