dsh-line-bot 0.5.5 → 0.5.6

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.5.6
+
+- 安裝 CLI 會偵測搭配外掛（`dsh-persona-dafeiyu`、`dsh-meme`、`dsh-tieba-dive`），可互動詢問或 `--with-companions` 一起安裝；`status` 也會顯示安裝狀態。
+- README（五語言）新增「搭配外掛」章節。
+
 ## 0.5.5
 
 - 收到 LINE 貼圖時抓取貼圖圖片，透過 DSH 附件服務交給模型閱讀（模型不支援圖片時自動退回貼圖關鍵字）。

package/README.en.md

@@ -56,6 +56,25 @@ Then add `dsh-line-bot` to the `dsh.profile.bundles` array in `~/.dsh/profiles/d
 >
 > Or from source: `git clone https://github.com/Hanson0901/dsh-line-bot.git`, then choose that folder in the DSH panel's "Install bundle", or run `dsh plugin --profile desktop add /path/to/dsh-line-bot`.
 
+## Companion plugins (optional)
+
+The bot works on its own; these plugins add capabilities:
+
+| Plugin | What it adds | Recommended |
+| --- | --- | --- |
+| `dsh-persona-dafeiyu` | Persona catalog and Tieba sync | Yes |
+| `dsh-meme` | Image/sticker replies | Yes |
+| `dsh-tieba-dive` | Source of Tieba learning sync | Optional |
+
+The install CLI detects what is missing and offers to install it:
+
+```bash
+npx dsh-line-bot install --with-companions
+npx dsh-line-bot install --no-companions
+```
+
+Without them: no dafeiyu means only plugin-local personas; no dsh-meme means text-only replies; no dsh-tieba-dive means Tieba sync stays off.
+
 ## First run (5 steps)
 
 1. **Create / obtain credentials**: go to [LINE Official Account Manager](https://manager.line.biz/) and create an Official Account → [LINE Developers Console](https://developers.line.biz/console/) and create (or pick) a Messaging API channel → open the **Use webhook** toggle on the "Messaging API" tab → copy the **Channel ID** and **Channel secret**.

package/README.ja.md

@@ -56,6 +56,25 @@ dsh plugin --profile desktop add dsh-line-bot
 >
 > ソースからなら：`git clone https://github.com/Hanson0901/dsh-line-bot.git` して、DSH パネルの「bundle をインストール」でそのフォルダを選ぶか、`dsh plugin --profile desktop add /path/to/dsh-line-bot` を実行します。
 
+## 連携プラグイン（任意）
+
+LINE Bot は単体でも動きます。以下を入れると機能が増えます：
+
+| プラグイン | 追加される機能 | 推奨 |
+| --- | --- | --- |
+| `dsh-persona-dafeiyu` | ペルソナ一覧と貼吧同期 | 推奨 |
+| `dsh-meme` | 画像／スタンプ返信 | 推奨 |
+| `dsh-tieba-dive` | 貼吧学習同期の取得元 | 任意 |
+
+インストール CLI は不足を検出して、一緒に入れるか確認します：
+
+```bash
+npx dsh-line-bot install --with-companions
+npx dsh-line-bot install --no-companions
+```
+
+ない場合の影響：大肥魚なし → プラグイン内のペルソナのみ、dsh-meme なし → テキストのみ、貼吧プラグインなし → 貼吧同期は停止。
+
 ## 初回セットアップ（5 ステップ）
 
 1. **認証情報を用意**：[LINE Official Account Manager](https://manager.line.biz/) で公式アカウントを作成 → [LINE Developers Console](https://developers.line.biz/console/) で Messaging API チャネルを作成（または選択）→ 「Messaging API」タブで **Use webhook** をオン → **Channel ID** と **Channel secret** をコピーします。

package/README.ko.md

@@ -56,6 +56,25 @@ dsh plugin --profile desktop add dsh-line-bot
 >
 > 소스에서 설치하려면 `git clone https://github.com/Hanson0901/dsh-line-bot.git` 후 DSH 패널의 "bundle 설치"에서 그 폴더를 선택하거나 `dsh plugin --profile desktop add /path/to/dsh-line-bot`을 실행합니다.
 
+## 함께 쓰는 플러그인 (선택)
+
+LINE Bot은 단독으로도 동작하며, 아래 플러그인을 설치하면 기능이 늘어납니다:
+
+| 플러그인 | 추가 기능 | 권장 |
+| --- | --- | --- |
+| `dsh-persona-dafeiyu` | 페르소나 목록, 톄바 동기화 | 권장 |
+| `dsh-meme` | 이미지/스티커 답장 | 권장 |
+| `dsh-tieba-dive` | 톄바 학습 동기화 소스 | 선택 |
+
+설치 CLI는 없는 것을 감지해 함께 설치할지 물어봅니다:
+
+```bash
+npx dsh-line-bot install --with-companions
+npx dsh-line-bot install --no-companions
+```
+
+없을 때: 대비어 없음 → 플러그인 자체 페르소나만, dsh-meme 없음 → 텍스트만, 톄바 플러그인 없음 → 톄바 동기화 꺼짐.
+
 ## 첫 구동(5단계)
 
 1. **자격 증명 준비**: [LINE Official Account Manager](https://manager.line.biz/)에서 공식 계정 생성 → [LINE Developers Console](https://developers.line.biz/console/)에서 Messaging API 채널 생성(또는 선택) → "Messaging API" 탭에서 **Use webhook** 켜기 → **Channel ID**와 **Channel secret** 복사.

package/README.md

@@ -56,6 +56,25 @@ dsh plugin --profile desktop add dsh-line-bot
 >
 > 或從原始碼：`git clone https://github.com/Hanson0901/dsh-line-bot.git`，在 DSH 面板「安裝 bundle」選那個資料夾，或 `dsh plugin --profile desktop add /path/to/dsh-line-bot`。
 
+## 搭配外掛（可選）
+
+LINE Bot 可以獨立運作；裝了下面這些外掛會多出對應功能：
+
+| 外掛 | 用途 | 建議 |
+| --- | --- | --- |
+| `dsh-persona-dafeiyu` | 人設清單、貼吧同步 | 建議 |
+| `dsh-meme` | 讓角色回圖片／貼圖 | 建議 |
+| `dsh-tieba-dive` | 貼吧學習同步的來源 | 可選 |
+
+安裝時 CLI 會偵測缺哪些，並詢問要不要一起安裝：
+
+```bash
+npx dsh-line-bot install --with-companions
+npx dsh-line-bot install --no-companions
+```
+
+少了它們的影響：沒有大肥魚 → 人設只剩插件自訂的；沒有 dsh-meme → 只能回文字；沒有刷貼吧 → 貼吧同步自動停用。
+
 ## 第一次上線（5 步）
 
 1. **建立／取得憑證**：到 [LINE Official Account Manager](https://manager.line.biz/) 建立官方帳號 → [LINE Developers Console](https://developers.line.biz/console/) 建立（或選用）Messaging API channel → 在「Messaging API」分頁把 **Use webhook** 打開 → 複製 **Channel ID** 與 **Channel secret**。

package/README.zh-CN.md

@@ -56,6 +56,25 @@ dsh plugin --profile desktop add dsh-line-bot
 >
 > 或从源码：`git clone https://github.com/Hanson0901/dsh-line-bot.git`，在 DSH 面板「安装 bundle」选那个文件夹，或 `dsh plugin --profile desktop add /path/to/dsh-line-bot`。
 
+## 搭配插件（可选）
+
+LINE Bot 可以独立运行；装上下面这些插件会多出对应功能：
+
+| 插件 | 用途 | 建议 |
+| --- | --- | --- |
+| `dsh-persona-dafeiyu` | 人设清单、贴吧同步 | 建议 |
+| `dsh-meme` | 让角色回图片/贴图 | 建议 |
+| `dsh-tieba-dive` | 贴吧学习同步的来源 | 可选 |
+
+安装时 CLI 会检测缺哪些，并询问要不要一起安装：
+
+```bash
+npx dsh-line-bot install --with-companions
+npx dsh-line-bot install --no-companions
+```
+
+少了它们的影响：没有大肥鱼 → 人设只剩插件自定义的；没有 dsh-meme → 只能回文字；没有刷贴吧 → 贴吧同步自动停用。
+
 ## 第一次上线（5 步）
 
 1. **创建／取得凭证**：到 [LINE Official Account Manager](https://manager.line.biz/) 创建官方账号 → [LINE Developers Console](https://developers.line.biz/console/) 创建（或选用）Messaging API channel → 在「Messaging API」分页把 **Use webhook** 打开 → 复制 **Channel ID** 与 **Channel secret**。

package/bin/cli.mjs

@@ -16,6 +16,7 @@ import fs from 'node:fs'
 import os from 'node:os'
 import path from 'node:path'
 import { spawnSync } from 'node:child_process'
+import readline from 'node:readline/promises'
 
 const IS_WIN = process.platform === 'win32'
 import { fileURLToPath } from 'node:url'
@@ -23,6 +24,13 @@ import { fileURLToPath } from 'node:url'
 const PKG = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8'))
 const NAME = PKG.name || 'dsh-line-bot'
 
+// 搭配的外掛：不裝也能用，但少掉某些功能。安裝時會偵測並詢問是否一起裝。
+const COMPANIONS = [
+  { name: 'dsh-persona-dafeiyu', label: '大肥魚人設', hint: '人設清單、貼吧同步（建議）' },
+  { name: 'dsh-meme', label: '表情包圖庫', hint: '讓角色回圖片／貼圖（建議）' },
+  { name: 'dsh-tieba-dive', label: '刷貼吧', hint: '貼吧學習同步的來源（可選）' },
+]
+
 function out(line = '') {
   process.stdout.write(`${line}\n`)
 }
@@ -32,7 +40,7 @@ function fail(message) {
 }
 
 function parseArgs(argv) {
-  const options = { command: '', profile: '', version: '', spec: '', dryRun: false, enable: true }
+  const options = { command: '', profile: '', version: '', spec: '', dryRun: false, enable: true, companions: 'ask' }
   const rest = [...argv]
   options.command = (rest.shift() || 'help').toLowerCase()
   for (let index = 0; index < rest.length; index += 1) {
@@ -56,6 +64,10 @@ function parseArgs(argv) {
       options.spec = arg.slice('--spec='.length)
     } else if (arg === '--no-enable') {
       options.enable = false
+    } else if (arg === '--with-companions') {
+      options.companions = 'yes'
+    } else if (arg === '--no-companions') {
+      options.companions = 'no'
     } else if (arg === '--help' || arg === '-h') {
       options.command = 'help'
     } else {
@@ -125,12 +137,12 @@ function bundlesOf(manifest) {
   return Array.isArray(bundles) ? [...bundles] : []
 }
 
-function withBundle(manifest, enabled) {
+function withBundle(manifest, enabled, name = NAME) {
   const bundles = bundlesOf(manifest)
   if (enabled) {
-    if (!bundles.includes(NAME)) bundles.push(NAME)
+    if (!bundles.includes(name)) bundles.push(name)
   } else {
-    const index = bundles.indexOf(NAME)
+    const index = bundles.indexOf(name)
     if (index >= 0) bundles.splice(index, 1)
   }
   return {
@@ -218,7 +230,66 @@ function runInstall(profile, versionSpec, { dryRun }) {
   }
 }
 
-function commandInstall(options) {
+function companionMissing(profile, dir, manifest, name) {
+  const deps = { ...(manifest.dependencies || {}), ...(manifest.devDependencies || {}) }
+  if (deps[name]) return false
+  if (bundlesOf(manifest).includes(name)) return false
+  return !fs.existsSync(path.join(dir, 'node_modules', name, 'package.json'))
+}
+
+async function askYesNo(question) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
+  try {
+    const answer = (await rl.question(question)).trim().toLowerCase()
+    return answer === '' || answer === 'y' || answer === 'yes' || answer === '是'
+  } finally {
+    rl.close()
+  }
+}
+
+function installCompanion(profile, name, options) {
+  runInstall(profile, `${name}@latest`, options)
+  if (options.dryRun) return
+  const { file } = readManifest(profile)
+  const current = readManifest(profile).manifest
+  const next = withBundle(current, true, name)
+  if (JSON.stringify(next) !== JSON.stringify(current)) {
+    writeManifestAtomic(file, next)
+    out(`✔ 已啟用 ${name}`)
+  }
+}
+
+async function setupCompanions(profile, options) {
+  const { dir, manifest } = readManifest(profile)
+  const missing = COMPANIONS.filter((item) => companionMissing(profile, dir, manifest, item.name))
+  if (missing.length === 0) {
+    out('• 搭配外掛都已安裝。')
+    return
+  }
+  out('')
+  out('搭配外掛（可選，不裝也能用）：')
+  for (const item of missing) out(`  • ${item.name} — ${item.label}：${item.hint}`)
+  if (options.dryRun) {
+    out(`→ 會詢問是否一起安裝 ${missing.map((item) => item.name).join('、')}`)
+    return
+  }
+  let install = false
+  if (options.companions === 'yes') install = true
+  else if (options.companions === 'no') install = false
+  else if (process.stdin.isTTY) install = await askYesNo('要一起安裝嗎？(Y/n) ')
+  else {
+    out('• 目前不是互動終端，略過搭配外掛；可加 --with-companions 一起安裝。')
+    return
+  }
+  if (!install) {
+    out('• 略過搭配外掛。之後可再跑 npx dsh-line-bot install --with-companions。')
+    return
+  }
+  for (const item of missing) installCompanion(profile, item.name, options)
+  out('✔ 搭配外掛安裝完成。')
+}
+
+async function commandInstall(options) {
   const profile = pickProfile(options.profile)
   const { dir, file, manifest } = readManifest(profile)
   const versionSpec = options.spec || (options.version ? `${NAME}@${options.version}` : `${NAME}@${PKG.version}`)
@@ -245,6 +316,8 @@ function commandInstall(options) {
     }
   }
 
+  await setupCompanions(profile, options)
+
   out('')
   out('完成。下一步：')
   out('  1. 完全結束並重開 DeepSeek Harness（桌面版請確認選單列沒有殘留）。')
@@ -295,6 +368,11 @@ function commandStatus(options) {
   out(`profile：${profile}（${dir}）`)
   out(`依賴：${dependency || '（未安裝）'}`)
   out(`bundle 啟用：${enabled ? '是' : '否'}`)
+  const companions = COMPANIONS.map((item) => {
+    const ok = !companionMissing(profile, dir, manifest, item.name)
+    return `${item.name}${ok ? '（已安裝）' : '（未安裝）'}`
+  })
+  out(`搭配外掛：${companions.join('、')}`)
   if (fs.existsSync(path.join(dshHome(), 'line-bot', 'config.json'))) {
     out('設定檔：<DSH_HOME>/line-bot/config.json（已存在）')
   }
@@ -314,6 +392,8 @@ function commandHelp() {
   out('  --version, -v <版本>   指定要安裝的版本（預設跟這個 CLI 相同）')
   out('  --spec <pnpm 規格>     直接指定套件規格，例如 github:Hanson0901/dsh-line-bot')
   out('  --no-enable            只安裝套件，不寫入 bundle 清單')
+  out('  --with-companions      一起安裝搭配外掛（dsh-persona-dafeiyu、dsh-meme、dsh-tieba-dive）')
+  out('  --no-companions        不詢問搭配外掛')
   out('  --dry-run, -n          只顯示會做什麼，不寫入')
   out('  --help, -h             顯示這段說明')
   out('')
@@ -324,7 +404,7 @@ const options = parseArgs(process.argv.slice(2))
 switch (options.command) {
   case 'install':
   case 'add':
-    commandInstall(options)
+    await commandInstall(options)
     break
   case 'uninstall':
   case 'remove':

package/lib/host.mjs

@@ -41,7 +41,7 @@ const { createMemeSource } = memeSourceMod
 const { createStickerImages } = stickerImageMod
 const { chunkText, clip, inQuietWindow, jsonFail, jsonOk, maskSecret, readJsonBody, safeArray, sleep } = utilMod
 
-export const VERSION = '0.5.5'
+export const VERSION = '0.5.6'
 
 // 環境變數提供的 Cloudflare API Token（方便用 shell 注入、不用把 token 寫進設定檔）。
 // 設定檔裡的 token 優先；兩者都沒有時才用環境變數。

package/package.json

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