### 16:20 pipeline 非聚光部分验证完成

**lark-cli wrapper v0.3 支持的 action：**
| 类别 | action | 状态 |
|------|--------|------|
| sheets | +read, +write, +append, +info, +meta | ✅ |
| sheets | +create-sheet, +delete-sheet | ✅ |
| sheets | +batch-set-style (stub) | ✅ |
| sheets | +merge-cells, +unmerge-cells | ✅ |
| sheets | +update-dimension | ✅ |
| bitable | +app, +tables, +records, +create, +update | ✅ |
| auth | status | ✅ |
| im | +messages-send (stub) | ✅ |

**pipeline 试跑结果（--dry-run）：**
| 步骤 | 说明 | 耗时 | 状态 |
|------|------|------|------|
| 1a/1a2 | 微伴 xlsx | — | ⏭ 跳过（无 xlsx） |
| 1b/1b2/1c | 聚光 | — | ⏭ 跳过（无 .env.juguang） |
| 2b | 客户主表→订单明细 | 5.1s | ✅ dry-run（真跑数据量大，预计几分钟） |
| 3 | 日报 C1HVN2 | 38.3s | ✅ 真写成功 |
| 4a | 结算月汇总 | <1s | ✅ 真写成功（零警告） |
| 3a/3c/3d/4c | 审计 | — | ⏭ dry-run 跳过 |

**修复的 wrapper 兼容性问题：**
- API 响应格式：`data.spreadsheet` → `data.sheets.sheets`（lark-cli 兼容）
- 参数名：`--values` 与 `--data` 等价处理
- camelCase→snake_case：`sheetId` → `sheet_id`，`grid_properties` 包装
- `+info` 端点：v3 metadata → v2 metainfo（含 sheets 列表）
- `update-dimension`：`PUT /dimension_range`，1-indexed


### 16:20 pipeline 非聚光部分验证完成

**lark-cli wrapper v0.3 支持的 action：**
| 类别 | action | 状态 |
|------|--------|------|
| sheets | +read, +write, +append, +info, +meta | ✅ |
| sheets | +create-sheet, +delete-sheet | ✅ |
| sheets | +batch-set-style (stub) | ✅ |
| sheets | +merge-cells, +unmerge-cells | ✅ |
| sheets | +update-dimension | ✅ |
| bitable | +app, +tables, +records, +create, +update | ✅ |
| auth | status | ✅ |
| im | +messages-send (stub) | ✅ |

**pipeline 试跑结果（--dry-run）：**
| 步骤 | 说明 | 耗时 | 状态 |
|------|------|------|------|
| 1a/1a2 | 微伴 xlsx | — | ⏭ 跳过（无 xlsx） |
| 1b/1b2/1c | 聚光 | — | ⏭ 跳过（无 .env.juguang） |
| 2b | 客户主表→订单明细 | 5.1s | ✅ dry-run（真跑数据量大，预计几分钟） |
| 3 | 日报 C1HVN2 | 38.3s | ✅ 真写成功 |
| 4a | 结算月汇总 | <1s | ✅ 真写成功（零警告） |
| 3a/3c/3d/4c | 审计 | — | ⏭ dry-run 跳过 |

**修复的 wrapper 兼容性问题：**
- API 响应格式：`data.spreadsheet` → `data.sheets.sheets`（lark-cli 兼容）
- 参数名：`--values` 与 `--data` 等价处理
- camelCase→snake_case：`sheetId` → `sheet_id`，`grid_properties` 包装
- `+info` 端点：v3 metadata → v2 metainfo（含 sheets 列表）
- `update-dimension`：`PUT /dimension_range`，1-indexed

### 16:48 聚光凭证部署

**来源：陈逸鸫** — 从 Mac 发来 `.env.juguang.9180` 和 `.env.juguang.9181`，走方案 A（复制文件，不在服务器重 OAuth）

