weflow-cli 1.5.0 → 1.6.1

package/scripts/chat_stats.py

@@ -1,702 +1,702 @@
-#!/usr/bin/env python3
-"""
-微信个人信息消费报告 — 统计消息量、聊天对象、公众号阅读偏好、活跃时段。
-
-用法:
-  python scripts/chat_stats.py --period week
-  python scripts/chat_stats.py --period month
-  python scripts/chat_stats.py --period month --output output/报告.md
-
-输出: output/微信报告_<周期>.md
-"""
-
-import sys, os, json, re, hashlib, argparse
-from datetime import datetime, timezone, timedelta
-from pathlib import Path
-from collections import Counter, defaultdict
-
-try:
-    from sqlcipher3 import dbapi2 as sqlcipher
-except ImportError:
-    print("请安装: pip install sqlcipher3"); sys.exit(1)
-
-sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
-from _utils import load_config, decrypt_lock, parse_frontmatter
-
-OUTPUT_ROOT = 'output'
-
-
-# ====== Database ======
-
-def open_db(db_path, key_hex, salt_hex):
-    raw_key = f"x'{key_hex}{salt_hex}'"
-    conn = sqlcipher.connect(db_path)
-    c = conn.cursor()
-    c.execute(f'PRAGMA key = "{raw_key}";')
-    c.execute("SELECT count(*) FROM sqlite_master")
-    return conn
-
-
-def get_name_map(contact_db, contact_key, contact_salt):
-    name_map = {}
-    if not contact_db or not contact_key or not os.path.exists(contact_db):
-        return name_map
-    try:
-        conn = open_db(contact_db, contact_key, contact_salt)
-        c = conn.cursor()
-        c.execute("SELECT username, COALESCE(NULLIF(remark,''), NULLIF(nick_name,''), username) FROM contact")
-        for r in c.fetchall():
-            name_map[r[0]] = r[1]
-        conn.close()
-    except:
-        pass
-    return name_map
-
-
-def get_own_wxid(nt_db, nt_key, nt_salt):
-    """Get own wxid — prefer config, fallback to UserInfo table."""
-    # Priority 1: config wxid (strip _xxxx suffix)
-    config = load_config()
-    wxid = config.get('wxid', '')
-    if wxid:
-        return wxid
-    # Priority 2: UserInfo table
-    try:
-        conn = open_db(nt_db, nt_key, nt_salt)
-        c = conn.cursor()
-        c.execute("SELECT user_name FROM UserInfo LIMIT 1")
-        row = c.fetchone()
-        conn.close()
-        return row[0] if row else ''
-    except:
-        return ''
-
-
-def get_biz_keys(config):
-    """Get biz database keys."""
-    nt_db = config.get('ntDbPath', '')
-    msg_dir = os.path.dirname(nt_db.replace('\\', '/'))
-    wxid_dir = os.path.dirname(os.path.dirname(msg_dir))
-    contact_db = os.path.join(wxid_dir, 'db_storage', 'contact', 'contact.db')
-
-    contact_key_enc = config.get('contactKey', '')
-    contact_salt = config.get('contactSalt', '')
-    contact_key = decrypt_lock(contact_key_enc) if contact_key_enc else ''
-
-    biz_db = os.path.join(msg_dir, 'biz_message_0.db')
-    biz_key_enc = config.get('bizKey', '')
-    biz_salt = config.get('bizSalt', '')
-    if biz_key_enc and biz_salt:
-        biz_key = decrypt_lock(biz_key_enc)
-    else:
-        print('[ERROR] 缺少 biz_message_0.db 密钥，请运行: python scripts/nt_decrypt.py scan --json')
-        sys.exit(1)
-
-    return {
-        'biz_db': biz_db, 'biz_key': biz_key, 'biz_salt': biz_salt,
-        'contact_db': contact_db, 'contact_key': contact_key, 'contact_salt': contact_salt,
-    }
-
-
-# ====== Stats Collection ======
-
-def collect_chat_stats(conn, start_ts, end_ts, name_map, own_wxid):
-    """Collect chat message statistics."""
-    c = conn.cursor()
-
-    # Get all sessions
-    try:
-        c.execute("SELECT user_name FROM Name2Id WHERE is_session = 1")
-        sessions = [r[0] for r in c.fetchall()]
-    except:
-        c.execute("SELECT name FROM sqlite_master WHERE type='table' AND name LIKE 'Msg_%'")
-        sessions = [r[0] for r in c.fetchall()]
-
-    # Build sender_id → username map from Name2Id
-    c.execute("SELECT rowid, user_name FROM Name2Id")
-    sender_id_map = {r[0]: r[1] for r in c.fetchall()}
-    own_wxid_base = own_wxid.rsplit('_', 1)[0] if own_wxid and '_' in own_wxid else ''
-
-    total_sent = 0
-    total_recv = 0
-    talker_stats = Counter()  # talker -> total messages
-    hour_dist = Counter()  # hour -> message count
-    day_dist = Counter()  # weekday -> message count
-
-    for talker in sessions:
-        tbl = f"Msg_{hashlib.md5(talker.encode()).hexdigest()}"
-        try:
-            c.execute(f'SELECT COUNT(*) FROM sqlite_master WHERE name="{tbl}"')
-            if c.fetchone()[0] == 0:
-                continue
-
-            c.execute(f'''
-                SELECT create_time, real_sender_id
-                FROM "{tbl}"
-                WHERE create_time >= ? AND create_time < ?
-            ''', (start_ts, end_ts))
-
-            count = 0
-            for ts, sender in c.fetchall():
-                count += 1
-                dt = datetime.fromtimestamp(ts, tz=timezone(timedelta(hours=8)))
-                hour_dist[dt.hour] += 1
-                day_dist[dt.weekday()] += 1
-
-                is_self = False
-                if own_wxid:
-                    # Resolve real_sender_id (int) → username via Name2Id
-                    username = sender_id_map.get(sender, '') if isinstance(sender, int) else str(sender)
-                    is_self = (username == own_wxid or username == own_wxid_base)
-                    if not is_self and username:
-                        is_self = (username == talker)  # sent by self in self-chat
-
-                if is_self:
-                    total_sent += 1
-                else:
-                    total_recv += 1
-
-            if count > 0:
-                name = name_map.get(talker, talker)
-                talker_stats[name] += count
-        except:
-            pass
-
-    return {
-        'total_sent': total_sent,
-        'total_recv': total_recv,
-        'talker_stats': talker_stats,
-        'hour_dist': hour_dist,
-        'day_dist': day_dist,
-    }
-
-
-def collect_biz_stats(biz_db, biz_key, biz_salt, start_ts, end_ts, name_map):
-    """Collect public account article statistics."""
-    try:
-        conn = open_db(biz_db, biz_key, biz_salt)
-    except:
-        return {'total_articles': 0, 'account_stats': Counter(), 'topic_stats': Counter()}
-
-    c = conn.cursor()
-    c.execute("SELECT user_name FROM Name2Id WHERE user_name LIKE 'gh_%'")
-    biz_users = [r[0] for r in c.fetchall()]
-
-    total_articles = 0
-    account_stats = Counter()
-    hour_dist = Counter()
-
-    for user in biz_users:
-        tbl = 'Msg_' + hashlib.md5(user.encode()).hexdigest()
-        try:
-            c.execute(f'SELECT COUNT(*) FROM sqlite_master WHERE name="{tbl}"')
-            if c.fetchone()[0] == 0:
-                continue
-
-            c.execute(f'''
-                SELECT create_time FROM "{tbl}"
-                WHERE create_time >= ? AND create_time < ?
-            ''', (start_ts, end_ts))
-
-            count = 0
-            for (ts,) in c.fetchall():
-                count += 1
-                dt = datetime.fromtimestamp(ts, tz=timezone(timedelta(hours=8)))
-                hour_dist[dt.hour] += 1
-
-            if count > 0:
-                name = name_map.get(user, user)
-                account_stats[name] += count
-                total_articles += count
-        except:
-            pass
-
-    conn.close()
-
-    # Read topic stats from existing daily reports
-    topic_stats = Counter()
-    daily_dir = Path(OUTPUT_ROOT) / 'biz-daily'
-    if daily_dir.exists():
-        for d in sorted(daily_dir.iterdir()):
-            if not d.is_dir():
-                continue
-            try:
-                dt = datetime.strptime(d.name, '%Y-%m-%d')
-                dt = dt.replace(tzinfo=timezone(timedelta(hours=8)))
-                if dt.timestamp() < start_ts or dt.timestamp() >= end_ts:
-                    continue
-            except:
-                continue
-
-            readme = d / 'README.md'
-            if readme.exists():
-                content = readme.read_text(encoding='utf-8')
-                # Extract topic counts from README
-                for topic in ['AI', '学术', '新闻', '文学', '投资']:
-                    match = re.search(rf'{topic}/:\s*(\d+)', content)
-                    if match:
-                        topic_stats[topic] += int(match.group(1))
-
-    return {
-        'total_articles': total_articles,
-        'account_stats': account_stats,
-        'topic_stats': topic_stats,
-    }
-
-
-# ====== Report Generation ======
-
-WEEKDAY_NAMES = ['周一', '周二', '周三', '周四', '周五', '周六', '周日']
-
-
-def extract_payment_totals(biz_db, biz_key, biz_salt, start_ts, end_ts):
-    """Scan biz_message_0.db for 微信支付 transaction amounts."""
-    import hashlib as _hashlib, re as _re
-    try:
-        biz_conn = open_db(biz_db, biz_key, biz_salt)
-    except:
-        return []
-    c = biz_conn.cursor()
-
-    # Find 微信支付 account
-    c.execute("SELECT user_name FROM Name2Id WHERE user_name LIKE 'gh_%' ORDER BY user_name")
-    payee = None
-    for r in c.fetchall():
-        tbl = f"Msg_{_hashlib.md5(r[0].encode()).hexdigest()}"
-        try:
-            c.execute(f"SELECT message_content FROM \"{tbl}\" LIMIT 1")
-            row = c.fetchone()
-            if row and row[0]:
-                content = row[0]
-                if isinstance(content, bytes):
-                    try:
-                        import zstandard
-                        dctx = zstandard.ZstdDecompressor()
-                        content = dctx.decompress(content).decode('utf-8', errors='ignore')
-                    except:
-                        content = content.decode('utf-8', errors='ignore')[:200]
-                if '¥' in (content or ''):
-                    payee = r[0]
-                    break
-        except:
-            pass
-
-    if not payee:
-        biz_conn.close()
-        return []
-
-    tbl = f"Msg_{_hashlib.md5(payee.encode()).hexdigest()}"
-    try:
-        c.execute(f"SELECT create_time, message_content FROM \"{tbl}\" WHERE create_time >= ? AND create_time < ? ORDER BY create_time",
-                  (start_ts, end_ts))
-        payments = []
-        for ts, content in c.fetchall():
-            if isinstance(content, bytes):
-                try:
-                    import zstandard
-                    dctx = zstandard.ZstdDecompressor()
-                    text = dctx.decompress(content).decode('utf-8', errors='ignore')
-                except:
-                    text = content.decode('utf-8', errors='ignore')[:200]
-            else:
-                text = str(content) if content else ''
-
-            # Extract amount from first <title> (duplicate in template area)
-            title_match = _re.search(r'<title><!\[CDATA\[(.*?)\]\]></title>', text)
-            if title_match:
-                title_text = title_match.group(1)
-                amt_match = _re.search(r'¥(\d+\.?\d*)', title_text)
-                if amt_match:
-                    amt = float(amt_match.group(1))
-                    # Get payment method from <des> (e.g. "使用建设银行储蓄卡支付￥50.00")
-                    desc = ''
-                    des_match = _re.search(r'<des><!\[CDATA\[(.*?)\]\]></des>', text)
-                    if des_match:
-                        raw = des_match.group(1)
-                        raw = _re.sub(r'￥?\d+\.?\d*', '', raw)   # remove amount
-                        raw = _re.sub(r'\(\d+\)', '', raw)         # remove card number
-                        raw = _re.sub(r'\(\)', '', raw)            # remove empty parens
-                        raw = _re.sub(r'\s+', ' ', raw).strip()    # collapse whitespace
-                        desc = raw
-                    if not desc:
-                        desc = '—'
-                    dt = datetime.fromtimestamp(ts, tz=timezone(timedelta(hours=8)))
-                    payments.append({
-                        'time': dt.strftime('%m-%d %H:%M'),
-                        'amount': amt,
-                        'desc': desc,
-                    })
-        biz_conn.close()
-        return payments
-    except:
-        biz_conn.close()
-        return []
-
-
-def extract_transfers(nt_db, nt_key, nt_salt, start_ts, end_ts, name_map, own_wxid):
-    """Scan message_0.db for 微信转账 records (type 8589934592049)."""
-    import hashlib as _hashlib, re as _re
-    try:
-        conn = open_db(nt_db, nt_key, nt_salt)
-    except:
-        return []
-    c = conn.cursor()
-
-    # Build sender_id → username map
-    c.execute("SELECT rowid, user_name FROM Name2Id")
-    sender_map = {r[0]: r[1] for r in c.fetchall()}
-
-    c.execute("SELECT name FROM sqlite_master WHERE type='table' AND name LIKE 'Msg_%'")
-    tables = [r[0] for r in c.fetchall()]
-
-    transfers = []
-    # First pass: collect all records into {key: {send_record, recv_record}}
-    raw = {}
-
-    for tbl in tables:
-        try:
-            c.execute(f"SELECT create_time, message_content, real_sender_id FROM \"{tbl}\" WHERE local_type = 8589934592049 AND create_time >= ? AND create_time < ?",
-                      (start_ts, end_ts))
-            for ct, content, sid in c.fetchall():
-                if isinstance(content, bytes):
-                    try:
-                        import zstandard
-                        dctx = zstandard.ZstdDecompressor()
-                        text = dctx.decompress(content).decode('utf-8', errors='ignore')
-                    except:
-                        text = content.decode('utf-8', errors='ignore')[:500]
-                else:
-                    text = str(content) if content else ''
-
-                amt_match = _re.search(r'收到转账(\d+\.?\d*)元', text)
-                if not amt_match or '转账' not in text:
-                    continue
-
-                amt = float(amt_match.group(1))
-                sender_wxid = sender_map.get(sid, str(sid))
-                is_send = (sender_wxid == own_wxid or sender_wxid == own_wxid.rsplit('_', 1)[0])
-                dt = datetime.fromtimestamp(ct, tz=timezone(timedelta(hours=8)))
-                key = (dt.strftime('%m-%d %H:%M'), amt)
-
-                if key not in raw:
-                    raw[key] = {}
-                if is_send:
-                    raw[key]['send'] = (sender_wxid, ct)
-                else:
-                    raw[key]['recv'] = (sender_wxid, ct)
-        except:
-            pass
-
-    # Second pass: merge pairs into transfer records
-    for key, pair in raw.items():
-        time_str, amt = key
-        send_time = pair.get('send', (None, 0))[1] if 'send' in pair else 0
-        recv_time = pair.get('recv', (None, 0))[1] if 'recv' in pair else 0
-
-        if 'send' in pair and 'recv' in pair:
-            # Both sides exist: order determines direction
-            if send_time < recv_time:
-                # User sent first → 发出
-                contact_wxid = pair['recv'][0]
-                contact_name = name_map.get(contact_wxid, contact_wxid)
-                transfers.append({'time': time_str, 'amount': amt, 'direction': '发出', 'contact': contact_name})
-            else:
-                # Contact sent first → 收到
-                contact_wxid = pair['recv'][0]
-                if contact_wxid != own_wxid:
-                    contact_name = name_map.get(contact_wxid, contact_wxid)
-                    transfers.append({'time': time_str, 'amount': amt, 'direction': '收到', 'contact': contact_name})
-        elif 'recv' in pair:
-            contact_wxid = pair['recv'][0]
-            if contact_wxid != own_wxid:
-                contact_name = name_map.get(contact_wxid, contact_wxid)
-                transfers.append({'time': time_str, 'amount': amt, 'direction': '收到', 'contact': contact_name})
-
-    conn.close()
-    return transfers
-
-
-def format_report(chat_stats, biz_stats, payments, transfers, period_label, start_date, end_date):
-    """Generate markdown report."""
-    lines = [
-        f'# 📊 微信个人信息消费报告',
-        f'> {period_label} | {start_date} ~ {end_date}',
-        '',
-    ]
-
-    # === Overview ===
-    total_msgs = chat_stats['total_sent'] + chat_stats['total_recv']
-    lines.append('## 📈 数据概览')
-    lines.append('')
-    lines.append(f'| 指标 | 数量 |')
-    lines.append(f'|------|------|')
-    lines.append(f'| 收到消息 | {chat_stats["total_recv"]:,} 条 |')
-    lines.append(f'| 发送消息 | {chat_stats["total_sent"]:,} 条 |')
-    lines.append(f'| 总消息量 | {total_msgs:,} 条 |')
-    lines.append(f'| 公众号文章 | {biz_stats["total_articles"]:,} 篇 |')
-    lines.append(f'| 活跃联系人 | {len(chat_stats["talker_stats"])} 个 |')
-    lines.append(f'| 活跃公众号 | {len(biz_stats["account_stats"])} 个 |')
-    lines.append('')
-
-    # === Top Talkers ===
-    lines.append('## 💬 Top 10 聊天对象')
-    lines.append('')
-    lines.append('| 排名 | 联系人 | 消息数 | 占比 |')
-    lines.append('|------|--------|--------|------|')
-    top_talkers = chat_stats['talker_stats'].most_common(10)
-    for i, (name, count) in enumerate(top_talkers, 1):
-        pct = f"{count / total_msgs * 100:.1f}%" if total_msgs > 0 else '0%'
-        lines.append(f'| {i} | {name} | {count:,} | {pct} |')
-    lines.append('')
-
-    # === Reading Preferences ===
-    if biz_stats['topic_stats']:
-        lines.append('## 📰 阅读偏好')
-        lines.append('')
-        total_topics = sum(biz_stats['topic_stats'].values())
-        lines.append('| 主题 | 篇数 | 占比 |')
-        lines.append('|------|------|------|')
-        topic_emoji = {'AI': '🤖', '学术': '🔬', '新闻': '📰', '文学': '📖', '投资': '💰'}
-        for topic, count in biz_stats['topic_stats'].most_common():
-            pct = f"{count / total_topics * 100:.0f}%" if total_topics > 0 else '0%'
-            emoji = topic_emoji.get(topic, '📌')
-            lines.append(f'| {emoji} {topic} | {count} | {pct} |')
-        lines.append('')
-
-    # === Top Public Accounts ===
-    if biz_stats['account_stats']:
-        lines.append('## 📱 Top 10 公众号')
-        lines.append('')
-        lines.append('| 排名 | 公众号 | 文章数 |')
-        lines.append('|------|--------|--------|')
-        for i, (name, count) in enumerate(biz_stats['account_stats'].most_common(10), 1):
-            lines.append(f'| {i} | {name} | {count} |')
-        lines.append('')
-
-    # === Activity Hours ===
-    lines.append('## ⏰ 活跃时段分布')
-    lines.append('')
-    lines.append('| 时段 | 消息数 | 热度 |')
-    lines.append('|------|--------|------|')
-    max_hour = max(chat_stats['hour_dist'].values()) if chat_stats['hour_dist'] else 1
-    for h in range(24):
-        count = chat_stats['hour_dist'].get(h, 0)
-        bar_len = int(count / max_hour * 10) if max_hour > 0 else 0
-        bar = '█' * bar_len + '░' * (10 - bar_len)
-        label = f'{h:02d}:00-{h:02d}:59'
-        lines.append(f'| {label} | {count:,} | {bar} |')
-    lines.append('')
-
-    # Most/least active hours
-    if chat_stats['hour_dist']:
-        most_active_h = chat_stats['hour_dist'].most_common(1)[0]
-        least_active_h = min(chat_stats['hour_dist'].items(), key=lambda x: x[1])
-        lines.append(f'- 🔥 最活跃：**{most_active_h[0]:02d}:00-{most_active_h[0]:02d}:59**（{most_active_h[1]:,} 条）')
-        lines.append(f'- 😴 最安静：**{least_active_h[0]:02d}:00-{least_active_h[0]:02d}:59**（{least_active_h[1]:,} 条）')
-    lines.append('')
-
-    # === Weekday Distribution ===
-    lines.append('## 📅 星期分布')
-    lines.append('')
-    lines.append('| 星期 | 消息数 | 热度 |')
-    lines.append('|------|--------|------|')
-    max_day = max(chat_stats['day_dist'].values()) if chat_stats['day_dist'] else 1
-    for d in range(7):
-        count = chat_stats['day_dist'].get(d, 0)
-        bar_len = int(count / max_day * 10) if max_day > 0 else 0
-        bar = '█' * bar_len + '░' * (10 - bar_len)
-        lines.append(f'| {WEEKDAY_NAMES[d]} | {count:,} | {bar} |')
-    lines.append('')
-
-    # === Fun Facts ===
-    lines.append('## 💡 趣味数据')
-    lines.append('')
-    from datetime import datetime
-    d1 = datetime.strptime(start_date, '%Y-%m-%d') if isinstance(start_date, str) else start_date
-    d2 = datetime.strptime(end_date, '%Y-%m-%d') if isinstance(end_date, str) else end_date
-    avg_per_day = total_msgs / max(1, (d2 - d1).days)
-    lines.append(f'- 📊 日均消息量：**{avg_per_day:.0f} 条**')
-    if payments:
-        total_spend = sum(p['amount'] for p in payments)
-        lines.append(f'- 💰 微信支付：**¥{total_spend:.2f}**（{len(payments)} 笔交易）')
-    if chat_stats['total_sent'] > 0 and chat_stats['total_recv'] > 0:
-        ratio = chat_stats['total_sent'] / chat_stats['total_recv']
-        if ratio > 1.2:
-            lines.append(f'- 🗣️ 你是个**话痨**，发送/接收比 = {ratio:.2f}')
-        elif ratio < 0.8:
-            lines.append(f'- 👂 你是个**倾听者**，发送/接收比 = {ratio:.2f}')
-        else:
-            lines.append(f'- 🤝 沟通均衡，发送/接收比 = {ratio:.2f}')
-    if biz_stats['topic_stats']:
-        top_topic = biz_stats['topic_stats'].most_common(1)[0]
-        lines.append(f'- ❤️ 最爱看：**{top_topic[0]}**类文章（{top_topic[1]} 篇）')
-    if top_talkers:
-        lines.append(f'- 🏆 最常聊天：**{top_talkers[0][0]}**（{top_talkers[0][1]:,} 条）')
-    lines.append('')
-
-    # === Payment Details ===
-    if payments:
-        lines.append('## 💰 微信支付明细')
-        lines.append('')
-        total_spend = sum(p['amount'] for p in payments)
-        lines.append(f'> 共 {len(payments)} 笔 | 合计 ¥{total_spend:.2f}')
-        lines.append('')
-        lines.append('| 时间 | 金额 | 说明 |')
-        lines.append('|------|------|------|')
-        for p in sorted(payments, key=lambda x: -x['amount']):
-            desc = p.get('desc', '')
-            lines.append(f'| {p["time"]} | ¥{p["amount"]:.2f} | {desc} |')
-        lines.append('')
-
-    # === Transfer Details ===
-    if transfers:
-        lines.append('## 💸 微信转账')
-        lines.append('')
-        total_out = sum(t['amount'] for t in transfers if t['direction'] == '发出')
-        total_in = sum(t['amount'] for t in transfers if t['direction'] == '收到')
-        lines.append(f'> 共 {len(transfers)} 笔 | 收到 ¥{total_in:.2f} | 发出 ¥{total_out:.2f}')
-        lines.append('')
-        lines.append('| 日期 | 方向 | 金额 | 对方 |')
-        lines.append('|------|------|------|------|')
-        for t in sorted(transfers, key=lambda x: x['time']):
-            dir_icon = '←' if t['direction'] == '收到' else '→'
-            lines.append(f'| {t["time"]} | {dir_icon} {t["direction"]} | ¥{t["amount"]:.2f} | {t["contact"]} |')
-        lines.append('')
-
-    # === 收支总览 ===
-    total_pay = sum(p['amount'] for p in payments) if payments else 0
-    total_in = sum(t['amount'] for t in transfers if t['direction'] == '收到') if transfers else 0
-    total_out = sum(t['amount'] for t in transfers if t['direction'] == '发出') if transfers else 0
-    if total_pay or total_in or total_out:
-        lines.append('## 📊 收支总览')
-        lines.append('')
-        net = total_in - total_pay - total_out
-        lines.append(f'| 收入 | 支出 | 净额 |')
-        lines.append(f'|------|------|------|')
-        income_str = f'转账收到 ¥{total_in:.2f}' if total_in else '—'
-        expense_parts = []
-        if total_pay:
-            expense_parts.append(f'消费 ¥{total_pay:.2f}')
-        if total_out:
-            expense_parts.append(f'转出 ¥{total_out:.2f}')
-        expense_str = ' + '.join(expense_parts) if expense_parts else '—'
-        sign = '+' if net >= 0 else ''
-        lines.append(f'| {income_str} | {expense_str} | {sign}¥{net:.2f} |')
-        lines.append('')
-
-    return '\n'.join(lines)
-
-
-# ====== Main ======
-
-def main():
-    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
-    parser = argparse.ArgumentParser(description='微信个人信息消费报告')
-    parser.add_argument('--period', choices=['week', 'month'], default='week', help='报告周期（默认 week）')
-    parser.add_argument('--month', help='指定月份 YYYY-MM（覆盖 --period）')
-    parser.add_argument('--output', help='输出文件路径')
-    args = parser.parse_args()
-
-    tz = timezone(timedelta(hours=8))
-    now = datetime.now(tz)
-
-    if args.month:
-        # Specified month
-        y, m = args.month.split('-')
-        start_date = datetime(int(y), int(m), 1, tzinfo=tz)
-        if int(m) == 12:
-            end_date = datetime(int(y) + 1, 1, 1, tzinfo=tz)
-        else:
-            end_date = datetime(int(y), int(m) + 1, 1, tzinfo=tz)
-        period_label = f'月报 — {args.month}'
-    elif args.period == 'week':
-        days_since_monday = now.weekday()
-        start_date = (now - timedelta(days=days_since_monday)).replace(hour=0, minute=0, second=0, microsecond=0)
-        end_date = now
-        period_label = f'周报 — {start_date.strftime("%Y-%m-%d")} ~ {end_date.strftime("%Y-%m-%d")}'
-    else:
-        start_date = now.replace(day=1, hour=0, minute=0, second=0, microsecond=0)
-        end_date = now
-        period_label = f'月报 — {now.strftime("%Y-%m")}'
-
-    start_ts = int(start_date.timestamp())
-    end_ts = int(end_date.timestamp())
-
-    print(f'=== 微信个人信息消费报告 ===')
-    print(f'周期: {period_label}')
-
-    # Load config
-    config = load_config()
-    nt_db = config.get('ntDbPath', '')
-    if not nt_db:
-        print('[ERROR] 未找到数据库路径，请先运行 weflow-cli init')
-        sys.exit(1)
-
-    nt_key = decrypt_lock(config.get('ntKey', ''))
-    nt_salt = config.get('ntSalt', '')
-
-    # Get name map and own wxid
-    keys = get_biz_keys(config)
-    name_map = get_name_map(keys['contact_db'], keys['contact_key'], keys['contact_salt'])
-    own_wxid = get_own_wxid(nt_db, nt_key, nt_salt)
-    print(f'联系人映射: {len(name_map)} | 自己: {own_wxid[:20]}...')
-
-    # Collect chat stats
-    print(f'\n统计聊天消息...')
-    try:
-        conn = open_db(nt_db, nt_key, nt_salt)
-    except Exception as e:
-        print(f'[ERROR] 打开数据库失败: {e}')
-        sys.exit(1)
-
-    chat_stats = collect_chat_stats(conn, start_ts, end_ts, name_map, own_wxid)
-    conn.close()
-    print(f'  消息: 发送 {chat_stats["total_sent"]:,} / 接收 {chat_stats["total_recv"]:,}')
-    print(f'  联系人: {len(chat_stats["talker_stats"])} 个')
-
-    # Collect biz stats
-    print(f'\n统计公众号文章...')
-    biz_stats = collect_biz_stats(
-        keys['biz_db'], keys['biz_key'], keys['biz_salt'],
-        start_ts, end_ts, name_map
-    )
-    print(f'  文章: {biz_stats["total_articles"]:,} 篇')
-    print(f'  公众号: {len(biz_stats["account_stats"])} 个')
-
-    # Collect payment data from biz database
-    payments = extract_payment_totals(
-        keys['biz_db'], keys['biz_key'], keys['biz_salt'],
-        start_ts, end_ts
-    )
-    if payments:
-        total = sum(p['amount'] for p in payments)
-        print(f'  微信支付: {len(payments)} 笔, ¥{total:.2f}')
-
-    # Collect transfer data
-    print(f'\n统计转账...')
-    transfers = extract_transfers(nt_db, nt_key, nt_salt, start_ts, end_ts, name_map, own_wxid)
-    total_in = sum(t['amount'] for t in transfers if t['direction'] == '收到')
-    total_out = sum(t['amount'] for t in transfers if t['direction'] == '发出')
-    if transfers:
-        print(f'  转账: {len(transfers)} 笔 | 收到 ¥{total_in:.2f} | 发出 ¥{total_out:.2f}')
-
-    # Generate report
-    print(f'\n生成报告...')
-    report = format_report(
-        chat_stats, biz_stats, payments, transfers, period_label,
-        start_date.strftime('%Y-%m-%d'), end_date.strftime('%Y-%m-%d')
-    )
-
-    # Save
-    suffix = args.month.replace('-', '') if args.month else args.period
-    output_path = args.output or os.path.join(OUTPUT_ROOT, f'微信报告_{suffix}.md')
-    os.makedirs(os.path.dirname(output_path) or '.', exist_ok=True)
-    with open(output_path, 'w', encoding='utf-8') as f:
-        f.write(report)
-
-    print(f'\n✓ 已保存到: {output_path}')
-    print(report[:500] + '...')
-
-
-if __name__ == '__main__':
-    main()
+#!/usr/bin/env python3
+"""
+微信个人信息消费报告 — 统计消息量、聊天对象、公众号阅读偏好、活跃时段。
+
+用法:
+  python scripts/chat_stats.py --period week
+  python scripts/chat_stats.py --period month
+  python scripts/chat_stats.py --period month --output output/报告.md
+
+输出: output/微信报告_<周期>.md
+"""
+
+import sys, os, json, re, hashlib, argparse
+from datetime import datetime, timezone, timedelta
+from pathlib import Path
+from collections import Counter, defaultdict
+
+try:
+    from sqlcipher3 import dbapi2 as sqlcipher
+except ImportError:
+    print("请安装: pip install sqlcipher3"); sys.exit(1)
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from _utils import load_config, decrypt_lock, parse_frontmatter
+
+OUTPUT_ROOT = 'output'
+
+
+# ====== Database ======
+
+def open_db(db_path, key_hex, salt_hex):
+    raw_key = f"x'{key_hex}{salt_hex}'"
+    conn = sqlcipher.connect(db_path)
+    c = conn.cursor()
+    c.execute(f'PRAGMA key = "{raw_key}";')
+    c.execute("SELECT count(*) FROM sqlite_master")
+    return conn
+
+
+def get_name_map(contact_db, contact_key, contact_salt):
+    name_map = {}
+    if not contact_db or not contact_key or not os.path.exists(contact_db):
+        return name_map
+    try:
+        conn = open_db(contact_db, contact_key, contact_salt)
+        c = conn.cursor()
+        c.execute("SELECT username, COALESCE(NULLIF(remark,''), NULLIF(nick_name,''), username) FROM contact")
+        for r in c.fetchall():
+            name_map[r[0]] = r[1]
+        conn.close()
+    except:
+        pass
+    return name_map
+
+
+def get_own_wxid(nt_db, nt_key, nt_salt):
+    """Get own wxid — prefer config, fallback to UserInfo table."""
+    # Priority 1: config wxid (strip _xxxx suffix)
+    config = load_config()
+    wxid = config.get('wxid', '')
+    if wxid:
+        return wxid
+    # Priority 2: UserInfo table
+    try:
+        conn = open_db(nt_db, nt_key, nt_salt)
+        c = conn.cursor()
+        c.execute("SELECT user_name FROM UserInfo LIMIT 1")
+        row = c.fetchone()
+        conn.close()
+        return row[0] if row else ''
+    except:
+        return ''
+
+
+def get_biz_keys(config):
+    """Get biz database keys."""
+    nt_db = config.get('ntDbPath', '')
+    msg_dir = os.path.dirname(nt_db.replace('\\', '/'))
+    wxid_dir = os.path.dirname(os.path.dirname(msg_dir))
+    contact_db = os.path.join(wxid_dir, 'db_storage', 'contact', 'contact.db')
+
+    contact_key_enc = config.get('contactKey', '')
+    contact_salt = config.get('contactSalt', '')
+    contact_key = decrypt_lock(contact_key_enc) if contact_key_enc else ''
+
+    biz_db = os.path.join(msg_dir, 'biz_message_0.db')
+    biz_key_enc = config.get('bizKey', '')
+    biz_salt = config.get('bizSalt', '')
+    if biz_key_enc and biz_salt:
+        biz_key = decrypt_lock(biz_key_enc)
+    else:
+        print('[ERROR] 缺少 biz_message_0.db 密钥，请运行: python scripts/nt_decrypt.py scan --json')
+        sys.exit(1)
+
+    return {
+        'biz_db': biz_db, 'biz_key': biz_key, 'biz_salt': biz_salt,
+        'contact_db': contact_db, 'contact_key': contact_key, 'contact_salt': contact_salt,
+    }
+
+
+# ====== Stats Collection ======
+
+def collect_chat_stats(conn, start_ts, end_ts, name_map, own_wxid):
+    """Collect chat message statistics."""
+    c = conn.cursor()
+
+    # Get all sessions
+    try:
+        c.execute("SELECT user_name FROM Name2Id WHERE is_session = 1")
+        sessions = [r[0] for r in c.fetchall()]
+    except:
+        c.execute("SELECT name FROM sqlite_master WHERE type='table' AND name LIKE 'Msg_%'")
+        sessions = [r[0] for r in c.fetchall()]
+
+    # Build sender_id → username map from Name2Id
+    c.execute("SELECT rowid, user_name FROM Name2Id")
+    sender_id_map = {r[0]: r[1] for r in c.fetchall()}
+    own_wxid_base = own_wxid.rsplit('_', 1)[0] if own_wxid and '_' in own_wxid else ''
+
+    total_sent = 0
+    total_recv = 0
+    talker_stats = Counter()  # talker -> total messages
+    hour_dist = Counter()  # hour -> message count
+    day_dist = Counter()  # weekday -> message count
+
+    for talker in sessions:
+        tbl = f"Msg_{hashlib.md5(talker.encode()).hexdigest()}"
+        try:
+            c.execute(f'SELECT COUNT(*) FROM sqlite_master WHERE name="{tbl}"')
+            if c.fetchone()[0] == 0:
+                continue
+
+            c.execute(f'''
+                SELECT create_time, real_sender_id
+                FROM "{tbl}"
+                WHERE create_time >= ? AND create_time < ?
+            ''', (start_ts, end_ts))
+
+            count = 0
+            for ts, sender in c.fetchall():
+                count += 1
+                dt = datetime.fromtimestamp(ts, tz=timezone(timedelta(hours=8)))
+                hour_dist[dt.hour] += 1
+                day_dist[dt.weekday()] += 1
+
+                is_self = False
+                if own_wxid:
+                    # Resolve real_sender_id (int) → username via Name2Id
+                    username = sender_id_map.get(sender, '') if isinstance(sender, int) else str(sender)
+                    is_self = (username == own_wxid or username == own_wxid_base)
+                    if not is_self and username:
+                        is_self = (username == talker)  # sent by self in self-chat
+
+                if is_self:
+                    total_sent += 1
+                else:
+                    total_recv += 1
+
+            if count > 0:
+                name = name_map.get(talker, talker)
+                talker_stats[name] += count
+        except:
+            pass
+
+    return {
+        'total_sent': total_sent,
+        'total_recv': total_recv,
+        'talker_stats': talker_stats,
+        'hour_dist': hour_dist,
+        'day_dist': day_dist,
+    }
+
+
+def collect_biz_stats(biz_db, biz_key, biz_salt, start_ts, end_ts, name_map):
+    """Collect public account article statistics."""
+    try:
+        conn = open_db(biz_db, biz_key, biz_salt)
+    except:
+        return {'total_articles': 0, 'account_stats': Counter(), 'topic_stats': Counter()}
+
+    c = conn.cursor()
+    c.execute("SELECT user_name FROM Name2Id WHERE user_name LIKE 'gh_%'")
+    biz_users = [r[0] for r in c.fetchall()]
+
+    total_articles = 0
+    account_stats = Counter()
+    hour_dist = Counter()
+
+    for user in biz_users:
+        tbl = 'Msg_' + hashlib.md5(user.encode()).hexdigest()
+        try:
+            c.execute(f'SELECT COUNT(*) FROM sqlite_master WHERE name="{tbl}"')
+            if c.fetchone()[0] == 0:
+                continue
+
+            c.execute(f'''
+                SELECT create_time FROM "{tbl}"
+                WHERE create_time >= ? AND create_time < ?
+            ''', (start_ts, end_ts))
+
+            count = 0
+            for (ts,) in c.fetchall():
+                count += 1
+                dt = datetime.fromtimestamp(ts, tz=timezone(timedelta(hours=8)))
+                hour_dist[dt.hour] += 1
+
+            if count > 0:
+                name = name_map.get(user, user)
+                account_stats[name] += count
+                total_articles += count
+        except:
+            pass
+
+    conn.close()
+
+    # Read topic stats from existing daily reports
+    topic_stats = Counter()
+    daily_dir = Path(OUTPUT_ROOT) / 'biz-daily'
+    if daily_dir.exists():
+        for d in sorted(daily_dir.iterdir()):
+            if not d.is_dir():
+                continue
+            try:
+                dt = datetime.strptime(d.name, '%Y-%m-%d')
+                dt = dt.replace(tzinfo=timezone(timedelta(hours=8)))
+                if dt.timestamp() < start_ts or dt.timestamp() >= end_ts:
+                    continue
+            except:
+                continue
+
+            readme = d / 'README.md'
+            if readme.exists():
+                content = readme.read_text(encoding='utf-8')
+                # Extract topic counts from README
+                for topic in ['AI', '学术', '新闻', '文学', '投资']:
+                    match = re.search(rf'{topic}/:\s*(\d+)', content)
+                    if match:
+                        topic_stats[topic] += int(match.group(1))
+
+    return {
+        'total_articles': total_articles,
+        'account_stats': account_stats,
+        'topic_stats': topic_stats,
+    }
+
+
+# ====== Report Generation ======
+
+WEEKDAY_NAMES = ['周一', '周二', '周三', '周四', '周五', '周六', '周日']
+
+
+def extract_payment_totals(biz_db, biz_key, biz_salt, start_ts, end_ts):
+    """Scan biz_message_0.db for 微信支付 transaction amounts."""
+    import hashlib as _hashlib, re as _re
+    try:
+        biz_conn = open_db(biz_db, biz_key, biz_salt)
+    except:
+        return []
+    c = biz_conn.cursor()
+
+    # Find 微信支付 account
+    c.execute("SELECT user_name FROM Name2Id WHERE user_name LIKE 'gh_%' ORDER BY user_name")
+    payee = None
+    for r in c.fetchall():
+        tbl = f"Msg_{_hashlib.md5(r[0].encode()).hexdigest()}"
+        try:
+            c.execute(f"SELECT message_content FROM \"{tbl}\" LIMIT 1")
+            row = c.fetchone()
+            if row and row[0]:
+                content = row[0]
+                if isinstance(content, bytes):
+                    try:
+                        import zstandard
+                        dctx = zstandard.ZstdDecompressor()
+                        content = dctx.decompress(content).decode('utf-8', errors='ignore')
+                    except:
+                        content = content.decode('utf-8', errors='ignore')[:200]
+                if '¥' in (content or ''):
+                    payee = r[0]
+                    break
+        except:
+            pass
+
+    if not payee:
+        biz_conn.close()
+        return []
+
+    tbl = f"Msg_{_hashlib.md5(payee.encode()).hexdigest()}"
+    try:
+        c.execute(f"SELECT create_time, message_content FROM \"{tbl}\" WHERE create_time >= ? AND create_time < ? ORDER BY create_time",
+                  (start_ts, end_ts))
+        payments = []
+        for ts, content in c.fetchall():
+            if isinstance(content, bytes):
+                try:
+                    import zstandard
+                    dctx = zstandard.ZstdDecompressor()
+                    text = dctx.decompress(content).decode('utf-8', errors='ignore')
+                except:
+                    text = content.decode('utf-8', errors='ignore')[:200]
+            else:
+                text = str(content) if content else ''
+
+            # Extract amount from first <title> (duplicate in template area)
+            title_match = _re.search(r'<title><!\[CDATA\[(.*?)\]\]></title>', text)
+            if title_match:
+                title_text = title_match.group(1)
+                amt_match = _re.search(r'¥(\d+\.?\d*)', title_text)
+                if amt_match:
+                    amt = float(amt_match.group(1))
+                    # Get payment method from <des> (e.g. "使用建设银行储蓄卡支付￥50.00")
+                    desc = ''
+                    des_match = _re.search(r'<des><!\[CDATA\[(.*?)\]\]></des>', text)
+                    if des_match:
+                        raw = des_match.group(1)
+                        raw = _re.sub(r'￥?\d+\.?\d*', '', raw)   # remove amount
+                        raw = _re.sub(r'\(\d+\)', '', raw)         # remove card number
+                        raw = _re.sub(r'\(\)', '', raw)            # remove empty parens
+                        raw = _re.sub(r'\s+', ' ', raw).strip()    # collapse whitespace
+                        desc = raw
+                    if not desc:
+                        desc = '—'
+                    dt = datetime.fromtimestamp(ts, tz=timezone(timedelta(hours=8)))
+                    payments.append({
+                        'time': dt.strftime('%m-%d %H:%M'),
+                        'amount': amt,
+                        'desc': desc,
+                    })
+        biz_conn.close()
+        return payments
+    except:
+        biz_conn.close()
+        return []
+
+
+def extract_transfers(nt_db, nt_key, nt_salt, start_ts, end_ts, name_map, own_wxid):
+    """Scan message_0.db for 微信转账 records (type 8589934592049)."""
+    import hashlib as _hashlib, re as _re
+    try:
+        conn = open_db(nt_db, nt_key, nt_salt)
+    except:
+        return []
+    c = conn.cursor()
+
+    # Build sender_id → username map
+    c.execute("SELECT rowid, user_name FROM Name2Id")
+    sender_map = {r[0]: r[1] for r in c.fetchall()}
+
+    c.execute("SELECT name FROM sqlite_master WHERE type='table' AND name LIKE 'Msg_%'")
+    tables = [r[0] for r in c.fetchall()]
+
+    transfers = []
+    # First pass: collect all records into {key: {send_record, recv_record}}
+    raw = {}
+
+    for tbl in tables:
+        try:
+            c.execute(f"SELECT create_time, message_content, real_sender_id FROM \"{tbl}\" WHERE local_type = 8589934592049 AND create_time >= ? AND create_time < ?",
+                      (start_ts, end_ts))
+            for ct, content, sid in c.fetchall():
+                if isinstance(content, bytes):
+                    try:
+                        import zstandard
+                        dctx = zstandard.ZstdDecompressor()
+                        text = dctx.decompress(content).decode('utf-8', errors='ignore')
+                    except:
+                        text = content.decode('utf-8', errors='ignore')[:500]
+                else:
+                    text = str(content) if content else ''
+
+                amt_match = _re.search(r'收到转账(\d+\.?\d*)元', text)
+                if not amt_match or '转账' not in text:
+                    continue
+
+                amt = float(amt_match.group(1))
+                sender_wxid = sender_map.get(sid, str(sid))
+                is_send = (sender_wxid == own_wxid or sender_wxid == own_wxid.rsplit('_', 1)[0])
+                dt = datetime.fromtimestamp(ct, tz=timezone(timedelta(hours=8)))
+                key = (dt.strftime('%m-%d %H:%M'), amt)
+
+                if key not in raw:
+                    raw[key] = {}
+                if is_send:
+                    raw[key]['send'] = (sender_wxid, ct)
+                else:
+                    raw[key]['recv'] = (sender_wxid, ct)
+        except:
+            pass
+
+    # Second pass: merge pairs into transfer records
+    for key, pair in raw.items():
+        time_str, amt = key
+        send_time = pair.get('send', (None, 0))[1] if 'send' in pair else 0
+        recv_time = pair.get('recv', (None, 0))[1] if 'recv' in pair else 0
+
+        if 'send' in pair and 'recv' in pair:
+            # Both sides exist: order determines direction
+            if send_time < recv_time:
+                # User sent first → 发出
+                contact_wxid = pair['recv'][0]
+                contact_name = name_map.get(contact_wxid, contact_wxid)
+                transfers.append({'time': time_str, 'amount': amt, 'direction': '发出', 'contact': contact_name})
+            else:
+                # Contact sent first → 收到
+                contact_wxid = pair['recv'][0]
+                if contact_wxid != own_wxid:
+                    contact_name = name_map.get(contact_wxid, contact_wxid)
+                    transfers.append({'time': time_str, 'amount': amt, 'direction': '收到', 'contact': contact_name})
+        elif 'recv' in pair:
+            contact_wxid = pair['recv'][0]
+            if contact_wxid != own_wxid:
+                contact_name = name_map.get(contact_wxid, contact_wxid)
+                transfers.append({'time': time_str, 'amount': amt, 'direction': '收到', 'contact': contact_name})
+
+    conn.close()
+    return transfers
+
+
+def format_report(chat_stats, biz_stats, payments, transfers, period_label, start_date, end_date):
+    """Generate markdown report."""
+    lines = [
+        f'# 📊 微信个人信息消费报告',
+        f'> {period_label} | {start_date} ~ {end_date}',
+        '',
+    ]
+
+    # === Overview ===
+    total_msgs = chat_stats['total_sent'] + chat_stats['total_recv']
+    lines.append('## 📈 数据概览')
+    lines.append('')
+    lines.append(f'| 指标 | 数量 |')
+    lines.append(f'|------|------|')
+    lines.append(f'| 收到消息 | {chat_stats["total_recv"]:,} 条 |')
+    lines.append(f'| 发送消息 | {chat_stats["total_sent"]:,} 条 |')
+    lines.append(f'| 总消息量 | {total_msgs:,} 条 |')
+    lines.append(f'| 公众号文章 | {biz_stats["total_articles"]:,} 篇 |')
+    lines.append(f'| 活跃联系人 | {len(chat_stats["talker_stats"])} 个 |')
+    lines.append(f'| 活跃公众号 | {len(biz_stats["account_stats"])} 个 |')
+    lines.append('')
+
+    # === Top Talkers ===
+    lines.append('## 💬 Top 10 聊天对象')
+    lines.append('')
+    lines.append('| 排名 | 联系人 | 消息数 | 占比 |')
+    lines.append('|------|--------|--------|------|')
+    top_talkers = chat_stats['talker_stats'].most_common(10)
+    for i, (name, count) in enumerate(top_talkers, 1):
+        pct = f"{count / total_msgs * 100:.1f}%" if total_msgs > 0 else '0%'
+        lines.append(f'| {i} | {name} | {count:,} | {pct} |')
+    lines.append('')
+
+    # === Reading Preferences ===
+    if biz_stats['topic_stats']:
+        lines.append('## 📰 阅读偏好')
+        lines.append('')
+        total_topics = sum(biz_stats['topic_stats'].values())
+        lines.append('| 主题 | 篇数 | 占比 |')
+        lines.append('|------|------|------|')
+        topic_emoji = {'AI': '🤖', '学术': '🔬', '新闻': '📰', '文学': '📖', '投资': '💰'}
+        for topic, count in biz_stats['topic_stats'].most_common():
+            pct = f"{count / total_topics * 100:.0f}%" if total_topics > 0 else '0%'
+            emoji = topic_emoji.get(topic, '📌')
+            lines.append(f'| {emoji} {topic} | {count} | {pct} |')
+        lines.append('')
+
+    # === Top Public Accounts ===
+    if biz_stats['account_stats']:
+        lines.append('## 📱 Top 10 公众号')
+        lines.append('')
+        lines.append('| 排名 | 公众号 | 文章数 |')
+        lines.append('|------|--------|--------|')
+        for i, (name, count) in enumerate(biz_stats['account_stats'].most_common(10), 1):
+            lines.append(f'| {i} | {name} | {count} |')
+        lines.append('')
+
+    # === Activity Hours ===
+    lines.append('## ⏰ 活跃时段分布')
+    lines.append('')
+    lines.append('| 时段 | 消息数 | 热度 |')
+    lines.append('|------|--------|------|')
+    max_hour = max(chat_stats['hour_dist'].values()) if chat_stats['hour_dist'] else 1
+    for h in range(24):
+        count = chat_stats['hour_dist'].get(h, 0)
+        bar_len = int(count / max_hour * 10) if max_hour > 0 else 0
+        bar = '█' * bar_len + '░' * (10 - bar_len)
+        label = f'{h:02d}:00-{h:02d}:59'
+        lines.append(f'| {label} | {count:,} | {bar} |')
+    lines.append('')
+
+    # Most/least active hours
+    if chat_stats['hour_dist']:
+        most_active_h = chat_stats['hour_dist'].most_common(1)[0]
+        least_active_h = min(chat_stats['hour_dist'].items(), key=lambda x: x[1])
+        lines.append(f'- 🔥 最活跃：**{most_active_h[0]:02d}:00-{most_active_h[0]:02d}:59**（{most_active_h[1]:,} 条）')
+        lines.append(f'- 😴 最安静：**{least_active_h[0]:02d}:00-{least_active_h[0]:02d}:59**（{least_active_h[1]:,} 条）')
+    lines.append('')
+
+    # === Weekday Distribution ===
+    lines.append('## 📅 星期分布')
+    lines.append('')
+    lines.append('| 星期 | 消息数 | 热度 |')
+    lines.append('|------|--------|------|')
+    max_day = max(chat_stats['day_dist'].values()) if chat_stats['day_dist'] else 1
+    for d in range(7):
+        count = chat_stats['day_dist'].get(d, 0)
+        bar_len = int(count / max_day * 10) if max_day > 0 else 0
+        bar = '█' * bar_len + '░' * (10 - bar_len)
+        lines.append(f'| {WEEKDAY_NAMES[d]} | {count:,} | {bar} |')
+    lines.append('')
+
+    # === Fun Facts ===
+    lines.append('## 💡 趣味数据')
+    lines.append('')
+    from datetime import datetime
+    d1 = datetime.strptime(start_date, '%Y-%m-%d') if isinstance(start_date, str) else start_date
+    d2 = datetime.strptime(end_date, '%Y-%m-%d') if isinstance(end_date, str) else end_date
+    avg_per_day = total_msgs / max(1, (d2 - d1).days)
+    lines.append(f'- 📊 日均消息量：**{avg_per_day:.0f} 条**')
+    if payments:
+        total_spend = sum(p['amount'] for p in payments)
+        lines.append(f'- 💰 微信支付：**¥{total_spend:.2f}**（{len(payments)} 笔交易）')
+    if chat_stats['total_sent'] > 0 and chat_stats['total_recv'] > 0:
+        ratio = chat_stats['total_sent'] / chat_stats['total_recv']
+        if ratio > 1.2:
+            lines.append(f'- 🗣️ 你是个**话痨**，发送/接收比 = {ratio:.2f}')
+        elif ratio < 0.8:
+            lines.append(f'- 👂 你是个**倾听者**，发送/接收比 = {ratio:.2f}')
+        else:
+            lines.append(f'- 🤝 沟通均衡，发送/接收比 = {ratio:.2f}')
+    if biz_stats['topic_stats']:
+        top_topic = biz_stats['topic_stats'].most_common(1)[0]
+        lines.append(f'- ❤️ 最爱看：**{top_topic[0]}**类文章（{top_topic[1]} 篇）')
+    if top_talkers:
+        lines.append(f'- 🏆 最常聊天：**{top_talkers[0][0]}**（{top_talkers[0][1]:,} 条）')
+    lines.append('')
+
+    # === Payment Details ===
+    if payments:
+        lines.append('## 💰 微信支付明细')
+        lines.append('')
+        total_spend = sum(p['amount'] for p in payments)
+        lines.append(f'> 共 {len(payments)} 笔 | 合计 ¥{total_spend:.2f}')
+        lines.append('')
+        lines.append('| 时间 | 金额 | 说明 |')
+        lines.append('|------|------|------|')
+        for p in sorted(payments, key=lambda x: -x['amount']):
+            desc = p.get('desc', '')
+            lines.append(f'| {p["time"]} | ¥{p["amount"]:.2f} | {desc} |')
+        lines.append('')
+
+    # === Transfer Details ===
+    if transfers:
+        lines.append('## 💸 微信转账')
+        lines.append('')
+        total_out = sum(t['amount'] for t in transfers if t['direction'] == '发出')
+        total_in = sum(t['amount'] for t in transfers if t['direction'] == '收到')
+        lines.append(f'> 共 {len(transfers)} 笔 | 收到 ¥{total_in:.2f} | 发出 ¥{total_out:.2f}')
+        lines.append('')
+        lines.append('| 日期 | 方向 | 金额 | 对方 |')
+        lines.append('|------|------|------|------|')
+        for t in sorted(transfers, key=lambda x: x['time']):
+            dir_icon = '←' if t['direction'] == '收到' else '→'
+            lines.append(f'| {t["time"]} | {dir_icon} {t["direction"]} | ¥{t["amount"]:.2f} | {t["contact"]} |')
+        lines.append('')
+
+    # === 收支总览 ===
+    total_pay = sum(p['amount'] for p in payments) if payments else 0
+    total_in = sum(t['amount'] for t in transfers if t['direction'] == '收到') if transfers else 0
+    total_out = sum(t['amount'] for t in transfers if t['direction'] == '发出') if transfers else 0
+    if total_pay or total_in or total_out:
+        lines.append('## 📊 收支总览')
+        lines.append('')
+        net = total_in - total_pay - total_out
+        lines.append(f'| 收入 | 支出 | 净额 |')
+        lines.append(f'|------|------|------|')
+        income_str = f'转账收到 ¥{total_in:.2f}' if total_in else '—'
+        expense_parts = []
+        if total_pay:
+            expense_parts.append(f'消费 ¥{total_pay:.2f}')
+        if total_out:
+            expense_parts.append(f'转出 ¥{total_out:.2f}')
+        expense_str = ' + '.join(expense_parts) if expense_parts else '—'
+        sign = '+' if net >= 0 else ''
+        lines.append(f'| {income_str} | {expense_str} | {sign}¥{net:.2f} |')
+        lines.append('')
+
+    return '\n'.join(lines)
+
+
+# ====== Main ======
+
+def main():
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+    parser = argparse.ArgumentParser(description='微信个人信息消费报告')
+    parser.add_argument('--period', choices=['week', 'month'], default='week', help='报告周期（默认 week）')
+    parser.add_argument('--month', help='指定月份 YYYY-MM（覆盖 --period）')
+    parser.add_argument('--output', help='输出文件路径')
+    args = parser.parse_args()
+
+    tz = timezone(timedelta(hours=8))
+    now = datetime.now(tz)
+
+    if args.month:
+        # Specified month
+        y, m = args.month.split('-')
+        start_date = datetime(int(y), int(m), 1, tzinfo=tz)
+        if int(m) == 12:
+            end_date = datetime(int(y) + 1, 1, 1, tzinfo=tz)
+        else:
+            end_date = datetime(int(y), int(m) + 1, 1, tzinfo=tz)
+        period_label = f'月报 — {args.month}'
+    elif args.period == 'week':
+        days_since_monday = now.weekday()
+        start_date = (now - timedelta(days=days_since_monday)).replace(hour=0, minute=0, second=0, microsecond=0)
+        end_date = now
+        period_label = f'周报 — {start_date.strftime("%Y-%m-%d")} ~ {end_date.strftime("%Y-%m-%d")}'
+    else:
+        start_date = now.replace(day=1, hour=0, minute=0, second=0, microsecond=0)
+        end_date = now
+        period_label = f'月报 — {now.strftime("%Y-%m")}'
+
+    start_ts = int(start_date.timestamp())
+    end_ts = int(end_date.timestamp())
+
+    print(f'=== 微信个人信息消费报告 ===')
+    print(f'周期: {period_label}')
+
+    # Load config
+    config = load_config()
+    nt_db = config.get('ntDbPath', '')
+    if not nt_db:
+        print('[ERROR] 未找到数据库路径，请先运行 weflow-cli init')
+        sys.exit(1)
+
+    nt_key = decrypt_lock(config.get('ntKey', ''))
+    nt_salt = config.get('ntSalt', '')
+
+    # Get name map and own wxid
+    keys = get_biz_keys(config)
+    name_map = get_name_map(keys['contact_db'], keys['contact_key'], keys['contact_salt'])
+    own_wxid = get_own_wxid(nt_db, nt_key, nt_salt)
+    print(f'联系人映射: {len(name_map)} | 本人账号: 已识别，未显示')
+
+    # Collect chat stats
+    print(f'\n统计聊天消息...')
+    try:
+        conn = open_db(nt_db, nt_key, nt_salt)
+    except Exception as e:
+        print(f'[ERROR] 打开数据库失败: {e}')
+        sys.exit(1)
+
+    chat_stats = collect_chat_stats(conn, start_ts, end_ts, name_map, own_wxid)
+    conn.close()
+    print(f'  消息: 发送 {chat_stats["total_sent"]:,} / 接收 {chat_stats["total_recv"]:,}')
+    print(f'  联系人: {len(chat_stats["talker_stats"])} 个')
+
+    # Collect biz stats
+    print(f'\n统计公众号文章...')
+    biz_stats = collect_biz_stats(
+        keys['biz_db'], keys['biz_key'], keys['biz_salt'],
+        start_ts, end_ts, name_map
+    )
+    print(f'  文章: {biz_stats["total_articles"]:,} 篇')
+    print(f'  公众号: {len(biz_stats["account_stats"])} 个')
+
+    # Collect payment data from biz database
+    payments = extract_payment_totals(
+        keys['biz_db'], keys['biz_key'], keys['biz_salt'],
+        start_ts, end_ts
+    )
+    if payments:
+        total = sum(p['amount'] for p in payments)
+        print(f'  微信支付: {len(payments)} 笔, ¥{total:.2f}')
+
+    # Collect transfer data
+    print(f'\n统计转账...')
+    transfers = extract_transfers(nt_db, nt_key, nt_salt, start_ts, end_ts, name_map, own_wxid)
+    total_in = sum(t['amount'] for t in transfers if t['direction'] == '收到')
+    total_out = sum(t['amount'] for t in transfers if t['direction'] == '发出')
+    if transfers:
+        print(f'  转账: {len(transfers)} 笔 | 收到 ¥{total_in:.2f} | 发出 ¥{total_out:.2f}')
+
+    # Generate report
+    print(f'\n生成报告...')
+    report = format_report(
+        chat_stats, biz_stats, payments, transfers, period_label,
+        start_date.strftime('%Y-%m-%d'), end_date.strftime('%Y-%m-%d')
+    )
+
+    # Save
+    suffix = args.month.replace('-', '') if args.month else args.period
+    output_path = args.output or os.path.join(OUTPUT_ROOT, f'微信报告_{suffix}.md')
+    os.makedirs(os.path.dirname(output_path) or '.', exist_ok=True)
+    with open(output_path, 'w', encoding='utf-8') as f:
+        f.write(report)
+
+    print(f'\n✓ 已保存到: {output_path}')
+    print(report[:500] + '...')
+
+
+if __name__ == '__main__':
+    main()