前言¶
DSH(DeepSeek Harness)採用「一切皆插件」的架構,開發者在構建智能體或工作流時,常需要從多個平臺(GitHub、B站等)收集消息,並在同一入口統一管理閱讀狀態、後續處理與發佈審覈。本文介紹 dsh-message-console,一個面向個人使用的 DSH 消息聚合插件。
是什麼¶
dsh-message-console 是一個 DSH 插件,以「來源」爲配置單位,把評論、issue、PR 和 release 的變化集中到一個入口,分別管理閱讀狀態、後續處理與發佈審覈。目前爲開發版本,支持通過服務器現有 gh 授權讀取 GitHub 倉庫,以及通過 Chrome Cookie 讀取 B 站視頻評論。兩條採集路徑均只讀,真實訂閱模型與完整自動處理鏈路仍需驗收。
核心功能¶
1. 主面板總覽與來源管理¶
- 主面板按平臺與來源展示卡片,支持獨立平臺列表、來源展開和來源詳情頁。
- 來源可保存簡介與標籤。
- 首次抓取作爲已讀基線;後續變化按內容版本顯示未讀,個人處理狀態獨立保存。
- 總覽與來源頁支持“全部已讀”,清除當前未讀與關注提示,保留草稿、評價和歷史。
2. 抓取與整理¶
- 來源配置支持全局默認值與來源覆蓋。
- 抓取和整理默認每 6 小時執行一次,可手動刷新並整理。
- GitHub 始終採集全部 Issue 和 PR,包括已關閉及已合併狀態。默認手動和自動整理都跳過這些內容;全局配置的“GitHub 整理範圍”可開啓“整理已關閉或已合併內容”,來源可覆蓋或恢復繼承。Release 照常整理。
- B站根評論和樓中樓圖片保留鏈接與尺寸,展示時按需生成縮略圖,點擊查看原圖。私有圖片緩存默認合計最多 256 MiB,原圖 7 天、縮略圖 30 天未使用後清理;全局配置可調整預算、查看佔用和清空緩存。
3. 內容分析與分流¶
- 評論經 Jev 概率判斷分流;人工介入不提前擬稿;模糊判斷最多升級一次。
- PR/issue 分析、回覆生成與獨立監督會話。監督攔截後保留草稿和原因,不自動重試改稿。
- 不同工作角色使用獨立 DSH 會話;同內容項的生成/審查/覈實角色跨輪複用最早有效的原會話,保留真實歷史;人工入口準備待用背景,首次用戶發言後進入真實歷史;Jev 輸入輸出在插件裏可查。
- 工作 Agent 默認使用 DSH PTC 模式與工作區權限,通過查詢工具讀取原文,通過提交工具保存結果和不可變草稿。
4. 評論自動回覆與監督¶
- B站評論按來源授權自動回覆:無需回覆、可自動回覆、需要人工與重要程度分開判斷;監督通過的新自動草稿以“由「看點什麼」插件自動回覆:”開頭,發送前複覈授權和版本。其他草稿等待人工審覈。發送結果不確定時保留
unknown,不自動重發。 - 內容列表支持服務端搜索、篩選及每頁 10、20、50 條。正文、評論、歷史版本和工作記錄按需加載。B站詳情保留視頻標題,簡介按內容版本分塊讀取。
5. 評價與學習¶
- 內容詳情可保存“我的評價”,按來源整理最多 50 條未學習案例,展示修改前後差異和案例引用,人工確認後才應用。
6. 數據與連接器¶
- GitHub 公開倉庫 REST 讀取連接器,支持分頁、限流退避和 PR head 變化檢查。PR 目前只獲得 patch 和討論,不代表完整代碼審查或實際執行測試。
- SQLite 按行事務、舊 JSON 數據遷移、進程鎖、中斷狀態恢復,以及宿主認證保護的分頁 API。
- GitHub 默認使用 DSH 運行用戶已有的
gh授權。先在同一用戶下確認gh auth status --hostname github.com,再啓動插件。插件調用gh auth token --hostname github.com,在內存中以該授權讀取固定的api.github.com,並通過/user驗證登錄身份。不會創建或修改授權,不將 token 寫入插件配置、數據庫、日誌或模型輸入。每次採集重新讀取授權,分頁複用該輪內存授權;命令及網絡請求均有超時。 gh不存在、授權失效或請求失敗時顯示錯誤並保留已有數據,不自動降級匿名訪問。需要匿名讀取公開倉庫時,可在宿主插件配置中明確設置githubAuth: public;默認值爲gh。無論 gh 授權本身具有什麼權限,當前 GitHub 連接器只採集,canPublish始終爲 false。
7. B站 Cookie 連接器¶
cookieFile用於 B 站視頻評論採集及按來源授權的評論發送。- macOS 可顯式運行
node scripts/import-chrome-cookies.mjs .local/credentials/chrome-cookies.json。默認 Chrome 的 Default profile,可將"Profile 1"作爲第三個參數。導入文件權限爲 0600,不會自動續期。 - B站評論按來源授權自動回覆:無需回覆、可自動回覆、需要人工與重要程度分開判斷;監督通過的新自動草稿以“由「看點什麼」插件自動回覆:”開頭,發送前複覈授權和版本。其他草稿等待人工審覈。發送結果不確定時保留
unknown,不自動重發。
安裝與啓用¶
安裝前請確保 Node.js 版本滿足要求,並安裝 DSH 0.2.1-rc.2 及 Cordis 4.0.5。
- 克隆倉庫後進入項目目錄:
git clone https://github.com/Player-MINEPIG/dsh-message-console.git
cd dsh-message-console
- 安裝依賴:
npm ci
- 本地開發與預覽(可選):
npm run check
npm run demo
預覽使用合成數據和模擬模型,不讀取真實賬號,不發送消息。每次啓動創建獨立模擬數據目錄;數據、構建臨時文件都留在被 Git 忽略的 .local/。
- 在 DSH 中安裝插件(開發版本):
npm run build
npm pack --pack-destination .local
dsh plugin add /absolute/path/to/dsh-message-console/.local/dsh-message-console-0.1.11.tgz
插件攜帶 cordis.patch.yml,默認將插件數據放入該 profile 的 DSH 數據目錄。可在插件配置中指定:
| 配置 | 用途 |
|---|---|
storageDir |
本插件的數據目錄;單進程獨佔 |
cookieFile |
顯式導入的本機 Cookie 文件路徑;不通過狀態 API 返回憑據 |
autoSchedule |
是否啓動抓取/整理計時,默認 true |
timeoutMs |
單個生成 Agent 的取消期限,默認 300000 |
典型用法¶
1. 配置來源¶
從 DSH 左側插件區域打開“看點什麼”,在“全局配置”從宿主目錄選擇提供商與模型,在“添加來源”綁定已有工作區。
添加來源時先輸入倉庫或視頻鏈接,再選擇內容類型。離開鏈接輸入框後,插件讀取標題、簡介和主題或分類,建議最多 12 個標籤。GitHub 支持倉庫、issues、pulls 和 releases 列表鏈接,單條內容鏈接會被拒絕;B站支持完整視頻鏈接、BV 號和 av 號。關注規則、階段背景與補充指令來自本地固定模板,元信息讀取失敗時仍可使用。手改或手動清空的字段會保留,已有來源只在點擊“重新識別並填充空白”時填充空白字段。仍需手動選擇工作區並保存;元信息讀取不抓取內容、不整理,也不調用模型。
2. 查看總覽與來源¶
頂欄提供“總覽”“學習記錄”“全局配置”和“添加來源”。“學習記錄”跨來源展示歷史批次及待確認提案;在來源詳情點擊“整理用戶評價”會直接發起該來源的學習批次並打開對應記錄。總覽首先顯示綜合優先級最高的最多三個已有平臺,再顯示來源卡片。點擊“全部平臺”或“展開來源”可單獨瀏覽對應列表。點擊平臺查看該平臺的來源,點擊來源進入獨立來源頁。編輯來源入口位於來源頁,全局配置只管理全局默認值。
未讀變化按內容項計數,一條評論對話無論新增多少條回覆都只計一個未讀內容項。需要處理按內容項去重,包含待處理、稍後處理及尚未確認關注的審覈草稿。標記“已處理”會確認當前關注,保留現有草稿與歷史,現有草稿不會再次頂起待處理提示;後續新內容、分析或草稿等事件會重新提醒。
總覽來源綜合排序按當前版本的分析重要性排序,有明確依據的緊急性只作有限修正,再比較需要處理數、未讀數與內容變化時間。
來源內容列表始終先顯示需要處理的項,再按重要性及有依據的緊急性排序,同級按最後更新時間排列,默認新到舊,可切換舊到新。最後更新時間優先使用平臺內容的 updatedAt,缺失時回退到採集到變化的時間;抓取時間單獨顯示。
GitHub 列表默認隱藏已關閉/已合併內容,勾選“顯示全部”可查看,採集仍全量同步,且此開關不改變整理範圍。搜索、篩選和顯示開關都在服務端分頁前應用,改變條件會回到第一頁。尚未整理或內容版本已變化的項不顯示。
3. 使用評價與學習¶
內容詳情可保存“我的評價”,按來源整理最多 50 條未學習案例,展示修改前後差異和案例引用,人工確認後才應用。
適用場景與注意¶
適合需要從 GitHub、B 站等平臺統一收集與處理消息的個人開發者。插件以當前 dsh 進程權限運行,安裝前應檢查源碼與許可證。
- 插件當前爲開發版本,真實訂閱模型與完整自動處理鏈路尚未端到端驗收。
- GitHub 採集目前按完整快照掃描,較大倉庫會產生較多請求;限流後保留已有數據,未完整獲取不會推進基線。尚無增量緩存。
- PR 文件列表超出 API 上限或未完整取得時,仍採集條目和狀態,但標記上下文不完整並停止自動審查。PR 缺失 patch 或代碼上下文、issue 缺少復現材料時,只能給出受限分析。Agent 可使用綁定工作區的標準工具覈對資料,但不能把可用工具當作已運行測試或已復現的證據。採集鏈路仍不提供完整倉庫檢索和自動代碼修復流程。
unknown發佈結果需要人工去原平臺覈實;本版沒有自動對賬和恢復發送的界面。- 已驗證真實賬號只讀採集及隔離宿主調用;完整默認 profile 和實際訂閱模型的處理鏈路尚未端到端驗收。
短結尾¶
dsh-message-console 爲 DSH 用戶提供了從多個平臺聚合消息並在同一入口管理閱讀狀態、後續處理與發佈審覈的能力,適合個人開發者集中管理評論、issue、PR 和 release 的變化。插件目前處於開發階段,部分鏈路尚需驗收。
- 插件目錄:https://www.skillhub.cn/plugins/Player-MINEPIG/dsh-message-console
- GitHub:https://github.com/Player-MINEPIG/dsh-message-console