@alpacachen/dsh-kanban 1.6.2 → 1.7.0
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/README.md +7 -2
- package/README.zh.md +7 -2
- package/docs/screenshots/card-details-dark.png +0 -0
- package/image.png +0 -0
- package/index.js +5 -5
- package/lib/client.js +119 -21
- package/package.json +4 -1
package/README.md
CHANGED
|
@@ -16,7 +16,8 @@ A collaborative kanban board where you and your AI agent plan, organize, and shi
|
|
|
16
16
|
</div>
|
|
17
17
|
|
|
18
18
|
<p align="center">
|
|
19
|
-
<img src="./image.png" alt="dsh-kanban board
|
|
19
|
+
<img src="./image.png" alt="Full dsh-kanban board in light mode with English tasks, labels and priorities" width="100%">
|
|
20
|
+
<img src="./docs/screenshots/card-details-dark.png" alt="Full dsh-kanban board in dark mode with an open task drawer showing a Markdown description" width="100%">
|
|
20
21
|
</p>
|
|
21
22
|
|
|
22
23
|
## ✨ From conversation to action
|
|
@@ -66,7 +67,9 @@ The cards appear directly on your board. Continue in conversation, or switch to
|
|
|
66
67
|
### On the Board
|
|
67
68
|
|
|
68
69
|
- Create, edit, delete, and drag cards between lists
|
|
69
|
-
-
|
|
70
|
+
- Read task details in a resizable side drawer that remembers its width and fills narrow screens
|
|
71
|
+
- Write descriptions as Markdown source with **Edit**; **Done editing** previews the result and **Save** applies changes
|
|
72
|
+
- Add labels and P0 / P1 / P2 priorities
|
|
70
73
|
- Exchange persistent card comments with the agent and see comment counts at a glance
|
|
71
74
|
- Open a card's activity timeline to see when it changed, what changed, and whether you or the agent made the change
|
|
72
75
|
- Track card creation, comments, moves, title and note edits, label changes, and priority changes
|
|
@@ -91,6 +94,8 @@ The plugin automatically gives the agent these tools in every workspace:
|
|
|
91
94
|
| **Lists** | `kanban_add_column`, `kanban_rename_column`, `kanban_delete_column`, `kanban_move_column` |
|
|
92
95
|
| **Labels** | `kanban_get_label`, `kanban_add_label`, `kanban_update_label`, `kanban_delete_label` |
|
|
93
96
|
|
|
97
|
+
For `kanban_add_card` and `kanban_update_card`, the task description uses the existing `note` field: send raw Markdown with line breaks, not HTML. Headings, lists, tables and fenced code blocks are rendered in task details. Keep the source within 2,000 characters, including Markdown syntax and newlines; longer input is truncated with a warning. Before editing a description, read `kanban_get_card` for its complete Markdown source (`kanban_get` only returns a summary). Updating `note` replaces the whole description; omit it to preserve the current text, or pass an empty string to clear it. Comments remain plain text.
|
|
98
|
+
|
|
94
99
|
## 💡 Things to ask your agent
|
|
95
100
|
|
|
96
101
|
> “Summarize what is currently in progress.”
|
package/README.zh.md
CHANGED
|
@@ -16,7 +16,8 @@
|
|
|
16
16
|
</div>
|
|
17
17
|
|
|
18
18
|
<p align="center">
|
|
19
|
-
<img src="./image.png" alt="
|
|
19
|
+
<img src="./image.png" alt="浅色模式下的完整 dsh-kanban 看板,展示英文任务、标签与优先级" width="100%">
|
|
20
|
+
<img src="./docs/screenshots/card-details-dark.png" alt="深色模式下的完整 dsh-kanban 看板,打开的任务详情抽屉展示 Markdown 描述" width="100%">
|
|
20
21
|
</p>
|
|
21
22
|
|
|
22
23
|
## ✨ 从一句话,到一块能执行的看板
|
|
@@ -66,7 +67,9 @@ dsh --profile web --dump-config
|
|
|
66
67
|
### 在「看板」标签页中
|
|
67
68
|
|
|
68
69
|
- 创建、编辑、删除卡片,并将卡片拖到其他列表
|
|
69
|
-
-
|
|
70
|
+
- 在侧边抽屉中查看任务详情,可拖动调整宽度并记忆,窄屏自动铺满
|
|
71
|
+
- 描述支持 Markdown:点击**「编辑」**修改原文,**「完成编辑」**切回预览,点击**「保存」**后生效
|
|
72
|
+
- 为卡片添加标签和 P0 / P1 / P2 优先级
|
|
70
73
|
- 与 Agent 在卡片下持续评论,并在看板上快速查看评论数量
|
|
71
74
|
- 打开卡片活动时间线,查看变更时间、具体内容,以及操作来自你还是 Agent
|
|
72
75
|
- 追踪卡片创建、评论、移动、标题与备注编辑、标签变化和优先级变化
|
|
@@ -91,6 +94,8 @@ dsh --profile web --dump-config
|
|
|
91
94
|
| **列表** | `kanban_add_column`、`kanban_rename_column`、`kanban_delete_column`、`kanban_move_column` |
|
|
92
95
|
| **标签** | `kanban_get_label`、`kanban_add_label`、`kanban_update_label`、`kanban_delete_label` |
|
|
93
96
|
|
|
97
|
+
`kanban_add_card` 和 `kanban_update_card` 的任务描述仍使用 `note` 字段,传入保留换行的 Markdown 原文,不传 HTML。任务详情会渲染标题、列表、表格和代码块。原文最多 2,000 字符,Markdown 标记和换行也计入长度,超出会截断并返回警告。修改已有描述前,应先调用 `kanban_get_card` 读取完整原文(`kanban_get` 只返回摘要)。传入 `note` 会替换整段描述;省略则保留原文,传空字符串则清空。评论仍为纯文本。
|
|
98
|
+
|
|
94
99
|
## 💡 你可以直接这样说
|
|
95
100
|
|
|
96
101
|
> 「总结一下目前正在进行的任务。」
|
|
Binary file
|
package/image.png
CHANGED
|
Binary file
|
package/index.js
CHANGED
|
@@ -1136,7 +1136,7 @@ export function apply(ctx) {
|
|
|
1136
1136
|
},
|
|
1137
1137
|
{
|
|
1138
1138
|
name: 'kanban_get_card',
|
|
1139
|
-
description: "Read one card's full details (title, note, label, priority and comments) by id from the current project (workspace) board. Use kanban_get first to discover card ids
|
|
1139
|
+
description: "Read one card's full details (title, raw Markdown description in note, label, priority and comments) by id from the current project (workspace) board. Use kanban_get first to discover card ids; its summary omits note. Read this tool before editing an existing description to preserve its content and Markdown formatting.",
|
|
1140
1140
|
parameters: {
|
|
1141
1141
|
type: 'object',
|
|
1142
1142
|
properties: {
|
|
@@ -1205,13 +1205,13 @@ export function apply(ctx) {
|
|
|
1205
1205
|
},
|
|
1206
1206
|
{
|
|
1207
1207
|
name: 'kanban_add_card',
|
|
1208
|
-
description: 'Add a card to the current project (workspace) kanban board. Write feature breakdowns and plans to the board: one card per task step.',
|
|
1208
|
+
description: 'Add a card to the current project (workspace) kanban board. Write feature breakdowns and plans to the board: one card per task step. Put the task description in note as raw Markdown; the task details drawer renders it.',
|
|
1209
1209
|
parameters: {
|
|
1210
1210
|
type: 'object',
|
|
1211
1211
|
properties: {
|
|
1212
1212
|
title: { type: 'string', description: `Card title (task name, concise and actionable; max ${TITLE_LIMIT} chars)` },
|
|
1213
1213
|
columnId: { type: 'string', description: 'Target list id; defaults to the first list (Todo)' },
|
|
1214
|
-
note: { type: 'string', description: `
|
|
1214
|
+
note: { type: 'string', description: `Task description as raw Markdown source, not HTML: background, acceptance criteria or breakdown details. Supports headings, lists, tables and fenced code blocks; preserve line breaks. Optional; max ${NOTE_LIMIT} chars including Markdown syntax and newlines. Longer input is truncated with a warning.` },
|
|
1215
1215
|
label: { type: 'string', description: `Label name (optional; max ${LABEL_LIMIT} chars): e.g. New Feature, bug, Feedback` },
|
|
1216
1216
|
priority: { type: 'string', enum: ['high', 'medium', 'low'], description: 'Priority (optional): high=P0 / medium=P1 / low=P2' },
|
|
1217
1217
|
},
|
|
@@ -1224,13 +1224,13 @@ export function apply(ctx) {
|
|
|
1224
1224
|
},
|
|
1225
1225
|
{
|
|
1226
1226
|
name: 'kanban_update_card',
|
|
1227
|
-
description: "Update a card's title, note, label or priority on the board.",
|
|
1227
|
+
description: "Update a card's title, Markdown description (note), label or priority on the board. Read kanban_get_card before editing an existing description; note replaces the whole description, not a patch.",
|
|
1228
1228
|
parameters: {
|
|
1229
1229
|
type: 'object',
|
|
1230
1230
|
properties: {
|
|
1231
1231
|
id: { type: 'string', description: 'Card id' },
|
|
1232
1232
|
title: { type: 'string', description: `New title (optional; max ${TITLE_LIMIT} chars)` },
|
|
1233
|
-
note: { type: 'string', description: `
|
|
1233
|
+
note: { type: 'string', description: `Complete replacement description as raw Markdown source, not HTML; preserve line breaks. Omit to keep the description unchanged; pass an empty string to clear it. Max ${NOTE_LIMIT} chars including Markdown syntax and newlines. Longer input is truncated with a warning.` },
|
|
1234
1234
|
label: { type: 'string', description: `New label name (optional; max ${LABEL_LIMIT} chars); pass empty string to clear` },
|
|
1235
1235
|
priority: { type: 'string', enum: ['high', 'medium', 'low', ''], description: 'New priority (optional): high=P0 / medium=P1 / low=P2; pass empty string to clear' },
|
|
1236
1236
|
},
|