@ahao430/dsh-workhub
DeepSeek Harness 中用于 DingTalk 和 Yunxiao 的个人工作智能中心：将工作数据同步到本地 SQLite，并提供仪表盘、工作日历、项目分析、报告以及 workhub_* 代理工具。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ahao430/dsh-workhub#3e85976174f2d247f5b487fcbd4507bec7fc2f34
Workhub 以 @ahao430/dsh-workhub 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把钉钉与云效的工作数据聚合到本地，用确定性统计看清工作全貌，用 AI 总结回溯每件事的来源。
钉钉和云效记录工作，WorkHub 帮你看清工作如何发生、如何推进，以及下一步该做什么。
这是一个 DeepSeek Harness（DSH）双端插件：Host 侧负责数据采集、存储、分析与 Agent 工具；Client 侧以 React 面板形式嵌入 DSH Web UI。数据全部保存在本机 SQLite，不需要部署任何后端服务。
双数据源（11 个同步源）
| 数据源 | 能力 |
|---|---|
| 钉钉（DWS CLI） | 待办、日志/日报、AI 听记（含摘要 / 关键词 / 行动项）、会话注册表、聊天消息（按需）、考勤打卡、日历日程 |
| 云效（OpenAPI） | 项目空间、代码仓库、流水线、需求/任务、Commit、报工工时、需求排期节点 |
核心能力
workhub_* 工具，全部只读或带确认；报告输入含按人维度（byPerson），AI 周报/日报可按人分区；AI 洞察与总结强制携带来源证据工作驾驶舱：时间范围、项目投入、活动趋势、周期对比与 AI 洞察以下截图由
tests/screenshot.mjs用合成示例数据渲染真实组件生成，不含任何真实组织或业务信息。
工作日历：卡片优先展示打卡时段、报工时长与当日主力需求；今日高亮。点选日期查看每日总结、云效排期节点、会议纪要与事件时间线。
工作日历：月视图、打卡/报工/需求卡片、每日总结项目分析：手动项目与云效项目空间统一归集，展示报工工时、提交数、需求状态分布与跨系统关联项。
项目分析：指标卡、需求状态分布、AI 洞察、关联工作项聊天洞察：选定会话后直接生成会话小结——话题分组、行动项候选、未决问题，可导出或删除。
聊天洞察：会话小结（话题/行动项/未决问题）智能报告：规则版周报即时生成（工作概况 / 逐日概览 / 代码推进 / 会议与决策 / 沟通协作 / 风险 / 下周计划），支持导出 Markdown。
智能报告：报告草稿与每日总结工作效能：周×小时热力图、时段分布与协作对象排行（活动代理指标，不等同于工时或生产力）。
工作效能：热力图、时段分布、协作对象数据管理：钉钉 / 云效双数据源连接状态、能力矩阵、12 个同步源与同步操作；云效 PAT 只存系统钥匙串。
数据管理：双数据源、能力矩阵、同步状态快捷执行：云效流水线运行（二次确认）与应用交付（应用搜索/收藏/备注，一键部署与按历史部署单回滚），全部写操作审计留痕。
快捷执行：流水线运行、应用交付环境与部署单、操作审计包名：@ahao430/dsh-workhub（工作区目录形式的 bundle，dsh.bundle 指向 cordis.patch.yml）。
从 npm 安装（推荐）：
dsh plugin add @ahao430/dsh-workhub # 装进当前 profile
从 GitHub 源码安装：
在 DSH 中用 plugin_manager 的 install_bundle 指向本仓库目录（或 dsh plugin add github:ahao430/dsh-workhub），随后用 set_plugin 启用 workhub 行。
插件市场：条目位于 awesome-dsh-plugin（
tools分类）；仓库根目录的screenshots.json用于市场详情页展示截图。
需要先安装并登录 DWS CLI（dws auth login）。
# 在工作区克隆本仓库后，把插件安装进当前 DSH profile
# 安装动作由 DSH 的 plugin_manager 完成（见下文「安装到 DSH」）
本仓库是 工作区目录形式的 DSH bundle（package.json 中 dsh.bundle.patch + dsh.client），安装方式：
plugin_manager 的 install_bundle，target 指向本目录绝对路径；workhub，用 set_plugin 启用；https://openapi-rdc.aliyuncs.com，或你的 Region 专属域名）、组织 ID（可留空自动获取）、PAT；credentialRef，代码与日志均不落明文。若 PAT 在某处泄露，请在云效侧轮换：生成新 Token 后在卡片里覆盖保存即可。
DWS 的 access token 约 2 小时一换，由 refresh token（约 30 天）自动续期，通常无感。refresh token 过期或被撤销后：
dws auth login 会自动打开浏览器完成 OAuth Loopback 授权，完成后面板自动刷新）dws auth login 命令与复制按钮，可在终端执行$DSH_PROFILE_DIR/workhub/data.db（无 DSH_PROFILE_DIR 时回退 ~/.dsh/workhub/data.db），SQLite node:sqlite。sourceReferences 记录来源。tests/fixtures/ 为脱敏示例数据，不含任何真实组织信息。dsh-workhub/
├── index.js # Host 入口：webServer 路由 / Agent 工具 / 定时同步
├── client.js # Client 入口：面板、页面、设计系统
├── lib/
│ ├── dws-executor.js # 唯一 spawn 出口（超时/并发/输出上限/JSON 容错）
│ ├── dws-client.js # 钉钉命令封装（argv 白名单）
│ ├── collector/ # 钉钉 & 云效采集器、同步管理
│ ├── yunxiao/client.js # 云效 OpenAPI 客户端（node:https + PAT）
│ ├── storage/db.js # SQLite schema、迁移、聚合查询
│ ├── security/credential-store.js # 钥匙串凭证存储
│ ├── time.js # 时间预设/粒度/对比区间
│ ├── watchdog.js # 规则引擎（逾期、沉寂项目等）
│ ├── api.js # 同源 HTTP API（只读 + 受控写）
│ └── tools.js # Agent 工具注册
├── locale/ # 插件展示元数据
└── tests/render-check.mjs # 客户端渲染冒烟测试
node --check client.js # 语法检查
node tests/render-check.mjs # 渲染冒烟测试（8 个页面 + 数据子组件）
node tests/manifest-check.mjs # 发布物料检查（清单 / files / 本地化 / 截图）
node tests/screenshot.mjs # 用合成数据生成 docs/screens/*.html（再用无头浏览器转 PNG）
设计约定：
--dsw-alias-*）做背景/边框/正文，强调色使用插件自有高对比色板（保证浅色/深色主题都清晰）；DwsExecutor，参数由白名单生成，禁止拼接 shell 字符串；日常提交由 .github/workflows/ci.yml 自动跑语法检查、渲染冒烟测试和物料检查。发版以 git tag 为发布标记：
# 1. 改 package.json 的 version（如 0.2.0），提交推送
git commit -am "chore: 0.2.0" && git push
# 2. 打 tag 并推送（git tag 即发布记录，不走 npm 分发）
git tag v0.2.0 && git push origin v0.2.0
如需发布到 npm，本地执行 npm publish --access public（或按 tag 版本号恢复 Publish 工作流并配置 NPM_TOKEN）。
MIT