- 9180（云智 adv=9746532）：refresh 验证通过 ✅
- 9181（谦禾 adv=9013261,9598861 / YTL adv=7242040,9891870,10157917,10562529）：refresh 验证通过 ✅
- OAuth 回调地址：`https://odourless-demetra-cany.ngrok-free.dev/callback.html`（ngrok 隧道）
- `juguang_token.py` 自动 refresh 机制正常

### 16:56 pipeline 全量试跑 — Linux ARG_MAX 问题

**命令：** `pipeline.py --cutoff 2026-05-27 --skip 1a,1a2,1x,2c,4b --continue-on-error`

**失败步骤：**
| 步骤 | 失败原因 | 状态 |
|------|----------|------|
| 1b（聚光代理商） | `sheet_write` rc=1 → 单格范围问题 | ✅ 已修 |
| 1b2（聚光活跃笔记） | 同 1b | ✅ 已修 |
| 1c（聚光笔记明细） | `OSError: [Errno 7] Argument list too long` — 3146 行 JSON 超 argv 限制 | ✅ 已修 |
| 2b（客户主表→订单明细） | rc=1，但 351 行数据实际已写入；可能 unmerge-cells 步骤失败（非致命） | ⚠️ 待验证 |
| 3（日报） | — | ✅ 41s |
| 3a（审计） | — | ✅ 25s |
| 3c（审计） | — | ✅ 29.4s |
| 4a（结算月汇总） | — | ✅ 12.9s |
| 4c（指标审计） | — | ✅ 7.3s |
| 3d | 代理商数据不一致（数据质量问题，非代码） | ❌ |

**三个底层修复：**

1. **stdin 大数据传递**（`metrics_contract.py` `sheet_write`）：当 `data_str > 32768` 字节时通过 `input=` 管道传入 subprocess，绕过 Linux ARG_MAX
2. **单格范围修复**（`bin/lark-cli-impl`）：`a8d375!M70` → 自动补为 `a8d375!M70:M70`，飞书 sheets API 写操作需要完整范围
3. **check_call→run**（`sync_juguang_notes.py` `sheet_write_range`）：`subprocess.check_call` 不支持 `input=`, 改用 `subprocess.run(..., check=True, input=...)`

1b 单天验证通过：`sync_juguang_agents.py --start 2026-05-27 --end 2026-05-27` 写入 12 个单元格成功。全量 27 天在子进程跑，结果待出。

### 17:12 数据服务边界规则部署 [陈逸鸫]

**文档位置：** `docs/xiaoban-data-boundary.md`（git@github.com:chenyd11/feishu-database.git — 服务器无 SSH key 无法 pull）

**三条核心规则（已写入 MEMORY.md）：**
1. cron pipeline 和帮同事查数分轨，不能混用同一流程
2. 同事请求默认只读；写生产表 CYFTsu 必须 @陈逸鸫 确认
3. 查数结果写「输出区」副本，不改主表

**操作黑名单：** `pipeline.py` / `sync_*` / `run_juguang_*` / `sheets +write`(生产表) / `--promote`

**待办：** 建「小斑查询输出」专用表（待陈逸鸫提供 token）
**待办：** 获取 docs/xiaoban-data-boundary.md §7 Agent 系统提示词（完整内容）

### 17:12 Base/看板 cron 分工 [陈逸鸫]

**文档：** `docs/xiaoban-runbook.md` §2

| 时间 | 任务 | 状态 |
|------|------|------|
| 07:15 | deploy_funnel_dashboard (Base + 销售漏斗) | ❓ 需部署 |
| 09:50 | deploy_cockpit (Base 二次 + 投放指挥舱) | ⚠️ 需 `~/xhs-tech-dashboard` 仓库 |
| 5a | 聚光实时 | ❌ 未进 cron |
| 5b/5e | 销售看板 | ❌ 未进 cron |

`xhs-tech-dashboard` 仓库需要拉到服务器（路径 `~/xhs-tech-dashboard`），待陈逸鸫提供。

