前言¶
在 DeepSeek Harness(DSH)裏做多項目、多 Session 的開發時,常見做法是翻聊天記錄或憑印象估算「今天在各目錄上花了多久、解決了什麼」。社區裏已有若干工作日誌類插件,多數側重時長或對話留存,較少把賬戶餘額、今日花費與「按項目的一段摘要」放在同一套視圖裏,也很少提供切 Session 仍可見的輕量 HUD。
下面介紹維護者 callmenightmare 發佈的客戶端插件 dsh-work-log(GitHub:callmenightmare/dsh-work-log)。它以單一數據源驅動兩種界面:側邊欄完整面板與右上角常駐浮窗,記錄每輪對話的工作區間、按工作目錄聚合項目,並可選調用模型生成「今天解決了什麼」的短摘要,同時通過宿主賬號服務展示錢包餘額與當日花費。插件在 SkillHub 目錄分類爲客戶端;截至資料記載,GitHub 星標爲 0。README 標明其爲非官方插件,與 DeepSeek 無隸屬關係。
這是什麼¶
dsh-work-log 是面向 DSH 的每日工作日誌插件(package.json 版本 1.0.3,MIT 許可證)。一句話定位:在 Harness Web / Desktop profile(要求 DSH >= 0.2.1-rc.1)中,自動摺疊對話爲記錄、按項目統計時長,並提供餘額/花費與模型摘要,外加可拖拽的浮窗 HUD。
整頁報告面板與浮窗讀同一套本地數據,切換 Session 或面板時浮窗仍顯示。
核心功能¶
完整面板(側邊欄入口)¶
進入主欄後可查看:
- 當日總工時、錢包餘額與今日花費
- 月曆(默認收起爲一行周條,可展開整月)
- 按項目分組的卡片:每項目含模型生成的 1–4 行「今天解決了什麼」
- 手工備註
摘要由模型按需生成;面板側只接收整理後的 prose,prompt 與完整回覆保留在宿主內。
浮窗膠囊(shell.overlay)¶
右上角常駐小膠囊:可拖拽,顯示今日工時與當前餘額;› 可跳轉到完整面板。切換 Session 與其他面板時仍保持顯示。
記錄與計時規則¶
資料中的行爲約定如下:
- 每輪對話自動折成一條記錄:用戶請求、助手收尾結論、本輪涉及目錄、改動文件數與增刪行數、起止時間。
- 按工作目錄聚成項目;時長按區間並集計算(同項目合併重疊區間,跨項目不重複計時,單輪封頂 3 小時,空閒不計)。
- 每個項目每天可用默認模型壓出 1–4 行摘要,緩存在當天數據裏;若之後又有新工作,會標「之後又有新的工作」。
與其它 DSH 工作日誌插件的差異(README 歸納):金錢維度而不僅是分鐘(餘額經 deepseekAccount.getBalance(),充值記爲 top-up 不重置花費計數)、摘要而非 transcript、HUD 而非僅頁面。
Agent 工具 work_log¶
供 agent 使用,支持 read / record / summarize(細節見倉庫實現與測試)。
安裝與啓用¶
當前 README 寫明僅支持通過本地目錄安裝 bundle,未提供 dsh plugin add github:… 一類命令。資料中的步驟如下。
- 獲取插件源碼到本機(README 示例):
git clone https://github.com/callmenightmare/dsh-work-log.git
- 在 Harness 中把該目錄裝成 bundle(路徑改爲你機器上的絕對路徑):
install_bundle /absolute/path/to/dsh-work-log
或:側邊欄「插件」→ 添加 → 選擇本地目錄。安裝後刷新頁面。
環境要求:DeepSeek Harness >= 0.2.1-rc.1(Web / Desktop profile)。
插件以當前 DSH 進程權限運行;安裝前應自行審閱源碼與 MIT 許可證,確認符合你的安全與合規要求。
數據存放與隱私¶
每日數據一個 JSON 文件,路徑固定爲:
~/.dsh/work-log/YYYY-MM-DD.json
文件可讀、可備份、可手改;卸載插件後文件仍保留。
隱私相關說明(README):
- 數據只在本機:寫本地文件,經
127.0.0.1上的路由供頁面讀取,不發往第三方。 - 餘額通過宿主自帶賬號服務讀取,不保存憑證。
- 生成摘要消耗你自己的模型額度(每項目每天一次調用)。
- HTTP 路由僅在迴環地址監聽(宿主默認綁定
127.0.0.1)。
典型用法¶
安裝並刷新後,日常可這樣用:
- 正常在各工作目錄下與 Harness 對話;插件在後臺按輪摺疊記錄並聚合項目時長。
- 需要總覽時,從側邊欄打開工作日誌面板,查看當日工時、餘額、花費與各項目摘要;需要時用月曆或備註補充上下文。
- 開發過程中可隨時看右上角浮窗上的今日工時與餘額;點
›進入完整面板。 - 若使用 agent,可通過
work_log工具的 read / record / summarize 與同日 JSON 數據交互(行爲以倉庫node test/host.test.mjs所覆蓋的 host 側邏輯爲準)。
適用場景與已知限制¶
適合誰:希望在 DSH 內統一看到「按項目工時 + 今日花費 + 可讀摘要」、且需要跨 Session 常駐 HUD 的開發者。
限制(README 已知):
- 面板爲固定暗色主題,不跟隨宿主明暗切換。
- 「今日花費」= 當天第一次讀到的餘額 − 當前餘額;安裝當日從第一次讀取起算,此前花費無法回溯。
- 項目時長按輪計算,等待你回覆的時間不計入。
社區目錄 SkillHub 與 DeepSeek / 幻方無官方從屬關係;本插件亦爲非官方作品。
結尾¶
dsh-work-log 把工時、花費與按項目的模型摘要收進同一數據層,並用面板 + 浮窗兩種入口呈現,適合在多目錄、多 Session 的 Harness 日常裏做可追溯的「今天做了什麼」。