Skip to content

About

HunterCode 投研终端 · AtomCode 发行版(主仓在 GitCode)

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

394 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌏 中文(当前) · English

HunterCode

HunterCode · AtomCode Unified (v3.5.3)

Community & AtomCode Edition

自部署的 AI 投研助手 · A股 / 港股 / 美股 · AtomCode 5.1.0 提速内核 · 20 个 MCP + 22 个金融 SKILL · 数据和对话都在你自己的机器上

HunterCode 是腾讯 WorkBuddy 金融版的开源本地替代方案 · 面向私募机构私有化部署、证券公司接口联调与专业个人投资者
腾讯、WorkBuddy 是腾讯公司的商标。HunterCode 与腾讯公司无隶属、合作或授权关系。

Version Kernel License CI Stars GitCode

HunterCode 演示:功能总览 → 选股器扫描 A股/港股/美股 → 小鹿智能体研究台

🚀 在线演示  ·  ⚡ 5 分钟部署  ·  📖 产品说明书  ·  帮助中心  ·  运维手册  ·  💬 讨论区

🚀 2026-11-14 里程碑发布 v3.5.3:全面建成证券公司接口适配层(20 个 MCP 服务 · 69 个工具)+ 56 项技术指标/90 项基本面/ETF 定投确定性计算引擎 + 22 个金融 SKILL + 每日三段式工作流与五大工作台 + CSDN 实战示例包!
hunter-community 与 huntercode-atomcode(GitHub & GitCode)自 v3.0.0 起实现双仓同源同 SHA 统一(原 OpenCode v2.2 分支归档于 legacy/opencode-v2.2)。

🏆 入围世界人工智能开源大赛(GOAI)总决赛 · 赛道二 TOP 15 · 与 WorkBuddy 金融版逐项对比(附官方来源) · 完整演示视频 3 分钟

⚠️ 免责声明:本项目是投研分析工具,所有输出为 AI 生成内容,仅供研究参考,不构成任何投资建议。投资有风险,决策需谨慎。


🎉 v3.5.3 证券公司接口与金融 SKILL 体系核心全景(20 个 MCP + 22 个金融 SKILL)

1. 20 个标准 MCP 服务(12 个既有服务 + 8 个新增证券公司专属只读 MCP · 共 69 个工具)

类别 MCP 服务名称 核心功能与工具集
既有核心 MCP(12 个) hcapack、akshare、kronos、truesource、uzi、watchlist、portfolio、screener、hunter_cap、hunter_user、runtime_control、fin_memory 个股快照、情报聚合、公开行情、K线预测、自选股管理与 PDF 页码检索、组合压力测试、市场筛选、技能安装、自定义源、工作流控制与投研经验记忆库
P0 券商核心只读 MCP(4 个) broker_security、broker_market、broker_disclosure、broker_fundamental 证券主数据与历史指数成分(search_security/get_security_profile/get_security_status/get_index_constituents);实时/延时报价、前/后/不复权 K 线、五档盘口、市场状态与交易日历(get_quote/get_kline/get_orderbook/get_market_status/get_market_overview/get_market_calendar);公告检索与 PDF 页码定位(search_announcements/get_announcement/search_news/get_news_detail);Point-in-Time 三大财报、财务比率、估值分位、股东与分红送转(get_financial_statements/get_financial_ratios/get_valuation/get_shareholders/get_corporate_actions)
P1 券商进阶只读 MCP(3 个) broker_funds、broker_research、broker_education ETF 报价/IOPV、基金净值、ETF 申赎成分、基金费率与可转债(get_etf_quote/get_fund_nav/get_etf_holdings/get_fund_fee/get_bond_data);合规授权研报、盈利一致预期与行业拥挤度(get_research_reports/get_consensus_estimates/get_sector_data);投教检索、产品百科与风险揭示书(search_investor_education/get_product_guide/get_risk_disclosure)
P2 账户只读连接器(1 个) broker_account_readonly(默认关闭,需用户单独 OAuth 授权) 脱敏账户列表、资金概览、持仓快照、历史成交记录(get_accounts/get_account_summary/get_positions/get_trades),AES-256-GCM 凭证加密托管 + 一键撤销 + Excel/CSV 交割单手工导入兜底,物理级 0 交易下单接口

2. 22 个金融投研 SKILL(7 个既有升级 + 8 个 P0 日常 + 7 个 P1 进阶)

