AI 入门实战:用 Hermes、DeepSeek 与 Tushare 搭出自己的 AI 工作区
版本:1.0
编写日期:2026-11-21
适用对象:Windows 用户;会下载、安装软件和编辑文本,但不需要会编程。
学习节奏:连续 7 天,每天 45–60 分钟;时间不足时可走“20 分钟最低成功路径”。
最终成果:搭出一个规则清楚、记忆可查、过程可验、技能可复用的个人 AI 工作区,并用 Tushare 完成一次真实但有边界的数据练习。
先说清楚:这七天要学什么
学 AI 不是背模型参数,也不是先学会微调模型。对大多数个人工作来说,真正要掌握的是下面这条循环:
提出任务 → 给足上下文 → 调对工具 → 检查结果 → 记录经验 → 下次复用
这套教程围绕六个关键词展开:
| 概念 | 英文 | 用一个问题理解它 |
|---|---|---|
| 大模型 | Large Language Model, LLM | 谁在理解和生成内容? |
| 上下文 | Context | 它这一次能看到哪些资料? |
| 工具 | Tool | 它能不能查数据库、读文件、上网? |
| MCP | Model Context Protocol,模型上下文协议 | 外部工具怎样用统一方式接进来? |
| Agent | 智能体 | 它能不能连续规划、调用工具并检查结果? |
| 记忆 | Memory | 下一次它怎样知道上次的目标、决定和教训? |
最终不是让你“会跟 AI 聊天”,而是让你能管理一个 AI 助手:
- 你知道它应该做什么。
- 你规定它不能做什么。
- 它做错时,你能查出错在哪。
- 成功的流程能保存下来,下次继续用。
- 新会话不需要把背景从头讲一遍。
七天后你应该能做到
- 在 Hermes 里使用 DeepSeek 模型。
- 接入并调用 Tushare MCP。
- 通过 AI 取得数据,同时保留工具调用和原始证据。
- 判断“有数据”与“数据正确”不是一回事。
- 维护规则、当前状态、领域知识、决策、经验和证据。
- 把重复三次以上的流程整理成可复用技能。
- 用新会话检验:AI 是否真的能接手,而不是只在你面前表现得好。
第一版明确不教的内容
本教程不教模型训练、微调、复杂因子研究、自动交易、完整选股策略、50GB 级数据库和全自动任务调度。股票只作为真实数据场景,不是投资建议,也不涉及任何人的个人持仓。
学习规则
每天怎样完成
每天按同一顺序做:
- 读 5–10 分钟概念。
- 完成 25–40 分钟实操。
- 留下当天文件或运行结果。
- 按验收清单自查。
- 把真实遇到的问题写进经验台账。
遇到问题时不要硬扛
- 同一个问题尝试超过 20 分钟,先停下。
- 记录完整报错、执行步骤、发生时间和你已经试过的方法。
- 不要把密码、API Key、Tushare Token 发进聊天。
- 不要让 AI“猜一个结果先继续”,数据任务必须能停下来。
每天都有两条路径
最低成功路径:时间很少时,只完成当天最关键的一步。
标准路径:完成实操、验收和记录。
没走完“加练”不影响毕业。
请使用自己的账号
DeepSeek 和 Tushare 都使用你自己的账号。不要借用别人的密钥、额度或 MCP 配置。真实密钥只保存在本机软件配置中,不写进本教程、Markdown、截图或 Git。
七天路线总览
| 天数 | 主题 | 当天必须留下的东西 |
|---|---|---|
| 第 1 天 | AI 概念、Markdown、工作区骨架 | README、规则、记忆索引 |
| 第 2 天 | Hermes 接入 DeepSeek | 一次成功问答和上下文测试 |
| 第 3 天 | 接入 Tushare MCP | MCP 联通记录和工具测试 |
| 第 4 天 | 第一次可核验取数 | 原始证据、数据表和核验记录 |
| 第 5 天 | 中性股票数据练习 | 三股对比表和边界说明 |
| 第 6 天 | 记忆、决策、经验、审计 | 一份决策和一条真实踩坑 |
| 第 7 天 | 技能固化与换会话验收 | SKILL 文件、验收表和交付说明 |
开始前准备
你需要准备
- Windows 10 或 Windows 11。
- 能正常安装和打开 Hermes Desktop。
- 一个 DeepSeek API 账号。
- 一个 Tushare 账号,以及该账号自己的 Token。
- 文本编辑器:记事本即可,建议后续使用 VS Code。
- 一个普通浏览器。
- 新建一个本地目录,例如:
D:\AI学习。
先定三条安全边界
- 密钥、Token、密码只放在软件要求的位置。
- AI 不得未经确认写入数据库、删除文件、发布内容或操作外部账户。
- 股票练习只使用公开示例,不加入个人持仓、成交记录和资金信息。
检查电脑是否已经安装 Python
打开 PowerShell,在开始菜单搜索 PowerShell,输入:
python --version
如果显示类似 Python 3.11.x,说明可用。如果打开 Microsoft Store 或提示找不到,可在 Python 官网安装当前稳定版,并在安装时勾选“Add Python to PATH”。本教程的绝大多数步骤不要求你会写 Python。
第 1 天:先理解 AI,再建立自己的工作区
今日目标
理解模型、上下文、工具、Agent 和记忆的关系;学会最基础的 Markdown;建立工作区目录。
10 分钟概念:AI 不是“一个无所不知的人”
大模型擅长根据上下文生成答案,但它不知道你没有提供给它的东西,也可能把“看起来合理”误当成“已经核实”。
可以把 AI 工作理解成四个层次:
- 模型:发动机,负责理解和生成。
- 上下文:这一次递给它的地图。
- 工具:允许它查看真实世界的眼睛和手。
- 工作区:长期保存规则、状态、资料、决定和经验的地方。
Agent 不是更聪明的模型,而是“模型 + 任务目标 + 工具 + 循环 + 检查”的组合。它能不能可靠工作,取决于你给它的边界和验收方式。
“训练 AI”在入门阶段通常指什么
这时说的训练,通常不是重新训练模型,而是:
- 写清楚它应该做什么。
- 提供可靠资料。
- 规定不能做什么。
- 给它反馈,纠正重复错误。
- 用已知答案测试它。
- 把验证过的流程保存成技能。
真正改变模型参数叫微调(fine-tuning),成本高,入门阶段通常没有必要。
10 分钟概念:Markdown 为什么方便
Markdown 是一种用普通文字写结构的格式:
# 一级标题
## 二级标题
- 列表项
- 另一个列表项
**加粗文字**
[链接文字](https://example.com)
它适合知识工作,因为:
- 纯文本,任何编辑器都能打开。
- 标题、列表、表格、代码块都清楚。
- 可以直接让人读,也可以让 AI 读。
- 修改记录能比较,不容易像 Word 一样产生大量格式垃圾。
- 可以转换成网页、PDF、Word,但内容只维护一份。
本教程以 .md 为主文件。HTML 是阅读界面,PDF 或 Word 是导出结果,不应反过来成为唯一源文件。
实操:创建工作区
最低成功路径
新建目录 D:\AI学习\我的AI工作区,在里面新建三个文本文件:
README.mdAGENTS.mdMEMORY.md
标准路径:一次建好职责完整的轻量工作区
打开 PowerShell,先确认 D:\AI学习 是你的学习目录,再执行:
$aiRoot = 'D:\AI学习\我的AI工作区'
$folders = @(
'01_状态',
'10_领域',
'20_决策',
'30_经验',
'40_证据',
'50_技能',
'60_日志',
'90_归档'
)
New-Item -ItemType Directory -Force -Path $aiRoot | Out-Null
foreach ($folder in $folders) {
New-Item -ItemType Directory -Force -Path (Join-Path $aiRoot $folder) | Out-Null
}
Get-ChildItem -LiteralPath $aiRoot
这就是“职责接近完整、技术实现轻量”的工作区。它没有数据库和自动化脚本,但已经具备 Codex 式系统的基本分工。
建立 README.md
把下面内容复制到 README.md,将方括号内容逐步改成自己的:
# 我的 AI 工作区
## 这个工作区做什么
用 AI 学习如何:
1. 提出清楚的任务;
2. 调取可信数据;
3. 核验结果;
4. 保存决定、经验和可复用技能。
当前主项目:[股票数据入门]
## 目录
- 01_状态:现在做到哪、下一步是什么
- 10_领域:稳定知识、口径和参考资料
- 20_决策:做过什么选择,为什么
- 30_经验:错误、根因和防复发规则
- 40_证据:原始结果、截图、链接和导出数据
- 50_技能:重复流程固化后的操作说明
- 60_日志:每天的简短工作记录
- 90_归档:不再使用但暂时保留的材料
## 快速入口
- 当前状态:[01_状态/当前状态.md](01_状态/当前状态.md)
- 记忆索引:[MEMORY.md](MEMORY.md)
- 工作规则:[AGENTS.md](AGENTS.md)
建立 AGENTS.md
把下面内容复制到 AGENTS.md。它不是“提示词”,而是你对 AI 的长期工作规则:
# 我的 AI 工作规则
## 工作方式
1. 先复述任务目标,再开始执行。
2. 区分事实、推断和未核实信息。
3. 数据结论必须说明来源、时间范围、计算口径和边界。
4. 重要步骤必须在 60_日志 留下简短记录。
## 权限与安全
1. 不读取、展示或写入密码、API Key、Token、银行卡或恢复码。
2. 不访问个人持仓、成交记录和资金信息,除非我明确授权。
3. 未经确认,不删除、覆盖、批量移动文件。
4. 未经确认,不执行数据库写入、发布、购买、交易或外部系统更改。
5. 不确定时停下来提问,不编造结果。
## 数据与股票
1. 股票内容只做数据核验和中性研究,不形成买卖建议。
2. 任何数据都要优先引用工具原始返回或正式文档。
3. 接口失败、权限不足或返回为空时,必须如实报告。
## 记忆
1. 长期规则写 AGENTS.md。
2. 当前进展写 01_状态。
3. 业务口径写 10_领域。
4. 选择和理由写 20_决策。
5. 错误和防复发方法写 30_经验。
6. 原始材料放 40_证据。
7. 没有证据的内容只能标成“推测”,不能写成事实。
建立 MEMORY.md
MEMORY.md 不当杂物箱,只做索引:
# 记忆索引
## 当前
- [当前状态](01_状态/当前状态.md)
- [股票研究领域卡](10_领域/股票研究.md)
## 已确认的选择
- 暂无
## 重要经验
- [踩坑台账](30_经验/踩坑台账.md)
## 规则
- [长期工作规则](AGENTS.md)
> 这里只放链接。正文放在对应目录,避免同一事实出现多个版本。
建立当前状态
在 01_状态\当前状态.md 写入:
# 当前状态
## 当前目标
七天学会搭建自己的 AI 工作区,并用 Tushare 完成一次可核验的数据练习。
## 已完成
- 已建立工作区目录。
## 下一步
- 在 Hermes 中接入 DeepSeek。
## 已知边界
- 尚未接入 Tushare MCP。
- 还没有确认数据字段和单位。
在 30_经验\踩坑台账.md 写入:
# 踩坑台账
| 日期 | 现象 | 根因 | 解决方法 | 如何防复发 |
|---|---|---|---|---|
| 暂无 | 暂无 | 暂无 | 暂无 | 暂无 |
今日验收
- [ ] 能不用看教程,用自己的话解释模型、上下文、工具、Agent、记忆。
- [ ] 能说出 Markdown 和 Word、PDF、网页的区别。
- [ ] 已建立
README.md、AGENTS.md、MEMORY.md。 - [ ] 已建立八个职责目录。
- [ ] 能指出当前状态、长期规则和原始证据分别放在哪里。
常见问题
| 问题 | 处理 |
|---|---|
文件被保存成 .md.txt |
在资源管理器中打开“文件扩展名”,再重命名 |
| 中文写入后乱码 | 编辑器保存为 UTF-8,不要使用未知编码 |
| 不知道文件放哪 | 先问:这是规则、状态、领域知识、决策、经验还是证据 |
| 文件内容重复 | 正文只放一处,其他文件链接过去 |
第 2 天:让 Hermes 使用 DeepSeek
今日目标
让 Hermes 通过 DeepSeek API 稳定完成问答,并理解模型、API 和工作区规则的关系。
概念:API 是什么
API(Application Programming Interface,应用程序接口)可以理解为“软件之间约定好的点菜窗口”。Hermes 不直接拥有 DeepSeek 模型,它通过 API 把问题和上下文发送出去,再把结果取回来。
使用 API 时要注意:
- 请求可能按量计费。
- 上下文越长,成本和等待时间通常越高。
- 工具调用会增加多轮请求。
- API Key 是账号凭证,只能在软件的安全配置中保存。
实操:配置 DeepSeek
不同版本的 Hermes 界面可能不同。优先找下面的入口:
- 打开 Hermes 的“设置”或“模型/提供商”。
- 选择 DeepSeek,或选择兼容 OpenAI 接口的自定义提供商。
- 需要填写 API 地址时,使用 DeepSeek 官方当前说明中的地址。
- 从当前账号可用列表中选择文本模型;不要盲目照抄别人配置文件里的模型名。
- 将你自己的 API Key 填入密钥栏。
- 保存并重启 Hermes。
不要把 API Key 粘贴到对话中让 AI 替你配置,也不要贴进本 Markdown。若怀疑密钥已经出现在聊天或截图中,应立刻在 DeepSeek 控制台撤销并重新生成。
最低成功路径
向 Hermes 发送:
请用三句话解释“上下文”和“记忆”的区别。
不要使用术语堆砌,最后给一个生活比喻。
能得到完整回答,即完成最低成功。
标准测试
测试 1:普通问答
我正在学习 AI 工作流。
请用“任务、上下文、工具、检查”四个词,
说明一个 AI 助手完成股票数据查询需要哪些环节。
测试 2:上下文连续性
先发送:
请记住,这个对话里的学习目标是:
搭建一个七天内能完成的个人 AI 工作区。
暂时不要展开计划。
再发送:
用一句话复述我刚才给你的学习目标。
如果回答准确,说明当前会话上下文正常。注意:这通常只是“当前对话上下文”,不等于长期记忆。长期记忆仍要写进工作区文件。
测试 3:规则是否生效
发送:
请先读取 D:\AI学习\我的AI工作区\AGENTS.md。
然后告诉我:涉及数据库写入时,你必须先做什么?
预期答案应包含“说明影响并取得确认”。如果 Hermes 不能读取该路径,检查它是否允许访问工作区目录。
把模型信息写进领域卡
建立 10_领域\AI环境.md:
# AI 环境记录
## 客户端
- Hermes Desktop
- Windows
## 模型提供商
- DeepSeek API
## 配置原则
- API Key 只保存在 Hermes 本机配置。
- 不把密钥写入工作区。
- 模型名称以当前软件列表为准。
## 最近验证
- 日期:YYYY-MM-DD
- 普通问答:通过/未通过
- 上下文复述:通过/未通过
- 读取 AGENTS 规则:通过/未通过
今日验收
- [ ] DeepSeek 模型能在 Hermes 中正常回答。
- [ ] 连续两轮对话能保持当前目标。
- [ ] Hermes 能读取工作区中的规则文件。
- [ ] API Key 没有出现在聊天、Markdown 或截图中。
- [ ] 已理解“当前上下文”和“长期记忆”不是一回事。
常见问题
| 现象 | 可能原因 | 处理 |
|---|---|---|
| 401/认证失败 | Key 填错、过期或用了别的平台密钥 | 回到 DeepSeek 控制台核对并重新生成 |
| 404/模型不存在 | 模型名不适用于当前账号 | 从软件列表或官方文档选择可用模型 |
| 429/限流 | 请求过快或额度不足 | 放慢操作,检查账户额度 |
| 能聊天但读不到文件 | 工作区未授权 | 在 Hermes 中增加工作区目录访问权限 |
| 重启后配置丢失 | 配置没有真正保存 | 重新检查提供商设置,不把密钥另存到文档 |
第 3 天:接入 Tushare MCP
今日目标
让 Hermes 连接到 Tushare 官方远程 MCP,并验证“工具列表”和“实际调用”都正常。
概念:MCP 解决什么问题
普通聊天模型只能看到对话里的文字。MCP(模型上下文协议)规定了一套统一方式,让 AI 客户端发现外部工具、查看参数并调用它们。
一次工具调用通常包含:
- 客户端向 MCP 服务询问“你有哪些工具”。
- 模型选择合适的工具。
- 模型生成参数。
- 客户端执行调用。
- 原始结果返回给模型。
- 模型总结结果,并应保留可核验信息。
这里最重要的是:模型总结不是数据源,MCP 原始返回才是第一层证据。
准备 Tushare
- 登录 Tushare 官网,进入个人中心。
- 找到自己的 HTTP Token 或 MCP 配置信息。
- 确认账号当前积分和可调用权限。
- 不把 Token 发到 AI 对话中,不贴进本教程。
Tushare 的接口名称存在,不代表账号一定有调用权限。以后遇到 40101、40203 时,应按错误处理,不要换一个假数据继续。
实操:添加远程 MCP
优先使用 Hermes 的 MCP 设置界面:
- 打开“设置”或“MCP 服务器”。
- 新建远程 HTTP MCP。
- 名称填写
tushareMcp。 - 地址按 Tushare 官方当前给出的 MCP 地址填写。
- 把 Token 放在官方要求的位置,并确认它只保存在本机配置。
- 保存、重启 Hermes,并确认 MCP 开关为开启状态。
若当前 Hermes 版只允许编辑配置,先定位实际配置路径:
$candidates = @(
"$env:APPDATA\cn.org.hermesagent.desktop\runtime\hermes-home\config.yaml",
"$env:USERPROFILE\.hermes\config.yaml"
)
$candidates | ForEach-Object {
if (Test-Path -LiteralPath $_) {
Get-Item -LiteralPath $_ | Select-Object FullName, LastWriteTime
}
}
如果两个路径都不存在,以 Hermes 当前设置页显示的路径为准,不要根据其他电脑的旧会话猜路径。
配置形态通常类似下面的 JSON。双引号里的 Token 必须替换为你自己的值;这段真实内容只能留在本机配置中。
{
"mcpServers": {
"tushareMcp": {
"url": "https://api.tushare.pro/mcp/?token=YOUR_TUSHARE_TOKEN"
}
}
}
为什么不能直接分享这段配置
Tushare 的这种远程 MCP 地址把 Token 放在 URL 中。拿到完整 URL 的人可能消耗你的额度。因此:
- 截图前遮住 URL 的 Token 部分。
- 不把真实配置发到群里让朋友“帮你看”。
- 不提交到 Git。
- 一旦泄露,立即去 Tushare 控制台重置 Token。
最低成功路径
在 Hermes 新会话发送:
请列出当前已连接 MCP 服务的名称。
先不要调用任何数据接口。
看到 tushareMcp 即完成最低成功。
标准验证:先列工具,再调一个基础接口
发送:
请只使用 tushareMcp。
第一步:确认 tushareMcp 可用。
第二步:调用 stock_basic,查询 ts_code=000001.SZ。
第三步:告诉我你实际调用了哪个工具、用了什么参数。
第四步:保留并展示最关键的原始返回字段。
如果工具不存在、权限不足或调用失败,立即停止并原样报告错误。
不要用网页搜索、记忆或推测代替 Tushare 返回。
预期至少看到:
- 实际工具名。
- 参数
ts_code=000001.SZ。 - 股票代码和名称。
- 成功或失败的明确状态。
如果 Tool 名称不完全叫 stock_basic,以当前 MCP 返回的工具清单为准,不要机械猜测。
建立股票领域卡
在 10_领域\股票研究.md 写入:
# 股票数据研究
## 数据源
- 主数据源:Tushare MCP
- 实际接口:待当天核验
- 查询日期:YYYY-MM-DD
## 基本规则
1. 先确认股票代码,再分析名称。
2. 记录接口名称、参数、日期范围和原始返回。
3. 不根据 AI 记忆补股票名称、价格或财务数字。
4. 股票练习不生成买卖建议。
## 已知错误
- 40101:工具或接口未注册。
- 40203:当前账号无接口权限。
- 空结果:可能是参数错误、日期无数据或接口没有发布,不等同于系统故障。
今日验收
- [ ] Hermes 能识别
tushareMcp。 - [ ] 能看到工具列表,不只看到“服务已添加”。
- [ ] 至少成功调用一次
stock_basic或等效基础接口。 - [ ] 记录了实际工具名和参数。
- [ ] Token 没有出现在聊天、文档或截图。
常见问题
| 现象 | 含义 | 正确处理 |
|---|---|---|
| 406 Not Acceptable | HTTP 客户端未使用 MCP 需要的 Accept 头 | 交给 Hermes 的 MCP 客户端处理,不手写半套 HTTP |
| 401/403 | Token 或权限问题 | 核对账号、Token 和配置 |
| 40101 | 工具/接口未注册 | 停止并核对官方工具名 |
| 40203 | 账号积分或权限不足 | 不重试刷请求,核对 Tushare 权限 |
| 工具列表可见但调用失败 | “注册”不等于“可用” | 记录错误,换一个已确认有权限的接口 |
| 配置重启后消失 | 改错配置位置或未保存 | 回到 Hermes 设置确认实际路径 |
第 4 天:完成第一次可核验取数
今日目标
查询一只公开示例股票最近 20 个交易日的数据,保留原始证据,验证排序、日期和字段。
概念:取到数据不等于取得正确数据
一个可靠的数据结果至少要有五项:
- 来源:哪个工具或接口。
- 参数:股票代码、日期范围、字段。
- 原始证据:工具返回或导出文件。
- 口径:单位、排序、复权方式和空值处理。
- 边界:哪些内容没有核实,不能据此推出什么。
最低成功路径
向 Hermes 发送:
请用 tushareMcp 查询 000001.SZ 最近 20 个交易日的日线数据。
只返回接口名、参数、起止日期和行数。
如果失败,原样返回错误,不要猜数据。
取得工具返回即完成最低成功。
标准任务
使用下面这段任务卡:
目标:
查询 000001.SZ 最近 20 个交易日的日线数据。
数据要求:
1. 只使用 tushareMcp。
2. 字段至少包括 trade_date、open、high、low、close、vol、amount。
3. 结果按 trade_date 升序排列。
4. 明确本次“最近”是以服务器当前可获得的最新交易日为终点。
5. 报告实际接口名、全部参数、起止日期和记录数。
输出要求:
1. 先给工具原始调用摘要。
2. 再给一张 Markdown 表,只展示最早 3 行和最新 3 行。
3. 检查是否有重复日期、空值、乱序和异常日期。
4. 说明每个字段的单位以哪份官方文档为准。
5. 如果工具失败,停止并报告,不得补充推测数据。
边界:
这只是数据读取练习,不做走势预测,不构成投资建议。
检查工具是否真的返回了数据
重点核对以下内容:
1. 股票身份
- 代码是否为
000001.SZ。 - 名称是否来自
stock_basic,而不是模型猜出来的。
2. 日期
- 是否为交易日,而不是自然日。
- 起止日期是否合理。
- 排序是否从旧到新。
- 如果工具默认降序,是否明确重新排序。
3. 行数
- 正常情况下最多 20 行。
- 少于 20 行可能是停牌、上市时间不足、接口缺失或日期筛选错误。
- 行数正确也不代表数值一定正确。
4. 字段和单位
不要把“成交量”和“成交额”混为一谈,也不要凭印象猜单位。将确认过的口径写进领域卡:
## 日线字段口径
| 字段 | 含义 | 单位/格式 | 官方依据 | 核验日期 |
|---|---|---|---|---|
| trade_date | 交易日期 | YYYYMMDD | 待填 | YYYY-MM-DD |
| open | 开盘价 | 待填 | 待填 | YYYY-MM-DD |
| high | 最高价 | 待填 | 待填 | YYYY-MM-DD |
| low | 最低价 | 待填 | 待填 | YYYY-MM-DD |
| close | 收盘价 | 待填 | 待填 | YYYY-MM-DD |
| vol | 成交量 | 待填 | 待填 | YYYY-MM-DD |
| amount | 成交额 | 待填 | 待填 | YYYY-MM-DD |
“待填”是有意保留的。没有核验时,不把模型回答直接写成事实。
保存原始证据
让 Hermes 执行:
请把本次 Tushare MCP 调用的任务说明、实际参数、
原始返回和你的核验结论保存到:
D:\AI学习\我的AI工作区\40_证据\
文件名使用日期和股票代码。
不要把 Tushare Token 或完整带 Token 的 URL 写入文件。
推荐证据结构:
# 000001.SZ 最近20个交易日数据证据
## 查询时间
YYYY-MM-DD HH:MM
## 工具与参数
- 工具:待填
- 股票代码:000001.SZ
- 日期范围:待填
## 原始返回
```json
在这里粘贴脱敏后的原始结果
```
## 核验
- 起止日期:
- 行数:
- 是否升序:
- 是否有重复日期:
- 是否有空值:
- 未核实边界:
今日验收
- [ ] 查询只使用了 Tushare MCP。
- [ ] 能指出实际工具名和全部参数。
- [ ] 起止日期和行数明确。
- [ ] 数据按日期升序。
- [ ] 原始证据已保存。
- [ ] 字段单位没有被凭空猜测。
- [ ] 已写明“不构成投资建议”。
常见问题
| 现象 | 可能原因 | 正确处理 |
|---|---|---|
| 最新一条不是今天 | 今天休市、数据尚未发布或日期落后 | 查交易日历和接口发布时间 |
| 只有部分股票返回 | 权限或查询上限 | 检查接口权限和分页规则 |
| 行数超过 20 | 日期条件没有限定正确 | 重新生成明确日期范围 |
| 返回顺序是倒序 | 接口原始排序如此 | 分析前显式升序排序 |
| 模型给出“合理价格”但没有工具返回 | 幻觉或混入记忆 | 立即放回原始证据,不接受无证据数据 |
第 5 天:完成一次中性股票数据练习
今日目标
对三只公开示例股票完成同一口径的数据对比,并学会规定 AI 的输出边界。
概念:先定义问题,再让 AI 干活
“帮我看看这几只股票”不是一个可验收任务。可执行任务需要:
- 明确对象:哪几只股票。
- 明确时间:哪个日期区间。
- 明确指标:比较什么。
- 明确计算:用什么公式。
- 明确输出:表格还是报告。
- 明确禁止:不许预测、不许荐股、不许补缺失数据。
示例股票只用于操作练习:
000001.SZ600519.SH300750.SZ
你可以替换成其他公开代码,但必须使用同一时间和同一口径。
最低成功路径
让 AI 比较三只股票在同一日期区间内的区间涨跌幅,并列出缺失项。
标准任务卡
目标:
比较 000001.SZ、600519.SH、300750.SZ
最近 20 个交易日的未复权收盘价区间变化和平均日成交额。
数据要求:
1. 只使用 tushareMcp。
2. 三只股票使用同一组起止交易日。
3. 区间涨跌幅 =
(最后交易日 close / 第一个交易日 close - 1)× 100%。
4. 平均日成交额使用同一单位,并说明单位来源。
5. 缺失交易日、空值和接口失败单独列出,不插值补齐。
输出要求:
1. 一张三行对比表。
2. 一行计算口径。
3. 一行数据来源。
4. 两到三条“只能说明什么”。
5. 两到三条“不能说明什么”。
6. 明确声明这不是投资建议。
禁止:
1. 不预测未来涨跌。
2. 不给出买入、卖出、持有、目标价或仓位建议。
3. 不把未复权价格变化称为完整投资收益。
4. 不根据模型记忆补公司基本面。
建议结果表格式
| 股票 | 代码 | 起始日/收盘 | 结束日/收盘 | 区间价格变化 | 平均日成交额 | 数据缺口 |
|---|---|---|---|---|---|---|
| 待工具返回 | 000001.SZ | 待填 | 待填 | 待填 | 待填 | 待填 |
| 待工具返回 | 600519.SH | 待填 | 待填 | 待填 | 待填 | 待填 |
| 待工具返回 | 300750.SZ | 待填 | 待填 | 待填 | 待填 | 待填 |
必须写出的边界
正确示例:
- 本表只说明指定 20 个交易日内未复权收盘价的变化。
- 未考虑分红、送股、手续费和买卖时点差异。
- 样本区间很短,不能证明长期规律。
- 成交额变化不等于资金净流入。
错误示例:
- “A 股票更强,所以应该买 A。”
- “成交额增加说明主力进场。”
- “过去 20 天涨得多,未来还会涨。”
更新工作区
把这次方法写成 20_决策\YYYY-MM-DD_短期数据对比口径.md:
# 短期数据对比口径
## 决定
本次三股练习统一使用最近 20 个交易日的未复权收盘价,
区间变化按首尾收盘价计算,平均日成交额使用接口原始单位。
## 原因
1. 三只股票必须使用同一时间和同一口径。
2. 未复权数据容易取得,适合第一次核验。
3. 该指标只用于学习,不代表完整收益。
## 不采用
- 不插值缺失交易日。
- 不混用不同日期区间。
- 不输出买卖建议。
## 后续条件
若要研究真实收益,需要另行确认复权、分红、停牌和交易成本口径。
把对比结果和原始工具返回写入 40_证据\,并在 01_状态\当前状态.md 更新为“已完成第一次数据对比,下一步学习记忆与审计”。
今日验收
- [ ] 三只股票使用完全相同的起止日期。
- [ ] 计算式和单位写清楚。
- [ ] 缺失数据没有被偷偷补齐。
- [ ] 报告只有数据描述,没有买卖建议。
- [ ] 已写出“能说明什么”和“不能说明什么”。
- [ ] 已保存任务、原始证据和决定。
第 6 天:让 AI 有记忆,但不再乱记
今日目标
建立规则、状态、领域、决策、经验、证据之间的分工;故意制造一次失败,验证 AI 会不会如实停下。
概念:记忆不是把聊天记录无限堆长
无差别保存全部对话会带来三个问题:
- 过期信息和新信息混在一起。
- AI 不知道哪条已经被推翻。
- 真正重要的规则被大量闲聊淹没。
推荐五层记忆:
| 层级 | 放什么 | 文件位置 |
|---|---|---|
| 规则 | 长期不变的安全、权限和协作要求 | AGENTS.md |
| 状态 | 现在做到哪里、下一步是什么 | 01_状态 |
| 领域 | 稳定知识、字段、单位、术语 | 10_领域 |
| 决策 | 做过的选择和理由 | 20_决策 |
| 经验 | 真实错误、根因、防复发方法 | 30_经验 |
| 证据 | 原始返回、日志、截图、链接 | 40_证据 |
MEMORY.md 负责索引,不重复保存所有正文。
最低成功路径
让 AI 读取 AGENTS.md、MEMORY.md 和 01_状态\当前状态.md,然后用三句话说明:
- 当前目标是什么。
- 下一步是什么。
- 哪些事情未经确认不能做。
实操:故意测试一次失败
选择不会产生费用的错误参数,例如让日线接口使用不存在的日期 20261340:
请用 tushareMcp 查询 000001.SZ 在 20261340 这一天的日线数据。
要求:
1. 原样展示工具返回。
2. 如果参数非法或没有数据,明确停止。
3. 不得修正为一个“看起来合理”的日期。
4. 不得用搜索或记忆代替工具返回。
5. 把这次失败按经验模板记录。
预期行为:
- 工具报参数错误、返回空或拒绝调用。
- AI 不伪造一条日线。
- AI 能区分“参数非法”“日期无数据”“接口权限不足”。
如果 AI 仍然给了价格,说明你没有保留证据或规则不够强。回到任务卡,要求它先展示工具原始返回,再允许总结。
经验模板
在 30_经验\踩坑台账.md 追加:
## EXP-YYYYMMDD-01:非法交易日测试
- 日期:YYYY-MM-DD
- 现象:使用无效日期 20261340 查询日线。
- 实际工具:
- 实际参数:
- 原始错误:
- 根因:
- 立即解决:
- 防复发规则:
- 任何日期先转换为 YYYYMMDD 并验证范围。
- 工具报错时停止,不修正参数后假装是原任务结果。
- 证据路径:
决策模板
在 20_决策\ 建立文件:
# 决策:为什么用 Markdown 作为主格式
- 日期:YYYY-MM-DD
- 状态:已采用
## 决定
工作区的规则、状态、领域、决策和经验全部使用 Markdown。
## 原因
1. 可读、可搜索、可由 AI 直接处理。
2. 不受某个软件格式限制。
3. 可以用 Git 或其他方式追踪变化。
4. HTML、PDF、Word 可以由 Markdown 导出。
## 代价
- 复杂排版能力不如专业排版软件。
- 需要遵守简单的标题和表格格式。
## 撤销条件
只有在需要多人复杂批注或强制版式时,才增加 Word/PDF,
Markdown 仍作为内容源。
换一个无记忆的会话验收
新开 Hermes 会话,只发送:
请按以下顺序读取:
1. D:\AI学习\我的AI工作区\AGENTS.md
2. D:\AI学习\我的AI工作区\MEMORY.md
3. D:\AI学习\我的AI工作区\01_状态\当前状态.md
然后回答:
1. 当前学习目标是什么?
2. 已完成什么?
3. 下一步是什么?
4. 涉及数据库写入时必须遵守什么?
5. 股票内容允许写买卖建议吗?
不要根据之前的聊天记忆回答。
如果它只能答出“不知道”,说明信息没有落到磁盘;如果它答得比文件更多,说明它在猜。两种情况都要修正。
今日验收
- [ ] 能说出六类记忆各自放在哪里。
- [ ]
MEMORY.md只有索引,不重复全部正文。 - [ ] 已完成一次非法日期测试。
- [ ] AI 没有伪造失败结果。
- [ ] 经验和决策都有文件。
- [ ] 新会话能根据磁盘文件说清当前状态和规则。
第 7 天:把流程固化成技能并完成验收
今日目标
把已经重复过的取数流程整理成技能,在新会话中独立执行,并完成工作区交付说明。
概念:什么时候值得做技能
不要一开始就给每件事写技能。满足下面的条件再固化:
- 同类任务至少做过两三次。
- 输入和输出基本稳定。
- 已经知道常见错误。
- 有明确的验收方式。
技能不是长篇知识库,而是一份“下次照着做就能复现”的操作说明。
最低成功路径
在 50_技能\股票数据查询\SKILL.md 写下:
- 什么时候使用。
- 需要哪些输入。
- 调用哪些工具。
- 输出什么。
- 如何检查。
- 什么情况下停止。
技能模板
---
name: tushare-stock-snapshot
description: 使用 Tushare MCP 查询公开股票在指定交易日区间内的日线数据,并完成基础核验。
---
# Tushare 股票日线快照
## 何时使用
当用户要求查询一只公开 A 股在指定日期区间内的日线数据时使用。
## 输入
- 股票代码,例如 000001.SZ
- 起始日期和结束日期
- 需要的字段
## 前置检查
1. 确认 tushareMcp 已连接。
2. 确认日期为 YYYYMMDD 格式。
3. 确认股票代码带交易所后缀。
4. 不读取任何个人持仓或交易信息。
## 执行步骤
1. 调用 stock_basic 核对股票代码和名称。
2. 调用 trade_cal 或等效交易日历确认日期区间。
3. 调用日线工具获取数据。
4. 按 trade_date 升序排序。
5. 检查重复日期、空值、行数和日期范围。
6. 保存脱敏后的原始证据。
## 输出
- 工具名和全部参数
- 起止日期与行数
- 关键表格
- 字段单位和来源
- 数据缺口与未核实边界
## 停止条件
- MCP 未连接
- 工具不存在
- 40101、40203 或权限不足
- 无法确认股票代码
- 原始返回与预期对象不一致
- 用户要求买卖建议
## 禁止
- 不伪造数据
- 不补齐缺失日期
- 不凭记忆写价格
- 不输出投资建议
新会话独立验收
新开一个 Hermes 会话,不提供背景,只发送:
请读取 D:\AI学习\我的AI工作区\AGENTS.md
和 D:\AI学习\我的AI工作区\50_技能\股票数据查询\SKILL.md。
然后按照这个技能查询 000001.SZ 最近 5 个交易日的日线数据。
把结果保存到 40_证据,并在 60_日志 记录本次执行。
如果任何前置检查不通过,停止并说明原因。
验收重点不是“回答看起来专业”,而是:
- 它实际执行了正确工具。
- 它保留了原始证据。
- 它遵守停止条件。
- 它能把任务写回工作区。
写一份交接说明
在 README.md 追加或新建 交付说明.md:
# 我的 AI 工作区交付说明
## 能力
- 使用 Hermes + DeepSeek 进行任务协作。
- 使用 Tushare MCP 查询公开股票数据。
- 保存状态、决定、经验和原始证据。
- 按已固化技能复核重复任务。
## 入口
- 规则:AGENTS.md
- 记忆索引:MEMORY.md
- 当前状态:01_状态/当前状态.md
- 股票口径:10_领域/股票研究.md
- 数据技能:50_技能/股票数据查询/SKILL.md
## 安全边界
- 不保存密钥和个人交易资料。
- 不自动修改数据库或外部账户。
- 不把数据结果写成投资建议。
## 下次开始时说什么
“请先读取 AGENTS.md、MEMORY.md 和当前状态,再继续任务。”
七天毕业验收
工具层
- [ ] Hermes 能使用 DeepSeek。
- [ ] Tushare MCP 显示已连接。
- [ ] 至少成功调用一次基础股票信息接口。
- [ ] 至少成功调用一次日线接口。
数据层
- [ ] 能说明实际工具名和参数。
- [ ] 有原始返回或脱敏导出。
- [ ] 能检查日期、排序、行数和缺失。
- [ ] 能说明字段单位和未核实边界。
管理层
- [ ] 有长期规则。
- [ ] 有当前状态。
- [ ] 有决定和理由。
- [ ] 有真实错误记录。
- [ ] 有证据目录。
记忆与复用
- [ ] 新会话能从文件恢复背景。
- [ ] 技能能在新会话中独立执行。
- [ ] 工作区没有重复事实和多版本冲突。
安全与边界
- [ ] 没有明文 API Key 或 Tushare Token。
- [ ] 没有个人持仓、成交记录和资金资料。
- [ ] 没有伪造数据。
- [ ] 没有买卖建议。
全部通过,即完成本教程。未通过的项目不用自责,把它写进踩坑台账,再只补这一项。
附录 A:每天 20 分钟保底卡
| 天数 | 只做这一件事 |
|---|---|
| 第 1 天 | 建好三个核心 Markdown 文件 |
| 第 2 天 | 让 Hermes 成功回答一个问题 |
| 第 3 天 | 在 MCP 列表中看到 tushareMcp |
| 第 4 天 | 成功取到一只股票的数据 |
| 第 5 天 | 让 AI 按明确口径算出一张三股对比表 |
| 第 6 天 | 把一条真实错误写进经验台账 |
| 第 7 天 | 新会话读规则并复述当前状态 |
附录 B:每日日志模板
在 60_日志\YYYY-MM-DD.md 写入:
# YYYY-MM-DD 工作日志
## 今天的目标
## 实际完成
## 工具与参数
## 结果
## 遇到的问题
## 证据位置
## 下一步
附录 C:通用任务卡模板
目标:
输入:
允许使用的工具:
执行步骤:
输出格式:
验收标准:
禁止事项:
失败时怎么做:
以后不必每次从零写提示词,只需复制任务卡并改四项:目标、输入、验收、禁止事项。
附录 D:常见错误速查
| 错误 | 真正的问题 | 不要做什么 | 应该做什么 |
|---|---|---|---|
| 模型回答得很像真的 | 没有证据 | 直接复制进报告 | 要求工具原始返回 |
| MCP 工具列表有名字 | 注册不代表有权限 | 连续重试 | 查权限和实际调用结果 |
| 接口返回为空 | 可能是日期、权限或确实无数据 | 猜一个数字补上 | 查参数、交易日历、官方说明 |
| 新会话不知道背景 | 信息只在旧聊天里 | 重新讲一遍就结束 | 写入规则、状态和记忆索引 |
| AI 改了文件却没记录 | 没有日志和证据 | 只看最终答复 | 检查文件内容和修改记录 |
| 回答很长但无法验收 | 任务边界不清 | 继续追问“再详细点” | 改为明确输入、输出和检查项 |
附录 E:什么时候考虑升级到 Codex
先在 Hermes 上完成本教程。出现下面情况时,再考虑更重的系统:
- 多个项目同时运行,需要更强的目录和状态管理。
- 需要搜索大量历史文档,而不是只看几十个 Markdown。
- 需要更严格的审批、测试、代码修改和版本控制。
- 同一流程每天重复,需要自动维护、任务编排和审计。
- 需要在代码库中完成大范围修改和验证。
Codex 式系统并不能替你决定目标。它的价值来自你已经会写规则、保存状态、规定验收、记录经验。工具升级只是把这些能力放大。
最后一段话
真正学会 AI,不是得到一个“万能答案”,而是逐渐具备下面四种判断:
- 这个任务需要什么上下文?
- 这个答案应不应该通过工具核实?
- 什么结果算完成,什么情况必须停下?
- 这次经验怎样保存,下一次才能更快?
你不需要第一天就搭出完整系统。每天留下一个能用的小结果,连续七天,系统就会从实践中长出来。
风险声明:本教程中的股票代码仅用于演示数据调用和核验流程。教程不提供证券投资咨询,不构成任何买卖、持有、估值或收益承诺。