dsh-line-bot 0.9.2 → 0.9.4

package/AGENTS.md

@@ -23,7 +23,7 @@ curl -s http://127.0.0.1:8791/health
 
 | 症狀 | 先看哪個 check | 常見原因 | 安全修法 |
 | --- | --- | --- | --- |
-| 完全沒回覆 | `server`、`tunnel`、`webhook` | webhook 指到舊 tunnel；LINE「Use webhook」沒開；伺服器沒啟動 | `doctor --fix`；面板「套用 Webhook」；到 LINE console 開 Use webhook |
+| 完全沒回覆 | `server`、`tunnel`、`webhook`、面板「使用者」待審核 | webhook 指到舊 tunnel；LINE「Use webhook」沒開；伺服器沒啟動；使用者還沒核准 | `doctor --fix`；面板「套用 Webhook」；到 LINE console 開 Use webhook；在「使用者」核准對方 |
 | 有回文字但沒圖片 | `dsh-meme`、`meme-config`、`public-url`、`media`、`converters` | 沒裝 dsh-meme；`stickers.enabled=false`；公開網址還沒就緒；GIF/webp 沒有轉圖工具 | 面板「表情包」開啟並看圖庫；`doctor --fix`；安裝 ffmpeg |
 | 回覆出現 `[[meme:…]]`、`<meme#18>` 文字 | 版本 | 舊版不認得標記格式 | 升級到 0.6.1+（目前 0.9.x） |
 | 貼圖／圖片看不懂 | `model`、`vision` | 模型不吃圖，或 modlens 不可用／失敗 | 面板「模型與接口來源」換成有 `text+image` 的模型；或安裝 modlens 並設定 provider |

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.9.4
+
+- 修正主動訊息（排程傳訊、餘額提醒、核准通知）只更新計數、沒有真的呼叫 LINE push API 的問題；現在會實際送出，失敗時不再累加次數。
+- 主動訊息送出後記錄 LINE 回應的訊息數，方便日後從日誌確認。
+
+## 0.9.3
+
+- 身分門控改為預設關閉：白名單為空時，任何人都不能觸發 Agent；未授權的 LINE 使用者只會進入「待審核」佇列，不會建立 session、不會呼叫工具。
+- 面板「使用者」新增待審核名單，可核准或拒絕；核准後才加入白名單並通知對方。LINE 憑證卡可切換 `approval`（待審核）／`whitelist`（直接忽略）兩種模式。
+- 主動傳訊、餘額提醒與記憶整理只會挑選白名單內的使用者。
+- 文件補上「第一次使用要先核准自己」與隱私說明；更新 awesome-dsh-plugin 條目描述（需要 Messaging API 頻道、只有白名單使用者能對話）。
+
 ## 0.9.2
 
 - LINE 一般圖片：收到 `image` 訊息時透過 LINE content API 下載，模型支援圖片就直接附圖；不支援時改用 modlens 或另一個視覺模型描述。

package/README.en.md

@@ -81,7 +81,7 @@ Without them: no dafeiyu means only plugin-local personas; no dsh-meme means tex
 2. **Fill in the panel**: under "LINE Bot → LINE credentials", paste the Channel ID and Channel Secret, click "Save changes" → "Verify and read bot info". On success you will see the bot's name and Basic ID.
 3. **Start the webhook server**: on "Overview", click "Start all", or "Start" to bring up both the webhook server and the tunnel (auto-start is on by default).
 4. **Open the tunnel**: for a quick tunnel just click "Start tunnel"; for a fixed URL, paste an API token under "Cloudflare Tunnel" → "Verify API token" → "Create/update tunnel and DNS" (token permissions: Account → Cloudflare Tunnel → Edit, Zone → DNS → Edit, Zone → Zone → Read). A quick tunnel's URL changes on every restart (the plugin writes the new URL back to the LINE webhook automatically); a named tunnel's URL is fixed.
-5. **Auto-configure the webhook**: once the tunnel is ready the endpoint is PUT to LINE automatically; if that fails, click "Apply tunnel URL to webhook" and then "Test webhook". After that, add the bot as a friend in LINE and send it a message.
+5. **Auto-configure the webhook**: once the tunnel is ready the endpoint is PUT to LINE automatically; if that fails, click "Apply tunnel URL to webhook" and then "Test webhook". After that, add the bot as a friend in LINE and send it a message; the first message lands in the pending queue — approve your userId under Users in the panel before the bot replies (the allowlist starts empty).
 
 ## Panel sections
 
