dsh-line-bot 0.4.1 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.5.1
+
+- 主動傳訊（含低餘額提醒）現在也能配表情包：預設提示詞允許在句子後面加 `[[meme:#編號]]`，不適合就純文字。
+
+## 0.5.0
+
+- 表情包（dsh-meme）：角色回覆時可以配圖或只回一張圖；圖片來自已安裝的 dsh-meme 圖庫（內建「大肥魚」24 張），面板可開關、限制一次最多 1～3 張、預覽圖庫樣本。
+- 圖片經目前的 Cloudflare 公開網址提供給 LINE；quick tunnel 換網址後自動跟上。
+- 為避免和 dsh-meme 的 chat 用法混淆，LINE 回覆會隱藏 `send_meme` 等工具，改用 `[[meme:#編號]]` 標記。
+
 ## 0.4.1
 
 - 角色現在知道「正在用哪個 provider／模型」回答：每輪會帶入目前模型，問它「你是哪個模型」時會照實回答。

package/README.en.md

@@ -77,6 +77,7 @@ At the top of the panel is a **sticky save bar**: "Save changes / Refresh" stays
 | Reply persona | Choose a persona (dafeiyu or a plugin custom one), add/edit/delete custom personas, copy the current persona into a custom one, enforce, allow users to switch personas, switch dafeiyu to session mode, test an Agent reply |
 | Tieba learning sync | Writes the tone samples learned while browsing Tieba back into the persona's "Tieba tone" section, preview diff, sync now |
 | 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 |
 | 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 |
@@ -164,6 +165,14 @@ The character keeps its own memory at `<DSH_HOME>/line-bot/memories.json`, separ
 - Each turn only injects the most recent N entries (20 entries / 2000 characters by default); the rest stay in the file. The per-user cap defaults to 120 entries and evicts the oldest.
 - Passwords, tokens, ID numbers and similar secrets should not be stored; it avoids them.
 - The "Personal memory" panel card shows what it remembers, lets you delete entries, prune expired ones, or trigger a review right away.
+## Memes (dsh-meme)
+
+The persona can attach a sticker to a text reply, or reply with just an image. Images come from the installed dsh-meme plugin's library (the built-in "大肥鱼" pack has 24 images):
+
+- 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.
+- Without dsh-meme installed, the feature stays off and replies are text only.
 ## Troubleshooting
 
 - **The panel says "cannot connect to the LINE Bot runtime"**: webServer may not be ready yet; refresh. If it still fails, look for `[line-bot]` messages in the DSH logs.

package/README.ja.md

@@ -77,6 +77,7 @@ dsh plugin --profile desktop add dsh-line-bot
 | 返信ペルソナ | ペルソナ選択（大肥魚またはプラグインのカスタム）、カスタムペルソナの追加・編集・削除、現在のペルソナをカスタムに複製、強制適用、ユーザーによる切り替え許可、大肥魚を session モードに切り替え、Agent 返信のテスト |
 | 貼吧学習の同期 | 貼吧で学んだ口調をペルソナの「貼吧学来的口气」節に書き戻す、差分プレビュー、今すぐ同期 |
 | 個人メモリ | ユーザーごとの長期記憶、期限切れの自動削除、毎日の自己整理、手動削除 |
+| 表情パック | dsh-meme の画像ライブラリで画像／スタンプを返信、オンオフ、1 回の上限、サンプル表示 |
 | DeepSeek 残高 | 現在の残高、毎ターンの注入、残高が少ないときの主動リマインド、しきい値とクールダウン（deepseek-account のみ） |
 | 自発メッセージ | オン／オフ、確率、間隔、1 日／1 か月の上限、最短間隔、静かな時間帯、idle、対象ユーザー、プロンプト、今すぐ試送、統計 |
 | ユーザー | LINE ユーザーごとに対応する DSH セッション、専用ワークスペース、現在のペルソナ（直接変更可）、メッセージ数、最終やりとり、メモリ消去／セッション再作成 |
@@ -164,6 +165,14 @@ dsh plugin --profile desktop add dsh-line-bot
 - 毎ターンは直近 N 件（既定 20 件・2000 文字）だけを注入し、残りはファイルに残します。1 人あたりの上限は既定 120 件で、超えると古いものから消えます。
 - パスワード、token、身分証番号などの機密情報は記録しません。
 - パネルの「個人メモリ」カードで、記録内容の確認、手動削除、期限切れの一括削除、今すぐの見直しができます。
+## 表情パック（dsh-meme）
+
+キャラクターはテキストの返信にスタンプ画像を添えたり、画像だけを返したりできます。画像はインストール済みの dsh-meme プラグインのライブラリ（内蔵「大肥魚」24 枚）から取得します。
+
+- 毎ターン、ライブラリのサンプル（番号＋説明）を context に注入します。画像を添えたいときは返信の最後に `[[meme:#番号]]`（または説明）を付けます。プラグインが LINE の image message に変換します。
+- 画像は現在の Cloudflare 公開 URL（`<URL>/media/<token>`）経由で LINE に渡されます。quick tunnel の再起動で URL が変わっても自動で追従します。
+- パネルの「表情パック」カードでオンオフ、1 回あたりの上限（1〜3）、ライブラリのサンプル表示ができます。画像の追加や分類の変更は dsh-meme 側の設定で行います。
+- dsh-meme がインストールされていない場合、この機能は無効になりテキストのみ返します。
 ## トラブルシューティング
 
 - **パネルに「LINE Bot ランタイムに接続できません」と出る**：webServer がまだ準備できていない可能性があります。再読み込みしてください。それでも失敗する場合は DSH ログの `[line-bot]` を確認します。

package/README.ko.md

@@ -77,6 +77,7 @@ dsh plugin --profile desktop add dsh-line-bot
 | 답장 페르소나 | 페르소나 선택(大肥魚 또는 플러그인 커스텀), 커스텀 페르소나 추가/편집/삭제, 현재 페르소나를 커스텀으로 복사, 강제 적용, 사용자 직접 전환 허용, 大肥魚를 session 모드로 전환, Agent 답장 테스트 |
 | 貼吧 학습 동기화 | 貼吧에서 배운 말투를 페르소나의 「貼吧学来的口气」 섹션으로 기록, 차이 미리보기, 지금 동기화 |
 | 개인 기억 | 사용자별 장기 기억, 만료 자동 삭제, 매일 자기 정리, 수동 삭제 |
