================================================================================ TeamChat v5.2.2 — 再一次跨界的扩展「智能体可以管理并匹配工作任务建立自定义群进行团队会谈」 · AI主持圆桌会谈 · AI群聊（上下文感知）· AI分身 · AI PRO浏览器扩展 · AI协作平台 · AI邮箱 · 工业级巢邮箱系统 · 多标签 · 圆桌动画 · PPT回放 · 头脑风暴 · 文件架 · 轻音乐 · 新手引导 · 串串频道 · 频道广播站 · 原创作者AI · 串串汇
编辑者：AI CC咨询 · 0+1+2≠3 Team 115886
一句话：选择智能体当主持人，人类发言后 AI 主持协调多智能体讨论。 多标签并行会话，离开不丢消息，右边栏像素圆桌动画实时展示。 已支持串串频道，手机上提问 → 自动多智能体讨论 → 多频道回复。 新增AI群聊功能，智能体能看到群聊历史，像消息群聊一样连贯对话。 智能体可以管理，匹配工作任务建立自定义群。 工业智能决策巢邮箱系统。 新增6步新手引导，快速上手。 更多版本补丁【https://github.com/interccy-stack/TeamChat】
v5.2.2 (2026-07-27) + 📁 HTTP 504 修复 — 已知BUG v5.2.0 (2026-07-26) + 📁 AI群聊文件管理 — 支持上传/下载/预览文件 + 🖼️ 管理智能体 — 用户可以选择不同智能体群聊 + 👁️ 在线预览 — 图片/PDF/代码/Markdown 在线预览 + 💾 文件元数据 — 文件信息持久化存储 + 🔗 消息可以清空 — 消息到群聊可以清空 + 🏷️ 版本号升级 — v5.2.0 大版本更新
v5.1.5 (2026-07-25) + 🧠 AI群聊上下文感知 — 智能体能看到群聊历史消息，像飞书群聊一样连贯对话 + 💬 智能体互相感知 — 智能体回复时会参考之前其他智能体和用户的发言 + 📝 群聊历史传递 — 最近20条消息作为上下文传给智能体 + 🎭 角色保持 — 智能体知道自己的身份，以"我"自称回复 + 🏷️ 版本号统一 — 全链路 v5.1.5
v5.1.4 (2026-07-25) + 🧩 AI群聊智能体动态管理 — 支持添加/删除AI群聊中的智能体，不再固定5个 + 🔄 智能体持久化 — 添加/删除的智能体配置自动保存到文件 + ⚙️ 管理弹窗 — AI群聊界面新增"⚙️ 管理智能体"按钮 + 🐛 修复串串汇选择智能体渲染 — agentDetail.sessions 空值保护 + 🐛 修复串串汇字段名不匹配 — a.id → a.agent_id + 🏷️ 版本号统一 — 全链路 v5.1.4
v5.1.3 (2026-07-25) + 🤖 AI群聊 v2.0 — 内部子页面，5个智能体常驻（阿里、Executor、QA、Master、Verifier） + 💬 @提及功能 — 支持 @智能体名 指定特定智能体回复 + 🎨 小红书风格界面 — 圆角卡片式消息气泡，紫色渐变智能体标签 + 🔧 引擎初始化修复 — 模块预加载 + sys.path保障 + 错误缓存机制 + 🌐 Agent协作网络 — 顶部导航栏新增外部链接（nightly.paw.msgbyte.com） + ✨ 悬停放大特效 — TC扩展/AI协作按钮悬停1.5倍放大动画 + 🏷️ 版本号统一 — 全链路 v5.1.3（plugin.json/team_chat_main.py/index.js） + 🐛 修复串串汇智能体选择 — 前端字段名修正：a.id → a.agent_id
v5.0.19 (2026-07-23) + 🤖 AI群聊入口 — 右侧栏新增"🤖 AI群聊"按钮，一键直达Tailchat Nightly群组 + 📱 6步新手引导系统 — 首次使用自动显示，详细说明右边功能区（AI邮箱、AI群聊、串串频道等） + 📖 右边功能区说明 — 步骤5重点介绍：AI邮箱、AI群聊、串串频道、头像上传、圆桌主题、轻音乐 + 📂 历史会谈位置说明 — 明确说明部署在"串串频道"的"历史"栏 + 🔄 版本号统一 — plugin.json/manifest.json/index.js 全链路 v5.0.19
v5.0.18 (2026-07-13)
+ 🐛浏览器扩展 -AI PRO
v5.0.17 (2026-07-12)
+ 🐛写邮件有附件功能
+ 🐛修正已知错误
v5.0.16 (2026-07-13)
+ 🐛更正云端和本地的智能体API
v5.0.15 (2026-07-13)
+ 🧠AI分身跨过插件平台 — 工作搭子
+ 📊传统邮箱（收件/发件/草稿/联系人/回收站/设置）
+ 🤖智能体邮箱工业智能应用初始版本
+ 🎵修改v4.1.0的轻音乐播放问题
+ 🔄兼容QwenPaw v2.0.0智能体系统
v4.1.0 (2026-06-20) —
+ 🤖 原创作者AI页面 — AI探索者、7X24小时原创作者的分身在线,分享qwenpaw智能体
+ 📡 串串频道管理页面 — 右侧栏「📡 串串频道」入口，独立视图切换
+ ⚙️ 工作原理6步动画 — 微信消息→路由→拆解→委派→回复，渐入展示
+ 📌 前提条件详细说明 — 安装CloudPaw插件/自定义智能体/编辑SOUL.md/下载模板
+ 🔄 举一反三提示 — 飞书/钉钉/QQ/Telegram/Discord 全平台通用
+ 🎵 轻音乐音量控制 — 10%-100% Slider + 内部⏹停止 + ▶正在播放指示+简谱计算器可编写乐谱
+ 🐛 config 路径修复 — 串串频道重启后状态不再丢失
+ 📜 稻盛和夫 + 有巢哲学 — 工作原理底部双行金色名言
+ 🏷️ 版本号统一 — plugin.json/main.py/dist 全链路 v4.1.0
+ 🐛 修复 agent_id=None — config.json null → or fallback
+ 📈 串串汇 · 智能体看板 — 串串频道的串串汇，独立数据视图
v4.0.9 (2026-06-18)
+ 📑 多会话标签页 — 浏览器式标签切换，每标签独立保存状态
+ ⌨ ↑↓ 输入历史浏览 — 自动存档最近 200 条已发送消息
+ 📼 PPT 播放器 v5 — 打字机逐字动画、Canvas 粒子背景、3 级变速
+ 🎨 全局界面双主题 — ☀️ 日光 (暖白) / 🌙 月色 (深蓝) 一键切换
+ ◀ 收起小桌板 — 铂金金属按钮，280px ↔ 36px 窄条折叠
+ 📄 文件架 — 智能体产出收集 + 工作区递归扫描
+ 🎵 轻音乐 7 曲目 — 《茉莉花》等 7 首 + ✏️ 自定义简谱引擎
+ 💳 观点切换器 / 对比模式 — 刷卡翻阅智能体观点
+ 📂 历史会谈卡片美化 — 金属按钮、紧凑操作行、消息预览
+ 🔒 安全锁 — 有未完成讨论时，其他标签锁定输入
+ ⏹ 停止按钮 — AbortController 中断，脑暴防穿透
+ ⭐ 收藏夹独立 tab — 历史会谈 Modal 双标签切换
+ 💾 localStorage 会话缓存 — 离线优先，后台 API 兜底
+ 🏷️ 标签内联编辑 — Input 组件替代 prompt()
+ 🎬 一闪广告 — 首次加载闪现，永久不重复
+ 🔑 快捷键面板 — ? 键弹出速查 Modal
+ 🔔 桌面通知 — 讨论完成时推送 + 自动播音乐
+ 🏛 圆桌浮动 canvas — position:fixed 永不中断
+ 🎨 5 种圆桌主题 — 经典/海洋/森林/低碳/赛朋 金属按钮
+ ✨ 金属质感全系列 — 语音/附件/回顾/轻音乐/发送/停止 铜金按钮
+ 🧠 头脑风暴轮次 — 13px 金色加粗动态显示
+ 🐛 修复 session_id: null → HTTP 422
+ 🐛 修复未选智能体直接发 → HTTP 400 → 前端拦截
+ 🐛 修复 apiPostAbort 作用域 → 消息不通 bug
+ 🐛 修复进度条离开消失 → activeTabRef 持久化
+ 📊 /sessions 性能优化 → 精简摘要模式，响应体缩小 95%
v4.0.8 (2026-06-11) + POST /chat 即时存盘、POST /upload、标签/置顶、全文搜索 + 🏛️ 像素圆桌动画、🔥 进度条七彩渐变、📎 文件上传
┌─────────────────────────────────────────────────────────────────────────┐ │ TeamChat │ ├─────────────────────────────────────────────────────────────────────────┤ │ │ │ Browser (QwenPaw Desktop) │ │ ┌───────────────────────────────────────────────────────────────┐ │ │ │ TeamChatPage (wxView=false) ▽ │ │ │ │ ┌──────────────────────┐ ┌──────────────────────────────┐ │ │ │ │ │ Left Panel (flex:1) │ │ Right Sidebar (280px/36px) │ │ │ │ │ │ │ │ │ │ │ │ │ │ 📑 Tab Bar │ │ 📧 AI邮箱 (metal btn) │ │ │ │ │ │ ┌────────────────┐ │ │ 🤖 AI群聊 (Tailchat集成) │ │ │ │ │ │ │ Host Select │ │ │ 📡 串串频道 (green metal) │ │ │ │ │ │ │ 🧠 Brainstorm │ │ │ 👤 头像上传+预设 │ │ │ │ │ │ │ Agent Tags │ │ │ 💬 我是谁 (TextArea) │ │ │ │ │ │ └────────────────┘ │ │ 🎨 圆桌主题 (5 金属) │ │ │ │ │ │ 💬 Message List │ │ 🎵 轻音乐列表 │ │ │ │ │ │ 📋 Host Steps │ │ ◀ 收起小桌板 (铂金) │ │ │ │ │ │ ┌────────────────┐ │ │ 🏛 浮动圆桌 Canvas │ │ │ │ │ │ │ Input Area │ │ │ │ │ │ │ │ │ │ ↑↓历史 · 🎤 │ │ │ │ │ │ │ │ │ │ 📎 · ▸回顾▼ │ │ │ │ │ │ │ │ │ │ 🎵(音量)⏹停止 │ │ │ │ │ │ │ │ │ │ ▶ 发送 │ │ │ │ │ │ │ │ │ └────────────────┘ │ │ │ │ │ │ │ └──────────────────────┘ └──────────────────────────────┘ │ │ │ │ │ │ │ │ WeChatPage (wxView=true) △ │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ │ │ 📡 串串频道管理 ← 返回团队会谈 │ │ │ │ │ │ ┌───────────────┐ ┌───────────────┐ ┌───────────────┐ │ │ │ │ │ │ │ 📡 频道状态 │ │ ⚙️ 工作原理 │ │ 🏆 王牌产品 │ │ │ │ │ │ │ │ 🟢/🔴 启用 │ │ 5步动画+前提 │ │ 5大功能简介 │ │ │ │ │ │ │ │ 主控智能体 │ │ 举一反三 │ │ 隐藏技能提示 │ │ │ │ │ │ │ │ │ │ 哲学名言×2 │ │ │ │ │ │ │ │ │ └───────────────┘ └───────────────┘ └───────────────┘ │ │ │ │ │ │ ┌───────────────┐ ┌───────────────┐ │ │ │ │ │ │ │ 🎹 简谱计算器 │ │ 🔮 服务频道 │ │ │ │ │ │ │ │ 6预设+播放 │ │ a0123.png │ │ │ │ │ │ │ └───────────────┘ └───────────────┘ │ │ │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ └───────────────────────────────────────────────────────────────┘ │ │ │ │ Modals: │ │ 📂 历史会谈 (全部/⭐收藏双tab) · 💳 观点切换器 │ │ 📼 PPT 播放器 (打字机+粒子+变速) · 📄 文件架 (已收集/工作区) │ │ 🔑 快捷键面板 (Esc关闭) · 📖 README │ │ │ ├─────────────────────────────────────────────────────────────────────────┤ │ │ │ Backend (FastAPI via build_router() → prefix="/team-chat") │ │ ┌───────────────────────────────────────────────────────────────┐ │ │ │ Core: POST /chat ← 协调多智能体，即时存盘 │ │ │ │ GET /agents ← 智能体列表 (TTL 60s 缓存) │ │ │ │ Sessions: GET /sessions ← 列表 + 搜索 (精简摘要) │ │ │ │ GET /session/{id} ← 详情 (完整数据) │ │ │ │ DELETE /session/{id} │ │ │ │ PUT /session/{id}/tag │ │ │ │ PUT /session/{id}/pin │ │ │ │ POST /session/{id}/summarize ← 刷卡器 │ │ │ │ Files: POST /upload ← 文本文件上传 (11 种格式) │ │ │ │ POST /collect-file ← 工作区文件收纳 │ │ │ │ POST /collect-content ← 内容收纳 │ │ │ │ GET /download/{fn} ← 文件下载 │ │ │ │ GET /collected-files ← 已收集列表 │ │ │ │ GET /workspace-files ← 工作区扫描 (递归) │ │ │ │ Avatars: GET /avatars │ │ │ │ PUT /avatars/{id} │ │ │ │ DELETE /avatars/{id} │ │ │ │ GET /avatar/{id} │ │ │ │ POST /avatar │ │ │ │ Cron: GET /cron ← 定时任务列表 │ │ │ │ POST /cron ← 创建定时任务 │ │ │ │ DELETE /cron/{job_id} ← 删除定时任务 │ │ │ │ Wechat: GET /wechat/status ← 串串频道启用状态 │ │ │ │ AIChat: GET /ai-chat/official ← 官方聊天室信息 │ │ │ │ POST /ai-chat/join ← 加入聊天室 │ │ │ │ POST /ai-chat/message ← 发送消息 │ │ │ │ GET /ai-chat/messages ← 获取消息列表 │ │ │ │ GET /ai-chat/members ← 获取成员列表 │ │ │ │ Meta: GET /system-info ← IP + 时间戳 │ │ │ │ GET /channels ← 通信渠道 │ │ │ │ GET /readme ← README.md │ │ │ │ GET /media/{filename} ← 媒体文件 │ │ │ └───────────────────────────────────────────────────────────────┘ │ │ │ │ Data Storage: │ │ data/*.json ← 会话 (SessionStore → JSON 文件) │ │ data/collected/ ← 文件架收集 │ │ media/ ← 上传媒体 + SOUL.md + a0123.png │ │ │ ├─────────────────────────────────────────────────────────────────────────┤ │ │ │ QwenPaw Agent API (httpx.AsyncClient, trust_env=False) │ │ GET /api/agents ← 智能体发现 │ │ POST /api/agent/process ← SSE 流式 → _call_agent_async() │ │ │ └─────────────────────────────────────────────────────────────────────────┘
🔵 核心功能 (6) ┌──────────────────────────────────────────────────────────────┐ │ 1. 主持人选择 — 铜金渐变文字 + Select 下拉，⭐ 标记 │ │ 2. 智能体选择 — Tags 点击切换，前5位展开，+N 折叠按钮 │ │ 3. 发送消息 — Enter 发送 · Shift+Enter 换行 │ │ 4. 消息气泡 — 角色分色（人类棕/主机金/智能体紫） │ │ 5. 主持步骤 — Collapse 面板，步骤+详情 │ │ 6. 文件引用 — [file:xxx] 自动渲染下载按钮 │ └──────────────────────────────────────────────────────────────┘
🟠 智能功能 (6) ┌──────────────────────────────────────────────────────────────┐ │ 7. 🧠 头脑风暴 — 多轮递归讨论，13px 金色加粗轮次显示 │ │ 8. 💳 观点切换器 — 刷卡翻阅智能体发言，末页对比模式 │ │ 9. 📼 PPT 播放器 — 打字机动画 · 粒子背景 · 3级变速 · 键盘操控 │ │ 10. 📄 文件架 — 收集下载 + 工作区递归扫描，双标签 │ │ 11. ⏹ 停止按钮 — AbortController 中断，脑暴防穿透 │ │ 12. 🔒 安全锁 — 未完成讨论时其他标签锁定输入 │ └──────────────────────────────────────────────────────────────┘
🟢 体验功能 (7) ┌──────────────────────────────────────────────────────────────┐ │ 13. 📑 多标签页 — 浏览器式切换，独立会话状态 │ │ 14. ⌨ ↑↓ 历史 — ArrowUp/Down 浏览最近 200 条已发送 │ │ 15. 🎤 语音输入 — Web SpeechRecognition │ │ 16. 📎 附件上传 — 文本文件 11 种格式 │ │ 17. 🎵 轻音乐 — 7首内置+✏️自定义简谱+🔊音量Slider+⏹停止 │ │ 18. 🔔 桌面通知 — 讨论完成时推送 + 自动播当前曲目 │ │ 19. 🔑 快捷键面板 — ? 弹出，Esc 关闭 │ └──────────────────────────────────────────────────────────────┘
🟣 视觉功能 (6) ┌──────────────────────────────────────────────────────────────┐ │ 20. 🏛 圆桌动画 — Canvas 60fps，位置浮动，永不中断 │ │ 21. 🎨 圆桌主题 — 经典/海洋/森林/低碳/赛朋 金属按钮 │ │ 22. ☀️🌙 全局主题 — 日光 (暖白) / 月色 (深蓝) 全界面适配 │ │ 23. 👤 头像管理 — 预设头像 + 自定义上传 │ │ 24. ✨ 金属按钮 — 输入栏全系列 铜金金属质感 │ │ 25. ◀ 收起小桌板 — 铂金金属按钮 │ └──────────────────────────────────────────────────────────────┘
🔴 管理功能 (4) ┌──────────────────────────────────────────────────────────────┐ │ 26. 📂 历史会谈 — 搜索/标签/收藏/删除，全部/⭐收藏双tab │ │ 27. 🏷️ 标签 — 内联 Input 编辑，防穿透 │ │ 28. 📌 收藏 — ⭐/☆ 切换，金色标记 │ │ 29. 📥 导出 — showSaveFilePicker() 自选路径保存 MD │ └──────────────────────────────────────────────────────────────┘
🟤 AI群聊 (5) ← v5.1.3 新增 ┌──────────────────────────────────────────────────────────────┐ │ 30. 💬 官方聊天室 — 5个智能体常驻（阿里/Executor/QA/Master/Verifier）│ │ 31. 🎯 @提及功能 — @智能体名 指定特定智能体回复 │ │ 32. 🎨 小红书风格 — 圆角卡片式消息气泡，紫色渐变标签 │ │ 33. 🔔 实时消息 — 3秒轮询，消息持久化到 DataStore │ │ 34. 🌐 Agent协作 — 顶部导航栏链接（nightly.paw.msgbyte.com） │ └──────────────────────────────────────────────────────────────┘
🟠 串串频道 (2) ← v4.1.0 新增 ┌──────────────────────────────────────────────────────────────┐ │ 35. 📡 频道管理 — 状态监测/工作原理动画/前提条件/举一反三 │ │ └──────────────────────────────────────────────────────────────┘
核心: POST /chat ChatRequest {message, host_id, agent_ids, session_id, host_name, brainstorm} GET /agents 智能体列表 (TTL 60s)
会话管理: GET /sessions?search= 列表 + 搜索 (精简摘要: session_id, tag, pinned, message_count, last_message, created_at, updated_at, agent_ids) GET /session/{id} 详情 (完整 history + host_steps) DELETE /session/{id} 删除 PUT /session/{id}/tag TagUpdate {tag} PUT /session/{id}/pin PinUpdate {pinned: bool} POST /session/{id}/summarize SummarizeRequest {host_id}
文件: POST /upload multipart (11 种格式, ≤5MB) POST /collect-file WorkspaceFileRequest {path, label} POST /collect-content ContentCollectRequest {content, filename} GET /download/{filename} 文件下载 GET /collected-files 已收集列表 GET /workspace-files?path= 工作区递归扫描
头像: GET /avatars 全部头像 PUT /avatars/{id} AvatarUpload {data_url} DELETE /avatars/{id} 删除（恢复默认） GET /avatar/{id} 下载 POST /avatar multipart (jpg/png, 200×200)
Cron (定时头脑风暴): GET /cron 任务列表 POST /cron CronJobReq {job_id, schedule, agent_ids, prompt, host_id} DELETE /cron/{job_id} 删除任务
串串频道 (v4.1.0): GET /wechat/status 频道启用状态 + 主持智能体
AI群聊 (v5.1.3): GET /ai-chat/official 官方聊天室信息 POST /ai-chat/join 加入聊天室 POST /ai-chat/message 发送消息 (支持 @提及) GET /ai-chat/messages 获取消息列表 GET /ai-chat/members 获取成员列表
系统: GET /system-info IP + 时间戳 GET /channels 通信渠道列表 GET /readme README.md GET /media/{filename} 媒体文件 (SOUL.md, a0123.png 等)
后端: • Pydantic 模型必须模块级别 — 嵌套在函数内 → UnboundLocalError • Form() 与 JSON 不兼容 — 前端 JSON body 必须用 Pydantic 接收 • httpx trust_env=False — QwenPaw Desktop 有 Privoxy 代理 • SessionStore 文件级 JSON — data/*.json, 内存缓存 + 同步写盘 • MAX_HISTORY = 500 — 单会话最多保留 500 条消息 • /sessions 返回精简摘要 — 不含 history/host_steps, 响应体缩减 95% • /session/{id} 返回完整数据 — 加载历史时获取全部消息 • pinned 强制 bool(s.get("pinned")) — 防 mixed type TypeError • agent_id or fallback — config.json null 时用 "cloud-orchestrator" • config 路径双级 os.path.dirname — 修复串串频道重启后状态丢失 (v4.1.0)
AI群聊 (v5.1.3): • 模块预加载机制 — 启动时预导入 ai_group_chat，避免运行时延迟导入失败 • sys.path 动态保障 — 插件隔离环境下手动添加插件目录到 sys.path • 错误缓存机制 — _ai_engine_error 缓存初始化失败原因，避免重复报错 • 5个常驻智能体 — ali、executor、qa、master、verifier 常驻聊天室 • @提及解析 — 正则 /@(\w+)/ 解析消息中的提及，指定特定智能体回复 • DataStore 持久化 — ai_chat_data.json 存储消息历史，3秒轮询实时同步 • 小红书风格 UI — 圆角卡片、紫色渐变标签、悬停放大特效
前端: • snap ref 防闭包过期 — saveTab() 读 useRef 不读闭包 • activeTabRef 实时 tabId — unmount cleanup 用 ref 获最新值 • syncActiveTab 每回调落地 — 4 个写入点 (普通/脑暴每轮/脑暴完成/汇总) • _abortRef 桥接 IIFE 作用域 — 解决 apiPostAbort 访问不到组件 abortRf • stopRef 脑暴防穿透 — round() 入口检查 stopRef.current • localStorage 会话缓存优先 — 离线下仍可浏览历史列表 • 安全锁 busyRef 三层防御 — UI 禁用 + 橙条警告 + send 拦截 • 圆桌 canvas 永远不 unmount — position:fixed 常驻，仅 CSS 切换位置 • 广告 localStorage 一次性 — teamchat_ad_shown 永久标记 • getApiUrl 动态端口解析 — 下载链接跨版本/端口自动适配
串串频道 (v4.1.0): • 视图切换而非路由 — QwenPaw registerRoutes 不支持 hash 导航 • wxView state 控制 — false→TeamChatPage, true→WeChatPage • 与游戏平台 Lobby↔Room 同模式 — 不依赖 Router，React 原生状态切换 • 串串频道使用 QwenPaw 内置 — 通过 /api/channels/wechat/ 路由 • cloud-orchestrator 负责主持 — SOUL.md + PROFILE.md 写入主持人规则 • 举一反三全平台 — 飞书/钉钉/QQ/Telegram/Discord 同原理
轻音乐引擎 (v4.1.0): • volRf 音量 ref — 同步 localStorage teamchat_music_vol • Slider 0.1-1.0 — tooltip 显示百分比 • gain.gain 动态应用音量 — 替代硬编码 0.25 • Popover 内部 ⏹ 停止按钮 — 红色 danger，播放中才出现 • ▶ 正在播放: [曲名] — 红色加粗居中指示条
localStorage 键名汇总: teamchat_tabs, teamchat_last_session, teamchat_sessions_cache, teamchat_shortcut_hint, teamchat_custom_song, teamchat_music_vol, ← v4.1.0 新增 teamchat_ad_shown
运行目录:
team_chat/
├── plugin.json # 插件清单（合规）
├── team_chat_main.py # 后端入口（FastAPI 路由 + PluginApi 注册）
├── ai_group_chat.py # AI群聊引擎（v5.1.3 新增）
├── __init__.py
├── README.md # 历史版本说明
├── email_backend/ # 邮箱后端模块
├── frontend/
│ └── dist/
│ └── index.js # 前端构建产物（561KB）
├── extension/ # Chrome 扩展
├── bookmarklet/ # 书签工具
├── avatars/ # 智能体头像
├── data/ # 会话数据存储
│ └── ai_chat_data.json # AI群聊消息持久化（v5.1.3 新增）
├── docs/ # 架构与开发文档
├── tests/ # 测试模块
├── media/ # 媒体资源
├── files/media/ # 文件媒体
├── aifenshen_pet.py # AI 分身桌面宠物
├── email_server.py # 邮箱服务
├── email_skill.py # 邮箱技能
├── reset_ai_avatar.js # 头像重置脚本
└── pigeon_thumb.png # 鸽子缩略图
================================================================================
七、升级 / 部署
================================================================================
部署步骤:
1. 修改源码 (dist/index.js 或 main.py)
2. 语法验证:
node -e "var fs=require('fs');new Function(fs.readFileSync('dist/index.js','utf8'))"
python -c "import py_compile;py_compile.compile('main.py',doraise=True)"
3. 同步到运行目录 (如不直接编辑运行目录):
copy /Y dist\index.js %USERPROFILE%\.qwenpaw\plugins\team_chat\frontend\dist\index.js
copy /Y main.py %USERPROFILE%\.qwenpaw\plugins\team_chat\main.py
4. 清除缓存:
rmdir /S /Q %USERPROFILE%\.qwenpaw\plugins\team_chat\__pycache__
彻底清除浏览器缓存
方式一：打开开发者工具强制刷新
按 F12 打开开发者工具
右键刷新按钮 → 「清空缓存并硬性重新加载」 （或者：在 Network 选项卡勾选 Disable cache，然后刷新）
方式二：手动清除
按 Ctrl + Shift + Del 打开清除浏览数据
勾选 缓存的图片和文件
时间范围选「所有时间」
点「清除数据」
方式三：无痕模式测试
复制 QwenPaw 地址
打开一个新的 无痕/隐私窗口
粘贴地址打开
5. 重启 QwenPaw Desktop
6. 浏览器 Ctrl+Shift+R 硬刷新
================================================================================
八、测试计划 (9 轮 40+ 项)
================================================================================
┌─ 第一轮：基础烟囱 ──────────────────────────────────────────┐
│ T1.1 页面加载 — 无崩溃，主持人/智能体有数据，圆桌动画运行│
│ T1.2 基础发送 — 输入→回复→步骤面板→JSON落盘 │
│ T1.3 未选拦截 — 无智能体发送→400拦截提示 │
└──────────────────────────────────────────────────────────────┘
┌─ 第二轮：标签页 ────────────────────────────────────────────┐
│ T2.1 新建标签 — + 新标签空白，旧标签不变 │
│ T2.2 状态隔离 — 两标签独立发送，切换后各自保持 │
│ T2.3 关闭标签 — 自动切到相邻标签 │
│ T2.4 重命名 — 内联 Input 编辑，持久化 │
│ T2.5 si 不丢失 — 标签A发送后切回，si不变 │
└──────────────────────────────────────────────────────────────┘
┌─ 第三轮：历史会谈 ──────────────────────────────────────────┐
│ T3.1 Modal 弹出 — 金属按钮，自动加载 │
│ T3.2 搜索 — 关键词过滤正确 │
│ T3.3 标签 & 收藏 — 内联编辑 + ⭐/☆ 切换 │
│ T3.4 加载历史 — 新标签页打开，完整恢复 │
│ T3.5 删除 — 确认→消失，取消→不变 │
│ T3.6 全部/收藏tab — 切换过滤正常，空状态提示 │
└──────────────────────────────────────────────────────────────┘
┌─ 第四轮：头脑风暴 ──────────────────────────────────────────┐
│ T4.1 基础脑暴 — 选≥2智能体→开脑暴→进度条七彩→轮次显示 │
│ T4.2 停止按钮 — 点击⏹→立即中断，不继续下一轮 │
│ T4.3 安全锁 — 脑暴进行中→其他标签橙条+输入禁用 │
└──────────────────────────────────────────────────────────────┘
┌─ 第五轮：刷卡器 & 回顾 ─────────────────────────────────────┐
│ T5.1 查看结果 — 脑暴完成→回顾▼→查看结果 │
│ T5.2 观点对比 — 逐张刷卡翻阅，末页对比模式 │
│ T5.3 导出 MD — 自选路径保存 │
└──────────────────────────────────────────────────────────────┘
┌─ 第六轮：PPT 播放器 ────────────────────────────────────────┐
│ T6.1 打字机 — 消息逐字出现，闪烁光标▎ │
│ T6.2 粒子背景 — 60 个光点漂浮 │
│ T6.3 键盘控制 — ← → Space 1/2/3 Esc │
│ T6.4 双主题 — ☀️日光 / 🌙月色 一键切换 │
│ T6.5 导出 — showSaveFilePicker 自选路径 │
└──────────────────────────────────────────────────────────────┘
┌─ 第七轮：文件架 ────────────────────────────────────────────┐
│ T7.1 已收集列表 — 回顾▼→文件架→已收集tab │
│ T7.2 工作区扫描 — 🔍→递归扫描→📥收集 │
│ T7.3 下载 — 📥→自选路径保存 │
│ T7.4 文件引用 — [file:xxx] 自动下载按钮 │
└──────────────────────────────────────────────────────────────┘
┌─ 第八轮：侧边栏 & 动画 ─────────────────────────────────────┐
│ T8.1 收起小桌板 — 铂金按钮→收缩36px │
│ T8.2 圆桌不中断 — 收缩→展开→动画立即恢复 │
│ T8.3 圆桌主题 — 5 种切换 (经典/海洋/森林/低碳/赛朋) │
│ T8.4 全局主题 — ☀️日光→全界面暖白·🌙月色→全界面深蓝 │
│ T8.5 金属按钮 — 输入栏6个按钮铜金质感一致 │
└──────────────────────────────────────────────────────────────┘
┌─ 第九轮：输入 & 音乐 & 串串频道 ────────────────────────────┐
│ T9.1 ↑↓历史 — 发送3条→↑逐条回溯→↓前进→底端恢复草稿 │
│ T9.2 🎤语音 — 请求麦克风→识别→填入 │
│ T9.3 📎附件 — 选择文件→上传→成功提示 │
│ T9.4 🎵轻音乐 — 7首曲目切换→播放→🔊调音量→⏹停止 │
│ T9.5 ✏️自定义简谱 — 输入数字简谱→播放 │
│ T9.6 🔑快捷键面板 — ? 弹出→Esc 关闭 │
│ T9.7 🔔桌面通知 — 讨论完成→通知+音乐 │
│ T9.8 📡串串频道 — 点击入口→状态显示🟢→工作原理动画可播放 │
│ T9.9 🎹简谱计算器 — 预设切换→音阶切换→播放/停止 │
│ T9.10 🔮服务频道 — 图片加载→点击跳转 agent.bh-jk.com │
└──────────────────────────────────────────────────────────────┘
================================================================================
TeamChat v5.2.0 — 2026-07-26 — 0+1+2≠3 Team 115886
================================================================================