gewuji/dsh-plugin-work-notes:給 DSH 左側欄加一個工作便籤面板

前言

DSH 的理念是「一切皆插件」,但它的 Web 界面裏一直缺一個順手的落筆記入口:待辦往往寫在別處,日期靠手工排,換臺機器就丟了。這個插件把這個問題收進了一個左側欄面板,本機瀏覽器存着。

下面介紹 gewuji/dsh-plugin-work-notes,一個 DSH(DeepSeek Harness)Web 界面插件。它只做一件事:在左側欄提供一塊可自由擺放的工作便籤畫布,並配上日曆與甘特視圖做日期管理。

它是什麼

這是一個 DSH 插件(bundle),不是獨立軟件,也不能單獨運行。裝進 DSH 後出現在左側欄,帶一個筆記形狀的「工作便籤」圖標。維護者是 Gewuji,在社區插件目錄裏歸入「記憶」分類。

它是純前端插件:不註冊宿主路由、不執行命令、不發起網絡請求。便籤數據只保存在你自己瀏覽器的 localStorage 裏。

核心功能

便籤畫布

卡片可以自由拖動,右下角拖拽縮放;靠近其它卡片時自動吸附,按住 Alt 臨時關閉吸附。提供 4 種配色、置頂、刪除二次確認,以及 未完成 / 進行中 / 完成 三種狀態。頂部輸入框按回車即可新增便籤,卡片按編輯順序層疊。

日曆視圖

週一開頭的月曆,單元格內帶農曆與節氣/節日註解。可以在某個單元格上直接建便籤;點擊便籤彈出日期彈層,第一次點設置開始日,第二次點設置結束日。起止日期覆蓋某天的便籤會顯示在那一天裏,可直接拖動改期。

甘特視圖

時間軸按天排布(每天 26px),上限 180 天,圍繞今天自動留白。拖動整條可以移動,拖兩端可以拉伸,步進按整天。新建時能自動識別文字裏的日期;未排期的便籤可以一鍵按文字補日期。

其它

  • 界面跟隨 DSH 語言切換中英文
  • 面板自帶幫助說明
  • 便籤保存在瀏覽器 localStorage,卸載插件不會刪除數據

安裝與啓用

插件包的根目錄就是一個完整的插件包(package.json 裏聲明瞭 dsh.bundle),不需要構建步驟。DSH 的插件安裝器可以直接從 git 倉庫安裝。

方式一:桌面端 / Web 界面裏裝(推薦)

打開「設置 → 插件」,在「包名或地址」裏粘貼倉庫地址,點「安裝」。

https://github.com/Gewuji/dsh-plugin-work-notes

完成後重啓 DSH(桌面端退出重開;Web 端重啓 dsh 服務),再刷新頁面。

方式二:命令行裝

dsh plugin --profile web add https://github.com/Gewuji/dsh-plugin-work-notes
# 等價寫法
dsh plugin --profile web add github:Gewuji/dsh-plugin-work-notes

裝完重啓 dsh 服務(或退出重開桌面客戶端),刷新頁面。

--profile 跟你要使用的 profile 走:命令行 / npx @deepseek-ai/dsh web 啓動的通常是 web。桌面客戶端由 Electron 獨佔管理 desktop profile,命令行不允許改它,所以桌面端請用方式一。

方式三:本地開發(拷貝目錄安裝)

dsh plugin --profile web add D:\path\to\dsh-plugin-work-notes

路徑必須是絕對路徑。安裝成功後,左側欄出現筆記形狀的「工作便籤」圖標,點開即可使用。

典型用法

操作 效果
頂部輸入框 + 回車 / Ctrl + Enter 新增便籤
拖動卡片 / 拖右下角 移動 / 縮放
按住 Alt 拖動 臨時關閉自動吸附
卡片上的顏色點、圖釘、狀態 換色 / 置頂 / 切換狀態
頂部「便籤 / 日曆 / 甘特」 切換視圖
記「週五前整理週會紀要」 新建時自動解析出日期
「持續 3 天」 由單個開始日展開成區間

數據與隱私

存儲鍵是 dsh-work-notes.v1,寫在瀏覽器 localStorage 裏。桌面端頁面源是 dsh-app://app,Web 端是 http://127.0.0.1:3080(可用 --port 改),因此桌面端與瀏覽器之間、換端口之後,便籤不共享、不遷移;同一端反覆啓動是本地的,不會丟。數據不上傳、不寫會話記錄,換電腦請自行導出或手工複製。

卸載

圖形界面:在「設置 → 插件 → 已安裝」裏找到 dsh-plugin-work-notes 刪除。命令行:

dsh plugin --profile web remove dsh-plugin-work-notes

卸載不會刪除已有便籤,便籤仍在瀏覽器存儲裏。想徹底清掉,在該站點的 localStorage 中刪除 dsh-work-notes.v1。

適用場景與注意

適合在 DSH 里長期待着、需要隨手記待辦和排日期的人:左側欄常駐,不用切窗口。

需要注意幾點:插件以當前 dsh 進程的權限運行,安裝前建議先讀一遍源碼並確認許可證(本項目爲 MIT)。它面向 DSH 0.1.x(在 0.1.7-rc.2 上驗證),依賴的穩定接口只有 dsh.client bundle 格式、sidebar.panellist / main 兩個註冊點,以及 dsh-client-ui-layout + dsh-client-ui-sidebar 注入;DSH 升到 0.2 / 1.0 等大版本若改動這些接口,插件需要跟着更新。桌面端和 Web 端通用,但兩邊各自獨立存數據。

項目爲單文件前端實現(client.js),沒有構建步驟,改完重啓服務並刷新頁面即可生效,瀏覽器端改動也可走 DSH 的 HMR。

結尾

它的價值在於把便籤、日曆、甘特收進 DSH 的左側欄,本地存儲、不越界。目錄頁:https://www.skillhub.cn/plugins/Gewuji/dsh-plugin-work-notes,倉庫:https://github.com/Gewuji/dsh-plugin-work-notes。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