微信群AI助手（AIworkin）

概述

基于 WorkBuddy 微信助理传入的微信群聊天记录，做内容分析 / 群聊总结 / 沟通纪要，并可根据需要把结果发到微信公众号（发布链路复用子技能包 aipdd-gzh-ai：24 套排版主题 + 官方 API 发布）或沉淀为腾讯在线文档（文档化链路复用子技能包 tencent-docs，即腾讯文档 docs.qq.com MCP 能力：智能文档/表格/PPT/思维导图/流程图/Word）。两子技能包位于本技能包根目录下的 aipdd-gzh-ai/ 与 tencent-docs/，保持原位引用，不复制。

本技能包的默认模型网关是 AIPDD（BaseURL https://api.aipdd.work）：文本/多模态、图片生成与编辑、视频、语音合成与识别（ASR）、向量、决策等能力经统一客户端 scripts/aipdd_gateway.py 提供，作为基础模型层在归一化、分析、发布、文档化各环节按需增强产物质量（详见 [references/aipdd-gateway.md](references/aipdd-gateway.md) 与 [references/aipdd-gateway-workflows.md](references/aipdd-gateway-workflows.md)）。用户在 app.aipdd.work 注册→「全局设置-API Key 管理」生成 Key，交给智能体静默存入包根 config.json 即长期复用。

• 本技能包根目录 = <SKILL_ROOT>（即本文件所在目录），子技能包根目录 = <SKILL_ROOT>/aipdd-gzh-ai/（下称 <AIPDD_ROOT>）与 <SKILL_ROOT>/tencent-docs/（下称 <TD_ROOT>）。
• 核心资产是 references/ 下的规则文件：输入归一化 chat-record-normalize.md、分析框架 analysis-framework.md、总结规范 summary-guide.md、纪要模板 meeting-notes.md、发布衔接 publish-guide.md、文档化衔接 tencent-docs-guide.md、AIPDD 模型网关基础层 aipdd-gateway.md + 联动 aipdd-gateway-workflows.md；脚本 scripts/parse_chat.py（解析）、scripts/configure.py（网关 Key 配置与模型目录）、scripts/aipdd_gateway.py（网关统一客户端）。
• 本 SKILL.md 只负责流程与决策，具体解析规则、分析维度、模板格式一律从 references 取用，分析质量靠框架不靠临场发挥。

搜索关键词索引（检索与触发用）

用户询问/搜索以下词（中英文均可）即命中本技能，按场景对应到下文工作流：

正文各步骤与 references 文件均已按此关键词体系命名（_内容分析.md / _总结.md / _沟通纪要.md），便于文件级检索。

工作流总览（语义路由）

AIPDD 模型网关（基础模型层，贯穿全链路的加速器）

本包默认模型后端为 AIPDD（BaseURL https://api.aipdd.work），提供文本/多模态、图片生成/编辑、视频、语音识别（ASR）、语音合成（TTS）、向量、决策七类能力，经零依赖客户端 scripts/aipdd_gateway.py 调用。它是基础模型层、不是新业务方向——只在既有链路里提升产物质量，规则详见 [references/aipdd-gateway.md](references/aipdd-gateway.md)（配置/端点/安全/排错）与 [references/aipdd-gateway-workflows.md](references/aipdd-gateway-workflows.md)（逐链路挂接点）。

• 首次使用/报未配置 Key：先按 gateway 文档第 1 节告诉用户「app.aipdd.work 注册 → 全局设置-API Key 管理生成 → 发给我保存」，拿到 Key 后静默写入：printf '%sn' "<Key>" | python3 scripts/configure.py init（存入包根 config.json，0600、不进版本库/分发包，下次自动复用，不回显明文）。
• 模型不写死：用哪模型、支持何能力，一律先 python3 scripts/configure.py catalog（或 aipdd_gateway.py models）实时取，上新/下线无需改本包文件。
• 先问再跑：转写/图片描述/配图/语音合成都消耗额度，默认不自动调，需先告知用户再跑；产物必回原文溯源。
• 挂接位置：第二步归一化（语音 ASR、图片多模态描述）、第三步分析（文本模型概览、向量聚类）、第五步发布（封面图）、第六步文档化（插图）。

