Feishu Advanced Builder (飞书高阶构建器)
超越普通纯文本记录,通过“构建器”思维实现飞书环境下的深度结构化数据写入与控制。它直接干预飞书底层的原子块(Block)与数据行记录,适用于汽车软件开发、架构师日常沉淀与复杂的 Auto-RCA 报告输出。
🎯 三大核心模块 (Core Capabilities)
1. 🎨 画板图谱注入器 (scripts/feishu-board.js)
使用场景: 故障树智能生成、架构时序设计、业务状态流转图。 将大模型生成的逻辑(如 Mermaid / PlantUML)自动变现为飞书原生的画板块(Block Type 43)。
- 一键创建子画板并嵌入文档
- 支持 Mermaid 流程图注入(
syntaxType: mermaid) - 支持 PlantUML 时序/类图/脑图注入(
syntaxType: plantuml)
2. 🗄️ 多维表格数据执行器 (scripts/feishu-bitable.js)
使用场景: Auto-RCA 自动化 Bug 指派、测试状态追踪看板。 它不是简单的读取整张表格,而是像操作 SQL 数据库一样精准干预具体的 Row(行级数据)。
- 在指定的 App ID / Table ID 下创建或更新特定数据条目。
- 支持写入带数据格式限定的字段:多选状态 (Status)、关联人员 (Persons)、日期筛选 (Dates) 等。
3. 📜 高级排版转化引擎 (scripts/feishu-markdown-to-docx.js)
使用场景: PRD/架构文档自动反编译及回写、长篇分析报告输出。 解决复杂的 Markdown 输出到飞书文档时排版崩坏或降级为纯文本的问题。
- 精准映射底层节点:将大模型的列表嵌套、复杂区块引用、代码高亮强制重编译为飞书原生的对应 Block 结构,保证最高级别的沉淀美观度。
🛠️ 安装与鉴权 (Setup)
前提:飞书应用必须拥有相关的多维表 (bitable:app)、文档 (docx:document) 和 画板 (board:whiteboard:node) 高级写入与读取权限。
FEISHU_APP_ID&FEISHU_APP_SECRET: 飞书应用的密钥凭证。
Note: 这是一个进阶开发者套件,执行前确保你清楚它的结构化数据定位。