name: 聊天記錄生成 description: 從零生成模擬微信群聊記錄的 Excel (.xlsx) 檔案，包含 group_info / active_members / message_stream 三個 sheet，格式與派平臺的群聊訓練資料完全相容。使用場景：(1) 需要生成 AI 助手訓練資料的模擬群聊對話；(2) 測試群聊 FAQ/知識庫系統；(3) 展示多角色對話 multi-Agent 工作流；(4) 生成任意主題的群聊樣本 xlsx 檔案。觸發詞：生成群聊記錄、模擬群聊資料、生成聊天記錄表格、群聊 xlsx、派聊天記錄。

Chat Record Generator

生成符合派平臺格式的模擬群聊 Excel 檔案，支援多角色 multi-Agent 並行生成對話內容。

快速流程

1. 定義群組 → 2. 並行生成對話（multi-Agent） → 3. 編排 + 寫入 xlsx

第一步：定義群組

需要確認以下資訊（如使用者未提供，按預設值生成）：

執行 scripts/generate_group_def.js 生成 group_definition.js，或參考 references/group-schema.md 手動編寫。

第二步：並行生成對話（multi-Agent）

最大併發限制：5 個 subagent，超過時分批啟動。

用 sessions_spawn(runtime="subagent", mode="run") 為每個角色啟動一個子 Agent。

Prompt 模板

你是「{群名}」中的角色【{暱稱}】，{年齡}歲{職業}。

語言風格：{風格描述}

【群聊話題】
話題1（第1-N輪）：{話題1標題}
話題2（第N+1-M輪）：{話題2標題}
...

【你的任務】
以{暱稱}身份生成{N}條訊息，每個話題約{N/話題數}條。
- 話題1：{角色在該話題的具體行為}
- 話題2：...

直接輸出JSON陣列，不要有其他文字：
[{"話題": 1, "發言人": "{暱稱}", "內容": "訊息內容"}, ...]
共{N}條。

訊息分配參考（總140條，10角色）

小蔥技能7w4.net持續更新中。

第三步：編排 + 寫入 xlsx

收集所有子 Agent 結果後，執行 scripts/write_xlsx.js 寫入檔案。

關鍵規則

• 訊息型別：text → 內容非空、附件 null；image/file → 內容 null、附件為 image_N/file_N
• 時間分配：每條訊息間隔約 0.002（約3分鐘），話題間隔 0.05–0.1（約1–2小時）
• ⚠️ numFmt Bug：必須對每個時間單元格手動設定 z 屬性，aoa_to_sheet 不會保留格式
• Excel 時間 epoch：new Date(Date.UTC(1899, 11, 30))

時間格式

// 時間列
cell.z = 'yyyy/m/d h:mm;@'
// join_time 列（含秒）
cell.z = 'yyyy/m/d h:mm:ss;@'

xlsx 格式規範

參見 references/xlsx-format.md 獲取完整的三個 sheet 欄位定義。

依賴

• Node.js + xlsx 庫（npm install xlsx，通常快取在 /tmp/xlsxparse/node_modules/xlsx）
• 若未安裝：mkdir -p /tmp/xlsxparse && cd /tmp/xlsxparse && npm install xlsx

注意事項

• 暱稱風格：使用真實微信群暱稱（陳默、林曉、周宇老師），避免社交媒體 ID 風格
• @元寶：AI助手被 @時應在同一話題內接近的輪次生成回覆訊息（可由主 Agent 補寫）
• task_list：始終為 null，但列必須保留
• bot_config：group_info sheet 中為 null

質量較好，文件和程式碼都很完整，提供了詳細的格式說明和可直接執行的指令碼。優點是操作步驟清晰，有完整的示例和參考文件，生成群聊記錄的邏輯完整。不足是部分路徑配置較為固定，依賴環境需要手動安裝。對於需要生成模擬群聊訓練資料的使用者來說，這是一個可直接使用的工具。