第一步：输入语义路由（先判断要什么，再看手里有什么）

开工前先判断需求类型（内容分析 / 群聊总结 / 沟通纪要，可多选），再确认素材；素材缺失时不猜，直接向用户索要：

• 用户已给聊天记录（文件路径、粘贴文本、WorkBuddy 转发内容）→ 进入第二步归一化；产出模式没明说时用 AskUserQuestion 一次问清：内容分析 / 群聊总结 / 沟通纪要 / 全都要（推荐「全都要」给信息量最大场景，选项给推荐项 + 备选）。
• 用户只说要什么、没给素材（如「把昨晚群里讨论做个纪要」）→ 向用户索要聊天记录：让用户把聊天记录发来（WorkBuddy 转发文件/文字，或直接粘贴），并提示可接受格式（txt/csv/json/md/docx/纯文本粘贴）。
• 产出模式按用户原话拆解：明确说「只要总结不用纪要」→ 只做总结；「纪要带行动项」→ 纪要模式必须输出行动项表；「分析+总结」→ 两者都做，同一份归一化数据复用，不重复解析。

第二步：数据归一化（所有链路共用）

读 [references/chat-record-normalize.md](references/chat-record-normalize.md) 按其规则执行。要点：

1. 格式识别：txt 导出（微信/企业微信/第三方导出）、CSV/表格、JSON、Markdown、docx、纯粘贴文本。识别不了按粘贴文本处理并明示假设。
2. 统一 schema：每条消息 = {时间, 发言人, 类型(文本/图片/文件/链接/语音转文字/系统), 内容}；时间戳模式、发言人分隔符、回复引用、@提及、表情等的解析规则见 normalize 文件。
3. 执行解析：文件类输入跑 scripts/parse_chat.py <输入文件> → 产出 {文件名}_messages.json（完整数据）与 {文件名}_消息列表.md（Markdown 时间线，超长自动截断，完整版保留在 json）。粘贴文本手工按统一 schema 整理（或粘贴进临时文件跑脚本）。
4. 质量检查：时间跨度（最早/最晚）、消息总数、有效发言人数量、未解析行占比——未解析行 > 5% 时向用户确认是否有特殊格式，不把脏数据直接喂给分析。
5. 归一化结果在对话中整理为分析用摘要视图（按时间排序的时间线，合并连续同一人消息，标注关键消息类型），供用户快速核对；随后进入第三步。
6. 多模态补全（可选，走 AIPDD 网关）：语音/音频消息无转写文本时，用 scripts/aipdd_gateway.py asr 转写为 voice_text 消息；图片消息要纳入分析时，用 aipdd_gateway.py text --image 生成描述。两者都先告知用户会消耗网关额度、得同意再跑，产出标注 AI 生成并待人工核实（详见 references/aipdd-gateway-workflows.md）。

第三步：分析模式路由（按需求选框架）

每选一个模式，读对应 reference 文件并按其框架/模板执行：

模式一：内容分析（读 [references/analysis-framework.md](references/analysis-framework.md)）

对归一化消息列表按框架分析，输出 Markdown 报告（{文件名}_内容分析.md）：

1. 概况：时间跨度、消息总数、参与人数、发言分布（TOP 发言者）
2. 话题聚类：识别 3–8 个主要话题（按消息聚集度），每个话题给热度（消息数占比）、时间区间、核心内容摘要、关键发言人
3. 关键信息抽提：结论/决策、数字与事实、日期与安排、资源与链接
4. 情绪与氛围：整体情绪基调（积极/中性/激烈/冲突）、情绪波动点（时间+事件）
5. 成员参与度：活跃成员（发言数/被@数）、潜水成员、讨论角色（发起者/推动者/决策者/反对者）
6. 风险与待办：未决争议、遗漏答复、承诺未兑现、需跟进事项
7. 讨论走向：话题演替、有无闭环、当前群聊所处阶段

