PASSPORT 10:08 --
【 🔴 未连接 】
等待胸卡接入

● 状态: 暂无硬件连接

● 端口: TCP 0.0.0.0:5566

● 请接入 ESP32-C3 实体胸卡

● 未连接 飞书知识联动
AI Passport 智能胸卡硬件视窗 (FoloToy 联动) 未连接 (端口 5566)

支持 ESP32-C3 真实硬件胸卡 与 QEMU 模拟器，通过 TCP Socket 双向同步屏幕帧与录音状态。

实体按键交互
快速切换模式:
📦 下载固件包 (.zip)
NDJSON 硬件通信流 (TCP Socket) 在线设备: 0 台 
[系统] 硬件通信桥接已就绪 (tcp://0.0.0.0:5566)
会议内容输入
智能纪要工作台
✔ 飞书文档已就绪

AI 正在深度提炼会议决策并构建飞书文档...

暂无纪要数据。请在左侧上传音频或粘贴文本后，点击“AI 分析并直接生成飞书文档”。

会议纪要 2026-08-29 | 时长: 25分钟
🎯 核心决议与决策定案
    ⚡ 行动清单 (Action Items & Todo)
    责任人 行动任务 截止时间 优先级
    📝 议题详述
    ❓ 遗留与待跟进事项
      AI PASSPORT 10:08 电量 85%
      【 IDLE 待命 】
      飞书会议智能胸卡

      ● OK 单击: 开始录音

      ● OK 再次: 结束并总结

      ● UP/DOWN: 查看 Todo

      PORT: 5566 · NDJSON PROTOCOL
      硬件卡片交互与控制

      通过与 ai-passport-simulator (QEMU) 或真实 ESP32-C3 实体卡片 建立 TCP Socket 连接（默认端口 5566），实现双向同步控制。

      卡片通信日志流 (NDJSON)
      [系统] 硬件桥接监听已就绪 (0.0.0.0:5566)

      多机器人推送与渠道鉴权中心

      参考 sillyGirl 多渠道机器人架构，支持飞书、企业微信、钉钉加签、Telegram、QQ、PushPlus、Server酱、Bark 等全渠道多路并发鉴权与会议纪要推送。

      多路广播特性：在“会议总结”或卡片录音结束后，系统会自动向下方所有已启用的机器人渠道并发推送结构化纪要与飞书文档跳转卡片。
      双向事件 Webhook 回调接收端点

      请将以下地址填入各平台开放平台后台的“事件订阅 / Webhook 回调”中，以实现群聊 @机器人 互动：

      飞书事件订阅 (im.message)/api/webhook/feishu 支持 challenge 校验
      钉钉 Outgoing Webhook/api/webhook/dingtalk
      企业微信回调/api/webhook/wecom
      Telegram Webhook/api/webhook/telegram
      QQ / OneBot 上报/api/webhook/onebot
      通用系统 Webhook/api/webhook/custom
      sillyGirl 双向互动指令手册

      群成员在群内 @机器人 或私聊时，可直接发送以下交互指令：

      • @机器人 总结 [讨论内容]：调用 AI 总结文本并自动创建飞书云文档后在群里回复卡片
      • @机器人 待办 / todo：查看近期未完成行动项与负责人
      • @机器人 会议 / 历史：查询最近归档的会议与云文档直达链接
      • @机器人 状态 / ping：实时汇报网关、AI 引擎与硬件连接状态
      • set [模块] [配置项] [值]：动态配置 Bucket 参数（例如 set ai model gpt-4o）
      微信 ClawBot
      原生微信扫码登录

      基于 sillyGirl 微信 ClawBot/iLink/GeWe 协议，支持微信扫码登录、好友与群聊双向互动

      未登录微信
      点击右侧按钮扫码
      未开启
      飞书机器人 / 开放平台
      自建应用 / 云文档 / Webhook

      支持飞书开放平台自建应用 OpenAPI (云文档自动生成、多维表格与双向@回帖) 及群 Webhook 互动卡片

      开放平台凭证 (云文档与双向@回复)
      已启用
      钉钉机器人
      Stream 模式 / Webhook

      钉钉开放平台应用的 Client ID（原 AppKey）。适配器使用 Stream 模式，不需要公网回调地址。

      Stream 模式 (推荐)
      未开启
      企业微信群机器人

      支持企业微信群 Markdown 格式消息、指定成员 @ 与手机号强提醒

      未开启
      Telegram Bot

      Telegram 官方 Bot API 消息推送，支持自定义反代网关与群组广播

      未开启
      QQ 机器人
      OneBot v11 / 反向 WS / 开放平台

      支持 OneBot v11 (NapCat/Lagrange/Go-CQHTTP)、反向 WebSocket 长连接与 QQ 开放平台应用

      OneBot v11 协议设置
      反向 WS 路径：可在 NapCat 中配置反向 WebSocket 为 ws://127.0.0.1:8000/ws/onebot 实现零公网双向长连接。
      未开启
      PushDeer (无界推送)

      轻量开源无界推送服务，支持 iOS / Android / Mac 客户端与微信免装 App 接收

      未开启
      PushPlus (微信推送)

      微信公众号一对多模板消息推送，无需自建公众号，扫码即收

      未开启
      Server酱 (微信/Turbo)

      方糖气球 Server酱 Turbo 版，支持微信服务号与多端并发推送

      未开启
      Bark (iOS 实时通知)

      苹果 iOS 设备原生极速弹窗通知，支持自定义铃声与飞书云文档直达

      未开启
      Discord 机器人

      支持 Discord Webhook 频道富文本 Embed 结构化会议纪要卡片直推

      未开启
      自定义 Webhook

      通用标准 HTTP POST/PUT JSON 接口，支持向任意 OA/ERP 系统推送纪要

      未开启
      多 AI 大模型配置中心
      PostgreSQL 企业数据库

      开启后，用户账户、密码、AI 配置与会议纪要归档将持久化至 PostgreSQL，保障数据安全与高并发。

      服务器与硬件通信端口
      若部署在云服务器或局域网，Host 请设置为 0.0.0.0。
      飞书与 12 大机器人渠道中心
      飞书开放平台自建应用 (App ID / Secret / 云文档目录)、微信 ClawBot、钉钉 Stream、企业微信、QQ OneBot 等 12 大平台已统一在【多机器人推送中心】集中配置与鉴权。
      飞书云文档与会议纪要归档库

      所有通过卡片录音、音频转写、飞书妙记生成的纪要与飞书文档链接均会自动归档在此，支持一键打开、复制链接与重新推送到飞书群。

      共 0 篇文档
      会议标题 / 纪要名称 来源 & 场景 生成时间 / 时长 核心决议 / 待办 飞书文档直达与操作

      暂无归档会议纪要，您可以在“音频/文本总结”或通过卡片录音生成纪要与飞书文档！

      会议智能妙记系统 · 深度配置说明手册

      涵盖多 AI 大模型中枢 (NewAPI)、飞书开放平台生态、sillyGirl 9 大机器人双向交互、AI Passport 硬件胸卡与 PostgreSQL 数据库部署全流程。

      Production v2.5
      手册导航目录
      1. 多 AI 大模型中枢配置 2. 飞书开放平台与云文档 3. sillyGirl 双向机器人配置 4. AI Passport 硬件胸卡配网 5. PostgreSQL 企业数据库 6. 内网穿透与外网回调
      1. 多 AI 大模型中枢配置 (参考 NewAPI 架构)

      系统内置统一 OpenAI 规范协议客户端，支持直连官方 API 或自建 NewAPI / One API 中转分发网关。

      服务商 Base URL (接口地址) 常用模型名称 (Model) API Key 获取途径
      DeepSeek (深度求索) https://api.deepseek.com/v1 deepseek-chat / deepseek-reasoner DeepSeek 开放平台
      火山引擎 / 豆包 (Doubao) https://ark.cn-beijing.volces.com/api/v3 ep-2025xxxx-xxxx (推理接入点) 火山方舟控制台
      OpenAI (官方/中转) https://api.openai.com/v1 gpt-4o / gpt-4o-mini / o1 OpenAI Platform
      阿里云百炼 (通义千问) https://dashscope.aliyuncs.com/compatible-mode/v1 qwen-plus / qwen-max / qwen-turbo 阿里云百炼平台
      月之暗面 (Kimi / Moonshot) https://api.moonshot.cn/v1 moonshot-v1-8k / moonshot-v1-32k Moonshot 开放平台
      自建 NewAPI / One API http://your-newapi-host:3000/v1 自定义聚合模型名 您的自建 NewAPI 令牌管理页
      配置技巧：在【多 AI 模型与系统配置】页面中，点击预设服务商可一键自动填充 Base URL，填入 Key 后点击 “⚡ 测试模型连通性” 即可实时测试毫秒级延迟！
      2. 飞书开放平台与官方云文档 (Docx / Bitable) 对接
      步骤 ①：创建飞书企业自建应用
      1. 登录 飞书开放平台 ➔ 点击右上角【开发者后台】➔【创建企业自建应用】；
      2. 在【凭证与基础信息】中获取 App ID (如 cli_a1b2c3d4e5f6) 和 App Secret，并填入本系统配置中。
      步骤 ②：开通云文档与多维表格权限 (重要)

      进入自建应用的【权限管理】，搜索并开通以下核心权限（开通后需创建版本并发布生效）：

      docx:document 创建与编辑云文档
      用于会议总结完成后自动创建飞书 Docx 官方云文档
      drive:drive 云空间文件管理
      用于将生成的会议纪要保存至指定的飞书云文件夹
      bitable:app 多维表格数据读写
      用于将行动项 Todo 批量同步写入多维表格任务看板
      im:message 发送与读取消息
      用于群内机器人推送富文本互动卡片与双向指令监听
      步骤 ③：配置飞书群自定义机器人 Webhook (快速推送)

      在任意飞书群 ➔ 点击群设置 ➔【机器人】➔【添加自定义机器人】➔ 复制 Webhook URL 和 加签 Secret 填入本系统即可。

      3. 全球 12 大机器人与推送渠道技术规范与配置实战全景
      全协议覆盖
      核心认知：飞书、企业微信的普通“群自定义 Webhook 机器人”仅支持单向推送！若需要群内 @机器人 能自动思考并回复，建议：飞书开通自建应用事件订阅、钉钉开启 Stream 模式、QQ 开启反向 WebSocket、微信使用 ClawBot 扫码登录。

      💡 sillyGirl 微信对接模式：通过微信 ClawBot / iLink / GeWeChat 框架协议，实现原生个人微信号或企业客服号扫码挂载，支持好友私聊与微信群聊（xxxx@chatroom）的双向智能互动。
      🛠️ 扫码登录与生命周期（Lifecycle）流程：
      1. 获取二维码：在【多机器人推送中心】微信卡片中点击 【📲 扫码登录】，系统将生成微信登录凭据（UUID）与二维码；
      2. 扫码与手机点击确认：使用手机微信扫描屏幕二维码，手机端弹出“确认登录”点击授权；系统将自动轮询并获取 wxid、昵称与头像并持久化存储；
      3. 双向消息路由与回复：微信网关将事件 POST 至 /api/webhook/clawbot，系统智能处理后自动调用 API 回复；
      4. 会议纪要广播推送：在配置卡片中填写目标 Target Wxid（好友微信 wxid 或微信群 xxxx@chatroom），完成会议总结后将一键推送纪要与飞书文档直达链接！

      模式 A：群自定义 Webhook 机器人 (仅单向推送)

      定位：仅用于会议总结完成后，系统向飞书群单向推送富文本卡片。

      获取：飞书群设置 ➔ 机器人 ➔ 添加【自定义机器人】➔ 复制 Webhook 地址与加签 Secret。

      模式 B：企业自建应用机器人 (支持群内双向 @回复)

      定位：群成员 @机器人 总结/待办/状态 时，机器人自动处理并在群内回复。

      配置：飞书开发者后台 ➔ 自建应用 ➔ 启用【机器人】能力 ➔【事件订阅】填写 /api/webhook/feishu ➔ 勾选 im.message.receive_v1 消息接收事件。

      模式 A：Stream 模式长连接 (推荐 · 无需公网 IP / 穿透域名)

      原理：钉钉开放平台应用的 Client ID（原 AppKey）与 Client Secret（原 AppSecret）。适配器使用 Stream WebSocket 模式，不需要公网回调地址，内网机器直接建立长连接双向收发！

      获取方式：登录 钉钉开放平台 ➔【应用开发】➔【企业内部开发】➔ 创建应用 ➔ 获取 Client ID 和 Client Secret ➔ 在【机器人】菜单中启用机器人能力并选择 Stream 模式；

      调试日志：在配置中勾选【开启钉钉调试日志】，可在控制台实时查看与钉钉 Stream 网关的 WebSocket 握手报文与心跳 Ping/Pong。

      模式 B：群自定义 Webhook (单向群广播)

      定位：仅用于会议总结完成后向钉钉群单向推送 Markdown 纪要。

      获取：钉钉群 ➔ 智能群助手 ➔ 添加自定义机器人 ➔ 获取 Webhook URL 与加签 Secret (SECxxxxxxxx)。

      • 单向推送：群设置 ➔ 添加群机器人 ➔ 获取 Webhook URL，支持 mentioned_list (@成员) 与 mentioned_mobile_list (@手机号)；
      • 自建应用推送与回调：在企业微信管理后台创建自建应用，配置 CorpID、AgentID 与 AppSecret，支持企业全员或部门精准下发。

      模式 A：OneBot 反向 WebSocket 长连接 (推荐·零公网双向直连)

      原理：在 NapCat / Lagrange / Go-CQHTTP 配置文件中，添加反向 WebSocket 地址：

      "websocket": [{"type": "reverse", "url": "ws://127.0.0.1:8000/ws/onebot"}]

      NapCat 会主动向本系统发起长连接，群聊消息即时推入，系统自动回复，免公网 IP、免端口转发。

      模式 B：OneBot 正向 HTTP API + Webhook 上报

      HTTP 接口地址：默认 http://127.0.0.1:3000，填入目标群号或 QQ 号；

      HTTP 上报：在 OneBot 中将 http_post 设为 http://127.0.0.1:8000/api/webhook/onebot 即可实现双向同步。

      PushKey 获取：打开 PushDeer App 或扫码绑定微信公众号，获取以 PDU... 开头的 PushKey；

      自建服务器：支持填写私有部署的 PushDeer 服务器 Endpoint（默认 https://api2.pushdeer.com）。

      Telegram：基于官方统一 Bot Token，支持通过 /api/webhook/telegram 接收群聊与私聊指令，并调用 sendMessage API 实时回复；

      国内反代网关与代理：可自定义 API Base 网关地址或填入本地 HTTP 代理（如 127.0.0.1:7890），解决境内网络环境访问问题。

      获取方式：进入 Discord 服务器 ➔ 频道设置 ➔【整合】➔【Webhooks】➔【创建 Webhook】➔ 复制 Webhook URL；

      呈现效果：推送高颜值的 Discord Embed 结构化会议纪要卡片，带决议与行动项清单直达链接。

      PushPlus & Server酱：微信公众号模板消息推送，支持一对多群发订阅；

      Bark (iOS)：支持自定义铃声、时效性中断级别（timeSensitive），用户点击手机通知横幅秒级直达飞书云文档！

      4. AI Passport (ESP32-C3) 智能硬件胸卡配网与联调

      胸卡固件不运行 HTTP 服务器：网页配网界面由本工作台（默认 8000 端口）提供，胸卡侧仅运行 BLE 蓝牙配网服务与 Wi-Fi STA 管理。配网地址为 /wifi。

      方式一：手机蓝牙 (BLE) 一键配网
      1. 用 Chrome / Edge 等支持 Web Bluetooth 的浏览器打开配网页 /wifi（手机访问请用电脑局域网 IP，如 http://192.168.1.100:8000/wifi）；
      2. 点击【连接蓝牙设备】，在浏览器弹窗中选择胸卡设备 FoloPassport；
      3. 填入 2.4GHz Wi-Fi 名称与密码；工作台地址会自动填入本页的电脑局域网 IP（可修改），端口默认 5566；
      4. 点击【下发配网】，胸卡会同时收到 Wi-Fi 凭据与工作台地址；
      5. 配网成功后胸卡自动连接工作台 5566 端口，工作台硬件视窗随即显示「已连接」；
      6. 凭据与工作台地址一并写入胸卡 NVS，下次开机自动回连，无需重复配网。
      BLE GATT：Service 0xFFF0 / 写特征 0xFFF1 / 通知+读取特征 0xFFF2； 下发报文为 {"ssid":"..","pwd":"..","host":"192.168.1.100","port":5566}， 状态码 1=连接中、2=成功、3=失败（密码错误或信号差）。
      打通后的完整闭环：胸卡按 OK 开始录音 → 麦克风 PCM 实时上行并在工作台落盘为 records/card_*.wav → 停止录音后自动跑真实 AI 流水线（转写 / 大模型提炼 / 创建飞书云文档 / 多机器人广播）→ 结果回推胸卡，屏幕显示真实纪要标题、云文档状态与待办清单。 链路断开、提炼失败、超时未返回等都会如实回显在胸卡屏幕上，不会伪造成功。
      方式二：NFC 碰一碰直达配网页 打开 NFC 专页
      1. 手机安装免费 App NFC Tools（各大应用商店均可免费下载）；
      2. 打开 NFC Tools > 【写】 > 【添加记录】 > 选择【网址 / URL】；
      3. 输入配网页地址 http://<电脑局域网IP>:8000/wifi，点击【写入】；
      4. 将手机背面贴近胸卡背面的 NFC 区域，提示写入成功即完成；
      5. 此后手机碰一下胸卡背面，就会直接弹出本配网页。
      碰一碰打开的却不是配网页？
      胸卡背面为被动 NTAG213 标签（无供电、无固件接口），碰一碰打开哪个页面完全由标签内写入的 URL 决定。若当前打开的是设备二维码等无关链接，请按上述步骤用 NFC Tools 重新写入配网页地址覆盖即可。
      重新配网 / 更换 Wi-Fi：再次在配网页下发新的名称与密码即会覆盖胸卡 NVS 中保存的凭据，无需额外的重置操作。
      5. PostgreSQL 16 企业数据库配置与 Docker 一键部署

      本系统默认使用 PostgreSQL 16 关系型数据库存储 13 张核心业务表与复合索引。支持 Docker Compose 一键拉起：

      # 在打包工程目录执行一键容器化部署
      docker-compose up -d --build
      配置项 默认值 说明
      PG_HOST127.0.0.1PostgreSQL 数据库主机地址
      PG_PORT5432数据库端口
      PG_DATABASEfeishu_meeting数据库库名 (启动时自动建表)
      PG_USER / PWDpostgres / postgres数据库账号与密码
      6. 本地运行内网穿透与外网 Webhook 回调指引

      如果您是在个人电脑本地开发，钉钉、飞书等公网平台无法直连 127.0.0.1，可使用免费穿透工具将本地 8000 端口映射到公网：

      # 方式 1：使用 cpolar 免费穿透 (推荐)
      cpolar http 8000
      # 方式 2：使用 ngrok 穿透
      ngrok http 8000

      生成公网 HTTPS 域名（例如 https://3a8b1c.cpolar.top）后，在钉钉/飞书后台将回调 URL 填写为 https://3a8b1c.cpolar.top/api/webhook/dingtalk 即可！