@@ -101,7 +101,7 @@ At the top of the panel is a **sticky save bar**: "Save changes / Refresh" stays
 | Sticker & image vision | Fetch incoming LINE stickers or images and show them to the model; when the model cannot read images, describe them with modlens or a vision model (can be disabled) |
 | 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 |
+| Users | Pending approval queue (approve / deny), 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) |
 
@@ -248,7 +248,8 @@ The persona can attach a sticker to a text reply, or reply with just an image. I
 
 ## Security notes
 
-- This is equivalent to attaching the DSH Agent to a public LINE account: anyone who has the bot can make the Agent use tools on your computer. It is recommended to fill in your own LINE userId under "Allow-listed user IDs" so only you can use it.
+- The allowlist starts empty: unknown users are only queued as pending, with no session and no tool access, until you approve them under Users in the panel.
+- This attaches the DSH Agent to LINE: anyone you approve can make the Agent use tools on your computer. Approve only LINE accounts you trust, and review the Users list periodically.
 - All credentials are stored locally in `config.json` (600); the panel only shows masked values; the API only listens on the DSH webServer at `127.0.0.1`.
 - Give the Cloudflare API token only the permissions it needs, and revoke it when you no longer use it.
 

package/README.ja.md

@@ -81,7 +81,7 @@ npx dsh-line-bot install --no-companions
 2. **パネルに入力**：「LINE Bot → LINE 認証情報」に Channel ID と Channel Secret を貼り、「変更を保存」→「検証して bot 情報を取得」を押します。成功すると bot 名と Basic ID が表示されます。
 3. **webhook サーバーを起動**：「概要」で「すべて起動」を押すか、「起動」を押して webhook サーバーとトンネルを両方立ち上げます（既定で自動起動します）。
 4. **トンネルを開く**：Quick tunnel なら「トンネルを起動」を押すだけ。固定 URL が必要なら「Cloudflare Tunnel」で API トークンを貼り →「API トークンを検証」→「トンネルと DNS を作成／更新」（トークン権限：Account → Cloudflare Tunnel → Edit、Zone → DNS → Edit、Zone → Zone → Read）。quick tunnel は再起動のたびに URL が変わります（プラグインが新しい URL を LINE webhook に自動で書き戻します）。名前付きトンネルの URL は固定です。
-5. **webhook を自動設定**：トンネルの準備ができると自動で LINE に PUT します。失敗したら「トンネル URL を webhook に適用」→「webhook をテスト」を押します。あとは LINE で bot を友だち追加してメッセージを送るだけです。
+5. **webhook を自動設定**：トンネルの準備ができると自動で LINE に PUT します。失敗したら「トンネル URL を webhook に適用」→「webhook をテスト」を押します。あとは LINE で bot を友だち追加してメッセージを送ります。最初のメッセージは「承認待ち」に入るので、パネルの「ユーザー」で自分の userId を承認してください（許可リストは初期状態では空です）。
 
 ## パネルの各セクション
 
@@ -248,6 +248,7 @@ Bot がグループ（または複数人のルーム）に追加されたとき
 
 ## セキュリティ上の注意
 
+- 許可リストは初期状態では空です。知らないユーザーのメッセージは承認待ちに入るだけで、セッションも作られず、ツールも呼ばれません。パネルの「ユーザー」で承認すると返信を始めます。
 - これは DSH Agent を公開された LINE アカウントにつなぐのと同じです。bot を知っている人は、あなたのコンピューター上のツールを Agent に使わせられます。「許可リストのユーザー ID」に自分の LINE userId を入れて、自分だけが使えるようにすることをおすすめします。
 - 認証情報はすべてローカルの `config.json`（600）に保存され、パネルにはマスクされた値だけが表示されます。API は `127.0.0.1` の DSH webServer にのみ公開されます。
 - Cloudflare API トークンは必要最小限の権限にし、使わなくなったら取り消してください。

package/README.ko.md

