1. 启动扫描
DeepAgents 模式启动时扫描 skills/ 下所有含 SKILL.md 的子目录，构建技能索引。
go-stock 项目研究站 · AI 智能体与技能生态
go-stock 的 AI 智能体：三种模式、技能系统与 MCP 扩展
本项目的 AI 助手不是一个「聊天框」：它内置四种对话模式（自动选择、快速、规划、DeepAgents）、150+ AI 数据工具（行情、资金流、龙虎榜、研报等），并支持技能（SKILL.md 渐进式提示词注入）、技能广场、MCP 外部工具扩展、知识库向量问答，以及会跨会话记住你的长期记忆与用户画像。
你的问题
模式选择
快速/规划/DeepAgents
快速/规划/DeepAgents
工具与技能调用
行情·资金·研报
行情·资金·研报
结论 + 可继续追问
依据项目官方 docs（AI 对话与视觉理解、技能管理、MCP 指南、8 月新功能介绍）整理的智能体工作流示意。
Modes
四种对话模式怎么选
模式在对话框底部切换，选择会被记忆，下次打开自动恢复。表内容来自官方《AI 对话与视觉理解功能说明》。
| 模式 | 工作机制 | 适用场景 | 官方推荐模型 |
|---|---|---|---|
| 🤖 自动选择 | 按问题复杂度自动挑模式 | 日常使用，不必纠结选哪种 | 跟随所选模型 |
| ⚡ 快速模式 | 单轮工具调用，响应最快 | 简单查询：股价、涨跌幅、单只股票资讯 | DeepSeek 最新版 |
| 🧠 规划模式 | 先制定计划再分步执行 | 多步骤分析：多股对比、按条件筛选 | GLM 最新版 |
| 🔬 DeepAgents | 内置任务规划、子 Agent 委派、文件系统与 Shell 集成 | 复杂深度研究：行业分析、全维度个股研报；也是技能系统生效的对话模式 | Claude / GLM 最新版 |
关键约束：技能（Skill）只在 DeepAgents 模式下生效——官方文档明确「技能管理仅在 DeepAgents 模式下生效，AI 按需发现并加载匹配技能，节省上下文 token」。用其它模式时，技能不会被激活。
Skills
go-stock 技能系统：渐进式提示词注入
技能不是插件，而是「按需加载的专业方法论」。官方文档给出的四步机制如下。
2. 按需发现
AI 先读技能的元数据（名称、描述、触发关键词），判断当前问题是否需要该技能。
3. 激活注入
决定使用后，才把完整提示词注入对话上下文，避免每次都占满 token。
4. 资源加载
技能可挂 scripts/、references/ 等资源，需要时再读取，也可绑定 MCP 服务器。
技能包最小结构
skills/<技能名>/SKILL.md（frontmatter 元数据 + 提示词正文）即可构成一个技能；需要脚本或参考资料时再增加 scripts/、references/ 子目录。管理界面支持导入 ZIP 技能包、在线编辑（CodeMirror 6 高亮）与删除。
| 技能广场能力 | 说明 |
|---|---|
| 浏览与检索 | 分类筛选、关键词搜索、排序、VIP 技能过滤 |
| 下载导入 | 一键把广场技能导入本地；导入时校验 SKILL.md、拦截路径穿越、限制解压量 |
| 分享上传 | 本地技能打包上传，可设名称、描述、分类、标签 |
| 账号与权限 | 轻量账号体系（注册/登录/设备绑定）与 VIP 权限；服务端裁定等级，隐藏技能仅作者可见 |
部署前提：官方文档说明技能广场需要配合 go-stock-server 服务端部署使用；只用本地技能时无需该服务端。
MCP
go-stock MCP 扩展：把外部工具接给 AI
MCP（Model Context Protocol）让 AI 调用外部工具服务器，例如把分析结论推到飞书或钉钉。整理自官方 docs/MCP_GUIDE.md。
| 项目 | 支持情况 | 注意点 |
|---|---|---|
| 传输协议 | StreamableHTTP（默认）、SSE | 旧服务器往往只支持 SSE，选错类型会连不上 |
| 鉴权方式 | 静态 Headers、OAuth 2.1（浏览器授权，动态注册 + PKCE） | OAuth 凭证加密存储，access token 过期自动用 refresh_token 续期 |
| Header 模板变量 | {{env.VAR}} 读环境变量、{{sessionId}}、{{uuid}} | 建议把 Token 放环境变量，避免明文入库 |
| 连接状态 | available / untested / unauthorized / unavailable | 「测试连接」会拉取 tools/list 并把工具 Schema 存本地库 |
| 工具缓存 | 按服务器 ID 缓存 + 配置指纹失效 + 10 分钟 TTL | 改完配置立刻生效，无需重启应用 |
| AI 自助管理 | 内置 List/Get/Create/Update/Delete MCPServer 工具 | 可让 AI 直接新增服务器，之后仍需点一次「测试连接」同步工具 |
不同模式下 MCP 工具的加载机制（为什么有时工具没被调用）
DeepAgents 模式：MCP 工具进入动态工具池，由 ToolSearch 按需检索，核心工具常驻；React / PlanExecute / auto 模式：按问题匹配注入——问题里出现启用的服务器名称（如 feishu-bot）、出现信号词（发送、通知、消息、webhook、机器人、飞书、钉钉等），或工具名/描述命中关键词时才注入。实用建议：提问时点名服务器名，或使用信号词。
RAG
go-stock 知识库：让回答建立在你自己的资料上
整理自官方《8 月新功能介绍》与《知识库与长期记忆功能说明》。
| 环节 | 实现方式 |
|---|---|
| 文档入库 | 粘贴文本或上传 .txt / .md / .markdown，支持批量上传与异步向量化进度显示 |
| 中文切片 | 按 rune 切片：目标 500 字、重叠 60 字、单片上限 1200 字，保持边界语义连续 |
| 向量存储 | chromem-go（纯 Go 嵌入式向量库，零 CGO 依赖，与 SQLite 构建链兼容） |
| 向量模型 | 复用 OpenAI 兼容的 /v1/embeddings，默认 text-embedding-3-small，可用 GO_STOCK_EMBEDDING_MODEL 覆盖 |
| 检索方式 | 单库检索（带相似度评分）与统一检索（所有知识库 + 长期记忆并发查询、全局重排、截断 Top-K） |
| 与 AI 集成 | 注册为 Agent 工具（AI 自主调用）或把检索结果直接注入系统提示词（明确问答场景） |
失败不阻断：官方文档说明向量化/向量检索失败只记录日志并降级，不会中断归档或对话主流程。
Memory
go-stock 长期记忆与用户画像
解决「AI 每次都从零开始」的问题，机制来自官方文档。
经验自动沉淀
每次分析报告归档时，问题与回答自动切片并异步写入 qa_history 向量集合，持久化在本机 memory/.vectorstore/，独立 goroutine 执行不阻塞归档。
自进化召回
Agent 构建提示词时按当前问题语义召回 Top-K 条历史问答经验（默认 5 条，支持用户隔离、按问题去重保留最高相似度），替代旧版的文件名扫描。
用户画像注入
行为数据由 LLM 汇总成 memory/user_profile.md，以「【用户偏好】」段落注入系统提示词（可开关）；界面可编辑、预览、清空与重新学习。
统一检索：长期记忆与知识库共享同一个检索入口（SearchAllKnowledge）——你的「经验」和你的「资料」在 AI 眼里是同一套知识体系。
Prompts
怎么提问：示例与触发关键词
来自官方《快速开始指南》与《交易日志与每日操作计划 AI 实战指南》。
| 任务类型 | 示例提问 | 触发关键词 |
|---|---|---|
| 条件选股 | 「帮我筛选 A 股中市值小于 200 亿、近 5 日主力净流入为正、PE 小于 30 的股票」 | 选股、筛选 |
| 个股分析 | 「分析贵州茅台（600519）近期的资金流向、技术形态和基本面」 | 分析、资金流向 |
| 横向对比 | 「对比宁德时代和比亚迪的财务数据与机构研报观点」 | 对比、研报 |
| 市场复盘 | 「总结今日 A 股市场热点板块、龙虎榜异动与重大资讯」 | 复盘、龙虎榜、资讯 |
| 每日操作计划 | 「为兆易创新生成明日操作计划：3 个情景 + 止损价 + 两档目标价，并开启盘中预警」 | 操作计划、明日操作、盘中预警 |
| 交易复盘 | 「统计我本月的交易日志：买卖次数、累计盈亏、胜率，并分析心态与胜率的关系」 | 交易日志、盈亏 |
Troubleshooting
智能体常见故障排查
整理自官方 docs 的常见问题章节；涉及模型侧的报错先看大模型配置页。
| 现象 | 原因 | 处理 |
|---|---|---|
| 技能没生效 | 技能仅在 DeepAgents 模式生效 | 切换到 DeepAgents 模式；输入 / 唤起技能菜单并按需勾选 |
| MCP 工具不被调用 | 服务器未启用，或提问未命中注入条件 | 打开启用开关；提问点名服务器名或使用「发送/通知/消息」等信号词 |
| MCP 状态 unauthorized | Token 过期、Header 名错误、{{env.*}} 变量未导出 | 核对 Header 与环境变量；OAuth 服务器重新点「授权」走浏览器流程 |
| 测试连接成功但工具列表为空 | 该 MCP 服务器没有注册任何工具 | 属服务器侧问题，与 go-stock 无关，换一个支持 tools/list 的服务器 |
| 长对话后回答变差或中断 | 上下文超阈值触发摘要中间件，或模型上下文有限 | 开新对话、开启记忆模式限定引用条数、换更长上下文模型 |
| 提问历史图片「看不到」 | 会话记忆只保存文字，历史图片不会重发 | 重新发送该图片；确认当前模型配置已打开视觉理解开关 |
FAQ
常见问题
本项目的 AI 分析需要自己买模型吗？
需要自备模型服务：可以填 DeepSeek、智谱、豆包、百炼、OpenAI 等平台的 API Key，也可以用本地 Ollama / LMStudio 完全离线跑。具体支持列表与配置方式以官方 README 与 docs 为准。
150+ AI 数据工具是哪些？
项目 README 与 docs 提到内置大量 AI 数据工具，覆盖行情、资金流向、龙虎榜、研报、公告、期指多空、融资融券、财经日历、每日操作计划与交易记录等方向，并按功能分组管理；工具在对话中由模型按需调用，具体清单随版本迭代变化，以官方文档为准。
技能和 MCP 有什么区别？
技能是「提示词与方法的按需注入」（本地目录 + SKILL.md，只在 DeepAgents 模式生效）；MCP 是「外部工具服务器的接入协议」（HTTP/SSE + 鉴权，各模式都可按规则注入）。前者改变 AI 的分析方法，后者扩展 AI 能调用的工具。
知识库支持 PDF 吗？
官方文档列出的入库格式是直接粘贴文本与 .txt / .md / .markdown 文件，未列出 PDF。若需处理 PDF，可先转换为文本再入库。
长期记忆会把我的数据上传吗？
向量库是本机的 chromem-go 实例，数据落在本地 memory/.vectorstore/；但生成回答时相关内容会随请求发送给你配置的模型服务商，这一点与所有云端模型调用相同，涉密资料请谨慎入库。
这些能力与 EasyClaw 的技能是一回事吗？
不是。本项目的技能是它自己实现的一套机制；EasyClaw 的技能是本机 skills/ 目录下的独立技能包，两者没有已证实集成。想在免部署环境里做同类研究，可看对比页列出的 EasyClaw 技能路线。