Feishu Bitable 任务管理器 - 自动化读写飞书多维表格任务，兼容架构约定

feishu-bitable-task-manager by httprunner/skills

75 周安装量

GitHub

安装命令

npx skills add https://github.com/httprunner/skills --skill feishu-bitable-task-manager

办公软件团队协作自动化

🇨🇳中文介绍

Feishu Bitable 任务管理器

使用此技能可在 Feishu Bitable 的“任务状态表”中读写任务，同时保持与其架构约定的兼容性。

路径约定

规范的安装和执行目录：~/.agents/skills/feishu-bitable-task-manager/。请从此目录运行命令：

cd ~/.agents/skills/feishu-bitable-task-manager

一次性执行（在脚本/循环中，可从任何工作目录安全运行）：

(cd ~/.agents/skills/feishu-bitable-task-manager && npx tsx scripts/bitable_task.ts --help)

快速开始

运行：

npx tsx scripts/bitable_task.ts <子命令> [标志]

必需的环境变量

FEISHU_APP_ID, FEISHU_APP_SECRET

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

关键默认值（兼容性规则）

将日期预设值视为字面字符串：Today、Yesterday、Any（Any 表示无日期约束）。
尽可能优先通过 --task-id / --biz-task-id 获取（这会覆盖 --app/--scene/--status/--date）。
默认忽略视图过滤；仅在明确启用时使用视图过滤（参见 references/task-fetch.md）。
仅保留 TaskID != 0 且至少包含 Params/ItemID/BookID/URL/UserID/UserName 之一的解码行。
允许 --status / --scene 使用逗号分隔的优先级列表。
fetch 支持 --limit；当设置 --limit 时，较早的场景/状态值会优先填充。
claim 仅适用于单任务；请勿使用 --limit。--candidate-limit 仅控制候选尝试次数（参见 references/task-claim.md）。
fetch 和 claim 都会拆分逗号分隔的 --scene 值，并按顺序查询每个场景（不将整个 CSV 视为一个字面场景）。
当摄入 JSON/JSONL 时，传递与列名匹配的键；如果存在 CDNURL/cdn_url，则将其映射到 Extra 中。

npx tsx scripts/bitable_task.ts fetch --app com.smile.gifmaker --scene 综合页搜索 --status pending --date Today --limit 10
npx tsx scripts/bitable_task.ts fetch --task-id "1326,1327" --raw
npx tsx scripts/bitable_task.ts fetch --biz-task-id ext-20240101-001 --raw

认领（多工作进程安全）

npx tsx scripts/bitable_task.ts claim \
  --app com.tencent.mm \
  --scene 个人页搜索,综合页搜索 \
  --device-serial <serial> \
  --status pending,failed \
  --date Today \
  --candidate-limit 5

认领行为的详细信息在 references/task-claim.md 中。

npx tsx scripts/bitable_task.ts update --task-id 180413 --status running --device-serial <serial> --dispatched-at now
npx tsx scripts/bitable_task.ts update --input updates.jsonl

npx tsx scripts/bitable_task.ts create \
  --input tasks.jsonl \
  --app com.smile.gifmaker \
  --scene 单个链接采集 \
  --status pending \
  --date YYYY-MM-DD \
  --skip-existing BizTaskID

剧集获取（只读）

通过可选的 BookID 过滤器从源剧集 Bitable 获取行。当调用者需要标准化的剧集元数据字段时，使用 --format meta：

npx tsx scripts/drama_fetch.ts --bitable-url "<DRAMA_BITABLE_URL>" --book-id "id1,id2" --format meta

从源 Bitable（原始多维表格）派生任务

sync 接受 --input 或 --bitable-url（可选附带 --book-id）并处理任务创建：

npx tsx scripts/drama_sync_task.ts \
  --bitable-url "https://.../base/SOURCE_APP?table=SOURCE_TABLE" \
  --task-url "https://.../base/TASK_APP?table=TASK_TABLE" \
  --app com.smile.gifmaker \
  --extra "test" \
  --params-list \
  --limit 10 \
  --skip-existing \
  --date 2026-02-10

--date YYYY-MM-DD 设置创建记录的任务日期，并用于 --skip-existing 去重过滤。省略时默认为今天。

参数模式标志（互斥）：

--params-list — 每个源行对应一个任务；Params 是所有搜索词的 JSON 数组，例如 ["好一个乖乖女","段休冥鹿鸣于"]。
--params-split — 每个搜索词对应一个任务；使用与 --params-list 相同的去重逻辑，但创建单独的任务，每个任务的 Params 为纯字符串。
--params-actor — 每个源行对应一个任务；Params 仅使用 主角名。

阅读 references/task-fetch.md 了解过滤器、分页、验证和字段映射。
阅读 references/task-claim.md 了解跨机器安全的任务认领。
阅读 references/task-update.md 了解状态更新、时间字段和批量更新规则。
阅读 references/task-create.md 了解创建负载规则和批量创建行为。
阅读 references/feishu-integration.md 了解 Feishu API 端点和请求/响应负载。
将 scripts/bitable_task.ts / scripts/drama_fetch.ts / scripts/drama_sync_task.ts 作为标志和行为的权威来源。

Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程

46,600 周安装