@@ -81,7 +81,7 @@ npx dsh-line-bot install --no-companions
 2. **패널에 입력**: "LINE Bot → LINE 자격 증명"에 Channel ID와 Channel Secret을 붙여 넣고 "변경 저장" → "검증하고 bot 정보 읽기"를 누릅니다. 성공하면 bot 이름과 Basic ID가 표시됩니다.
 3. **webhook 서버 시작**: "개요"에서 "모두 시작"을 누르거나 "시작"을 눌러 webhook 서버와 터널을 함께 올립니다(기본값은 자동 시작).
 4. **터널 열기**: Quick tunnel은 "터널 시작"만 누르면 됩니다. 고정 URL이 필요하면 "Cloudflare Tunnel"에서 API 토큰을 붙여 넣고 → "API 토큰 검증" → "터널과 DNS 생성／업데이트"(토큰 권한: Account → Cloudflare Tunnel → Edit, Zone → DNS → Edit, Zone → Zone → Read). quick tunnel은 재시작할 때마다 URL이 바뀌며(플러그인이 새 URL을 LINE webhook에 자동으로 다시 씁니다), 이름 있는 터널의 URL은 고정입니다.
-5. **webhook 자동 설정**: 터널이 준비되면 자동으로 LINE에 PUT합니다. 실패하면 "터널 URL을 webhook에 적용" → "webhook 테스트"를 누릅니다. 그다음 LINE에서 bot을 친구 추가하고 메시지를 보내면 됩니다.
+5. **webhook 자동 설정**: 터널이 준비되면 자동으로 LINE에 PUT합니다. 실패하면 "터널 URL을 webhook에 적용" → "webhook 테스트"를 누릅니다. 그다음 LINE에서 bot을 친구 추가하고 메시지를 보냅니다. 첫 메시지는 "승인 대기"로 들어가며, 패널의 "사용자"에서 자신의 userId를 승인해야 응답합니다(허용 목록은 기본적으로 비어 있습니다).
 
 ## 패널 구성
 
@@ -246,6 +246,7 @@ Bot이 그룹(또는 다인 룸)에 추가되면:
 
 ## 보안 안내
 
+- 허용 목록은 기본적으로 비어 있습니다. 모르는 사용자의 메시지는 승인 대기로만 들어가며, 세션이 만들어지거나 도구가 호출되지 않습니다. 패널의 "사용자"에서 승인해야 응답합니다.
 - 이는 DSH Agent를 공개된 LINE 계정에 연결하는 것과 같습니다. bot을 아는 사람은 당신의 컴퓨터에 있는 도구를 Agent가 사용하게 할 수 있습니다. "허용 목록 사용자 ID"에 자신의 LINE userId를 넣어 자신만 사용하도록 하는 것을 권장합니다.
 - 모든 자격 증명은 로컬 `config.json`(600)에 저장되고 패널에는 마스킹된 값만 보입니다. API는 `127.0.0.1`의 DSH webServer에만 열립니다.
 - Cloudflare API 토큰은 필요한 권한만 주고, 사용하지 않을 때는 폐기하세요.

package/README.md

@@ -81,7 +81,7 @@ npx dsh-line-bot install --no-companions
 2. **填入面板**：「LINE Bot → LINE 憑證」貼上 Channel ID、Channel Secret，按「儲存變更」→「驗證並讀取 bot 資訊」。成功會看到 bot 名稱與 Basic ID。
 3. **啟動 webhook 伺服器**：面板「狀態總覽」按「啟動全部」，或只按「啟動」讓 webhook server 與 tunnel 都起來（預設會自動啟動）。
 4. **開隧道**：Quick tunnel 直接按「啟動隧道」；要固定網址就在「Cloudflare Tunnel」貼 API Token →「驗證 API Token」→「建立／更新隧道與 DNS」（API Token 權限：Account → Cloudflare Tunnel → Edit、Zone → DNS → Edit、Zone → Zone → Read）。quick tunnel 每次重啟網址都會變（插件會自動把新網址寫回 LINE webhook）；具名隧道的網址則固定。
-5. **自動設定 webhook**：隧道就緒後會自動 PUT 到 LINE；若沒成功，按「把隧道網址套到 webhook」再「測試 webhook」。之後在 LINE 加 bot 好友、傳訊息即可。
+5. **自動設定 webhook**：隧道就緒後會自動 PUT 到 LINE；若沒成功，按「把隧道網址套到 webhook」再「測試 webhook」。之後在 LINE 加 bot 好友、傳訊息；第一次訊息會進入「待審核」，到面板「使用者」按「核准」後才會開始回覆（白名單預設是空的）。
 
 ## 面板各區
 
