dsh-line-bot 0.5.6 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.6.0
+
+- 支援群組與多人聊天室：被 @ 或引用（回覆某則訊息）一定回，其餘訊息依「群組回覆機率」擲骰（預設 15%）。
+- 每個群組有自己的 DSH session、工作資料夾、人設與個人記憶；面板新增「群組」卡（回覆機率、開關、群組人設、清空記憶）。
+- 狀態與個人記憶清單會列出群組；新增 `group-persona`／`group-reset` 動作。
+
 ## 0.5.6
 
 - 安裝 CLI 會偵測搭配外掛（`dsh-persona-dafeiyu`、`dsh-meme`、`dsh-tieba-dive`），可互動詢問或 `--with-companions` 一起安裝；`status` 也會顯示安裝狀態。

package/README.en.md

@@ -101,6 +101,7 @@ At the top of the panel is a **sticky save bar**: "Save changes / Refresh" stays
 | DeepSeek balance | Current balance, per-turn context, low-balance proactive reminder, threshold and cooldown (deepseek-account only) |
 | Proactive messages | Toggle, probability, interval, daily/monthly caps, minimum gap, quiet hours, idle, target users, prompt, send a test now, statistics |
 | Users | The DSH session each LINE user maps to, their own workspace folder, their current persona (editable), message count, last interaction, clear memory / reset session |
+| Groups | Per-group session, workspace folder, persona, message count; reply chance when not addressed; always reply on @ / quote; clear group memory |
 | Advanced | Port, Agent provider/model/effort/cwd/timeout, one workspace per user (and its root), welcome/error/empty replies, logs, reload host modules (dev) |
 
 ## Configuration files
@@ -134,6 +135,15 @@ The "Model & provider" card chooses the provider/model used for LINE replies:
 - **Plugin custom personas**: no persona plugin required. In "Reply persona → Custom personas" you can add/edit/delete them; data lives in `<DSH_HOME>/line-bot/personas.json` (0600). When a custom persona is selected, the plugin asks dafeiyu to opt out in that session (if it is installed), then injects the custom persona into that agent's system prompt.
 - Both kinds appear in the same dropdown. The same applies when a user switches with a LINE command (`人設`, `人設 2`, `人設 <name>`).
 
+## Groups and multi-user chats
+
+When the bot is added to a group (or a multi-user room):
+
+- **Being @-mentioned always triggers a reply**, and **quoting any message always triggers a reply**; any other message is answered only when a dice roll against the *group reply chance* (default 15%) succeeds, otherwise it stays quiet.
+- Each group gets its own **DSH session, workspace folder, persona and personal memory**, separate from direct chats and other groups.
+- The `persona` command works in groups too; the panel's **Groups** card lets you tune the reply chance, toggles, per-group persona and clear a group's memory.
+- Proactive messages and DeepSeek balance reminders still target direct chats only.
+
 ## Per-user memory and personas
 
 - **Memory is not shared**: every LINE user gets their own DSH session and their own Agent workspace folder `<DSH_HOME>/line-bot/users/<LINE userId>/`. The files the Agent sees, `AGENTS.md`, and workspace memory are specific to that user; nobody reads anyone else's.

package/README.ja.md

@@ -101,6 +101,7 @@ npx dsh-line-bot install --no-companions
 | DeepSeek 残高 | 現在の残高、毎ターンの注入、残高が少ないときの主動リマインド、しきい値とクールダウン（deepseek-account のみ） |
 | 自発メッセージ | オン／オフ、確率、間隔、1 日／1 か月の上限、最短間隔、静かな時間帯、idle、対象ユーザー、プロンプト、今すぐ試送、統計 |
 | ユーザー | LINE ユーザーごとに対応する DSH セッション、専用ワークスペース、現在のペルソナ（直接変更可）、メッセージ数、最終やりとり、メモリ消去／セッション再作成 |
+| グループ | グループごとのセッション、ワークスペース、ペルソナ、メッセージ数；呼ばれていないときの返信確率；@／引用時は必ず返信；グループのメモリ消去 |
 | 詳細設定 | ポート、Agent の provider/model/effort/cwd/タイムアウト、ユーザーごとのワークスペース（ルート含む）、ウェルカム／エラー／空返信、ログ、開発用 host リロード |
 
 ## 設定ファイル
@@ -134,6 +135,15 @@ npx dsh-line-bot install --no-companions
 - **プラグイン内蔵のカスタムペルソナ**：ペルソナプラグインは不要です。「返信ペルソナ → カスタムペルソナ」で追加・編集・削除でき、データは `<DSH_HOME>/line-bot/personas.json`（0600）に保存されます。カスタムペルソナを選ぶと、プラグインは（インストールされていれば）大肥魚にそのセッションでの停止を依頼し、カスタムペルソナをその agent の system prompt に注入します。
 - どちらも同じドロップダウンから選べます。ユーザーが LINE コマンドで切り替える場合も同じです（`人設`、`人設 2`、`人設 名前`）。
 