模式二：群聊总结（读 [references/summary-guide.md](references/summary-guide.md)）

按用户要求的周期/主题输出总结（{文件名}_总结.md）：默认日报结构（今日重点 → 讨论话题 → 新信息/变化 → 共识与行动 → 明日关注），周报/专题按模板切换；语气客观中性，不夸大不遗漏，行动项必须可执行可追踪。

模式三：沟通纪要（读 [references/meeting-notes.md](references/meeting-notes.md)）

输出结构化纪要（{文件名}_沟通纪要.md）：会议信息（时间/群组/参与人/主持人）→ 议题清单 → 各议题讨论摘要 → 共识结论 → 行动项表（事项/负责人/截止时间/状态） → 待跟进问题。行动项必须从消息真实可溯，每条行动项附消息时间戳与发言人；无行动项明确写「本期无行动项」，不编造。

组合执行

多模式组合按「分析 → 总结 → 纪要」依赖顺序执行：内容分析做底（话题/关键信息复用），总结取其重点，纪要取其结论与行动项；交付一份总报告（头部列模式清单，各模式为独立章节）。

第四步：交付确认

• 交付 Markdown 报告 + 执行说明（用了哪些模式、解析假设、无法确认处标注「待人工核实」）。
• 用户确认或提出调整（改长度、补模式、换结构）后，任务完成——除非用户说「发微信/发文章」。
• 用户只要报告就停在 Markdown，不进发布链路。

第五步：文章化发布（衔接子技能包 aipdd-gzh-ai）

用户说「发微信 / 发文章 / 通知大家 / 把这个发到公众号」，或一键模式下用户主动要求发布时，进入发布衔接。读 [references/publish-guide.md](references/publish-guide.md) 按其执行：

1. 确认发布对象：公众号文章（走 aipdd-gzh-ai 全链路）vs 仅需简要微信消息回复（直接改写短文即可，不走 aipdd-gzh-ai）。默认公众号文章。
2. 进入子技能包：子技能包 aipdd-gzh-ai 位于 <SKILL_ROOT>/aipdd-gzh-ai/（保持原位引用，不要复制）。入口 <AIPDD_ROOT>/aipdd-gzh-ai_SKILL.md，其脚本/组件库/配置一律用绝对路径调用：<AIPDD_ROOT>/scripts/validate_gzh_html.py、<AIPDD_ROOT>/references/theme-index.md 等。
3. 素材交接：把本包产出的纪要/总结/分析报告作为写作素材传给 aipdd-gzh-ai（即其「输入语义路由」链路 A 素材），按 aipdd-gzh-ai 工作流执行：写作风格选择（纪要/结论类推荐理性分析或干货清单，通知/公告类可直接排版不写作）→ 排版（主题按题材推荐）→ 校验到 0 ERROR → 发布（默认草稿箱，--publish 直发需用户显式要求）。
4. 封面/配图（可选，走 AIPDD 网关）：无现成封面图时，除子包 PIL 兜底，可用 <SKILL_ROOT>/scripts/aipdd_gateway.py image（尺寸取模型 capabilities，如 1536×1024 横版）生成更高质量封面/文中配图，生成后走 wechat_publish.py --thumb 上传（先告知用户消耗额度、得确认再跑）。
5. 核实与边界：文中涉及群内他人言论、公司事务、敏感信息时，发布前提醒用户核对事实与授权，不擅自把群聊内容原样外发。

第六步：文档化产出（衔接子技能包 tencent-docs）

用户说「做成文档 / 存成腾讯文档 / 整理成在线文档 / 出个在线表格 / 做成PPT / 发个文档链接」，或一键模式下用户主动要求文档化时，进入文档化衔接。读 [references/tencent-docs-guide.md](references/tencent-docs-guide.md) 按其执行：

