@alpacachen/dsh-kanban 1.2.0 → 1.3.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.
Files changed (5) hide show
  1. package/README.md +53 -86
  2. package/README.zh.md +48 -81
  3. package/index.js +597 -81
  4. package/lib/client.js +132 -14
  5. package/package.json +4 -1
package/README.md CHANGED
@@ -2,138 +2,105 @@
2
2
 
3
3
  # dsh-kanban
4
4
 
5
- **Plan with your AI. See the work move.**
5
+ ### Plan with AI. Move work forward visually.
6
6
 
7
- A shared kanban board for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), built for both people and agents.
7
+ A collaborative kanban board where you and your AI agent plan, organize, and ship work together—without leaving DeepSeek Harness.
8
8
 
9
- [简体中文](README.zh.md) · English
9
+ [![npm version](https://img.shields.io/npm/v/@alpacachen/dsh-kanban?color=5b8def&label=npm)](https://www.npmjs.com/package/@alpacachen/dsh-kanban)
10
+ ![DeepSeek Harness Plugin](https://img.shields.io/badge/DeepSeek%20Harness-Plugin-7c5cff)
11
+ ![License](https://img.shields.io/badge/license-MIT-22c55e)
10
12
 
11
- </div>
13
+ [简体中文](README.zh.md) · **English**
12
14
 
13
- Turn a conversation into an actionable plan without copying tasks between your AI assistant and a project tracker. Ask the agent to break down a feature, prioritize a bug, or move finished work—the same changes appear instantly in the **Board** tab, where you can continue organizing everything by hand.
15
+ </div>
14
16
 
15
17
  <p align="center">
16
18
  <img src="./image.png" alt="dsh-kanban board inside DeepSeek Harness" width="100%">
17
19
  </p>
18
20
 
19
- ## Why dsh-kanban?
21
+ ## ✨ From conversation to action
20
22
 
21
- - **Plan in conversation** — 14 `kanban_*` tools let the agent create and manage cards, lists, and labels.
22
- - **Stay in control** — edit cards, drag work between lists, reorder your workflow, and filter by priority from the UI.
23
- - **Keep projects separate** — every DSH workspace gets its own board and persisted data.
24
- - **Feel at home in DSH** — the board follows the active language and theme, including dark mode.
25
- - **Install and go** — the browser bundle is prebuilt; no frontend toolchain or native build step is required.
23
+ Stop copying AI-generated plans into a separate project tracker. Tell your agent what you want to build, and watch it turn the plan into cards, priorities, labels, and workflow updates on the **Board** tab.
26
24
 
27
- ## Quick start
25
+ You can take over at any time—drag a card, refine a note, reorder a list—and the agent immediately works from the same board.
28
26
 
29
- ### 1. Install the plugin
27
+ | 💬 Plan naturally | 🧭 Stay in control | ⚡ Start instantly |
28
+ | --- | --- | --- |
29
+ | Manage the board with 14 built-in `kanban_*` tools. | Edit, drag, prioritize, label, and filter from the UI. | Install the prebuilt plugin—no frontend setup required. |
30
+ | **🗂️ Keep work separate** | **🌓 Feel at home** | **🤝 Share one source of truth** |
31
+ | Every DSH workspace gets its own board. | Follows your DSH language, theme, and dark mode. | You and the agent always see the same tasks and status. |
30
32
 
31
- Install the published npm package:
33
+ ## 🚀 Get started
34
+
35
+ ### 1. Install
32
36
 
33
37
  ```sh
34
38
  dsh plugin --profile web add @alpacachen/dsh-kanban
35
39
  ```
36
40
 
37
- GitHub source checkouts are not a supported installation method because the generated browser bundle is created only by CI for the npm package.
38
-
39
- Restart `dsh web` after installation so the plugin bundle is loaded. To confirm that it was added successfully:
41
+ Restart `dsh web` so the plugin bundle is loaded. You can confirm the installation with:
40
42
 
41
43
  ```sh
42
44
  dsh --profile web --dump-config
43
45
  ```
44
46
 
45
- The output should include a `dsh-kanban` layer.
47
+ Look for a `dsh-kanban` layer in the output.
46
48
 
47
- ### 2. Open the board
49
+ ### 2. Open your board
48
50
 
49
- Open a workspace and select the **Board** tab next to the conversation views. A new board starts with **Todo**, **In Progress**, **Review**, and **Done**.
51
+ Enter any workspace and choose the **Board** tab beside the conversation views. A fresh board starts with four familiar stages:
50
52
 
51
- ### 3. Plan with the agent
53
+ `Todo` → `In Progress` → `Review` → `Done`
52
54
 
53
- Try a prompt like:
55
+ ### 3. Ask your agent to plan
54
56
 
55
- > Break the authentication feature into implementation tasks, add one card per step, and mark the security review as P0.
57
+ Try this:
56
58
 
57
- The agent updates the board directly. You can then refine the plan in the UI, or keep working through conversation.
59
+ > Break the authentication feature into implementation tasks, create one card per step, and mark the security review as P0.
58
60
 
59
- ## What you can do
61
+ The cards appear directly on your board. Continue in conversation, or switch to the Board tab and shape the plan by hand.
60
62
 
61
- ### From the Board tab
63
+ ## 🧩 Everything you need to keep work moving
64
+
65
+ ### On the Board
62
66
 
63
67
  - Create, edit, delete, and drag cards between lists
64
68
  - Add notes, labels, and P0 / P1 / P2 priorities
65
- - Create, rename, reorder, and remove lists
66
- - Create labels and customize their colors
67
- - Filter the board by priority
68
-
69
- ### From a conversation
70
-
71
- The plugin makes these tools available automatically in every workspace conversation:
72
-
73
- | Area | Tools |
74
- | --- | --- |
75
- | Board | `kanban_get` |
76
- | Cards | `kanban_get_card`, `kanban_add_card`, `kanban_update_card`, `kanban_delete_card`, `kanban_move_card` |
77
- | Lists | `kanban_add_column`, `kanban_rename_column`, `kanban_delete_column`, `kanban_move_column` |
78
- | Labels | `kanban_get_label`, `kanban_add_label`, `kanban_update_label`, `kanban_delete_label` |
79
-
80
- A few more things you can ask:
81
-
82
- - “Summarize what is currently in progress.”
83
- - “Move ‘Fix login redirect’ to In Progress and set it to P0.”
84
- - “Add a Blocked list after In Progress.”
85
- - “Create a red Urgent label and apply it to the release card.”
86
-
87
- ## Data and persistence
69
+ - Open a card's activity timeline to see when it changed, what changed, and whether you or the agent made the change
70
+ - Track card creation, moves, title and note edits, label changes, and priority changes
71
+ - Send any card to the agent in your current conversation or a new one
72
+ - Create, rename, reorder, and remove workflow lists
73
+ - Create color-coded labels for fast visual scanning
74
+ - Filter the entire board by priority, or manually refresh it whenever needed
88
75
 
89
- Boards are isolated by workspace and stored through the DSH filesystem service as `kanban-board-<workspaceId>.json`. They survive browser refreshes and DSH restarts, and uninstalling the plugin does not delete existing board data.
76
+ ### Continue any card with your agent
90
77
 
91
- ## How it works
78
+ Open a card and choose **Chat with agent**. dsh-kanban carries its ID, title, label, and notes into either the current conversation or a fresh one, so the agent has the context it needs immediately. The content is inserted as an editable draft—it is never sent until you choose to send it.
92
79
 
93
- `dsh-kanban` uses the standard DSH bundle format:
80
+ ### In conversation
94
81
 
95
- - `index.js` registers the agent tools and the `/api/kanban` browser endpoint.
96
- - Both interfaces share one data layer, so the agent and the Board tab always operate on the same board.
97
- - `cordis.patch.yml` adds the plugin to the selected DSH profile.
98
- - `lib/client.js` is the prebuilt web client loaded by DSH.
82
+ The plugin automatically gives the agent these tools in every workspace:
99
83
 
100
- The client is built with React, TypeScript, Tailwind CSS, shadcn/ui, Radix UI, and dnd-kit. React itself is provided by DSH, keeping the distributed bundle smaller and avoiding duplicate runtimes.
101
-
102
- ## Development
103
-
104
- Requirements: Node.js and pnpm.
105
-
106
- ```sh
107
- pnpm install
108
- pnpm build
109
- pnpm typecheck
110
- ```
111
-
112
- For an unminified client bundle while debugging:
84
+ | Area | Tools |
85
+ | --- | --- |
86
+ | **Board** | `kanban_get` |
87
+ | **Cards** | `kanban_get_card`, `kanban_add_card`, `kanban_update_card`, `kanban_delete_card`, `kanban_move_card` |
88
+ | **Lists** | `kanban_add_column`, `kanban_rename_column`, `kanban_delete_column`, `kanban_move_column` |
89
+ | **Labels** | `kanban_get_label`, `kanban_add_label`, `kanban_update_label`, `kanban_delete_label` |
113
90
 
114
- ```sh
115
- node build.mjs --no-minify
116
- ```
91
+ ## 💡 Things to ask your agent
117
92
 
118
- Project layout:
93
+ > “Summarize what is currently in progress.”
119
94
 
120
- ```text
121
- index.js # Host plugin, tools, persistence, and HTTP endpoint
122
- cordis.patch.yml # DSH bundle patch
123
- build.mjs # Client build script
124
- src/client/ # React and TypeScript source
125
- lib/client.js # Generated locally or by CI; included only in the npm package
126
- ```
95
+ > “Move ‘Fix login redirect’ to In Progress and set it to P0.”
127
96
 
128
- ## Contributing
97
+ > “Add a Blocked list after In Progress.”
129
98
 
130
- Issues and pull requests are welcome. If you are planning a larger change, opening an issue first is a good way to align on the approach before implementation.
99
+ > “Create a red Urgent label and apply it to the release card.”
131
100
 
132
- ## Uninstall
101
+ > “I'm a lawyer. Set up a board for my day-to-day casework, create the workflow stages and labels I’ll need, and keep them up to date as my work evolves.”
133
102
 
134
- ```sh
135
- dsh plugin --profile web remove @alpacachen/dsh-kanban
136
- ```
103
+ You do not need to design the workflow first. Tell the agent your role, situation, or goal, and it can create suitable stages and labels—then keep refining them as you work.
137
104
 
138
105
  ## License
139
106
 
package/README.zh.md CHANGED
@@ -2,138 +2,105 @@
2
2
 
3
3
  # dsh-kanban
4
4
 
5
- **和 AI 一起规划，在看板上看到进展。**
5
+ ### 和 AI 一起规划，让每一步进展清晰可见。
6
6
 
7
- 一个为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 打造、由你和 Agent 共同维护的项目看板。
7
+ 一块真正由你和 AI Agent 共同维护的项目看板——从想法、任务拆解到推进交付，全程无需离开 DeepSeek Harness。
8
8
 
9
- 简体中文 · [English](README.md)
9
+ [![npm version](https://img.shields.io/npm/v/@alpacachen/dsh-kanban?color=5b8def&label=npm)](https://www.npmjs.com/package/@alpacachen/dsh-kanban)
10
+ ![DeepSeek Harness Plugin](https://img.shields.io/badge/DeepSeek%20Harness-Plugin-7c5cff)
11
+ ![License](https://img.shields.io/badge/license-MIT-22c55e)
10
12
 
11
- </div>
13
+ **简体中文** · [English](README.md)
12
14
 
13
- 不用再把 AI 给出的计划手动搬进项目管理工具。让 Agent 拆解功能、调整优先级或推进任务，变更会立即出现在 **「看板」**标签页；你也可以随时接手，通过拖拽和编辑继续整理工作。
15
+ </div>
14
16
 
15
17
  <p align="center">
16
18
  <img src="./image.png" alt="DeepSeek Harness 中的 dsh-kanban 看板界面" width="100%">
17
19
  </p>
18
20
 
19
- ## 为什么是 dsh-kanban？
21
+ ## ✨ 从一句话，到一块能执行的看板
20
22
 
21
- - **在对话里完成规划**：14 个 `kanban_*` 工具让 Agent 能直接管理卡片、列表和标签。
22
- - **一切仍由你掌控**：编辑卡片、跨列拖拽、调整工作流，或按优先级筛选任务。
23
- - **项目之间互不干扰**：每个 DSH 工作区都有独立看板，并自动持久化数据。
24
- - **自然融入 DSH**：界面跟随当前语言和主题，也支持暗色模式。
25
- - **安装后即可使用**：浏览器端已预构建，不需要额外配置前端工具链，也没有原生构建步骤。
23
+ 不必再把 AI 生成的计划手动搬进项目管理工具。告诉 Agent 你想完成什么，它就能在 **「看板」** 标签页中拆分任务、创建卡片、设置优先级和更新进度。
26
24
 
27
- ## 快速开始
25
+ 你也可以随时接手：拖动卡片、补充备注、调整列表。你和 Agent 始终面对同一块看板、同一份进度。
28
26
 
29
- ### 1. 安装插件
27
+ | 💬 自然对话 | 🧭 随时掌控 | ⚡ 开箱即用 |
28
+ | --- | --- | --- |
29
+ | 通过 14 个 `kanban_*` 工具直接管理任务。 | 在界面中编辑、拖拽、标记和筛选卡片。 | 浏览器端已预构建，无需配置前端环境。 |
30
+ | **🗂️ 项目隔离** | **🌓 原生体验** | **🤝 实时协作** |
31
+ | 每个 DSH 工作区都有自己的独立看板。 | 自动跟随 DSH 的语言、主题与暗色模式。 | 你做的调整，Agent 立即可见；反之亦然。 |
30
32
 
31
- 从 npm 安装已发布的包：
33
+ ## 🚀 三步开始使用
34
+
35
+ ### 1. 安装
32
36
 
33
37
  ```sh
34
38
  dsh plugin --profile web add @alpacachen/dsh-kanban
35
39
  ```
36
40
 
37
- 项目不支持从 GitHub 源码安装，因为生成的浏览器 bundle 只会由 CI 构建并放入 npm 包。
38
-
39
- 安装后重启 `dsh web`，让插件 bundle 在启动时加载。可以通过下面的命令确认配置：
41
+ 安装后重启 `dsh web`，让插件 bundle 完成加载。你可以用下面的命令确认安装结果：
40
42
 
41
43
  ```sh
42
44
  dsh --profile web --dump-config
43
45
  ```
44
46
 
45
- 如果安装成功，输出中会包含 `dsh-kanban` 配置层。
47
+ 如果输出中包含 `dsh-kanban` 配置层，就说明安装成功。
46
48
 
47
49
  ### 2. 打开看板
48
50
 
49
- 进入任意工作区，在会话视图旁打开**「看板」**标签页。新看板默认包含 **Todo**、**In Progress**、**Review** 和 **Done** 四个列表。
51
+ 进入任意工作区，点击会话视图旁的 **「看板」** 标签页。新看板已经准备好四个常用阶段：
52
+
53
+ `Todo` → `In Progress` → `Review` → `Done`
50
54
 
51
55
  ### 3. 让 Agent 开始规划
52
56
 
53
57
  试试这样说：
54
58
 
55
- > 把登录功能拆成具体的实现任务，每一步建一张卡片，并把安全审查标为 P0。
59
+ > 把登录功能拆成具体的实现任务，每一步创建一张卡片，并把安全审查标为 P0。
56
60
 
57
- Agent 会直接更新当前看板。之后你可以在界面中继续调整，也可以留在对话里推进任务。
61
+ 任务会直接出现在看板中。你可以继续通过对话推进，也可以切换到看板，用拖拽和编辑完善计划。
58
62
 
59
- ## 你可以做什么
63
+ ## 🧩 推进工作需要的能力，都在这里
60
64
 
61
65
  ### 在「看板」标签页中
62
66
 
63
67
  - 创建、编辑、删除卡片，并将卡片拖到其他列表
64
68
  - 为卡片补充备注、标签和 P0 / P1 / P2 优先级
65
- - 创建、重命名、排序和删除列表
66
- - 创建标签并自定义颜色
67
- - 按优先级筛选整个看板
69
+ - 打开卡片活动时间线，查看变更时间、具体内容，以及操作来自你还是 Agent
70
+ - 追踪卡片创建、移动、标题与备注编辑、标签变化和优先级变化
71
+ - 从任意卡片发起对话，在当前会话或新会话中让 Agent 接着处理
72
+ - 创建、重命名、排序和删除工作流列表
73
+ - 创建彩色标签，让不同任务一眼可辨
74
+ - 按优先级筛选整个看板，也可以随时手动刷新
75
+
76
+ ### 从任意卡片继续与 Agent 协作
77
+
78
+ 打开卡片并选择 **「与 Agent 聊一聊」**，dsh-kanban 会把卡片 ID、标题、标签和备注带入当前会话或一个新会话，让 Agent 立即获得完整上下文。内容只会填入输入框作为可编辑草稿，由你确认后发送，不会自动提交。
68
79
 
69
80
  ### 在对话中
70
81
 
71
- 插件会自动为工作区内的对话提供以下工具：
82
+ 插件会自动为每个工作区中的 Agent 提供以下工具：
72
83
 
73
84
  | 范围 | 工具 |
74
85
  | --- | --- |
75
- | 看板 | `kanban_get` |
76
- | 卡片 | `kanban_get_card`、`kanban_add_card`、`kanban_update_card`、`kanban_delete_card`、`kanban_move_card` |
77
- | 列表 | `kanban_add_column`、`kanban_rename_column`、`kanban_delete_column`、`kanban_move_column` |
78
- | 标签 | `kanban_get_label`、`kanban_add_label`、`kanban_update_label`、`kanban_delete_label` |
79
-
80
- 你还可以这样使用：
81
-
82
- - 「总结一下目前正在进行的任务。」
83
- - 「把『修复登录跳转』移到进行中，并设为 P0。」
84
- - 「在进行中后面新增一个阻塞列表。」
85
- - 「创建一个红色的『紧急』标签，并加到发布卡片上。」
86
-
87
- ## 数据与持久化
88
-
89
- 看板按工作区隔离，并通过 DSH 文件系统服务保存为 `kanban-board-<workspaceId>.json`。刷新页面或重启 DSH 都不会丢失数据；卸载插件时，已有的看板数据也会保留。
90
-
91
- ## 工作原理
92
-
93
- `dsh-kanban` 使用标准的 DSH bundle 格式：
86
+ | **看板** | `kanban_get` |
87
+ | **卡片** | `kanban_get_card`、`kanban_add_card`、`kanban_update_card`、`kanban_delete_card`、`kanban_move_card` |
88
+ | **列表** | `kanban_add_column`、`kanban_rename_column`、`kanban_delete_column`、`kanban_move_column` |
89
+ | **标签** | `kanban_get_label`、`kanban_add_label`、`kanban_update_label`、`kanban_delete_label` |
94
90
 
95
- - `index.js` 注册 Agent 工具和浏览器端使用的 `/api/kanban` 接口。
96
- - Agent 与「看板」标签页共享同一套数据层，双方看到的始终是同一块看板。
97
- - `cordis.patch.yml` 将插件加入指定的 DSH profile。
98
- - `lib/client.js` 是由 DSH 直接加载的预构建 Web 客户端。
91
+ ## 💡 你可以直接这样说
99
92
 
100
- 客户端使用 React、TypeScript、Tailwind CSS、shadcn/ui、Radix UI 和 dnd-kit 构建。React 由 DSH 提供，以减少发布体积并避免重复运行时。
93
+ > 「总结一下目前正在进行的任务。」
101
94
 
102
- ## 本地开发
95
+ > 「把『修复登录跳转』移到进行中，并设为 P0。」
103
96
 
104
- 需要准备 Node.js 和 pnpm。
97
+ > 「在进行中后面新增一个阻塞列表。」
105
98
 
106
- ```sh
107
- pnpm install
108
- pnpm build
109
- pnpm typecheck
110
- ```
99
+ > 「创建一个红色的『紧急』标签，并加到发布卡片上。」
111
100
 
112
- 调试时可以生成未压缩的客户端 bundle：
101
+ > 「我是一名律师，请帮我初始化一套适合日常办案的看板，根据工作流程创建阶段列表和常用标签，并随着工作变化持续帮我维护。」
113
102
 
114
- ```sh
115
- node build.mjs --no-minify
116
- ```
117
-
118
- 项目结构：
119
-
120
- ```text
121
- index.js # 宿主插件、Agent 工具、持久化与 HTTP 接口
122
- cordis.patch.yml # DSH bundle 补丁
123
- build.mjs # 客户端构建脚本
124
- src/client/ # React 与 TypeScript 源码
125
- lib/client.js # 本地或 CI 生成，仅随 npm 包发布
126
- ```
127
-
128
- ## 参与贡献
129
-
130
- 欢迎提交 Issue 和 Pull Request。如果准备进行较大的改动，建议先开一个 Issue 讨论目标和实现方式，避免重复工作。
131
-
132
- ## 卸载
133
-
134
- ```sh
135
- dsh plugin --profile web remove @alpacachen/dsh-kanban
136
- ```
103
+ 不必提前设计好工作流。只需告诉 Agent 你的职业、场景或目标，它就能为你创建合适的阶段和标签，并在后续协作中持续调整。
137
104
 
138
105
  ## 开源许可
139
106