前言¶
在 DeepSeek Harness（DSH）裏做 Agent 或日常開發時，工作痕跡往往分散在釘釘（待辦、日誌、聽記、會話）和阿里云云效（需求、代碼、流水線、報工）兩側。各自打開控制台或 CLI 能查單點數據，卻很難在同一時間軸上對照「這週報了哪些工、提交了哪些需求、會議裏留下了什麼行動項」。下面介紹社區插件 WorkHub（npm 包 @ahao430/dsh-workhub）：在 DSH 內把雙端數據同步進本機 SQLite，用面板和 Agent 工具做統計、日曆、報告與受控寫操作，無需自建後端。
這是什麼¶
WorkHub 由維護者 ahao430 發佈，在 SkillHub 等社區目錄中歸類爲客戶端類 DSH 插件（README 同時說明其爲 Host + Client 雙端插件：Host 負責採集、存儲、分析與 Agent 工具；Client 以 React 面板嵌入 DSH Web UI）。定位是「釘釘 × 雲效個人工作智能臺」：用確定性 SQL 聚合看清工作全貌，AI 總結與洞察需攜帶來源證據。數據默認落在 $DSH_PROFILE_DIR/workhub/data.db（無該環境變量時回退 ~/.dsh/workhub/data.db）。許可證爲 MIT（見倉庫與 npm 包信息）。
核心功能¶
雙數據源同步¶
README 將能力歸納爲雙數據源（11 個同步源），主要包括：
| 來源 | 能力（摘自 README） |
|---|---|
| 釘釘（經 DWS CLI） | 待辦、日誌/日報、AI 聽記（含摘要/關鍵詞/行動項）、會話註冊表、聊天消息（按需）、考勤打卡、日曆日程 |
| 雲效（OpenAPI） | 項目空間、代碼倉庫、流水線、需求/任務、Commit、報工工時、需求排期節點 |
釘釘側需先安裝並登錄 DWS CLI（dws auth login）；雲效側在面板「數據管理」中配置 API Base URL、組織 ID（可留空自動獲取）與 PAT，Token 寫入系統鑰匙串，SQLite 僅保存引用。
面板能力¶
- 工作駕駛艙：時間範圍（含「上週五 → 本週四」報工週期）、粒度分級、上期對比、項目投入、活動趨勢、進行中需求（按身份過濾）、AI 洞察卡。
- 工作日曆：月/周視圖，打卡時段與報工時長、每日總結、雲效排期節點、事件時間線。
- 項目分析：手動項目與雲效項目空間歸集，報工、提交、需求狀態與跨系統關聯項。
- 聊天洞察：會話選擇與按需採集、發言統計、會話小結（話題/行動項/未決問題）。
- 工作效能：周×小時熱力圖、時段分佈、協作對象排行（README 註明爲活動代理指標，不等同於工時）。
- 智能報告：規則版週報/日報，可導出 Markdown。
- 快捷執行：雲效流水線運行、應用交付（搜索/收藏/部署/按歷史回滾），寫操作二次確認並記審計日誌。
- 數據管理：雙源連接狀態、能力矩陣與同步操作。
Agent 工具¶
Host 側註冊 15 個 workhub_* 工具（README 描述爲只讀或帶確認）；洞察與總結需強制關聯 sourceReferences 等來源字段，與「統計由 SQL、LLM 只做解釋」的設計約定一致。
安裝與啓用¶
從 npm 安裝（README 推薦）：
dsh plugin add @ahao430/dsh-workhub
上述命令將包裝進當前 DSH profile。包爲工作區目錄形式的 bundle（dsh.bundle 指向 cordis.patch.yml）。
從 GitHub 源碼安裝： 在 DSH 中通過 plugin_manager 的 install_bundle 指向倉庫目錄，或使用 README 給出的 dsh plugin add github:ahao430/dsh-workhub；安裝後插件行 id 爲 workhub，用 set_plugin 啓用，刷新 Web UI 後左側邊欄出現 WorkHub 圖標。
釘釘數據採集的前置條件：
dws auth login
典型用法¶
配置雲效¶
- 雲效控制台 → 個人設置 → 個人訪問令牌 → 創建 PAT（README 建議權限：用戶信息、項目、需求/任務、代碼管理、報工；工作流可選）。
- 打開 WorkHub「數據管理」→ 阿里云云效卡片。
- 填入 API Base URL（中心站
https://openapi-rdc.aliyuncs.com，或 Region 專屬域名）、組織 ID、PAT，保存。
憑證失效時¶
DWS access token 約 2 小時刷新；refresh token 過期後，數據管理裏釘釘卡片會提示需重新登錄，面板提供一鍵重新登錄或複製 dws auth login 在終端執行。歷史數據仍可讀，增量同步在重登前暫停。
在 Agent 側¶
在 DSH 對話中可調用已註冊的 workhub_* 工具查詢本地聚合結果；涉及流水線運行、部署等寫操作會走確認與審計流程（細節以插件當前實現爲準）。
適用場景與注意¶
適合誰： 日常同時使用釘釘（DWS CLI）與雲效、希望在 DSH 內統一看板、日曆、週報，並偶爾從面板或 Agent 觸發受控雲效操作的個人開發者。
使用前請知悉：
- 插件以當前 DSH 進程權限運行，會調用本機
dws、訪問雲效 OpenAPI 並讀寫本地 SQLite；安裝前請閱讀 GitHub 源碼 與 MIT 許可證。 - 聊天原文爲按需採集，並有保留策略；勿將 PAT 或日誌提交到公開倉庫。
- 社區目錄 SkillHub 插件頁 與
awesome-dsh-plugin列表獨立於 DeepSeek / 幻方，並非官方應用商店。 - README 路線圖仍列有未完成功能（如缺陷/MR 同步、面板內直連模型總結、團隊視圖等），以倉庫當前 tag / npm 版本爲準（
package.json抓取版本爲 0.1.0）。
結尾¶
WorkHub 把釘釘與雲效的工作數據收到本機，用駕駛艙、日曆、項目分析與規則報告補齊「看清工作如何發生、如何推進」這一環，並在 DSH 內提供可審計的快捷執行與 workhub_* Agent 工具。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫。
