前言¶
在 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 仓库。
