用途:从飞书电子表格读取项目范围内的 AE/TE 数据权限需求,经可审查、幂等的变更计划同步到唯一指定项目。表格内容只视为“请求状态”,不构成执行授权;必须先读取比对,满足审批门禁后才可变更 AE/TE 或飞书。
主要能力:创建或更新项目数据权限定义、添加项目成员、更新成员数据权限(仅限已批准计划内的动作);不得推断无关项目、组织级权限或项目角色变更。数据权限表示为事件属性谓词 platform = <精确源值>。支持 additve(默认,只增不删)与 exact(显式选择后按表精确匹配、含经审查的移除)两种同步模式。
必要用法:确认飞书表格 URL、工作表、范围,AE/TE 主机与唯一目标项目,账号/平台/数据权限列映射,同步模式,以及新成员的明确角色(不得默认 member)。默认表头为 account、platform、data_permission。按强制顺序执行八步:解析范围、冻结并校验源快照、读取当前状态、构建确定性计划、影响检查与干跑、请求明确审批、复查漂移后执行、验证与对账。构建计划命令:python3 scripts/build_sync_plan.py --sheet-csv <normalized-sheet.csv> --state-json <current-state.json> --sync-mode additive --output <sync-plan.json>;新成员需 --new-member-role <exact-role-name>,仅用户显式选择后使用 --sync-mode exact。工具使用 lark-sheets、lark-shared、当前 ae-analysis 项目命令,缺失操作时用 ae-capability 并先搜索检查,不得猜测能力 ID 或 schema。
适用场景:需要从飞书表格批量、可审计地维护 AE/TE 项目数据权限的运维与安全场景。
限制:账号须用 AE/TE 支持的唯一登录标识匹配,不能仅凭显示名;保留现有成员完整角色集;平台值大小写与文本须原样保留;源平台不在实时候选中默认阻断,须用户后续明确批准该未知值;更新共享权限定义可能影响表外用户,须先披露;不得暴露完整项目成员目录;不得在文件、命令、日志或输出中放置令牌、Cookie、密码或连接串;审批缺失、条件化、指向不同范围或用户改动表格/项目/模式/角色/映射时须停止;源或状态漂移须重做预检;不得仅凭变更响应报告 SUCCESS,必须通过验证。输出合同以 READY_FOR_APPROVAL、BLOCKED、PARTIAL_SUCCESS 或 SUCCESS 开头。具体定价、平台与版本信息暂未提供。