shield_lock
JinDaGe
← Back to skills
extension
Category: OtherAPI key required

PM周报数据同步

将项目经理提交的原始 Excel 周报数据同步到乐荐飞书表格。当项目经理发送周报 Excel 文件、要求更新周收入数据、核对周报数据时激活。

personAuthor: romicboyhubclawhub
open_in_newRepositorydownloadDownload package

PM Weekly Report Update

项目经理周报数据同步技能。

配置文件

目标飞书表格配置存储在 env.vars 下，使用扁平 key：

| 字段 | 说明 | |------|------| | env.vars.pm_feishu_sheet_token | 飞书表格 token | | env.vars.pm_feishu_sheet_sheet_id | Sheet ID | | env.vars.pm_feishu_sheet_url | 完整 URL |

⚠️ 注意：配置系统不支持嵌套格式（如 pm_feishu_sheet.token），写入时会自动拍扁为 pm_feishu_sheet_token。读取时必须使用上述扁平 key。

读取配置（无默认值，配置不存在时为空）：

openclaw config get env.vars.pm_feishu_sheet_token
openclaw config get env.vars.pm_feishu_sheet_sheet_id
openclaw config get env.vars.pm_feishu_sheet_url

写入配置（每次只写一个字段）：

openclaw config set env.vars.pm_feishu_sheet_token "你的token"
openclaw config set env.vars.pm_feishu_sheet_sheet_id "你的sheet_id"
openclaw config set env.vars.pm_feishu_sheet_url "完整URL"

严禁使用覆盖整个 JSON 的方式写入配置。

配置管理流程

流程 1：首次配置（无配置时）

  1. 用户发送飞书表格 URL（如 https://lejian.feishu.cn/wiki/RgS0wyoEdisDOCkXE0icPWBPnoe?sheet=NdGNM7）
  2. 从 URL 解析出 token、sheet_id、完整 url
  3. 逐字段写入配置（每次一个字段）： 
    openclaw config set env.vars.pm_feishu_sheet.token "RgS0wyoEdisDOCkXE0icPWBPnoe"
openclaw config set env.vars.pm_feishu_sheet.sheet_id "NdGNM7"
openclaw config set env.vars.pm_feishu_sheet.url "https://lejian.feishu.cn/wiki/RgS0wyoEdisDOCkXE0icPWBPnoe?sheet=NdGNM7"
  4. 告知用户配置完成，可以继续发送 Excel

流程 2：已有配置时

  1. 调用 openclaw config get env.vars.pm_feishu_sheet.token 读取 token
  2. 配合 sheet_id 和 url 用于后续操作

流程 3：配置更新（用户发送新链接）

如果用户发送了新的飞书表格 URL，视为重新配置提示，重复流程1逐字段更新。

URL 解析规则

飞书表格 URL 格式：

  • Wiki 乐荐格式（带 /wiki/）：https://*.feishu.cn/wiki/TOKEN?sheet=SHEET_ID
    • token = ?sheet= 前面的路径部分（如 RgS0wyoEdisDOCkXE0icPWBPnoe）
    • sheet_id = ?sheet= 后面的部分（如 NdGNM7）
    • url = 原始 URL 整体
  • 标准格式（带 /sheets/）：https://feishu.cn/sheets/shtcnABC123
    • token = 路径最后一段（如 shtcnABC123）
    • sheet_id = 从 URL 中找 sheet= 参数；无则调用 meta 获取第一个 sheet

判断逻辑：

  • 链接含 /wiki/ → Wiki 格式，直接解析 token + sheet_id
  • 链接含 /sheets/ → 标准格式，token 取路径最后一段，sheet_id 从参数读或调用 meta
  • 既无 /wiki/ 也无 /sheets/ → 视为 token，sheet_id 待指定

安装后引导 ⚠️

本技能依赖 lejian-feishu-sheet（飞书电子表格操作技能），必须先安装并配置才能正常工作。

前置条件

  1. 安装依赖技能（如果尚未安装）：

    openclaw skills install lejian-feishu-sheet

  2. 飞书应用权限：你需要有一个乐荐的飞书应用，该应用需要开通「电子表格」编辑权限（sheets:spreadsheet），并将此飞书表格分享给该应用（编辑权限）。

  3. 配置飞书凭证：

    openclaw config set channels.feishu.appId "你的appId"
