dsh-line-bot 0.2.2 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.3.0
+
+- 新增「個人記憶」：每位使用者一份長期記憶（`<DSH_HOME>/line-bot/memories.json`），角色可在對話中自己呼叫 `line_memory_add` 記下重要資訊、用 `line_memory_forget` 忘掉、用 `line_memory_list` 確認。
+- 有期限的記憶可帶 `ttlDays`，到期由排程自動刪除；每天（預設 4 點，面板可調）角色會自己整理一次，清掉過期或不再成立的內容。
+- 每輪只注入最近 N 筆／限量字元；面板「個人記憶」卡可查看、刪除、立即清理、立即整理，並調整每人上限與每日整理時間。
+- README 五種語言補上個人記憶說明。
+
 ## 0.2.1
 
 - 新增「DeepSeek 餘額」：每輪把錢包餘額放進角色背景資訊；低於門檻時由角色用自己的語氣主動提醒儲值（冷卻、靜音時段、可在面板調整）。

package/README.en.md

@@ -71,6 +71,8 @@ At the top of the panel is a **sticky save bar**: "Save changes / Refresh" stays
 | Section | Contents |
 | --- | --- |
 | Overview | Green-light status for webhook server / tunnel / LINE / persona / proactive messages, public URL, one-click bring-up and start/stop |
+| DeepSeek balance | Current balance, per-turn context, low-balance proactive reminder, threshold and cooldown |
+| Personal memory | Per-user long-term memory, expiry cleanup, daily self-review, manual delete |
 | LINE credentials | Channel ID, Channel Secret, Access Token, auto-issue, loading animation, bot info, webhook apply/test, allow-list |
 | Cloudflare Tunnel | quick / API token modes, token, hostname, tunnel name, Account/Zone ID, download cloudflared, start/stop, auto-configure webhook, bring your own public URL |
 | 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 |
@@ -141,6 +143,16 @@ The **DeepSeek balance** card reads the wallet balance of the DeepSeek account D
 - Requires DSH to be signed in to a DeepSeek account (deepseek-account). If it is not, the card explains why and everything else keeps working.
 - The threshold is money, not tokens: Platform shows a wallet balance, and token conversion varies by model and cache hits.
 
+## Personal memory
+
+The character keeps its own memory at `<DSH_HOME>/line-bot/memories.json`, separated per user:
+
+- When something important comes up (preferences, current situation, promises, notable events), it saves it with `line_memory_add` on its own.
+- Time-limited items (exams, trips, short-term situations) can carry an expiry date and are deleted automatically; you can also just tell it to forget something.
+- Once a day (4 AM by default, configurable in the panel) it reviews the list and removes expired items, one-off events that are over, or facts that no longer hold.
+- 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.
 ## 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

@@ -71,6 +71,8 @@ dsh plugin --profile desktop add dsh-line-bot
 | セクション | 内容 |
 | --- | --- |
 | 概要 | webhook サーバー／トンネル／LINE／ペルソナ／自発メッセージの状態、公開 URL、ワンクリック起動と停止 |
+| DeepSeek 残高 | 現在の残高、毎ターンの注入、残高が少ないときの主動リマインド、しきい値とクールダウン |
+| 個人メモリ | ユーザーごとの長期記憶、期限切れの自動削除、毎日の自己整理、手動削除 |
 | LINE 認証情報 | Channel ID、Channel Secret、Access Token、自動発行、ローディング表示、bot 情報、webhook の適用／テスト、許可リスト |
 | Cloudflare Tunnel | quick／API トークンモード、トークン、hostname、トンネル名、Account／Zone ID、cloudflared のダウンロード、起動／停止、webhook 自動設定、独自の公開 URL |
 | 返信ペルソナ | ペルソナ選択（大肥魚またはプラグインのカスタム）、カスタムペルソナの追加・編集・削除、現在のペルソナをカスタムに複製、強制適用、ユーザーによる切り替え許可、大肥魚を session モードに切り替え、Agent 返信のテスト |
@@ -141,6 +143,16 @@ dsh plugin --profile desktop add dsh-line-bot
 - DSH が DeepSeek アカウントにログインしている必要があります。未ログインの場合はカードに理由が表示され、他の機能はそのまま使えます。
 - しきい値は金額であって token 数ではありません。
 
+## 個人メモリ
+
+キャラクターは自分用のメモリを `<DSH_HOME>/line-bot/memories.json` に持ち、ユーザーごとに分けて保存します：
+
+- 好み、近況、約束、重要な出来事など、あとで必要になりそうな情報は `line_memory_add` で自分から記録します。
+- 期限のあるもの（試験、旅行、短期の状況）は期限日を付けられ、期限が来ると自動で削除されます。「忘れて」と言えば削除します。
+- 毎日（既定は午前 4 時、パネルで変更可）一度見直し、期限切れ・終わった一度きりの出来事・もう成り立たない内容を削除します。
+- 毎ターンは直近 N 件（既定 20 件・2000 文字）だけを注入し、残りはファイルに残します。1 人あたりの上限は既定 120 件で、超えると古いものから消えます。
+- パスワード、token、身分証番号などの機密情報は記録しません。
+- パネルの「個人メモリ」カードで、記録内容の確認、手動削除、期限切れの一括削除、今すぐの見直しができます。
 ## トラブルシューティング
 
 - **パネルに「LINE Bot ランタイムに接続できません」と出る**：webServer がまだ準備できていない可能性があります。再読み込みしてください。それでも失敗する場合は DSH ログの `[line-bot]` を確認します。

package/README.ko.md

@@ -71,6 +71,8 @@ dsh plugin --profile desktop add dsh-line-bot
 | 섹션 | 내용 |
 | --- | --- |
 | 개요 | webhook 서버／터널／LINE／페르소나／능동 메시지 상태, 공개 URL, 원클릭 기동과 시작/중지 |