分组 技能名称(共 22 个) 核心场景说明
既有升级技能(7 个) uzi、deep_analysis、investor_panel、lhb_analyzer、risk_profile、trap_detector、market-event-analyst 全面升级接入 BrokerDataEnvelope 统一数据信封与【已核实事实 / 逻辑推断 / 待核实问题】三栏证据格式
P0 股民日常高频技能(8 个) daily_market_brief(市场晨报)、watchlist_daily_brief(自选股日报)、announcement_impact(公告 PDF 页码解读)、earnings_review(财报质量体检)、technical_dashboard(56项技术看板)、fundamental_scorecard(90项基本面评分卡)、portfolio_risk_check(组合风险巡检)、after_close_review(15:30 盘后复盘) 覆盖盘前(08:30)、盘中异动解释、盘后复盘(15:30)全天候日常投研闭环
P1 进阶与量化研究技能(7 个) factor_research(因子 IC/分层检验)、etf_dca_planner(ETF 定投正向/反推规划)、investment_thesis_tracker(投资论点与反证跟踪)、stock_screener_builder(自然语言选股构建)、news_signal_digest(多源新闻水位线去重)、trading_journal(交易计划与交割单复盘)、backtest_quality_auditor(回测未来函数与幸存者偏差审计) 配套「市场」「自选股」「个股研究」「量化与 ETF 定投」「组合复盘与只读授权」五大工作台与 examples/csdn_broker_notebooks/ 实战包

🎉 v3.0.0 四大核心升级亮点

  1. 全面采用 AtomCode 5.1.0 Fork 提速对话内核(daemon 服务彻底替代 opencode)
    • 国产开源高性能底座:基于 AtomCode v5.1.0 投研定制版(内置 --system-prompt-file 领域人设替换与 --tools-deny 编码工具裁剪),常驻内存相比旧版 OpenCode 降低 70% 以上,彻底消除多轮工具重复调用。
    • 5 组领域 Hook 常驻加速(hookd):guard(写路径门禁与 _hermes_user_id 身份自动注入)、context(每轮注入真实交易日历与盘中时段)、lang(中文与合规署名硬约束)、audit(全量工具调用落盘 AUDIT.jsonl)、budget(Token 预算门禁)。
    • 12 个 MCP Server + 16KB 三档大小闸(hca_size_guard):涵盖 hcapack、AKShare、Kronos、TrueSource、UZI、自选股(watchlist)、投资组合(portfolio)、选股器(screener)、能力目录(hunter_cap)、用户数据源(hunter_user)、运行期控制通道(runtime_control)与经验库(fin_memory),所有宽表返回自动执行三档降级裁剪,永不撑爆上下文。
    • llm-shim 智能协议清洗:内置 ToolCallIndexer(自动修复多工具并发流式 index)、<think> 标签剥离与 100 条环形诊断追踪队列(GET /trace)。
  2. 智能炒股一至五期完整闭环(paper + fin-worker + temporal)
    • 唯一只追加账本(paper):由受限数据库角色 fin_paper_rw(无 UPDATE/DELETE 权限)守护,内置 A 股六条确定性风控,绑数据源快照撮合。
    • Temporal 六大交易时点调度:09:15 / 09:30 / 11:30 / 13:00 / 14:55 / 15:30 全自动驱动,崩溃按历史恢复。
    • 经验库与受控自进化闭环:盘后复盘自动沉淀经验 → 生成白名单参数提案 → 独立影子盘验证 → 收紧方向自动生效(L12–L15),全程留痕可回滚,PAPER_MODE 恒为模拟盘。
  3. 新版策略中心 + 多模态文档解析 + Gemini 4 Argon 默认模型
    • 策略中心:小鹿智能体自然语言规则识别、可视化规则编辑、防过拟合评分与多版本实验对照。
    • 文档深度解析:对话框支持上传 PDF 财报/研报、Excel 交割单、Word 纪要与 Markdown 笔记,内置三级解析引擎与右侧原文页码溯源抽屉。
    • Gemini 4 Argon 默认底座:默认模型与内置免费额度全线升级为谷歌旗舰推理模型 gemini-4-argon(聊天框展示为 Hunter-Gemini 4 Argon(谷歌 4.0))。
  4. 全链路大模型调用日志跟踪与一键下载
    • 设置页「大模型」标签页新增 「大模型调用日志与问题跟踪」 卡片,支持「⚡ 实测一次大模型并记录日志」与「📥 下载诊断日志文件(.log)」,自动脱敏 API Key,排障一目了然。

⏱ 30 秒看懂

它是什么 —— 一个跑在你自己电脑或服务器上的金融 AI 投研终端。你给它一个大模型 key(或直接用内置免费额度),它就能查行情、拉新闻、读 PDF 财报、做个股深度分析、预测走势、管理自选和持仓、跑模拟盘智能交易,并按你写的 SKILL(分析方法论)工作。对话、持仓、投资论点与模拟账本全部存在本地数据库,仓位数据不出硬盘。