+## グループと複数人チャット
+
+Bot がグループ（または複数人のルーム）に追加されたとき：
+
+- **@ で呼ばれたら必ず返信**、**引用（返信）されたら必ず返信**します。それ以外は「グループ返信確率」（既定 15%）の抽選に当たったときだけ返信します。
+- グループごとに **DSH セッション・ワークスペース・ペルソナ・個人メモリ** を持ち、1 対 1 のチャットや他のグループとは分かれています。
+- グループでも `人設` コマンドが使えます。パネルの「グループ」カードで返信確率・スイッチ・グループごとのペルソナ・メモリの消去を設定できます。
+- 自発メッセージと DeepSeek 残高の通知は 1 対 1 の相手にだけ送られます。
+
 ## ユーザーごとのメモリとペルソナ
 
 - **メモリは共有されません**：LINE ユーザーごとに専用の DSH セッションと、専用の Agent ワークスペース `<DSH_HOME>/line-bot/users/<LINE userId>/` を持ちます。Agent が見るファイル、`AGENTS.md`、ワークスペースメモリはそのユーザー専用で、他人のものは読みません。

package/README.ko.md

@@ -101,6 +101,7 @@ npx dsh-line-bot install --no-companions
 | DeepSeek 잔액 | 현재 잔액, 매 턴 주입, 잔액이 적을 때 캐릭터가 먼저 알림, 기준 금액과 쿨다운(deepseek-account 전용) |
 | 능동 메시지 | 켜기/끄기, 확률, 간격, 일일/월간 상한, 최소 간격, 조용한 시간대, idle, 대상 사용자, 프롬프트, 지금 시험 발송, 통계 |
 | 사용자 | LINE 사용자별 DSH 세션, 전용 작업 폴더, 현재 페르소나(직접 변경 가능), 메시지 수, 마지막 상호작용, 기억 지우기／세션 재설정 |
+| 그룹 | 그룹별 세션, 작업 폴더, 페르소나, 메시지 수; 호출되지 않았을 때 답장 확률; @／인용 시 항상 답장; 그룹 기억 지우기 |
 | 고급 설정 | 포트, Agent provider/model/effort/cwd/타임아웃, 사용자별 작업 폴더(루트 포함), 환영／오류／빈 답장, 로그, 개발용 host 리로드 |
 
 ## 설정 파일
@@ -134,6 +135,15 @@ npx dsh-line-bot install --no-companions
 - **플러그인 내장 커스텀 페르소나**: 페르소나 플러그인이 필요 없습니다. "답장 페르소나 → 커스텀 페르소나"에서 추가/편집/삭제할 수 있고 데이터는 `<DSH_HOME>/line-bot/personas.json`(0600)에 저장됩니다. 커스텀 페르소나를 고르면 플러그인은 (설치되어 있다면) 大肥魚에게 그 세션에서 중지해 달라고 한 뒤 커스텀 페르소나를 해당 agent의 system prompt에 주입합니다.
 - 두 종류 모두 같은 드롭다운에서 선택할 수 있습니다. 사용자가 LINE 명령으로 바꾸는 경우도 같습니다(`人設`, `人設 2`, `人設 이름`).
 
+## 그룹 및 다인 채팅
+
+Bot이 그룹(또는 다인 룸)에 추가되면:
+
+- **@로 호출되면 항상 답장**하고, **인용(답장)되면 항상 답장**합니다. 그 외에는 "그룹 답장 확률"(기본 15%) 주사위를 굴려 당첨될 때만 답장합니다.
+- 그룹마다 **DSH 세션, 작업 폴더, 페르소나, 개인 기억**이 따로 있으며 1:1 채팅이나 다른 그룹과 분리됩니다.
+- 그룹에서도 `人設` 명령을 쓸 수 있습니다. 패널의 "그룹" 카드에서 답장 확률, 스위치, 그룹별 페르소나, 기억 지우기를 설정할 수 있습니다.
+- 자발적 메시지와 DeepSeek 잔액 알림은 여전히 1:1 대상에게만 갑니다.
+
 ## 사용자별 기억과 페르소나
 
 - **기억은 공유되지 않습니다**: LINE 사용자마다 자신의 DSH 세션과 전용 Agent 작업 폴더 `<DSH_HOME>/line-bot/users/<LINE userId>/`가 있습니다. Agent가 보는 파일, `AGENTS.md`, 작업 공간 기억은 그 사용자 전용이며 다른 사람의 것은 읽지 않습니다.

package/README.md

@@ -101,6 +101,7 @@ npx dsh-line-bot install --no-companions
 | DeepSeek 餘額 | 目前餘額、每輪注入、低於門檻時由角色主動提醒、提醒門檻與冷卻（僅 deepseek-account） |
 | 主動傳訊 | 開關、機率、間隔、每日／每月上限、最短間隔、安靜時段、idle、指定對象、提示詞、立即試傳、統計 |
 | 使用者 | 每位 LINE 使用者對應的 DSH session、專屬工作資料夾、目前人設（可直接改）、訊息數、上次互動、清空記憶／重設 session |
