dsh-line-bot 0.9.1 → 0.9.3

package/AGENTS.md

@@ -8,7 +8,7 @@
 node bin/cli.mjs doctor --json      # 或 npx dsh-line-bot doctor --json
 ```
 
-- 伺服器在跑時，doctor 會打本機 `http://127.0.0.1:8791/doctor`，檢查：伺服器、Cloudflare Tunnel、公開網址健康、LINE webhook、dsh-meme 圖庫、表情包設定、轉圖工具、模型、圖片可送達測試、最近錯誤。
+- 伺服器在跑時，doctor 會打本機 `http://127.0.0.1:8791/doctor`，檢查：伺服器、Cloudflare Tunnel、公開網址健康、LINE webhook、dsh-meme 圖庫、表情包設定、轉圖工具、模型、modlens 看圖能力、圖片可送達測試、最近錯誤。
 - 伺服器沒跑時會退成離線檢查（設定檔、憑證、dsh-meme、轉圖工具、日誌）。
 - `--fix` 會做安全修復：重啟 tunnel、重設 webhook、重新讀 bot 資訊；不會改設定、不會刪資料。
 
@@ -23,10 +23,10 @@ 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.8.x） |
-| 貼圖看不懂 | `model` | 目前模型不吃圖（`inputModalities` 沒有 image） | 面板「模型與接口來源」換成有 `text+image` 的模型 |
+| 回覆出現 `[[meme:…]]`、`<meme#18>` 文字 | 版本 | 舊版不認得標記格式 | 升級到 0.6.1+（目前 0.9.x） |
+| 貼圖／圖片看不懂 | `model`、`vision` | 模型不吃圖，或 modlens 不可用／失敗 | 面板「模型與接口來源」換成有 `text+image` 的模型；或安裝 modlens 並設定 provider |
 | 群組不回 | 面板「群組」 | 沒被 @／引用、擲骰沒中、群組功能關閉 | 看面板回覆機率與開關 |
 | 主動訊息沒出現 | 面板「主動傳訊」 | 機率、每日／每月上限、靜音時段、冷卻、沒有 session 的使用者 | 看 `status.nudge` 與日誌 |
 | 餘額提醒沒出現 | `balance` | provider 不是 `deepseek-account`、餘額高於門檻、冷卻中、靜音 | 面板「DeepSeek 餘額」看 `applicable`、`lastAskAt` |

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.9.3
+
+- 身分門控改為預設關閉：白名單為空時，任何人都不能觸發 Agent；未授權的 LINE 使用者只會進入「待審核」佇列，不會建立 session、不會呼叫工具。
+- 面板「使用者」新增待審核名單，可核准或拒絕；核准後才加入白名單並通知對方。LINE 憑證卡可切換 `approval`（待審核）／`whitelist`（直接忽略）兩種模式。
+- 主動傳訊、餘額提醒與記憶整理只會挑選白名單內的使用者。
+- 文件補上「第一次使用要先核准自己」與隱私說明；更新 awesome-dsh-plugin 條目描述（需要 Messaging API 頻道、只有白名單使用者能對話）。
+
+## 0.9.2
+
+- LINE 一般圖片：收到 `image` 訊息時透過 LINE content API 下載，模型支援圖片就直接附圖；不支援時改用 modlens 或另一個視覺模型描述。
+- 貼圖：模型不吃圖時，先用 modlens 看圖，失敗再改用支援圖片的模型描述，最後才退回貼圖關鍵字。
+- 面板「LINE 憑證」新增「看得懂一般圖片」開關與目前看圖方式說明。
+- 診斷（doctor）新增「看圖能力（modlens）」檢查。
+
 ## 0.9.1
 - 貼吧學習同步的目標下拉現在也包含「插件自訂人設」（`local:`）；選自訂人設時會寫入 `<DSH_HOME>/line-bot/persona-overlays/<id>.md` 覆蓋層，每輪注入。
 - 讀不到大肥魚 HTTP bridge 時，改成直接讀取 `<DSH_HOME>/storages/dsh-persona-dafeiyu/personas.json` 並列出內建人設，不再讓同步目標變空。

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
 
@@ -98,10 +98,10 @@ At the top of the panel is a **sticky save bar**: "Save changes / Refresh" stays
 | Jokes | Text joke library: built-in seeds, Tieba quotes, wanjiqi barrage memes; per-source toggles, per-turn injection count, add/delete entries |
 | Personal memory | Per-user long-term memory, expiry cleanup, daily self-review, manual delete |
 | Memes | Reply with images/stickers from the dsh-meme library, enable/disable, image limit, and sample previews |
-| Sticker vision | Fetch incoming LINE stickers and show them to the model (can be disabled) |
+| 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) |
 
@@ -220,7 +220,8 @@ The persona can attach a sticker to a text reply, or reply with just an image. I
 - Each turn injects a numbered sample of the library into context; when the persona wants a picture, it appends `[[meme:#N]]` (or a caption) at the end of its reply, and the plugin turns that into a LINE image message.
 - Images are served to LINE through the current Cloudflare public URL (`<url>/media/<token>`), and the URL follows quick-tunnel restarts automatically.
 - The panel's "Memes" card can disable the feature, limit images per reply (1–3), and preview library samples. To add or re-tag images, use dsh-meme's own settings.
-- When a LINE sticker arrives, the bot fetches the sticker image and shows it to the model (vision-capable models read the image; otherwise the bot falls back to the keywords LINE provides), so the persona can react to the mood. Turn "Understand stickers" off in the LINE credentials card to use keywords only.
+- When a LINE sticker arrives, the bot fetches the image and shows it to the model; vision-capable models read it directly, otherwise the bot asks modlens, then tries another vision model, and only then falls back to the keywords LINE provides. Turn "Understand stickers" off in the LINE credentials card to use keywords only.
+- Regular images work the same way: the bot downloads them through LINE's content API and attaches them to the message; if the model cannot read images, the same modlens / vision-model description path is used. Turn "Understand images" off in the LINE credentials card to skip them.
 - Without dsh-meme installed, the feature stays off and replies are text only.
 ## Diagnostics
 - Panel → Advanced → Run diagnostics checks the server, tunnel, public URL, webhook, dsh-meme library, image converters, model, and recent errors; Safe repair only reconnects the tunnel and re-applies the webhook.
