Feishu File Renamer

批量恢复和重命名飞书机器人下载的哈希文件名，支持群聊、云文档及多维表格映射，自动冲突处理和日志记录。

📁 feishu-file-renamer - 飞书文件重命名助手

🎯 功能

解决飞书机器人下载文件时文件名变成哈希值的问题。

核心功能

• 📁 原始文件名恢复 - 从消息元数据提取原名
• 📦 批量重命名 - 一次处理上百个文件
• 🤖 飞书集成 - 消息/群聊/云文档支持
• 📊 多维表格联动 - 从表格读取映射关系
• ⚡ 智能冲突处理 - 自动添加序号
• 📝 重命名日志 - 详细统计和错误报告

🚀 使用方法

命令触发

/rename-file
/feishu-rename
/restore-filename

自然语言触发

重命名文件
恢复文件名
飞书文件
哈希文件名
批量重命名

高级用法

# 单文件
claw skill run feishu-file-renamer \
  --file "/tmp/img_v3_xxx.png" \
  --name "产品图.png"

# 批量（从消息）
claw skill run feishu-file-renamer \
  --message-id "om_x100b520xxx" \
  --output-dir "/tmp/renamed"

# 多维表格
claw skill run feishu-file-renamer \
  --bitable "APP_TOKEN" \
  --table "TABLE_ID"

📋 输出示例

重命名完成

### ✅ 文件重命名完成

**统计结果：**
- ✅ 成功：48
- ❌ 失败：2
- ⏭️  跳过：0

**重命名日志：** /tmp/rename_log.md

使用方法（无文件时）

### 📁 飞书文件重命名助手

**使用方法：**

方式 1：单文件重命名
claw skill run feishu-file-renamer \
  --file "/tmp/img_v3_xxx.png" \
  --name "产品图.png"

方式 2：批量重命名
claw skill run feishu-file-renamer \
  --message-id "om_x100b520xxx" \
  --output-dir "/tmp/renamed"

⚙️ 配置

支持场景

场景	支持	说明
飞书私信	✅	完全支持
飞书群聊	✅	完全支持
云文档附件	✅	完全支持
多维表格	✅	完全支持

文件限制

• 大小：< 100MB
• 数量：无限制
• 格式：所有格式

🔧 技术原理

文件名恢复

// 从消息解析：[img_v3_xxx.png](产品图.png)
function extractFileMappings(message: string): FileMapping[] {
  // 正则匹配飞书文件链接格式
  const pattern = /\[(img_v3_[^\]]+)\]\(([^\)]+)\)/g;
  // 提取哈希文件名和原始文件名
}

冲突处理

// 产品图.png 已存在 → 产品图_1.png
let counter = 1;
while (existsSync(finalPath)) {
  finalPath = `${baseName}_${counter}${ext}`;
  counter++;
}

📝 使用场景

1. 群聊文件整理 - 恢复下载的产品图
2. 电商上架 - 批量重命名后上传
3. 设计稿归档 - 按项目分类重命名
4. 文档管理 - 恢复云文档附件原名

🐛 常见问题

Q: 支持表情包吗？
A: 不支持，飞书 API 限制。

Q: 文件大小限制？
A: 建议 100MB 以内。

Q: 支持子文件夹吗？
A: 支持，使用 --recursive。

Q: 如何恢复原名？
A: 查看重命名日志。

📊 性能指标

文件数	手动	Skill	提升
10	5 分钟	3 秒	100x
50	25 分钟	8 秒	187x
100	50 分钟	15 秒	200x

📄 许可证

MIT License

🔗 相关链接

• OpenClaw 文档
• ClawHub
• GitHub 仓库

---

作者： 郑宇航
版本： 1.0.0
最后更新： 2026-04-06