+| 이모티콘 | dsh-meme 라이브러리로 이미지/스티커 답장, 켜기/끄기, 1회 최대 장수, 샘플 미리보기 |
 | DeepSeek 잔액 | 현재 잔액, 매 턴 주입, 잔액이 적을 때 캐릭터가 먼저 알림, 기준 금액과 쿨다운(deepseek-account 전용) |
 | 능동 메시지 | 켜기/끄기, 확률, 간격, 일일/월간 상한, 최소 간격, 조용한 시간대, idle, 대상 사용자, 프롬프트, 지금 시험 발송, 통계 |
 | 사용자 | LINE 사용자별 DSH 세션, 전용 작업 폴더, 현재 페르소나(직접 변경 가능), 메시지 수, 마지막 상호작용, 기억 지우기／세션 재설정 |
@@ -164,6 +165,14 @@ dsh plugin --profile desktop add dsh-line-bot
 - 매 턴에는 최근 N개(기본 20개·2000자)만 주입하고 나머지는 파일에 남깁니다. 사용자당 상한은 기본 120개이며, 넘으면 오래된 것부터 지웁니다.
 - 비밀번호, token, 신분증 번호 같은 민감 정보는 기록하지 않습니다.
 - 패널의 "개인 기억" 카드에서 기록 내용 확인, 수동 삭제, 만료 일괄 정리, 지금 정리를 할 수 있습니다.
+## 이모티콘(dsh-meme)
+
+캐릭터는 텍스트 답장에 스티커 이미지를 붙이거나 이미지만 보낼 수 있습니다. 이미지는 설치된 dsh-meme 플러그인의 라이브러리(내장 「대비어」 24장)에서 가져옵니다.
+
+- 매 턴 라이브러리 샘플(번호＋설명)을 context에 넣습니다. 이미지를 붙이려면 답장 끝에 `[[meme:#번호]]`(또는 설명)를 붙입니다. 플러그인이 LINE image message로 바꿔 보냅니다.
+- 이미지는 현재 Cloudflare 공개 URL(`<URL>/media/<token>`)을 통해 LINE에 전달되며, quick tunnel이 재시작돼 URL이 바뀌어도 자동으로 따라갑니다.
+- 패널의 「이모티콘」 카드에서 켜고 끄기, 답장당 최대 장수(1~3), 라이브러리 샘플 미리보기를 할 수 있습니다. 이미지 추가나 분류 변경은 dsh-meme 설정에서 하세요.
+- dsh-meme이 설치되어 있지 않으면 이 기능은 꺼지고 텍스트만 답장합니다.
 ## 문제 해결
 
 - **패널에 "LINE Bot 런타임에 연결할 수 없습니다"**: webServer가 아직 준비되지 않았을 수 있습니다. 새로 고침하세요. 그래도 실패하면 DSH 로그의 `[line-bot]` 메시지를 확인합니다.

package/README.md

@@ -77,6 +77,7 @@ dsh plugin --profile desktop add dsh-line-bot
 | 回覆人設 | 選擇人設（大肥魚或插件自訂）、新增／編輯／刪除自訂人設、把目前人設複製成自訂、強制套用、允許使用者自己換人設、切換大肥魚 session 模式、測試 Agent 回覆 |
 | 貼吧學習同步 | 把刷貼吧學到的語氣寫回人設的「貼吧學來的口氣」段、預覽差異、立即同步 |
 | 個人記憶 | 每位使用者分開的長期記憶、到期自動刪、每日請角色整理、手動刪除 |
+| 表情包 | 使用 dsh-meme 圖庫回圖片／貼圖、開關、一次最多幾張、圖庫樣本 |
 | DeepSeek 餘額 | 目前餘額、每輪注入、低於門檻時由角色主動提醒、提醒門檻與冷卻（僅 deepseek-account） |
 | 主動傳訊 | 開關、機率、間隔、每日／每月上限、最短間隔、安靜時段、idle、指定對象、提示詞、立即試傳、統計 |
 | 使用者 | 每位 LINE 使用者對應的 DSH session、專屬工作資料夾、目前人設（可直接改）、訊息數、上次互動、清空記憶／重設 session |
@@ -164,6 +165,14 @@ dsh plugin --profile desktop add dsh-line-bot
 - 每輪只帶入最近的 N 筆（預設 20 筆、2000 字），其餘仍留在檔案裡；每人上限預設 120 筆，超過時刪最舊的。
 - 密碼、token、證件號等敏感資料不該叫它記，它也會避免。
 - 面板的「個人記憶」卡可以看目前記了什麼、手動刪除、立即清理到期、或現在就叫它整理一次。
+## 表情包（dsh-meme）
+
+角色可以回文字時配一張貼圖，也可以只回一張圖。圖片來自已安裝的 dsh-meme 外掛的圖庫（內建「大肥魚」24 張）：
+
+- 每輪會把圖庫樣本（編號＋描述）帶進 context；角色想配圖時在回覆最後加 `[[meme:#編號]]`（或描述），插件再組成 LINE 的 image message。
+- 圖片透過目前的 Cloudflare 公開網址（`<網址>/media/<token>`）提供給 LINE；quick tunnel 換網址後會自動跟上。
+- 面板「表情包」卡可以開關、限制一次最多幾張（1～3），並預覽圖庫樣本。要新增圖片或改分類，請用 dsh-meme 自己的設定。
+- 沒安裝 dsh-meme 時這個功能會自動停用，只回文字。
 ## 疑難排解
 
 - **面板顯示「無法連線到 LINE Bot 執行期」**：webServer 可能還沒就緒，重新整理即可；仍失敗就看 DSH 日誌裡 `[line-bot]` 的訊息。

package/README.zh-CN.md

@@ -77,6 +77,7 @@ dsh plugin --profile desktop add dsh-line-bot
 | 回复人设 | 选择人设（大肥鱼或插件自定义）、新增／编辑／删除自定义人设、把目前人设复制成自定义、强制套用、允许用户自己换人设、切换大肥鱼 session 模式、测试 Agent 回复 |
 | 贴吧学习同步 | 把刷贴吧学到的语气写回人设的「贴吧学来的口气」段、预览差异、立即同步 |
 | 个人记忆 | 每位用户分开的长期记忆、到期自动删除、每日请角色整理、手动删除 |