@@ -247,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 を承認してください（許可リストは初期状態では空です）。
 
 ## パネルの各セクション
 
@@ -98,7 +98,7 @@ npx dsh-line-bot install --no-companions
 | ジョーク | テキストネタ集：内蔵シード、貼吧名台詞、wanjiqi 弾幕ネタ。ソース別の切り替え、ターンごとの注入数、追加／削除 |
 | 個人メモリ | ユーザーごとの長期記憶、期限切れの自動削除、毎日の自己整理、手動削除 |
 | 表情パック | dsh-meme の画像ライブラリで画像／スタンプを返信、オンオフ、1 回の上限、サンプル表示 |
-| スタンプ理解 | LINE スタンプを受信したら画像を取得してモデルに見せる（オフ可） |
+| スタンプ・画像理解 | LINE スタンプや通常の画像を受信したら取得してモデルに見せる。画像非対応モデルは modlens や別の視覚モデルで説明（オフ可） |
 | DeepSeek 残高 | 現在の残高、毎ターンの注入、残高が少ないときの主動リマインド、しきい値とクールダウン（deepseek-account のみ） |
 | 自発メッセージ | オン／オフ、確率、間隔、1 日／1 か月の上限、最短間隔、静かな時間帯、idle、対象ユーザー、プロンプト、今すぐ試送、統計 |
 | ユーザー | LINE ユーザーごとに対応する DSH セッション、専用ワークスペース、現在のペルソナ（直接変更可）、メッセージ数、最終やりとり、メモリ消去／セッション再作成 |
@@ -220,7 +220,8 @@ Bot がグループ（または複数人のルーム）に追加されたとき
 - 毎ターン、ライブラリのサンプル（番号＋説明）を context に注入します。画像を添えたいときは返信の最後に `[[meme:#番号]]`（または説明）を付けます。プラグインが LINE の image message に変換します。
 - 画像は現在の Cloudflare 公開 URL（`<URL>/media/<token>`）経由で LINE に渡されます。quick tunnel の再起動で URL が変わっても自動で追従します。
 - パネルの「表情パック」カードでオンオフ、1 回あたりの上限（1〜3）、ライブラリのサンプル表示ができます。画像の追加や分類の変更は dsh-meme 側の設定で行います。
-- LINE スタンプを受信すると、スタンプ画像を取得してモデルに見せます（画像対応モデルはそのまま読み、非対応なら LINE のキーワードを使います）。「LINE 認証情報」カードの「スタンプを理解する」でオフにできます。
+- LINE スタンプを受信すると、スタンプ画像を取得してモデルに見せます。画像対応モデルはそのまま読み、非対応ならまず modlens、次に別の視覚モデルで説明し、最後に LINE のキーワードを使います。「LINE 認証情報」カードの「スタンプを理解する」でオフにできます。
+- 通常の画像も同じです。LINE content API でダウンロードしてモデルに添付し、画像非対応なら同じ modlens／視覚モデルの説明経路を使います。「LINE 認証情報」カードの「画像を理解する」でオフにできます。
 - dsh-meme がインストールされていない場合、この機能は無効になりテキストのみ返します。
 ## 診断
 - パネルの「詳細設定 → 診断を実行」でサーバー、Tunnel、公開 URL、webhook、dsh-meme 図庫、画像変換ツール、モデル、最近のエラーを確認できます。「安全な修復」は tunnel 再接続と webhook 再設定だけを行います。
@@ -247,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를 승인해야 응답합니다(허용 목록은 기본적으로 비어 있습니다).
 
 ## 패널 구성
 
@@ -98,7 +98,7 @@ npx dsh-line-bot install --no-companions
 | 말장난 | 텍스트 밈: 내장 시드, 貼吧 명언, wanjiqi 탄막 밈. 출처별 켜기/끄기, 턴당 주입 수, 추가/삭제 |
 | 개인 기억 | 사용자별 장기 기억, 만료 자동 삭제, 매일 자기 정리, 수동 삭제 |
 | 이모티콘 | dsh-meme 라이브러리로 이미지/스티커 답장, 켜기/끄기, 1회 최대 장수, 샘플 미리보기 |
-| 스티커 이해 | LINE 스티커를 받으면 이미지를 가져와 모델에 보여 줌 (끌 수 있음) |
+| 스티커·이미지 이해 | LINE 스티커나 일반 이미지를 받으면 가져와 모델에 보여 줌. 이미지 미지원 모델은 modlens 또는 다른 비전 모델로 설명 (끌 수 있음) |
 | DeepSeek 잔액 | 현재 잔액, 매 턴 주입, 잔액이 적을 때 캐릭터가 먼저 알림, 기준 금액과 쿨다운(deepseek-account 전용) |
 | 능동 메시지 | 켜기/끄기, 확률, 간격, 일일/월간 상한, 최소 간격, 조용한 시간대, idle, 대상 사용자, 프롬프트, 지금 시험 발송, 통계 |
 | 사용자 | LINE 사용자별 DSH 세션, 전용 작업 폴더, 현재 페르소나(직접 변경 가능), 메시지 수, 마지막 상호작용, 기억 지우기／세션 재설정 |
@@ -218,7 +218,8 @@ Bot이 그룹(또는 다인 룸)에 추가되면:
 - 이미지는 현재 Cloudflare 공개 URL(`<URL>/media/<token>`)을 통해 LINE에 전달됩니다. 보낸 이미지는 `<DSH_HOME>/line-bot/media/`에 90일간 보관되므로 나중에 채팅을 열어도 LINE이 가져갈 수 있습니다.
 - quick tunnel은 재시작하면 URL이 바뀌므로 이전 메시지의 이미지는 표시되지 않습니다. 영구 URL이 필요하면 API Token named tunnel과 사용자 도메인을 사용하세요.
 - 패널의 「이모티콘」 카드에서 켜고 끄기, 답장당 최대 장수(1~3), 라이브러리 샘플 미리보기를 할 수 있습니다. 이미지 추가나 분류 변경은 dsh-meme 설정에서 하세요.
