Codex 学习手册 · Markdown 主文件自动生成

AI 入门实战:Hermes、DeepSeek 与 Tushare 七天版

七天完成一次可验收的 AI 能力闭环:从规则和记忆,到 DeepSeek、Tushare MCP、数据核验与技能复用。

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 助手:

  1. 你知道它应该做什么。
  2. 你规定它不能做什么。
  3. 它做错时,你能查出错在哪。
  4. 成功的流程能保存下来,下次继续用。
  5. 新会话不需要把背景从头讲一遍。

七天后你应该能做到

  • 在 Hermes 里使用 DeepSeek 模型。
  • 接入并调用 Tushare MCP。
  • 通过 AI 取得数据,同时保留工具调用和原始证据。
  • 判断“有数据”与“数据正确”不是一回事。
  • 维护规则、当前状态、领域知识、决策、经验和证据。
  • 把重复三次以上的流程整理成可复用技能。
  • 用新会话检验:AI 是否真的能接手,而不是只在你面前表现得好。

第一版明确不教的内容

本教程不教模型训练、微调、复杂因子研究、自动交易、完整选股策略、50GB 级数据库和全自动任务调度。股票只作为真实数据场景,不是投资建议,也不涉及任何人的个人持仓。


学习规则

每天怎样完成

每天按同一顺序做:

  1. 读 5–10 分钟概念。
  2. 完成 25–40 分钟实操。
  3. 留下当天文件或运行结果。
  4. 按验收清单自查。
  5. 把真实遇到的问题写进经验台账。

遇到问题时不要硬扛

  • 同一个问题尝试超过 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学习。

先定三条安全边界

  1. 密钥、Token、密码只放在软件要求的位置。
  2. AI 不得未经确认写入数据库、删除文件、发布内容或操作外部账户。
  3. 股票练习只使用公开示例,不加入个人持仓、成交记录和资金信息。

检查电脑是否已经安装 Python

打开 PowerShell,在开始菜单搜索 PowerShell,输入:

python --version

如果显示类似 Python 3.11.x,说明可用。如果打开 Microsoft Store 或提示找不到,可在 Python 官网安装当前稳定版,并在安装时勾选“Add Python to PATH”。本教程的绝大多数步骤不要求你会写 Python。


第 1 天:先理解 AI,再建立自己的工作区

今日目标

理解模型、上下文、工具、Agent 和记忆的关系;学会最基础的 Markdown;建立工作区目录。

10 分钟概念:AI 不是“一个无所不知的人”

大模型擅长根据上下文生成答案,但它不知道你没有提供给它的东西,也可能把“看起来合理”误当成“已经核实”。

可以把 AI 工作理解成四个层次:

  1. 模型:发动机,负责理解和生成。
  2. 上下文:这一次递给它的地图。
  3. 工具:允许它查看真实世界的眼睛和手。
  4. 工作区:长期保存规则、状态、资料、决定和经验的地方。

Agent 不是更聪明的模型,而是“模型 + 任务目标 + 工具 + 循环 + 检查”的组合。它能不能可靠工作,取决于你给它的边界和验收方式。

“训练 AI”在入门阶段通常指什么

这时说的训练,通常不是重新训练模型,而是:

  • 写清楚它应该做什么。
  • 提供可靠资料。
  • 规定不能做什么。
  • 给它反馈,纠正重复错误。
  • 用已知答案测试它。
  • 把验证过的流程保存成技能。

真正改变模型参数叫微调(fine-tuning),成本高,入门阶段通常没有必要。

10 分钟概念:Markdown 为什么方便

Markdown 是一种用普通文字写结构的格式:

# 一级标题
## 二级标题

- 列表项
- 另一个列表项

**加粗文字**