+| DeepSeek 잔액 | 현재 잔액, 매 턴 주입, 잔액이 적을 때 캐릭터가 먼저 알림, 기준 금액과 쿨다운 |
+| 개인 기억 | 사용자별 장기 기억, 만료 자동 삭제, 매일 자기 정리, 수동 삭제 |
 | LINE 자격 증명 | Channel ID, Channel Secret, Access Token, 자동 발급, 로딩 표시, bot 정보, webhook 적용/테스트, 허용 목록 |
 | Cloudflare Tunnel | quick／API 토큰 모드, 토큰, hostname, 터널 이름, Account／Zone ID, cloudflared 다운로드, 시작/중지, webhook 자동 설정, 직접 제공하는 공개 URL |
 | 답장 페르소나 | 페르소나 선택(大肥魚 또는 플러그인 커스텀), 커스텀 페르소나 추가/편집/삭제, 현재 페르소나를 커스텀으로 복사, 강제 적용, 사용자 직접 전환 허용, 大肥魚를 session 모드로 전환, Agent 답장 테스트 |
@@ -141,6 +143,16 @@ dsh plugin --profile desktop add dsh-line-bot
 - DSH가 DeepSeek 계정(deepseek-account)에 로그인되어 있어야 합니다. 아니면 카드에 이유가 표시되며 다른 기능은 그대로 동작합니다.
 - 기준값은 금액이며 token 수가 아닙니다.
 
+## 개인 기억
+
+캐릭터는 `<DSH_HOME>/line-bot/memories.json`에 자기 기억을 저장하며, 사용자별로 분리됩니다:
+
+- 선호, 근황, 약속, 중요한 사건처럼 나중에 쓸 만한 정보는 `line_memory_add`로 스스로 기록합니다.
+- 기한이 있는 일(시험, 여행, 단기 상황)은 만료일을 붙일 수 있고, 기한이 지나면 자동으로 삭제됩니다. "잊어줘"라고 하면 지웁니다.
+- 매일(기본 새벽 4시, 패널에서 변경 가능) 한 번 정리하며, 만료된 항목·끝난 일회성 사건·더 이상 맞지 않는 내용을 삭제합니다.
+- 매 턴에는 최근 N개(기본 20개·2000자)만 주입하고 나머지는 파일에 남깁니다. 사용자당 상한은 기본 120개이며, 넘으면 오래된 것부터 지웁니다.
+- 비밀번호, token, 신분증 번호 같은 민감 정보는 기록하지 않습니다.
+- 패널의 "개인 기억" 카드에서 기록 내용 확인, 수동 삭제, 만료 일괄 정리, 지금 정리를 할 수 있습니다.
 ## 문제 해결
 
 - **패널에 "LINE Bot 런타임에 연결할 수 없습니다"**: webServer가 아직 준비되지 않았을 수 있습니다. 새로 고침하세요. 그래도 실패하면 DSH 로그의 `[line-bot]` 메시지를 확인합니다.

package/README.md

@@ -71,6 +71,8 @@ dsh plugin --profile desktop add dsh-line-bot
 | 區塊 | 內容 |
 | --- | --- |
 | 狀態總覽 | webhook server／隧道／LINE／人設／主動傳訊的綠燈狀態、公開網址、一鍵上線與啟停 |
+| DeepSeek 餘額 | 目前餘額、每輪注入、低於門檻時由角色主動提醒、提醒門檻與冷卻 |
+| 個人記憶 | 每位使用者分開的長期記憶、到期自動刪、每日請角色整理、手動刪除 |
 | LINE 憑證 | Channel ID、Channel Secret、Access Token、自動簽發、loading 動畫、bot 資訊、webhook 套用／測試、白名單 |
 | Cloudflare Tunnel | quick／API Token 模式、Token、hostname、隧道名稱、Account／Zone ID、下載 cloudflared、啟停、自動設定 webhook、自行提供的公開網址 |
 | 回覆人設 | 選擇人設（大肥魚或插件自訂）、新增／編輯／刪除自訂人設、把目前人設複製成自訂、強制套用、允許使用者自己換人設、切換大肥魚 session 模式、測試 Agent 回覆 |
@@ -141,6 +143,16 @@ dsh plugin --profile desktop add dsh-line-bot
 - 需要 DSH 已登入 DeepSeek 帳號（deepseek-account）。沒登入或該 profile 沒掛這個服務時，卡片會顯示原因，其餘功能不受影響。
 - 門檻用的是錢包金額，不是 token 數：DeepSeek 平台顯示的是金額，token 換算會隨模型與快取變動。
 
+## 個人記憶
+
+角色有一份自己的記憶，存在 `<DSH_HOME>/line-bot/memories.json`，每位使用者分開：
+
+- 對話中出現它覺得重要的資訊（喜好、近況、承諾、重要事件），它會自己用 `line_memory_add` 記下來，不用你交代。
+- 有期限的事（考試、旅行、短期狀況）可以標到期日，時間到自動刪除；你也可以直接叫它「忘掉這件事」。
+- 每天（預設凌晨 4 點，面板可改）它會自己整理一次：把過期、一次事件已結束、或明顯不再成立的記憶刪掉。
+- 每輪只帶入最近的 N 筆（預設 20 筆、2000 字），其餘仍留在檔案裡；每人上限預設 120 筆，超過時刪最舊的。
+- 密碼、token、證件號等敏感資料不該叫它記，它也會避免。
+- 面板的「個人記憶」卡可以看目前記了什麼、手動刪除、立即清理到期、或現在就叫它整理一次。
 ## 疑難排解
 
 - **面板顯示「無法連線到 LINE Bot 執行期」**：webServer 可能還沒就緒，重新整理即可；仍失敗就看 DSH 日誌裡 `[line-bot]` 的訊息。

package/README.zh-CN.md

@@ -71,6 +71,8 @@ dsh plugin --profile desktop add dsh-line-bot
 | 区块 | 内容 |
 | --- | --- |
 | 状态总览 | webhook server／隧道／LINE／人设／主动传讯的绿灯状态、公开网址、一键上线与启停 |
+| DeepSeek 余额 | 当前余额、每轮注入、低于门槛时由角色主动提醒、提醒门槛与冷却 |
+| 个人记忆 | 每位用户分开的长期记忆、到期自动删除、每日请角色整理、手动删除 |
 | LINE 凭证 | Channel ID、Channel Secret、Access Token、自动签发、loading 动画、bot 信息、webhook 套用／测试、白名单 |
 | Cloudflare Tunnel | quick／API Token 模式、Token、hostname、隧道名称、Account／Zone ID、下载 cloudflared、启停、自动设置 webhook、自行提供的公开网址 |
 | 回复人设 | 选择人设（大肥鱼或插件自定义）、新增／编辑／删除自定义人设、把目前人设复制成自定义、强制套用、允许用户自己换人设、切换大肥鱼 session 模式、测试 Agent 回复 |