-- LINE 스티커를 받으면 스티커 이미지를 가져와 모델에 보여 줍니다(이미지 지원 모델은 바로 읽고, 아니면 LINE 키워드로 대체). 「LINE 자격 증명」 카드에서 「스티커 이해」를 끌 수 있습니다.
+- LINE 스티커를 받으면 스티커 이미지를 가져와 모델에 보여 줍니다. 이미지 지원 모델은 바로 읽고, 아니면 먼저 modlens, 다음으로 다른 비전 모델로 설명하고, 마지막에 LINE 키워드로 대체합니다. 「LINE 자격 증명」 카드에서 「스티커 이해」를 끌 수 있습니다.
+- 일반 이미지도 같습니다. LINE content API로 내려받아 모델에 첨부하고, 이미지 미지원이면 같은 modlens／비전 모델 설명 경로를 씁니다. 「LINE 자격 증명」 카드에서 「이미지 이해」를 끌 수 있습니다.
 - dsh-meme이 설치되어 있지 않으면 이 기능은 꺼지고 텍스트만 답장합니다.
 ## 진단
 - 패널의 "고급 설정 → 진단 실행"에서 서버, Tunnel, 공개 URL, webhook, dsh-meme 라이브러리, 이미지 변환 도구, 모델, 최근 오류를 확인할 수 있습니다. "안전 복구"는 tunnel 재연결과 webhook 재설정만 수행합니다.
@@ -245,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 好友、傳訊息；第一次訊息會進入「待審核」，到面板「使用者」按「核准」後才會開始回覆（白名單預設是空的）。
 
 ## 面板各區
 
@@ -98,10 +98,10 @@ npx dsh-line-bot install --no-companions
 | 玩梗 | 文字梗庫：內建種子、貼吧金句、wanjiqi 彈幕梗；三個來源可個別開關、每輪注入幾則、新增／刪除梗 |
 | 個人記憶 | 每位使用者分開的長期記憶、到期自動刪、每日請角色整理、手動刪除 |
 | 表情包 | 使用 dsh-meme 圖庫回圖片／貼圖、開關、一次最多幾張、圖庫樣本 |
-| 貼圖理解 | 收到 LINE 貼圖時抓圖給模型看（可關閉） |
+| 貼圖與圖片理解 | 收到 LINE 貼圖或一般圖片時抓圖給模型看；模型不吃圖時用 modlens 或另一個視覺模型描述（可關閉） |
 | DeepSeek 餘額 | 目前餘額、每輪注入、低於門檻時由角色主動提醒、提醒門檻與冷卻（僅 deepseek-account） |
 | 主動傳訊 | 開關、機率、間隔、每日／每月上限、最短間隔、安靜時段、idle、指定對象、提示詞、立即試傳、統計 |
-| 使用者 | 每位 LINE 使用者對應的 DSH session、專屬工作資料夾、目前人設（可直接改）、訊息數、上次互動、清空記憶／重設 session |
+| 使用者 | 待審核名單（核准／拒絕）、每位 LINE 使用者對應的 DSH session、專屬工作資料夾、目前人設（可直接改）、訊息數、上次互動、清空記憶／重設 session |
 | 群組 | 每個群組的 session、工作資料夾、人設、訊息數；沒被點名時的回覆機率；被 @／引用一定回；清空群組記憶 |
 | 進階設定 | 連接埠、Agent provider/model/effort/cwd/逾時、一人一個工作資料夾（含根目錄）、歡迎／錯誤／空回覆、日誌、開發用 host 重新載入 |
 
@@ -220,7 +220,8 @@ Bot 被加進群組（或多人聊天室）後：
 - 每輪會把圖庫樣本（編號＋描述）帶進 context；角色想配圖時在回覆最後加 `[[meme:#編號]]`（或描述），插件再組成 LINE 的 image message。
 - 圖片透過目前的 Cloudflare 公開網址（`<網址>/media/<token>`）提供給 LINE；quick tunnel 換網址後會自動跟上。
 - 面板「表情包」卡可以開關、限制一次最多幾張（1～3），並預覽圖庫樣本。要新增圖片或改分類，請用 dsh-meme 自己的設定。
-- 收到 LINE 貼圖時，會抓貼圖圖片交給模型看（支援圖片的模型直接讀圖，否則用 LINE 提供的關鍵字），角色才接得住貼圖的情緒。可在「LINE 憑證」卡關閉「看得懂貼圖」。
+- 收到 LINE 貼圖時，會抓貼圖圖片交給模型看；模型支援圖片就直接讀，否則先用 modlens 描述，再不支援就改用另一個視覺模型，最後才退回 LINE 提供的關鍵字。可在「LINE 憑證」卡關閉「看得懂貼圖」。
+- 一般圖片也一樣：透過 LINE content API 下載後直接附給模型；模型不吃圖時走同一套 modlens／視覺模型描述。可在「LINE 憑證」卡關閉「看得懂一般圖片」。
 - 沒安裝 dsh-meme 時這個功能會自動停用，只回文字。
 ## 診斷與修復
 - 面板「進階設定 → 執行診斷」會檢查伺服器、Tunnel、公開網址、webhook、表情包圖庫、轉圖工具、模型與最近錯誤；「自動修復（安全）」只會重連 tunnel、重設 webhook。
@@ -247,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 好友、传消息；第一条消息会进入「待审核」，到面板「使用者」按「核准」后才会开始回复（白名单默认为空）。
 
 ## 面板各区
 
@@ -98,7 +98,7 @@ npx dsh-line-bot install --no-companions
 | 玩梗 | 文字梗库：内置种子、贴吧金句、wanjiqi 弹幕梗；三个来源可分别开关、每轮注入几条、新增／删除梗 |
 | 个人记忆 | 每位用户分开的长期记忆、到期自动删除、每日请角色整理、手动删除 |
 | 表情包 | 使用 dsh-meme 图库回图片/贴图、开关、每次最多几张、图库样本 |
