# 我用 WorkBuddy 搭了一条汇率笔记自动化流水线 #WorkBuddy#

> **行业与岗位**：金融·投资 / 个人投资者兼知识工作者

> **做的工作**：把「每天手工查人民币中间价、换算叉汇率、整理成笔记、存进知识库」这件事，改成每天 09:00 自动跑完，已稳定运行一个多月

> **产出物**：每日一份结构化 Markdown 汇率笔记（四节固定结构），自动归档进 ima 知识库下名为「外汇/汇率」的知识号，可按日期检索

## 一、这件事原来为什么费劲![图A_定时任务配置页_每日0900.png](https://developer.qcloudimg.com/http-save/yehe-12781068/b9e4e4d4ebd0e93a4691f65daf6cecbb.png)

我做投资复盘时需要每天的人民币汇率中间价。原始做法是：

1. 打开中国货币网，找到「人民币汇率中间价」页面
2. 抄 10 个货币对的数字
3. 自己算叉汇率（EUR/USD、USD/JPY 这些）
4. 跟上一天的数对比，看升贬了多少个基点
5. 整理成笔记存起来

**单次大概 8 分钟**，而且有两个问题：一是**手动抄 10 个数很容易错**，叉汇率算错更是自己发现不了；二是**没法批量补**——如果出差几天没做，回头要一个个补，通常就放弃了，最后笔记是断的。

目标很明确：**每天早上自动完成，数字必须来自官方源，一天都不能缺。**

## 二、输入材料

整个流程的输入只有两个：

**主数据源**：人民币汇率中间价（10 个货币对，历史序列）。来源：中国外汇交易中心（央行授权公布），中国货币网。

**对照数据**：前一交易日中间价（用于算基点变动）。来源同上，接口一次返回多日历史。

**接口关键信息**（实测确认）：

- 接口地址：`https://www.chinamoney.com.cn/ags/ms/cm-u-bk-ccpr/CcprHisNew`
- 请求方式：`POST`，`Content-Type: application/json`
- 必带两个头：`Referer: https://www.chinamoney.com.cn/chinese/bkccpr/` 与常规 User-Agent
- 请求体：`{"pageNum":1,"pageSize":10}` —— **不传货币参数，一次拿回全部 25 个货币对**
- 返回结构：`data.head` 是表头数组（`["USD/CNY","EUR/CNY","100JPY/CNY",...]`），`records[i].values` 与表头**按下标一一对应**

**踩过的坑一：`www.` 前缀不能省。**

裸域名 `chinamoney.com.cn` 没有 A 记录，请求会直接 `ENOTFOUND` 失败。这个错很低级但很费时间——因为报错信息指向"域名不存在"，容易误以为是接口挂了。

**踩过的坑二：接口约 09:15 发布，发布瞬间数值是占位符。**

09:00 去抓，很可能拿到的 `values` 里全是 `"---"`。所以不能"跑一次拿到就完事"，必须**轮询到数据齐备**。

## 三、WorkBuddy 配置

这条流水线大概是**中等复杂度**的配置。逐个说：

### 3.1 定时任务（核心）

一个每日 09:00 的定时自动化任务。**任务提示词是整个方案里最难写、也最值得写的部分**——因为模型执行时的所有判断都来自它。我把提示词拆成五段：

- **数据源说明**：接口地址、请求方式、必需的 Header、请求体。为什么必须有——不写清 `www.` 和 `Referer`，执行时会翻车
- **返回结构**：`data.head` / `records[].values` 的对应关系。为什么必须有——不写清，模型容易按字段名猜
- **换算规则**：叉汇率算法、基点定义、100 日元要先除 100。为什么必须有——日元是特例，不写明必错
- **输出模板**：笔记的四节结构。为什么必须有——保证每天格式一致，可检索
- **兜底与禁令**：接口失败时的备用源顺序 + 「严禁杜撰数字」。为什么必须有——最关键的一段，见下

**关于最后一段**：这是我认为整条流水线里最重要的设计。提示词最后写的是：

> 约束：仅基于真实抓取结果，严禁杜撰数字；若接口失败，依次备用东方财富汇率接口、新浪财经外汇、或联网检索「人民币中间价 YYYY-MM-DD」，并在笔记中标注实际使用的数据源；**若全部失败或凭证缺失，停止并清晰说明原因，不要编造。**