[链接文字](https://example.com)

它适合知识工作,因为:

  • 纯文本,任何编辑器都能打开。
  • 标题、列表、表格、代码块都清楚。
  • 可以直接让人读,也可以让 AI 读。
  • 修改记录能比较,不容易像 Word 一样产生大量格式垃圾。
  • 可以转换成网页、PDF、Word,但内容只维护一份。

本教程以 .md 为主文件。HTML 是阅读界面,PDF 或 Word 是导出结果,不应反过来成为唯一源文件。

实操:创建工作区

最低成功路径

新建目录 D:\AI学习\我的AI工作区,在里面新建三个文本文件:

  • README.md
  • AGENTS.md
  • MEMORY.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 界面可能不同。优先找下面的入口:

  1. 打开 Hermes 的“设置”或“模型/提供商”。
  2. 选择 DeepSeek,或选择兼容 OpenAI 接口的自定义提供商。
  3. 需要填写 API 地址时,使用 DeepSeek 官方当前说明中的地址。
  4. 从当前账号可用列表中选择文本模型;不要盲目照抄别人配置文件里的模型名。
  5. 将你自己的 API Key 填入密钥栏。
  6. 保存并重启 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 客户端发现外部工具、查看参数并调用它们。

一次工具调用通常包含:

  1. 客户端向 MCP 服务询问“你有哪些工具”。
  2. 模型选择合适的工具。
  3. 模型生成参数。
  4. 客户端执行调用。
  5. 原始结果返回给模型。
  6. 模型总结结果,并应保留可核验信息。

这里最重要的是:模型总结不是数据源,MCP 原始返回才是第一层证据。

准备 Tushare

  1. 登录 Tushare 官网,进入个人中心。
  2. 找到自己的 HTTP Token 或 MCP 配置信息。
  3. 确认账号当前积分和可调用权限。
  4. 不把 Token 发到 AI 对话中,不贴进本教程。

Tushare 的接口名称存在,不代表账号一定有调用权限。以后遇到 40101、40203 时,应按错误处理,不要换一个假数据继续。

实操:添加远程 MCP

优先使用 Hermes 的 MCP 设置界面:

  1. 打开“设置”或“MCP 服务器”。
  2. 新建远程 HTTP MCP。
  3. 名称填写 tushareMcp。
  4. 地址按 Tushare 官方当前给出的 MCP 地址填写。
  5. 把 Token 放在官方要求的位置,并确认它只保存在本机配置。
  6. 保存、重启 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 个交易日的数据,保留原始证据,验证排序、日期和字段。

概念:取到数据不等于取得正确数据

一个可靠的数据结果至少要有五项:

  1. 来源:哪个工具或接口。
  2. 参数:股票代码、日期范围、字段。
  3. 原始证据:工具返回或导出文件。
  4. 口径:单位、排序、复权方式和空值处理。
  5. 边界:哪些内容没有核实,不能据此推出什么。

最低成功路径

向 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.SZ
  • 600519.SH
  • 300750.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 会不会如实停下。

概念:记忆不是把聊天记录无限堆长

无差别保存全部对话会带来三个问题:

  1. 过期信息和新信息混在一起。
  2. AI 不知道哪条已经被推翻。
  3. 真正重要的规则被大量闲聊淹没。

推荐五层记忆:

层级 放什么 文件位置
规则 长期不变的安全、权限和协作要求 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 天:把流程固化成技能并完成验收

今日目标

把已经重复过的取数流程整理成技能,在新会话中独立执行,并完成工作区交付说明。

概念:什么时候值得做技能

不要一开始就给每件事写技能。满足下面的条件再固化:

  1. 同类任务至少做过两三次。
  2. 输入和输出基本稳定。
  3. 已经知道常见错误。
  4. 有明确的验收方式。

技能不是长篇知识库,而是一份“下次照着做就能复现”的操作说明。

最低成功路径

在 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,不是得到一个“万能答案”,而是逐渐具备下面四种判断:

  1. 这个任务需要什么上下文?
  2. 这个答案应不应该通过工具核实?
  3. 什么结果算完成,什么情况必须停下?
  4. 这次经验怎样保存,下一次才能更快?

你不需要第一天就搭出完整系统。每天留下一个能用的小结果,连续七天,系统就会从实践中长出来。

风险声明:本教程中的股票代码仅用于演示数据调用和核验流程。教程不提供证券投资咨询,不构成任何买卖、持有、估值或收益承诺。

回到顶部