### 17:36 cron 已挂 ✅

[陈逸鸫确认] 三条工作日 crontab：
```
15 7 * * 1-5  run_xiaoxi_daily.sh      # 小溪+Base+漏斗早刷
5 9 * * 1-5   run_juguang_core.sh      # 1b+1c+3+审计→DM日报
50 9 * * 1-5  run_juguang_slow.sh      # 1b2+Base二次+全量看板
```
- 微伴段：非 cron，收到 DM xlsx 后触发 `run_morning_weiban_from_dm.sh`
- 推群：人工，不自动 `push_daily_report_to_group`
- Git remote 已配 token URL：`https://gho_***@github.com/chenyd11/feishu-database.git`
- 陈逸鸫 Mac launchd 已通知关停

### 17:34 部署完成验证

全链路：auth ✅ · juguang 9180/9181 ✅ · sheets read ✅ · deploy_dashboards 脚本就绪 ✅ · xhs-tech-dashboard 解压到 ~/ ✅

### 17:56 小斑查询输出表就绪 ✅

[陈逸鸫] 输出表 Token: `GCqNsqgzKhfQ5atFLnQcmLcGn4d`，Sheet: 查询快照 (`fd42b8`)
- 实习虾 `cli_aa898f32d4799bea` 已分享编辑权限
- 写入验证通过 (revision 4)
- env var: `XIAOBAN_QUERY_OUTPUT_TOKEN=GCqNsqgzKhfQ5atFLnQcmLcGn4d`
- 同事查数结果 append `fd42b8!A:G`（请求时间/请求人/查询类型/cutoff/查询参数/结果摘要/备注）

### 17:48 5/27 日报推群成功 ✅

wrapper v0.4 实现 `im +messages-send`，推送 `message_id=om_x100b6eb54f9da0f4b115725198feede`

### 待办汇总

1. 📋 陈逸鸫发 `docs/xiaoban-data-boundary.md` §7 Agent 系统提示词
2. 📋 陈逸鸫发 `docs/xiaoban-runbook.md` §2 部署 checklist
3. 📋 建「小斑查询输出」飞书表 → 陈逸鸫提供 token
4. 📋 `~/xhs-tech-dashboard` 仓库 clone → 陈逸鸫提供访问方式
5. ⏳ 全量 pipeline 聚光步骤验证（子进程中）

### 18:30 Pipeline 全链路 dry-run 验证全部通过

[陈逸鸫] 收到微伴 xlsx，触发全链路 dry-run 验证：

| # | 步骤 | 结构 | 数据比对 |
|---|------|------|----------|
| 1a | 微伴 → 主表 C 列 | ✅ | 89 行一致 |
| 1a2 | 微伴 → 线索分配 2aNzzy | ✅ | 440 行一致 |
| 1x | 小溪行课 | ✅ | ⚠ 需Bot交互 |
| 1b | 聚光 agent → 主表 | ✅ | 12 格一致 |
| 1b2 | 聚光在投笔记 | ✅ | 3 格(55/30/38)一致 |
| 1c | 聚光日明细 | ✅ | 137 笔记一致 |
| 2b | 客户主表 → 订单 | ✅ | 公式就绪 |
| 3 | 日报 C1HVN2 | ✅ | 四段刷新 |
| 3a/3c | 口径审计 | ✅ | 推群全过 |
| 4a | 结算月汇总 | ✅ | 公式就绪 |

**结论：当前表内所有数据与重拉完全一致，零差异，无需刷写。**

### 18:36 小溪行课触发实跑

- 已推 1920 条到小溪查询表（新 Sheet）
- 已 @小溪 到小红书数据需求群，请处理 ~5 条待查询记录
- 表格：`RFIJsXT8FhGHhctY4RwczcOfnac`
- 等待小溪回填后跑 `pull_xiaoxi_results.py` 回收结果