-| 贴图理解 | 收到 LINE 贴图时抓图给模型看（可关闭） |
+| 贴图与图片理解 | 收到 LINE 贴图或一般图片时抓图给模型看；模型不吃图时用 modlens 或另一个视觉模型描述（可关闭） |
 | DeepSeek 余额 | 当前余额、每轮注入、低于门槛时由角色主动提醒、提醒门槛与冷却（仅 deepseek-account） |
 | 主动传讯 | 开关、概率、间隔、每日／每月上限、最短间隔、安静时段、idle、指定对象、提示词、立即试传、统计 |
 | 用户 | 每位 LINE 用户对应的 DSH session、专属工作文件夹、目前人设（可直接改）、消息数、上次互动、清空记忆／重设 session |
@@ -220,7 +220,8 @@ Bot 被加入群组（或多人聊天室）后：
 - 每轮会把图库样本（编号＋描述）带进 context；角色想配图时在回复最后加 `[[meme:#编号]]`（或描述），插件再组成 LINE 的 image message。
 - 图片通过当前的 Cloudflare 公开网址（`<网址>/media/<token>`）提供给 LINE；quick tunnel 换网址后会自动跟上。
 - 面板「表情包」卡可以开关、限制每次最多几张（1～3），并预览图库样本。要新增图片或改分类，请用 dsh-meme 自己的设置。
-- 收到 LINE 贴图时，会抓贴图图片交给模型看（支持图片的模型直接读图，否则用 LINE 提供的关键词），角色才能接住贴图的情绪。可在「LINE 凭证」卡关闭「看得懂贴图」。
+- 收到 LINE 贴图时，会抓贴图图片交给模型看；模型支持图片就直接读，否则先用 modlens 描述，再不支持就改用另一个视觉模型，最后才退回 LINE 提供的关键词。可在「LINE 凭证」卡关闭「看得懂贴图」。
+- 一般图片也一样：通过 LINE content API 下载后直接附给模型；模型不吃图时走同一套 modlens／视觉模型描述。可在「LINE 凭证」卡关闭「看得懂一般图片」。
 - 没安装 dsh-meme 时该功能会自动停用，只回文字。
 ## 诊断与修复
 - 面板「高级设置 → 执行诊断」会检查服务器、Tunnel、公开网址、webhook、表情包图库、转图工具、模型与最近错误；「自动修复（安全）」只会重连 tunnel、重设 webhook。
@@ -247,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/TROUBLESHOOTING.md

@@ -25,11 +25,12 @@ npx dsh-line-bot doctor --fix   # 安全修復：重連 tunnel、重設 webhook
 - 用面板「測試 Agent 回覆」或 `meme-preview` 確認模型有輸出標記。
 
 ### 回覆裡出現 `[[meme:…]]` 或 `<meme#18>`
-- 舊版不認得標記格式；升級到 0.6.1 以上（目前 0.8.x）。
+- 舊版不認得標記格式；升級到 0.6.1 以上（目前 0.9.x）。
 