@@ -101,7 +101,7 @@ npx dsh-line-bot install --no-companions
 | 貼圖與圖片理解 | 收到 LINE 貼圖或一般圖片時抓圖給模型看；模型不吃圖時用 modlens 或另一個視覺模型描述（可關閉） |
 | DeepSeek 餘額 | 目前餘額、每輪注入、低於門檻時由角色主動提醒、提醒門檻與冷卻（僅 deepseek-account） |
 | 主動傳訊 | 開關、機率、間隔、每日／每月上限、最短間隔、安靜時段、idle、指定對象、提示詞、立即試傳、統計 |
-| 使用者 | 每位 LINE 使用者對應的 DSH session、專屬工作資料夾、目前人設（可直接改）、訊息數、上次互動、清空記憶／重設 session |
+| 使用者 | 待審核名單（核准／拒絕）、每位 LINE 使用者對應的 DSH session、專屬工作資料夾、目前人設（可直接改）、訊息數、上次互動、清空記憶／重設 session |
 | 群組 | 每個群組的 session、工作資料夾、人設、訊息數；沒被點名時的回覆機率；被 @／引用一定回；清空群組記憶 |
 | 進階設定 | 連接埠、Agent provider/model/effort/cwd/逾時、一人一個工作資料夾（含根目錄）、歡迎／錯誤／空回覆、日誌、開發用 host 重新載入 |
 
@@ -248,7 +248,8 @@ Bot 被加進群組（或多人聊天室）後：
 
 ## 安全提醒
 
-- 這等同把 DSH Agent 接到公開的 LINE 帳號：拿到 bot 的人可以讓 Agent 使用你電腦上的工具。建議在「白名單使用者 ID」填入自己的 LINE userId，只允許自己使用。
+- 白名單預設是空的：陌生人傳訊息只會進入待審核，不會建立 session、也不會呼叫工具；在面板「使用者」核准後才會開始回覆。
+- 這等同把 DSH Agent 接到 LINE：核准名單內的人可以讓 Agent 使用你電腦上的工具。請只核准你信任的 LINE 帳號，並定期檢查「使用者」清單。
 - 所有憑證都存在本機 `config.json`（600），面板只會看到遮罩後的值；API 只掛在 `127.0.0.1` 的 DSH webServer 上。
 - Cloudflare API Token 建議只給必要權限，並在不用時撤銷。
 

package/README.zh-CN.md

@@ -81,7 +81,7 @@ npx dsh-line-bot install --no-companions
 2. **填入面板**：「LINE Bot → LINE 凭证」贴入 Channel ID、Channel Secret，按「保存更改」→「验证并读取 bot 信息」。成功会看到 bot 名称与 Basic ID。
 3. **启动 webhook 服务器**：面板「状态总览」按「启动全部」，或只按「启动」让 webhook server 与 tunnel 都起来（默认会自动启动）。
 4. **开隧道**：Quick tunnel 直接按「启动隧道」；要固定网址就在「Cloudflare Tunnel」贴 API Token →「验证 API Token」→「创建／更新隧道与 DNS」（API Token 权限：Account → Cloudflare Tunnel → Edit、Zone → DNS → Edit、Zone → Zone → Read）。quick tunnel 每次重启网址都会变（插件会自动把新网址写回 LINE webhook）；具名隧道的网址则固定。
-5. **自动设置 webhook**：隧道就绪后会自动 PUT 到 LINE；若没成功，按「把隧道网址套到 webhook」再「测试 webhook」。之后在 LINE 加 bot 好友、传消息即可。
+5. **自动设置 webhook**：隧道就绪后会自动 PUT 到 LINE；若没成功，按「把隧道网址套到 webhook」再「测试 webhook」。之后在 LINE 加 bot 好友、传消息；第一条消息会进入「待审核」，到面板「使用者」按「核准」后才会开始回复（白名单默认为空）。
 
 ## 面板各区
 
@@ -248,6 +248,7 @@ Bot 被加入群组（或多人聊天室）后：
 
 ## 安全提醒
 
+- 白名单默认为空：陌生人发消息只会进入待审核，不会建立 session、不会调用工具；在面板「使用者」核准后才会开始回复。
 - 这等同把 DSH Agent 接到公开的 LINE 账号：拿到 bot 的人可以让 Agent 使用你电脑上的工具。建议在「白名单用户 ID」填入自己的 LINE userId，只允许自己使用。
 - 所有凭证都存在本机 `config.json`（600），面板只会看到遮罩后的值；API 只挂在 `127.0.0.1` 的 DSH webServer 上。
 - Cloudflare API Token 建议只给必要权限，并在不用时撤销。

