用途:读取指定目录下的 .jsonl 会话文件,经清洗归一化后按时间窗口计算指标、归类话题、审查风险,并与上一周期对比,输出一个自包含的英文 Markdown 周报。默认时区为 Asia/Shanghai。
主要能力:按固定报告顺序生成标题、执行摘要、本周发布、周话题排名、未解决高优先级问题、周环比对比、周活跃度、趋势与建议、方法与数据说明、往期报告、结构化数据附录。使用半开时间区间区分当前与上一窗口,两者时长相等、边界相接且不重叠,默认连续七天。计算 discussion_units、effective_discussions、participants、human_messages、assistant_messages、system_messages、unknown_role_messages、total_messages 等指标,并保持消息总数不变式。支持话题多标签分类与关键词 Top 20,按讨论单元等稳定顺序排名。
使用方式:提供必填的 sessions_root,递归读取 .jsonl;可选 current_start/current_end、previous_start/previous_end、previous_report、output_path、session_scope、history。默认输出文件名 OpenViking_Community_QA_Weekly_Report_YYYY-MM-DD_to_YYYY-MM-DD.md,未指定 output_path 时写入 reports/qa-weekly-YYYYMMDD-YYYYMMDD/。可用命令先列出候选文件:rg --files "$SESSION_ROOT" -g '*.jsonl'。
限制与边界:仅以 sessions_root 下的会话文件为分析来源,不合并其他社区或在线聊天数据;只交付一个 .md 文件;不调用在线文档、消息、联系人、白板 API,不创建 XML/HTML/SVG/PNG,不上传内容。不得凭直觉估计数字,结论须可追溯;无法证明时写“截至数据截止前未发现支持性证据”。输出不得包含完整人名、邮箱、电话、原始身份键、密钥等敏感信息。发布信息仅采纳明确完成信号,计划类说法不算已发布。若周环比数据缺失,标记为不可用或不可比,绝不以 0 替代未知值。