-### 貼圖看不懂
-- 需要模型支援圖片（`inputModalities` 含 `image`）。面板「模型與接口來源」可換模型。
-- 模型不支援時仍會用貼圖關鍵字，不會壞掉。
+### 貼圖／圖片看不懂
+- 模型支援圖片（`inputModalities` 含 `image`）時會直接看圖；面板「模型與接口來源」可換模型。
+- 模型不支援時，插件會先用 modlens 描述，再改用另一個視覺模型，最後才退回貼圖關鍵字。
+- modlens 可在「進階 → 診斷」看 `vision` check；失敗通常是 provider 額度或 503。一般圖片可在面板「LINE 憑證」關閉「看得懂一般圖片」。
 
 ### APNG 不會動
 - LINE 不播放 APNG，只顯示第一幀。保持 `stickers.apng=false` 即可。

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 || {}
@@ -968,7 +975,9 @@ window.__ModuleLoader__.load({
           ),
           h(Toggle, { checked: line.useAutoToken !== false, onChange: (value) => update({ line: { useAutoToken: value } }), label: '自動簽發 access token', hint: '有 Channel ID＋Secret 時，優先自動取得（建議開啟）' }),
           h(Toggle, { checked: line.loadingEnabled !== false, onChange: (value) => update({ line: { loadingEnabled: value } }), label: '顯示「正在輸入」動畫', hint: '回覆前呼叫 LINE 的 loading 動畫' }),
-          h(Toggle, { checked: line.stickerVision !== false, onChange: (value) => update({ line: { stickerVision: value } }), label: '看得懂貼圖', hint: '收到貼圖時抓圖片給模型看；模型不支援圖片時仍會用貼圖關鍵字' }),
+          h(Toggle, { checked: line.stickerVision !== false, onChange: (value) => update({ line: { stickerVision: value } }), label: '看得懂貼圖', hint: '收到貼圖時抓圖片給模型看；模型不支援圖片時改用 modlens 描述，再不支援才用關鍵字' }),
+          h(Toggle, { checked: line.imageVision !== false, onChange: (value) => update({ line: { imageVision: value } }), label: '看得懂一般圖片', hint: '收到圖片時下載給模型看；模型不支援圖片時用 modlens 產生描述' }),
+          h('div', { style: S.note }, `看圖方式：${runtime.vision?.modelSupportsImages ? '目前模型可直接看圖' : runtime.vision?.available ? '目前模型不吃圖，改用 modlens 描述' : '目前模型不吃圖，且找不到 modlens'}${runtime.vision?.lastError ? `（modlens 最近錯誤：${runtime.vision.lastError}）` : ''}`),
           h('div', { style: S.row },
             h(Btn, { onClick: () => act('line-verify'), disabled: !!busy, tone: 'primary' }, busy === 'line-verify' ? '驗證中…' : '驗證並讀取 bot 資訊'),
             h(Btn, { onClick: () => act('token-refresh'), disabled: !!busy }, '重新簽發 token'),
@@ -989,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
@@ -1287,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

@@ -26,6 +26,8 @@ export const DEFAULT_CONFIG = {
     useAutoToken: true,
     loadingEnabled: true,
     stickerVision: true,
+    imageVision: true,
+    accessMode: 'approval', // approval | whitelist
     allowedUserIds: [],
     welcomeText: '（已加好友）嗨，我是大肥魚～想聊什麼都可以跟我說。',
     errorReply: '（剛剛卡住了，再說一次好嗎？）',
@@ -193,9 +195,11 @@ 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)
   next.line.welcomeText = String(next.line.welcomeText ?? '').slice(0, 1000)
   next.line.errorReply = String(next.line.errorReply ?? '').slice(0, 500)
   next.line.emptyReply = String(next.line.emptyReply ?? '').slice(0, 500)
@@ -347,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

@@ -27,6 +27,7 @@ const jokesMod = await import(withVersion('./jokes.mjs'))
 const stickersMod = await import(withVersion('./stickers.mjs'))
 const memeSourceMod = await import(withVersion('./meme-source.mjs'))
 const stickerImageMod = await import(withVersion('./sticker-image.mjs'))
+const visionMod = await import(withVersion('./vision.mjs'))
 const utilMod = await import(withVersion('./util.mjs'))
 const { createConfigStore, publicConfig, dataDir, dshHome } = configMod
 const { createPersonaClient } = personaMod
@@ -43,9 +44,10 @@ const { createJokeStore } = jokesMod
 const { createStickerStore } = stickersMod
 const { createMemeSource } = memeSourceMod
 const { createStickerImages } = stickerImageMod
+const { createVision } = visionMod
 const { chunkText, clip, inQuietWindow, jsonFail, jsonOk, maskSecret, readJsonBody, safeArray, sleep, readJsonSafe } = utilMod
 
-export const VERSION = '0.9.1'
+export const VERSION = '0.9.3'
 
 // 環境變數提供的 Cloudflare API Token（方便用 shell 注入、不用把 token 寫進設定檔）。
 // 設定檔裡的 token 優先；兩者都沒有時才用環境變數。
@@ -362,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]
@@ -445,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
@@ -990,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 端的「人設」指令（只改自己的） ────────────────────────────────
@@ -1456,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)}`))
@@ -1465,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') {
@@ -1478,25 +1545,90 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
       const keywords = Array.isArray(event.message.keywords)
         ? event.message.keywords.filter(Boolean).slice(0, 8).join('、')
         : ''
+      const supportsImages = await modelSupportsImages()
       let hasImage = false
+      let described = ''
       if (cfg.line?.stickerVision !== false) {
         try {
-          const ref = await stickerImages.toAttachment(event.message.stickerId, event.message.stickerResourceType)
-          if (ref) {
-            messageImages.push(ref)
-            hasImage = true
+          if (supportsImages) {
+            const ref = await stickerImages.toAttachment(event.message.stickerId, event.message.stickerResourceType)
+            if (ref) {
+              messageImages.push(ref)
+              hasImage = true
+            }
+          } else {
+            let description = ''
+            const { data } = await stickerImages.fetchBytes(event.message.stickerId, event.message.stickerResourceType)
+            const file = writeIncomingImage(Buffer.from(data), `sticker-${event.message.stickerId}-${Date.now()}.png`)
+            if (vision.available()) {
+              try {
+                description = await describeImageFile(file, '這是一張 LINE 貼圖，請用繁體中文簡短描述圖案與情緒。')
+              } catch (error) {
+                logger.warn(`modlens 看貼圖失敗，改用視覺模型：${errorText(error)}`)
+              }
+            }
+            if (!description) {
+              try {
+                const ref = await stickerImages.saveBuffer(Buffer.from(data), `line-sticker-${event.message.stickerId}.png`, 'image/png')
+                description = await describeWithVisionModel(ref)
+              } catch (error) {
+                logger.warn(`視覺模型看貼圖失敗：${errorText(error)}`)
+              }
+            }
+            described = description
           }
         } catch (error) {
-          logger.warn(`取得貼圖圖片失敗，只用關鍵字：${errorText(error)}`)
+          logger.warn(`取得貼圖圖片或看圖失敗，只用關鍵字：${errorText(error)}`)
         }
       }
       text = [
         `（使用者沒有打字，傳了一個 LINE 貼圖：packageId=${event.message.packageId ?? '?'}, stickerId=${event.message.stickerId ?? '?'}`,
         keywords ? `，貼圖關鍵字：${keywords}` : '',
-        hasImage ? '，貼圖圖片已附在這一則訊息裡（請直接看圖）' : '',
+        hasImage ? '，貼圖圖片已附在這一則訊息裡（請直接看圖）' : described ? `，貼圖內容描述：${described}` : '',
         '。請用你自己的語氣，一兩句自然回應這個貼圖；不要說「你傳了貼圖」這種話，依圖片內容或關鍵字猜情緒，不確定就輕鬆帶過。）',
       ].join('')
-      logger.info(`收到貼圖（packageId=${event.message.packageId ?? '?'}, stickerId=${event.message.stickerId ?? '?'}${keywords ? `，${keywords}` : ''}）`)
+      logger.info(`收到貼圖（packageId=${event.message.packageId ?? '?'}, stickerId=${event.message.stickerId ?? '?'}${keywords ? `，${keywords}` : ''}${hasImage ? '，已附圖' : described ? '，已取得圖片描述' : ''}）`)
+    } else if (messageType === 'image') {
+      if (cfg.line?.imageVision === false) {
+        logger.info('略過圖片（line.imageVision 關閉）')
+        return
+      }
+      try {
+        const messageId = event.message?.id
+        if (!messageId) throw new Error('缺少 messageId')
+        const buffer = await withToken((token) => lineApi.getMessageContent(token, messageId))
+        const mediaType = imageMediaType(buffer)
+        if (await modelSupportsImages()) {
+          const ref = await stickerImages.saveBuffer(buffer, `line-image-${messageId}.${mediaType.split('/')[1]}`, mediaType)
+          messageImages.push(ref)
+          text = '（使用者傳了一張圖片，圖片已附在這一則訊息裡，請直接看圖並用你自己的語氣自然回應；不要說「你傳了圖片」這種話。）'
+        } else {
+          let description = ''
+          if (vision.available()) {
+            try {
+              const file = writeIncomingImage(buffer, `incoming-${messageId}.${mediaType.split('/')[1]}`)
+              description = await describeImageFile(file, '這是一張 LINE 對話中傳來的圖片，請用繁體中文簡潔描述內容與情緒。')
+            } catch (error) {
+              logger.warn(`modlens 看圖片失敗，改用視覺模型：${errorText(error)}`)
+            }
+          }
+          if (!description) {
+            try {
+              const ref = await stickerImages.saveBuffer(buffer, `line-image-${messageId}.${mediaType.split('/')[1]}`, mediaType)
+              description = await describeWithVisionModel(ref)
+            } catch (error) {
+              logger.warn(`視覺模型看圖片失敗：${errorText(error)}`)
+            }
+          }
+          text = description
+            ? `（使用者傳了一張圖片。圖片內容描述：${description}。請依這個描述用你自己的語氣自然回應，不要說「你傳了圖片」這種話。）`
+            : '（使用者傳了一張圖片，但目前模型不支援看圖、modlens 也不可用；請用文字輕輕帶過，不要假裝看到內容。）'
+        }
+        logger.info(`收到圖片（messageId=${messageId}，${buffer.length} bytes）`)
+      } catch (error) {
+        logger.warn(`處理圖片失敗：${errorText(error)}`)
+        text = '（使用者傳了一張圖片，但下載或辨識失敗；請用文字輕輕帶過，不要假裝看到內容。）'
+      }
     } else {
       logger.info(`略過非文字訊息（${messageType}）`)
       return
@@ -1609,7 +1741,98 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
   const stickers = createStickerStore({ dir, logger })
   const memes = createMemeSource({ ctx, logger })
   const stickerImages = createStickerImages({ ctx, logger, dir })
+  const vision = createVision({ logger, cacheDir: path.join(dir, 'cache') })
   const mediaTokens = new Map()
+  let imageSupportCache = { at: 0, key: '', value: false }
+
+  async function modelSupportsImages() {
+    const selection = modelSelection()
+    const key = `${selection.provider}/${selection.model}`
+    if (imageSupportCache.key === key && Date.now() - imageSupportCache.at < 60_000) return imageSupportCache.value
+    let value = false
+    try {
+      const llm = ctx.get?.('llm')
+      if (llm?.resolveModelInfo && selection.provider && selection.model) {
+        const info = await llm.resolveModelInfo(selection.provider, selection.model)
+        value = Array.isArray(info?.inputModalities) && info.inputModalities.includes('image')
+      }
+      if (!value) {
+        const catalog = await modelCatalog({ force: false }).catch(() => null)
+        const provider = catalog?.providers?.find((item) => item.id === selection.provider)
+        const model = provider?.models?.find((item) => item.id === selection.model)
+        value = Array.isArray(model?.inputModalities) && model.inputModalities.includes('image')
+      }
+    } catch (error) {
+      logger.warn(`查模型圖片能力失敗：${errorText(error)}`)
+    }
+    imageSupportCache = { at: Date.now(), key, value }
+    return value
+  }
+
+  function imageMediaType(buffer) {
+    const bytes = Buffer.isBuffer(buffer) ? buffer : Buffer.from(buffer || [])
+    if (bytes.length >= 3 && bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff) return 'image/jpeg'
+    if (bytes.length >= 8 && bytes[0] === 0x89 && bytes[1] === 0x50) return 'image/png'
+    if (bytes.length >= 12 && bytes.toString('ascii', 0, 4) === 'RIFF' && bytes.toString('ascii', 8, 12) === 'WEBP') return 'image/webp'
+    if (bytes.length >= 6 && bytes.toString('ascii', 0, 3) === 'GIF') return 'image/gif'
+    return 'image/png'
+  }
+
+  function writeIncomingImage(buffer, name) {
+    const file = path.join(dir, 'cache', name)
+    fs.mkdirSync(path.dirname(file), { recursive: true })
+    fs.writeFileSync(file, buffer)
+    return file
+  }
+
+  async function describeImageFile(file, prompt) {
+    const described = await vision.describe(file, { prompt })
+    return described.text
+  }
+
+  async function describeWithVisionModel(ref) {
+    const llm = ctx.get?.('llm')
+    if (!llm?.stream || !ref) return ''
+    const catalog = await modelCatalog({ force: false }).catch(() => null)
+    const wanted = [
+      ['cguair', 'gpt-6.1-terra'],
+      ['cguair', 'gpt-6.1-sol'],
+      ['deepseek-account', 'deepseek-flash'],
+      ['deepseek-official', 'deepseek-flash'],
+      ['deepseek-modlens', 'deepseek-v4-pro'],
+    ]
+    const available = []
+    for (const [provider, model] of wanted) {
+      const item = catalog?.providers?.find((entry) => entry.id === provider)?.models?.find((entry) => entry.id === model)
+      if (item && Array.isArray(item.inputModalities) && item.inputModalities.includes('image')) available.push({ provider, model })
+    }
+    for (const entry of available) {
+      try {
+        let text = ''
+        const stream = llm.stream({
+          provider: entry.provider,
+          model: entry.model,
+          maxTokens: 220,
+          messages: [
+            {
+              role: 'user',
+              content: [
+                { type: 'text', text: '請用繁體中文簡短描述這張圖片的內容與情緒，兩句以內，不要客套。' },
+                { type: 'image', attachment: ref },
+              ],
+            },
+          ],
+        })
+        for await (const chunk of stream) {
+          if (chunk?.type === 'text-delta') text += chunk.text || ''
+        }
+        if (text.trim()) return text.trim()
+      } catch (error) {
+        logger.warn(`用 ${entry.provider}/${entry.model} 看圖失敗：${errorText(error)}`)
+      }
+    }
+    return ''
+  }
 
   const server = createWebhookServer({ getConfig: () => store.get(), logger, dispatch: handleEvent, getMedia, getDoctor: (options) => runDiagnostics(options) })
 
@@ -1877,10 +2100,16 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
       const modalities = info?.inputModalities || []
       checks.push(check('model', '回覆模型', 'ok',
         `${selected.provider}/${selected.model}${modalities.length ? `（${modalities.join('+')}）` : ''}`,
-        modalities.includes('image') ? '' : '這個模型不吃圖；貼圖理解會退回關鍵字，但不影響送表情包'))
+        modalities.includes('image') ? '' : '這個模型不吃圖；會改用 modlens 或另一個視覺模型描述圖片，失敗才退回關鍵字'))
     } catch (error) {
       checks.push(check('model', '回覆模型', 'warn', errorText(error), '在面板「模型與接口來源」重新選模型'))
     }
+    {
+      const status = vision.status()
+      checks.push(check('vision', '看圖能力（modlens）', status.available ? 'ok' : 'warn',
+        status.available ? `modlens 可用${status.lastError ? `；最近錯誤：${status.lastError}` : ''}` : '找不到 modlens；模型不吃圖時會退回關鍵字',
+        status.available ? '' : '安裝 @liustack/modlens，或改用支援圖片的模型'))
+    }
     if (memeStats.available && base) {
       try {
         const sample = memes.sample({ limit: 1 })[0]
@@ -2036,6 +2265,12 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
         items: stickers.list(),
         warning: publicBaseSync() ? '' : '尚未取得公開網址（Cloudflare tunnel 未啟動）',
       },
+      vision: {
+        ...vision.status(),
+        modelSupportsImages: await modelSupportsImages(),
+        imageVision: cfg.line?.imageVision !== false,
+        stickerVision: cfg.line?.stickerVision !== false,
+      },
       memory: {
         ...memory.stats(),
         enabled: cfg.memory?.enabled !== false,
@@ -2055,6 +2290,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(),
@@ -2259,6 +2500,47 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
         return maybeAskForTopUp({ dryRun: payload.dryRun !== false, force: payload.force === true })
       case 'meme-stats':
         return { ...memes.stats(), enabled: store.get().stickers?.enabled !== false, maxPerReply: memeMaxPerReply(), sample: memes.sample({ limit: 20 }) }
+      case 'vision-model-look': {
+        const url = String(payload.url || '').trim()
+        if (!url) throw new Error('缺少 url')
+        const response = await fetch(url, { signal: AbortSignal.timeout(20_000) })
+        if (!response.ok) throw new Error(`下載圖片失敗：HTTP ${response.status}`)
+        const buffer = Buffer.from(await response.arrayBuffer())
+        const mediaType = imageMediaType(buffer)
+        const ref = await stickerImages.saveBuffer(buffer, `vision-model-${Date.now()}.${mediaType.split('/')[1]}`, mediaType)
+        return { text: await describeWithVisionModel(ref), attachmentId: String(ref.attachmentId || '') }
+      }
+      case 'image-look': {
+        const url = String(payload.url || '').trim()
+        if (!url) throw new Error('缺少 url')
+        const response = await fetch(url, { signal: AbortSignal.timeout(20_000) })
+        if (!response.ok) throw new Error(`下載圖片失敗：HTTP ${response.status}`)
+        const buffer = Buffer.from(await response.arrayBuffer())
+        if (buffer.length > 10 * 1024 * 1024) throw new Error('圖片超過 10MB')
+        const mediaType = imageMediaType(buffer)
+        const ref = await stickerImages.saveBuffer(buffer, `test-image-${Date.now()}.${mediaType.split('/')[1]}`, mediaType)
+        const result = await runner.turn({
+          sessionId: `session-image-look-${Date.now()}`,
+          text: '請用一句繁體中文描述這張圖片的內容與情緒。',
+          images: [ref],
+          contextText: '',
+          cwd: store.get().agent.cwd || undefined,
+        })
+        return { text: result.text, attachmentId: String(ref.attachmentId || ''), mediaType }
+      }
+      case 'vision-describe': {
+        const url = String(payload.url || '').trim()
+        const stickerId = String(payload.stickerId || '').trim()
+        const file = String(payload.file || '').trim()
+        if (!url && !stickerId && !file) throw new Error('需要 url、stickerId 或 file')
+        let target = url || file
+        if (stickerId) {
+          const { data } = await stickerImages.fetchBytes(stickerId, payload.stickerResourceType || 'STATIC')
+          target = writeIncomingImage(Buffer.from(data), `vision-${stickerId}-${Date.now()}.png`)
+        }
+        const described = await vision.describe(target, { prompt: String(payload.prompt || '').trim() })
+        return { text: described.text, vision: vision.status() }
+      }
       case 'sticker-look': {
         const stickerId = String(payload.stickerId || '').trim()
         if (!stickerId) throw new Error('缺少 stickerId')
@@ -2394,6 +2676,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/line-api.mjs

@@ -161,3 +161,32 @@ export async function pushMessage(accessToken, to, content) {
     body: JSON.stringify({ to, messages }),
   })
 }
+
+/**
+ * 下載使用者傳來的圖片／檔案內容（GET /v2/bot/message/{id}/content）。
+ * LINE 的 content API 在 api-data 網域，回傳二進位。
+ */
+export async function getMessageContent(accessToken, messageId, { timeoutMs = 30000 } = {}) {
+  const id = String(messageId || '').trim()
+  if (!id) throw new LineApiError('沒有 messageId')
+  const controller = new AbortController()
+  const timer = setTimeout(() => controller.abort(), timeoutMs)
+  try {
+    const res = await fetch(`https://api-data.line.me/v2/bot/message/${encodeURIComponent(id)}/content`, {
+      headers: { authorization: `Bearer ${accessToken}` },
+      signal: controller.signal,
+    })
+    if (!res.ok) {
+      const text = await res.text().catch(() => '')
+      throw new LineApiError(`LINE ${res.status}${text ? `：${text.slice(0, 200)}` : ''}`, { status: res.status })
+    }
+    const data = Buffer.from(await res.arrayBuffer())
+    if (data.length > 10 * 1024 * 1024) throw new LineApiError('圖片超過 10MB，略過')
+    return data
+  } catch (error) {
+    if (error?.name === 'AbortError') throw new LineApiError('LINE 圖片下載逾時', { status: 0 })
+    throw error
+  } finally {
+    clearTimeout(timer)
+  }
+}

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/lib/sticker-image.mjs

