weflow-cli 1.16.0 → 1.17.0

package/scripts/on_this_day.py

@@ -1,178 +1,178 @@
-"""「那年今日」：把几年前的今天你在聊什么捞出来。
-
-为什么只有本地全量数据能做到：微信的搜索只覆盖当前会话、而且历史一长就翻不动；
-这里直接按 `create_time` 扫所有分片里的每一张会话表，所以"五年前的今天"是能查的。
-
-用法：
-    python scripts/on_this_day.py                     # 1 / 3 / 5 年前的今天
-    python scripts/on_this_day.py --years 2,4,6
-    python scripts/on_this_day.py --talker 老表亲戚群   # 只看某个会话
-    python scripts/on_this_day.py --json
-"""
-from __future__ import annotations
-
-import argparse
-import re
-import json
-import pathlib
-import sys
-import time
-from collections import Counter, defaultdict
-from datetime import datetime, timezone, timedelta
-
-SCRIPT_DIR = pathlib.Path(__file__).resolve().parent
-sys.path.insert(0, str(SCRIPT_DIR))
-
-from _utils import load_config, decrypt_lock  # noqa: E402
-import nt_decrypt as nd  # noqa: E402
-
-TZ = timezone(timedelta(hours=8))
-DEFAULT_YEARS = (1, 3, 5)
-
-
-def _keys(cfg):
-    key = decrypt_lock(cfg.get('ntKey', '') or '')
-    salt = decrypt_lock(cfg.get('ntSalt', '') or '')
-    pw = decrypt_lock(cfg.get('favPassphrase', '') or cfg.get('decryptKey', '') or '')
-    return key, salt, pw
-
-
-def _text_of(content, local_type=0):
-    """消息正文 → 一行字。
-
-    **不能只看 `message_content` 是不是以 `<` 开头**：appmsg 那一族（链接/文件/小程序）
-    的内容是 zstd 压缩的二进制，原样打出来就是 `(/`$` 这种碎片（第一版就是这么翻车的）。
-    这里直接复用 `nt_decrypt` 里那套已经处理过压缩、类型标签与引用消息的显示层。
-    """
-    lt = int(local_type or 0)
-    base = lt & 0xFFFFFFFF
-    if base == 1:                      # 纯文本
-        text = nd._decode_content(content)
-        text = ' '.join(str(text).split())[:120]
-        # 群消息的 `message_content` 自带 `wxid_xxx: ` 前缀，而发言人已经在左边显示了一次
-        return re.sub(r'^[A-Za-z0-9_\-]+@?(chatroom|openim)?\s*:\s*', '', text)[:120]
-    try:
-        out = nd.non_text_display(lt, content)[:120]
-        return re.sub(r'^[A-Za-z0-9_\-]+:\s*', '', out)[:120]
-    except Exception:
-        return ''
-
-
-def day_bounds(dt):
-    start = datetime(dt.year, dt.month, dt.day, tzinfo=TZ)
-    return int(start.timestamp()), int((start + timedelta(days=1)).timestamp())
-
-
-def collect_for_day(conns, name_map, target_day, talker_filter=''):
-    """{talker: [(ts, sender, text), ...]} for one calendar day."""
-    start, end = day_bounds(target_day)
-    out = defaultdict(list)
-    for conn in conns:
-        c = conn.cursor()
-        try:
-            c.execute('SELECT user_name FROM Name2Id WHERE is_session = 1')
-            sessions = [r[0] for r in c.fetchall() if r[0]]
-        except Exception:
-            continue
-        # `real_sender_id` 是 **Name2Id 的 rowid**，不是 wxid —— 少这一步映射，
-        # 输出里发言人就全是 `65`、`4`、`8` 这样的数字（第一版就是这样）。
-        try:
-            c.execute('SELECT rowid, user_name FROM Name2Id')
-            sender_map = {r[0]: r[1] for r in c.fetchall()}
-        except Exception:
-            sender_map = {}
-        for talker in sessions:
-            if talker_filter and talker_filter not in (talker, name_map.get(talker, talker)):
-                continue
-            tbl = f'Msg_{__import__("hashlib").md5(talker.encode()).hexdigest()}'
-            try:
-                c.execute('SELECT COUNT(*) FROM sqlite_master WHERE name=?', (tbl,))
-                if c.fetchone()[0] == 0:
-                    continue
-                c.execute(f'SELECT create_time, real_sender_id, local_type, message_content '
-                          'FROM "{0}" WHERE create_time >= ? AND create_time < ? ORDER BY create_time'.format(tbl),
-                          (start, end))
-                for ts, sender, ltype, content in c.fetchall():
-                    text = _text_of(content, ltype)
-                    if text:
-                        who = sender_map.get(sender, '')
-                        out[name_map.get(talker, talker)].append(
-                            (int(ts), name_map.get(who, who), text))
-            except Exception:
-                continue
-    return out
-
-
-def main():
-    ap = argparse.ArgumentParser(description='那几年的今天你在聊什么')
-    ap.add_argument('--years', default=','.join(str(y) for y in DEFAULT_YEARS),
-                    help='往前看几年，逗号分隔（默认 1,3,5）')
-    ap.add_argument('--talker', default='', help='只看某个会话（wxid 或昵称）')
-    ap.add_argument('--limit', type=int, default=6, help='每天最多列几条（默认 6）')
-    ap.add_argument('--json', action='store_true')
-    args = ap.parse_args()
-
-    cfg = load_config()
-    db = cfg.get('ntDbPath') or ''
-    if not db:
-        raise SystemExit('配置里没有 ntDbPath，先跑 weflow-cli init')
-    key, salt, pw = _keys(cfg)
-    conns = nd.connect_message_shards(db, key, salt, pw)
-    if not conns:
-        raise SystemExit('打不开任何消息分片')
-
-    try:
-        # 联系人在 **contact.db**，不在消息库里 —— 从消息库找 `contact` 表一定落空，
-        # 输出里就只剩 `47966561144@chatroom` 和 `wxid_xxx`（第一版就是这样）。
-        name_map = {}
-        try:
-            from network import load_graph
-            people, _rooms, _members = load_graph(cfg)
-            name_map = {p['username']: (p['remark'] or p['nick'] or p['username'])
-                        for p in people.values()}
-        except Exception as exc:
-            print(f'[WARN] 读联系人失败（{type(exc).__name__}: {exc}），下面显示 id',
-                  file=sys.stderr)
-
-        today = datetime.now(TZ)
-        years = [int(y) for y in args.years.split(',') if y.strip().isdigit()]
-        result = []
-        for y in years:
-            try:
-                day = today.replace(year=today.year - y)
-            except ValueError:      # 2 月 29 日
-                day = today.replace(year=today.year - y, day=28)
-            by_talker = collect_for_day(conns, name_map, day, args.talker)
-            total = sum(len(v) for v in by_talker.values())
-            top = Counter({k: len(v) for k, v in by_talker.items()}).most_common(3)
-            picks = []
-            for talker, msgs in sorted(by_talker.items(), key=lambda kv: -len(kv[1]))[:3]:
-                for ts, sender, text in msgs[:max(1, args.limit // 3)]:
-                    picks.append({'talker': talker, 'time': datetime.fromtimestamp(ts, tz=TZ).strftime('%H:%M'),
-                                  'sender': sender, 'text': text})
-            result.append({'date': day.strftime('%Y-%m-%d'), 'yearsAgo': y,
-                           'total': total, 'threads': top, 'samples': picks[:args.limit]})
-    finally:
-        for conn in conns:
-            try:
-                conn.close()
-            except Exception:
-                pass
-
-    if args.json:
-        print(json.dumps({'success': True, 'days': result}, ensure_ascii=False, indent=2))
-        return
-
-    for item in result:
-        head = f"{item['date']}（{item['yearsAgo']} 年前的今天）"
-        if not item['total']:
-            print(f'\n{head}\n  那天没有聊天记录')
-            continue
-        threads = '、'.join(f'{n}({c})' for n, c in item['threads'])
-        print(f"\n{head}  {item['total']} 条  {threads}")
-        for s in item['samples']:
-            print(f"  {s['time']}  {s['talker']} · {s['sender'] or '?'}：{s['text']}")
-
-
-if __name__ == '__main__':
-    main()
+"""「那年今日」：把几年前的今天你在聊什么捞出来。
+
+为什么只有本地全量数据能做到：微信的搜索只覆盖当前会话、而且历史一长就翻不动；
+这里直接按 `create_time` 扫所有分片里的每一张会话表，所以"五年前的今天"是能查的。
+
+用法：
+    python scripts/on_this_day.py                     # 1 / 3 / 5 年前的今天
+    python scripts/on_this_day.py --years 2,4,6
+    python scripts/on_this_day.py --talker 老表亲戚群   # 只看某个会话
+    python scripts/on_this_day.py --json
+"""
+from __future__ import annotations
+
+import argparse
+import re
+import json
+import pathlib
+import sys
+import time
+from collections import Counter, defaultdict
+from datetime import datetime, timezone, timedelta
+
+SCRIPT_DIR = pathlib.Path(__file__).resolve().parent
+sys.path.insert(0, str(SCRIPT_DIR))
+
+from _utils import load_config, decrypt_lock  # noqa: E402
+import nt_decrypt as nd  # noqa: E402
+
+TZ = timezone(timedelta(hours=8))
+DEFAULT_YEARS = (1, 3, 5)
+
+
+def _keys(cfg):
+    key = decrypt_lock(cfg.get('ntKey', '') or '')
+    salt = decrypt_lock(cfg.get('ntSalt', '') or '')
+    pw = decrypt_lock(cfg.get('favPassphrase', '') or cfg.get('decryptKey', '') or '')
+    return key, salt, pw
+
+
+def _text_of(content, local_type=0):
+    """消息正文 → 一行字。
+
+    **不能只看 `message_content` 是不是以 `<` 开头**：appmsg 那一族（链接/文件/小程序）
+    的内容是 zstd 压缩的二进制，原样打出来就是 `(/`$` 这种碎片（第一版就是这么翻车的）。
+    这里直接复用 `nt_decrypt` 里那套已经处理过压缩、类型标签与引用消息的显示层。
+    """
+    lt = int(local_type or 0)
+    base = lt & 0xFFFFFFFF
+    if base == 1:                      # 纯文本
+        text = nd._decode_content(content)
+        text = ' '.join(str(text).split())[:120]
+        # 群消息的 `message_content` 自带 `wxid_xxx: ` 前缀，而发言人已经在左边显示了一次
+        return re.sub(r'^[A-Za-z0-9_\-]+@?(chatroom|openim)?\s*:\s*', '', text)[:120]
+    try:
+        out = nd.non_text_display(lt, content)[:120]
+        return re.sub(r'^[A-Za-z0-9_\-]+:\s*', '', out)[:120]
+    except Exception:
+        return ''
+
+
+def day_bounds(dt):
+    start = datetime(dt.year, dt.month, dt.day, tzinfo=TZ)
+    return int(start.timestamp()), int((start + timedelta(days=1)).timestamp())
+
+
+def collect_for_day(conns, name_map, target_day, talker_filter=''):
+    """{talker: [(ts, sender, text), ...]} for one calendar day."""
+    start, end = day_bounds(target_day)
+    out = defaultdict(list)
+    for conn in conns:
+        c = conn.cursor()
+        try:
+            c.execute('SELECT user_name FROM Name2Id WHERE is_session = 1')
+            sessions = [r[0] for r in c.fetchall() if r[0]]
+        except Exception:
+            continue
+        # `real_sender_id` 是 **Name2Id 的 rowid**，不是 wxid —— 少这一步映射，
+        # 输出里发言人就全是 `65`、`4`、`8` 这样的数字（第一版就是这样）。
+        try:
+            c.execute('SELECT rowid, user_name FROM Name2Id')
+            sender_map = {r[0]: r[1] for r in c.fetchall()}
+        except Exception:
+            sender_map = {}
+        for talker in sessions:
+            if talker_filter and talker_filter not in (talker, name_map.get(talker, talker)):
+                continue
+            tbl = f'Msg_{__import__("hashlib").md5(talker.encode()).hexdigest()}'
+            try:
+                c.execute('SELECT COUNT(*) FROM sqlite_master WHERE name=?', (tbl,))
+                if c.fetchone()[0] == 0:
+                    continue
+                c.execute(f'SELECT create_time, real_sender_id, local_type, message_content '
+                          'FROM "{0}" WHERE create_time >= ? AND create_time < ? ORDER BY create_time'.format(tbl),
+                          (start, end))
+                for ts, sender, ltype, content in c.fetchall():
+                    text = _text_of(content, ltype)
+                    if text:
+                        who = sender_map.get(sender, '')
+                        out[name_map.get(talker, talker)].append(
+                            (int(ts), name_map.get(who, who), text))
+            except Exception:
+                continue
+    return out
+
+
+def main():
+    ap = argparse.ArgumentParser(description='那几年的今天你在聊什么')
+    ap.add_argument('--years', default=','.join(str(y) for y in DEFAULT_YEARS),
+                    help='往前看几年，逗号分隔（默认 1,3,5）')
+    ap.add_argument('--talker', default=os.environ.get('WEFLOW_TALKER', ''), help='只看某个会话（wxid 或昵称）')
+    ap.add_argument('--limit', type=int, default=6, help='每天最多列几条（默认 6）')
+    ap.add_argument('--json', action='store_true')
+    args = ap.parse_args()
+
+    cfg = load_config()
+    db = cfg.get('ntDbPath') or ''
+    if not db:
+        raise SystemExit('配置里没有 ntDbPath，先跑 weflow-cli init')
+    key, salt, pw = _keys(cfg)
+    conns = nd.connect_message_shards(db, key, salt, pw)
+    if not conns:
+        raise SystemExit('打不开任何消息分片')
+
+    try:
+        # 联系人在 **contact.db**，不在消息库里 —— 从消息库找 `contact` 表一定落空，
+        # 输出里就只剩 `47966561144@chatroom` 和 `wxid_xxx`（第一版就是这样）。
+        name_map = {}
+        try:
+            from network import load_graph
+            people, _rooms, _members = load_graph(cfg)
+            name_map = {p['username']: (p['remark'] or p['nick'] or p['username'])
+                        for p in people.values()}
+        except Exception as exc:
+            print(f'[WARN] 读联系人失败（{type(exc).__name__}: {exc}），下面显示 id',
+                  file=sys.stderr)
+
+        today = datetime.now(TZ)
+        years = [int(y) for y in args.years.split(',') if y.strip().isdigit()]
+        result = []
+        for y in years:
+            try:
+                day = today.replace(year=today.year - y)
+            except ValueError:      # 2 月 29 日
+                day = today.replace(year=today.year - y, day=28)
+            by_talker = collect_for_day(conns, name_map, day, args.talker)
+            total = sum(len(v) for v in by_talker.values())
+            top = Counter({k: len(v) for k, v in by_talker.items()}).most_common(3)
+            picks = []
+            for talker, msgs in sorted(by_talker.items(), key=lambda kv: -len(kv[1]))[:3]:
+                for ts, sender, text in msgs[:max(1, args.limit // 3)]:
+                    picks.append({'talker': talker, 'time': datetime.fromtimestamp(ts, tz=TZ).strftime('%H:%M'),
+                                  'sender': sender, 'text': text})
+            result.append({'date': day.strftime('%Y-%m-%d'), 'yearsAgo': y,
+                           'total': total, 'threads': top, 'samples': picks[:args.limit]})
+    finally:
+        for conn in conns:
+            try:
+                conn.close()
+            except Exception:
+                pass
+
+    if args.json:
+        print(json.dumps({'success': True, 'days': result}, ensure_ascii=False, indent=2))
+        return
+
+    for item in result:
+        head = f"{item['date']}（{item['yearsAgo']} 年前的今天）"
+        if not item['total']:
+            print(f'\n{head}\n  那天没有聊天记录')
+            continue
+        threads = '、'.join(f'{n}({c})' for n, c in item['threads'])
+        print(f"\n{head}  {item['total']} 条  {threads}")
+        for s in item['samples']:
+            print(f"  {s['time']}  {s['talker']} · {s['sender'] or '?'}：{s['text']}")
+
+
+if __name__ == '__main__':
+    main()

package/scripts/opinion_timeline.py

@@ -1,138 +1,138 @@
-"""某个号的观点时间线：它这一年都说过什么，什么时候开始变了。
-
-日报每天把文章存成 `output/biz-daily/<date>/<topic>/*.md`（frontmatter 带 `source`、
-`date`，正文有 `## AI 摘要`），所以"这个号的观点怎么变"是可以按时间排出来的 ——
-而微信里你只能一篇篇点开、还没有横轴。
-
-用法：
-    python scripts/opinion_timeline.py --list                  # 哪些号存了多少篇
-    python scripts/opinion_timeline.py --source 某号      # 时间线
-    python scripts/opinion_timeline.py --source 某号 --months 3
-    python scripts/opinion_timeline.py --source 某号 --ai       # 让模型总结观点变化
-"""
-from __future__ import annotations
-
-import argparse
-import json
-import pathlib
-import re
-import sys
-from collections import defaultdict
-
-SCRIPT_DIR = pathlib.Path(__file__).resolve().parent
-sys.path.insert(0, str(SCRIPT_DIR))
-
-# 摘要复用日报那套清洗：原始文本是「【核心观点】…【关键细节】1.…」，直接打出来是噪音。
-from daily_mail import clean_summary as _clean  # noqa: E402
-
-ROOT = SCRIPT_DIR.parent
-DAILY_DIR = ROOT / 'output' / 'biz-daily'
-
-
-def parse_md(path):
-    """frontmatter + `## AI 摘要` 那一段。解析不出来就跳过，不让一篇坏文件毁掉整条时间线。"""
-    try:
-        text = path.read_text(encoding='utf-8')
-    except Exception:
-        return None
-    meta = {}
-    body = text
-    if text.startswith('---'):
-        end = text.find('\n---', 3)
-        if end > 0:
-            for line in text[3:end].splitlines():
-                if ':' in line:
-                    k, v = line.split(':', 1)
-                    meta[k.strip()] = v.strip().strip('"')
-            body = text[end + 4:]
-    summary = ''
-    m = re.search(r'##\s*AI 摘要\s*\n+(.+?)(?:\n#|\n---|$)', body, re.S)
-    if m:
-        summary = ' '.join(m.group(1).split())[:200]
-    return {
-        'title': meta.get('title', ''),
-        'source': meta.get('source', ''),
-        'date': meta.get('date', ''),
-        'relevance': meta.get('relevance', ''),
-        'topic': meta.get('topic', ''),
-        'url': meta.get('url', ''),
-        'summary': summary,
-    }
-
-
-def load_all():
-    """所有日期目录里的文章。"""
-    items = []
-    if not DAILY_DIR.is_dir():
-        return items
-    for day in sorted(DAILY_DIR.iterdir()):
-        if not day.is_dir():
-            continue
-        for md in day.rglob('*.md'):
-            rec = parse_md(md)
-            if rec and rec['source']:
-                items.append(rec)
-    return items
-
-
-def main():
-    ap = argparse.ArgumentParser(description='某个号的观点时间线')
-    ap.add_argument('--source', default='', help='公众号名（子串匹配）')
-    ap.add_argument('--months', type=int, default=0, help='只看最近 N 个月（0 = 全部）')
-    ap.add_argument('--limit', type=int, default=30, help='最多列几篇（默认 30，最近的在前）')
-    ap.add_argument('--list', action='store_true', help='列出存了哪些号、各多少篇')
-    ap.add_argument('--ai', action='store_true', help='让模型总结观点变化（要 API key）')
-    ap.add_argument('--json', action='store_true')
-    args = ap.parse_args()
-
-    items = load_all()
-    if not items:
-        raise SystemExit(f'{DAILY_DIR} 下没有可解析的文章')
-
-    if args.list:
-        counter = defaultdict(int)
-        for it in items:
-            counter[it['source']] += 1
-        rows = sorted(counter.items(), key=lambda kv: -kv[1])
-        print(f'共 {len(rows)} 个号，{len(items)} 篇\n')
-        for name, n in rows[:40]:
-            print(f'  {n:>4} 篇  {name}')
-        return
-
-    if not args.source:
-        ap.print_help()
-        return
-
-    picked = [it for it in items if args.source in it['source']]
-    if not picked:
-        raise SystemExit(f'没有匹配「{args.source}」的文章；用 --list 看有哪些号')
-    picked.sort(key=lambda x: x['date'], reverse=True)
-    if args.limit and args.limit > 0:
-        picked = picked[:args.limit]
-
-    dates = sorted({it['date'] for it in picked})
-    print(f"{picked[0]['source']}：{len(picked)} 篇，{dates[0]} ~ {dates[-1]}\n")
-    for it in picked:
-        rel = f"（{it['relevance']}）" if it['relevance'] else ''
-        print(f"{it['date']}  {it['title'][:60]}{rel}")
-        if it['summary']:
-            print(f"    {_clean(it['summary'], 160)}")
-
-    if args.ai:
-        from _utils import load_config, get_api_key, call_ai
-        api_key = get_api_key(load_config())
-        if not api_key:
-            print('\n[WARN] 没有可用的 API key，跳过观点总结', file=sys.stderr)
-            return
-        lines = [f"{it['date']} {it['title']}：{it['summary']}" for it in picked][-40:]
-        prompt = (
-            f"下面是同一个公众号「{picked[0]['source']}」按时间排列的文章与要点。\n"
-            '请用中文回答：它的关注点或立场有没有随时间变化？如果有，指出从什么变成什么，'
-            '并给出对应的日期作为证据；如果没有明显变化，就说明它一直关注什么。'
-            '不要罗列所有篇目，不要空话。\n\n' + '\n'.join(lines))
-        print('\n--- 观点变化（AI 总结）---')
-        print(call_ai(prompt, 'deepseek', api_key, max_tokens=800))
-
-
-if __name__ == '__main__':
-    main()
+"""某个号的观点时间线：它这一年都说过什么，什么时候开始变了。
+
+日报每天把文章存成 `output/biz-daily/<date>/<topic>/*.md`（frontmatter 带 `source`、
+`date`，正文有 `## AI 摘要`），所以"这个号的观点怎么变"是可以按时间排出来的 ——
+而微信里你只能一篇篇点开、还没有横轴。
+
+用法：
+    python scripts/opinion_timeline.py --list                  # 哪些号存了多少篇
+    python scripts/opinion_timeline.py --source 某号      # 时间线
+    python scripts/opinion_timeline.py --source 某号 --months 3
+    python scripts/opinion_timeline.py --source 某号 --ai       # 让模型总结观点变化
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import pathlib
+import re
+import sys
+from collections import defaultdict
+
+SCRIPT_DIR = pathlib.Path(__file__).resolve().parent
+sys.path.insert(0, str(SCRIPT_DIR))
+
+# 摘要复用日报那套清洗：原始文本是「【核心观点】…【关键细节】1.…」，直接打出来是噪音。
+from daily_mail import clean_summary as _clean  # noqa: E402
+
+ROOT = SCRIPT_DIR.parent
+DAILY_DIR = ROOT / 'output' / 'biz-daily'
+
+
+def parse_md(path):
+    """frontmatter + `## AI 摘要` 那一段。解析不出来就跳过，不让一篇坏文件毁掉整条时间线。"""
+    try:
+        text = path.read_text(encoding='utf-8')
+    except Exception:
+        return None
+    meta = {}
+    body = text
+    if text.startswith('---'):
+        end = text.find('\n---', 3)
+        if end > 0:
+            for line in text[3:end].splitlines():
+                if ':' in line:
+                    k, v = line.split(':', 1)
+                    meta[k.strip()] = v.strip().strip('"')
+            body = text[end + 4:]
+    summary = ''
+    m = re.search(r'##\s*AI 摘要\s*\n+(.+?)(?:\n#|\n---|$)', body, re.S)
+    if m:
+        summary = ' '.join(m.group(1).split())[:200]
+    return {
+        'title': meta.get('title', ''),
+        'source': meta.get('source', ''),
+        'date': meta.get('date', ''),
+        'relevance': meta.get('relevance', ''),
+        'topic': meta.get('topic', ''),
+        'url': meta.get('url', ''),
+        'summary': summary,
+    }
+
+
+def load_all():
+    """所有日期目录里的文章。"""
+    items = []
+    if not DAILY_DIR.is_dir():
+        return items
+    for day in sorted(DAILY_DIR.iterdir()):
+        if not day.is_dir():
+            continue
+        for md in day.rglob('*.md'):
+            rec = parse_md(md)
+            if rec and rec['source']:
+                items.append(rec)
+    return items
+
+
+def main():
+    ap = argparse.ArgumentParser(description='某个号的观点时间线')
+    ap.add_argument('--source', default='', help='公众号名（子串匹配）')
+    ap.add_argument('--months', type=int, default=0, help='只看最近 N 个月（0 = 全部）')
+    ap.add_argument('--limit', type=int, default=30, help='最多列几篇（默认 30，最近的在前）')
+    ap.add_argument('--list', action='store_true', help='列出存了哪些号、各多少篇')
+    ap.add_argument('--ai', action='store_true', help='让模型总结观点变化（要 API key）')
+    ap.add_argument('--json', action='store_true')
+    args = ap.parse_args()
+
+    items = load_all()
+    if not items:
+        raise SystemExit(f'{DAILY_DIR} 下没有可解析的文章')
+
+    if args.list:
+        counter = defaultdict(int)
+        for it in items:
+            counter[it['source']] += 1
+        rows = sorted(counter.items(), key=lambda kv: -kv[1])
+        print(f'共 {len(rows)} 个号，{len(items)} 篇\n')
+        for name, n in rows[:40]:
+            print(f'  {n:>4} 篇  {name}')
+        return
+
+    if not args.source:
+        ap.print_help()
+        return
+
+    picked = [it for it in items if args.source in it['source']]
+    if not picked:
+        raise SystemExit(f'没有匹配「{args.source}」的文章；用 --list 看有哪些号')
+    picked.sort(key=lambda x: x['date'], reverse=True)
+    if args.limit and args.limit > 0:
+        picked = picked[:args.limit]
+
+    dates = sorted({it['date'] for it in picked})
+    print(f"{picked[0]['source']}：{len(picked)} 篇，{dates[0]} ~ {dates[-1]}\n")
+    for it in picked:
+        rel = f"（{it['relevance']}）" if it['relevance'] else ''
+        print(f"{it['date']}  {it['title'][:60]}{rel}")
+        if it['summary']:
+            print(f"    {_clean(it['summary'], 160)}")
+
+    if args.ai:
+        from _utils import load_config, get_api_key, call_ai
+        api_key = get_api_key(load_config())
+        if not api_key:
+            print('\n[WARN] 没有可用的 API key，跳过观点总结', file=sys.stderr)
+            return
+        lines = [f"{it['date']} {it['title']}：{it['summary']}" for it in picked][-40:]
+        prompt = (
+            f"下面是同一个公众号「{picked[0]['source']}」按时间排列的文章与要点。\n"
+            '请用中文回答：它的关注点或立场有没有随时间变化？如果有，指出从什么变成什么，'
+            '并给出对应的日期作为证据；如果没有明显变化，就说明它一直关注什么。'
+            '不要罗列所有篇目，不要空话。\n\n' + '\n'.join(lines))
+        print('\n--- 观点变化（AI 总结）---')
+        print(call_ai(prompt, 'deepseek', api_key, max_tokens=800))
+
+
+if __name__ == '__main__':
+    main()