+| 表情包 | 使用 dsh-meme 图库回图片/贴图、开关、每次最多几张、图库样本 |
 | DeepSeek 余额 | 当前余额、每轮注入、低于门槛时由角色主动提醒、提醒门槛与冷却（仅 deepseek-account） |
 | 主动传讯 | 开关、概率、间隔、每日／每月上限、最短间隔、安静时段、idle、指定对象、提示词、立即试传、统计 |
 | 用户 | 每位 LINE 用户对应的 DSH session、专属工作文件夹、目前人设（可直接改）、消息数、上次互动、清空记忆／重设 session |
@@ -164,6 +165,14 @@ dsh plugin --profile desktop add dsh-line-bot
 - 每轮只带入最近的 N 笔（默认 20 笔、2000 字），其余仍留在文件里；每人上限默认 120 笔，超过时删除最旧的。
 - 密码、token、证件号等敏感资料不该叫它记，它也会避免。
 - 面板的「个人记忆」卡可以看目前记了什么、手动删除、立即清理到期、或现在就叫它整理一次。
+## 表情包（dsh-meme）
+
+角色可以在文字后面配一张贴图，也可以只回一张图。图片来自已安装的 dsh-meme 插件的图库（内置「大肥鱼」24 张）：
+
+- 每轮会把图库样本（编号＋描述）带进 context；角色想配图时在回复最后加 `[[meme:#编号]]`（或描述），插件再组成 LINE 的 image message。
+- 图片通过当前的 Cloudflare 公开网址（`<网址>/media/<token>`）提供给 LINE；quick tunnel 换网址后会自动跟上。
+- 面板「表情包」卡可以开关、限制每次最多几张（1～3），并预览图库样本。要新增图片或改分类，请用 dsh-meme 自己的设置。
+- 没安装 dsh-meme 时该功能会自动停用，只回文字。
 ## 疑难排解
 
 - **面板显示「无法连接到 LINE Bot 运行时」**：webServer 可能还没就绪，刷新即可；仍失败就看 DSH 日志里 `[line-bot]` 的消息。

package/client.js

