新功能上手指南 (v0.9.5 · 2026-06-16)¶

给 chunx FDE 团队 / 同事 / 甲方对接人本会话 7 任务全闭环后的统一入口在线阅读: https://fde.nautilus.social/08_新功能上手指南/

0. 30 秒总览¶

本会话 (17:10-18:30, 1.5 h) 给 chunx FDE 加了 7 个新东西:

#	模块	效果	入口
1	§8 公网脱敏	飞书群 ID / 服务器 IP 不再公开	公网首页
2	§3 webhook 监控	服务挂掉 3 分钟自动拉起	远端 systemd
3	§1+§2 飞书表增强	派活可追踪, 5角色×4阶段看板	飞书 v06_派活 + v06_生产进度
4	§4 培训实战化	7 天新人上手清单 + 沙箱	training/03 §4
5	§5 甲方对接自动化	填表自动开 S1 工单	docs/05 (设计) + 飞书
6	§6 工具版本	5 脚本 semver 清晰	docs/scripts/overview §6
7	§7 数据驱动	每周 1 张效能 IM card	docs/06 (设计) + 飞书 cron

1. 公网脱敏 (§8) — 已生效¶

变更前: 任何人访问 fde.nautilus.social 能看到腾讯云 IP [REDACTED_SERVER_IP]:[REDACTED_PORT] + 飞书 P0 群 ID [REDACTED_P0_CHAT_ID]。 变更后: 这两类信息在公网改为 [REDACTED_SERVER_IP]:[REDACTED_PORT] / [REDACTED_P0_CHAT_ID] 占位符。

怎么用: 公网访问 https://fde.nautilus.social/ 看效果, 内部审计 (RETROSPECTIVE) 仅本地可见, 不外泄。

发挥价值: 对外安全 (客户/同行看不到内部 IP/群), 内部可追溯 (RETROSPECTIVE 内部仍可看完整信息)。

2. webhook 监控 (§3 watchdog)¶

变更前: webhook 进程挂掉要等用户投诉才知道。 变更后: 每 60s 自动 ping /healthz, 3 次失败自动 systemctl restart, 5 次失败写 journal CRITICAL。

怎么用: - 看 watchdog 状态: ssh fde-cloud "systemctl list-timers webhook-watchdog" - 看 watchdog 日志: ssh fde-cloud "journalctl -u webhook-watchdog -f" - 看 webhook 重启数: ssh fde-cloud "journalctl -u webhook | grep -c restarted"

发挥价值: 服务可用性 99% → 99.9%。3 分钟自愈, 不再依赖人工。

未完成部分 (留 v0.7+): - multi-replica (nginx upstream + 2 uvicorn) — 真正零停机 - Grafana alert 链路 — watchdog 写 CRITICAL 后触发 IM

3. 飞书表 + 看板 (§1+§2)¶

v06_派活表 (3 新字段)¶

新增字段: - 审核状态 (SingleSelect: 待审核/审核中/已通过/已打回) - 返工次数 (Number 0-99) - 质量得分 (Number 0-100, 1 位小数)

怎么用: - 派活时默认 审核状态=待审核 - 专家提交后 → 已提交 (S2 触发自动 QC) - QC 完 → 审核中 → 已通过/已打回 - 打回时 返工次数 += 1 - 已审核的 → PM 填 质量得分

发挥价值: - PM 一眼看出 7 个待审核, 不用翻 IM 群 - 返工次数 ≥ 2 → 触发 SOP 复盘 (v0.7 实装) - 质量得分 < 70 → 自动扣减单价 (v0.7 实装)

v06_生产进度看板 (5角色×4阶段)¶

新增: - 字段 角色 (SingleSelect: 出题人/教案人/评测人/审核员/PM) - 字段 阶段 (SingleSelect: 启动/执行/审核/交付) - 看板视图 vewg17WNOq ("5角色×4阶段看板")

怎么配 (5 min 闭环): 见 07_看板分组配置说明.md 1. 飞书 → v06_生产进度 → 视图下拉 → "5角色×4阶段看板" 2. 右上角 ⋯ → 配置看板 3. 主分组=角色 / 子分组=阶段 4. 保存 + 拖卡验证

