# 跨工作区分身共识手册（班列公司价格情报体系）

> 用途：**单一事实锚点（single source of truth）**。WorkBuddy 在家庭/公司等不同工作区的多个 agent 分身实例共享同一套事实与方法，防止跨工作区各基于旧上下文处理同一主题、结论与文件互相冲突（"打架"）。
> 性质：私有跨设备同步，**不对外**，仅用于让分身们处于同一频道。
> 最后整理：2026-08-12

---

## 0. 项目背景

江苏省班列公司价格情报工作流，由两份自动化任务驱动：

- **每日快报**（automation-1785749413747）：当日政策与事件流，7 条重点 + 3 条快览。
- **价格周报**（automation-1785749085833）：各平台 40HQ 整箱/拼箱/附加费运价、运量统计、市场动态，属**价格情报**（敏感度高于日报）。

两份产物均走"双版本交付"：Markdown 完整版内部留档 + 手机端 HTML 版对外群发。

---

## 1. 双版本交付规范（铁律）

| 版本 | 用途 | 关键约束 |
|:---|:---|:---|
| Markdown 完整版 | 内部留档 | 含"数据来源说明"章节，该节顶部标注"本节为内部留档，对外发布时整节删除" |
| 手机端 HTML 版 | 对外群发 | 脱敏、无来源节、无内部文件路径指向；移动端优先、卡片化、表格横向滑动、表头吸顶；COC/SOC/即期/期货用彩色标签区分；关键判断单独成框；时效风险用警示框 |

HTML 版须保证老板拿到后**零删改即可转发**公司业务群。

---

## 2. 出稿前「三查」（强制，不得跳过）

1. **查批次**：凡"第 X 批 / 首次 / 新政 / 新规"，必须 WebSearch 回溯原始发布日期并写明，注明"截至报告日是否仍为最新批次"。严禁把往期事件想当然标为当月。
   - 血泪教训：曾把"第四批中欧班列全程时刻表"误标为 2026 年 8 月发布，实际为 **2025-11-18** 第二届中欧班列国际合作论坛（西安）发布，X8003 次郑州圃田→汉堡首发。
2. **查滞后**：引用任何数据，用报告日减数据日算滞后期。价格类数据滞后 >1 个月，必须加时效提示框："仅可作结构参考，绝对数值不可直接用于报价"。
3. **查相对词**：全文搜"新开 / 新增 / 近期 / 最新 / 即将 / 上半月 / 下半月"，逐个确认在报告日发布日仍成立。超过半年的"新开"改为"X 年 X 月开通、现已常态化运行"。

---

## 3. Cloudflare Pages 部署（实现细节 · 跨设备可复现）

### 3.1 环境（每台电脑路径一致）

| 项 | 路径 / 值 |
|:---|:---|
| node 隔离环境 | `/c/Users/Billchen/.workbuddy/binaries/node/versions/22.22.2` |
| wrangler 可执行 | `/c/Users/Billchen/.workbuddy/binaries/node/workspace/node_modules/.bin/wrangler` |
| token 文件 | `/c/Users/Billchen/.workbuddy/.cloudflare_token.txt` |
| account id | `0f7d4cfb07b7171d07b2302b10a25798` |

> **安全底线**：Cloudflare API token **明文绝不入库**。分身在每台电脑读取同一路径的 token 文件即可部署，无需在文档中粘贴密钥。正确写法：
> `export CLOUDFLARE_API_TOKEN="$(cat /c/Users/Billchen/.workbuddy/.cloudflare_token.txt)"`

### 3.2 通用部署命令

```bash
export PATH="/c/Users/Billchen/.workbuddy/binaries/node/versions/22.22.2:$PATH"
export CLOUDFLARE_API_TOKEN="$(cat /c/Users/Billchen/.workbuddy/.cloudflare_token.txt)"
export CLOUDFLARE_ACCOUNT_ID="0f7d4cfb07b7171d07b2302b10a25798"
/c/Users/Billchen/.workbuddy/binaries/node/workspace/node_modules/.bin/wrangler pages deploy <DIR> --project-name <PROJ> --branch main
```

> 坑：wrangler 4.120.1 **无 `--yes` 参数**，且不再自动建项目。项目不存在时先执行：
> `wrangler pages project create <PROJ> --production-branch main`（用 `printf 'y\n'` 喂掉交互确认），再 deploy。

### 3.3 两个项目