@@ -49,5 +49,14 @@ export function createStickerImages({ ctx, logger, dir }) {
     return ref
   }
 
-  return { available, toAttachment }
+  async function saveBuffer(buffer, name = 'line-image.png', mediaType = 'image/png') {
+    if (!available()) throw new Error('這個 profile 沒有附件服務（attachments）')
+    if (!buffer || buffer.byteLength === 0) throw new Error('圖片是空檔案')
+    const bytes = buffer instanceof Uint8Array ? buffer : new Uint8Array(buffer)
+    const [ref] = await attachments.saveImages([{ data: bytes, mediaType, name }])
+    if (!ref) throw new Error('附件服務沒有回傳圖片參照')
+    return ref
+  }
+
+  return { available, toAttachment, saveBuffer, fetchBytes }
 }

package/lib/vision.mjs

@@ -0,0 +1,100 @@
+// 用 modlens CLI 看圖：只在模型本身不支援圖片、或需要描述時使用。
+import { execFile } from 'node:child_process'
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+
+const TIMEOUT_MS = 90_000
+
+function candidateMains() {
+  const list = []
+  if (process.env.MODLENS_MAIN) list.push(process.env.MODLENS_MAIN)
+  const home = os.homedir()
+  for (const profile of ['desktop', 'web', 'line', 'headless']) {
+    list.push(path.join(home, '.dsh', 'profiles', profile, 'node_modules', '@liustack', 'modlens', 'dist', 'main.js'))
+  }
+  list.push('/opt/homebrew/lib/node_modules/@liustack/modlens/dist/main.js')
+  list.push('/usr/local/lib/node_modules/@liustack/modlens/dist/main.js')
+  return list
+}
+
+function execFileAsync(file, args, options) {
+  return new Promise((resolve, reject) => {
+    execFile(file, args, options, (error, stdout, stderr) => {
+      if (error) {
+        error.stdout = stdout
+        error.stderr = stderr
+        reject(error)
+        return
+      }
+      resolve({ stdout, stderr })
+    })
+  })
+}
+
+function pickText(data) {
+  const parts = []
+  if (data?.summary) parts.push(String(data.summary).trim())
+  const scene = data?.semantics?.scene
+  if (scene && !parts.includes(scene)) parts.push(String(scene).trim())
+  const intent = data?.semantics?.intent
+  if (intent) parts.push(`意圖：${intent}`)
+  const entities = Array.isArray(data?.semantics?.entities) ? data.semantics.entities.map((item) => item?.name).filter(Boolean) : []
+  if (entities.length) parts.push(`畫面元素：${entities.slice(0, 6).join('、')}`)
+  const ocr = String(data?.ocr?.full_text || '').trim()
+  if (ocr) parts.push(`文字：${ocr.slice(0, 240)}`)
+  const regions = Array.isArray(data?.layout?.regions) ? data.layout.regions.map((item) => item?.text).filter(Boolean) : []
+  if (!parts.length && regions.length) parts.push(regions.slice(0, 8).join(' '))
+  const text = parts.filter(Boolean).join('；').replace(/\s+/g, ' ').trim()
+  return text.slice(0, 600)
+}
+
+export function createVision({ logger, cacheDir }) {
+  let mainPath
+  let lastError = ''
+
+  function resolveMain() {
+    if (mainPath !== undefined) return mainPath
+    mainPath = candidateMains().find((file) => fs.existsSync(file)) || ''
+    return mainPath
+  }
+
+  function available() {
+    return Boolean(resolveMain())
+  }
+
+  function status() {
+    return { available: available(), main: resolveMain(), lastError }
+  }
+
+  async function describe(file, { prompt = '', provider = '', model = '' } = {}) {
+    if (!available()) throw new Error('找不到 modlens（請安裝 @liustack/modlens 或設定 MODLENS_MAIN）')
+    if (!file) throw new Error('沒有指定圖片')
+    if (!/^https?:\/\//i.test(file) && !fs.existsSync(file)) throw new Error('找不到要看的圖片檔案')
+    const dir = cacheDir || path.join(os.tmpdir(), 'dsh-line-bot-vision')
+    fs.mkdirSync(dir, { recursive: true })
+    const out = path.join(dir, `modlens-${Date.now()}-${Math.random().toString(16).slice(2, 8)}.json`)
+    const args = ['analyze', '-i', file, '-o', out, '--timeout', String(TIMEOUT_MS)]
+    if (provider) args.push('--provider', provider)
+    if (model) args.push('--model', model)
+    if (prompt) args.push('--prompt', prompt)
+    try {
+      await execFileAsync(process.execPath, [resolveMain(), ...args], { timeout: TIMEOUT_MS + 15_000 })
+      const raw = JSON.parse(fs.readFileSync(out, 'utf8'))
+      const text = pickText(raw)
+      if (!text) throw new Error('modlens 沒有回傳可用的描述')
+      lastError = ''
+      return { text, raw }
+    } catch (error) {
+      lastError = String(error?.message || error).slice(0, 300)
+      logger?.warn?.(`modlens 看圖失敗：${lastError}`)
+      throw error
+    } finally {
+      try {
+        fs.rmSync(out, { force: true })
+      } catch {}
+    }
+  }
+
+  return { available, describe, status }
+}

package/package.json

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