baoyu-wechat-summary

What it does

Summarizes WeChat group chat highlights into a structured digest using the local wx-cli binary. By default, it generates a normal digest; a roast version is optional. It maintains per-group history and per-user profiles across runs, with privacy guardrails baked in. It is invoked when the user asks to summarize a group chat and provides options to use a roast version when requested.

How it works

• Verifies environment prerequisites for wx-cli, ensuring wx-cli is installed, the ~/.wx-cli directory is correctly owned, and wx-cli is initialized with WeChat running.
• Reads user preferences from EXTEND.md to determine default version (normal, roast, or both) and data_root location. If EXTEND.md is missing, it blocks until setup provides preferences.
• Parses the user’s request to extract a group name and a time-range (e.g., 今天, 最近7天, 某天到某天) and determines the digest version to generate based on default settings and user keywords (毒舌/roast to include roast; 只要正经的/normal only to exclude roast; 都来一份/both for both).
• Resolves the target group by querying wx contacts for the group and filtering for chatrooms, handling disambiguation if needed. Computes a folder path as {data_root}/{group_id}-{sanitized_group_name}/ and renames folders if the group name changes.
• Fetches messages using wx history with appropriate --since and --until dates, handling incremental mode by referencing history.json’s last_message_time and skipping messages older than that. For large ranges, processes in chunks and uses a per-3-day digest strategy to maintain quality.
• Parses message schema fields (id, from_wxid, from_nickname, content, timestamp, chat_type, quote/reply fields) and formats timestamps for display. Replaces sender display with self_display for the user’s messages.
• Loads sender profiles from profiles/ and, if roast is enabled, profiles-roast/.md files for active users in the batch, building an internal profile context not shown in the final digest.
• Detects potential in-chat digests in-history to avoid duplication, and can prompt the user to anchor to a different start time if found.
• Detects and handles @bot requests by collecting them in an internal list for a dedicated section in the digest, using aliases from EXTEND.md (default bot, 精华bot).

When to use it

Use when the user asks to summarize or extract highlights from a WeChat group, mentions a time range, or asks to backfill/initialize user profiles. Trigger phrases include: Chinese terms like "总结群聊", "群聊精华", "群聊摘要" and English equivalents like "summarize group chat", "group chat digest"; and also when the user mentions a specific group name with a time range or asks to backfill portraits.

What it can touch

• Executes the wx-cli binary (wx) to fetch history and metadata, requiring dangerouslyDisableSandbox: true due to sandbox restrictions. Commands referenced include: "wx --version", "wx sessions", "wx history". The folder structure for digests is {data_root}/{group_id}-{sanitized_group_name}/, with subfolders like profiles/ and profiles-roast/ for per-user data. The system reads and writes history.json, history-digests.jsonl, and per-user profile files in those folders.

Caveats

• wx-cli relies on macOS user-owned data directories outside the sandbox; running commands requires explicitly disabling sandbox. The user is warned to use /sandbox to adjust restrictions.
• The behavior depends on EXTEND.md for defaults; if missing, first-time setup is blocking and requires user input to provide self_wxid, self_display, default_version, and data_root.
• Large digests may be chunked to avoid token budget issues; incremental mode assumes history.json exists or falls back to default_time_range if not present.
• The roast version is optional and must be explicitly requested; otherwise, non-roast output is generated by default.