{ "markdown": "
\n\n**🌏 中文(当前)· [English](./README_EN.md)**\n\n
\n\n
\n\n\"Hunter\n\n# Hunter Community Edition\n\n### 别人的策略 · 你自己的 SKILL\n### 一个平台 · 一亿套系统\n\n*Your investment brain, on your terms*\n\n**对话 · 持仓 · 投资记忆体都在你磁盘 · 数据供给三选一(免费源 / 自接工具 / 平台管道)· 5 分钟跑起来**\n*Chat / positions / thesis on your disk · pick your data supply — free sources, bring-your-own tools, or Hunter data pipeline*\n\n[![License](https://img.shields.io/badge/license-Apache_2.0-blue)](./LICENSE)\n[![CI](https://github.com/agentpit-io/hunter-community/actions/workflows/ci.yml/badge.svg)](https://github.com/agentpit-io/hunter-community/actions/workflows/ci.yml)\n[![Docker](https://img.shields.io/badge/ghcr.io-agentpit--io-blue)](https://github.com/agentpit-io/hunter-community/pkgs/container/hunter-community-api)\n[![GitHub Stars](https://img.shields.io/github/stars/agentpit-io/hunter-community?style=social)](https://github.com/agentpit-io/hunter-community)\n\n[**🚀 Live Demo**](https://hunter-community.agentpit.io) · [**📖 Docs**](./docs/01-getting-started.md) · [**🐦 Twitter**](https://x.com/agentpit_io) · [**⭐ Star us**](https://github.com/agentpit-io/hunter-community)\n\n
\n\n\n\nhttps://github.com/user-attachments/assets/37f4a065-663b-4eee-8d3f-c9c0573270e3\n\n*SaaS 完整演示 · 3 分 34 秒 · 深度分析 + 走势预测 + SKILL 使用 · 点视频左下角播放*\n\n
\n\n**⚠️ 免责声明**:本项目是投研分析工具 · 所有输出为 AI 生成内容 · 仅供研究参考 · 不构成任何投资建议 · 投资有风险 · 决策需谨慎\n\n
\n\n---\n\n## 📖 目录\n\n- [这是什么](#-这是什么)\n- [为什么选 Hunter](#-为什么选-hunter)\n- [核心能力](#-核心能力)\n- [5 分钟跑起来](#-5-分钟跑起来)\n- [数据供给三选一(唯一需要理解的概念)](#-数据供给三选一唯一需要理解的概念)\n- [杀手级功能:投资记忆体](#-杀手级功能投资记忆体investment-thesis)\n- [大模型兼容性](#-大模型兼容性)\n- [23 个内置 SKILL](#-23-个内置-skill)\n- [技术栈](#-技术栈)\n- [架构](#-架构)\n- [Provider 矩阵](#-provider-矩阵)\n- [扩展 Hunter](#-扩展-hunter)\n- [Community vs Cloud](#-community-vs-cloud)\n- [常见问题](#-常见问题)\n- [Contributing](#-contributing)\n- [社区与支持](#-社区与支持)\n- [Roadmap](#-roadmap)\n\n---\n\n## 🎯 这是什么\n\n**Hunter 是给个人投资者用的金融 AI Agent 平台**。给它 1 把 key + 1 个大模型 · 你就有一个能查行情、拉新闻、跑深度分析、预测走势、盯自选、按 SKILL 方法论工作的 AI 团队 —— **全部在你自己的机器上运行**。\n\n- 🎯 **数据供给三选一** · 免费源(akshare/yfinance)开箱即用 · 或平台管道(`hunt_tools_xxx` 免费申请)解锁 **32/33 数据源** + **23 个精修 SKILL** + Kronos 走势预测 + TrueSource 另类情报 · 或接你自己的 MCP\n- 🧠 **多模型可插拔** · **DeepSeek v4 pro 实测 P0 默认**(<$0.001/次 · 12-70 秒)· 通义/豆包/Claude/GPT env 模板齐全\n- 💾 **自部署** · docker compose 一键起 · 数据在你磁盘 · 不上云 · 不联系我们除非你想\n- 🔌 **易扩展** · Markdown 写 SKILL 方法论 · GitHub 一键装 SKILL · 接自己的 MCP · 三种扩展全支持\n- 💰 **免费开源** · Apache 2.0 · fork 随便用(仅须换名)\n\nLive preview: **[https://hunter-community.agentpit.io](https://hunter-community.agentpit.io)**\n(演示站开了多用户 · 首次访问会引导你注册 · 自己 clone 下来跑不需要账号)\n\n---\n\n## 🌟 为什么选 Hunter\n\n| 别人家 | Hunter |\n|---|---|\n| **OpenBB · FinGPT** — 需要自己拼 provider 与 tool · 上手 2-3 天 | 开箱即用 · 5 分钟跑起来 · SKILL 就是方法论 · 加一个就多一种分析 |\n| **TradingView** — 强图表 · 但只订阅 · 不能自部署 · 数据不出户 | 数据在你磁盘 · 想接自己的 broker / 数据源 / MCP 完全放开 |\n| **Cursor / Cline 通用 agent** — 通用但金融要自己教 | 23 个金融专精 SKILL · 卖方研究员级方法论 · 覆盖尽调/估值/组合 |\n| **通用 ChatGPT** — 能答但拿不到实时数据 · 不会调工具 | 一 key 通吃行情/新闻/K 线/龙虎榜/北向 · Function calling 精准分流 |\n\n---\n\n## ✨ 核心能力\n\n\n\n\n\n\n\n\n
\n\n**💹 数据(32/33 源)**\n- 实时行情 · A/港/美股\n- 30 天 K 线 · 财报 · 新闻\n- 龙虎榜 · 十大股东 · 治理\n- 北向资金 · 南向资金 · AH 溢价\n- 巨潮公告 · 行业分类\n\n\n\n**🧠 AI 能力**\n- 23 个精修 SKILL(下方展开)\n- Kronos 走势预测(清华时序模型)\n- TrueSource 主动情报采集\n- DeepSeek/qwen/Claude/GPT 可插拔\n- MCP 工具循环 · 自动分流\n\n\n\n**💬 交互**\n- SSE 流式对话 · 边想边输出\n- 富卡片渲染(报价/新闻/预测)\n- **侧栏三层**(数据源/工具箱/SKILL · 见 [截图](./docs/screenshots/02-sidebar-toolbox.png))\n- 自选 · 持仓 · 信号追踪\n- 顶部深度工具菜单(在线分析/K 线预测/信号看板/事件分析 · 见 [截图](./docs/screenshots/06-top-menu-depth-tools.png))\n\n\n\n**🚀 部署**\n- docker compose 一键起\n- 5 分钟(镜像已 pull 后)\n- 6 服务 healthy 自动 orchestrate\n- bind mount 快速迭代\n- 一 key 通用 · 无外部依赖\n\n
\n\n---\n\n## 🚀 5 分钟跑起来\n\n### 前置\n\n- Docker Desktop(Windows/macOS)或 Docker Engine + Compose v2(Linux)\n- 磁盘 20 GB(opencode 镜像 ~7.5 GB)· 内存 4 GB\n- 能访问 `ghcr.io`(对话引擎从这里拉)\n- 大模型 key(DeepSeek 免费送 500 万 tokens · [30 秒申请](https://platform.deepseek.com/api_keys))\n\n### 3 步启动\n\n```bash\n# 1. 拉代码\ngit clone https://github.com/agentpit-io/hunter-community\ncd hunter-community\ncp .env.example .env\n\n# 2. 改 .env 三处(自动生成 JWT_SECRET · 手填 LLM_API_KEY · 可选填 HUNTER_API_KEY)\n# - Linux/macOS\necho \"JWT_SECRET=$(openssl rand -base64 48)\" >> .env\n# - Windows PowerShell 版见 docs/01-getting-started.md\n\n# 手改 .env 三处:\n# LLM_BASE_URL=https://api.deepseek.com/v1\n# LLM_DEFAULT_MODEL=deepseek-v4-pro\n# LLM_API_KEY=sk-xxxxx\n# LLM_SCHEMA_SANITIZE=1 # DeepSeek 必开\n# HUNTER_API_KEY=hunt_tools_xxxxx # 免费 · 30 秒申请 hunter.agentpit.io/dev/api-keys\n\n# 3. 起服务(首次 10 分钟拉镜像 · 之后 30 秒)\ndocker compose up -d\nopen http://localhost:3100\n```\n\n**首次测试**(打开浏览器后):\n- 问\"601899 现在多少钱\" — 会看到富卡片(实时价 · 52 周分位 · AI 短评)\n- 问\"预测茅台走势\" — Kronos GPU 推理 · 30-70 秒出未来 10 天 K 线预测\n- 点侧栏「深度分析」输入代码 — 60-300 秒出 22 维度深度报告\n\n**详细指南**:[`docs/01-getting-started.md`](./docs/01-getting-started.md)\n\n---\n\n## 🔑 数据供给三选一(唯一需要理解的概念)\n\n除了一把大模型 key(必需 · 你自己申请驱动对话本身)· 数据供给你有 **三种玩法** —— **不再强制我们的平台 key**:\n\n| 玩法 | 谁的 key | 数据来源 | 适合谁 | 冷启动体验 |\n|---|---|---|---|---|\n| **① 免费开源源** | 不需要任何我们的 key | akshare(A股)· yfinance(美/港股)· 内置离线样例 | 想 5 分钟跑通 · 先看看效果 | 开箱即用 · 覆盖不全时会明确降级提示 |\n| **② 自接工具 / MCP** | 你自己的数据源 key / MCP server | 你自己的 broker · 数据商 · 自建 MCP · Cline/Cursor 生态任意 MCP | 已有数据订阅 · 想接进 Hunter 用 | 侧栏「工具箱 ＋」按钮接自己的 MCP |\n| **③ 平台数据管道** `hunt_tools_xxx` | 我们签发 · [免费申请 30 秒](https://hunter.agentpit.io/dev/api-keys) | 32 数据源 · 另类数据(招投标/招聘/海关/专利)· Kronos GPU 走势预测 · TrueSource 情报 | 免费源不够用 · 想要独家另类信号与深度分析基座 | 一 key 通 4 网关(tools/data/kronos/truesource) |\n\n**推荐使用路径**:第一天用 ① 免费源跑通全流程 → 用得深了发现覆盖不够、经常断流、缺另类信号 → 升级到 ③ 平台管道(最省心)或接 ② 自己的数据源。\n\n**大模型 key(必需)**:DeepSeek 免费送 500 万 tokens · [30 秒申请](https://platform.deepseek.com/api_keys)· 也支持 OpenAI / OpenRouter / OneAPI / AIHubMix 等任何 OpenAI-compatible 端点。\n\n### 为什么值得 fork 自部署\n\n- ✅ **对话 · 持仓 · 投资记忆体全部在你磁盘** —— 深度分析推理也在你的容器里跑 · 不再依赖我方服务器 · **本地优先从口号变成事实**\n- ✅ **Apache 2.0** —— fork 随便用(仅须换品牌名)· 商业闭源可以 · 二次分发可以\n- ✅ **左侧工具全部照常显示** —— 不打折不隐藏 · 点下去会明确告诉你怎么解锁 · 而不是静默失败\n- ✅ **平台管道用量按 key 记账** —— 我们不看你的数据、不看你的对话 · 只看请求计数\n\n---\n\n## 🧠 杀手级功能:投资记忆体(Investment Thesis)\n\n**投资记忆体是 Hunter 区别于其他财经 AI 工具的核心能力** —— 它记录你「当初为什么买」:买入时的核心论点、5 大关键假设、持仓成本。之后系统用最新数据持续检验这些假设是否仍然成立:\n\n- 📉 **业绩证伪监控** —— 财报出来后自动比对当初的营收/利润假设 · 偏离基线立即量化标记\n- 🔄 **订单流转监控** —— 关键客户/供应商/渠道的实时舆情检验\n- 🏛 **逻辑支柱松动预警** —— 5 大支柱任意一支塌了立即提醒你 · 而不是等你半年后翻账户才发现\n- 📊 **假设漂移追踪** —— 定量记录关键指标偏离基线的幅度与速度\n\n**一次分析 · 持续陪伴** —— 把一次性的深度报告变成持续的持仓管理助手 · 这是\"看一次报告然后忘掉\"和\"研究框架长期跟踪\"的分水岭。\n\n**实现方式**:通过 `uzi_thesis` SKILL(详见下方「投资策略」分类) · 记忆数据以本地 Postgres 存储 · 完全在你磁盘上 · 不出你的机器 · 我们看不到、也不需要看到。\n\n**未来路线**:v1.0 将推出「记忆体云同步」(可选付费) · 跨设备同步与云端备份;**本地单机版永久免费**。\n\n> ⚠️ 记忆体产出的所有假设检验、支柱评分、漂移提示都是 AI 生成的研究参考 · 不构成投资建议 · 是否调整持仓由你自己决策。\n\n---\n\n## 🤖 大模型兼容性\n\n**遵循\"测法是假测试 · 测工具调用才是真测试\"方法论** · 我们用 7 个 golden case 实测每家模型的 tool_call 可靠性。\n\n### 直连(单 provider)\n\n| 模型 | 接入 | tool_call hit | 平均延迟 | 单次成本 | 推荐等级 | 已知踩坑 |\n|---|---|---|---|---|---|---|\n| **DeepSeek v4 pro** | `api.deepseek.com` | **6/7** | 30s | ~$0.0001-0.0008 | ⭐⭐⭐⭐⭐ **P0 直连默认** | 必开 `LLM_SCHEMA_SANITIZE=1` |\n\n### 走 AIHubMix 网关(一把 key 打通 30+ 家 · 2026-08-16 实测)\n\n| 排名 | 模型 | hit | 平均延迟 | 稳定性 | 推荐等级 |\n|---|---|---|---|---|---|\n| 🥇 | **Claude Sonnet 5** | **7/7** | 25.7s | ✅ 无 timeout · 无 think 泄漏 · B2 主动编排 4 tool | ⭐⭐⭐⭐⭐ **海外首推** |\n| 🥈 | **Qwen 3.8 Max** | **7/7** | 48.1s | ✅ 无 timeout · 无 think 泄漏 | ⭐⭐⭐⭐⭐ **国内首推** |\n| 🥉 | **Gemini 3.5 Flash** | 6/7 | 62.3s | ⚠ C1 边界过度调用超时 · 无 think 泄漏 | ⭐⭐⭐⭐ 便宜快 |\n| 4 | **Doubao Seed 2.1 Pro** | 6/7 | 103.9s | ⚠ 深度分析慢 3-5× | ⭐⭐⭐ 建议直连火山引擎 |\n| 5 | **GPT-5.6 sol**(tool 描述已修) | 5/7 | 24.4s | ⚠ A3/B1 hit 未提升 · 但**不再报错**(改走 quickview 作为兜底 · 用户拿到可用数据)| ⭐⭐⭐ 快 · hit 上限受 OpenAI 系 tool 匹配算法制约 |\n| 6 | **MiniMax M3**(修复后) | 6/7 | 77.3s | ✅ **0/7 泄漏**(修复前 7/7 · shim 已内置双保险)| ⭐⭐⭐⭐ 已可用 |\n\n**AIHubMix 使用注意**:Alpine 容器直连 aihubmix 会被 CDN 按 TLS 指纹拦截(SSL EOF)· 需要 host proxy 中转 · 详见 [`docs/env-samples/.env.aihubmix.example`](./docs/env-samples/.env.aihubmix.example) 和 [`docs/model-testing/scripts/aihubmix-host-proxy.py`](./docs/model-testing/scripts/aihubmix-host-proxy.py)。\n\n**Thinking 类模型 `` 泄漏兜底**:MiniMax / Qwen thinking / Kimi thinking 系列会把内部推理夹在 assistant.content 里 · `scripts/llm-shim/shim.py` 已内置双保险(请求端注入 `thinking:false` + 响应端 SSE 状态机剥离 `...`)· 用 `LLM_STRIP_THINK=0` 可紧急关闭。**11 个跨 chunk 边界的单元测试全过**,复测 MiniMax M3 think 泄漏 7/7 → 0/7。\n\n**env 模板 6 份齐备**(每份含 URL / model 名 / SANITIZE 设置 / 已知踩坑注释):[`docs/env-samples/`](./docs/env-samples/)\n- `.env.aihubmix.example` — 网关(GPT/Claude/Gemini/Qwen/Doubao/MiniMax/DeepSeek/GLM 一把 key)\n- `.env.deepseek.example` — 直连 DeepSeek(P0 直连基线)\n- `.env.claude.example` / `.env.openai.example` / `.env.qwen.example` / `.env.doubao.example` — 直连各家\n\n**详细评测方法与数据**:[`docs/model-testing/`](./docs/model-testing/)\n- [`model-compat-matrix.md`](./docs/model-testing/model-compat-matrix.md) — 全适配矩阵\n- [`results/2026-08-16_aihubmix_六家对比.md`](./docs/model-testing/results/2026-08-16_aihubmix_六家对比.md) — 6 家最新旗舰完整对比\n- [`results/2026-08-15_deepseek_v4pro_对比分析.md`](./docs/model-testing/results/2026-08-15_deepseek_v4pro_对比分析.md) — DeepSeek v4 pro 直连基线\n- [`scripts/run-golden-cases.py`](./docs/model-testing/scripts/run-golden-cases.py) — 评测 runner(可复现)\n\n---\n\n## 📚 23 个内置 SKILL\n\nSKILL 是**分析逻辑** —— 一段讲清\"这类问题该怎么分析\"的方法论。**23 个 SKILL 全部精修方法论完毕**(v0.2.3 · 2026-08-15) · **不再有\"薄壳假装有方法论\"** —— 每个 SKILL 都能给出机构级输出。\n\n### 综合分析(3)\n\n| SKILL | 一句话说明 |\n|---|---|\n| `stock_deep_analysis` | 22 维度融合 · 8 数据源 · 约 7s 出 LITE 报告 |\n| `debate` | 6 位分析师 · 2 轮辩论 · 60-90s 出深度报告 |\n| `uzi_quick_scan` | 30 秒给出综合评分与要点摘要 · 附 66 位专家评委观点分布(仅供研究参考 · 不构成投资建议)|\n\n### 估值建模(5 · UZI 系列)\n\n| SKILL | 一句话说明 |\n|---|---|\n| `uzi_dcf` | DCF 现金流折现 · WACC + 敏感性表 · 支持基于新财报的增量更新 |\n| `uzi_comps` | 同行对标 · PE/PB/PS/EV-EBITDA 多倍数横向 · 给合理估值区间 |\n| `uzi_lbo` | 杠杆收购情景 · 模拟 PE 买方 · 输出 5 年 IRR 与 MoM |\n| `uzi_segmental_model` | 分部建模 · 按业务线预测收入 · 分部对整体估值贡献 |\n| `uzi_earnings` | 解读最新财报 · beat/miss 检测 · EPS 驱动拆解 · 指引质量评分 |\n\n### 投研报告(3 · UZI 系列)\n\n| SKILL | 一句话说明 |\n|---|---|\n| `uzi_initiate` | 机构首次覆盖报告 · JPM/GS 卖方格式 · 投资亮点 + 估值 + 评级 |\n| `uzi_ic_memo` | 投委会备忘录 · base/bull/bear 三情景回报分布 |\n| `uzi_dd` | 完整尽调清单 · 财务/法律/运营/管理层/行业 5 大流 21 项 |\n\n### 投资策略(4 · UZI 系列)\n\n| SKILL | 一句话说明 |\n|---|---|\n| `uzi_thesis` | 建 5 支柱投资论点 · 持续追踪支柱状态与假设漂移 |\n| `uzi_catalysts` | 未来 60 天关键事件日历 · 财报/指引/解禁 · 附股价影响判断 |\n| `uzi_screen` | 5 套量化筛选(价值/成长/质量/动量/低波)· 排名与选中原因 |\n| `uzi_scan_trap` | 杀猪盘排查 · 异常拉升 + 减持时点 + 造假信号 + 推票热度 |\n\n### 组合管理(3)\n\n| SKILL | 一句话说明 |\n|---|---|\n| `portfolio_stress` | 压力测试 · 含板块联动 + 减半建议 · 前置需录 shares+cost |\n| `uzi_rebalance` | 逐持仓再平衡建议 · 权重漂移 + 交易清单 + 换手成本 |\n| `uzi_returns` | 收益归因 · 按持仓/行业/风格因子拆解 · Top 贡献与拖累 |\n\n### 基础工具(5)\n\n| SKILL | 一句话说明 |\n|---|---|\n| `quote` | 查一只或多只股票的最新价与近期波动 · 支持横向对比 |\n| `stock_news` | 5 条精选新闻 · 每条 AI 影响短评(利好/利空/中性/强利好) |\n| `forecast` | 清华 Kronos 金融时序大模型 · 预测未来 N 日开高低收 |\n| `risk_profile` | 读/改风险偏好 + 现金 + 单票/HK 上限 · 供组合建议自动应用 |\n| `watchlist_daily` | 自选涨跌排序 + Top 3 AI 归因 · 前置需先加自选 |\n\n\"SKILL\n\n*23 SKILL 侧栏视图 · 综合分析 / 投研报告 / 估值建模 / 组合管理 分类分组 · 点击即用*\n\n**想加自己的?**看 [扩展 Hunter](#-扩展-hunter) 章节。\n\n---\n\n## 🛠 技术栈\n\n| 层 | 技术 |\n|---|---|\n| **前端** | Next.js 15 (App Router) · React 19 · TypeScript 5 · Tailwind CSS 3 · shadcn/ui |\n| **后端** | FastAPI · Python 3.12 · SQLAlchemy 2 · httpx · loguru |\n| **对话引擎** | [OpenCode](https://opencode.ai) 定制版 · MCP protocol · Bun runtime |\n| **数据库** | Postgres 16 · Redis 7 |\n| **AI** | OpenAI-compatible (DeepSeek / qwen / doubao / OneAPI) · Anthropic · Kronos GPU |\n| **认证** | JWT (HS256) · argon2id · 单用户 / 多租户可切 |\n| **部署** | Docker Compose · GHCR 私有镜像 · bind mount 快速迭代 |\n| **测试** | 12 golden case runner (v3) · SSE 订阅 · 4 维度矩阵 |\n\n---\n\n## 🏗 架构\n\n```\n ┌─────────────────────┐\n浏览器 → │ web (Next.js 15) │ :3100\n └────────┬────────────┘\n │ /api/* (web 自带 BFF 转发 · 无需反向代理)\n ┌────────▼────────────┐ ┌──────────────────┐\n │ api (FastAPI) │ │ opencode 引擎 │\n │ · auth (JWT) │◄───────┤ MCP tools 回调 │\n │ · providers layer │ │ 5 plugins: │\n │ · 23 SKILLs │ │ auth/guard/ │\n │ · agents │───► hunter 网关(4 通道 · 一 key 全开)\n └─┬─────────────┬─────┘ │ budget/audit/ │\n │ mcp-context │\n └────────┬─────────┘\n │ tool schema 清洗\n ┌──────────▼─────────┐\n │ llm-shim :3999 │──► 你的大模型网关\n └────────────────────┘\n Postgres Redis\n :5442 :6479\n```\n\n**关键组件**:\n- **web BFF** — Next.js 反代 opencode · 转发 JWT 供 hunter-auth 读\n- **hunter-mcp-context** plugin — tools=13 · 自动注入 `_hermes_user_id`\n- **hunter-guard** — MCP schema sanitize(DeepSeek `parameters:null` 兜底)\n- **hunter-auth** — JWT 门禁 · sessionUsers 关联 user_id\n- **hunter-budget** — 用量记账 · 支持限额\n- **hunter-audit** — AUDIT.jsonl 完整审计流\n\n---\n\n## 📊 Provider 矩阵\n\n数据源默认走 Hunter 网关(`hunter`)。没配 key 时它会明确回一句\"去申请 key\" · 而不是假装数据源出问题。\n\n想完全不用 key 也能取 A 股行情 · 把 `DATA_SOURCE_PROVIDER` 设成 `akshare`(美股港股用 `yfinance`)。两者都免费 · 但覆盖面和数据质量不如平台管道 · 且 akshare 在容器里经常连不上境内数据源。\n\n| 层 | 环境变量 | 可选值 | 默认 |\n|---|---|---|---|\n| 数据源 | `DATA_SOURCE_PROVIDER` | `hunter` · `akshare` · `yfinance` · `saas` | `hunter` |\n| 大模型 | `LLM_PROVIDER` | `openai_compat` · `anthropic` · `saas_gemini` | `openai_compat` |\n| 预测 | `FORECAST_PROVIDER` | `noop` · `kronos_local` · `kronos_saas` | `kronos_saas` |\n\n细节与返回结构见 [`docs/02-providers.md`](./docs/02-providers.md)。\n\n---\n\n## 🔌 扩展 Hunter\n\n三种扩展方式 · 一种比一种深入:\n\n### 1. 加自己的 SKILL(Markdown · 最简单)\n\nSKILL 就是**方法论** —— 一段讲清\"这类问题该怎么分析\"的 Markdown。用的是 **Anthropic Agent Skills 标准格式** · **网上下载的 skill 不用改一个字**。\n\n```\nuser-skills/\n 你的skill名/\n SKILL.md\n```\n\n```markdown\n---\nname: 你的skill名\ndescription: 一句话说明什么时候该用它 —— 模型据此判断要不要调用\n---\n\n# 正文写方法论\n分几步、先看什么后看什么、注意什么。\n```\n\n放好后 `docker compose restart opencode` 即可。**同名时你的覆盖我们的**。\n\n### 2. 从 GitHub 一键装 SKILL(v0.2.3 新)\n\n侧栏 SKILL 那一行点「＋」→ 粘 GitHub URL(如 `github.com/anthropics/skills/xxx`) → 装之前先看内容 → 一键装。**先探测后下载 · 装完自动生效**。\n\n\"GitHub\n\n### 3. 接自己的 MCP(工具箱那行的「＋」)\n\n用户自接的 MCP server 会自动并进工具箱视图 · description 直接给模型用 —— 名字 / MCP 类型(HTTP/SSE/stdio) / URL / API key 一次填完。\n\n\"接一个自己的\n\n---\n\n## ☁️ Community vs Cloud\n\n| 能力 | Community(自部署) | Cloud([hunter.agentpit.io](https://hunter.agentpit.io)) |\n|---|---|---|\n| 对话(自带大模型 key) | ✅ | ✅ |\n| 免费数据源(akshare/yfinance) | ✅ 开箱即用 · 无需任何我方 key | ✅ |\n| 接入你自己的 MCP / 数据源 | ✅ 无需任何我方 key | ✅ |\n| 内置 23 SKILL(方法论) | ✅ 全部随代码分发 · 无需任何 key | ✅ |\n| UZI 深度分析(22 维) | ✅ 数据源三选一(免费源/自接/平台管道)| ✅ |\n| Kronos 走势预测 | ✅ 平台管道(免费) · 或自建 GPU · [直连](./docs/kronos-direct-access.md)(oapk_ key)| ✅ |\n| TrueSource 另类情报 | ✅ 平台管道(免费) · 或自采 | ✅ |\n| 投资记忆体(本地存储) | ✅ 永久免费 · 本地 Postgres | ✅ |\n| GitHub 一键装 SKILL | ✅ (v0.2.3) | ✅ |\n| 记忆体云同步(v1.0 规划)| ⏳ 规划中(本地版永久免费) | 🔜 计划推出(可选付费) |\n| 微信推送 | ❌ | ✅ |\n| 飞书通知 | ❌ | ✅ |\n| 多租户计费 | ❌ | ✅ |\n\n---\n\n## ❓ 常见问题\n\n
\nopencode 一直 Restarting?\n\n大概率是 LLM_* 三件套少填。`docker compose logs opencode --tail 20` 看日志 · 会明说少哪个。\n\n- `LLM_BASE_URL` — 大模型 API 基地址\n- `LLM_DEFAULT_MODEL` — 模型名\n- `LLM_API_KEY` — key\n- DeepSeek 额外必开 `LLM_SCHEMA_SANITIZE=1`\n
\n\n
\nDeepSeek 首条对话 400 \"Invalid schema type: null\"?\n\nDeepSeek 严格模式拒 `parameters: null`。`.env` 加:\n```\nLLM_SCHEMA_SANITIZE=1\n```\n`docker compose up -d`(必须 up · restart 不重读 env)。\n
\n\n
\n深度分析报告全空 / Sentinel 保留 0 条?\n\n`HUNTER_API_KEY` 没填或无效 · Sentinel 拿不到 finance-data 数据。去 [hunter.agentpit.io/dev/api-keys](https://hunter.agentpit.io/dev/api-keys) 免费申请 30 秒。\n
\n\n
\n改了 skills/ 后不生效?\n\nopencode **只在启动时扫一次** skill 目录。改完必须:\n```bash\ndocker compose restart opencode # 约 50 秒\npython scripts/check_skill_sync.py # 比对磁盘 ↔ opencode · 不一致会列出\n```\n> 实测过 · `POST /instance/dispose` 无效 · 文件挂载可见也无效 · 只能重启。\n
\n\n
\n端口被占?\n\n编辑 `.env` 里的 `*_HOST_PORT`:\n```\nWEB_HOST_PORT=3101\nAPI_HOST_PORT=8101\nPOSTGRES_HOST_PORT=5443\n```\n同时改 `NEXT_PUBLIC_API_URL=http://localhost:8101`。\n
\n\n
\nWindows 装机 3 大静默 bug?\n\n已在 v0.1.1+ 修复 · 现在 Windows 装机也顺畅:\n- `.gitattributes` 加了 · 防 CRLF 破坏 entrypoint.sh\n- README 里的 PowerShell 命令已换成 UTF-8 安全版\n- docker-compose.yml 默认值不再盖过代码默认值\n\n若碰到还请开 issue。\n
\n\n
\n更多问题?\n\n详细排错见 [`docs/01-getting-started.md`](./docs/01-getting-started.md) 或来 [社区群](#-社区与支持) 问。\n
\n\n---\n\n## 🤝 Contributing\n\nPull requests welcome!codebase 还在从私仓迁移中 · v1.0 前会有 churn。\n\n### 最简单的第一次贡献:加一个 SKILL(5 分钟)\n\n比如你有自己的\"看 K 线突破\"方法 · 就写:\n```\nuser-skills/kline_breakout/SKILL.md\n```\n提 PR 到 `skills/` 目录 · 全球用户下次 pull 就能用。\n\n### Good first issues\n\n看 [GitHub Issues](https://github.com/agentpit-io/hunter-community/issues?q=is%3Aissue+label%3A%22good+first+issue%22) 挂 `good first issue` 标签的 · 都是 30 分钟内能搞定的入门任务。\n\n### 完整流程\n\n见 [CONTRIBUTING.md](./CONTRIBUTING.md)。\n\n---\n\n## 💬 社区与支持\n\n\n\n\n\n\n\n\n
\n\n**💬 微信**(拉群交流)\n`agentpit`\n\n\n\n**📱 微信公众号**\n`agentpit.io`\n\n\n\n**🐦 Twitter / X**\n[@agentpit_io](https://x.com/agentpit_io)\n\n\n\n**💡 GitHub Discussions**\n[提问 · 分享](https://github.com/agentpit-io/hunter-community/discussions)\n\n
\n\n**遇到 bug**: [开 issue](https://github.com/agentpit-io/hunter-community/issues/new)\n**安全漏洞**: `security@agentpit.io`(见 [SECURITY.md](./SECURITY.md))\n\n---\n\n## 🗺 Roadmap\n\n- [x] **v0.1** · Monorepo skeleton + docker-compose + fin-r1 deploy(P1)\n- [x] **v0.1** · SaaS strip(WeChat / Lark / SSO removed)(P2)\n- [x] **v0.1** · 本地 email + password auth(argon2 + JWT)(P3)\n- [x] **v0.1** · 可插拔 provider 层(data · LLM · forecast)+ per-user settings(P4)\n- [x] **v0.2** · opencode chat 引擎上线 · 5 plugins + 5 MCP · 一 key 通用(P5)\n- [x] **v0.2.3** · 23 SKILL 精修完毕 · GitHub 一键装 SKILL · 侧栏三层重构\n- [x] **v0.2.3** · MCP tool description 分流指引(kpred/deep_analysis/quickview)\n- [ ] **v0.3** · runner v4 支持 SSE 订阅 · 多 provider 全评测出 matrix\n- [ ] **v1.0** · SKILL catalog UI + community skill marketplace\n\n---\n\n## 📄 License\n\nApache 2.0 · see [LICENSE](./LICENSE) and [NOTICE](./NOTICE).\n\n**Hunter · AgentPit · 猎鹿人** are trademarks of the AgentPit team.\nForks must rename.\n\n---\n\n
\n\n**⭐ 觉得有用请点 Star · 是我们继续维护的动力**\n\nMade with ❤️ by [AgentPit](https://agentpit.io) team\n\n
\n", "bytes": 18810, "sha": "bce9b4611e5ba2c3fea8935b02db0b3f35bcfb47fb5a0d571f4fa153afb513bf", "repo_slug": "agentpit-io/hunter-community", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_hangeaiagent_akshare_mcp_27f5e93d/readme" }