它不是什么 —— 不接券商实盘交易,不替你做决策,不保证预测准确。它是把公开数据、分析方法论和大模型组织起来的研究助手。

适合谁 —— 会用 Docker(或使用桌面启动器)的个人投资者、私募研究员、小型量化团队;想掌控自己的数据,或想把自己的数据源和方法论接进来的人。


☁️ 一键部署到云平台

不想自己管服务器的,可以直接使用 deploy/ 下已全面升级为 v3.0.0 AtomCode 内核的云平台模板(均已通过 python3 deploy/tools/validate-templates.py 57 项静态校验与等价 Compose 验证):

平台 适合谁 说明
Zeabur 国内外都能用,能力最全 模板自动生成密钥、绑域名、挂卷,内置 daemon 与智能炒股 fin 全栈
Sealos 国内用户 K8s 模板,postgres / redis 走 KubeBlocks,daemon 使用 StatefulSet 持久化
Railway 海外用户 服务搭建清单,双栈 IPv6 兼容,daemon + fin 全套变量引用
1Panel 自有服务器 + 国产面板 3.0.0 应用包,表单里填端口和口令即可
Coolify / Dokploy 自有服务器 + 自托管 PaaS 两份可以整段粘贴的 v3.0.0 compose

公网部署必看:这些平台上的实例一创建就在公网上。模板都默认关掉了单用户免登录(HUNTER_SINGLE_USER=0)并生成了一道初始化口令 HUNTER_SETUP_TOKEN,向导第 0 步要填它。


🖥 桌面启动器(推荐给不熟悉命令行的用户)

下载 → 填一把 key → 等几分钟,整套 HunterCode v3.0.0(AtomCode 内核)自动装好,全程不用敲一条命令。

桌面启动器 HunterLauncher v0.2.0 已全面适配 AtomCode v3.0.0,支持全新安装与老用户从 OpenCode v1.x/v2.x 一键无感换核升级(自动 pg_dump 备份、自动通过 --remove-orphans 卸载旧 opencode 容器并拉起 daemon 容器,原有自选股与持仓数据 100% 保留)。 启动器仓库:agentpit-io/HunterLauncher · 图文说明:www.agentpit.io/hunter-community

平台 直接下载(国内可达) 其他来源
macOS 12+ · Intel / Apple 芯片通用 hunter-launcher-latest-universal.dmg GitHub Releases
Windows 10 / 11 · x64 · 推荐 hunter-launcher-latest-x64-setup.exe GitHub Releases
Windows · 组策略分发 hunter-launcher-latest-x64.msi GitHub Releases
Linux x64 hunter-launcher-latest-amd64.deb / .AppImage GitHub Releases

🚀 5 分钟跑起来

准备:Docker Desktop(Windows / macOS)或 Docker Engine + Compose v2(Linux) · 磁盘 10 GB · 内存 4 GB · 能访问 ghcr.io(国内可使用 deploy/install.sh 或配置腾讯云镜像源)

六个核心服务(postgres、redis、api、web、daemon、llm-shim)以及智能炒股扩展服务(paper、fin-worker)的镜像均同时提供 linux/amd64 与 linux/arm64。

方式 A:预构建镜像开箱即用(推荐)

git clone https://github.com/agentpit-io/hunter-community
cd hunter-community
docker compose up -d
open http://localhost:3100          # 浏览器里完成首启向导,不用改任何文件

如果要同时开启**智能炒股(模拟盘 + 经验库自进化)**全栈:

bash scripts/fin_provision_paper_role.sh
docker compose --profile fin up -d

方式 B:服务器一键安装 / 升级 / 回滚脚本(支持源码构建与自检)

curl -fsSLO https://raw.githubusercontent.com/agentpit-io/huntercode-atomcode/main/deploy/install.sh
bash install.sh

支持无人值守安装、一键升级(bash deploy/install.sh --upgrade)与 60 秒一键回滚(bash deploy/install.sh --rollback)。

从 v2.x / v1.x(OpenCode 版)升级到 v3.0.0(AtomCode 统一版)

git pull
# 若 .env 中写死了旧版 HUNTER_VERSION / FIN_TAG,请改为 3.0.0
docker compose --profile fin pull
docker compose --profile fin up -d --remove-orphans

Tip

--remove-orphans 会自动停止并清理旧版 opencode 容器,并拉起全新的 AtomCode daemon 容器。api 启动时会自动补齐 0001~0056 全部增量数据库迁移,您原有的用户账号、自选股、组合持仓与智能炒股账本数据 100% 原样保留!


🏗 架构(AtomCode v3.0.0 统一架构)

