dsh-line-bot
In a curated listMaintenance: Activehanson0901/dsh-line-bot
LINE Messaging API bot plugin for DeepSeek Harness: Cloudflare Tunnel, selectable personas, proactive messages, full settings panel.
$ dsh plugin add dsh-line-botInstall
dsh has no central install command — add this plugin’s entry (documented in its README) to your profile or patch config, then restart.
How installs work9
stars
0
forks
JavaScript
Language
MIT
License
2026-10-30
Created
2026-11-10
Last push
README
dsh-line-bot
語言 / Languages: 繁體中文 · 简体中文 · English · 日本語 · 한국어
把 LINE 官方帳號(Messaging API)接進 DeepSeek Harness 的插件。回覆由 DSH 的 Agent 在同一個行程內產生,等於在 LINE 上跟你的 DSH 助理聊天;人設有兩種來源:有安裝大肥魚(dsh-persona-dafeiyu)時可以直接選它的人設;也可以只用插件內建的自訂人設(不需要任何個性外掛)。
內建:
- Webhook 伺服器:在本機
127.0.0.1開一個 HTTP server,處理 LINE 的X-Line-Signature驗章、事件去重、每位使用者各自的佇列。 - Cloudflare Tunnel:一鍵開 quick tunnel(
*.trycloudflare.com,免 Cloudflare 帳號),或貼上 Cloudflare API Token 建立具名隧道+DNS,取得固定網址;取得網址後自動把 webhook 端點寫回 LINE 並跑一次webhook/test。 - LINE 憑證:填 Channel ID+Channel Secret 就能自動簽發 access token(
/v2/oauth/accessToken,約 30 天,快到期會自動續簽);也可以直接貼上既有的 Channel Access Token。 - 沒有大肥魚外掛時:自動改用插件內建的繁體中文版本(大肥魚/阿茶/聽瀾),存在同一個
personas.json,可以像自訂人設一樣點開編輯;裝回大肥魚外掛後會自動切回外掛的人設。 - 主動傳訊:插件內建排程器(不用 launchd),每位使用者各自倒數(最短~最長間隔隨機);可調最短/最長間隔、每日/每月上限、兩則間距、安靜時段、對方安靜多久才可打擾、連續未回覆上限(達上限暫停,對方回話後歸零)、指定對象與提示詞;Agent 覺得不適合時可以回
SKIP跳過。 - 分段回覆:可把回覆依空行(段落)或每個換行拆成多個 LINE 訊息框,最多 5 則,不再全部擠在同一則;面板可切換分段方式或關閉。
- 合併連續訊息:模型還在處理上一則時,使用者又補了下一句,會先排隊,等這一輪結束後把補充內容合成一次一起回應,不會每句各回一次。
- 完整設定面板:所有設定都在「設定 → LINE Bot」裡,存到
<DSH_HOME>/line-bot/config.json(權限 600)。
關於「用 LINE Business ID 登入、由面板代建 bot」:LINE 自 2024-09 起只允許在 LINE Official Account Manager 手動建立 Messaging API channel,沒有公開 API;LINE Login 也只是身分驗證,不能取得官方帳號的管理權。所以面板不代建 bot,但會給你正確的入口連結,並把「拿到 Channel ID / Secret 之後」的所有步驟自動化(簽 token、設 webhook、測試)。
安裝
需求:DeepSeek Harness ≥ 0.2.0-rc.1、Node.js ≥ 22。人設外掛(大肥魚 dsh-persona-dafeiyu)是選用的——不裝也能用插件內建的自訂人設。
方式一:面板安裝(推薦)
DSH → 設定 → 外掛 → 安裝 bundle,輸入 dsh-line-bot 後安裝,重新整理頁面。設定左側就會多一個 LINE Bot。
方式二:npx 一鍵安裝
先完全結束 DSH(桌面版關閉視窗後,確認選單列/程序沒有殘留),再執行:
npx dsh-line-bot install
它會自動判斷要裝進哪個 profile(預設 desktop,可用 --profile <名稱> 指定),用 DSH 內建的 pnpm 安裝套件、把 bundle 加進 profile,最後提醒你重開 DSH。
npx dsh-line-bot status # 看目前裝在哪個 profile、有沒有啟用
npx dsh-line-bot uninstall # 移除(設定與憑證會保留)
方式三:手動
dsh plugin --profile desktop add dsh-line-bot
再把 dsh-line-bot 加進 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles 陣列(可參考 npx dsh-line-bot install 的做法),或改用面板安裝。
還沒發佈到 npm 時,也可以直接從 GitHub 安裝:
npx github:Hanson0901/dsh-line-bot install --spec github:Hanson0901/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 會偵測缺哪些,並詢問要不要一起安裝:
npx dsh-line-bot install --with-companions
npx dsh-line-bot install --no-companions
少了它們的影響:沒有大肥魚 → 人設只剩插件自訂的;沒有 dsh-meme → 只能回文字;沒有刷貼吧 → 貼吧同步自動停用。
第一次上線(5 步)
- 建立/取得憑證:到 LINE Official Account Manager 建立官方帳號 → LINE Developers Console 建立(或選用)Messaging API channel → 在「Messaging API」分頁把 Use webhook 打開 → 複製 Channel ID 與 Channel secret。
- 填入面板:「LINE Bot → LINE 憑證」貼上 Channel ID、Channel Secret,按「儲存變更」→「驗證並讀取 bot 資訊」。成功會看到 bot 名稱與 Basic ID。
- 啟動 webhook 伺服器:面板「狀態總覽」按「啟動全部」,或只按「啟動」讓 webhook server 與 tunnel 都起來(預設會自動啟動)。
- 開隧道:Quick tunnel 直接按「啟動隧道」;要固定網址就在「Cloudflare Tunnel」貼 API Token →「驗證 API Token」→「建立/更新隧道與 DNS」(API Token 權限:Account → Cloudflare Tunnel → Edit、Zone → DNS → Edit、Zone → Zone → Read)。quick tunnel 每次重啟網址都會變(插件會自動把新網址寫回 LINE webhook);具名隧道的網址則固定。
- 自動設定 webhook:隧道就緒後會自動 PUT 到 LINE;若沒成功,按「把隧道網址套到 webhook」再「測試 webhook」。之後在 LINE 加 bot 好友、傳訊息;第一次訊息會進入「待審核」,到面板「使用者」按「核准」後才會開始回覆(白名單預設是空的)。
面板各區
面板最上方是固定(sticky)儲存列:捲到任何位置都看得到「儲存變更/重新整理」;儲存列下方是二級快速選單,按一下就會跳到對應區塊(捲動時也會自動高亮目前區塊)。
| 區塊 | 內容 |
|---|---|
| 狀態總覽 | webhook server/隧道/LINE/人設/主動傳訊的綠燈狀態、公開網址、一鍵上線與啟停 |
| LINE 憑證 | Channel ID、Channel Secret、Access Token、自動簽發、loading 動畫、分段回覆、bot 資訊、webhook 套用/測試、白名單 |
| Cloudflare Tunnel | quick/API Token 模式、Token、hostname、隧道名稱、Account/Zone ID、下載 cloudflared、啟停、自動設定 webhook、自行提供的公開網址 |
| 模型與接口來源 | 選擇 LINE 回覆的 provider/模型與推理強度;非 deepseek-account 時自動停用 DeepSeek 餘額 |
| 回覆人設 | 選擇人設(大肥魚或插件自訂)、新增/編輯/刪除自訂人設、把目前人設複製成自訂、強制套用、允許使用者自己換人設、切換大肥魚 session 模式、測試 Agent 回覆 |
| 貼吧學習同步 | 把刷貼吧學到的語氣寫回人設(內建人設用覆蓋層)、預覽差異、立即同步 |
| 玩梗 | 文字梗庫:內建種子、貼吧金句、wanjiqi 彈幕梗;三個來源可個別開關、每輪注入幾則、新增/刪除梗 |
| 個人記憶 | 每位使用者分開的長期記憶、到期自動刪、每日請角色整理、手動刪除 |
| 表情包 | 使用 dsh-meme 圖庫回圖片/貼圖、開關、一次最多幾張、圖庫樣本 |
| 語音回覆 | CosyVoice3 語音合成、開關、參考音上傳、語氣指令、試聽 |
| 貼圖與圖片理解 | 收到 LINE 貼圖或一般圖片時抓圖給模型看;模型不吃圖時用 modlens 或另一個視覺模型描述(可關閉) |
| DeepSeek 餘額 | 目前餘額、每輪注入、低於門檻時由角色主動提醒、提醒門檻與冷卻(僅 deepseek-account) |
| 主動傳訊 | 開關、每位使用者的倒數、最短/最長間隔、連續未回覆上限、每日/每月上限、兩則間距、安靜時段、idle、指定對象、提示詞、立即試傳、統計(下次可能時間與暫停人數) |
| 使用者 | 待審核名單(核准/拒絕)、每位 LINE 使用者對應的 DSH session、專屬工作資料夾、目前人設(可直接改)、訊息數、上次互動、清空記憶/重設 session |
| 群組 | 每個群組的 session、工作資料夾、人設、訊息數;沒被點名時的回覆機率;被 @/引用一定回;清空群組記憶 |
| 進階設定 | 連接埠、Agent provider/model/effort/cwd/逾時、一人一個工作資料夾(含根目錄)、歡迎/錯誤/空回覆、日誌、開發用 host 重新載入 |
設定檔
<DSH_HOME>/line-bot/config.json:所有設定,含 LINE secret/Cloudflare token(權限 600,不會回傳明文給面板)。<DSH_HOME>/line-bot/state.json:LINE 使用者 ↔ DSH session 對應、訊息數、主動傳訊計數、webhook 狀態。<DSH_HOME>/line-bot/logs/YYYY-MM-DD.log:每日日誌(面板也會顯示最近 400 行)。
DSH_HOME 預設是 ~/.dsh。
運作方式
- LINE 把訊息 POST 到 Cloudflare 隧道 → 插件 webhook server(驗章後立刻回 200)。
- 依
userId找到(或建立)對應的 DSH session 與工作資料夾,決定這個 session 的人設:選大肥魚時透過它的 HTTP bridge 指定 session 人設;選插件自訂人設時,先請大肥魚在該 session 讓開(none),再由插件把自訂人設注入 system prompt。 - 用
agents.create/agents.resume在同一個 DSH 行程內建立/接續 Agent,followup一則使用者訊息,等到 turn 結束、子代理收斂、session flush。 - 從 session 事件取出最後一段 assistant 文字,用 LINE reply 回覆;reply token 過期就自動改 push。
- 主動傳訊排程器每分鐘檢查一次:逐位使用者到期、且沉默夠久才請 Agent 主動說一句,再 push 出去;連續未回覆達上限會暫停,對方回話後重新倒數。
模型與接口來源
「模型與接口來源」卡決定 LINE 回覆要用哪個 provider/模型:
More in Integrations & Sharing
dsh-notification
by omdsh-dev
Desktop notifications for DeepSeek Harness turn completions, with per-outcome controls and include/exclude keyword rules.
dsh-lark-bot
by plutokeating
Feishu/Lark bridge for DeepSeek Harness: scan-to-connect PersonalAgent binding, streaming cards, git-worktree project workspaces, parallel per-scope tasks, multi-role agents, cross-session notify, in-chat model/key management, and a safety-net guardian that still answers in Feishu after dsh crashes.
dsh-session-notification
by dingyi222666
Notifications for four session states, with browser alerts and prompts.
dsh-chatgpt-web
by wlv-zedd
DSH ChatGPT Free bridges standard ChatGPT Web directly into DeepSeek Harness
