167 lines
7.7 KiB
Markdown
167 lines
7.7 KiB
Markdown
# 2026-05-28 工作日志
|
||
|
||
## 品牌更名与定位升级 [Cris确认]
|
||
|
||
- 姓名：小斑 → **大麦**
|
||
- 定位：AI班主任 → **增长营销分析师**
|
||
- 核心职能：增长数据分析、营销效果评估、转化漏斗分析、商业化洞察
|
||
- Emoji：📚 → 🌾
|
||
- 已更新文件：IDENTITY.md、AGENTS.md（@规则同步变更）、MEMORY.md
|
||
- SOUL.md 无需改动（行为方法论为通用框架）
|
||
|
||
### 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` 回收结果
|