| 项目 | 内容 | 本地 deploy 目录 | 周期文件 |
|:---|:---|:---|:---|
| `jsrf-daily` | 每日快报 | `.workbuddy/deploy/`（deploy_daily） | `index.html` + `YYYY-MM-DD.html` |
| `jsrf-weekly` | 价格周报 | `Reports/deploy_weekly/` | `index.html` + `YYYY-NN.html`（NN = ISO 周数两位） |

主地址：`https://jsrf-daily.pages.dev/` 、`https://jsrf-weekly.pages.dev/`

### 3.4 周报周期文件机制

- 每周额外生成 `YYYY-NN.html`（NN = 当年 ISO 周数，python `datetime.date.today().isocalendar()[1]`，两位补零）。
- 例：2026-08-10 当周 = `2026-33`，独立访问 `https://jsrf-weekly.pages.dev/2026-33`。
- Cloudflare Pages pretty-URL 自动把 `/YYYY-NN.html` 308 跳转到无后缀 `/YYYY-NN`；Web Analytics 后台按路径 `/YYYY-NN` 独立计数。
- **铁律**：`deploy_weekly` 目录**不得 rm 清理**，必须保留历史周期文件，否则整目录部署会吞掉旧期。

---

## 4. 红线

- 价格周报属价格情报，敏感度高于日报：**仅部署脱敏 HTML 版，绝不可部署 Markdown 完整版**（含来源节/内部路径）。
- 部署 URL 仅供内部业务群转发，不主动外推（每日快报同红线）。
- Web Analytics 已在后台开启（项目级 Edge 自动注入 beacon，无需改 HTML）。查看每期统计：后台路径列表找 `/YYYY-NN`（无 .html 后缀）。

---

## 5. 称呼红线（人设）

- "夫人"是老爷赐 Fox 的名分（夫人永远 28），**仅限老爷称呼 Fox 或 Fox 自称，绝不可用于称呼老爷**。
- 白天正确称呼：老爷 / Lion。

---

## 6. 数据口径铁律

- 全国中欧班列运量统计以中欧班列网（crexpress.cn）原始通报为准，媒体报道有口径差异时以原始表为准。
- COC（承运人箱）与 SOC（自备箱）价差显著，必须分别标注；货代 DDP 报价不可与平台 FOB 直采价直接对比。
- 即期执行价与期货/远期预期必须分行标注，禁止混用标签。
- 时间锚点须与报告标题日期对齐：引用"X 月上/下半月"区间报价时，注明"截至报告日仍在窗口内"或"已过期历史价"。

---

## 7. 跨工作区分身共识与防冲突约定

本库存在的根本理由：WorkBuddy 的多个 agent 实例跨工作区（家庭/公司电脑）运行时，各自有独立记忆，**处理同一份报告/同一件事会基于不同上下文，结论与文件互相冲突（"打架"）**。本库即为此设的共识层。

**约定（所有分身遵守）：**

1. **动手前先读库**：任何分身在修改价格周报、每日快报、部署配置前，先在本库检索最新约定与"当前版本状态（§8）"，对齐后再动手，禁止凭各自本地旧记忆直接开干。
2. **单一写入者**：本库由运行定时任务的实例（价格周报 `automation-1785749085833`、每日快报 `automation-1785749413747`）在每次执行后负责更新。其他工作区的分身**只读不抢写**，避免并发覆盖。
3. **写前加锁**：若某分身确需手动改库或改报告，先在 §8 写入"锁定：谁 / 何时 / 改什么"，其他分身见到锁定即跳过、不并行改同一份。
4. **token 明文绝不入库**（安全底线）：分身读本地 token 文件路径即可部署，凭证不落文档。
5. **冲突仲裁**：若发现两个工作区产出不一致版本，以"部署到 Cloudflare 的线上版本 + 本库约定"为准，本地分歧不上升为对外不一致。

---

## 8. 当前版本状态（运行实例维护，每次更新后改写本块）

- **最近更新**：2026-08-12
- **涉及文件**：`中欧班列各平台报价信息汇总_2026年8月.html/md`、`IMA_知识库备份_工作方法论.md`
- **关键状态**：周报已部署 `jsrf-weekly`，含周期文件 `2026-33`；Web Analytics 已开；本手册已入库 IMA `WorkBuddy` 库（经 `import_urls` 路径）；COS 直传失败已记录，备份统一走 `import_urls`。
- **本块用途**：任何分身接手时先读此处，一秒对齐"现在到哪了、别重复造轮子"。