openclaw config set channels.feishu.appSecret "你的appSecret"

  4. 如需重置本技能配置（只清除乐荐飞书表格配置，保留其他 env.vars）：

    openclaw config unset env.vars.pm_feishu_sheet_token
openclaw config unset env.vars.pm_feishu_sheet_sheet_id
openclaw config unset env.vars.pm_feishu_sheet_url

    ⚠️ 不要使用 openclaw config unset env.vars（会清除所有 env.vars，影响其他技能）。

首次配置

配置完成后，发一次飞书表格链接（如 https://lejian.feishu.cn/wiki/RgS0wyoEdisDOCkXE0icPWBPnoe?sheet=NdGNM7），技能会自动解析并保存。

字段枚举与映射关系

Excel 列定义

| Excel列索引 | Python变量名 | 飞书列对应 | 说明 | |------------|------------|----------|------| | B（第1索引） | channel_name | 对应飞书G列 | 客户名称（规则2使用） | | C（第2索引） | ops_channel_name | 对应飞书X列（重要！） | OPS渠道单位名称（规则1使用） | | F（第5索引） | pe | 对应飞书E列 | 项目经理 | | H（第7索引） | supply_price | — | 渠道供货价（要同步的周收入） |

飞书表格列定义

| 飞书列 | 列名 | 说明 | |--------|------|------| | B | 区域 | | | C | 总监 | | | D | 销售 | | | E | PM（项目经理） | 匹配 Excel pe | | F | 项目唯一标识 | | | G | 项目名称 | 匹配 Excel channel_name | | X | OPS渠道单位名称 | 匹配 Excel ops_channel_name（规则1） | | CS~CW | 周收入列 | 第1-5周数据 |

⚠️ 关键映射：

  • Excel ops_channel_name（C列）→ 飞书 X列（不是G列）
  • Excel channel_name（B列）→ 飞书 G列（规则2使用）

匹配字段速查

| 规则 | Excel字段 | 飞书字段 | 优先级 | |------|----------|---------|--------| | 规则1 | ops_channel_name（C列） | X列 | 最高 | | 规则2 | channel_name（B列）+ pe（F列） | G列 + E列 | 降级 |

飞书表格结构

| 飞书列 | 内容 | 说明 | |--------|------|------| | B | 区域 | | | C | 总监 | | | D | 销售 | | | E | PM（项目经理） | ← 匹配 Excel F列 | | F | 项目唯一标识 | | | G | 项目名称 | ← 匹配 Excel B列 | | X | OPS渠道单位名称 | ← 匹配 Excel C列（重要！） | | CS | 第1周（4/1-4/5） | | | CT | 第2周（4/6-4/12） | | | CU | 第3周（4/13-4/19） | | | CV | 第4周（4/20-4/26） | | | CW | 第5周（4/27-4/30） | |

数据从第3行开始。第2行是表头。

匹配规则

详见 references/match-rules.md。

优先级：

  1. 规则1（最高）：Excel ops_channel_name（C列）== 飞书 X列（OPS渠道单位名称）→ 直接命中
  2. 规则2（降级）：channel_name + pe 联合定位飞书 G列+E列，按 2.1精确 → 2.2前缀剥离 → 2.3双向包含 依次尝试

别名支持： 系统支持项目别名映射，例如 享道出行/赛可出行 → 享道汽车。别名在所有规则中均生效。

匹配失败处理： 规则1失败 → 降级规则2；规则2某一子级失败 → 降级下一级；全部失败 → 报错

报错信息： 未找到项目 [channel_name] + PM [pe] 的行，请确认该项目的周报已添加到此表格

原始 Excel 格式

Sheet 名：UUID 风格（如 d2721d4c-95a5-4d8c-bc12-668050f）

| 列索引 | Python变量名 | 列名 | 说明 | |--------|------------|------|------| | B（第1索引） | channel_name | 客户名称 | 规则2使用 | | C（第2索引） | ops_channel_name | OPS渠道单位名称 | 规则1匹配字段（最高优先级） | | F（第5索引） | pe | 项目经理 | 匹配飞书E列 | | H（第7索引） | supply_price | 渠道供货价 | = 要同步的周收入 |

