baoyu-wechat-summary Checked

| Priority | Path | Scope |

|----------|------|-------|

| 1 | .baoyu-skills/baoyu-wechat-summary/EXTEND.md (relative to project root) | Project |

| 2 | ${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-wechat-summary/EXTEND.md | XDG |

| 3 | $HOME/.baoyu-skills/baoyu-wechat-summary/EXTEND.md | User home |

| Result | Action |

|--------|--------|

| Found | Read, parse, apply. On first use in session, briefly remind: "Using preferences from [path]. Edit it to change defaults." |

| Not found | **MUST** run first-time setup (BLOCKING) before generating any digest — do NOT silently use defaults. |

### Supported keys

EXTEND.md is plain text with key: value or key=value lines, # for comments, case-insensitive keys.

| Key | Type | Default | Purpose |

|-----|------|---------|---------|

| self_wxid | string | (required) | The owning account's wxid. Messages whose from_wxid matches this are attributed to the user. |

| self_display | string | (required) | Display name to substitute for the user's own messages in digest text. |

| default_version | normal / roast / both | normal | Which version(s) to generate when the user doesn't say otherwise. |

| default_time_range | string (e.g. 7d, 24h, 1d) | (none) | Default range when the user omits time and there's no incremental anchor. |

| data_root | path | {project_root}/wechat | Override where digest folders live. |

| bot_aliases | comma-separated strings | bot, 精华bot | Names that trigger the 「@bot 答疑」 section. A message containing @<alias> (case-insensitive) is treated as a question/request aimed at the digest bot. Pick names that do NOT match any real group member or existing bot, to avoid ambiguity. |

A starter template lives at EXTEND.md.example (EXTEND.md.example).

### First-Time Setup (BLOCKING)

If no EXTEND.md is found, do NOT silently proceed.

**Step A — Try to auto-discover self_wxid and self_display first.** Run (in order, stop at the first that succeeds):

# 1. If wx-cli exposes a whoami, use it
wx whoami --json 2>/dev/null

# 2. Otherwise, find self-sent messages in recent sessions
wx sessions --json --limit 20 2>/dev/null

For option 2, scan the sessions for any private/group thread the user has sent into and read one of their own from_wxid / from_nickname pairs. If you can confidently pre-fill both values, use them as defaults in the question below; otherwise leave the fields blank for the user to fill in.

**Step B — Confirm with one AskUserQuestion call (batched), pre-filling whatever auto-discovery found:**

• self_wxid (e.g., wxid_abc123) — fall-back hint: the user can find it with wx contacts --query "<own nickname>", or by inspecting any of their own sent messages in wx sessions --json
• self_display (e.g., 宝玉) — how they want their messages attributed
• default_version — pick one of normal / roast / both
• data_root — where digest folders live. Default: {project_root}/wechat. Enter a custom absolute path (e.g. ~/Documents/wechat-digests) or leave blank for default.
• Save location — pick one of project / XDG / home

Write EXTEND.md to the chosen path. If the user provided a non-default data_root, include it as an uncommented line; otherwise omit it (the default applies automatically). Confirm "Preferences saved to [path]. Edit it any time to change defaults.", then continue with the digest workflow.

Workflow

### Step 1: Parse the user's request

Extract:

• **Group name** (or partial name for fuzzy matching)
• **Time range** — interpret flexibly:
• "最近 1 天" / "今天" / "last 24 hours" → 1 day
• "最近 3 天" → 3 days
• "最近 7 天" / "这周" → 7 days
• "最近 30 天" / "最近一个月" → 30 days
• "某天" (e.g. "3 月 5 号") → that specific date
• "某天到某天" (e.g. "3 月 1 号到 3 月 5 号") → date range
• "从上次开始" / "继续" / "接着上次" / "since last" → **incremental mode**: read history.json for this group, use last_digest.last_message_time as the start
• No time specified → **incremental mode**. If no history.json exists yet, fall back to default_time_range from EXTEND.md if set, else last 24 hours.
• **Version(s) to generate**:
• Start from default_version in EXTEND.md.
• User request overrides: keywords "毒舌"/"roast"/"挑衅"/"再来个毒的"/"sass" → force include_roast=true. Keywords "只要正经的"/"normal only"/"不要毒舌" → force include_normal=true, include_roast=false. "都来一份"/"两个版本都要"/"both" → both.
• At least one of include_normal/include_roast must end up true.

Convert relative ranges into absolute --since YYYY-MM-DD --until YYYY-MM-DD pairs using today's local date.

### Step 2: Find the group + resolve folder path

wx contacts --query "<group_name>" --json

Filter for entries whose username ends in @chatroom. If multiple groups match, use AskUserQuestion to disambiguate. If none match, fall back to wx sessions --json and search there before asking the user.

Once resolved, compute the folder path:

{data_root}/{group_id}-{sanitized_group_name}/

where data_root is from EXTEND.md (default {project_root}/wechat).

**Sanitize the group name** — replace any of / \ : * ? " < > | NUL and control characters with _. Trim trailing dots and whitespace. Don't strip emoji or Chinese characters.

**Group-rename detection**: list existing folders under {data_root}/ and find any folder whose name starts with {group_id}-. If one exists but the suffix differs (group was renamed), rename the existing folder to the new {group_id}-{sanitized_new_name} form. If a target with the new name already exists (rare), keep both and prefer the existing one for this run.

### Step 2.5: Look up the group owner（群主）

群主是谁**必须有据可查**，不能凭历史摘要、群友玩笑或印象推断（群主可能换届，历史摘要里的说法会过期）：

wx members "<group_name_or_id>" --json

• 检查输出中是否有 owner / role 字段标识群主；有则以此为准
• 如果 wx-cli 版本不暴露群主信息，则