dsh-super-kanban 0.4.0 → 0.4.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 (4) hide show
  1. package/CHANGELOG.md +25 -1
  2. package/README.en.md +43 -25
  3. package/README.md +41 -23
  4. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.4.1] - 2026-11-05
11
+
12
+ Documentation-only patch release: the plugin code is unchanged from 0.4.0.
13
+
14
+ ### Added
15
+
16
+ - **Upgrade guide**: how to update an installed plugin, how to verify the
17
+ installed version, the SemVer-range pitfall (`^0.3.0` never resolves 0.4.x;
18
+ cross-minor upgrades need an exact version or a reinstall), and how to roll
19
+ back.
20
+ - **Troubleshooting guide** (`docs/TROUBLESHOOTING.md`): stale UI after an
21
+ update, missing entry point, blank board, 401/403, scanning and AI issues,
22
+ artifact previews, sidebar widths, uninstall/data retention and diagnostics.
23
+ - **Absolute README asset and document links**, so screenshots, the demo GIF
24
+ and docs links render correctly on the npm package page as well as GitHub.
25
+
26
+ ### Changed
27
+
28
+ - README (Chinese and English), INSTALL, MARKET, DESIGN, ARCHITECTURE,
29
+ DEVELOPMENT and CONTRACT were re-checked against the 0.4 UI and updated where
30
+ they still described earlier behaviour (toolbar actions, accent marks, board
31
+ status markers).
32
+
10
33
  ## [0.4.0] - 2026-11-05
11
34
 
12
35
  UI refinement release: put the frequently used toolbar actions back on the
@@ -83,6 +106,7 @@ workspace into a maintainable task board.
83
106
  with the local DSH account token; tokens are never logged or persisted by the
84
107
  plugin. See [SECURITY.md](./SECURITY.md).
85
108
 
86
- [Unreleased]: https://github.com/topmindspace/dsh-super-kanban/compare/v0.4.0...HEAD
109
+ [Unreleased]: https://github.com/topmindspace/dsh-super-kanban/compare/v0.4.1...HEAD
87
110
  [0.3.0]: https://github.com/topmindspace/dsh-super-kanban/releases/tag/v0.3.0
88
111
  [0.4.0]: https://github.com/topmindspace/dsh-super-kanban/releases/tag/v0.4.0
