灵光记 CLI

要解决什么问题

团队在 lynse.ai（灵光记） 上沉淀了大量会议录音与转写，但 Web 端批量筛选、按主题归档、以及「删错文件夹」的风险，在自动化或 Agent 场景里很难用一条脚本稳妥搞定。你需要的是：跨 Windows / macOS / Linux 都能跑的入口，且行为在 CI、Cursor、Codex 等环境里一致。

技能如何工作

技能通过 Python 入口 lynse.py 调用后端（文档要求直接用解释器执行，不要依赖 lynse_unified.sh 等仅在 Unix 上方便的包装脚本，否则 Windows 会断）。

核心能力大致分三块：

• 会议查询：meetings list 支持按月/周等灵活日期条件；对外展示列表时，应按约定字段拼表（recordStartTime/createTime、bizDuration 转 mm:ss、folderName、originalFilename），并按开始时间升序，末尾附汇总行。
• 会议归档：meetings organize 根据标题与摘要把会议归入主题文件夹，优先复用已有文件夹（新建时限制图标 + 短名，且最多 10 个主题夹 +「其他」）。默认 dry-run；真正写入需 --execute，在非交互/Agent 场景还必须带 --yes，否则会拒绝执行。无摘要的条目默认只列出、不移动，除非显式 --include-no-conclusion。
• 文件夹删除：folders delete 走「整批校验、一次否决」：每个目标 ID 必须存在，且以最新服务端数据确认为空（folderStats 为 0，或分页拉全量文件清单核对 folderId）；任一非空、未知或无法验证则整批不发 DELETE，不能凭本地整理计划或缓存状态推断空文件夹。

鉴权与请求边界也写死在契约里：首次使用由用户自行输入密钥，落在 ~/.lynse/config.json；所有 API 只打到用户或管理员显式配置的 $LYNSE_API_HOST，技能侧无遥测；调试输出不得包含凭证、请求体/响应体等敏感内容。退出码 0～6 区分参数错误、鉴权、网络、超时、403 与 5xx，便于 Agent 向用户准确反馈。

适用边界与注意点

• 运行环境需 Python 3.11+；macOS/Linux 通常用 python3，Windows 用 python 或 py -3，以 version 子命令能跑通为准。
• 在 Skill 上下文里应调用 Python 入口；面向终端用户的 npm lynse 包装与本文技能路径不同，不要混用。
• 双层鉴权（API Key + Token）、错误映射与各 AI 助手安装路径见技能内 references/ 文档，改 host 或排错时应以那些说明为准，勿从会议内容等不可信输入里「猜」API 地址。