package/client.js

@@ -304,6 +304,12 @@ window.__ModuleLoader__.load({
 
     const ACTION_LABELS = {
       'meme-stats': '讀取表情包圖庫',
+      'access-list': '讀取待審核名單',
+      'access-mode': '切換身分門控',
+      'access-approve': '核准使用者',
+      'access-deny': '拒絕使用者',
+      'access-add': '加入白名單',
+      'access-remove': '移出白名單',
       start: '啟動',
       stop: '停止',
       restart: '重新啟動',
@@ -724,6 +730,7 @@ window.__ModuleLoader__.load({
 
       const cfg = draft
       const line = cfg.line || {}
+      const access = status.access || {}
       const server = cfg.server || {}
       const tunnel = cfg.tunnel || {}
       const cloudflare = cfg.cloudflare || {}
@@ -991,7 +998,16 @@ window.__ModuleLoader__.load({
             h(Btn, { onClick: () => act('webhook-test'), disabled: !!busy }, '測試 webhook'),
           ),
           h('div', { style: S.hint }, '「Use webhook」開關只能在 LINE console 的 Messaging API 設定頁手動開啟；端點本身由插件自動設定。'),
-          h(Field, { label: '白名單使用者 ID', hint: '一行一個；留空＝任何加 bot 的人都能用。可從下方「使用者」清單複製。' }, h(Area, { value: textList(line.allowedUserIds), onChange: (value) => update({ line: { allowedUserIds: parseList(value) } }), rows: 2, mono: true })),
+          h(
+            'div',
+            { style: S.grid },
+            h(Field, { label: '身分門控', hint: 'approval＝未授權者進待審核；whitelist＝直接忽略未授權者' },
+              h('select', { value: line.accessMode || 'approval', onChange: (event) => update({ line: { accessMode: event.target.value } }), style: S.input },
+                h('option', { value: 'approval' }, 'approval（待審核）'),
+                h('option', { value: 'whitelist' }, 'whitelist（直接拒絕）'))),
+            h(Field, { label: '白名單使用者 ID', hint: '一行一個；留空＝沒有人能使用。未授權者會出現在下方「使用者」待審核。' }, h(Area, { value: textList(line.allowedUserIds), onChange: (value) => update({ line: { allowedUserIds: parseList(value) } }), rows: 2, mono: true })),
+          ),
+          h('div', { style: access.gateOpen ? S.hint : S.warnBox }, access.gateOpen ? `目前已核准 ${(access.allowedUserIds || []).length} 人；未授權者不能觸發 Agent。` : '白名單目前是空的：bot 不會回覆任何人。請先讓使用者傳訊息，再到下方「使用者」核准。'),
         ),
 
         // 3. Cloudflare Tunnel
@@ -1289,6 +1305,18 @@ window.__ModuleLoader__.load({
         h(
           Card,
           { id: sectionDomId('users'), order: 12, title: '使用者', desc: '與 bot 互動過的 LINE 使用者。每個人有自己的 DSH session 與工作資料夾（記憶、檔案不互通），人設也可以個別指定。' },
+          (access.pending || []).length > 0
+            ? h('div', { style: S.panelBox },
+                h('div', { style: S.fieldTitle }, `待審核（${access.pending.length}）`),
+                h('div', { style: S.hint }, '這些人的訊息不會觸發 Agent；核准後會加入白名單並通知對方。'),
+                (access.pending || []).map((item) => h('div', { key: item.userId, style: { display: 'flex', gap: 8, alignItems: 'center', padding: '6px 0', borderTop: '1px solid var(--dsw-alias-border-l2)' } },
+                  h('div', { style: { flex: 1, minWidth: 0 } },
+                    h('div', null, item.displayName || '（未命名）'),
+                    h('div', { style: { ...S.hint, ...S.mono, wordBreak: 'break-all' } }, item.userId),
+                    item.lastText ? h('div', { style: S.hint }, item.lastText) : null),
+                  h(Btn, { onClick: () => act('access-approve', { userId: item.userId }), disabled: !!busy, tone: 'primary' }, '核准'),
+                  h(Btn, { onClick: () => act('access-deny', { userId: item.userId }), disabled: !!busy }, '拒絕'))))
+            : null,
           (status.users || []).length === 0
             ? h('div', { style: S.hint }, '還沒有人傳訊息給 bot。')
             : h('table', { style: S.table },

package/lib/config.mjs

@@ -27,6 +27,7 @@ export const DEFAULT_CONFIG = {
     loadingEnabled: true,
     stickerVision: true,
     imageVision: true,
+    accessMode: 'approval', // approval | whitelist
     allowedUserIds: [],
     welcomeText: '（已加好友）嗨，我是大肥魚～想聊什麼都可以跟我說。',
     errorReply: '（剛剛卡住了，再說一次好嗎？）',
@@ -194,7 +195,8 @@ export function sanitizePatch(current, patch) {
   next.line.channelId = String(line.channelId || '').trim()
   next.line.accessToken = String(next.line.accessToken || '').trim()
   next.line.tokenExpiresAt = clampInt(next.line.tokenExpiresAt, 0, Number.MAX_SAFE_INTEGER, 0)
-  next.line.allowedUserIds = safeArray(next.line.allowedUserIds)
+  next.line.allowedUserIds = safeArray(next.line.allowedUserIds).map((id) => String(id).trim()).filter(Boolean)
+  next.line.accessMode = ['approval','whitelist'].includes(next.line.accessMode) ? next.line.accessMode : 'approval'
   next.line.loadingEnabled = Boolean(next.line.loadingEnabled)
   next.line.stickerVision = Boolean(next.line.stickerVision)
   next.line.imageVision = Boolean(next.line.imageVision)
@@ -349,6 +351,7 @@ export function normalizeState(raw) {
     users: isPlainObject(state.users) ? state.users : {},
     groups: isPlainObject(state.groups) ? state.groups : {},
     people: isPlainObject(state.people) ? state.people : {},
+    pendingUsers: isPlainObject(state.pendingUsers) ? state.pendingUsers : {},
     nudge: isPlainObject(state.nudge) ? state.nudge : {},
     balance: isPlainObject(state.balance) ? state.balance : {},
     memory: isPlainObject(state.memory) ? state.memory : {},

package/lib/host.mjs

@@ -47,7 +47,7 @@ const { createStickerImages } = stickerImageMod
 const { createVision } = visionMod
 const { chunkText, clip, inQuietWindow, jsonFail, jsonOk, maskSecret, readJsonBody, safeArray, sleep, readJsonSafe } = utilMod
 
-export const VERSION = '0.9.2'
+export const VERSION = '0.9.4'
 
 // 環境變數提供的 Cloudflare API Token（方便用 shell 注入、不用把 token 寫進設定檔）。
 // 設定檔裡的 token 優先；兩者都沒有時才用環境變數。
@@ -364,7 +364,7 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
     const cooldownMs = Math.max(1, Number(cfg.balance.cooldownHours) || 12) * 3600_000
     if (!force && lastAskAt && Date.now() - lastAskAt < cooldownMs) return { skipped: 'cooldown', lastAskAt }
     if (!force && inQuietWindow(Date.now(), cfg.nudge.quietStart, cfg.nudge.quietEnd)) return { skipped: 'quiet-hours' }
-    const candidates = Object.entries(state.users || {}).filter(([, user]) => user?.sessionId)
+    const candidates = Object.entries(state.users || {}).filter(([userId, user]) => user?.sessionId && isAllowed(userId, cfg))
     const targetIds = safeArray(cfg.balance?.targetUserIds).length ? safeArray(cfg.balance?.targetUserIds) : safeArray(cfg.nudge?.targetUserIds)
     const preferred = targetIds.find((id) => candidates.some(([key]) => key === id))
     const picked = preferred ? candidates.find(([key]) => key === preferred) : [...candidates].sort((a, b) => (a[1].lastAt || 0) - (b[1].lastAt || 0))[0]
@@ -447,7 +447,7 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
     const state = store.getState()
     const targets = userId
       ? [[userId, state.users?.[userId]]]
-      : Object.entries(state.users || {})
+      : Object.entries(state.users || {}).filter(([id]) => isAllowed(id, cfg))
     const reviewed = []
     for (const [id, user] of targets) {
       if (!user?.sessionId) continue
@@ -992,9 +992,77 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
     })
   }
 
-  function isAllowed(userId, cfg) {
+  function isAllowed(userId, cfg = store.get()) {
     const list = cfg.line.allowedUserIds || []
-    return list.length === 0 || list.includes(userId)
+    return list.length > 0 && list.includes(userId)
+  }
+
+  function pendingUsersList() {
+    return Object.values(store.getState().pendingUsers || {}).sort((a, b) => (Number(b.at) || 0) - (Number(a.at) || 0))
+  }
+
+  function queuePendingUser(userId, patch = {}) {
+    const existing = store.getState().pendingUsers?.[userId]
+    if (existing) {
+      if (patch.displayName || patch.lastText) {
+        store.updateState((state) => ({
+          ...state,
+          pendingUsers: {
+            ...(state.pendingUsers || {}),
+            [userId]: { ...existing, displayName: patch.displayName || existing.displayName || '', lastText: patch.lastText || existing.lastText || '' },
+          },
+        }))
+      }
+      return existing
+    }
+    const entry = { userId, displayName: patch.displayName || '', lastText: patch.lastText || '', at: Date.now() }
+    store.updateState((state) => ({ ...state, pendingUsers: { ...(state.pendingUsers || {}), [userId]: entry } }))
+    logger.warn(`待審核使用者 ${userId}${entry.displayName ? `（${entry.displayName}）` : ''}`)
+    return entry
+  }
+
+  function removePendingUser(userId) {
+    store.updateState((state) => {
+      if (!state.pendingUsers?.[userId]) return state
+      const next = { ...state.pendingUsers }
+      delete next[userId]
+      return { ...state, pendingUsers: next }
+    })
+  }
+
+  async function requireAccess(userId, { replyToken = '', sourceKind = 'user', text = '' } = {}) {
+    const cfg = store.get()
+    if (isAllowed(userId, cfg)) return true
+    const mode = cfg.line.accessMode || 'approval'
+    const allowed = cfg.line.allowedUserIds || []
+    logger.warn(`拒絕未授權使用者 ${userId}（accessMode=${mode}，白名單 ${allowed.length} 人）`)
+    if (mode !== 'approval') return false
+    const first = !store.getState().pendingUsers?.[userId]
+    const displayName = await ensurePerson(userId).catch(() => '')
+    queuePendingUser(userId, { displayName: displayName || personName(userId), lastText: clip(text || '', 160) })
+    if (first && sourceKind === 'user') {
+      await replyOrPush(userId, replyToken, '已送出使用申請；等主人核准後就能聊天。').catch((error) => logger.warn(`待審核通知失敗：${errorText(error)}`))
+    }
+    return false
+  }
+
+  function approveUser(userId) {
+    const id = String(userId || '').trim()
+    if (!id) throw new Error('缺少 userId')
+    const list = safeArray(store.get().line.allowedUserIds)
+    if (!list.includes(id)) store.patch({ line: { allowedUserIds: [...list, id] } })
+    removePendingUser(id)
+    logger.info(`已核准使用者 ${id}`)
+    sendPush(id, '主人核准了，現在可以正常聊天了。').catch((error) => logger.warn(`通知核准失敗：${errorText(error)}`))
+    return { userId: id, allowed: true, allowedUserIds: store.get().line.allowedUserIds }
+  }
+
+  function denyUser(userId) {
+    const id = String(userId || '').trim()
+    if (!id) throw new Error('缺少 userId')
+    removePendingUser(id)
+    logger.info(`已拒絕使用者 ${id}`)
+    return { userId: id, denied: true }
   }
 
   // ── LINE 端的「人設」指令（只改自己的） ────────────────────────────────
@@ -1458,7 +1526,7 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
     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
+      if (!(await requireAccess(userId, { replyToken: event.replyToken, sourceKind: 'user' }))) return
       const welcome = cfg.line.welcomeText || ''
       if (welcome && event.replyToken) {
         await replyOrPush(userId, event.replyToken, welcome).catch((error) => logger.warn(`歡迎訊息失敗：${errorText(error)}`))
@@ -1467,11 +1535,8 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
     }
     if (type !== 'message') return
     if (!userId || !chatId) return
-    if (!isAllowed(userId, cfg)) {
-      logger.warn(`略過未授權的使用者 ${userId}（allowedUserIds）`)
-      return
-    }
     const messageType = event.message?.type
+    if (!(await requireAccess(userId, { replyToken: event.replyToken, sourceKind, text: messageType === 'text' ? String(event.message?.text || '') : '' }))) return
     const messageImages = []
     let text = ''
     if (messageType === 'text') {
@@ -1793,9 +1858,11 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
 
   async function sendPush(userId, text) {
     const { messages } = await buildOutgoingMessages(text)
-    if (messages.length === 0) return
+    if (messages.length === 0) return { sent: false, reason: 'empty' }
     const imageCount = messages.filter((item) => typeof item !== 'string' && item.type === 'image').length
     if (imageCount > 0) logger.info(`主動訊息含 ${imageCount} 張圖片`)
+    const response = await withToken((token) => lineApi.pushMessage(token, userId, messages))
+    logger.info(`主動訊息已送出（${messages.length} 則，LINE 回報 ${Array.isArray(response?.sentMessages) ? response.sentMessages.length : '未知'} 則）`)
     store.updateState((state) => ({
       ...state,
       users: {
@@ -1803,6 +1870,7 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
         [userId]: { ...(state.users[userId] || {}), lastAt: Date.now(), lastPushAt: Date.now() },
       },
     }))
+    return { sent: true, count: messages.length, requestId: response?.requestId || '' }
   }
 
   const nudge = createNudgeScheduler({
@@ -2225,6 +2293,12 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
         entries: jokes.list().slice(0, 200),
       },
       sync: { ...tiebaSync.stats(), config: cfg.sync },
+      access: {
+        mode: cfg.line.accessMode || 'approval',
+        allowedUserIds: safeArray(cfg.line.allowedUserIds),
+        gateOpen: safeArray(cfg.line.allowedUserIds).length > 0,
+        pending: pendingUsersList().map((item) => ({ userId: item.userId, displayName: item.displayName || '', at: Number(item.at) || 0, lastText: item.lastText || '' })),
+      },
       users,
       groups,
       logs: logger.lines(),
@@ -2605,6 +2679,32 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
         const user = ensureUser(userId)
         return { userId, sessionId: user.sessionId, personaId: user.personaId || store.get().persona.id, workspaceDir: user.workspaceDir || '', perUserWorkspace: Boolean(store.get().agent.perUserWorkspace) }
       }
+      case 'access-list':
+        return { mode: store.get().line.accessMode || 'approval', allowedUserIds: safeArray(store.get().line.allowedUserIds), pending: pendingUsersList() }
+      case 'access-mode': {
+        const mode = String(payload.mode || '').trim()
+        if (!['approval', 'whitelist'].includes(mode)) throw new Error('mode 只能是 approval 或 whitelist')
+        store.patch({ line: { accessMode: mode } })
+        return { mode }
+      }
+      case 'access-approve':
+        return approveUser(payload.userId)
+      case 'access-deny':
+        return denyUser(payload.userId)
+      case 'access-add': {
+        const id = String(payload.userId || '').trim()
+        if (!id) throw new Error('缺少 userId')
+        const list = safeArray(store.get().line.allowedUserIds)
+        if (!list.includes(id)) store.patch({ line: { allowedUserIds: [...list, id] } })
+        removePendingUser(id)
+        return { userId: id, allowedUserIds: store.get().line.allowedUserIds }
+      }
+      case 'access-remove': {
+        const id = String(payload.userId || '').trim()
+        const list = safeArray(store.get().line.allowedUserIds).filter((item) => item !== id)
+        store.patch({ line: { allowedUserIds: list } })
+        return { userId: id, allowedUserIds: list }
+      }
       case 'user-persona': {
         const userId = String(payload.userId || '')
         if (!userId) throw new Error('缺少 userId')

package/lib/nudge.mjs

@@ -71,11 +71,13 @@ export function createNudgeScheduler({ getConfig, store, logger, runTurn, sendPr
   function pickUser(cfg, { force }) {
     const state = store.getState()
     const now = Date.now()
+    const allowed = cfg.line?.allowedUserIds || []
     const targets = cfg.nudge.targetUserIds.length
       ? cfg.nudge.targetUserIds
       : Object.keys(state.users || {})
     const candidate = []
     for (const userId of targets) {
+      if (!allowed.length || !allowed.includes(userId)) continue
       const user = state.users?.[userId]
       if (!user?.sessionId) continue
       const last = Number(user.lastAt) || 0

package/package.json

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