@@ -21,6 +21,7 @@ window.__ModuleLoader__.load({
       { key: 'memory', label: '個人記憶' },
       { key: 'balance', label: 'DeepSeek 餘額' },
       { key: 'nudge', label: '主動傳訊' },
+      { key: 'meme', label: '表情包' },
       { key: 'users', label: '使用者' },
       { key: 'advanced', label: '進階／日誌' },
     ]
@@ -298,6 +299,7 @@ window.__ModuleLoader__.load({
 
     // ── 主面板 ─────────────────────────────────────────────────────────────
     const ACTION_LABELS = {
+      'meme-stats': '讀取表情包圖庫',
       start: '啟動',
       stop: '停止',
       restart: '重新啟動',
@@ -656,6 +658,9 @@ window.__ModuleLoader__.load({
       const nudgeCfg = cfg.nudge || {}
       const syncCfg = cfg.sync || {}
       const balanceCfg = cfg.balance || {}
+      const memeCfg = cfg.stickers || {}
+      const memeStatus = status.meme || {}
+      const memeSample = Array.isArray(memeStatus.sample) ? memeStatus.sample : []
       const balanceStatus = status.balance || {}
       const balanceSymbol = balanceStatus.cny ? '¥' : balanceStatus.usd ? '$' : '¥'
       const balanceTotal = balanceStatus.cny ? balanceStatus.cny.total : balanceStatus.usd ? balanceStatus.usd.total : null
@@ -1132,10 +1137,34 @@ window.__ModuleLoader__.load({
           nudgeStats.lastError ? h('div', { style: S.errBox }, nudgeStats.lastError) : null,
         ),
 
+        // 5.5 表情包（dsh-meme 圖庫）
+        h(
+          Card,
+          { id: sectionDomId('meme'), order: 10, title: '表情包（dsh-meme 圖庫）', desc: '角色可以在文字後面配一張圖，也可以只回一張圖。圖片來自 dsh-meme 外掛的圖庫；要新增、分類或改描述，請到 dsh-meme 的設定頁。' },
+          !memeStatus.available
+            ? h('div', { style: S.warnBox }, '沒有偵測到 dsh-meme 外掛（或尚未啟用）。請先安裝並啟用 dsh-meme，這裡才會出現可用圖片。')
+            : h('div', null,
+                h('div', { style: S.row },
+                  h(Badge, { ok: true }, '圖庫 ' + ((memeStatus.packs || []).length) + ' 個'),
+                  h(Badge, { ok: true }, '共 ' + (memeStatus.count || 0) + ' 張'),
+                  h(Badge, { ok: !!memeStatus.publicBase }, memeStatus.publicBase ? '公開網址正常' : '沒有公開網址'),
+                ),
+                h(Toggle, { checked: memeCfg.enabled !== false, onChange: (value) => update({ stickers: { enabled: value } }), label: '允許角色使用表情包', hint: '關掉後只回文字' }),
+                h(Field, { label: '一次最多幾張', hint: 'LINE 一次回覆最多 5 則訊息，圖片也算在內' }, h(Num, { value: memeCfg.maxPerReply, min: 1, max: 3, step: 1, onChange: (value) => update({ stickers: { maxPerReply: value } }) })),
+                h('div', { style: S.row },
+                  h(Btn, { onClick: () => act('meme-stats'), disabled: !!busy }, busy === 'meme-stats' ? '讀取中…' : '重新讀取圖庫'),
+                ),
+                h('div', { style: S.fieldTitle }, '圖庫樣本'),
+                memeSample.length === 0
+                  ? h('div', { style: S.hint }, '目前讀不到樣本；確認 dsh-meme 是否已啟用圖庫。')
+                  : h('div', null, memeSample.map((item, index) => h('div', { key: index, style: { fontSize: 13, padding: '4px 0', borderTop: '1px solid var(--dsw-alias-border-l2)' } }, '・' + item.caption + '（' + item.tag + '）'))),
+              ),
+        ),
+
         // 6. 使用者
         h(
           Card,
-          { id: sectionDomId('users'), order: 10, title: '使用者', desc: '與 bot 互動過的 LINE 使用者。每個人有自己的 DSH session 與工作資料夾（記憶、檔案不互通），人設也可以個別指定。' },
+          { id: sectionDomId('users'), order: 11, title: '使用者', desc: '與 bot 互動過的 LINE 使用者。每個人有自己的 DSH session 與工作資料夾（記憶、檔案不互通），人設也可以個別指定。' },
           (status.users || []).length === 0
             ? h('div', { style: S.hint }, '還沒有人傳訊息給 bot。')
             : h('table', { style: S.table },
@@ -1171,7 +1200,7 @@ window.__ModuleLoader__.load({
         // 7. 進階設定
         h(
           Card,
-          { id: sectionDomId('advanced'), order: 11, title: '進階設定', desc: '通常不用改；出問題時可從這裡調整。' },
+          { id: sectionDomId('advanced'), order: 20, title: '進階設定', desc: '通常不用改；出問題時可從這裡調整。' },
           h('div', { style: S.grid },
             h(Field, { label: 'Webhook 連接埠', hint: '改完按儲存；伺服器會自動重啟。' }, h(Num, { value: server.port, min: 1024, max: 65535, onChange: (value) => update({ server: { port: value } }) })),
             h(Field, { label: '每位使用者獨立工作資料夾', hint: '開啟＝每個 LINE 使用者有自己的 cwd（檔案、AGENTS.md、工作區記憶互不相通）' },

package/lib/agent-runner.mjs

@@ -120,6 +120,20 @@ export function createAgentRunner({ ctx, logger, getConfig }) {
       } catch (error) {
         logger?.warn?.(`注入人設／貼吧動態失敗：${error?.message || error}`)
       }
+      try {
+        const registry = agentCtx.get?.('tools') || agentCtx.tools
+        if (registry?.restrict) {
+          for (const name of ['send_meme', 'learn_meme', 'meme_update', 'meme_list']) {
+            try {
+              agentCtx.effect(() => registry.restrict({ deny: [name] }), `line-bot: hide ${name}`)
+            } catch {
+              /* 這個 profile 沒有這個工具就略過 */
+            }
+          }
+        }
+      } catch (error) {
+        logger?.warn?.(`隱藏 dsh-meme 工具失敗：${error?.message || error}`)
+      }
       if (Array.isArray(tools) && tools.length > 0) {
         try {
           const registry = agentCtx.get?.('tools') || agentCtx.tools

package/lib/config.mjs

@@ -111,6 +111,11 @@ export const DEFAULT_CONFIG = {
     reviewDaily: true,
     reviewHour: 4,
   },
+  stickers: {
+    // 角色可以用圖片／表情包回話；圖片由面板上傳，存在 <dataDir>/stickers。
+    enabled: true,
+    maxPerReply: 1,
+  },
   log: {
     maxLines: 400,
   },
@@ -232,6 +237,10 @@ export function sanitizePatch(current, patch) {
   memory.injectMaxChars = clampInt(memory.injectMaxChars, 200, 8000, 2000)
   memory.reviewHour = clampInt(memory.reviewHour, 0, 23, 4)
 
+  const stickers = next.stickers || (next.stickers = {})
+  stickers.enabled = Boolean(stickers.enabled)
+  stickers.maxPerReply = clampInt(stickers.maxPerReply, 1, 3, 1)
+
   const nudge = next.nudge
   nudge.enabled = Boolean(nudge.enabled)
   nudge.chance = clampFloat(nudge.chance, 0, 1, 0.18)

package/lib/host.mjs

@@ -2,7 +2,8 @@
 // 大肥魚人設、agent 回覆與主動傳訊，全部集中在這裡，index.js 只負責載入與路由掛載。
 import fs from 'node:fs'
 import path from 'node:path'
-import { randomUUID } from 'node:crypto'
+import { randomBytes, randomUUID, createHash } from 'node:crypto'
+import { execFileSync } from 'node:child_process'
 // 用 ?v= 載入：dev/reload 重新 import host.mjs 時，這整組模組也會跟著重新求值，
 // 不用重開 DSH 就能套用 lib/*.mjs 的修改。
 const LOAD_VERSION = new URL(import.meta.url).searchParams.get('v') || ''
@@ -20,6 +21,8 @@ const localPersonasMod = await import(withVersion('./local-personas.mjs'))
 const tiebaContextMod = await import(withVersion('./tieba-context.mjs'))
 const balanceMod = await import(withVersion('./deepseek-balance.mjs'))
 const memoryMod = await import(withVersion('./memory.mjs'))
+const stickersMod = await import(withVersion('./stickers.mjs'))
+const memeSourceMod = await import(withVersion('./meme-source.mjs'))
 const utilMod = await import(withVersion('./util.mjs'))
 const { createConfigStore, publicConfig, dataDir } = configMod
 const { createPersonaClient } = personaMod
@@ -32,9 +35,11 @@ const { createLocalPersonas, LOCAL_PREFIX } = localPersonasMod
 const { buildTiebaContext } = tiebaContextMod
 const { createBalanceMonitor } = balanceMod
 const { createMemoryStore } = memoryMod
+const { createStickerStore } = stickersMod
+const { createMemeSource } = memeSourceMod
 const { chunkText, clip, inQuietWindow, jsonFail, jsonOk, maskSecret, readJsonBody, safeArray } = utilMod
 
-export const VERSION = '0.4.1'
+export const VERSION = '0.5.0'
 
 // 環境變數提供的 Cloudflare API Token（方便用 shell 注入、不用把 token 寫進設定檔）。
 // 設定檔裡的 token 優先；兩者都沒有時才用環境變數。
@@ -106,6 +111,7 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
     lastReply: null,
     lastTokenIssueAt: 0,
     tokenSource: '',
+    publicUrl: '',
   }
 
   const service = (name) => {
@@ -299,7 +305,7 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
   }
 
   function agentContextText(userId) {
-    return [modelContextText(), tiebaContextText(), balanceContextText(), memoryContextText(userId)].filter(Boolean).join('\n\n')
+    return [modelContextText(), tiebaContextText(), balanceContextText(), memoryContextText(userId), memeContextText() || stickerContextText()].filter(Boolean).join('\n\n')
   }
 
   async function refreshBalance() {
@@ -819,14 +825,202 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
     return { reply: `${prefix}「${picked.name}」回你。` }
   }
 
+  function publicBaseSync() {
+    const cfg = store.get()
+    if (runtime.publicUrl) return String(runtime.publicUrl).replace(/\/+$/, '')
+    if (cfg.tunnel?.publicUrl) return String(cfg.tunnel.publicUrl).replace(/\/+$/, '')
+    if (cfg.tunnel?.mode === 'api' && cfg.cloudflare?.hostname) return `https://${cfg.cloudflare.hostname}`
+    return ''
+  }
+
+  const STICKER_MARKER = /\[\[\s*(?:sticker|貼圖|贴图|表情包)\s*:\s*([^\]\n]{1,60})\s*\]\]/gi
+  const MEME_MARKER = /\[\[\s*meme\s*:\s*([^\]\n]{1,80})\s*\]\]/gi
+  const MEME_BRACKET = /\[表情\s*[:：]\s*([^\]\n]{1,80})\]/g
+
+  function splitStickerMarkers(text) {
+    const names = []
+    const memeNames = []
+    let cleaned = String(text || '')
+      .replace(STICKER_MARKER, (_match, name) => {
+        const value = String(name || '').trim()
+        if (value) names.push(value)
+        return ''
+      })
+      .replace(MEME_MARKER, (_match, name) => {
+        const value = String(name || '').trim()
+        if (value) memeNames.push(value)
+        return ''
+      })
+    if (memes.available()) {
+      cleaned = cleaned.replace(MEME_BRACKET, (_match, name) => {
+        const value = String(name || '').trim()
+        if (value) memeNames.push(value)
+        return ''
+      })
+    }
+    cleaned = cleaned
+      .replace(/[ \t]+\n/g, '\n')
+      .replace(/\n{3,}/g, '\n\n')
+      .trim()
+    return { text: cleaned, names, memes: memeNames }
+  }
+
+  function memeMaxPerReply() {
+    return Math.max(1, Math.min(3, Number(store.get().stickers?.maxPerReply) || 1))
+  }
+
+  function memeContextText() {
+    const cfg = store.get()
+    if (cfg.stickers?.enabled === false) return ''
+    if (!memes.available()) return ''
+    if (memes.packs().length === 0) return ''
+    const sample = memes.sample({ limit: 20 })
+    const lines = (sample || [])
+      .map((item) => String(item.caption || '').trim())
+      .filter(Boolean)
+      .slice(0, 20)
+    if (lines.length === 0) return ''
+    return [
+      '【表情包】你的圖庫（dsh-meme）裡有這些圖：',
+      lines.map((line, index) => `${index + 1}. ${line}`).join('\n'),
+      `想配圖時，在回覆最後加上 [[meme:#編號]]（例如 [[meme:#3]]，編號照上面清單），也可以寫描述；只回一張圖就只輸出那個標記。一次最多 ${memeMaxPerReply()} 張；氣氛合適才用，不要每句都加；不要呼叫 send_meme。`,
+      publicBaseSync() ? '' : '（目前沒有公開網址，圖片送不出去。）',
+    ].filter(Boolean).join('\n')
+  }
+
+  function stickerContextText() {
+    const cfg = store.get()
+    if (cfg.stickers?.enabled === false) return ''
+    const items = stickers.list()
+    if (items.length === 0) return ''
+    const list = items.slice(0, 24).map((item) => `${item.name}${item.description ? `（${item.description}）` : ''}`).join('、')
+    return [
+      '【表情包】你可以在文字後面配一張圖，也可以只回一張圖。',
+      `可用：${list}`,
+      `想用時把 [[sticker:名稱]] 放在回覆最後，一次最多 ${memeMaxPerReply()} 張，名稱要完全符合；不需要就不要用，也不要每句都加。`,
+      publicBaseSync() ? '' : '（目前沒有公開網址，圖片暫時送不出去。）',
+    ].filter(Boolean).join('\n')
+  }
+
+  function convertWebpToPng(filePath) {
+    if (process.platform !== 'darwin') return ''
+    try {
+      const cacheDir = path.join(dir, 'cache')
+      fs.mkdirSync(cacheDir, { recursive: true })
+      const stat = fs.statSync(filePath)
+      const key = createHash('sha1').update(`${filePath}:${stat.mtimeMs}`).digest('hex').slice(0, 16)
+      const dest = path.join(cacheDir, `${key}.png`)
+      if (!fs.existsSync(dest)) {
+        execFileSync('sips', ['-s', 'format', 'png', filePath, '--out', dest], { stdio: 'ignore', timeout: 15000 })
+      }
+      return fs.existsSync(dest) ? dest : ''
+    } catch (error) {
+      logger.warn(`轉換表情包格式失敗：${errorText(error)}`)
+      return ''
+    }
+  }
+
+  function registerImageFile(filePath) {
+    const ext = path.extname(String(filePath || '')).toLowerCase()
+    let serve = filePath
+    let mime = ''
+    if (ext === '.jpg' || ext === '.jpeg') mime = 'image/jpeg'
+    else if (ext === '.png') mime = 'image/png'
+    else if (ext === '.webp') {
+      mime = 'image/png'
+      serve = convertWebpToPng(filePath)
+    } else {
+      return ''
+    }
+    if (!mime || !serve || !fs.existsSync(serve)) return ''
+    const token = `m${randomBytes(6).toString('hex')}`
+    mediaTokens.set(token, { path: serve, mime, at: Date.now() })
+    return token
+  }
+
+  function getMedia(id) {
+    const key = String(id || '')
+    if (!key) return null
+    if (key.startsWith('m')) {
+      const hit = mediaTokens.get(key)
+      if (!hit) return null
+      if (Date.now() - hit.at > 60 * 60 * 1000) {
+        mediaTokens.delete(key)
+        return null
+      }
+      try {
+        return { mime: hit.mime, bytes: fs.readFileSync(hit.path) }
+      } catch {
+        mediaTokens.delete(key)
+        return null
+      }
+    }
+    const entry = stickers.get(key)
+    const bytes = entry ? stickers.readFile(entry) : null
+    return entry && bytes ? { mime: entry.mime, bytes } : null
+  }
+
+  async function buildOutgoingMessages(text) {
+    const cfg = store.get()
+    const parsed = splitStickerMarkers(text)
+    const messages = []
+    const max = memeMaxPerReply()
+    const base = publicBaseSync()
+    if (cfg.stickers?.enabled !== false && base && parsed.memes.length > 0 && memes.available()) {
+      const sample = memes.sample({ limit: 20 })
+      for (const desc of parsed.memes.slice(0, max)) {
+        const indexMatch = /^#?(\d{1,3})$/.exec(String(desc).trim())
+        const index = indexMatch ? Number(indexMatch[1]) - 1 : -1
+        let file = index >= 0 ? (sample[index]?.path || '') : ''
+        if (!file) {
+          const picked = memes.pick({ query: desc })
+          file = picked?.ok && picked.path ? picked.path : ''
+        }
+        if (!file) {
+          const fallback = memes.search({ query: desc, limit: 1 })
+          file = fallback.memes?.[0]?.path || ''
+        }
+        if (!file) {
+          logger.warn(`找不到表情包：${desc}`)
+          continue
+        }
+        const token = registerImageFile(file)
+        if (!token) {
+          logger.warn(`表情包格式不支援（LINE 只收 JPEG/PNG）：${file}`)
+          continue
+        }
+        const url = `${base}/media/${token}`
+        messages.push({ type: 'image', originalContentUrl: url, previewImageUrl: url })
+      }
+    }
+    if (cfg.stickers?.enabled !== false && base && parsed.names.length > 0) {
+      for (const name of parsed.names.slice(0, max)) {
+        const entry = stickers.get(name)
+        if (!entry) {
+          logger.warn(`找不到表情包：${name}`)
+          continue
+        }
+        const url = `${base}/media/${encodeURIComponent(entry.id)}`
+        messages.push({ type: 'image', originalContentUrl: url, previewImageUrl: url })
+      }
+    }
+    if (parsed.text) {
+      for (const chunk of chunkText(parsed.text)) {
+        if (messages.length >= 5) break
+        messages.push(chunk)
+      }
+    }
+    return { messages: messages.slice(0, 5), parsed }
+  }
+
   async function replyOrPush(userId, replyToken, texts) {
-    const chunks = chunkText(texts)
-    if (chunks.length === 0) return
+    const { messages } = await buildOutgoingMessages(texts)
+    if (messages.length === 0) return
     try {
-      await withToken((token) => lineApi.replyMessage(token, replyToken, chunks))
+      await withToken((token) => lineApi.replyMessage(token, replyToken, messages))
     } catch (error) {
       logger.warn(`reply 失敗，改用 push：${errorText(error)}`)
-      await withToken((token) => lineApi.pushMessage(token, userId, chunks))
+      await withToken((token) => lineApi.pushMessage(token, userId, messages))
     }
   }
 
@@ -896,9 +1090,10 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
         cwd: ensureUserWorkspace(userId) || cfg.agent.cwd || undefined,
       })
       let replyText = String(result?.text || '').trim()
-      if (!replyText) replyText = cfg.line.emptyReply || '（她沒有說話）'
+      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(replyText, 300) }
+      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,
@@ -918,8 +1113,11 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
 
   // ── 元件 ────────────────────────────────────────────────────────────────
   const runner = createAgentRunner({ ctx, logger, getConfig: () => store.get() })
+  const stickers = createStickerStore({ dir, logger })
+  const memes = createMemeSource({ ctx, logger })
+  const mediaTokens = new Map()
 
-  const server = createWebhookServer({ getConfig: () => store.get(), logger, dispatch: handleEvent })
+  const server = createWebhookServer({ getConfig: () => store.get(), logger, dispatch: handleEvent, getMedia })
 
   const tunnel = createTunnelManager({
     getConfig: () => withEnvCloudflare(store.get()),
@@ -928,6 +1126,7 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
     dataDir: dir,
     onUrl: async (url) => {
       logger.info(`Cloudflare 公網位址：${url}`)
+      runtime.publicUrl = String(url || '').replace(/\/+$/, '')
       if (!store.get().tunnel.autoConfigureWebhook) return
       try {
         await applyWebhook(url)
@@ -941,8 +1140,9 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
   })
 
   async function sendPush(userId, text) {
-    const chunks = chunkText(text)
-    await withToken((token) => lineApi.pushMessage(token, userId, chunks))
+    const { messages } = await buildOutgoingMessages(text)
+    if (messages.length === 0) return
+    await withToken((token) => lineApi.pushMessage(token, userId, messages))
     store.updateState((state) => ({
       ...state,
       users: {
@@ -1053,6 +1253,8 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
         throw error
       }
     }
+    const liveTunnel = await tunnel.status().catch(() => null)
+    if (liveTunnel?.url) runtime.publicUrl = String(liveTunnel.url).replace(/\/+$/, '')
     startWebhookGuard()
     nudge.start()
     tiebaSync.start()
@@ -1152,6 +1354,22 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
         lastAskText: state.balance?.lastAskText || '',
         low: Boolean(balanceView() && Number(cfg.balance.threshold) > 0 && balanceView().value.total < Number(cfg.balance.threshold)),
       },
+      meme: {
+        ...memes.stats(),
+        enabled: cfg.stickers?.enabled !== false,
+        maxPerReply: memeMaxPerReply(),
+        publicBase: publicBaseSync(),
+        sample: memes.sample({ limit: 8 }).map((item) => ({ tag: item.tag, caption: item.caption, packName: item.packName })),
+        localStickers: stickers.stats().count,
+      },
+      stickers: {
+        ...stickers.stats(),
+        enabled: cfg.stickers?.enabled !== false,
+        maxPerReply: Math.max(1, Math.min(3, Number(cfg.stickers?.maxPerReply) || 1)),
+        publicBase: publicBaseSync(),
+        items: stickers.list(),
+        warning: publicBaseSync() ? '' : '尚未取得公開網址（Cloudflare tunnel 未啟動）',
+      },
       memory: {
         ...memory.stats(),
         enabled: cfg.memory?.enabled !== false,
@@ -1325,6 +1543,23 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
         return refreshBalance()
       case 'balance-ask':
         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 'meme-preview': {
+        if (!payload.text) throw new Error('缺少 text')
+        const built = await buildOutgoingMessages(String(payload.text))
+        return { messages: built.messages, parsed: built.parsed }
+      }
+      case 'sticker-list':
+        return { ...stickers.stats(), items: stickers.list(), publicBase: publicBaseSync() }
+      case 'sticker-add': {
+        const entry = stickers.add({ name: payload.name, description: payload.description, dataUrl: payload.dataUrl || payload.data })
+        return { sticker: entry, count: stickers.list().length }
+      }
+      case 'sticker-delete': {
+        if (!payload.id) throw new Error('缺少表情包 id')
+        return stickers.remove(String(payload.id))
+      }
       case 'memory-list': {
         const only = String(payload.userId || '').trim()
         const state = store.getState()
@@ -1477,6 +1712,20 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
         jsonOk(res, await buildStatus())
         return
       }
+      if (req.method === 'GET' && sub.startsWith('/media/')) {
+        const media = getMedia(decodeURIComponent(sub.slice('/media/'.length)))
+        if (!media || !media.bytes) {
+          jsonFail(res, 'not found', 404)
+          return
+        }
+        res.writeHead(200, {
+          'content-type': media.mime || 'application/octet-stream',
+          'content-length': media.bytes.length,
+          'cache-control': 'public, max-age=300',
+        })
+        res.end(media.bytes)
+        return
+      }
       if (req.method === 'GET' && sub === '/health') {
         jsonOk(res, { ok: true, version: VERSION, server: server.status(), tunnel: (await tunnel.status()).phase })
         return

package/lib/line-api.mjs

@@ -127,8 +127,15 @@ export async function startLoading(accessToken, chatId, loadingSeconds = 60) {
   })
 }
 
-export async function replyMessage(accessToken, replyToken, texts) {
-  const messages = (Array.isArray(texts) ? texts : [texts]).filter(Boolean).map((text) => ({ type: 'text', text }))
+function toMessages(input) {
+  return (Array.isArray(input) ? input : [input])
+    .filter(Boolean)
+    .map((item) => (typeof item === 'string' ? { type: 'text', text: item } : item))
+    .filter((item) => item && item.type)
+}
+
+export async function replyMessage(accessToken, replyToken, content) {
+  const messages = toMessages(content)
   if (messages.length === 0) return null
   return request(`${MESSAGING}/message/reply`, {
     method: 'POST',
@@ -137,8 +144,8 @@ export async function replyMessage(accessToken, replyToken, texts) {
   })
 }
 
-export async function pushMessage(accessToken, to, texts) {
-  const messages = (Array.isArray(texts) ? texts : [texts]).filter(Boolean).map((text) => ({ type: 'text', text }))
+export async function pushMessage(accessToken, to, content) {
+  const messages = toMessages(content)
   if (messages.length === 0) return null
   return request(`${MESSAGING}/message/push`, {
     method: 'POST',

package/lib/meme-source.mjs

@@ -0,0 +1,74 @@
+// 讀 dsh-meme 外掛提供的只讀取圖服務（ctx.get('dshMeme')）。
+// 圖庫、分類、描述都由 dsh-meme 維護；這裡只負責挑圖與把檔案路徑交給 LINE。
+export function createMemeSource({ ctx, logger }) {
+  function service() {
+    try {
+      return ctx?.get?.('dshMeme') || null
+    } catch {
+      return null
+    }
+  }
+
+  function available() {
+    const svc = service()
+    return Boolean(svc && typeof svc.pick === 'function')
+  }
+
+  function packs() {
+    try {
+      const rows = service()?.packs?.()
+      return Array.isArray(rows) ? rows : []
+    } catch (error) {
+      logger?.warn?.(`讀取 dsh-meme 圖庫失敗：${error?.message || error}`)
+      return []
+    }
+  }
+
+  function search({ query = '', tag = '', limit = 8 } = {}) {
+    try {
+      const result = service()?.search?.({ query, tag, limit })
+      if (result && Array.isArray(result.memes)) return result
+      return { ok: false, memes: [] }
+    } catch (error) {
+      logger?.warn?.(`搜尋 dsh-meme 圖庫失敗：${error?.message || error}`)
+      return { ok: false, memes: [] }
+    }
+  }
+
+  function pick({ query = '', tag = '', limit = 8 } = {}) {
+    try {
+      const result = service()?.pick?.({ query, tag, limit })
+      if (result && result.ok && result.path) return result
+      return result && typeof result === 'object' ? result : { ok: false }
+    } catch (error) {
+      logger?.warn?.(`挑選 dsh-meme 圖片失敗：${error?.message || error}`)
+      return { ok: false, error: error?.message || String(error) }
+    }
+  }
+
+  const MOODS = ['happy', 'angry', 'sad', 'shy', 'confused', 'daily']
+
+  function sample({ limit = 16 } = {}) {
+    const seen = new Set()
+    const rows = []
+    for (const tag of MOODS) {
+      const result = search({ tag, limit: 4 })
+      for (const item of result.memes || []) {
+        const key = item.path || `${item.tag}:${item.caption}`
+        if (seen.has(key)) continue
+        seen.add(key)
+        rows.push(item)
+        if (rows.length >= limit) return rows
+      }
+    }
+    return rows
+  }
+
+  function stats() {
+    const rows = packs()
+    const count = rows.reduce((sum, pack) => sum + (Number(pack.count) || 0), 0)
+    return { available: available(), count, packs: rows }
+  }
+
+  return { available, packs, search, pick, sample, stats }
+}

package/lib/nudge.mjs

@@ -1,7 +1,7 @@
 // 大肥魚主動傳訊排程。執行在 host 裡（不用 launchd），所有參數都由面板調整：
 // 機率、間隔、每日/每月上限、安靜時段、冷卻時間、指定對象；每次真的送出才記帳。
 const DEFAULT_PROMPT =
-  '（主動傳訊）現在輪到你主動找對方說話。用一兩句自然、像訊息的短句開場，不要提「系統」「排程」「AI」這些字，也不要複製你之前說過的話。如果你判斷現在不適合打擾，只輸出 SKIP。'
+  '（主動傳訊）現在輪到你主動找對方說話。用一兩句自然、像訊息的短句開場，不要提「系統」「排程」「AI」這些字，也不要複製你之前說過的話。如果氣氛合適，可以在句子後面加 [[meme:#編號]] 配一張圖（編號照 context 裡的圖庫清單），不適合就純文字。如果你判斷現在不適合打擾，只輸出 SKIP。'
 
 export function createNudgeScheduler({ getConfig, store, logger, runTurn, sendProactive }) {
   let timer = null

package/lib/stickers.mjs

@@ -0,0 +1,160 @@
+// 表情包圖庫：把使用者上傳的圖片存到 <dataDir>/stickers，
+// 回覆時由角色用 [[sticker:名稱]] 標記挑一張，再由 host 轉成 LINE image message。
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
+import { randomBytes } from 'node:crypto'
+import path from 'node:path'
+import { readJsonSafe, writeJsonAtomic } from './util.mjs'
+
+const MAX_BYTES = 5 * 1024 * 1024
+const MAX_NAME = 40
+const MAX_DESC = 160
+
+function sniff(buffer) {
+  if (buffer.length >= 8 && buffer[0] === 0x89 && buffer[1] === 0x50 && buffer[2] === 0x4e && buffer[3] === 0x47) {
+    const width = buffer.readUInt32BE(16)
+    const height = buffer.readUInt32BE(20)
+    return { mime: 'image/png', ext: 'png', width, height }
+  }
+  if (buffer.length >= 3 && buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff) {
+    return { mime: 'image/jpeg', ext: 'jpg', ...jpegSize(buffer) }
+  }
+  return null
+}
+
+function jpegSize(buffer) {
+  let offset = 2
+  while (offset + 9 < buffer.length) {
+    if (buffer[offset] !== 0xff) {
+      offset += 1
+      continue
+    }
+    const marker = buffer[offset + 1]
+    const length = buffer.readUInt16BE(offset + 2)
+    if (marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc) {
+      return { height: buffer.readUInt16BE(offset + 5), width: buffer.readUInt16BE(offset + 7) }
+    }
+    offset += 2 + length
+  }
+  return { width: 0, height: 0 }
+}
+
+function decodeBase64(input) {
+  const text = String(input || '')
+  const comma = text.indexOf(',')
+  const payload = text.startsWith('data:') && comma >= 0 ? text.slice(comma + 1) : text
+  if (!payload) throw new Error('沒有收到圖片內容')
+  const buffer = Buffer.from(payload.replace(/\s+/g, ''), 'base64')
+  if (buffer.length === 0) throw new Error('圖片解碼後是空的')
+  return buffer
+}
+
+export function createStickerStore({ dir, logger }) {
+  const baseDir = path.join(dir, 'stickers')
+  const indexFile = path.join(baseDir, 'index.json')
+  let cache = null
+
+  function ensureDir() {
+    if (!existsSync(baseDir)) mkdirSync(baseDir, { recursive: true })
+  }
+
+  function load() {
+    if (cache) return cache
+    const raw = readJsonSafe(indexFile, { version: 1, items: [] })
+    const items = Array.isArray(raw?.items) ? raw.items.filter((item) => item && item.id && item.file) : []
+    cache = { version: 1, items }
+    return cache
+  }
+
+  function save(store) {
+    ensureDir()
+    writeJsonAtomic(indexFile, store)
+    cache = store
+  }
+
+  function list() {
+    return load().items.map((item) => ({ ...item }))
+  }
+
+  function get(idOrName) {
+    const key = String(idOrName || '').trim().toLowerCase()
+    if (!key) return null
+    return load().items.find((item) => item.id.toLowerCase() === key || item.name.toLowerCase() === key) || null
+  }
+
+  function filePath(entry) {
+    return path.join(baseDir, entry.file)
+  }
+
+  function readFile(entry) {
+    try {
+      return readFileSync(filePath(entry))
+    } catch {
+      return null
+    }
+  }
+
+  function uniqueName(name, ignoreId) {
+    const wanted = String(name || '').trim().slice(0, MAX_NAME) || 'sticker'
+    const taken = new Set(load().items.filter((item) => item.id !== ignoreId).map((item) => item.name.toLowerCase()))
+    if (!taken.has(wanted.toLowerCase())) return wanted
+    let index = 2
+    while (taken.has(`${wanted}-${index}`.toLowerCase())) index += 1
+    return `${wanted}-${index}`
+  }
+
+  function add({ name, description, dataUrl }) {
+    const buffer = decodeBase64(dataUrl)
+    if (buffer.length > MAX_BYTES) throw new Error(`圖片太大（${Math.round(buffer.length / 1024)} KB），上限 5 MB`)
+    const info = sniff(buffer)
+    if (!info) throw new Error('只接受 PNG 或 JPEG 圖片')
+    ensureDir()
+    const id = randomBytes(4).toString('hex')
+    const file = `${id}.${info.ext}`
+    writeFileSync(path.join(baseDir, file), buffer)
+    const entry = {
+      id,
+      name: uniqueName(name),
+      description: String(description || '').trim().slice(0, MAX_DESC),
+      mime: info.mime,
+      file,
+      bytes: buffer.length,
+      width: info.width || 0,
+      height: info.height || 0,
+      createdAt: Date.now(),
+    }
+    const store = load()
+    save({ version: 1, items: [entry, ...store.items] })
+    logger?.info?.(`表情包已加入：${entry.name}（${Math.round(buffer.length / 1024)} KB）`)
+    return { ...entry }
+  }
+
+  function update(id, patch = {}) {
+    const store = load()
+    const entry = store.items.find((item) => item.id === id)
+    if (!entry) throw new Error('找不到這個表情包')
+    if (patch.name !== undefined) entry.name = uniqueName(patch.name, entry.id)
+    if (patch.description !== undefined) entry.description = String(patch.description || '').trim().slice(0, MAX_DESC)
+    save({ version: 1, items: store.items })
+    return { ...entry }
+  }
+
+  function remove(id) {
+    const store = load()
+    const entry = store.items.find((item) => item.id === id)
+    if (!entry) throw new Error('找不到這個表情包')
+    try {
+      rmSync(filePath(entry), { force: true })
+    } catch (error) {
+      logger?.warn?.(`刪除表情包檔案失敗：${error?.message || error}`)
+    }
+    save({ version: 1, items: store.items.filter((item) => item.id !== id) })
+    return { id: entry.id, name: entry.name, removed: true }
+  }
+
+  function stats() {
+    const items = load().items
+    return { dir: baseDir, indexFile, count: items.length, bytes: items.reduce((sum, item) => sum + (Number(item.bytes) || 0), 0) }
+  }
+
+  return { list, get, add, update, remove, readFile, filePath, stats }
+}

package/lib/webhook-server.mjs

@@ -17,7 +17,7 @@ function verifySignature(secret, raw, signature) {
   }
 }
 
-export function createWebhookServer({ getConfig, logger, dispatch }) {
+export function createWebhookServer({ getConfig, logger, dispatch, getMedia }) {
   let server = null
   let port = 0
   let startedAt = 0
@@ -72,6 +72,22 @@ export function createWebhookServer({ getConfig, logger, dispatch }) {
       return
     }
 
+    if (req.method === 'GET' && url.pathname.startsWith('/media/')) {
+      const id = decodeURIComponent(url.pathname.slice('/media/'.length))
+      const media = typeof getMedia === 'function' ? await getMedia(id) : null
+      if (!media || !media.bytes) {
+        jsonFail(res, 'not found', 404)
+        return
+      }
+      res.writeHead(200, {
+        'content-type': media.mime || 'application/octet-stream',
+        'content-length': media.bytes.length,
+        'cache-control': 'public, max-age=300',
+      })
+      res.end(media.bytes)
+      return
+    }
+
     if (url.pathname !== '/webhook') {
       jsonFail(res, 'not found', 404)
       return

package/package.json

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