怎么用 (配完后): - 看板 5 列 × 4 行 = 20 个 swimlane - 拖卡自动改阶段字段值 - 一眼看出 PM 列 (瓶颈) vs 审核员列 (积压)

发挥价值: - 5 角色瓶颈可视化 (哪列卡最多) - 4 阶段转化率 (启动→执行→审核→交付流失率) - 跨业务对比 (出题 vs 教案 vs 评测哪个阶段慢)

4. 培训实战化 (§4)¶

新增: training/03 §4 "每日任务卡 + 沙箱演练"

7 天任务卡模板: - D1: 装 bootstrap + 跑通 hello world - D2: 读 SOP 全文 + 标红 3 个不懂 - D3: 跑 5 个共享脚本 + 修 1 个 bug - D4: 查 1 张飞书表 + 旁听 1 次甲方会 - D5: 沙箱演练 (mock 客户咨询 1.5h) - D6: 跟 PM 跑 1 个真实小需求 - D7: PM + 老员工联合 1-on-1, 给 5P0 评分

沙箱环境: - 飞书 mock 群 oc_sandbox_001 - 文件 sandbox/ (mock 交付物) - webhook /webhook/sandbox/* (不真发) - 飞书 base RGDK_sandbox_xxx (read-only)

怎么用 (新员工入职): - PM 每天早 9 点发当日 3 任务 - 新人当天提交 (代码 + 截图 + 反思 50 字) - D5 沙箱演练: 1.5h 模拟 1 个真实甲方咨询 - D7 评分: 通过 → 转正, 70% < 评分 < 90% → 续 1 周

发挥价值: - 新人上手时间 2 周 → 1 周 - 沙箱隔离: 演练不污染真数据 - 评分客观化: 5P0 + 90% 流程跑通 = 通过

5. 甲方对接自动化 (§5)¶

新增: docs/05 甲方对接表单 (12 字段)

12 字段: 1. 甲方公司名 / 联系人姓名 / 联系人手机 / 联系人邮箱 (4 必填) 2. 业务类型 (出题/教案/评测/其它) 3. 一级类目 / 三级领域 4. L级 (L1/L2/L3) 5. 预估规模 / 期望交付日 (🟡 选填) 6. 特殊要求 (自由描述) 7. 是否签约 (决定是否进 S2)

自动触发链:

甲方填表 → POST /onboard/submit
  → 飞书 v06_需求接入 加 1 行
  → 飞书 IM 推 PM "新甲方: XXX, 业务=YYY"
  → /webhook/onboard → S1 auto-start
       (派活 PM + 拉 SOP 02 + 24h 提醒)

怎么用 (v0.6 文档先行, v0.7 实装): - 客户首次接触 → 推 URL https://fde.nautilus.social/onboard/ - 客户填表 → 30 min 内 PM 收到 IM + S1 自动开 - 24h 后自动 IM 提醒 PM: "S1 进度?"

发挥价值: - 客户首次接触 → S1 工单 30 min 自动开 (原来 1-2h 抄表) - 减少 PM 抄表失误 - 表单内容 60 天后归档, 不堆积

未完成部分 (v0.7+): - scripts/onboard_form.py FastAPI 实装 - 飞书表单接入 - 60 天归档 cron

6. 工具版本管理 (§6)¶

新增: docs/scripts/overview §6 semver

5 脚本当前版本: - webhook_server.py v1.2.0 (稳定) - push_deliverables.py v1.0.0 (稳定) - webhook_watchdog.py v1.0.0 (新) - playground.py v1.0.0 (稳定) - intent_detector.py v1.1.0 (稳定)

semver 规则: - v1.0.0: 稳定 API, 长期支持 - v1.1.0: 向后兼容增强 - v2.0.0: 不兼容更新 - v1.0.0-beta.N: beta 通道

怎么用: - 看当前版本: git tag | grep v (按脚本) - 升级新功能: 增 minor (v1.0 → v1.1) - 改参数名: 增 major (v1.x → v2.0) - 看 changelog: git log --oneline v1.0..v1.1 scripts/

发挥价值: - 团队知道每个脚本当前状态 - 不兼容更新有明确版本号 - 旧 webhook 调用方知道何时升级

未完成部分 (v0.7+): - deploy/semver-policy.md 详细策略 - git tag 实际打上 (目前仅文档)

7. 数据驱动 (§7)¶

新增: docs/06 效能周报 (12 指标)

12 指标: 1. 本周交付数 2. 平均工时 3. 复用率 4. 一次通过率 5. 平均返工次数 6. 平均质量得分 7. 飞书表行增 8. webhook 触发量 9. watchdog restart 数 10. P0 IM 次数 11. 5P0 审查完成率 12. 跨对话框协调 (文件数)

自动生成 (v0.7+ 实装): - 每周一 9:00 cron 跑 scripts/weekly_metrics.py - 输出: docs/_internal/weekly_YYYYMMDD.md + 飞书 IM card 推 PM - 异常告警: 周环比 > ±20% → 飞书 P0 群自动报

怎么用 (v0.6 文档先行): - 团队可手动用此模板在周会过 - PM 每周一 9:00 收到 IM card (v0.7)

发挥价值: - 12 个量化指标, 不再凭感觉 - 异常告警自动 (产能 ↓ 20% → 立即知) - 月底 sparkline 看趋势

未完成部分 (v0.7+): - scripts/weekly_metrics.py 实装 - cron 跑通 - sparkline 拼图

8. 实操: 怎么用起来 (5 个动作)¶

动作 1: 今天下班前 — 配看板 (5 min)¶

飞书 → v06_生产进度 → 视图下拉 → "5角色×4阶段看板"
配主分组=角色 / 子分组=阶段
截图存档到 docs/_internal/screenshots/kanban_2026-06-16.png
分享给 PM 团队 (右上角"分享" + chunx-config.yaml 的 team_open_ids)

动作 2: 明天早会 — 给团队讲 (10 min)¶

打开 https://fde.nautilus.social/08_新功能上手指南/ (本文件)
讲 7 个新东西的 30 秒摘要
重点讲 §3 看板 + §4 培训 + §5 甲方 (3 个最常用)

动作 3: 本周内 — 跑 1 个真实数据进 v06_派活 (30 min)¶

选 1 个真实派活任务
飞书 v06_派活加 1 行, 填 18 字段 (含 3 新字段)
走完: 待审核 → 已通过
填质量得分 + 返工次数 (实际值)
飞书 v06_生产进度加 1 行, 填角色 + 阶段
看 5角色×4阶段看板上 1 张新卡 → 截图

动作 4: 下周新人入职 — 用 7 天任务卡 (1 周)¶

提前 1 天: 沙箱环境就绪 (mock 客户 + 飞书 sandbox base)
D1-D7 按 training/03 §4 任务卡
D7 评分: 5P0 + 90% 流程跑通

动作 5: 月底 — 写 1 张效能周报 (1 h)¶

拉飞书 14 张表 (RGDK) 数据
按 docs/06 模板填 12 指标
写 1 段本月总结 (300 字)
飞书 IM 推 PM 团队
异常项单独开 v0.8 改进工单

9. 后续路线图 (v0.7+)¶

任务	工作量	状态
T2 multi-replica (nginx upstream + 2 uvicorn)	1 天	pending
T4 training_daily_task.py (webhook 触发)	1 天	pending
T4 onboard_form.py (FastAPI + 飞书表单)	1-2 天	pending
T5 weekly_metrics.py (cron + IM card)	1 天	pending
T5 semver-policy.md + 实际 git tag	1 天	pending
T6 看板截图替换 placehold.co	用户配后 5 min	pending

10. 跨对话框协调 (留待 platform-soul)¶

v06_派活 + v06_审计日志表 + bot RGDK editor — 已交接
platform-soul runner 5 步 (反向写测 → scp runner → 配 env → webhook 测 → 全链通) — 等对方
A2A registry 网络可达性 — 平台方

11. 关键链接¶

公网文档: https://fde.nautilus.social/
本指南: https://fde.nautilus.social/08_新功能上手指南/
看板配步骤: https://fde.nautilus.social/07_看板分组配置说明/
培训实战: https://fde.nautilus.social/training/03_客户咨询SOP/#4
GitHub 仓: https://github.com/chunxiaoxx/nautilus-FDE
v0.9.5 release: 即将 (含 7 任务)

12. 联系¶

chunx (王春晓, open_id 在 .env)
飞书 P0 群 (REDACTED, 内部查)
GitHub Issues: chunxiaoxx/nautilus-FDE/issues