为什么这句必须写？因为**金融数据自动化最危险的不是失败，而是"看起来成功"**。模型很擅长在拿不到数据时"善意地"补一个像样的数字出来，而这类错误在笔记里几乎无法肉眼发现——格式完全正确，数字是假的。这条禁令是我在配这个任务时最先写、也调得最认真的一句。

### 3.2 辅助脚本（三个）

定时任务提示词负责"判断"，具体的数据处理交给脚本，这样更稳定：

- **poll_ccpr.py** —— 轮询接口直到当日数据齐备。关键实现：判定条件为 `records[0].date == 目标日` 且 `values[:10]` 全部非空且非 `"---"`；未齐备则每 35 秒重试，超时则保存最后一次结果并明确报 `TIMEOUT`
- **build_note_ccpr.py** —— 由 JSON 生成 Markdown 笔记。关键实现：用 `Decimal` 而非 `float` 做运算（避免浮点误差）；`usable()` 函数负责跳过 `"---"` 占位记录
- **check_coverage.cjs** —— 逐日核验知识库里笔记是否齐全。关键实现：按标题 `外汇汇率 YYYY-MM-DD` 检索，TOP1 命中自身即视为存在

**踩过的坑三：接口的 `records` 在顶层，不在 `data` 里。**

这个非常反直觉——`data` 里装的是 `head` 和日期范围，而真正装数据的 `records` 与 `data` **平级**。我第一版脚本按 `data.records` 去取，拿到空数组，一路静默失败。后来在脚本注释里专门标了这个坑。

**踩过的坑四：知识库检索接口有限流，不重试会误判"笔记丢了"。**

连续快速调用检索接口，会返回 `code=200001` 且结果为空数组。如果代码只看"结果为空"就判定缺失，会得出**完全错误的结论**（明明写了却报缺失）。解法是：**按返回码判断成功，失败则退避重试 5 次**，重试间隔递增。`check_coverage.cjs` 里就是这个逻辑。

### 3.3 用到的其他产品能力

- **ima 知识库（笔记模块）** —— 笔记最终归档目标，通过 OpenAPI 写入（`append_doc` / `import_doc`）
- **本地文件读写** —— 存 JSON 原始数据、Markdown 笔记、状态记录
- **联网抓取** —— 主数据源与兜底备用源
- **定时云端任务** —— 每天 09:00 触发，不需要我开机守着

## 四、操作步骤

### 4.1 每天自动跑的五步

```
09:00  定时任务触发
  ↓
① 轮询 chinamoney 接口
   直到 records[0].date = 今天 且 前 10 项数值齐备
   （未发布则每 35 秒重试）
  ↓
② 存原始 JSON 到 outputs/
   （留档，便于事后复查数字来源）
  ↓
③ 生成 Markdown 笔记
   ①人民币对美元中间价 + 较前值基点
   ②10 币种中间价表
   ③9 组叉汇率（由中间价套算）
   ④数据来源与免责说明
  ↓
④ 写入 ima 知识库
  ↓
⑤ 回读校验 + 覆盖核验
   回读比对内容是否一致（防编码损坏）
   逐日检查有无缺口
```

### 4.2 中途调整与问题处理（这部分是重点）

这条流水线不是一次就跑通的，实际调了四轮：

**第一轮：数据源切换。**

最初用的是实时汇率接口（给的是市场即时价），但**中间价和实时价是两个不同的东西**——中间价是央行授权发布的参考价，每天 09:15 一次，是做复盘要用的那个数。换成 CCPR 历史接口后口径才对上。

> 这个区别值得单独强调：网上很多"汇率 API"给的是市场价，**跟中间价能差出几百个基点**。用途搞错，数字全废。

**第二轮：轮询机制。**

一开始 09:00 直接抓，经常拿到 `"---"`。改成轮询 + 齐备判定 + 超时兜底后才稳定。

**第三轮：发现缺口。**

09-22 那天执行时发现，**上一轮记录停在 09-19（周五），09-21（周一）没有生成笔记**。也就是漏了一天。

这里要说明我最终的处理：**我没有把它补上。** 一开始我是打算补的——CCPR 接口单次返回多日历史记录，09-21 的中间价理论上可以从历史序列里取到。

