前言¶

在 DeepSeek Harness（DSH）里長時間開多個會話時，手頭要跟進的事項往往散在筆記、聊天或外部工具裏，切回 DSH 界面時不一定立刻看到「下一件該做什麼」。常見做法是在瀏覽器另開 Tab 記待辦，或依賴會話外的任務應用，與當前 DSH Web UI 是兩套上下文。

下面介紹社區插件 dsh-todo（維護者 OverToWind，分類爲客戶端）：在會話標題欄增加一個待辦按鈕，背後掛浮動面板；未完成項在按鈕上輪播，並按截止時間整鈕着色。數據存在瀏覽器 localStorage，不註冊宿主側服務，適合只想在 DSH 界面內輕量記任務、又不想單獨開應用的開發者。

這是什麼¶

dsh-todo 是面向 DSH Web UI 的 Cordis bundle 插件：會話 header 裏一個按鈕，點擊後展開浮動面板，用於新增、編輯、勾選和刪除待辦。簡介可概括爲：header 輪播未完成項、按緊急度着色、面板常駐可操作。

• 目錄頁：https://www.skillhub.cn/plugins/OverToWind/dsh-todo
• 源碼與說明：https://github.com/OverToWind/dsh-todo
• 許可證：MIT（README 與 package.json 一致）
• package.json 中版本爲 1.0.0

DSH 生態強調「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。安裝前請自行閱讀源碼與許可證——插件隨當前 DSH 進程 / 瀏覽器上下文運行，權限與宿主一致。

核心功能¶

以下能力均來自項目 README 與中文說明，可直接對照倉庫驗證。

標題欄輪播（Header ticker）¶

未完成事項每 4 秒在按鈕文案上切換一條；鼠標懸停按鈕，或浮動面板打開時，輪播暫停。已完成項不參與輪播。

緊急度着色（Urgency tinting）¶

整顆按鈕按截止時間着色：逾期爲紅，24 小時內爲琥珀色，更晚爲綠，全部完成時爲中性色。面板內每一行使用同一套規則。

常駐面板（Persistent panel）¶

支持新增；編輯文字與截止時間；勾選完成；刪除；清除已完成。列表按緊急度排序，已完成項收進 Done (n) /「已完成 n 項」摺疊區。

快捷截止時間¶

提供 Today / Tomorrow 快捷 chip：分別爲當天 18:00 與次日 09:00；也可用手選 datetime，或不限截止時間。

本地持久化¶

條目保存在 localStorage，鍵名爲 dsh-todo.items.v1，刷新頁面後仍保留。

主題與語言¶

顏色僅使用 DSH 的 --dsw-alias-* token，亮暗主題隨 DSH。界面文案隨宿主 locale 爲英文或中文（locale/en.json、locale/zh.json）。

掛載點¶

shell.overlay 默認可穿透點擊；面板卡片會顯式恢復指針事件，以便交互。

安裝與啓用¶

官方 README 給出的從 GitHub 安裝方式如下（請將 <profile> 換成你的 DSH profile 名）：

# from GitHub
dsh plugin --profile <profile> add github:OverToWind/dsh-todo

若已在本地有一份插件目錄（非本文要求的 git clone 步驟，僅指你已有路徑），可在 DSH 會話內安裝 bundle：

plugin_manager action=install_bundle target=<path to a local clone>

安裝後需要 重啓或刷新 DSH。該插件不註冊 host 側服務，渲染與狀態均由 client 半部承擔（client.js；index.js 的 host 半部爲空）。

典型用法¶

1. 按上一節命令爲指定 profile 安裝插件並刷新 Web UI。
2. 在任意會話標題欄 utilities 區域找到 dsh-todo 按鈕；觀察未完成項輪播與按鈕着色。
3. 打開面板：添加任務，用 Today / Tomorrow 或 datetime 設截止，或選不限時間。
4. 勾選完成、編輯、刪除或「清除已完成」；已完成區在摺疊段中查看。
5. 刷新瀏覽器，確認 localStorage 鍵 dsh-todo.items.v1 下數據仍在（開發者工具 → Application → Local Storage）。

維護者在倉庫中提供無瀏覽器校驗（stub window / document / localStorage 與最小 React，斷言渲染樹）：

node --check client.js
node scripts/verify-render.mjs     # 40 checks

適用場景與注意¶

適合：在 DSH Web UI 內做會話級輕量待辦；需要截止時間與視覺優先級提示；希望數據只留在本機瀏覽器、不依賴後端任務服務。

注意：

• 數據僅存當前瀏覽器 profile 的 localStorage，換設備或清站點數據會丟失，重要事項請另有備份策略。
• 插件爲純客戶端 bundle（dsh.client.platform: web，immediately: true），依賴 @deepseek-ai/dsh-client-ui-conversation 注入。
• 安裝前請閱讀 https://github.com/OverToWind/dsh-todo 源碼與 MIT 許可證；勿在未審閱的情況下在生產環境盲目啓用第三方插件。

結尾¶

dsh-todo 把待辦收進 DSH 會話標題欄：輪播提醒未完成項、按截止着色，並用浮動面板完成增刪改查與本地持久化。需要詳情與 issue 請訪問 GitHub；在 SkillHub 目錄頁可查看插件元信息與分類（客戶端）。

• 目錄：https://www.skillhub.cn/plugins/OverToWind/dsh-todo
• GitHub：https://github.com/OverToWind/dsh-todo