# 2026-04-10 工作日志

## 修复：内容测试问题反馈群同步脚本

**来源：** [李若松] 反馈文档未正常更新

### 问题根因
脚本 `scripts/sync_feedback_group_to_wiki.sh` 存在多个bug导致每次执行都失败但静默退出：

1. **凭证错误**：使用了 `xiaoyan`（小研）的 Bot 凭证，但 xiaoyan Bot 不在群里，API 返回 `230002: Bot can NOT be out of the chat`
2. **CLI 参数名错误**：`--start-time`/`--end-time` 实际应为 `--start`/`--end`（lark-cli flag 不存在导致直接报错）
3. **时间格式错误**：传了毫秒时间戳，实际需要 ISO 8601 格式
4. **sort 参数值错误**：`create_time_desc` 应为 `desc`
5. **图片下载路径问题**：lark-cli `--output` 不支持绝对路径，必须用相对路径
6. **图片无法在文档中展示**：原脚本只下载到本地路径，未使用 `docs +media-insert` 上传到文档

### 修复方案
- 改用 `xiaokui` Bot 凭证（小葵已在群中）
- 修正所有 CLI 参数名和格式
- 图片先下载到工作目录（相对路径），再用 `docs +media-insert` 插入文档
- 去掉 `set -e`，改为手动错误处理避免单条消息失败导致整个脚本退出
- 时间用 ISO 8601 格式存储和传递

### 验证结果（第一版 → Wiki文档）
- 全量同步成功：49 条消息 + 5 张图片写入 Wiki 文档
- Wiki文档：DfUqddItXoDsnNxPypncbinknxh

## 迭代：改为电子表格 + 腾讯COS

**来源：** [李若松] 要求改用表格存储，媒体文件上传COS

### 方案
- 脚本改为 Python：`scripts/sync_feedback_group.py`
- 记录写入飞书电子表格：`E8vFsCmPBhT4SCtNmnJchqeJnJe`，sheet_id `7bce8f`
- 列：时间 | 反馈人 | 信息类型 | 信息内容(或地址)
- 非文本消息（图片/视频/音频/文件）下载后上传到腾讯COS
- COS桶：`static-1317843270`，区域：`ap-beijing`
- COS路径结构：`vala_llm/user_feedback/{type}/{date}/{filename}`
  - type: image / video / audio / file
  - date: YYYY-MM-DD
- 访问域名：`https://static.valavala.com/vala_llm/user_feedback/...`
- COS凭证已存入 `secrets.md`

### 验证结果
- 全量同步成功：47条记录写入表格，5张图片+4个视频上传COS
- crontab 每小时整点自动执行：`0 * * * *`
- 群ID：oc_fabff7672e62a9ced7b326ee4a286c26

## 封装两个通用Skill

**来源：** [李若松] 要求将功能封装为可复用skill

### 1. tencent-cos-upload
- 路径：`/root/.openclaw/skills/tencent-cos-upload/`
- 功能：上传文件到腾讯COS并生成可访问URL
- 提供命令行调用和Python模块两种方式
- 核心文件：`scripts/cos_upload.py`（CosUploader类）

### 2. feishu-group-msg-sync
- 路径：`/root/.openclaw/skills/feishu-group-msg-sync/`
- 功能：定期同步飞书群聊消息到电子表格，媒体上传COS
- 依赖 tencent-cos-upload skill
- 核心文件：`scripts/sync_group_to_sheet.py`（模板脚本，修改顶部配置即可复用）
- 参考文件：`references/lark-cli-cheatsheet.md`

### 项目脚本也改为引用skill
- `scripts/sync_feedback_group.py` 现在只做配置覆盖，逻辑全部引用自skill
