dsh-activity-board 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 hyper and contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,179 @@
1
- # Temporary Holding Version
1
+ # dsh-activity-board — a session activity board for DSH
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ English | [中文](README.zh.md)
4
+
5
+ A Web client plugin for [DSH (DeepSeek Harness)](https://github.com/deepseek-ai/deepseek-harness)
6
+ that turns **what your sessions are actually doing right now** into a three-column
7
+ **activity board** — **In progress**, **Needs confirmation**, and **Recent
8
+ activity** — where each card shows status, workspace, live background-job
9
+ progress, and the **last assistant reply excerpt**. Click a card to open that
10
+ conversation.
11
+
12
+ > **Different from a task board.** This is **not** another place where you hand-build
13
+ > tasks. Its cards are a **read-only projection of your real session activity** — it
14
+ > reads what sessions are running, blocked on you, or recently touched and mirrors
15
+ > them, including live jobs and the latest reply. Nothing to create, nothing to keep
16
+ > in sync; it reflects your actual work the moment it happens.
17
+
18
+ - A read-only projection of Host state; it changes **no** session, message, or model-visible input.
19
+ - No user configuration; it works once installed and reads the same data source as the sidebar.
20
+
21
+ ## Why not a task board / dashboard?
22
+
23
+ The DSH ecosystem already has several **task-management** plugins (e.g. `dsh-taskboard`,
24
+ `dsh-kanban`, `dsh-workbench-tasks`) and a widget **dashboard** (`dsh-workboard`). They
25
+ are built around a task store *you* own: you create cards, agents claim or update them,
26
+ and the board is a record of that store. They are great at that — but they answer
27
+ "what did I plan?", not "what is happening in my sessions right now?".
28
+
29
+ This plugin answers the second question and only the second: a **zero-maintenance
30
+ activity mirror** of your sessions. No task ledger, no model-facing tools, no injected
31
+ prompt — just the live state you would otherwise have to open each conversation to see.
32
+
33
+
34
+ ## Features
35
+
36
+ - **Three-column board**
37
+ - **In progress**: sessions whose turn is running, have running subagents, or
38
+ still have live background jobs (a job that outlives its turn), showing the
39
+ job's live progress line (e.g. `3/10`, current command/phase).
40
+ - **Needs confirmation** (human-in-the-loop): sessions blocked on you —
41
+ approval (`approval`), an answer (`question`), or a plan review (`plan-review`).
42
+ - **Recent activity**: recently updated idle sessions (paginated, see below).
43
+ - **Top stats**: In progress / Awaiting / Recent / Total sessions.
44
+ - **Time-range filter**: Today / This week / This month / All / **Custom**
45
+ (popover with presets — today, yesterday, last 3/7/30 days — or an explicit
46
+ start/end date, precise to the day). Defaults to **Today**. The range scopes
47
+ the Recent column and the totals.
48
+ - **Per-card excerpt**: the session's last assistant reply as plain text
49
+ (Markdown stripped), clamped to two lines and **expanded on hover/focus**.
50
+ Excerpts are read only for the newest 20 sessions to bound cost.
51
+ - **Automation hidden by default**: sessions bound to an active scheduled task
52
+ (reminder) are hidden; a header toggle reveals them and shows how many are hidden.
53
+ - **Search**: filter by title or workspace instantly.
54
+ - **Infinite scroll / load more**: the Recent column starts at 12 and loads +12
55
+ as you scroll to the bottom (or via a Load more button). Every column is capped
56
+ so a huge session count never renders all at once.
57
+ - Bilingual (English/Chinese) and light/dark aware.
58
+
59
+ ## Screenshots
60
+
61
+ Three-column kanban (stats bar, in-progress / needs-confirmation / recent, per-card reply excerpt, time-range filter):
62
+
63
+ | Light | Dark |
64
+ |---|---|
65
+ | ![light](docs/screenshot-light.png) | ![dark](docs/screenshot-dark.png) |
66
+
67
+ ## Install
68
+
69
+ **Recommended: install from npm** (the package ships a prebuilt `lib/`).
70
+
71
+ ```sh
72
+ # into the default profile, or name one
73
+ dsh plugin add dsh-activity-board
74
+ dsh plugin --profile web add dsh-activity-board
75
+ ```
76
+
77
+ Then restart `dsh web` (or close and reopen the GUI) and refresh the page. A
78
+ An **Activity board** entry appears in the sidebar between Plugins and Automation tasks.
79
+
80
+ **Or install from the in-app plugin market** if you configure a market index
81
+ that lists this plugin (see "Ecosystem" below).
82
+
83
+ ### From a Git source install (advanced)
84
+
85
+ A Git install fetches **sources, not built artifacts**, so it needs a local DSH
86
+ source checkout to build (the client bundle preset, CSS handling, and
87
+ `@deepseek-ai/*` type declarations live in the monorepo):
88
+
89
+ ```sh
90
+ DSH_CHECKOUT=/path/to/deepseek-harness dsh plugin add 'github:<you>/dsh-activity-board#<sha>'
91
+ ```
92
+
93
+ pnpm will refuse the package's `prepare` build script on the first attempt; add
94
+ the exact package key it prints to the profile's `pnpm-workspace.yaml`:
95
+
96
+ ```yaml
97
+ allowBuilds:
98
+ dsh-activity-board: true
99
+ ```
100
+
101
+ and retry. To avoid asking users to build, publish to npm (prebuilt) instead.
102
+
103
+ ## How it loads
104
+
105
+ DSH's Web plugin mechanism: any Host Loader package that declares `dsh.client` in
106
+ its `package.json` and exports `./client` (built to `lib/client.js`, wrapped as
107
+ `window.__ModuleLoader__.load({ id, factory })`) is scanned by
108
+ `@deepseek-ai/dsh-client-modules`, which injects the browser bundle into the
109
+ `window.__DSH_BOOT__` module graph.
110
+
111
+ The page registers a root-level `main` keyed slot (`key: 'workbench'`) plus a
112
+ `sidebar.panellist` entry that selects it via `ctx.layout.selectPanel('workbench')`,
113
+ becoming a global page beside Plugins and Automation tasks.
114
+
115
+ All data is ambient; the plugin holds no transport state:
116
+
117
+ | Source | Purpose |
118
+ |---|---|
119
+ | `useSessions` (ui-session root source, injected as a global prop) | session `ids` / `byId` (`displayTitle`, `cwd`, `running`, `updatedAt`) |
120
+ | `useSessionStatus` (same) | per-session `running` / `pendingInteraction` |
121
+ | `hooks.jobs = ctx.jobs.state` | background-job roster and `progress` (with `ctx.jobs.watchRows`) |
122
+ | `hooks.schedule` (`ctx.remote.schedule.catalog`) | sessions bound to an active reminder (for default-hiding) |
123
+ | `hooks.workspaces = ctx.workspaces.list` | archived session ids (archived sessions are hidden) |
124
+ | `ctx.uiWorkspace.openSession` | open a conversation |
125
+ | `ctx.remote.session.follow` (newest 20 sessions only) | last assistant reply excerpt |
126
+
127
+ ## Develop / build
128
+
129
+ ```sh
130
+ # 1) link the DSH source checkout's packages into this project's node_modules (once)
131
+ npm run link-deps
132
+ # 2) build: tsc emits lib/types → tsdown emits lib/index.js + lib/client.js
133
+ npm run build
134
+ ```
135
+
136
+ The default checkout path is `../../../source/deepseek-harness` (relative to this
137
+ project); override with `DSH_CHECKOUT=/path/to/deepseek-harness`. It uses the
138
+ checkout's `tsc` and `tsdown`; if the checkout was never built, run `pnpm run build`
139
+ there first (or at least ensure each `packages/*/*/lib/types` exists).
140
+
141
+ Publishing to npm ships the prebuilt `lib/` (see the `files` list), so consumers
142
+ never build.
143
+
144
+ ## Ecosystem
145
+
146
+ This is a community DSH plugin. To help others find it:
147
+
148
+ - Add the **`dsh-plugin`** topic to the GitHub repo.
149
+ - (Optional) Host a **format-1 plugin market index JSON** (validated by
150
+ `@deepseek-ai/dsh-plugin-market-index`: `parseMarketIndex` / `marketInstallTarget`).
151
+ Users add it as an index URL and can then find and one-click install the plugin
152
+ from the GUI's Discover page. The repo's `apps/plugin-market-generator` can
153
+ generate/validate an index.
154
+
155
+ > The official DSH repository currently **does not accept external pull requests**
156
+ > (see its `CONTRIBUTING.md`); community plugins are the encouraged path.
157
+
158
+ ## Known limitations
159
+
160
+ - "In progress" progress comes from background jobs (`JobView.progress`/`label`);
161
+ plain conversation turns have no unified milestone/percentage field, so those
162
+ show only a "Running" state.
163
+ - `pendingInteraction.kind` is mapped by string; a new upstream kind falls back to
164
+ the generic "Needs confirmation" wording.
165
+ - The time range scopes the Recent column and totals; In-progress / Needs-confirmation
166
+ are always shown (active work should always be visible).
167
+ - Excerpts read a handful of recent records; very long replies are clipped to
168
+ ~4000 chars (two-line clamp on the card, full text on hover).
169
+
170
+ ## Contact
171
+
172
+ - Technical questions / bug reports: please open an [Issue](https://github.com/hyper-open/dsh-activity-board/issues) so the answer stays searchable for others.
173
+ - Chat / collaboration / licensing: add me on WeChat (scan the QR code, note "GitHub").
174
+
175
+ <p align="center"><img src="docs/images/wechat-qrcode.jpg" width="220" alt="Author WeChat"></p>
176
+
177
+ ## License
178
+
179
+ [MIT](LICENSE)
package/README.zh.md ADDED
@@ -0,0 +1,165 @@
1
+ # dsh-activity-board — DSH 会话活动看板
2
+
3
+ [English](README.md) | 中文
4
+
5
+ 一个 [DSH(DeepSeek Harness)](https://github.com/deepseek-ai/deepseek-harness) 的
6
+ Web 客户端插件:把**你的会话此刻真实在做的事**投影成一块三栏**活动看板**——「进行中」
7
+ 「待确认」「最近活跃」,每张卡片显示状态、工作区、实时后台任务进度和**最后一条回复
8
+ 摘要**;点击卡片直接进入对应会话。
9
+
10
+ > **和"任务看板"不是一回事。** 这不是又一个让你手工建卡的任务系统。它的卡片是**对你
11
+ > 真实会话活动的只读投影**——读取哪些会话在跑、在等你处理、或最近被改动,连实时后台
12
+ > 作业与最新回复一并镜像出来。**无需建卡、无需维护同步**,工作一发生它就反映出来。
13
+
14
+ - 只读地投影 Host 已有状态,**不改变**任何会话、消息或模型可见输入。
15
+ - 无用户配置项,装上即用;数据源与会话侧边栏同源。
16
+
17
+ ## 为什么不是任务看板 / dashboard?
18
+
19
+ DSH 生态已有若干**任务管理**插件(如 `dsh-taskboard`、`dsh-kanban`、`dsh-workbench-tasks`)
20
+ 和一个 widget **仪表盘**(`dsh-workboard`)。它们围绕**你自己拥有的任务库**构建:你建卡、
21
+ agent 认领或更新,看板是那份任务库的记录。它们擅长回答"我计划了什么?",但**不是**回答
22
+ "我的会话此刻在发生什么?"。
23
+
24
+ 本插件只回答且专注回答第二个问题:对会话做一块**零维护的活动镜像**。没有任务台账、没有
25
+ 模型侧工具、不注入提示词——只呈现那些你原本要逐个打开会话才能看到的实时状态。
26
+
27
+ ## 功能
28
+
29
+ - **三栏看板**
30
+ - **进行中**:轮次在跑、有运行中的子任务、或仍有活跃后台作业(`job` 尚未结束)的会话,
31
+ 并显示后台作业的实时进度行(如 `3/10`、当前命令/阶段)。
32
+ - **待确认**(Human-in-the-loop):等待你介入才能继续的会话——
33
+ 等待审批(`approval`)、等待回答(`question`)、计划待审(`plan-review`)。
34
+ - **最近活跃**:最近更新过的空闲会话(分页加载,见下)。
35
+ - **顶部统计卡**:进行中 / 待确认 / 最近活跃 / 会话总数。
36
+ - **时间范围筛选**:今日 / 本周 / 本月 / 全部 / **自定义**(弹出面板 + 快捷预设:今天、
37
+ 昨天、近 3/7/30 天,或自定义起止日期,精确到日)。默认「今日」。时间范围作用于
38
+ 「最近活跃」栏与统计。
39
+ - **每卡片摘要**:显示该会话最后一条助手回复的纯文本摘要(已去除 Markdown 标记),
40
+ 两行省略,**悬停/聚焦展开全文**。摘要只为最新 20 个会话读取,控成本。
41
+ - **默认隐藏自动化会话**:绑定了活跃定时任务(reminder)的会话默认不显示,右上角开关
42
+ 可临时显示(并在开关旁标出隐藏数量)。
43
+ - **搜索**:按标题或工作区即时过滤。
44
+ - **无限滚 / 加载更多**:最近活跃栏首屏 12 个,滚动到底自动加载 +12,或点「加载更多」。
45
+ 各栏都有渲染上限,会话再多也不会一次性渲染全部。
46
+ - 中英双语、明暗主题自适应。
47
+
48
+ ## 截图
49
+
50
+ 三栏看板(统计卡、进行中 / 待确认 / 最近活跃、每卡片回复摘要、时间范围筛选):
51
+
52
+ | 浅色 | 深色 |
53
+ |---|---|
54
+ | ![light](docs/screenshot-light.png) | ![dark](docs/screenshot-dark.png) |
55
+
56
+ ## 安装
57
+
58
+ **推荐:从 npm 安装**(包内已含预构建的 `lib/`)。
59
+
60
+ ```sh
61
+ # 直接安装(加到默认或指定 profile)
62
+ dsh plugin add dsh-activity-board
63
+ # 或指定 profile
64
+ dsh plugin --profile web add dsh-activity-board
65
+ ```
66
+
67
+ 然后重启对应的 `dsh web`(或关闭再开 GUI),刷新页面,侧边栏「插件 / 自动化任务」之间
68
+ 会出现 **活动看板** 入口。
69
+
70
+ **或者:在 GUI 的插件市场里安装**(若你配置了包含本插件的市场索引,见下文「生态」)。
71
+
72
+ ### 从 Git 源码安装(进阶)
73
+
74
+ Git 安装拉取的是**源码而非构建产物**,因此需要本机有一份 DSH 源码 checkout 来构建
75
+ (客户端的 bundle 预设、CSS 处理与 `@deepseek-ai/*` 类型声明都在 monorepo 内):
76
+
77
+ ```sh
78
+ DSH_CHECKOUT=/path/to/deepseek-harness dsh plugin add 'github:<you>/dsh-activity-board#<sha>'
79
+ ```
80
+
81
+ pnpm 首次会提示放行其 `prepare` 构建脚本;把 pnpm 打印的包名加入该 profile 的
82
+ `pnpm-workspace.yaml`:
83
+
84
+ ```yaml
85
+ allowBuilds:
86
+ dsh-activity-board: true
87
+ ```
88
+
89
+ 再重试安装。若不想让对方构建,直接发 npm 包(预构建)即可。
90
+
91
+ ## 使用须知
92
+
93
+ - 插件通过「profile 补丁里插入一行 Loader」加载。`dsh plugin add` 会自动完成;手动方式见
94
+ [贡献指南](../../../source/deepseek-harness/docs/user/develop/basic/publish.md)。
95
+ - 验证:启动日志里不应出现 `dsh-activity-board: failed to import` 或
96
+ `client-modules: ... failed to compose`;页面 `__DSH_BOOT__` 图应含 `"id":"dsh-activity-board"`。
97
+
98
+ ## 工作原理
99
+
100
+ DSH 的 Web 插件机制:Host Loader 中任一包若在 `package.json` 声明 `dsh.client` 并导出
101
+ `./client`(构建产物 `lib/client.js`,约定为 `window.__ModuleLoader__.load({ id, factory })`
102
+ 包装),`@deepseek-ai/dsh-client-modules` 会自动扫描该 Loader 行、把浏览器 bundle 注入
103
+ `window.__DSH_BOOT__` 模块图。
104
+
105
+ 页面通过注册根级 `main` 键槽(`key: 'workbench'`)+ `ctx.layout.selectPanel('workbench')`
106
+ (由 `sidebar.panellist` 入口触发)成为一个全局页面,与「插件」「自动化任务」同级。
107
+
108
+ 数据全部来自环境,插件不持有传输状态:
109
+
110
+ | 来源 | 用途 |
111
+ |---|---|
112
+ | `useSessions`(ui-session 根标准源,作为全局 prop 自动注入) | 会话 `ids` / `byId`(`displayTitle`、`cwd`、`running`、`updatedAt`) |
113
+ | `useSessionStatus`(同上) | 每会话 `running` / `pendingInteraction` |
114
+ | `hooks.jobs = ctx.jobs.state` | 后台作业花名册与 `progress`(配合 `ctx.jobs.watchRows` 订阅) |
115
+ | `hooks.schedule`(`ctx.remote.schedule.catalog`) | 绑定活跃定时任务的会话集合(用于默认隐藏) |
116
+ | `hooks.workspaces = ctx.workspaces.list` | 归档会话集合(归档会话不显示) |
117
+ | `ctx.uiWorkspace.openSession` | 打开会话 |
118
+ | `ctx.remote.session.follow`(仅最新 20 个会话) | 最后一条助手回复摘要 |
119
+
120
+ ## 开发 / 构建
121
+
122
+ ```sh
123
+ # 1) 把 DSH 源码 checkout 的包软链进本项目 node_modules(一次性)
124
+ npm run link-deps
125
+ # 2) 编译:tsc 产出 lib/types → tsdown 产出 lib/index.js + lib/client.js
126
+ npm run build
127
+ ```
128
+
129
+ 默认 checkout 路径为 `../../../source/deepseek-harness`(相对本项目),可用
130
+ `DSH_CHECKOUT=/path/to/deepseek-harness` 覆盖。依赖 checkout 的 `tsc` 与 `tsdown`;若
131
+ checkout 尚未构建,请先在其中 `pnpm run build`(至少确保各 `packages/*/*/lib/types` 存在)。
132
+
133
+ 发布到 npm 前构建产物已在 `lib/`,`files` 只包含产物与文档,无需安装方构建。
134
+
135
+ ## 生态与发现
136
+
137
+ 本插件属于 DSH 社区插件。为便于他人发现:
138
+
139
+ - 在 GitHub 仓库上打入 **`dsh-plugin`** topic。
140
+ - (可选)托管一个 **format-1 插件市场索引 JSON**(由
141
+ `@deepseek-ai/dsh-plugin-market-index` 校验:`parseMarketIndex` / `marketInstallTarget`),
142
+ 用户把它作为 index URL 加入后,即可在 GUI 的 Discover 页搜到并一键安装。仓库内的
143
+ `apps/plugin-market-generator` 可生成/校验索引。
144
+
145
+ > 说明:DSH 官方仓库目前**不接受外部 PR**(见其 `CONTRIBUTING.md`),官方鼓励以社区插件
146
+ > 形式分享。
147
+
148
+ ## 已知限制
149
+
150
+ - 「进行中」的进度来自后台作业(`JobView.progress`/`label`);纯对话轮次没有统一的
151
+ 里程碑/百分比进度字段,故该场景只显示「运行中」状态。
152
+ - `pendingInteraction.kind` 按字符串映射文案;上游新增 kind 会落到「待确认」通用文案。
153
+ - 时间范围作用于「最近活跃」与统计;「进行中 / 待确认」始终显示(活跃任务应始终可见)。
154
+ - 摘要读取最新的若干条历史记录;极长回复被裁剪到约 4000 字符(卡片上两行省略、悬停看更多)。
155
+
156
+ ## 联系作者
157
+
158
+ - 技术问题 / Bug 反馈:请提 [Issue](https://github.com/hyper-open/dsh-activity-board/issues),方便沉淀给后来人
159
+ - 交流 / 合作 / 授权:扫码添加微信(备注 GitHub)
160
+
161
+ <p align="center"><img src="docs/images/wechat-qrcode.jpg" width="220" alt="作者微信"></p>
162
+
163
+ ## 许可证
164
+
165
+ [MIT](LICENSE)
Binary file
Binary file
Binary file