112
+ [0.4.1]: https://github.com/topmindspace/dsh-super-kanban/releases/tag/v0.4.1
package/README.en.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [![CI](https://github.com/topmindspace/dsh-super-kanban/actions/workflows/ci.yml/badge.svg)](https://github.com/topmindspace/dsh-super-kanban/actions/workflows/ci.yml)
4
4
  [![npm](https://img.shields.io/npm/v/dsh-super-kanban.svg)](https://www.npmjs.com/package/dsh-super-kanban)
5
- [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
5
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/topmindspace/dsh-super-kanban/blob/main/LICENSE)
6
6
 
7
7
  An AI task board that **lives inside the DeepSeek Harness UI**. It reads the real DSH sessions across your workspaces and infers each task's goal, progress, completion state and open issues — and you can also maintain the board entirely by hand. Every card can be traced back to a specific session and a specific sentence.
8
8
 
@@ -10,11 +10,11 @@ An AI task board that **lives inside the DeepSeek Harness UI**. It reads the rea
10
10
  - **Data**: sessions are scanned read-only on your machine; board data stays on your machine.
11
11
  - **Intelligence**: reuses the model quota of the DSH account already signed in on this machine — zero configuration. Turn AI off and it falls back to local rule-based analysis.
12
12
 
13
- **English** | [简体中文](README.md)
13
+ **English** | [简体中文](https://github.com/topmindspace/dsh-super-kanban/blob/main/README.md)
14
14
 
15
- ![Task board (light)](docs/screenshots/board-light.png)
15
+ ![Task board (light)](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/board-light.png)
16
16
 
17
- ![Board → task details → continue task demo](docs/screenshots/demo.gif)
17
+ ![Board → task details → continue task demo](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/demo.gif)
18
18
 
19
19
  ## Contents
20
20
 
@@ -27,6 +27,7 @@ An AI task board that **lives inside the DeepSeek Harness UI**. It reads the rea
27
27
  - [Screenshots](#screenshots)
28
28
  - [Compatibility](#compatibility)
29
29
  - [FAQ](#faq)
30
+ - [Troubleshooting](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/TROUBLESHOOTING.md)
30
31
  - [Development and contributing](#development-and-contributing)
31
32
  - [License](#license)
32
33
 
@@ -46,7 +47,7 @@ Super Kanban turns those conversations into a maintainable board:
46
47
  | 🤝 Session hand-off | "Continue this task" builds a structured prompt and (after your confirmation) puts it in the original or a new session input — never sends automatically |
47
48
  | ✅ Subtasks and goals | Subtask checklists (importable from session todos, writes back progress), task goal, and DSH Session Goal tracking |
48
49
  | 📦 Artifact tracking | Collects deliverables and written files; click to open them in the DSH document preview |
49
- | 🧾 Key facts first | Cards show a one-line goal summary; the drawer leads with 3–6 key facts and keeps raw evidence collapsed |
50
+ | 🧾 Key facts first | Cards keep only title / meta / progress; the drawer leads with 3–6 key facts and keeps raw evidence collapsed |
50
51
  | ✍️ Manual control | Create, edit, drag between columns, archive, delete, lock fields — AI never overwrites what you locked |
51
52
  | 🔄 Continuous maintenance | First scan in seconds, then incremental scans; new sessions join automatically and old tasks keep updating |
52
53
  | 🧠 Explainable | Every inference carries a confidence and a one-line reason — no black-box status changes |
@@ -64,7 +65,7 @@ Super Kanban turns those conversations into a maintainable board:
64
65
 
65
66
  - Session digests sent to the model are capped at **≤1.5KB per session**, containing only recent changes and key signals.
66
67
  - Structured output is bounded: ≤6 key facts, ≤8 evidence items, `max_tokens` ≤ 2200, with per-session limits.
67
- - **Incremental gating**: the model is called only when user messages increase, a turn ends, the session is new, or you explicitly re-analyze. Live turns are never re-analyzed, and there is a minimum interval per session.
68
+ - **Incremental gating**: the model is called only when user messages increase, a turn ends, or the session is analyzed for the first time. Live turns are never re-analyzed, and there is a minimum interval per session.
68
69
  - **Controllable budget**: per-scan and daily AI call limits are configurable; exceeding them automatically falls back to the rules engine. The settings page shows today's calls and tokens.
69
70
  - Re-scanning already analyzed sessions results in **zero AI calls**.
70
71
 
@@ -74,6 +75,12 @@ Super Kanban turns those conversations into a maintainable board:
74
75
  - Online analysis sends **compressed digests only**: never full session text, never file contents, never account credentials.
75
76
  - All AI features can be disabled in settings and take effect immediately, falling back to local rules.
76
77
 
78
+ ### Interface (v0.4)
79
+
80
+ - DSH-native light/dark themes, typography and spacing; "monochrome first with restrained accents": color only appears in status dots, thin progress lines, priority text and type icons.
81
+ - The header keeps frequent actions visible (search / scan / settings / open in right sidebar / new task); the "⋯" menu only contains "Export JSON".
82
+ - Full visual and interaction rules: [DESIGN.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/DESIGN.md).
83
+
77
84
  ## Two layouts
78
85
 
79
86
  The same board can be opened in two ways:
@@ -98,16 +105,16 @@ The same board can be opened in two ways:
98
105
  1. DSH → **Plugins** → **Discover**
99
106
  2. **Add index source** and paste:
100
107
  `https://topmindspace.github.io/dsh-super-kanban/index.json`
101
- 3. Find **Super Kanban** in the list → **Install** → enable
108
+ 3. Find **Super Kanban** in the list → open its page (the index lists every available version) → **Install** the version you want → enable
102
109
  4. Press `Cmd+R` in the DSH window (restart DSH if needed)
103
110
 
104
111
  > The market index becomes available after the first release is published to GitHub Pages; its content comes from this repository's `docs/`.
105
112
 
106
113
  ### Option B: npm package
107
114
 
108
- DSH → Plugins → Add plugin → enter the package name `dsh-super-kanban` (optionally with a version, e.g. `dsh-super-kanban@<version>`) → install → enable → reload the window.
115
+ DSH → Plugins → Add plugin → enter the package name — `dsh-super-kanban` for npm latest, or an **exact version** such as `dsh-super-kanban@0.4.1` (recommended when upgrading) → install → enable → reload the window.
109
116
 
110
- > The npm package is published: `dsh-super-kanban` (https://www.npmjs.com/package/dsh-super-kanban). See [docs/MARKET.md](docs/MARKET.md) for the release and index-refresh flow.
117
+ > The npm package is published: `dsh-super-kanban` (https://www.npmjs.com/package/dsh-super-kanban). See [docs/MARKET.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/MARKET.md) for the release and index-refresh flow.
111
118
 
112
119
  ### Option C: Git repository
113
120
 
@@ -125,19 +132,26 @@ cd dsh-super-kanban
125
132
 
126
133
  Or choose "local directory" in the DSH plugin page and point it at this repository root. After installing, reload the window and "任务看板" appears in the left sidebar.
127
134
 
128
- ### Upgrade and uninstall
135
+ ### Updating the plugin (important)
136
+
137
+ Third-party plugins have **no automatic upgrade**: updating means **uninstall the old version → install the target version**, then reload DSH (fully quit and reopen if the UI still looks stale).
138
+
139
+ - **Cross-minor upgrades need an exact version**: going from `0.3.x` to `0.4.x` requires an exact install such as `dsh-super-kanban@0.4.1`. An old range such as `^0.3.0` **never** resolves to 0.4.x under semantic versioning — the most common cause of "updated but the UI is still old".
140
+ - **Within 0.4.x**: if the profile dependency is `^0.4.0`, patch releases (0.4.1, 0.4.2, …) resolve normally; plugin-page installs record an exact version, so those still require uninstall + reinstall.
141
+ - After updating press `Cmd+R`; if nothing changed, **fully quit and reopen DSH**, then verify the real installed version as described in [INSTALL.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/INSTALL.md#2-验证安装与版本).
142
+
143
+ ### Uninstall
129
144
 
130
- - **Upgrade**: market / npm / Git installs update from the plugin page; source installs run `git pull` and reload the window.
131
145
  - **Uninstall**: remove it from the plugin page, or run `./uninstall.sh -y` in the source directory.
132
146
  - Uninstalling **does not delete** board data; to wipe it, delete `~/.dsh/storages/super-kanban/`.
133
147
 
134
- Detailed installation, upgrade and troubleshooting steps are in [docs/INSTALL.md](docs/INSTALL.md).
148
+ Detailed install / update / verification / rollback steps are in [docs/INSTALL.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/INSTALL.md); if something breaks see [docs/TROUBLESHOOTING.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/TROUBLESHOOTING.md).
135
149
 
136
150
  ## Usage
137
151
 
138
152
  1. Click **任务看板** in the left sidebar (or the board icon in a conversation header for the right-sidebar form).
139
153
  2. **Board**: four columns — Backlog / In progress / Blocked / Done; column headers show counts and status colors.
140
- 3. **Cards**: status dot, title with an AI/rules marker, a one-line goal summary, source workspace and last-activity time, plus restrained priority, issue count, artifact count, subtask progress and a progress line.
154
+ 3. **Cards**: status dot, title with an AI/rules marker, source workspace and last-activity time, plus restrained priority, issue count, artifact count, subtask progress and a progress line.
141
155
  4. **Detail drawer** (click a card):
142
156
  - One-line status summary (click "Edit" to change fields)
143
157
  - **Key facts** (3–6 items: key progress / decisions / issues from the session)
@@ -207,27 +221,27 @@ By default incremental scans only analyze **changed sessions**; the per-scan AI
207
221
 
208
222
  | Board (light) | Board (dark) |
209
223
  | --- | --- |
210
- | ![Board light](docs/screenshots/board-light.png) | ![Board dark](docs/screenshots/board-dark.png) |
224
+ | ![Board light](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/board-light.png) | ![Board dark](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/board-dark.png) |
211
225
 
212
226
  | Task details (light) | Task details (dark) |
213
227
  | --- | --- |
214
- | ![Task details light](docs/screenshots/drawer-light.png) | ![Task details dark](docs/screenshots/drawer-dark.png) |
228
+ | ![Task details light](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/drawer-light.png) | ![Task details dark](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/drawer-dark.png) |
215
229
 
216
230
  | Continue-task dialog | Prompt placed into the session input |
217
231
  | --- | --- |
218
- | ![Continue task](docs/screenshots/continue-modal.png) | ![Prompt placed](docs/screenshots/continue-placed.png) |
232
+ | ![Continue task](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/continue-modal.png) | ![Prompt placed](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/continue-placed.png) |
219
233
 
220
234
  | Right sidebar (narrow) | Right sidebar fullscreen |
221
235
  | --- | --- |
222
- | ![Right sidebar](docs/screenshots/side-panel.png) | ![Sidebar fullscreen](docs/screenshots/side-fullscreen.png) |
236
+ | ![Right sidebar](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/side-panel.png) | ![Sidebar fullscreen](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/side-fullscreen.png) |
223
237
 
224
238
  | Artifact preview entries | Settings (persistent gear) |
225
239
  | --- | --- |
226
- | ![Artifacts](docs/screenshots/drawer-artifacts.png) | ![Settings](docs/screenshots/settings-dual.png) |
240
+ | ![Artifacts](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/drawer-artifacts.png) | ![Settings](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/settings-dual.png) |
227
241
 
228
242
  | "⋯" menu (export JSON only) | 1280px window |
229
243
  | --- | --- |
230
- | ![Toolbar menu](docs/screenshots/toolbar-menu.png) | ![1280](docs/screenshots/board-1280.png) |
244
+ | ![Toolbar menu](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/toolbar-menu.png) | ![1280](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/board-1280.png) |
231
245
 
232
246
  > All screenshots above use a fully fictional demo dataset (invented workspaces / sessions / tasks) and contain no real user or workspace information.
233
247
 
@@ -244,6 +258,9 @@ By default incremental scans only analyze **changed sessions**; the per-scan AI
244
258
 
245
259
  ## FAQ
246
260
 
261
+ **Q: I updated the plugin but the UI still looks old / new features are missing.**
262
+ A: The usual cause is an old profile dependency range (e.g. `^0.3.0`); cross-minor upgrades require an **exact version** such as `dsh-super-kanban@0.4.1`. Press `Cmd+R` first, then fully quit and reopen DSH. If it is still old, follow [docs/TROUBLESHOOTING.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/TROUBLESHOOTING.md#更新后-ui-未变) to check the real installed version and dependency spec.
263
+
247
264
  **Q: There is no "任务看板" in the left sidebar.**
248
265
  A: Press `Cmd+R` to reload the window; restart DSH if it is still missing. If it remains missing, check the diagnostics on the DSH plugin page (a failed plugin load usually reports a reason).
249
266
 
@@ -251,7 +268,7 @@ A: Press `Cmd+R` to reload the window; restart DSH if it is still missing. If it
251
268
  A: Click the scan button in the header to trigger a manual scan, or check that "Auto scan" is enabled in settings.
252
269
 
253
270
  **Q: The AI judgment is wrong.**
254
- A: Open the card and edit the fields directly (editing locks them), or use "re-analyze" in the card menu to let AI look at the source session again.
271
+ A: Open the card and edit the fields directly (editing locks them, so AI won't overwrite them later). To make AI re-judge it, continue the source session and wait for the next scan — the card updates automatically.
255
272
 
256
273
  **Q: I don't want certain workspaces on the board.**
257
274
  A: Settings gear in the board header → Excluded workspaces (multi-select).
@@ -277,11 +294,12 @@ npm run check:privacy # scan for personal paths / credentials / session ids
277
294
  npm run market:index # regenerate docs/index.json
278
295
  ```
279
296
 
280
- - For the development setup, repository layout and debugging, see [CONTRIBUTING.md](CONTRIBUTING.md) and [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md).
281
- - Architecture: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md). Interface contract: [docs/CONTRACT.md](docs/CONTRACT.md). Visual spec: [docs/DESIGN.md](docs/DESIGN.md).
282
- - Release and distribution flow (market index, npm, Git): [docs/MARKET.md](docs/MARKET.md).
283
- - For security issues, please follow [SECURITY.md](SECURITY.md) and report privately instead of opening a public issue.
297
+ - For the development setup, repository layout and debugging, see [CONTRIBUTING.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/CONTRIBUTING.md) and [docs/DEVELOPMENT.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/DEVELOPMENT.md).
298
+ - Architecture: [docs/ARCHITECTURE.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/ARCHITECTURE.md). Interface contract: [docs/CONTRACT.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/CONTRACT.md). Visual spec: [docs/DESIGN.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/DESIGN.md).
299
+ - Release and distribution flow (market index, npm, Git): [docs/MARKET.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/MARKET.md).
300
+ - User-facing troubleshooting guide: [docs/TROUBLESHOOTING.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/TROUBLESHOOTING.md).
301
+ - For security issues, please follow [SECURITY.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/SECURITY.md) and report privately instead of opening a public issue.
284
302
 
285
303
  ## License
286
304
 
287
- [MIT](LICENSE) © topmindspace
305
+ [MIT](https://github.com/topmindspace/dsh-super-kanban/blob/main/LICENSE) © topmindspace
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [![CI](https://github.com/topmindspace/dsh-super-kanban/actions/workflows/ci.yml/badge.svg)](https://github.com/topmindspace/dsh-super-kanban/actions/workflows/ci.yml)
4
4
  [![npm](https://img.shields.io/npm/v/dsh-super-kanban.svg)](https://www.npmjs.com/package/dsh-super-kanban)
5
- [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
5
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/topmindspace/dsh-super-kanban/blob/main/LICENSE)
6
6
 
7
7
  一个**生长在 DeepSeek Harness 界面里**的 AI 任务看板：它读取你各个工作区的真实 DSH 会话，自动研判任务的目标、进度、完成情况与问题，也可以完全手动管理。每张任务卡都能追溯到具体会话与具体一句话。
8
8
 
@@ -10,11 +10,11 @@
10
10
  - **数据**：只读扫描本机 DSH 会话；看板数据保存在本机，不出本机
11
11
  - **智能**：复用本机 DSH 已登录账号的模型额度，零配置；关闭后自动降级为本地规则分析
12
12
 
13
- **简体中文** | [English](README.en.md)
13
+ **简体中文** | [English](https://github.com/topmindspace/dsh-super-kanban/blob/main/README.en.md)
14
14
 
15
- ![任务看板（浅色）](docs/screenshots/board-light.png)
15
+ ![任务看板（浅色）](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/board-light.png)
16
16
 
17
- ![看板 → 任务详情 → 继续任务 演示](docs/screenshots/demo.gif)
17
+ ![看板 → 任务详情 → 继续任务 演示](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/demo.gif)
18
18
 
19
19
  ## 目录
20
20
 
@@ -27,6 +27,7 @@
27
27
  - [界面截图](#界面截图)
28
28
  - [兼容性](#兼容性)
29
29
  - [常见问题](#常见问题)
30
+ - [故障排查](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/TROUBLESHOOTING.md)
30
31
  - [开发与贡献](#开发与贡献)
31
32
  - [License](#license)
32
33
 
@@ -46,7 +47,7 @@ Super Kanban 把这些对话转成一张可持续维护的看板：
46
47
  | 🤝 会话联动 | 「继续此任务」生成结构化提示词，确认后放入原会话或同工作区新会话输入框，不自动发送 |
47
48
  | ✅ 子任务与目标 | 子任务清单（可从会话待办导入、勾选自动回写进度）、任务目标、DSH Session Goal 追踪 |
48
49
  | 📦 产物跟踪 | 自动收集会话交付物与写出的文件，点击在 DSH 文档预览中打开 |
49
- | 🧾 关键事实优先 | 卡片先给一句话目标摘要；抽屉先看 3–6 条关键事实，完整证据默认折叠 |
50
+ | 🧾 关键事实优先 | 卡片只保留标题/元信息/进度三层；抽屉先看 3–6 条关键事实，完整证据默认折叠 |
50
51
  | ✍️ 手动维护 | 新建 / 编辑 / 拖拽换列 / 归档 / 删除 / 锁定字段；你改过的字段 AI 不再覆盖 |
51
52
  | 🔄 持续维护 | 首次约数秒完成扫描，之后按间隔增量扫描；新会话自动纳入，旧任务自动更新 |
52
53
  | 🧠 解释得清 | 每条研判带置信度与一句话理由，避免「黑箱改状态」 |
@@ -64,7 +65,7 @@ Super Kanban 把这些对话转成一张可持续维护的看板：
64
65
 
65
66
  - 送模型的会话摘要（digest）压到 **≤1.5KB/会话**，只含最近变化与关键信号。
66
67
  - 输出结构化：关键事实 ≤6、证据 ≤8、`max_tokens` ≤2200，单个会话解析结果有明确上限。
67
- - **增量门控**：只在「用户消息增加 / 轮次结束 / 首次 / 手动重新研判」时调用模型；同一活跃 turn 内不重复分析，同一会话有最小间隔。
68
+ - **增量门控**：只在「用户消息增加 / 轮次结束 / 首次分析」时调用模型；同一活跃 turn 内不重复分析，同一会话有最小间隔。
68
69
  - **预算可控**：设置里可配「单次扫描 AI 调用上限」与「每日上限」，超限自动降级规则引擎；设置页显示今日调用数与 tokens。
69
70
  - 反复全量扫描已分析的会话时，**0 次 AI 调用**。
70
71
 
@@ -74,6 +75,12 @@ Super Kanban 把这些对话转成一张可持续维护的看板：
74
75
  - 联网研判只发送**压缩摘要**：不发送完整会话原文、不发送文件内容、不发送账号凭证。
75
76
  - 所有 AI 功能可在设置中一键关闭，立即降级为本地规则分析。
76
77
 
78
+ ### 界面（v0.4）
79
+
80
+ - 与 DSH 同源的深浅色、字体与间距；"单色为底、克制的强调色"：颜色只出现在状态点、细进度线、优先级小字与类型图标上。
81
+ - 页头常驻常用动作（搜索 / 扫描 / 设置 / 在右侧栏打开 / 新建），「⋯」只保留「导出 JSON」。
82
+ - 更多视觉与交互规则见 [DESIGN.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/DESIGN.md)。
83
+
77
84
  ## 两种形态
78
85
 
79
86
  同一个看板支持两种打开方式：
@@ -107,7 +114,7 @@ Super Kanban 把这些对话转成一张可持续维护的看板：
107
114
 
108
115
  DSH → 插件 → 添加插件 → 输入包名 `dsh-super-kanban`（可附加版本号，如 `dsh-super-kanban@<version>`）→ 安装 → 启用 → 刷新窗口。
109
116
 
110
- > npm 包已发布：`dsh-super-kanban`（https://www.npmjs.com/package/dsh-super-kanban）。发布与索引更新流程见 [docs/MARKET.md](docs/MARKET.md)。
117
+ > npm 包已发布：`dsh-super-kanban`（https://www.npmjs.com/package/dsh-super-kanban）。发布与索引更新流程见 [docs/MARKET.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/MARKET.md)。
111
118
 
112
119
  ### 方式 C：Git 仓库
113
120
 
@@ -125,19 +132,26 @@ cd dsh-super-kanban
125
132
 
126
133
  或在 DSH 插件页选择「本地目录」指向本仓库根目录。安装完成后刷新窗口，左侧栏出现「任务看板」。
127
134
 
128
- ### 升级与卸载
135
+ ### 更新插件（重要）
136
+
137
+ 第三方插件**没有“自动升级”**：更新 = **卸载旧版 → 安装目标版本**，然后刷新 DSH 窗口（必要时完全退出重开）。
138
+
139
+ - **跨 minor 必须用精确版本**：`0.3.x → 0.4.x` 要安装 `dsh-super-kanban@0.4.1` 这类精确版本；旧的范围依赖 `^0.3.0` 在语义化版本下**永远不会**解析到 0.4.x（这是“更新后界面仍是旧版”的常见原因）。
140
+ - **0.4.x 内的小版本**：若 profile 依赖写的是 `^0.4.0`，0.4.1、0.4.2 等补丁版可被正常解析；若插件页安装写的是精确版本，则同样需要卸载后安装目标版本。
141
+ - 更新后先按 `Cmd+R`；界面没变则**完全退出 DSH 再打开**，再按 [INSTALL.md 的“验证版本”](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/INSTALL.md#2-验证安装与版本) 检查实际版本与依赖规格。
142
+
143
+ ### 卸载
129
144
 
130
- - **升级**：插件市场 / npm / Git 安装的，在插件页更新即可；源码安装的 `git pull` 后刷新窗口。
131
145
  - **卸载**：插件页移除，或源码目录执行 `./uninstall.sh -y`。
132
146
  - 卸载**不会删除**看板数据；彻底清空请删除 `~/.dsh/storages/super-kanban/`。
133
147
 
134
- 更详细的安装、升级、排障说明见 [docs/INSTALL.md](docs/INSTALL.md)。
148
+ 更详细的安装、更新、验证、回滚与排障说明见 [docs/INSTALL.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/INSTALL.md)；遇到问题见 [docs/TROUBLESHOOTING.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/TROUBLESHOOTING.md)。
135
149
 
136
150
  ## 使用
137
151
 
138
152
  1. 左侧栏点 **任务看板**（或会话右上角看板图标走右侧栏形态）。
139
153
  2. **看板**：四列——待办 / 进行中 / 受阻 / 已完成；列头显示数量与状态色。
140
- 3. **卡片**：状态点、标题与 AI/规则标记、一句话目标摘要、来源工作区与最近活动时间，以及克制的优先级、问题数、产物数、子任务进度与进度线。
154
+ 3. **卡片**：状态点、标题与 AI/规则标记、来源工作区与最近活动时间，以及克制的优先级、问题数、产物数、子任务进度与进度线。
141
155
  4. **详情抽屉**（点卡片打开）：
142
156
  - 一句话状态摘要（点「编辑」可改字段）
143
157
  - **关键事实**（3–6 条，来自会话的关键进展 / 决策 / 问题）
@@ -207,27 +221,27 @@ DSH 会话（本机只读）
207
221
 
208
222
  | 看板（浅色） | 看板（深色） |
209
223
  | --- | --- |
210
- | ![看板-浅色](docs/screenshots/board-light.png) | ![看板-深色](docs/screenshots/board-dark.png) |
224
+ | ![看板-浅色](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/board-light.png) | ![看板-深色](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/board-dark.png) |
211
225
 
212
226
  | 任务详情（浅色） | 任务详情（深色） |
213
227
  | --- | --- |
214
- | ![任务详情-浅色](docs/screenshots/drawer-light.png) | ![任务详情-深色](docs/screenshots/drawer-dark.png) |
228
+ | ![任务详情-浅色](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/drawer-light.png) | ![任务详情-深色](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/drawer-dark.png) |
215
229
 
216
230
  | 继续此任务弹窗 | 提示词放入原会话输入框 |
217
231
  | --- | --- |
218
- | ![继续此任务](docs/screenshots/continue-modal.png) | ![提示词放入会话](docs/screenshots/continue-placed.png) |
232
+ | ![继续此任务](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/continue-modal.png) | ![提示词放入会话](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/continue-placed.png) |
219
233
 
220
234
  | 右侧栏形态（窄） | 右侧栏全屏 |
221
235
  | --- | --- |
222
- | ![右侧栏形态](docs/screenshots/side-panel.png) | ![右侧栏全屏](docs/screenshots/side-fullscreen.png) |
236
+ | ![右侧栏形态](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/side-panel.png) | ![右侧栏全屏](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/side-fullscreen.png) |
223
237
 
224
238
  | 产物预览入口 | 设置（齿轮常驻） |
225
239
  | --- | --- |
226
- | ![产物](docs/screenshots/drawer-artifacts.png) | ![设置](docs/screenshots/settings-dual.png) |
240
+ | ![产物](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/drawer-artifacts.png) | ![设置](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/settings-dual.png) |
227
241
 
228
242
  | 「⋯」菜单（仅导出 JSON） | 1280 宽窗口 |
229
243
  | --- | --- |
230
- | ![工具栏菜单](docs/screenshots/toolbar-menu.png) | ![1280](docs/screenshots/board-1280.png) |
244
+ | ![工具栏菜单](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/toolbar-menu.png) | ![1280](https://raw.githubusercontent.com/topmindspace/dsh-super-kanban/main/docs/screenshots/board-1280.png) |
231
245
 
232
246
  > 以上截图来自一套完全虚构的演示数据（虚构工作区 / 会话 / 任务），不含任何真实用户或工作区信息。
233
247
 
@@ -244,6 +258,9 @@ DSH 会话（本机只读）
244
258
 
245
259
  ## 常见问题
246
260
 
261
+ **Q：更新插件后界面还是旧版 / 看不到新功能？**
262
+ A：最常见原因是 profile 依赖仍是旧范围（如 `^0.3.0`），跨 minor 需要安装**精确版本**（如 `dsh-super-kanban@0.4.1`）。先 `Cmd+R` 刷新，再完全退出 DSH 重开；仍无效则按 [docs/TROUBLESHOOTING.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/TROUBLESHOOTING.md#更新后-ui-未变) 检查实际安装版本与依赖规格。
263
+
247
264
  **Q：左侧栏没有「任务看板」？**
248
265
  A：按 `Cmd+R` 刷新窗口；仍没有则重启 DSH。仍没有请查看 DSH 插件页的诊断信息（插件加载失败会提示原因）。
249
266
 
@@ -251,7 +268,7 @@ A：按 `Cmd+R` 刷新窗口；仍没有则重启 DSH。仍没有请查看 DSH
251
268
  A：点右上角扫描按钮手动触发；或检查设置中的「自动扫描」是否开启。
252
269
 
253
270
  **Q：AI 判断错了怎么办？**
254
- A：点开卡片直接改字段（编辑即锁定）；也可以在卡片菜单里「重新研判」，让 AI 重新分析该任务的来源会话。
271
+ A：点开卡片直接改字段（编辑即锁定），AI 之后不会再覆盖；如需重新判定，在来源会话中继续对话后等待下一次扫描，插件会自动更新这张卡。
255
272
 
256
273
  **Q：不想让某些工作区进看板？**
257
274
  A：看板页头设置齿轮 → 排除工作区（可多选）。
@@ -277,11 +294,12 @@ npm run check:privacy # 扫描个人路径 / 凭证 / 会话 id 等敏感内容
277
294
  npm run market:index # 重新生成 docs/index.json
278
295
  ```
279
296
 
280
- - 开发环境搭建、目录结构与调试方法见 [CONTRIBUTING.md](CONTRIBUTING.md) 与 [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)。
281
- - 架构说明见 [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)，接口契约见 [docs/CONTRACT.md](docs/CONTRACT.md)，视觉规范见 [docs/DESIGN.md](docs/DESIGN.md)。
282
- - 发布与分发流程（市场索引、npm、Git）见 [docs/MARKET.md](docs/MARKET.md)。
283
- - 安全问题请按 [SECURITY.md](SECURITY.md) 私下报告，不要开公开 issue。
297
+ - 开发环境搭建、目录结构与调试方法见 [CONTRIBUTING.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/CONTRIBUTING.md) 与 [docs/DEVELOPMENT.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/DEVELOPMENT.md)。
298
+ - 架构说明见 [docs/ARCHITECTURE.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/ARCHITECTURE.md)，接口契约见 [docs/CONTRACT.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/CONTRACT.md)，视觉规范见 [docs/DESIGN.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/DESIGN.md)。
299
+ - 发布与分发流程（市场索引、npm、Git）见 [docs/MARKET.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/MARKET.md)。
300
+ - 用户侧排障手册见 [docs/TROUBLESHOOTING.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/docs/TROUBLESHOOTING.md)。
301
+ - 安全问题请按 [SECURITY.md](https://github.com/topmindspace/dsh-super-kanban/blob/main/SECURITY.md) 私下报告，不要开公开 issue。
284
302
 
285
303
  ## License
286
304
 
287
- [MIT](LICENSE) © topmindspace
305
+ [MIT](https://github.com/topmindspace/dsh-super-kanban/blob/main/LICENSE) © topmindspace
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-super-kanban",
3
- "version": "0.4.0",
3
+ "version": "0.4.1",
4
4
  "description": "AI task kanban for DeepSeek Harness: derives task goals, progress, completion and issues from DSH sessions, with key facts, subtasks, artifacts, session hand-off and a dual full-page/right-sidebar UI.",
5
5
  "type": "module",
6
6
  "main": "./index.mjs",