@@ -141,6 +143,16 @@ dsh plugin --profile desktop add dsh-line-bot
 - 需要 DSH 已登录 DeepSeek 账号（deepseek-account）。未登录或该 profile 没有这个服务时，卡片会说明原因，其他功能不受影响。
 - 门槛用的是钱包金额，不是 token 数。
 
+## 个人记忆
+
+角色有一份自己的记忆，保存在 `<DSH_HOME>/line-bot/memories.json`，每位用户分开：
+
+- 对话中出现它觉得重要的信息（喜好、近况、承诺、重要事件），它会自己用 `line_memory_add` 记下来，不用你交代。
+- 有期限的事（考试、旅行、短期状况）可以标到期日，时间到自动删除；你也可以直接叫它「忘掉这件事」。
+- 每天（默认凌晨 4 点，面板可改）它会自己整理一次：把过期、一次性事件已结束、或明显不再成立的记忆删掉。
+- 每轮只带入最近的 N 笔（默认 20 笔、2000 字），其余仍留在文件里；每人上限默认 120 笔，超过时删除最旧的。
+- 密码、token、证件号等敏感资料不该叫它记，它也会避免。
+- 面板的「个人记忆」卡可以看目前记了什么、手动删除、立即清理到期、或现在就叫它整理一次。
 ## 疑难排解
 
 - **面板显示「无法连接到 LINE Bot 运行时」**：webServer 可能还没就绪，刷新即可；仍失败就看 DSH 日志里 `[line-bot]` 的消息。

package/client.js

