Iflyrec 会议同步

概述

安装一个运行于本地 Windows 系统的监听器，该监听器持续读取讯飞听见/Iflyrec 桌面客户端的日志文件，识别已完成会议的 orderId 值，并将生成的 AI 会议纪要及文字实录保存为 Markdown 文件。该监听器结合日志事件触发机制与周期性全量扫描回退策略，确保即使因系统原因遗漏了 FileSystemWatcher 事件，也能自动纠正并完成同步。

本功能仅适用于已登录讯飞听见/Iflyrec 账户的 Windows 机器。该能力不绕过账户登录、充值状态或会议平台权限校验。

快速开始

1. 确认前提条件：Windows 系统、Python 3、讯飞听见/Iflyrec 桌面客户端，以及一个本地目标文件夹。
2. 在本 skill 所在目录下运行安装脚本：

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .scriptsinstall_iflyrec_meeting_sync.ps1 -TargetDir "D:Meeting Minutes"

3. 在企业微信（WeCom）中开启会议，并使用 Iflyrec 的 内录+外录 模式进行录制。
4. 结束录制，等待 Iflyrec 显示生成的「智能纪要」。
5. 检查目标文件夹中是否生成了名为 智能纪要：...md 的文件。

脚本说明

• scripts/install_iflyrec_meeting_sync.ps1：将运行时文件复制到 %APPDATA%iflyrec-meeting-sync 目录，写入 config.json 配置，并启用开机自启。默认参数 -LaunchMode Auto 优先尝试通过 Windows 任务计划程序注册任务；若因系统策略限制无法注册，则自动降级为在当前用户的「启动」文件夹中创建快捷方式。
• scripts/iflyrec_meeting_sync.py：解析 Iflyrec 日志，使用本地 Iflyrec 会话 ID 调用生成结果 API，将纪要与实录写入 Markdown 文件，并在 sync_retry_state.json 中持久化记录每个 orderId 的重试退避状态。
• scripts/watch_iflyrec_meetings.ps1：长期运行的监听脚本，支持文件系统事件监听 + 轮询回退机制，默认全量扫描间隔为 300 秒。
• scripts/run_sync.ps1：由监听器与安装器共同调用的同步入口脚本。
• scripts/ensure_iflyrec_watcher.ps1：当采用任务计划程序模式时，用于重启 Iflyrec 监听任务。
• scripts/uninstall_iflyrec_meeting_sync.ps1：移除已注册的任务计划或「启动」快捷方式，并可选删除运行时文件。
• scripts/build_skillhub_package.ps1：构建发布包，生成包含 SKILL.md、agents/、scripts/、references/ 和 assets/ 的压缩包。

验证

安装完成后，可执行以下命令进行验证：

python "%APPDATA%iflyrec-meeting-synciflyrec_meeting_sync.py" self-test --config "%APPDATA%iflyrec-meeting-syncconfig.json"
python "%APPDATA%iflyrec-meeting-synciflyrec_meeting_sync.py" scan --config "%APPDATA%iflyrec-meeting-syncconfig.json"
Get-ScheduledTask -TaskName IflyrecMeetingSync

预期状态如下：

• self-test 应能成功定位目标文件夹、Iflyrec 数据目录、Iflyrec 日志目录及 datastore.json 文件。
• scan 命令将在 Iflyrec 已打开会议结果页面后，输出近期符合条件的 order_id 记录。
• 安装成功或执行过 ensure_iflyrec_watcher.ps1 后，任务计划程序中的任务状态应为 Running；若安装时降级为「启动」快捷方式，则此条不适用。
• watcher.log 的启动日志中应包含 fullScan=300s 字样（除非监听器显式指定了自定义的 -FullScanSeconds 参数）。

故障排查

当安装失败、任务计划程序异常、Iflyrec 登录状态异常或自动下载失败时，请参阅 references/windows-setup.md。

常见检查项：

• 若某场会议仅在另一场更晚的会议触发后才被识别，请保留事件监听机制，同时依赖默认的全量扫描回退策略——该策略即使未检测到新的日志特征，也会每 5 分钟执行一次 sync 操作。

• 重复出现 skip incomplete 或 skip error 日志条目时，将受 sync_retry_state.json 控制，按 10 / 20 / 40 / 60 分钟逐级退避，以降低对 Iflyrec API 的重复调用频率。

• 未生成 Markdown 文件：请先确认 Iflyrec 是否已成功生成「智能纪要」，再检查 %APPDATA%iflyrec-meeting-syncwatcher.log 与 sync.log 文件内容。

• 任务未运行：可手动执行 scripts/ensure_iflyrec_watcher.ps1 -TaskName IflyrecMeetingSync 尝试恢复；若因企业策略禁用了任务计划程序，可改用 -LaunchMode StartupShortcut 参数重新安装。

• 单场会议异常导致阻塞：当前脚本对单条记录错误具备容错能力，会跳过错误项并继续处理后续会议。

• 目标文件夹路径错误：编辑 %APPDATA%iflyrec-meeting-syncconfig.json 中对应配置项，然后重启任务。

安全规范

• 禁止在公开发布的包中包含用户日志副本、datastore.json、Cookie、手机号、生成的会议纪要或目标文件夹中的任何内容。
• 禁止在 skill 中硬编码个人保险柜（vault）路径。必须通过 -TargetDir 参数传入，或在运行时修改 config.json。
• Iflyrec 生成的 AI 会议纪要属于机器生成内容，投入业务使用前必须经人工审核与确认。