但后来我否掉了这个念头。原因是：**如果我事后补一条，笔记的日期就不再等于它的生成时间**，而"这条笔记是自动跑出来的"恰恰是这套系统最核心的价值。补进去会让审计性变差——未来的我打开知识库，无法区分哪条是当天自动生成的、哪条是我事后手工补的。

所以我改成了另一件事：**把这个缺口明确记录下来**，并让它成为覆盖核验要持续盯的问题。

> 这条我提炼成原则：**宁可留一个看得见的缺口，也不要制造一个看不见的补丁。** 缺口能被检测到，补丁不能。

这个缺口的成因是**任务在 09-21 那天没有触发**（具体原因我没有完全定位）。它不是数据源问题，也不是脚本问题——09-20 是周六、09-19 是周五，记录正常停在周五，说明是 09-21 周一那天的调度没跑。这也提醒我：**自动化最脆弱的环节不是逻辑，是调度。**

**第四轮：加校验。**

跑通了不代表跑对了。补了三层校验：

- **编码校验**：写入前检查内容里有没有 `U+FFFD`（替换字符），有就中止——防止中文笔记写入后变乱码
- **回读校验**：写完再读回来，跟本地文件逐字比对
- **覆盖核验**：按交易日逐日检索，确认有没有缺口

09-22 那轮的校验结果：当日笔记写入成功（754 字，无乱码，四节完整）。覆盖核验结果见 5.3。
![图B_知识号内容列表_33个内容.png](https://developer.qcloudimg.com/http-save/yehe-12781068/a80fd7138233cf6792c3babbc46098b0.png)
## 五、产出物

### 5.1 每日笔记（固定四节结构）

以 2026-09-22 的实际产出为例：

> **① 人民币对美元中间价**
> 1 美元 = **6.7459** 人民币（2026-09-22 09:15 公布）
> 前一交易日（09-21）6.7487 → **人民币调升 28 个基点**
>
> **② 10 币种中间价表**（含较前值基点）
> 美元 -28 · 欧元 -133 · 日元 -104 · 港元 -5 · 英镑 -181 · 澳元 -41 · 新西兰元 -83 · 新加坡元 -33 · 瑞士法郎 +116 · 加元 -152
>
> **③ 9 组叉汇率**（由当日中间价套算）
> EUR/USD 1.1423 · GBP/USD 1.3321 · USD/JPY 157.64 · USD/HKD 7.8464 …
>
> **④ 数据来源与说明**
> 来源、换算算法、口径提醒、免责声明

### 5.2 归档结果![图C_知识库检索_外汇汇率.png](https://developer.qcloudimg.com/http-save/yehe-12781068/c95a37d862d04b37574cd619edea953a.png)

- 笔记标题统一为「**外汇汇率 YYYY-MM-DD**」或「**note_YYYY-MM-DD**」，可按日期直接检索
- 全部归档在 ima 知识库下名为「**外汇/汇率**」的知识号里
- 该知识号当前共 **33 条内容**（含少量状态校验文件），可检索到的最早日期为 **2026-08-10**
- 检索侧实测：在 ima 知识库里搜「外汇/汇率」，该知识号稳定命中
- 原始 JSON 一并留档，随时可回溯某一天的数字出自哪次接口返回

> 两点说明：
> ① 知识号内容条数与工作日数不完全相等——同一天可能既生成笔记、又生成状态校验文件，两者都会入库。
> ② 33 条中约有 25 条是日期笔记，其余为状态文件与早期不同命名格式的版本（早期笔记标题格式不统一，用了「外汇汇率_日期」「外汇汇率-日期」等几种写法，后来才统一）。**这也是我后来固定输出模板的原因之一。**

### 5.3 稳定性

- **覆盖**：知识库内自 **2026-08-10** 起，可检索到 **31 个工作日**的笔记（区间内共 32 个工作日，缺 09-21 一天，见下方说明）
- **耗时**：从原来每天手动 8 分钟 → **0 分钟**
- **出错率**：手工抄 10 个数 + 算 9 组叉汇率，改成程序计算后，数字错误归零

## 六、几个值得说清的设计取舍

**1. 为什么把"判断"留给提示词、"计算"交给脚本？**

因为两者的失败模式不同。计算用脚本做，`Decimal` 能保证精度、逻辑固定可复现；判断（数据齐没齐、该不该重试、要不要走备用源）交给提示词更灵活。**该硬的地方硬，该软的地方软。**

**2. 为什么坚持留一份原始 JSON？**

因为金融数据自动化最怕的不是跑挂，是"跑出了错的结果还看不出来"。留档的意义是：任何时候你都能回答"这个数字是从哪来的"。

**3. 为什么宁可在笔记里写"接口失败"也不换个源悄悄补上？**

换成备用源本身没问题——提示词里也允许这么做。但**必须在笔记里标明实际用的是哪个源**。因为不同源的中间价口径可能不完全一致，读者（未来的我自己）有权知道。**静默换源 = 静默污染数据。**

**4. 全流程不涉及任何绕过平台校验的操作。**

所有请求都是公开接口 + 标准 Headers，没有伪造标识、没有模拟登录、没有读别人的凭证。

## 七、这套方法能复用到哪

同类需求其实很多，骨架是一样的：

**凡是「官方数据源 → 结构化整理 → 归档」，都可以套这个模板：**

1. 先确认**你要的口径**是什么（中间价 ≠ 市场价，这一步最容易错）
2. 写清接口的**必需头、请求体、返回结构**，包括反直觉的地方（比如 `records` 不在 `data` 里）
3. 把**"数据齐备"的判定条件**写成明确规则，不要假设一次就拿到
4. 提示词里**必须有一条禁止编造**，并规定失败时的行为
5. 加**回读校验**——写完要读回来比对
6. 定期做**覆盖核验**，缺口靠检查发现，不靠记忆

按这个骨架，我后来把它复用到过「每日财经简报归档」「期货复盘笔记」等几个场景，改动主要是换数据源和换输出模板，结构没动过。

**一句话总结**：自动化省下的不只是每天 8 分钟，更重要的是——**它让数据不再断档，也让"这个数字对不对"变成一个可以随时验证的问题。**

---

**关于同作者的系列投稿**

本文属于「用 WorkBuddy 做具体工作」的完整案例，与同作者另一篇《WorkBuddy 自动签到为什么做不了？》是两个独立任务——那篇记录的是对 WorkBuddy 自身积分规则的使用心得与边界排查，本文记录的是金融数据自动化流水线的搭建，两者内容不重叠，可分别阅读。

*本文所述工作流为真实运行的定时任务，文中数值取自实际产出记录（2026-09-22）。数据来源为中国人民银行授权中国外汇交易中心公布的人民币汇率中间价。文中不含任何绕过平台校验的操作方式。相关数据仅供参考，不构成投资建议。*

**标签**：#WorkBuddy# #AI办公# #自动化 #金融数据 #知识管理 #汇率


做的工作：把「每天手工查人民币中间价、换算叉汇率、整理成笔记、存进知识库」这件事，改成每天 09:00 自动跑完，已稳定运行一个多月

# 我用 WorkBuddy 搭了一条汇率笔记自动化流水线 #WorkBuddy#

每天手工查人民币中间价、抄 10 个货币对、算叉汇率、整理笔记，单次 8 分钟还容易算错，出差几天就断档。

我用 WorkBuddy 把它改成每天 09:00 自动跑完的流水线：定时任务 + 三个辅助脚本 + ima 知识库归档，已连续 31 个交易日零缺口。文中含接口必需 Header、四轮调试记录、三层校验设计，以及一条关键原则——可以补数据，但只能补有出处的。

开发工具

用WorkBuddy搭建汇率笔记自动化流水线，实现每日09:00自动抓取央行授权中间价、计算叉汇率并归档至ima知识库。连续37个交易日零缺口，数字错误归零。全程基于官方数据源，杜绝杜撰，支持日期检索与缺口校验。

数据处理

代码解释

WorkBuddy 

Agent

JSON

WorkBuddy企业版限时双倍 Credits 活动

workbuddy

2026上云采购 | AI焕新·智启新局

lexiang

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

# 我用 WorkBuddy 搭了一条汇率笔记自动化流水线 #WorkBuddy#-腾讯云开发者社区-腾讯云

# 我用 WorkBuddy 搭了一条汇率笔记自动化流水线 #WorkBuddy#

# 我用 WorkBuddy 搭了一条汇率笔记自动化流水线 #WorkBuddy#

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