⚠️ openpyxl 的 row 数组是 0-based 索引（Python list）：A=index0, B=index1, ..., H=index7

同步流程

第一步：检查配置

调用 openclaw config get env.vars.pm_feishu_sheet.token 读取配置。

  • 有配置 → 继续
  • 无配置 → 请用户发送飞书表格 URL，完成配置后继续

第二步：解析文件名判断周次

文件名格式：xxx_2026_0420-0426---uuid.xlsx

| 日期区间（MMDD） | 对应列 | |----------|--------| | 0401-0405 | CS | | 0406-0412 | CT | | 0413-0419 | CU | | 0420-0426 | CV | | 0427-0430 | CW |

从文件名提取 MMDD-MMDD 区间，匹配上表确定目标列。

第三步：读取 Excel 数据

读取 Sheet 1，从第2行起，提取：

  • channel_name（B列）
  • ops_channel_name（C列）
  • pe（F列）
  • supply_price（H列）

第四步：匹配项目行

按 references/match-rules.md 中的规则依次尝试匹配：

  1. 规则1：Excel ops_channel_name（C列） == 飞书 X列（最高优先级）
  2. 规则2：channel_name + pe 联合定位飞书 G列+E列（2.1精确 → 2.2前缀剥离 → 2.3双向包含）

全部失败 → 报错。

第五步：写入飞书表格

使用 lejian-feishu-sheet 的 write 命令，token/sheet_id 从配置读取：

TOKEN=$(openclaw config get env.vars.pm_feishu_sheet.token)
SHEET_ID=$(openclaw config get env.vars.pm_feishu_sheet.sheet_id)
OPENCLAW_CONFIG=~/workspace/agent/openclaw.json \
~/workspace/agent/skills/lejian-feishu-sheet/scripts/feishu-sheet.sh \
write "$TOKEN" "${SHEET_ID}!CV5:CV5" '[[159468.66]]'

输出格式要求

执行结果输出（JSON）

脚本执行后输出结构化 JSON，包含以下字段：

{
  "week_col": "CV",        // 本次更新的周次列
  "updates": [             // 成功匹配的记录列表（包含写入和跳过）
    {
      "channel": "某科技公司",           // Excel channel_name（B列）
      "ops_channel_name": "2026某科技公司", // Excel OPS渠道单位名称（C列）
      "pe": "张三",               // PM（项目经理）
      "row": 17,                    // 飞书表格目标行号
      "col": "CV",                  // 周次列
      "value": 35792,               // 本次写入的供货价
      "rule": "规则1",              // 命中的匹配规则
      "status": "ok"                // 状态：ok=成功写入, skipped=跳过
    }
  ],
  "errors": [              // 匹配失败的记录列表
    "未找到项目 [某渠道]（2025某渠道名）+ PM [李四] 的行"
  ]
}

输出要求：

  1. week_col 必须标注本次更新的周次列（如 CV=第4周）
  2. updates 中的每条记录必须包含：channel、ops_channel_name、pe、row、col、value、rule
  3. errors 中每条错误信息必须包含：项目名（channel_name）、OPS渠道单位名称（ops_channel_name）和 PM
  4. 匹配规则名称需标准化：规则1、规则2.1、规则2.2、规则2.3

错误处理

| 情况 | 处理 | |------|------| | 无飞书表格配置 | 请用户发送飞书表格 URL，分析后写入配置 | | 文件名无法解析周次 | 报错：「无法识别文件名中的日期，请确认格式如 xxx_2026_0420-0426---uuid.xlsx」 | | 项目行未找到 | 报错：「未找到项目 [某公司] + PM [某PM] 的行，请确认该项目的周报已添加到此表格」 | | 渠道供货价为0或空 | 跳过该行（不写入），并在结果中说明「[某公司] 无渠道供货价数据（0），已跳过」 | | 找到多个匹配行 | 报错：「匹配到多行，请检查数据：[行号1] [行号2]」 |

注意事项

  • 每次只更新已有行，不新建行
  • 有任何一行匹配失败，整体报错，不部分更新
  • 使用乐荐飞书凭证（channels.feishu.appId / channels.feishu.appSecret）
  • 写入前展示将要更新的内容，确认后执行