跳转至

听写助手对话记录 58 · MVP-FS飞书管理员操作手册

记录编号:DLG-58 日期:2026-08-07 时段:21:25 - 21:50 参与方:用户(SPO)、听写(DT) 沟通渠道:AI 对话(Trae) 关联文档:PMG V8.2 / WLG V6.0 / 发布 V1.1 / m0/README V1.0 / MVP-FS V1.1 / scripts/README V1.3


一、用户需求

用户在 DLG-56(MVP-FS 飞书操作培训手册全员版)完成后,提出后续工作:

参照 mvp-fs 培训手册,再帮我写一份面向本项目飞书管理员的培训操作手册

明确要求: 1. 风格对齐:参照全员版培训手册的 PPT 风格(下方 1/3 解说区 + 项目标准色 + Mermaid 可视化 + 键盘 ←→ 翻页 / F 全屏) 2. 受众聚焦:面向飞书管理员角色(非普通用户),解决"如何搭建、配置、运维、治理、迭代"飞书工作台的问题,区别于全员版的"如何走完一单" 3. 角色范围:OL 运营负责人(成文·主管理员)/ TL 技术负责人(司徒·技术管理员)/ ML 市场负责人(洪·备份管理员)


二、工作过程

步骤 1:素材定位与角色核验(21:25 - 21:30)

  • 读取核心素材源:
  • docs/技术文档/m0/MVP-FS实施方案.md V1.1 → §2.2 6 张数据表清单 / §2.3 6 角色权限矩阵 / §3.2 CPT-Lite 40 字段 / §3.3 QSV-Lite 报价公式 / §5.4 表单迭代规则 / §8 数据质量监控
  • scripts/README.md V1.3 → §5 mvp-data-checker.py + mvp-weekly-report.py 详细用法与协作流程
  • docs/项目管理.md V2.1 → §3.1 RACI 角色对照表(确认 OL=成文 / TL=司徒 / ML=洪 / BO=洪 / SPO=曾总,双管理员机制)
  • 发布/m0/MVP-FS飞书操作培训手册.html → 风格模板(深墨绿 #004046 + 浅沙金 #D4AF78 + 米白 #F2F0EB + 下方解说区 + steps 卡片 + tag 标签)

  • 关键纠偏:初始探索 Agent 误判 ML 为"管理负责人",实际应为"市场负责人"(PJM §3.1 明确)。直接读取 PJM 与 MVP-FS 实施方案确认:双管理员机制 = OL 主业务 + TL 主技术,ML 作为备份。

步骤 2:管理员手册开发(21:30 - 21:45)

  • 产出文件:发布/m0/MVP-FS飞书管理员操作手册.html(41 KB)
  • 9 章 11 页结构(封面 + 目录 + 9 章正文):
  • 搭建篇(第 1-4 章):管理员角色与职责分工 → 飞书工作台搭建(WEAVELY-MVP)→ 字段与公式配置(CPT-Lite 40 + QSV-Lite 公式)→ 视图与仪表盘配置
  • 治理篇(第 5-7 章):权限配置(6 角色矩阵 + 师傅行级)→ 自动化规则(3 条提醒规则)→ AI 听写协作与日常运维
  • 进阶篇(第 8-9 章):周报脚本与表单迭代治理 → 异常处理 FAQ + 上线 Checklist

  • 设计要点

  • 双管理员职责矩阵:7 行表格明确 OL(业务)vs TL(技术)在建表/权限/自动化/数据治理/表单迭代/备份应急 6 个职责域的分工
  • Day 1-2 时间线:把搭建任务拆为 Day 1 上午(建文件+6 表)+ 下午(配字段+公式)+ Day 2 上午(视图+仪表盘)+ 下午(权限+自动化),每段都有可验收的产出
  • 权限矩阵 6 角色:OL 管理员 / TL 编辑者 / ML 编辑者 / BO 查看者 / SPO 查看者 / 师傅受限查看者,含飞书角色 + 可见表 + 权限 + 日常操作 4 列
  • 师傅行级权限 4 步配置:开启按行权限 → 添加"当前用户"动态匹配规则 → L6 字段可编辑例外 → 师傅账号登录验证;红线警示隐私事故
  • 3 条自动化规则:新订单提醒(L1→OL)/ 阶段变更提醒(按阶段通知不同角色)/ 超时提醒(L2 超 2h + L3 超 24h)
  • 日常运维节奏:每日(OL 备份+监控)/ 每周五(TL 跑脚本+周报)/ 每月(OL+TL 复盘+迭代)三栏卡片
  • 周报 6 步流程:与 scripts/README §5.4 完全对齐,含具体命令行
  • 表单迭代 4 条治理规则:加字段易删字段难 / 枚举优先 / 版本号管理 / 不超 50 字段
  • 10 问 FAQ + 12 项上线 Checklist:覆盖师傅看不到订单 / 公式报错 / 自动化不触发 / CSV 乱码 / 离职回收等高频问题

  • 风格对齐全员版:相同的 :root CSS 变量、相同的 slide/speak 布局、相同的 tag/steps/card/alert 组件、相同的 nav 导航条与键盘交互

步骤 3:索引同步(21:45 - 21:50)

3.1 更新 发布/m0/README.md - §2.1 MVP-FS 配套工具表新增「MVP-FS 飞书管理员操作手册」条目(受众 OL/TL/ML,对应源文档 MVP-FS §2.2-2.4 + §3 + §5.4 + §8 + scripts/README §5) - §四 Mermaid 关系图新增 PUB_FS4 节点 + M1 → PUB_FS4 连线 + 浅沙金高亮样式

3.2 更新 发布/README.md - §2.3 MVP 方案类表新增管理员手册条目 - §五 修订记录追加 2026-08-07 条目(发布文档含子目录共 15 份)

3.3 创建本记录 DLG-58 - 更新 WLG README §5.1 对话记录索引追加 DLG-58 - 更新 WLG README §六 修订记录追加 V6.1


三、产出物清单

# 路径 类型 版本 说明
1 发布/m0/MVP-FS飞书管理员操作手册.html 新建 HTML PPT V1.0 DOC-D00-M1-T2 主交付物:11 页管理员专属操作手册,覆盖搭建/配置/运维/治理/迭代全链路
2 发布/m0/README.md 更新 V1.0 → V1.1 §2.1 表新增管理员手册条目;§四 Mermaid 图新增 PUB_FS4 节点
3 发布/README.md 更新 V1.1 → V1.2 §2.3 表新增管理员手册条目;§五 修订记录追加
4 docs/工作日志/对话记录/20260807_听写助手对话记录58_MVP-FS飞书管理员操作手册.md 新建 DLG-58 本记录
5 docs/工作日志/README.md 更新 V6.0 → V6.1 索引表追加 DLG-58;修订记录 V6.1

变更统计:新建 2 文件 + 更新 3 文件 = 5 文件变更


四、关键决策

# 决策项 决策原因 决策人
D1 双管理员机制(OL 主业务 + TL 主技术),ML 备份 与 PJM §3.1 RACI 矩阵对齐:建表的人要懂业务(OL),改结构的人要懂技术(TL),一个人容易出错或卡壳;ML 作为备份确保 OL 不在岗时业务连续 DT
D2 章节结构按"搭建→治理→进阶"三篇组织,而非按"Day1/Day2/日常"时间线 管理员手册是长期参考文档(不是一次性培训文档),按职责域组织便于后续查阅;Day 1-2 时间线作为每章的小节标注嵌入 DT
D3 师傅行级权限独立成 §5.2 单独 4 步讲解 师傅行级权限是隐私控制红线(PJM §2.4 数据安全风险),配错会泄露全部客户电话地址;必须独立讲解 + 红线警示 + 测试验证步骤 DT
D4 表单迭代 4 条规则独立成 §8.2,与周报脚本流程并列 "加字段易删字段难"是 MVP §1.4 设计原则的核心,40 字段不控制会膨胀到 80 字段导致一线填不动;治理规则与脚本流程同属"周治理"动作,放同一章便于周五一次性执行 DT
D5 风格完全对齐全员版培训手册(同样的 CSS 变量与组件) ① 形成"MVP-FS 培训系列"统一视觉体系 ② 全员版已验证风格可用,复用降低风险 ③ 解说专栏可同时作为管理员培训讲师稿 DT

五、待办事项

# 待办 负责人 建议时间 状态
T1 OL+TL 共同按手册执行 Day 1-2 搭建,完成后对照 §9.2 Checklist 12 项验收 OL + TL MVP-FS Week 1 前两天 ⏳ 待启动
T2 管理员手册打印 A4 双面,作为 OL/TL 工位案头参考 OL Day 1 搭建开始前 ⏳ 待办
T3 师傅行级权限配置后必须用师傅账号实测(Checklist 第 10 项) TL Day 2 下午 ⏳ 待办
T4 git 同步 + 公开文档同步执行(PJM §4.3.6/7,用户指令触发) DT(等用户指令) 用户确认后 ⏳ 待指令

本记录由听写 DT 于对话完成后自动整理,如有遗漏请 OL/SPO 补充。