跳转至

听写助手对话记录 60 · 飞书应用创建与权限配置实操指南

记录编号：DLG-20260807-60 日期：2026-08-07 智能体：听写（DT） 参与方：用户、DT 沟通渠道：AI 助手对话 主题：在飞书管理员操作文档中补充飞书自建应用创建与权限配置详细指南 → 记录日志 → 文档公开发布

一、用户需求

用户在 feishu-cli-setup.ps1 初始化脚本即将被 TL 执行的背景下，提出以下两个递进需求：

  1. 补充飞书应用创建与权限配置操作指南：在《MVP-FS 飞书管理员操作手册》中详细描述飞书自建应用创建及权限配置的完整手动操作步骤，方便 TL（司徒）按图索骥手动获取 App ID + App Secret，无需再凭经验摸索或临时查开放平台文档。
  2. 规范收尾：完成文档变更后，按 PJM §4 规范创建工作日志（DLG-60）、更新 WLG 索引、执行 git 同步与公开文档发布。

二、工作过程记录

步骤 1：飞书开放平台官方文档交叉验证

为确保操作指南的准确性与时效性，交叉检索飞书开放平台官方文档（最后更新 2026-05-07）与 2025-2026 实战教程，确认：

  • 应用创建路径：开发者后台 → 创建企业自建应用（正确，非"商店应用"或"小程序"）
  • 凭证位置：左侧「凭证与基础信息」→ App ID（cli_ 开头）+ App Secret（32 位，需点「查看/重置」按钮）
  • 权限体系：tenant_access_token（应用身份）vs user_access_token（用户身份），MVP-FS 阶段 1-3 全部使用应用身份权限
  • 权限名确认：飞书 2026 版权限命名规范（bitable:app、bitable:app:readonly、contact:contact:readonly_as_app 等 13 项）
  • 批量导入 JSON：飞书开放平台「权限管理」支持 JSON 批量导入（2025 年新功能，是手动勾选的 10 倍效率）
  • 发布审批流程：创建版本（版本号/更新说明/可见范围）→ 申请线上发布 → 企业管理员同意 → 状态变「已上线」
  • 403 常见根因：Scope 权限 ≠ 文档协作者权限；需额外通过「...」→「更多」→「添加文档应用」授予单表级权限（90% 用户第一次会踩坑）

步骤 2：管理员手册 V1.1→V1.2 新增附录 B（3 页）

更新 发布/m0/MVP-FS飞书管理员操作手册.html：

修改项 具体内容
封面版本 V1.1→V1.2，新增「V1.2 新增」行：📘 附录 B「飞书应用创建与权限配置实操指南」（手动获取凭据 11 步）
P02 目录 进阶篇目录追加「附录 B：飞书应用创建与权限配置指南（V1.2 新增）」；目录区追加金色提示框说明附录 B 用途
P13 附录 B-1 📘 Step 1-4：登录后台 → 创建应用（应用名/描述模板）→ 获取凭证（安全红线提醒）→ 添加「机器人」能力，附解说词
P14 附录 B-2 📘 Step 5-7：权限管理入口 → 13 项权限「批量导入 JSON」模板（可直接复制粘贴）→ 按阶段 1/2/3 分组的权限清单对照表，附解说词
P15 附录 B-3 📘 Step 8-11：创建版本（版本号/更新说明/可见范围模板）→ 管理员审批流程 → 文档级「添加文档应用」权限（⚠️ 易踩坑提示）→ 验证方法表 → 4 条附录 B 专属 FAQ，附解说词
总页数 12 页 → 15 页（追加 P13-P15）

步骤 3：feishu-cli-setup.ps1 步骤 4 权限引导文案同步更新

更新 scripts/feishu-cli-setup.ps1 步骤 4 引导文案：

  • 旧版：简单罗列 5 类权限大类名（多维表格-读写 / 云文档-读写等），与实际 Scope 名有偏差（如写了 docs:doc、workflow:workflow，实际不使用这些权限）
  • 新版：
  • 顶部明确告知「请先按附录 B 完成 Step 1-9」，给出文档路径与 P13-15 页码
  • 提供与附录 B Step 6 完全一致的批量导入 JSON 模板（13 项 tenant 权限），可直接复制粘贴
  • 权限 3 分组说明：阶段 1 建表 6 项 / 阶段 2 运维 4 项 / 阶段 3 闭环 3 项
  • 增加检查清单 [4.1]～[4.4]：机器人能力 / 13 项权限 / 创建版本 1.0.0 / 管理员审批通过
  • 补充附录 B Step 10「旧表需添加文档应用」说明（一键搭建脚本自建表自动处理，可跳过）

与管理员手册一致性：feishu-cli-setup.ps1 步骤 4 的权限清单、JSON 模板、阶段划分与附录 B P14 完全一致，无偏差。

三、结论与产出

本次对话产出物清单

序号 产出物 位置 状态
1 飞书管理员操作手册 V1.2 发布/m0/MVP-FS飞书管理员操作手册.html 已完成（P13-15 新增 3 页附录 B）
2 feishu-cli-setup.ps1 步骤 4 权限引导文案同步 scripts/feishu-cli-setup.ps1 已完成（与附录 B 清单完全一致）
3 DLG-60 工作日志（本文件） docs/工作日志/对话记录/20260807_听写助手对话记录60_飞书应用创建与权限配置指南.md 已完成

版本升级汇总表

文档 升级前 升级后 变更摘要
管理员手册 HTML V1.1（12 页） V1.2（15 页） 封面/目录版本同步；新增 P13-15 附录 B（3 页）；目录追加提示框
feishu-cli-setup.ps1 步骤 4 粗粒度权限 步骤 4 精化版 追加附录 B 链接；13 项 JSON 批量导入模板；4 项检查清单；旧表文档应用说明

TL 后续操作提示（给司徒）

  1. 打开 发布/m0/MVP-FS飞书管理员操作手册.html，键盘 → 翻到 P13-P15 附录 B，按 Step 1-11 操作（约 15-20 分钟）
  2. 期间需洪哥或 OL 协助做 Step 9 管理员审批（行政流程，提前约 5 分钟）
  3. 附录 B 完成后，在 PowerShell 执行： 
    powershell -File d:\AC\TF\hk2026\scripts\feishu-cli-setup.ps1
  4. 凭据验证通过后，执行一键搭建： 
    python d:\AC\TF\hk2026\scripts\feishu-mvp-setup.py --dry-run   # 先模拟，确认字段无误
python d:\AC\TF\hk2026\scripts\feishu-mvp-setup.py            # 正式搭建（5-10 分钟）

四、下一步建议（待办 T1-T4）

编号 待办事项 责任人 状态
T1 TL 按附录 B 完成飞书应用创建 + 发版审批 TL（司徒） 待启动
T2 执行 feishu-cli-setup.ps1 + feishu-mvp-setup.py 搭建 WEAVELY-MVP 工作台 TL（司徒） 待 T1 完成
T3 git 同步：主仓提交推送 → 公开文档仓同步 → MkDocs 站点部署 DT（听写） 完成 DLG-60 编写后立即执行
T4 验证线上站点 /mvpfsadminpg/ 短路径指向 V1.2 最新版本 TL / DT 待 T3 完成

DLG-60 记录结束 · 下一步执行 T3：git 同步与文档公开发布