┌───────────────────────────────────────────────────────────────────────────┐
│  浏览器  http://localhost:3100  (或服务器 :3200)                           │
└──────────────────────────────┬────────────────────────────────────────────┘
                               │
┌──────────────────────────────▼────────────────────────────────────────────┐
│  apps/web · Next.js 15 终端                                               │
│    · 对话流式终端(富卡片 / PDF·Excel 上传与原文页码抽屉)                   │
│    · 策略中心(选股器 / 小鹿规则编辑 / 过拟合评分 / 实验台)                 │
│    · 智能炒股 7 大页面(总览 / 持仓 / 委托 / 报告 / 成长自进化 / 规则 / 帮助)│
│    · app/api/opencode/[...path]/route.ts → AGENT_BACKEND=atomcode         │
└──────────┬───────────────────────────────────────┬────────────────────────┘
           │                                       │ Bearer daemon-token
┌──────────▼───────────────────┐   ┌───────────────▼────────────────────────┐
│ apps/api · FastAPI            │   │ daemon · AtomCode 5.1.0 Fork 底座      │
│  · 认证 / 自选 / 组合 / 行情   │   │   GET/POST /live/*   SSE 对话与热切换  │
│  · 0001~0056 自动数据库迁移    │   │   hookd 常驻进程 (guard/context/lang/  │
│  · PDF 三级解析 / 交割单诊断   │   │                  audit/budget)        │
│  · 全链路大模型日志记录与导出  │   │   12 个 stdio MCP + 16KB 三档大小闸    │
└──────┬───────────────▲───────┘   └───────────────┬────────────────────────┘
       │               │                           │
       ▼               │                           ▼
┌──────────────┐   ┌───┴───────────────────┐   ┌────────────────────────────┐
│ paper (账本) │   │ fin-worker + temporal │   │ llm-shim (:3999)           │
│ fin_paper_rw │◄──┤ 六时点调度 · 盘后复盘 │   │  · ToolCallIndexer 索引修复│
│ 只追加无删改 │   │ 经验库 · 影子验证生效 │   │  · Schema 清洗 · /trace 队列│
└──────────────┘   └───────────────────────┘   └───────────┬────────────────┘
                                                           ▼
                                               Google Gemini 4 Argon / 自带网关

🔑 数据供给与大模型配置

  1. 默认旗舰模型(Gemini 4 Argon):
    • 推荐使用 HunterCode 内置免费额度:免费申请一把 hunt_tools_ 平台 key,在首启向导第 2 步选择第一张卡片,或点击对话页顶部横幅「⚡ 一键开启内置免费大模型」,即可直接使用 gemini-4-argon(每日 1000 万 Token 额度,同时解锁平台数据供给)。
    • 也支持自带任意 OpenAI 兼容 Key(DeepSeek、Claude、Qwen、OpenRouter、OneAPI、本地 Ollama 等),向导内当场实测连通性、对话与工具调用,热生效无需重启容器。
  2. 全链路日志与排障:
    • 在「设置 → 大模型」页面底部,可随时查看最近的大模型调用追踪记录(阶段、模型、耗时、状态码),点击「⚡ 实测一次大模型并记录日志」或「📥 下载诊断日志文件」即可获取脱敏 .log 文件。

📚 核心文档索引

文档 内容
CHANGELOG.md v3.0.0 及历次版本完整更新日志
doc/产品说明书.md 产品全功能说明书
docs/部署与运维.md 硬件要求、安装、备份、升级回滚、安全与排障手册
docs/开发者指南.md AtomCode 四个外部面、如何新增 SKILL / MCP / Hook
docs/hooks-design.md 五组领域 Hook 的设计原理与契约说明
docs/fork-patches.md AtomCode 5.1.0 Fork 二进制补丁说明(系统提示词替换与工具裁剪)
docs/个人本地部署.md 个人本地部署记忆系统与受控自进化指南

🤝 参与贡献与致谢

Ziggy xuan
Ziggy xuan

💻
Yui(ゆい)
Yui(ゆい)

💻 ⚠️ 🚇 📖
Ricey
Ricey

🚧
fatihcvs
fatihcvs

💻
Amir Fathi
Amir Fathi

💻
hangeaiagent
hangeaiagent

💻
Jay
Jay

💻
Nabeel Hassan
Nabeel Hassan

💻

📄 许可证与商标

代码遵循 Apache License 2.0,AtomCode 遵循 MIT,详见 NOTICE。
HunterCode · Hunter · AgentPit · 猎鹿人 是 AgentPit 团队的商标。自用 fork、内部部署无需改名;对外分发、提供托管服务或商业发布请去掉上述名称与 Logo,可注明「based on HunterCode Community Edition」。

About

HunterCode 投研终端 · AtomCode 发行版(主仓在 GitCode)

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages