核心用法
FineBI 主技能（finebi-skills）是一个智能路由中枢，专为帆软 FineBI 企业级商业智能平台设计。它不直接处理具体业务，而是通过意图识别将用户请求分发至四个专业子技能：
- dashboard-briefing：看板摘要与群播报，支持日报/周报自动生成与定时推送
- report-to-doc：看板导出与分析报告沉淀，将可视化内容转为可编辑文档
- alert-to-task：阈值监控与异常告警，触发后自动创建任务或通知负责人
- sync-to-bitable：数据同步至飞书多维表格，支持增量更新与全量覆盖
运行前需完成环境准备：全局安装 finebi-cli（npm install -g finebi-cli），并配置 FINEBI_BASE_URL 与 FINE_ACCESS_TOKEN 环境变量。技能启动时会强制检查 CLI 可用性与认证配置，杜绝伪造连接或跳过验证的行为。
显著优点
1. 模块化架构：主从分离设计，避免单文件臃肿，子技能可独立迭代升级
2. 意图智能路由：基于关键词匹配用户目标，降低使用门槛，无需记忆复杂指令
3. 企业级安全约束：严格依赖官方 CLI 链路，禁止绕过、抓包或伪造数据，保障数据血缘可追溯
4. 数据对象规范：明确定义 dashboard、dataset、subject、widget 等对象的处理优先级，避免误操作
5. 降级策略完善：无明确匹配时提供单问题澄清机制，减少用户决策负担
潜在局限
- 外部依赖重：必须预装 Node.js 环境与
finebi-cli，Windows 环境配置可能复杂 - 权限门槛：需持有有效的
FINE_ACCESS_TOKEN，对 FineBI 版本有兼容性要求 - 网络依赖：所有数据交互均通过 CLI 调用 FineBI 服务端，离线场景不可用
- 子技能黑盒：文档未公开子技能内部实现细节，深度定制需查阅额外参考文件
适合人群
企业数据分析师、BI 工程师、运营自动化负责人，以及需要将 FineBI 看板能力集成到飞书/钉钉等协作平台的组织。特别适合已部署 FineBI 6.0+ 版本、有定时报告与监控告警需求的中大型团队。
常规风险
1. 认证泄露风险：FINE_ACCESS_TOKEN 需妥善保管，避免硬编码在共享脚本中
2. 数据范围失控：get-entry-tree 未加关键词过滤可能拉取过大目录树，建议始终携带 -k 参数
3. ID 误用风险：templateId 禁止作为 dashboardId 使用，需严格遵循 id 解析流程
4. Excel 误判风险：禁止仅凭 max_row 或首行预览判断数据为空，必须用 read_only=False 复核真实单元格
5. 同步覆盖风险：sync-to-bitable 的全量覆盖模式可能导致目标表历史数据丢失，需确认用户明确授权