+| 群組 | 每個群組的 session、工作資料夾、人設、訊息數；沒被點名時的回覆機率；被 @／引用一定回；清空群組記憶 |
 | 進階設定 | 連接埠、Agent provider/model/effort/cwd/逾時、一人一個工作資料夾（含根目錄）、歡迎／錯誤／空回覆、日誌、開發用 host 重新載入 |
 
 ## 設定檔
@@ -134,6 +135,15 @@ npx dsh-line-bot install --no-companions
 - **插件內建自訂人設**：不需要任何個性外掛。面板「回覆人設 → 自訂人設」可新增／編輯／刪除，資料存在 `<DSH_HOME>/line-bot/personas.json`（0600）。選到自訂人設時，插件會請大肥魚在該 session 停用（若它有安裝），再把自訂人設注入這個 agent 的 system prompt。
 - 兩種人設可以在同一個下拉選單裡選；使用者自己用 LINE 指令切換時也一樣（`人設`、`人設 2`、`人設 名字`）。
 
+## 群組與多人聊天室
+
+Bot 被加進群組（或多人聊天室）後：
+
+- **被 @ 一定回**、**被引用（回覆某則訊息）一定回**；其他訊息依「群組回覆機率」擲骰（預設 15%），沒中就安靜。
+- 每個群組有自己的 **DSH session、工作資料夾、人設與個人記憶**，和一對一聊天、其他群組都分開。
+- 群組裡也能用 `人設` 指令；面板「群組」卡可以調回覆機率、開關、個別群組的人設與清空記憶。
+- 主動傳訊與 DeepSeek 餘額提醒仍然只找一對一的對象。
+
 ## 每位使用者各自的記憶與人設
 
 - **記憶不共用**：每個 LINE 使用者都有自己的 DSH session，以及自己的 Agent 工作資料夾 `<DSH_HOME>/line-bot/users/<LINE userId>/`。Agent 看到的檔案、`AGENTS.md`、工作區記憶都是該使用者專屬的，不會讀到別人的。

package/README.zh-CN.md

@@ -101,6 +101,7 @@ npx dsh-line-bot install --no-companions
 | DeepSeek 余额 | 当前余额、每轮注入、低于门槛时由角色主动提醒、提醒门槛与冷却（仅 deepseek-account） |
 | 主动传讯 | 开关、概率、间隔、每日／每月上限、最短间隔、安静时段、idle、指定对象、提示词、立即试传、统计 |
 | 用户 | 每位 LINE 用户对应的 DSH session、专属工作文件夹、目前人设（可直接改）、消息数、上次互动、清空记忆／重设 session |
+| 群组 | 每个群组的 session、工作文件夹、人设、消息数；没被点名时的回复概率；被 @／引用一定回；清空群组记忆 |
 | 高级设置 | 端口、Agent provider/model/effort/cwd/超时、一人一个工作文件夹（含根目录）、欢迎／错误／空回复、日志、开发用 host 重新载入 |
 
 ## 配置文件
@@ -134,6 +135,15 @@ npx dsh-line-bot install --no-companions
 - **插件内置自定义人设**：不需要任何个性插件。面板「回复人设 → 自定义人设」可新增／编辑／删除，数据存在 `<DSH_HOME>/line-bot/personas.json`（0600）。选到自定义人设时，插件会请大肥鱼在该 session 停用（若它有安装），再把自定义人设注入这个 agent 的 system prompt。
 - 两种人设可以在同一个下拉菜单里选；用户自己用 LINE 指令切换时也一样（`人设`、`人设 2`、`人设 名字`）。
 
+## 群组与多人聊天室
+
+Bot 被加入群组（或多人聊天室）后：
+
+- **被 @ 一定回**、**被引用（回复某条消息）一定回**；其他消息按「群组回复概率」掷骰（默认 15%），没中就安静。
+- 每个群组有自己的 **DSH session、工作文件夹、人设与个人记忆**，和一对一聊天、其他群组分开。
+- 群组里也能用 `人设` 指令；面板「群组」卡可调回复概率、开关、个别群组的人设与清空记忆。
+- 主动传讯与 DeepSeek 余额提醒仍然只找一对一的对象。
+
 ## 每位用户各自的记忆与人设
 
 - **记忆不共享**：每个 LINE 用户都有自己的 DSH session，以及自己的 Agent 工作文件夹 `<DSH_HOME>/line-bot/users/<LINE userId>/`。Agent 看到的文件、`AGENTS.md`、工作区记忆都是该用户专属的，不会读到别人的。

package/client.js

