zdashboard 2.1.0 → 2.2.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 CHANGED
@@ -202,7 +202,6 @@ node dist/cli.js --dir <项目根> --port 4190 --plugins ./my-plugins
202
202
 
203
203
  ### 环境变量
204
204
 
205
- - `PORT`:默认 4190(未被 `--port` 覆盖时)
206
205
 
207
206
  ### 内置路由
208
207
 
@@ -224,6 +223,7 @@ node dist/cli.js --dir <项目根> --port 4190 --plugins ./my-plugins
224
223
  | `/__docs` | GET | 项目文档列表 |
225
224
  | `/__apply` | GET | OpenSpec changes 列表 |
226
225
  | `/__apply/change` | GET | `?name=<change>` 详情 |
226
+ | `/__worktrees` | GET | `.zworktree/` 下的 worktree 列表(`git worktree list --porcelain`) |
227
227
  | `/__design/assets` | GET | 设计资产扫描 |
228
228
  | `/__stats/data` | GET | 项目统计(内置 stats 插件) |
229
229
  | `/__notes/data` | GET | 便签列表(examples/notes 示例) |
@@ -248,6 +248,28 @@ node dist/cli.js --dir <项目根> --port 4190 --plugins ./my-plugins
248
248
  - **构建**:tsup(CLI) + Vite(SPA)
249
249
  - **包管理**:pnpm
250
250
 
251
+ ## 数据约定
252
+
253
+ ### .zdev/ 数据目录
254
+
255
+ zdashboard v2.1+ 优先读取 `.zdev/` 下的数据文件(与 zskills 新协议对齐):
256
+
257
+ | 文件 | 说明 | 回退路径 |
258
+ |------|------|---------|
259
+ | `.zdev/config.yaml` | 禅道凭据(zgoal skill 创建) | `.zgoal/config.yaml` |
260
+ | `.zdev/review.yaml` | 评审数据 | 根目录 `review.yaml` |
261
+ | `.zdev/*.md` | 评审相关文档(brief.md 等) | — |
262
+
263
+ 启动日志会打印数据目录:`data -> .zdev/`(仅 `.zdev/` 存在时)。
264
+
265
+ ### worktree 执行模型
266
+
267
+ zapply 在 `.zworktree/<change-name>/` 下创建独立 worktree,apply 插件会优先读取 worktree 内的 `tasks.md`/`proposal.md`/`design.md`,主目录兜底。Viewer 卡片会显示 `worktree 执行中` badge。
268
+
269
+ ### --restart 端口继承
270
+
271
+ `--restart` 重启时,新实例会优先尝试旧实例的端口(通过 `.zdev/dashboard.json` 记录),避免书签/标签失效。用户显式 `--port` 时仍尊重用户选择。
272
+
251
273
  ## 迁移状态
252
274
 
253
275
  - [x] zview-dashboard → zdashboard(v1.0.0)