@@ -14,6 +14,7 @@ window.__ModuleLoader__.load({
     const NAV = [
       { key: 'overview', label: '狀態總覽' },
       { key: 'balance', label: 'DeepSeek 餘額' },
+      { key: 'memory', label: '個人記憶' },
       { key: 'line', label: 'LINE 憑證' },
       { key: 'tunnel', label: 'Cloudflare' },
       { key: 'persona', label: '回覆人設' },
@@ -293,6 +294,10 @@ window.__ModuleLoader__.load({
       'persona-mode': '切換人設模式',
       'tieba-preview': '預覽貼吧同步差異',
       'balance-refresh': '查詢 DeepSeek 餘額',
+      'memory-list': '讀取個人記憶',
+      'memory-delete': '刪除記憶',
+      'memory-prune': '清理到期記憶',
+      'memory-review': '請角色整理記憶',
       'balance-ask': '餘額提醒',
       'tieba-sync': '同步貼吧學習',
       'local-persona-list': '讀取自訂人設',
@@ -317,6 +322,7 @@ window.__ModuleLoader__.load({
       const [active, setActive] = useState('overview')
       const [syncPreview, setSyncPreview] = useState(null)
       const [balancePreview, setBalancePreview] = useState(null)
+      const [memoryData, setMemoryData] = useState(null)
       const [localEdit, setLocalEdit] = useState({ id: '', name: '', text: '' })
 
       const dirty = useMemo(() => {
@@ -436,6 +442,50 @@ window.__ModuleLoader__.load({
         await act('balance-ask', { dryRun: false, force: true })
       }
 
+      async function loadMemory({ quiet = false } = {}) {
+        if (!quiet) setBusy('memory-list')
+        try {
+          if (dirty && !quiet) await persist(false)
+          const value = await jpost('/action', { action: 'memory-list', payload: {} })
+          if (value?.status) {
+            setStatus(value.status)
+            setDraft(stripSecrets(value.status.config))
+          }
+          setMemoryData(value?.result || null)
+        } catch (err) {
+          if (!quiet) setToast({ kind: 'error', text: '讀取記憶失敗：' + (err.message || err) })
+        } finally {
+          if (!quiet) setBusy('')
+        }
+      }
+
+      async function removeMemory(userId, entry) {
+        setBusy('memory-delete')
+        try {
+          const value = await jpost('/action', { action: 'memory-delete', payload: { userId, id: entry.id } })
+          if (value?.status) {
+            setStatus(value.status)
+            setDraft(stripSecrets(value.status.config))
+          }
+          await loadMemory({ quiet: true })
+          setToast({ kind: 'ok', text: '已刪掉一筆記憶。' })
+        } catch (err) {
+          setToast({ kind: 'error', text: '刪除記憶失敗：' + (err.message || err) })
+        } finally {
+          setBusy('')
+        }
+      }
+
+      async function runMemory(action) {
+        await act(action)
+        await loadMemory({ quiet: true })
+      }
+
+      useEffect(() => {
+        loadMemory({ quiet: true })
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+      }, [])
+
       async function previewSync() {
         setBusy('tieba-preview')
         setToast(null)
@@ -566,6 +616,9 @@ window.__ModuleLoader__.load({
       const balanceStatus = status.balance || {}
       const balanceSymbol = balanceStatus.cny ? '¥' : balanceStatus.usd ? '$' : '¥'
       const balanceTotal = balanceStatus.cny ? balanceStatus.cny.total : balanceStatus.usd ? balanceStatus.usd.total : null
+      const memoryCfg = cfg.memory || {}
+      const memoryStatus = status.memory || {}
+      const memoryUsers = memoryData?.users || []
       const syncStats = status.sync || {}
       const runtime = status
       const persona = status.persona || {}
@@ -705,6 +758,53 @@ window.__ModuleLoader__.load({
           balancePreview && balancePreview.text ? h('div', { style: S.panelBox }, h('div', { style: S.fieldTitle }, '角色會傳這則：'), h('pre', { style: S.pre }, balancePreview.text)) : null,
         ),
 
+        // 1.6 個人記憶
+        h(
+          Card,
+          {
+            id: sectionDomId('memory'),
+            title: '個人記憶',
+            desc: '每位使用者分開。角色覺得重要的事會自己記下來；有期限的到期自動刪，每天也會請角色自己整理一次。',
+            right: h(Btn, { onClick: () => loadMemory(), disabled: !!busy }, busy === 'memory-list' ? '讀取中…' : '重新整理'),
+          },
+          h('div', { style: S.row },
+            h(Badge, { ok: memoryStatus.enabled !== false }, '共 ' + (memoryStatus.total || 0) + ' 筆'),
+            h(Badge, { ok: memoryCfg.reviewDaily !== false }, '每日整理：' + (memoryCfg.reviewDaily !== false ? (Number(memoryCfg.reviewHour) || 0) + ' 點' : '關閉')),
+            h(Badge, { ok: true }, '到期自動刪'),
+          ),
+          h(KV, { rows: [
+            ['上次清理', memoryStatus.lastPruneAt ? fmtTime(memoryStatus.lastPruneAt) : '還沒清過'],
+            ['上次角色整理', memoryStatus.lastReviewAt ? fmtTime(memoryStatus.lastReviewAt) : '還沒整理過'],
+            ['記憶檔', memoryStatus.file || ''],
+          ] }),
+          h('div', { style: S.grid },
+            h(Field, { label: '每天整理時間（0–23 點）', hint: '由角色自己判斷哪幾筆該忘掉' }, h(Num, { value: memoryCfg.reviewHour, min: 0, max: 23, step: 1, onChange: (value) => update({ memory: { reviewHour: value } }) })),
+            h(Field, { label: '每輪最多帶入幾筆', hint: '其餘仍留在檔案裡' }, h(Num, { value: memoryCfg.injectMaxEntries, min: 1, max: 80, step: 1, onChange: (value) => update({ memory: { injectMaxEntries: value } }) })),
+            h(Field, { label: '每人上限（筆）', hint: '超過時刪最舊的' }, h(Num, { value: memoryCfg.maxPerUser, min: 10, max: 500, step: 10, onChange: (value) => update({ memory: { maxPerUser: value } }) })),
+            h(Field, { label: '帶入字數上限', hint: '避免佔用太多 prompt' }, h(Num, { value: memoryCfg.injectMaxChars, min: 200, max: 8000, step: 200, onChange: (value) => update({ memory: { injectMaxChars: value } }) })),
+          ),
+          h('div', { style: S.row },
+            h(Toggle, { checked: memoryCfg.enabled !== false, onChange: (value) => update({ memory: { enabled: value } }), label: '開啟個人記憶', hint: '關掉後角色不再記新的事情，也不會讀到舊的' }),
+            h(Toggle, { checked: memoryCfg.reviewDaily !== false, onChange: (value) => update({ memory: { reviewDaily: value } }), label: '每天請角色整理一次', hint: '清掉過期或不再成立的記憶' }),
+          ),
+          h('div', { style: S.row },
+            h(Btn, { onClick: () => runMemory('memory-prune'), disabled: !!busy }, busy === 'memory-prune' ? '清理中…' : '清理到期記憶'),
+            h(Btn, { onClick: () => runMemory('memory-review'), disabled: !!busy }, busy === 'memory-review' ? '整理中…' : '現在請角色整理'),
+          ),
+          memoryData
+            ? (memoryUsers.length === 0
+                ? h('div', { style: S.note }, '目前沒有任何記憶。角色在對話中覺得重要時，會自己記下來。')
+                : memoryUsers.map((row) => h('div', { key: row.userId, style: S.panelBox },
+                    h('div', { style: S.fieldTitle }, (row.displayName || row.userId) + '（' + row.entries.length + ' 筆）'),
+                    row.entries.map((entry) => h('div', { key: entry.id, style: { display: 'flex', gap: 8, alignItems: 'flex-start', padding: '6px 0', borderTop: '1px solid var(--dsw-alias-border-l2)' } },
+                      h('span', { style: { flex: '0 0 auto', fontSize: 11, color: 'var(--dsw-alias-label-tertiary)', paddingTop: 2 } }, ({ fact: '事實', event: '事件', preference: '喜好', inside: '默契' })[entry.kind] || entry.kind),
+                      h('span', { style: { flex: 1, fontSize: 13, lineHeight: 1.5 } }, entry.text, entry.expiresText ? h('span', { style: { color: 'var(--dsw-alias-label-tertiary)' } }, '（到 ' + String(entry.expiresText).slice(0, 10) + '）') : null),
+                      h(Btn, { tone: 'danger', onClick: () => removeMemory(row.userId, entry), disabled: !!busy }, '刪除'),
+                    )),
+                  )))
+            : h('div', { style: S.note }, '按「重新整理」讀取目前記住的內容。'),
+        ),
+
         // 2. LINE 憑證
         h(
           Card,

package/lib/agent-runner.mjs

@@ -80,7 +80,7 @@ export function createAgentRunner({ ctx, logger, getConfig }) {
 
   // 把「插件自己的人設」與「貼吧動態」掛進這個 agent 的 system prompt。
   // 自訂人設只有選了才注入；大肥魚的人設走它自己的 session 指定。
-  function agentSetup({ personaText, contextText }) {
+  function agentSetup({ personaText, contextText, tools = [] }) {
     return (agentCtx) => {
       try {
         const prompt = agentCtx?.systemPrompt
@@ -120,6 +120,17 @@ export function createAgentRunner({ ctx, logger, getConfig }) {
       } catch (error) {
         logger?.warn?.(`注入人設／貼吧動態失敗：${error?.message || error}`)
       }
+      if (Array.isArray(tools) && tools.length > 0) {
+        try {
+          const registry = agentCtx.get?.('tools') || agentCtx.tools
+          if (!registry?.register) throw new Error('這個 profile 沒有 tools 服務')
+          for (const spec of tools) {
+            agentCtx.effect(() => registry.register(spec), `line-bot: tool ${spec.name}`)
+          }
+        } catch (error) {
+          logger?.warn?.(`掛載記憶工具失敗：${error?.message || error}`)
+        }
+      }
     }
   }
 
@@ -161,7 +172,7 @@ export function createAgentRunner({ ctx, logger, getConfig }) {
     }
   }
 
-  async function turn({ sessionId, text, persona, personaClient, personaText, contextText, cwd: cwdOverride }) {
+  async function turn({ sessionId, text, persona, personaClient, personaText, contextText, tools = [], cwd: cwdOverride }) {
     const cfg = getConfig()
     const timeoutMs = cfg.agent.timeoutMs || 180000
     const { options } = agentOptions()
@@ -175,7 +186,7 @@ export function createAgentRunner({ ctx, logger, getConfig }) {
     let offEnd = null
 
     try {
-      const setup = personaText || contextText ? agentSetup({ personaText, contextText }) : undefined
+      const setup = personaText || contextText || tools.length > 0 ? agentSetup({ personaText, contextText, tools }) : undefined
       const opened = await openAgent(sessionId, options, cwd, setup)
       agent = opened.agent
       handle = opened.handle

package/lib/config.mjs

@@ -100,6 +100,16 @@ export const DEFAULT_CONFIG = {
     ask: true,
     cooldownHours: 12,
   },
+  memory: {
+    // 每位使用者各自的個人記憶：agent 覺得重要就自己記，有期限的到期自動刪。
+    enabled: true,
+    maxPerUser: 120,
+    injectMaxEntries: 20,
+    injectMaxChars: 2000,
+    // 背景每天檢查一次，請角色自己把過期／失效的記憶刪掉。
+    reviewDaily: true,
+    reviewHour: 4,
+  },
   log: {
     maxLines: 400,
   },
@@ -212,6 +222,14 @@ export function sanitizePatch(current, patch) {
   balance.threshold = clampFloat(balance.threshold, 0, 100000, 10)
   balance.cooldownHours = clampInt(balance.cooldownHours, 1, 168, 12)
 
+  const memory = next.memory || (next.memory = {})
+  memory.enabled = Boolean(memory.enabled)
+  memory.reviewDaily = Boolean(memory.reviewDaily)
+  memory.maxPerUser = clampInt(memory.maxPerUser, 10, 500, 120)
+  memory.injectMaxEntries = clampInt(memory.injectMaxEntries, 1, 80, 20)
+  memory.injectMaxChars = clampInt(memory.injectMaxChars, 200, 8000, 2000)
+  memory.reviewHour = clampInt(memory.reviewHour, 0, 23, 4)
+
   const nudge = next.nudge
   nudge.enabled = Boolean(nudge.enabled)
   nudge.chance = clampFloat(nudge.chance, 0, 1, 0.18)
@@ -291,6 +309,7 @@ export function normalizeState(raw) {
     users: isPlainObject(state.users) ? state.users : {},
     nudge: isPlainObject(state.nudge) ? state.nudge : {},
     balance: isPlainObject(state.balance) ? state.balance : {},
+    memory: isPlainObject(state.memory) ? state.memory : {},
     sync: isPlainObject(state.sync) ? state.sync : {},
     webhook: isPlainObject(state.webhook) ? state.webhook : null,
     lastEventAt: Number(state.lastEventAt) || 0,

package/lib/host.mjs

@@ -19,6 +19,7 @@ const tiebaSyncMod = await import(withVersion('./tieba-sync.mjs'))
 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 utilMod = await import(withVersion('./util.mjs'))
 const { createConfigStore, publicConfig, dataDir } = configMod
 const { createPersonaClient } = personaMod
@@ -30,9 +31,10 @@ const { createTiebaSync, reloadPersonaPlugin } = tiebaSyncMod
 const { createLocalPersonas, LOCAL_PREFIX } = localPersonasMod
 const { buildTiebaContext } = tiebaContextMod
 const { createBalanceMonitor } = balanceMod
+const { createMemoryStore } = memoryMod
 const { chunkText, clip, inQuietWindow, jsonFail, jsonOk, maskSecret, readJsonBody } = utilMod
 
-export const VERSION = '0.1.0'
+export const VERSION = '0.3.0'
 
 // 環境變數提供的 Cloudflare API Token（方便用 shell 注入、不用把 token 寫進設定檔）。
 // 設定檔裡的 token 優先；兩者都沒有時才用環境變數。
@@ -168,6 +170,8 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
   // ── DeepSeek 餘額 ───────────────────────────────────────────────────────
   const balance = createBalanceMonitor({ ctx, logger })
   let balanceTimer = null
+  const memory = createMemoryStore({ dir, logger, getConfig: () => store.get() })
+  let memoryTimer = null
 
   function balanceView() {
     const cached = balance.get()
@@ -193,8 +197,38 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
     return lines.join('\n')
   }
 
-  function agentContextText() {
-    return [tiebaContextText(), balanceContextText()].filter(Boolean).join('\n\n')
+  function memoryRulesText() {
+    if (store.get().memory?.enabled === false) return ''
+    return [
+      '【個人記憶】你有一份自己的記憶（每位使用者分開）。',
+      '對話中若出現你覺得重要、之後還會用到的資訊（喜好、近況、承諾、重要事件），馬上用 line_memory_add 記下來，不用等對方交代。',
+      '一次只記一件事；如果同時有兩三件重要的事，就分開呼叫兩三次，不要合併成一段。',
+      '有期限的事（考試、旅行、短期的狀況）請填 ttlDays，到期會自動刪掉；一次性閒聊不要記。',
+      '使用者要你忘掉某件事時，用 line_memory_forget 刪掉；想確認自己記了什麼就用 line_memory_list。',
+      '很重要：只有真的呼叫了工具才算記住。沒呼叫就不要說「記好了」；使用者明確要你記住時，先呼叫工具再回覆。',
+      '不要記密碼、token、證件號等敏感資料，也不要在回覆裡提到這些工具或「記憶系統」。',
+    ].join('\n')
+  }
+
+  function memoryContextText(userId) {
+    if (!userId) return ''
+    const rules = memoryRulesText()
+    const remembered = memory.formatForContext(userId)
+    return [rules, remembered].filter(Boolean).join('\n\n')
+  }
+
+  function memoryToolsFor(userId) {
+    if (!userId || store.get().memory?.enabled === false) return []
+    try {
+      return memory.toolsFor(userId)
+    } catch (error) {
+      logger.warn('準備記憶工具失敗：' + errorText(error))
+      return []
+    }
+  }
+
+  function agentContextText(userId) {
+    return [tiebaContextText(), balanceContextText(), memoryContextText(userId)].filter(Boolean).join('\n\n')
   }
 
   async function refreshBalance() {
@@ -269,6 +303,94 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
     }
   }
 
+  // ── 個人記憶：清理與每日整理 ────────────────────────────────────────────
+  function pruneMemories() {
+    try {
+      const out = memory.prune()
+      if (out.removed > 0) logger.info('個人記憶：清理 ' + out.removed + ' 筆到期項目')
+      return out
+    } catch (error) {
+      logger.warn('清理個人記憶失敗：' + errorText(error))
+      return { removed: 0, error: errorText(error) }
+    }
+  }
+
+  async function reviewMemories({ userId = '' } = {}) {
+    const cfg = store.get()
+    if (cfg.memory?.enabled === false) return { skipped: 'disabled' }
+    const state = store.getState()
+    const targets = userId
+      ? [[userId, state.users?.[userId]]]
+      : Object.entries(state.users || {})
+    const reviewed = []
+    for (const [id, user] of targets) {
+      if (!user?.sessionId) continue
+      const entries = memory.list(id)
+      if (entries.length === 0) continue
+      const selection = cfg.persona.enforce ? user.personaId || cfg.persona.id : ''
+      const applied = await applyPersonaSelection(selection, user.sessionId)
+      const lines = entries.map((entry) => {
+        const created = new Date(entry.createdAt).toISOString().slice(0, 10)
+        const until = entry.expiresAt ? '，' + new Date(entry.expiresAt).toISOString().slice(0, 10) + ' 失效' : ''
+        return '- ' + entry.id + ' [' + entry.kind + '] ' + entry.text + '（' + created + until + '）'
+      })
+      const promptText = [
+        '（這是系統提供的背景整理，不是主人說的話）請你檢查自己對這位使用者的記憶。',
+        '目前的記憶：',
+        ...lines,
+        '把已經過期、一次事件已結束、或明顯不再成立的，用 line_memory_forget 刪掉；其餘保留。',
+        '不要輸出給主人看的訊息，只呼叫工具，最後回一個 OK。',
+      ].join('\n')
+      try {
+        await runner.turn({
+          sessionId: user.sessionId,
+          text: promptText,
+          persona: applied.persona,
+          personaText: applied.personaText,
+          personaClient: persona(),
+          contextText: '',
+          tools: memoryToolsFor(id),
+          cwd: ensureUserWorkspace(id) || undefined,
+        })
+        reviewed.push({ userId: id, entries: entries.length })
+      } catch (error) {
+        logger.warn('整理 ' + id + ' 的記憶失敗：' + errorText(error))
+      }
+    }
+    store.updateState((current) => ({ ...current, memory: { ...(current.memory || {}), lastReviewAt: Date.now() } }))
+    logger.info('個人記憶：整理完成，檢查 ' + reviewed.length + ' 位使用者')
+    return { reviewed: reviewed.length, users: reviewed }
+  }
+
+  function maybeDailyMemoryReview() {
+    const cfg = store.get()
+    if (cfg.memory?.enabled === false || cfg.memory?.reviewDaily === false) return
+    const hour = Number(cfg.memory?.reviewHour)
+    const wantedHour = Number.isFinite(hour) ? Math.max(0, Math.min(23, Math.round(hour))) : 4
+    const now = new Date()
+    if (now.getHours() !== wantedHour) return
+    const lastReviewAt = Number(store.getState().memory?.lastReviewAt) || 0
+    if (lastReviewAt && now.getTime() - lastReviewAt < 20 * 3600_000) return
+    reviewMemories().catch((error) => logger.warn('每日記憶整理失敗：' + errorText(error)))
+  }
+
+  function startMemoryWatch() {
+    stopMemoryWatch()
+    pruneMemories()
+    memoryTimer = setInterval(() => {
+      pruneMemories()
+      maybeDailyMemoryReview()
+    }, 10 * 60_000)
+    memoryTimer.unref?.()
+  }
+
+  function stopMemoryWatch() {
+    if (memoryTimer) {
+      clearInterval(memoryTimer)
+      memoryTimer = null
+    }
+  }
+
   // ── LINE 憑證 ────────────────────────────────────────────────────────────
   async function getToken({ force = false } = {}) {
     const cfg = store.get()
@@ -684,7 +806,8 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
         persona: applied.persona,
         personaText: applied.personaText,
         personaClient: persona(),
-        contextText: agentContextText(),
+        contextText: agentContextText(userId),
+        tools: memoryToolsFor(userId),
         cwd: ensureUserWorkspace(userId) || cfg.agent.cwd || undefined,
       })
       let replyText = String(result?.text || '').trim()
@@ -759,7 +882,8 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
         persona: applied.persona,
         personaText: applied.personaText,
         personaClient: persona(),
-        contextText: agentContextText(),
+        contextText: agentContextText(owner?.[0]),
+        tools: memoryToolsFor(owner?.[0]),
         cwd: owner ? ensureUserWorkspace(owner[0]) : undefined,
       })
     },
@@ -848,6 +972,7 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
     nudge.start()
     tiebaSync.start()
     startBalanceWatch()
+    startMemoryWatch()
     store.updateState((state) => ({ ...state, lastStartAt: Date.now() }))
     if (cfg.line.channelId && cfg.line.channelSecret) refreshBotInfo().catch(() => {})
     return buildStatus()
@@ -856,6 +981,7 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
   async function stopAll() {
     stopWebhookGuard()
     stopBalanceWatch()
+    stopMemoryWatch()
     nudge.stop()
     tiebaSync.stop()
     await tunnel.stop({ silent: true }).catch(() => {})
@@ -936,6 +1062,16 @@ 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)),
       },
+      memory: {
+        ...memory.stats(),
+        enabled: cfg.memory?.enabled !== false,
+        reviewDaily: cfg.memory?.reviewDaily !== false,
+        reviewHour: Number(cfg.memory?.reviewHour) || 0,
+        maxPerUser: Number(cfg.memory?.maxPerUser) || 120,
+        injectMaxEntries: Number(cfg.memory?.injectMaxEntries) || 20,
+        injectMaxChars: Number(cfg.memory?.injectMaxChars) || 2000,
+        lastReviewAt: Number(state.memory?.lastReviewAt) || 0,
+      },
       sync: { ...tiebaSync.stats(), config: cfg.sync },
       users,
       logs: logger.lines(),
@@ -1096,6 +1232,37 @@ 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 'memory-list': {
+        const only = String(payload.userId || '').trim()
+        const state = store.getState()
+        const rows = Object.entries(state.users || {})
+          .filter(([userId]) => !only || userId === only)
+          .map(([userId, user]) => ({
+            userId,
+            displayName: user?.displayName || '',
+            entries: memory.list(userId).map((entry) => ({
+              ...entry,
+              createdText: new Date(entry.createdAt).toISOString(),
+              expiresText: entry.expiresAt ? new Date(entry.expiresAt).toISOString() : '',
+            })),
+          }))
+          .filter((row) => row.entries.length > 0)
+        return { users: rows, total: rows.reduce((sum, row) => sum + row.entries.length, 0) }
+      }
+      case 'memory-add': {
+        const userId = String(payload.userId || '').trim()
+        if (!userId) throw new Error('缺少 userId')
+        return memory.add(userId, payload)
+      }
+      case 'memory-delete': {
+        const userId = String(payload.userId || '').trim()
+        if (!userId) throw new Error('缺少 userId')
+        return memory.forget(userId, { ids: payload.id ? [payload.id] : payload.ids })
+      }
+      case 'memory-prune':
+        return pruneMemories()
+      case 'memory-review':
+        return reviewMemories({ userId: String(payload.userId || '').trim() })
       case 'nudge-test':
         return nudge.tick({ force: true })
       case 'agent-test': {
@@ -1103,6 +1270,9 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
         const sessionId = String(payload.sessionId || `session-line-selftest-${Date.now()}`)
         const cwd = String(payload.cwd || '').trim() || undefined
         const selection = String(payload.personaId || '').trim() || (cfg.persona.enforce ? cfg.persona.id : '')
+        const testUserId = String(payload.userId || '').trim()
+          || Object.entries(store.getState().users || {}).find(([, item]) => item.sessionId === sessionId)?.[0]
+          || ''
         const applied = await applyPersonaSelection(selection, sessionId)
         const result = await runner.turn({
           sessionId,
@@ -1110,7 +1280,8 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
           persona: applied.persona,
           personaText: applied.personaText,
           personaClient: persona(),
-          contextText: agentContextText(),
+          contextText: agentContextText(testUserId),
+          tools: memoryToolsFor(testUserId),
           cwd,
         })
         return { text: result.text, reason: result.reason, sessionId, cwd: cwd || '', persona: selection, personaSource: applied.source }

package/lib/memory.mjs

@@ -0,0 +1,209 @@
+// 每位 LINE 使用者各自的「個人記憶」：agent 覺得重要就自己寫進來，
+// 有保存期限的到期後由背景清理；也可以被要求翻出來看或忘掉。
+import fs from 'node:fs'
+import path from 'node:path'
+import { randomBytes } from 'node:crypto'
+import { readJsonSafe, writeJsonAtomic, nowIso } from './util.mjs'
+import { defineTool } from './toolkit.mjs'
+
+const KINDS = ['fact', 'event', 'preference', 'inside']
+const MAX_TEXT = 600
+const DAY = 24 * 60 * 60 * 1000
+
+function emptyStore() {
+  return { version: 1, users: {}, lastPruneAt: 0 }
+}
+
+function normalizeEntry(input) {
+  const text = String(input?.text || '').trim().slice(0, MAX_TEXT)
+  if (!text) throw new Error('記憶內容不能是空的')
+  const kind = KINDS.includes(input?.kind) ? input.kind : 'fact'
+  let importance = Number(input?.importance)
+  if (!Number.isFinite(importance)) importance = 3
+  importance = Math.max(1, Math.min(5, Math.round(importance)))
+  let expiresAt = 0
+  const ttlDays = Number(input?.ttlDays)
+  if (Number.isFinite(ttlDays) && ttlDays > 0) {
+    expiresAt = Date.now() + Math.min(ttlDays, 3650) * DAY
+  }
+  return {
+    id: 'm_' + randomBytes(4).toString('hex'),
+    text,
+    kind,
+    importance,
+    source: input?.source === 'user' ? 'user' : 'agent',
+    createdAt: Date.now(),
+    expiresAt,
+  }
+}
+
+export function createMemoryStore({ dir, logger, getConfig }) {
+  const file = path.join(dir, 'memories.json')
+  let store = readJsonSafe(file, emptyStore())
+  if (!store || typeof store !== 'object') store = emptyStore()
+  if (!store.users || typeof store.users !== 'object') store.users = {}
+  if (!store.version) store.version = 1
+
+  function save() {
+    writeJsonAtomic(file, store, 0o600)
+  }
+
+  function cfg() {
+    return getConfig()?.memory || {}
+  }
+
+  function bucket(userId) {
+    const key = String(userId || '')
+    if (!key) throw new Error('缺少使用者 ID')
+    if (!store.users[key]) store.users[key] = { entries: [], updatedAt: 0 }
+    if (!Array.isArray(store.users[key].entries)) store.users[key].entries = []
+    return store.users[key]
+  }
+
+  function activeEntries(userId) {
+    const now = Date.now()
+    return bucket(userId).entries
+      .filter((entry) => !entry.expiresAt || entry.expiresAt > now)
+      .sort((a, b) => b.createdAt - a.createdAt)
+  }
+
+  function list(userId) {
+    return activeEntries(userId).map((entry) => ({ ...entry }))
+  }
+
+  function add(userId, input) {
+    const entry = normalizeEntry(input)
+    const target = bucket(userId)
+    target.entries.push(entry)
+    target.updatedAt = Date.now()
+    const max = Math.max(10, Math.min(Number(cfg().maxPerUser) || 120, 500))
+    if (target.entries.length > max) {
+      target.entries.sort((a, b) => a.createdAt - b.createdAt)
+      target.entries.splice(0, target.entries.length - max)
+    }
+    save()
+    logger?.info?.(`個人記憶：幫 ${userId} 記下「${entry.text.slice(0, 40)}」`)
+    return { ...entry }
+  }
+
+  function forget(userId, { ids, query, expired } = {}) {
+    const target = bucket(userId)
+    const now = Date.now()
+    const wanted = new Set(Array.isArray(ids) ? ids.map(String) : [])
+    const needle = String(query || '').trim().toLowerCase()
+    const removed = []
+    target.entries = target.entries.filter((entry) => {
+      const hit = (wanted.size > 0 && wanted.has(entry.id))
+        || (expired === true && entry.expiresAt && entry.expiresAt <= now)
+        || (needle && String(entry.text || '').toLowerCase().includes(needle))
+      if (hit) removed.push(entry.id)
+      return !hit
+    })
+    if (removed.length > 0) {
+      target.updatedAt = Date.now()
+      save()
+      logger?.info?.(`個人記憶：從 ${userId} 刪掉 ${removed.length} 筆`)
+    }
+    return { removed: removed.length, ids: removed }
+  }
+
+  function prune() {
+    const now = Date.now()
+    let removed = 0
+    for (const [userId, target] of Object.entries(store.users)) {
+      const entries = Array.isArray(target?.entries) ? target.entries : []
+      const kept = entries.filter((entry) => !entry.expiresAt || entry.expiresAt > now)
+      removed += entries.length - kept.length
+      if (kept.length !== entries.length) {
+        target.entries = kept
+        target.updatedAt = now
+      }
+      if (kept.length === 0 && Object.keys(target).length <= 2) delete store.users[userId]
+    }
+    if (removed > 0 || !store.lastPruneAt) {
+      store.lastPruneAt = now
+      save()
+    }
+    return { removed, at: now }
+  }
+
+  function stats() {
+    const now = Date.now()
+    let total = 0
+    let expired = 0
+    const users = []
+    for (const [userId, target] of Object.entries(store.users)) {
+      const entries = Array.isArray(target?.entries) ? target.entries : []
+      const live = entries.filter((entry) => !entry.expiresAt || entry.expiresAt > now)
+      expired += entries.length - live.length
+      total += live.length
+      if (live.length > 0) users.push({ userId, count: live.length, lastAt: target.updatedAt || 0 })
+    }
+    return { file, total, expired, users, lastPruneAt: store.lastPruneAt || 0 }
+  }
+
+  function formatForContext(userId) {
+    const conf = cfg()
+    if (conf.enabled === false || !userId) return ''
+    const entries = activeEntries(userId)
+    if (entries.length === 0) return ''
+    const maxEntries = Math.max(1, Math.min(Number(conf.injectMaxEntries) || 20, 80))
+    const maxChars = Math.max(200, Math.min(Number(conf.injectMaxChars) || 2000, 8000))
+    const lines = []
+    let used = 0
+    for (const entry of entries.slice(0, maxEntries)) {
+      const stamp = new Date(entry.createdAt).toISOString().slice(0, 10)
+      const until = entry.expiresAt ? `，${new Date(entry.expiresAt).toISOString().slice(0, 10)} 失效` : ''
+      const line = `- [${entry.kind}] ${entry.text}（${stamp}${until}）`
+      if (used + line.length > maxChars) break
+      lines.push(line)
+      used += line.length
+    }
+    if (lines.length === 0) return ''
+    return [
+      '【你記得的關於這位使用者的事】',
+      '（這些是你自己寫下的記憶；可自然引用，但不必逐條複述。若發現過期或不再成立，可用 line_memory_forget 刪掉。）',
+      ...lines,
+    ].join('\n')
+  }
+
+  function toolsFor(userId) {
+    return [
+      defineTool({
+        name: 'line_memory_add',
+        description: '把關於這位使用者的重要事情寫進你的個人記憶。只記長期有用、之後還會影響對話的內容；'
+          + '一次性或純閒聊不要記。有期限的（例如「下週考試」「這個月在減肥」）請填 ttlDays，到期會自動刪掉。'
+          + '不要記密碼、token、身分證號等敏感資料。',
+        parameters: {
+          text: { type: 'string', description: '要記住的事，一句到兩句，寫成你自己看得懂的描述', required: true },
+          kind: { type: 'string', enum: KINDS, description: 'fact=事實、event=事件、preference=喜好、inside=你們之間的默契' },
+          importance: { type: 'number', description: '1~5，越高越重要（預設 3）' },
+          ttlDays: { type: 'number', description: '幾天後失效；不填或 0 表示長期保留' },
+        },
+        execute: async (args) => {
+          const entry = add(userId, args || {})
+          return { saved: true, id: entry.id, kind: entry.kind, expiresAt: entry.expiresAt || null }
+        },
+      }),
+      defineTool({
+        name: 'line_memory_forget',
+        description: '刪掉你的個人記憶：用 ids 指定，或給 query 刪掉內容包含這段字的記憶；'
+          + '給 expired:true 則清掉所有已到期的。使用者要求「忘掉」時就用這個。',
+        parameters: {
+          ids: { type: 'array', items: { type: 'string' }, description: '要刪的記憶 id' },
+          query: { type: 'string', description: '刪掉內容包含這個字串的記憶' },
+          expired: { type: 'boolean', description: '清掉所有已到期的記憶' },
+        },
+        execute: async (args) => forget(userId, args || {}),
+      }),
+      defineTool({
+        name: 'line_memory_list',
+        description: '列出你目前對這位使用者記得的內容（含 id 與到期日），想確認或整理時使用。',
+        parameters: {},
+        execute: async () => ({ count: activeEntries(userId).length, entries: activeEntries(userId) }),
+      }),
+    ]
+  }
+
+  return { file, list, add, forget, prune, stats, formatForContext, toolsFor }
+}

package/lib/toolkit.mjs

@@ -0,0 +1,42 @@
+// 把工具定義補成宿主要求的形狀（output schema + render），並把參數映射轉成 JSON Schema。
+// 做法與 dsh-tieba-dive 的 lib/toolkit.mjs 相同：宿主有 dsh-tools 就用它的 defineTool，
+// 沒有就自己補；這樣外掛不必把 dsh-tools 宣告成依賴。
+let base = (spec) => spec
+let usingHost = false
+
+try {
+  const mod = await import('dsh-tools')
+  if (typeof mod.defineTool === 'function') {
+    base = mod.defineTool
+    usingHost = true
+  }
+} catch {
+  /* 宿主沒給，用本地兜底 */
+}
+
+export const textOutput = {
+  schema: { type: 'object', properties: {}, additionalProperties: true },
+  render: (_args, value) => [{
+    type: 'text',
+    text: typeof value === 'string' ? value : JSON.stringify(value, null, 2),
+  }],
+}
+
+export function toJsonSchema(params) {
+  if (!params) return { type: 'object', properties: {}, required: [] }
+  if (params.type === 'object') return params
+  const properties = {}
+  const required = []
+  for (const [key, value] of Object.entries(params)) {
+    if (!value || typeof value !== 'object') continue
+    const { required: isRequired, ...schema } = value
+    properties[key] = schema
+    if (isRequired === true) required.push(key)
+  }
+  return { type: 'object', properties, required, additionalProperties: false }
+}
+
+export function defineTool(spec) {
+  if (usingHost) return base({ output: textOutput, ...spec })
+  return base({ output: textOutput, ...spec, parameters: toJsonSchema(spec.parameters) })
+}

package/package.json

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