1. 确认文档形式：智能文档 / 在线表格 / PPT / Word / 思维导图 / 流程图，意图不明时 AskUserQuestion 一次问清；整合场景默认智能文档。
2. 进入子技能包：子技能包 tencent-docs 位于 <SKILL_ROOT>/tencent-docs/（保持原位引用，不要复制）。入口 <TD_ROOT>/tencent-docs_SKILL.md；首次使用先鉴权（bash <TD_ROOT>/setup.sh tdoc_check_and_start_auth → 用户确认后再 tdoc_fetch_token，详见 <TD_ROOT>/references/auth.md）。
3. 素材交接：把本包产出的纪要/总结/分析报告作为文档创建素材，按「群聊产物→文档映射」选品类（纪要/总结→智能文档、行动项→在线表格、话题结构→思维导图、流程→流程图、汇报→PPT、正式通知→Word）→ 读对应品类入口执行 → 工具参数用 mcporter list 现场拉取。需要示意图/封面时，可用 <SKILL_ROOT>/scripts/aipdd_gateway.py image 生成后按 tencent-docs 图片上传流程插入（纯文字纪要无需配图，不强加）。
4. 交付：文档可点击链接 + 简述（品类、结构、匿名化说明）；涉及群内他人言论时提醒用户核对隐私范围，发言人默认匿名化。

通知自动流程（WorkBuddy 微信助理场景）

WorkBuddy 微信助理收到群聊相关内容通知（转发的聊天文件、粘贴的群聊文本、语音转文字，或用户指令「处理一下群里最新消息」）时，按以下规则自动处理：

1. 判定内容：是否为群聊记录（时间戳+发言人特征）。是 → 继续；不是 → 按普通消息回复，不启动分析。
2. 确认模式：按用户预置偏好执行（如「默认总结+纪要」），没预置时问一句：内容分析 / 群聊总结 / 沟通纪要 / 全都要；用户消息里带「总结」「纪要」「行动项」等词 → 跳过提问按对应模式执行。
3. 自动执行 ②→④：归一化 → 分析 → 交付报告。
4. 发文/文档化指示：用户说「发文章」或预置「自动发文」→ 进入第五步发布衔接；用户说「做成文档」或预置「自动文档化」→ 进入第六步文档化衔接；用户说「先放着」→ 停在报告交付。

一键模式与工作流组合

• 一键模式（用户说「直接搞定 / 全部自动 / 一条龙」）：按输入语义路由判定 → 全套模式（默认 内容分析+群聊总结+沟通纪要）→ 归一化 → 分析 → 交付总报告；发布/文档化需用户显式要求或预置，否则停在报告。
• 通知 → 分析 → 发文：WorkBuddy 通知到达 → 分析交付 → 用户确认后发文，是最高频组合路径。
• 分析 → 总结 → 纪要 → 文章发布：全程组合，报告确认后直接衔接 aipdd-gzh-ai 发布。
• 分析 → 总结 → 纪要 → 文档化：全程组合，报告确认后衔接 tencent-docs 生成腾讯在线文档（默认智能文档，素材同一份产物）。

多群批量编排

用户一次给出多个群的聊天记录（≥2 份）时：

1. 询问意图（AskUserQuestion 一次问清）：全部统一处理（同模式逐群执行）/ 只处理某几份 / 合并成一份总报告（跨群横向对比：各群话题、活跃度、协作关系）。
2. 统一处理后按用户给序逐群执行，每群独立产出文件（文件名互不覆盖：{文件名}_内容分析.md 等）；合并模式额外产出一份横评报告（多群汇总_对比分析.md）。
3. 发文场景：多群合并报告逐篇生成文章进草稿箱（批量发布一律停草稿箱，规避订阅号每日 1 次发布限制），交付草稿清单。
4. 文档化场景：多群合并报告默认生成一份整合智能文档（分群分章节）；如需逐群独立文档（≥2 份）先询问用户，批量创建时逐群串行调用 create_smartcanvas_by_mdx 并交付链接清单。

常见问题