@@ -23,6 +23,7 @@ window.__ModuleLoader__.load({
       { key: 'nudge', label: '主動傳訊' },
       { key: 'meme', label: '表情包' },
       { key: 'users', label: '使用者' },
+      { key: 'group', label: '群組' },
       { key: 'advanced', label: '進階／日誌' },
     ]
     const sectionDomId = (key) => `${SECTION_ID}-sec-${key}`
@@ -337,6 +338,9 @@ window.__ModuleLoader__.load({
       'nudge-test': '主動傳訊試跑',
       'agent-test': '測試 Agent 回覆',
       'user-reset': '重設使用者',
+      'user-persona': '設定使用者人設',
+      'group-persona': '設定群組人設',
+      'group-reset': '重設群組',
       'logs-clear': '清除日誌',
       setup: '一鍵上線',
     }
@@ -660,6 +664,8 @@ window.__ModuleLoader__.load({
       const nudgeCfg = cfg.nudge || {}
       const syncCfg = cfg.sync || {}
       const balanceCfg = cfg.balance || {}
+      const groupCfg = cfg.group || {}
+      const groupList = status.groups || []
       const memeCfg = cfg.stickers || {}
       const memeStatus = status.meme || {}
       const memeSample = Array.isArray(memeStatus.sample) ? memeStatus.sample : []
@@ -1201,6 +1207,49 @@ window.__ModuleLoader__.load({
                   )))),
         ),
 
+        // 6.5 群組
+        h(
+          Card,
+          { id: sectionDomId('group'), order: 12, title: '群組', desc: '被加進群組時，只有被 @、被引用，或依機率擲骰才回覆；每個群組有自己的 session、工作資料夾、人設與記憶。' },
+          h('div', { style: S.grid },
+            h(Field, { label: '沒被點名時的回覆機率（%）', hint: '每則群組訊息用這個機率決定要不要回；0 就只在被 @ 或引用時回' },
+              h(Num, { value: Math.round((Number(groupCfg.replyChance) || 0) * 100), min: 0, max: 100, step: 1, onChange: (value) => update({ group: { replyChance: value / 100 } }) })),
+          ),
+          h('div', { style: S.row },
+            h(Toggle, { checked: groupCfg.enabled !== false, onChange: (value) => update({ group: { enabled: value } }), label: '在群組裡運作', hint: '關掉後群組訊息完全不回' }),
+            h(Toggle, { checked: groupCfg.replyToMentions !== false, onChange: (value) => update({ group: { replyToMentions: value } }), label: '被 @ 一定回' }),
+            h(Toggle, { checked: groupCfg.replyToQuotes !== false, onChange: (value) => update({ group: { replyToQuotes: value } }), label: '被引用一定回' }),
+          ),
+          groupList.length === 0
+            ? h('div', { style: S.hint }, '還沒被加入任何群組，或群組還沒傳過訊息。')
+            : h('table', { style: S.table },
+                h('thead', null, h('tr', null, h('th', { style: S.th }, '群組'), h('th', { style: S.th }, 'session／資料夾'), h('th', { style: S.th }, '訊息'), h('th', { style: S.th }, '人設'), h('th', { style: S.th }, '上次互動'), h('th', { style: S.th }, ''))),
+                h('tbody', null, groupList.map((group) =>
+                  h('tr', { key: group.groupId },
+                    h('td', { style: S.td }, h('div', null, group.displayName || '（未命名群組）'), h('div', { style: { ...S.hint, ...S.mono } }, group.groupId)),
+                    h('td', { style: { ...S.td, ...S.mono } }, group.sessionId || '—', group.workspaceDir ? h('div', { style: { ...S.hint, ...S.mono, wordBreak: 'break-all' } }, group.workspaceDir) : null),
+                    h('td', { style: S.td }, String(group.messages ?? 0)),
+                    h('td', { style: S.td },
+                      h('select', {
+                        value: group.personaId || personaCfg.id || 'dafeiyu',
+                        onChange: (event) => act('group-persona', { groupId: group.groupId, personaId: event.target.value }),
+                        style: { ...S.input, padding: '3px 6px', fontSize: 12 },
+                        disabled: !!busy,
+                      },
+                        (personaCatalog.length ? personaCatalog : [{ id: group.personaId, name: group.personaName || group.personaId }]).map((item) =>
+                          h('option', { key: item.id, value: item.id }, `${item.name}${item.source === 'local' ? '（自訂）' : ''}`)))),
+                    h('td', { style: S.td }, fmtTime(group.lastAt)),
+                    h('td', { style: S.td }, h(Btn, {
+                      onClick: () => {
+                        if (typeof window !== 'undefined' && !window.confirm('這會清空這個群組自己的 session 與工作資料夾（記憶、檔案），確定？')) return
+                        act('group-reset', { groupId: group.groupId, wipeWorkspace: true })
+                      },
+                      disabled: !!busy,
+                      tone: 'danger',
+                    }, '清空記憶'))),
+                  ))),
+        ),
+
         // 7. 進階設定
         h(
           Card,

package/lib/config.mjs

@@ -54,6 +54,12 @@ export const DEFAULT_CONFIG = {
     tunnelId: '',
     verified: false,
   },
+  group: {
+    enabled: true,
+    replyChance: 0.15,
+    replyToMentions: true,
+    replyToQuotes: true,
+  },
   persona: {
     id: 'dafeiyu',
     enforce: true,
@@ -323,6 +329,7 @@ export function normalizeState(raw) {
   const state = isPlainObject(raw) ? raw : {}
   return {
     users: isPlainObject(state.users) ? state.users : {},
+    groups: isPlainObject(state.groups) ? state.groups : {},
     nudge: isPlainObject(state.nudge) ? state.nudge : {},
     balance: isPlainObject(state.balance) ? state.balance : {},
     memory: isPlainObject(state.memory) ? state.memory : {},

package/lib/host.mjs

@@ -41,7 +41,7 @@ const { createMemeSource } = memeSourceMod
 const { createStickerImages } = stickerImageMod
 const { chunkText, clip, inQuietWindow, jsonFail, jsonOk, maskSecret, readJsonBody, safeArray, sleep } = utilMod
 
-export const VERSION = '0.5.6'
+export const VERSION = '0.6.0'
 
 // 環境變數提供的 Cloudflare API Token（方便用 shell 注入、不用把 token 寫進設定檔）。
 // 設定檔裡的 token 優先；兩者都沒有時才用環境變數。
@@ -733,6 +733,60 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
     return user
   }
 
+  // 群組／多人聊天室：各自一個 session、工作資料夾、人設與記憶。
+  function ensureGroup(chatId, kind = 'group') {
+    const cfg = store.get()
+    const state = store.getState()
+    const existing = state.groups?.[chatId]
+    const workspaceDir = ensureUserWorkspace(chatId)
+    const personaId = existing?.personaId || cfg.persona.id
+    if (existing?.sessionId) {
+      if (existing.workspaceDir !== workspaceDir || existing.personaId !== personaId) {
+        const patched = { ...existing, workspaceDir, personaId, kind }
+        store.updateState((s) => ({ ...s, groups: { ...(s.groups || {}), [chatId]: patched } }))
+        return patched
+      }
+      return existing
+    }
+    const group = {
+      groupId: chatId,
+      kind,
+      sessionId: `session-${randomUUID()}`,
+      createdAt: Date.now(),
+      messages: 0,
+      lastAt: Date.now(),
+      lastUserAt: 0,
+      displayName: existing?.displayName || '',
+      personaId,
+      workspaceDir,
+    }
+    store.updateState((s) => ({ ...s, groups: { ...(s.groups || {}), [chatId]: group } }))
+    logger.info(`建立 LINE ${kind === 'room' ? '聊天室' : '群組'} ${chatId} 的 session ${group.sessionId}（工作資料夾：${workspaceDir || '共用'}）`)
+    return group
+  }
+
+  function mentionedBot(message) {
+    const botId = runtime.botInfo?.userId || ''
+    const mentionees = message?.mention?.mentionees
+    if (Array.isArray(mentionees)) {
+      for (const item of mentionees) {
+        if (item?.isSelf === true) return true
+        if (botId && item?.userId === botId) return true
+      }
+    }
+    return false
+  }
+
+  function groupGate(message, cfg) {
+    const rules = cfg.group || {}
+    if (rules.enabled === false) return { reply: false, reason: 'group-disabled' }
+    if (rules.replyToMentions !== false && mentionedBot(message)) return { reply: true, reason: 'mention' }
+    if (rules.replyToQuotes !== false && message?.quotedMessageId) return { reply: true, reason: 'quote' }
+    const chance = Number(rules.replyChance)
+    if (!Number.isFinite(chance) || chance <= 0) return { reply: false, reason: 'dice' }
+    return { reply: Math.random() < chance, reason: 'dice' }
+  }
+
   async function fetchProfile(userId) {
     const user = store.getState().users?.[userId]
     if (!user || user.displayName) return
@@ -757,6 +811,28 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
     }
   }
 
+  async function fetchGroupSummary(chatId, kind) {
+    const group = store.getState().groups?.[chatId]
+    if (!group || group.displayName) return
+    try {
+      const summary = kind === 'room'
+        ? await withToken((token) => lineApi.getRoomSummary(token, chatId))
+        : await withToken((token) => lineApi.getGroupSummary(token, chatId))
+      const name = summary?.groupName || summary?.roomName || ''
+      if (name) {
+        store.updateState((state) => ({
+          ...state,
+          groups: {
+            ...state.groups,
+            [chatId]: { ...state.groups[chatId], displayName: name, pictureUrl: summary.pictureUrl || '' },
+          },
+        }))
+      }
+    } catch (error) {
+      logger.warn(`讀取 LINE 群組摘要失敗：${errorText(error)}`)
+    }
+  }
+
   function isAllowed(userId, cfg) {
     const list = cfg.line.allowedUserIds || []
     return list.length === 0 || list.includes(userId)
@@ -791,15 +867,20 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
     return [head, '想換的話回我：', '・「人設 1」＝用清單編號', '・「人設 阿茶」＝用名字', '・「人設 預設」＝回到預設', '', ...lines].join('\n')
   }
 
-  async function handlePersonaCommand({ userId, sessionId, text, replyToken, dryRun = false }) {
+  async function handlePersonaCommand({ ownerKind = 'user', ownerId, userId, sessionId, text, replyToken, dryRun = false }) {
     const match = text.match(PERSONA_CMD)
     if (!match) return null
     const cfg = store.get()
     if (cfg.persona.allowUserSwitch === false) {
       return { reply: '這個 bot 目前不開放自行切換人設；想換請跟管理者說。' }
     }
+    const kind = ownerKind === 'group' ? 'group' : 'user'
+    const id = ownerId || userId
     const state = store.getState()
-    const user = dryRun ? state.users?.[userId] || { personaId: cfg.persona.id } : ensureUser(userId)
+    const bucket = kind === 'group' ? 'groups' : 'users'
+    const user = dryRun
+      ? (state[bucket]?.[id] || { personaId: cfg.persona.id })
+      : (kind === 'group' ? ensureGroup(id) : ensureUser(id))
     const rest = String(match[1] || '').trim()
     let summary = null
     try {
@@ -824,10 +905,14 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
       return { reply: `找不到「${rest}」這個人設。\n\n${personaMenuText(candidates, currentId)}` }
     }
     if (!dryRun) {
-      store.updateState((next) => ({
-        ...next,
-        users: { ...next.users, [userId]: { ...(next.users[userId] || {}), personaId: picked.id } },
-      }))
+      store.updateState((next) => {
+        const nextBucket = kind === 'group' ? 'groups' : 'users'
+        const map = next[nextBucket] || {}
+        return {
+          ...next,
+          [nextBucket]: { ...map, [id]: { ...(map[id] || {}), personaId: picked.id } },
+        }
+      })
       if (picked.source === 'local') {
         await persona().disableSessionPersona(sessionId).catch((error) => logger.warn(`停用大肥魚人設失敗：${errorText(error)}`))
       } else {
@@ -1125,7 +1210,10 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
     const cfg = store.get()
     if (cfg.enabled === false) return
     const type = event?.type
-    const userId = event?.source?.userId
+    const source = event?.source || {}
+    const userId = source.userId
+    const sourceKind = source.type === 'group' ? 'group' : source.type === 'room' ? 'room' : 'user'
+    const chatId = sourceKind === 'group' ? source.groupId : sourceKind === 'room' ? source.roomId : userId
     if (type === 'follow' && userId) {
       if (!isAllowed(userId, cfg)) return
       const welcome = cfg.line.welcomeText || ''
@@ -1135,7 +1223,7 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
       return
     }
     if (type !== 'message') return
-    if (!userId) return
+    if (!userId || !chatId) return
     if (!isAllowed(userId, cfg)) {
       logger.warn(`略過未授權的使用者 ${userId}（allowedUserIds）`)
       return
@@ -1174,31 +1262,52 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
     }
     if (!text) return
 
-    const user = ensureUser(userId)
+    let groupReason = ''
+    if (sourceKind !== 'user') {
+      const gate = groupGate(event.message, cfg)
+      if (!gate.reply) {
+        logger.info(`群組訊息（${gate.reason}）：這次不回`)
+        return
+      }
+      groupReason = gate.reason
+      logger.info(`群組訊息：回覆（${gate.reason}）`)
+    }
+
+    const conversationKey = sourceKind === 'user' ? userId : chatId
+    const user = sourceKind === 'user' ? ensureUser(userId) : ensureGroup(chatId, sourceKind)
+    const bucketName = sourceKind === 'user' ? 'users' : 'groups'
     store.updateState((state) => {
-      const target = state.users[userId]
+      const map = state[bucketName] || {}
+      const target = map[conversationKey]
       if (!target) return state
       return {
         ...state,
         totalMessages: (Number(state.totalMessages) || 0) + 1,
-        users: {
-          ...state.users,
-          [userId]: { ...target, messages: (Number(target.messages) || 0) + 1, lastAt: Date.now(), lastUserAt: Date.now() },
+        [bucketName]: {
+          ...map,
+          [conversationKey]: { ...target, messages: (Number(target.messages) || 0) + 1, lastAt: Date.now(), lastUserAt: Date.now() },
         },
       }
     })
 
-    const personaResult = await handlePersonaCommand({ userId, sessionId: user.sessionId, text, replyToken: event.replyToken })
+    const personaResult = await handlePersonaCommand({
+      ownerKind: sourceKind,
+      ownerId: conversationKey,
+      sessionId: user.sessionId,
+      text,
+      replyToken: event.replyToken,
+    })
     if (personaResult) {
-      await replyOrPush(userId, event.replyToken, personaResult.reply)
+      await replyOrPush(chatId, event.replyToken, personaResult.reply)
       return
     }
 
     try {
       if (cfg.line.loadingEnabled && event.replyToken) {
-        await withToken((token) => lineApi.startLoading(token, userId)).catch(() => {})
+        await withToken((token) => lineApi.startLoading(token, chatId)).catch(() => {})
       }
-      const freshUser = store.getState().users?.[userId] || user
+      const freshMap = sourceKind === 'user' ? store.getState().users : store.getState().groups
+      const freshUser = freshMap?.[conversationKey] || user
       const selection = cfg.persona.enforce ? freshUser.personaId || cfg.persona.id : ''
       const applied = await applyPersonaSelection(selection, user.sessionId)
       const result = await runner.turn({
@@ -1207,31 +1316,34 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
         persona: applied.persona,
         personaText: applied.personaText,
         personaClient: persona(),
-        contextText: agentContextText(userId),
-        tools: memoryToolsFor(userId),
+        contextText: agentContextText(conversationKey),
+        tools: memoryToolsFor(conversationKey),
         images: messageImages,
-        cwd: ensureUserWorkspace(userId) || cfg.agent.cwd || undefined,
+        cwd: ensureUserWorkspace(conversationKey) || cfg.agent.cwd || undefined,
       })
       let replyText = String(result?.text || '').trim()
       const parsedReply = splitStickerMarkers(replyText)
       if (!parsedReply.text && parsedReply.names.length === 0) replyText = cfg.line.emptyReply || '（她沒有說話）'
-      await replyOrPush(userId, event.replyToken, replyText)
-      runtime.lastReply = { userId, at: Date.now(), text: clip(parsedReply.text || (parsedReply.names.length ? `[表情包] ${parsedReply.names.join('、')}` : replyText), 300) }
-      store.updateState((state) => ({
-        ...state,
-        lastReply: runtime.lastReply,
-        users: {
-          ...state.users,
-          [userId]: { ...state.users[userId], lastAt: Date.now(), lastReplyAt: Date.now() },
-        },
-      }))
+      await replyOrPush(chatId, event.replyToken, replyText)
+      runtime.lastReply = { chatId, kind: sourceKind, at: Date.now(), text: clip(parsedReply.text || (parsedReply.names.length ? `[表情包] ${parsedReply.names.join('、')}` : replyText), 300) }
+      store.updateState((state) => {
+        const map = state[bucketName] || {}
+        const target = map[conversationKey]
+        if (!target) return { ...state, lastReply: runtime.lastReply }
+        return {
+          ...state,
+          lastReply: runtime.lastReply,
+          [bucketName]: { ...map, [conversationKey]: { ...target, lastAt: Date.now(), lastReplyAt: Date.now() } },
+        }
+      })
     } catch (error) {
       runtime.lastLineError = errorText(error)
-      logger.error(`回覆 ${userId} 失敗：${errorText(error)}`)
+      logger.error(`回覆 ${chatId} 失敗：${errorText(error)}`)
       const fallback = cfg.line.errorReply || '（剛剛卡住了，再說一次好嗎？）'
-      await replyOrPush(userId, event.replyToken, fallback).catch((err) => logger.error(`錯誤訊息也送不出去：${errorText(err)}`))
+      await replyOrPush(chatId, event.replyToken, fallback).catch((err) => logger.error(`錯誤訊息也送不出去：${errorText(err)}`))
     }
-    void fetchProfile(userId)
+    if (sourceKind === 'user') void fetchProfile(userId)
+    else void fetchGroupSummary(chatId, sourceKind)
   }
 
   // ── 元件 ────────────────────────────────────────────────────────────────
@@ -1427,6 +1539,25 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
         }
       })
       .sort((a, b) => b.lastAt - a.lastAt)
+    const groups = Object.entries(state.groups || {})
+      .map(([groupId, group]) => {
+        const personaId = group.personaId || cfg.persona.id
+        return {
+          groupId,
+          kind: group.kind || 'group',
+          sessionId: group.sessionId || '',
+          displayName: group.displayName || '',
+          pictureUrl: group.pictureUrl || '',
+          messages: Number(group.messages) || 0,
+          lastAt: Number(group.lastAt) || 0,
+          lastUserAt: Number(group.lastUserAt) || 0,
+          lastReplyAt: Number(group.lastReplyAt) || 0,
+          personaId,
+          personaName: personaNames.get(personaId) || '',
+          workspaceDir: group.workspaceDir || (cfg.agent.perUserWorkspace ? userWorkspaceDir(groupId, cfg) : ''),
+        }
+      })
+      .sort((a, b) => b.lastAt - a.lastAt)
     const hasBot = Boolean(runtime.botInfo)
     const publicCfg = publicConfig(cfg)
     if (publicCfg.cloudflare) {
@@ -1507,6 +1638,7 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
       },
       sync: { ...tiebaSync.stats(), config: cfg.sync },
       users,
+      groups,
       logs: logger.lines(),
     }
   }
@@ -1708,18 +1840,21 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
       case 'memory-list': {
         const only = String(payload.userId || '').trim()
         const state = store.getState()
-        const rows = Object.entries(state.users || {})
-          .filter(([userId]) => !only || userId === only)
-          .map(([userId, user]) => ({
-            userId,
-            displayName: user?.displayName || '',
-            entries: memory.list(userId).map((entry) => ({
-              ...entry,
-              createdText: new Date(entry.createdAt).toISOString(),
-              expiresText: entry.expiresAt ? new Date(entry.expiresAt).toISOString() : '',
-            })),
-          }))
-          .filter((row) => row.entries.length > 0)
+        const mapEntry = (kind) => ([id, item]) => ({
+          userId: id,
+          id,
+          kind,
+          displayName: item?.displayName || '',
+          entries: memory.list(id).map((entry) => ({
+            ...entry,
+            createdText: new Date(entry.createdAt).toISOString(),
+            expiresText: entry.expiresAt ? new Date(entry.expiresAt).toISOString() : '',
+          })),
+        })
+        const rows = [
+          ...Object.entries(state.users || {}).filter(([id]) => !only || id === only).map(mapEntry('user')),
+          ...Object.entries(state.groups || {}).filter(([id]) => !only || id === only).map(mapEntry('group')),
+        ].filter((row) => row.entries.length > 0)
         return { users: rows, total: rows.reduce((sum, row) => sum + row.entries.length, 0) }
       }
       case 'memory-add': {
@@ -1805,6 +1940,47 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
         }
         return { userId, personaId, personaName: picked.name || '', personaSource: picked.source || 'dafeiyu' }
       }
+      case 'group-persona': {
+        const groupId = String(payload.groupId || '').trim()
+        if (!groupId) throw new Error('缺少 groupId')
+        const personaId = String(payload.personaId || '').trim()
+        if (!personaId) throw new Error('缺少 personaId')
+        const summary = await getPersonaSummary({ force: true })
+        const picked = (summary.catalog || []).find((item) => item.id === personaId)
+        if (!picked) throw new Error(`找不到人設：${personaId}`)
+        store.updateState((state) => ({
+          ...state,
+          groups: { ...state.groups, [groupId]: { ...(state.groups[groupId] || {}), personaId } },
+        }))
+        const sessionId = store.getState().groups?.[groupId]?.sessionId
+        if (sessionId) {
+          if (picked.source === 'local') {
+            await persona().disableSessionPersona(sessionId).catch((error) => logger.warn(`停用大肥魚人設失敗：${errorText(error)}`))
+          } else {
+            await persona().setSessionPersona(sessionId, personaId).catch((error) => logger.warn(`套用人設失敗：${errorText(error)}`))
+          }
+        }
+        return { groupId, personaId, personaName: picked.name || '', personaSource: picked.source || 'dafeiyu' }
+      }
+      case 'group-reset': {
+        const groupId = String(payload.groupId || '').trim()
+        if (!groupId) throw new Error('缺少 groupId')
+        if (payload.wipeWorkspace && store.get().agent.perUserWorkspace) {
+          const target = userWorkspaceDir(groupId)
+          try {
+            fs.rmSync(target, { recursive: true, force: true })
+            logger.info(`已清空群組工作資料夾：${target}`)
+          } catch (error) {
+            logger.warn(`清空工作資料夾失敗：${errorText(error)}`)
+          }
+        }
+        store.updateState((state) => {
+          const next = { ...state, groups: { ...state.groups } }
+          delete next.groups[groupId]
+          return next
+        })
+        return { groupId, reset: true }
+      }
       case 'user-reset': {
         const userId = String(payload.userId || '')
         if (!userId) throw new Error('缺少 userId')

package/lib/line-api.mjs

@@ -95,6 +95,14 @@ export async function getProfile(accessToken, userId) {
   return request(`${MESSAGING}/profile/${encodeURIComponent(userId)}`, { headers: bearer(accessToken) })
 }
 
+export async function getGroupSummary(accessToken, groupId) {
+  return request(`${MESSAGING}/group/${encodeURIComponent(groupId)}/summary`, { headers: bearer(accessToken) })
+}
+
+export async function getRoomSummary(accessToken, roomId) {
+  return request(`${MESSAGING}/room/${encodeURIComponent(roomId)}/summary`, { headers: bearer(accessToken) })
+}
+
 export async function getQuota(accessToken) {
   return request(`${MESSAGING}/message/quota`, { headers: bearer(accessToken) })
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-line-bot",
-  "version": "0.5.6",
+  "version": "0.6.0",
   "description": "把 LINE 官方帳號（Messaging API）接進 DeepSeek Harness 的插件：內建 Cloudflare Tunnel、人設選擇（大肥魚或插件自訂）、主動傳訊與完整設定面板。",
   "type": "module",
   "main": "index.js",