dsh-taskboard 0.2.2 → 0.4.0

package/package.json

@@ -1,74 +1,74 @@
-{
-  "name": "dsh-taskboard",
-  "description": "Agent-first task board for the DSH web GUI: host-authoritative task ledger with taskboard_* agent tools, project (= workspace) claim boundaries, per-task model execution in fresh sessions, host-side cron scheduling, and a live SSE kanban view. Mounts via the official dsh plugin system — no DSH source changes.",
-  "version": "0.2.2",
-  "type": "module",
-  "main": "lib/index.js",
-  "exports": {
-    ".": "./lib/index.js",
-    "./invariant": "./lib/invariant.js",
-    "./client": "./lib/client.js",
-    "./package.json": "./package.json"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "inject": [],
-      "platform": "web"
-    }
-  },
-  "files": [
-    "lib/**/*.js",
-    "lib/**/*.js.map",
-    "src",
-    "cordis.patch.yml",
-    "LICENSE"
-  ],
-  "license": "Apache-2.0",
-  "author": "cloader",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/cloader/dsh-taskboard.git"
-  },
-  "bugs": {
-    "url": "https://github.com/cloader/dsh-taskboard/issues"
-  },
-  "homepage": "https://github.com/cloader/dsh-taskboard#readme",
-  "keywords": [
-    "dsh",
-    "deepseek-harness",
-    "dsh-plugin",
-    "taskboard",
-    "kanban",
-    "agent"
-  ],
-  "scripts": {
-    "build": "npm run build:host && npm run build:client",
-    "build:host": "tsdown -c tsdown.host.config.ts",
-    "build:client": "tsdown -c tsdown.client.config.ts && node scripts/wrap-client.mjs",
-    "watch": "tsdown -c tsdown.host.config.ts --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run"
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-workspace": "^0.1.0-rc.6",
-    "@deepseek-ai/schemastery": "^3.18.1",
-    "@types/node": "^22.20.1",
-    "@types/react": "~18.3.1",
-    "@types/react-dom": "^18.3.7",
-    "jsdom": "^25.0.1",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
-    "tsdown": "0.22.2",
-    "typescript": "~5.7.2",
-    "vitest": "^3.0.0"
-  }
-}
+{
+  "name": "dsh-taskboard",
+  "description": "Agent-first task board for the DSH web GUI: host-authoritative task ledger with taskboard_* agent tools, project (= workspace) claim boundaries, per-task model execution in fresh sessions, optional per-task git-worktree isolation (dedicated task branches, commit evidence, one-click merge), host-side cron scheduling, and a live SSE kanban view. Mounts via the official dsh plugin system — no DSH source changes.",
+  "version": "0.4.0",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./invariant": "./lib/invariant.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [],
+      "platform": "web"
+    }
+  },
+  "files": [
+    "lib/**/*.js",
+    "lib/**/*.js.map",
+    "src",
+    "cordis.patch.yml",
+    "LICENSE"
+  ],
+  "license": "Apache-2.0",
+  "author": "cloader",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cloader/dsh-taskboard.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cloader/dsh-taskboard/issues"
+  },
+  "homepage": "https://github.com/cloader/dsh-taskboard#readme",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "dsh-plugin",
+    "taskboard",
+    "kanban",
+    "agent"
+  ],
+  "scripts": {
+    "build": "npm run build:host && npm run build:client",
+    "build:host": "tsdown -c tsdown.host.config.ts",
+    "build:client": "tsdown -c tsdown.client.config.ts && node scripts/wrap-client.mjs",
+    "watch": "tsdown -c tsdown.host.config.ts --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-workspace": "^0.1.0-rc.6",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "@types/node": "^22.20.1",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "^18.3.7",
+    "jsdom": "^25.0.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsdown": "0.22.2",
+    "typescript": "~5.7.2",
+    "vitest": "^3.0.0"
+  }
+}

package/src/client/api.ts

@@ -10,11 +10,20 @@ import type {
   ChangeEvent,
   CreateTaskBody,
   DeleteTaskBody,
+  DiagnosticsResponse,
+  DiffResponse,
+  ImportCommitResponse,
+  ImportPreviewResponse,
+  MergeBranchResponse,
   MoveTaskBody,
   RejectTaskBody,
+  RunTaskBody,
   StateResponse,
   TaskRecord,
+  TaskTemplate,
+  TemplatesResponse,
   UpdateTaskBody,
+  WorktreeRemoveBody,
   WorkspaceView,
 } from '../shared/api.ts'
 import type { CommentRecord, TaskSummary } from '../shared/protocol.ts'
@@ -49,10 +58,30 @@ export interface TaskboardClient {
   reject(id: string, body: RejectTaskBody): Promise<TaskSummary>
   comment(id: string, bodyText: string): Promise<CommentRecord>
   remove(id: string, body: DeleteTaskBody): Promise<{ trashed?: boolean; purged?: boolean }>
-  /** Trigger a manual run (fresh in-project session). */
-  run(id: string): Promise<{ executionId: string; sessionId: string }>
+  /** Trigger a manual run (fresh in-project session); `reuse: true` = 续跑. */
+  run(id: string, body?: RunTaskBody): Promise<{ executionId: string; sessionId: string }>
   /** Cancel the running execution (stops the agent session; task returns to todo). */
   cancel(id: string): Promise<{ cancelled: true; executionId: string }>
+  /** Merge the task branch into the main worktree (--no-ff, user-only). */
+  mergeBranch(id: string): Promise<MergeBranchResponse>
+  /** Remove the task's worktree; optionally delete its branch. */
+  worktreeRemove(id: string, body: WorktreeRemoveBody): Promise<{ removed: true; branchDeleted: boolean; branchError?: string }>
+  /** Health diagnostics (⚙ panel). */
+  diagnostics(): Promise<DiagnosticsResponse>
+  /** Clean up one orphan worktree directory (task no longer in the ledger). */
+  worktreeCleanup(workspaceId: string, taskId: string): Promise<{ cleaned: true; path: string }>
+  /** Diff view: one execution's commit or changed path (read-only, capped). */
+  diff(taskId: string, query: { execution: string; commit?: string; path?: string }): Promise<DiffResponse>
+  /** Import dry-run: classify the uploaded ledger against the live one. */
+  importPreview(file: unknown): Promise<ImportPreviewResponse>
+  /** Commit an import (merge upserts; replace swaps the whole ledger, backing it up first). */
+  importCommit(mode: 'merge' | 'replace', ledger: unknown): Promise<ImportCommitResponse>
+  /** List task templates. */
+  templates(): Promise<TemplatesResponse>
+  /** Create or replace a template. */
+  templateUpsert(body: { id?: string; name: string; task: TaskTemplate['task'] }): Promise<TaskTemplate>
+  /** Delete a template by id. */
+  templateDelete(id: string): Promise<{ deleted: boolean }>
   /** Subscribe to change frames; the disposer stops the stream. */
   stream(onChange: (event: ChangeEvent) => void, onGap: () => void): () => void
 }
@@ -69,8 +98,23 @@ export function createClient(): TaskboardClient {
     reject: (id, body) => post(`/dsh-taskboard/tasks/${encodeURIComponent(id)}/reject`, body),
     comment: (id, bodyText) => post(`/dsh-taskboard/tasks/${encodeURIComponent(id)}/comment`, { body: bodyText }),
     remove: (id, body) => post(`/dsh-taskboard/tasks/${encodeURIComponent(id)}/delete`, body),
-    run: id => post(`/dsh-taskboard/tasks/${encodeURIComponent(id)}/run`, {}),
+    run: (id, body) => post(`/dsh-taskboard/tasks/${encodeURIComponent(id)}/run`, body ?? {}),
     cancel: id => post(`/dsh-taskboard/tasks/${encodeURIComponent(id)}/cancel`, {}),
+    mergeBranch: id => post(`/dsh-taskboard/tasks/${encodeURIComponent(id)}/merge`, {}),
+    worktreeRemove: (id, body) => post(`/dsh-taskboard/tasks/${encodeURIComponent(id)}/worktree-remove`, body),
+    diagnostics: () => unwrap<DiagnosticsResponse>(fetch('/dsh-taskboard/diagnostics')),
+    worktreeCleanup: (workspaceId, taskId) => post('/dsh-taskboard/worktree-cleanup', { workspaceId, taskId }),
+    diff: (taskId, query) => {
+      const params = new URLSearchParams({ execution: query.execution })
+      if (query.commit !== undefined) params.set('commit', query.commit)
+      if (query.path !== undefined) params.set('path', query.path)
+      return unwrap<DiffResponse>(fetch(`/dsh-taskboard/tasks/${encodeURIComponent(taskId)}/diff?${params.toString()}`))
+    },
+    importPreview: file => post('/dsh-taskboard/import/preview', file),
+    importCommit: (mode, ledger) => post('/dsh-taskboard/import', { mode, ledger }),
+    templates: () => unwrap<TemplatesResponse>(fetch('/dsh-taskboard/templates')),
+    templateUpsert: body => post('/dsh-taskboard/templates', body),
+    templateDelete: id => post('/dsh-taskboard/templates/delete', { id }),
     stream(onChange, onGap) {
       const es = new EventSource('/dsh-taskboard/events')
       let revision: number | undefined

package/src/client/board/ImportModal.tsx

@@ -0,0 +1,182 @@
+/**
+ * The ledger-import modal (0.4.0): pick a JSON file → dry-run preview
+ * (create / overwrite / invalid classification) → commit as merge or
+ * replace. Replace swaps the WHOLE ledger after an automatic backup and a
+ * double confirmation. Files exported by ⬇ JSON import as-is.
+ *
+ * @module dsh-taskboard/client/board/ImportModal
+ */
+import { useRef, useState } from 'react'
+import type { BoardController } from '../controller.ts'
+import type { ImportPreviewResponse } from '../../shared/api.ts'
+import { useAlert } from './AlertModal.tsx'
+
+/** One classified row (create / overwrite). */
+function PlanRow({ row }: { row: { id: string; title: string; status: string } }) {
+  return (
+    <div className="dsh-atb-imp-row" title={row.id}>
+      <span className="dsh-atb-imp-row-title">{row.title}</span>
+      <span className="dsh-atb-imp-row-status">{row.status}</span>
+    </div>
+  )
+}
+
+/**
+ * The import modal.
+ * @param controller - the controller.
+ */
+export function ImportModal({ controller }: { controller: BoardController }) {
+  const [fileName, setFileName] = useState('')
+  const [parsed, setParsed] = useState<unknown>(null)
+  const [parseError, setParseError] = useState<string | undefined>(undefined)
+  const [plan, setPlan] = useState<ImportPreviewResponse['plan'] | undefined>(undefined)
+  const [mode, setMode] = useState<'merge' | 'replace'>('merge')
+  const [busy, setBusy] = useState(false)
+  const [result, setResult] = useState<string | undefined>(undefined)
+  const [confirmReplace, setConfirmReplace] = useState(false)
+  const fileRef = useRef<HTMLInputElement>(null)
+  const { alert: showAlert, el: alertEl } = useAlert()
+
+  /** Read + parse the picked file, then dry-run the preview. */
+  const onFile = (file: File | undefined): void => {
+    setPlan(undefined)
+    setParseError(undefined)
+    setResult(undefined)
+    setConfirmReplace(false)
+    setFileName('')
+    setParsed(null)
+    if (file === undefined) return
+    void file.text().then(text => {
+      try {
+        const value: unknown = JSON.parse(text)
+        setParsed(value)
+        setFileName(file.name)
+        void controller.importPreview(value).then(p => {
+          if (p !== undefined) setPlan(p)
+        })
+      } catch {
+        setParseError('文件不是合法 JSON')
+      }
+    })
+  }
+
+  /** Commit the import (replace requires the inline double confirmation). */
+  const commit = (): void => {
+    if (parsed === null || plan === undefined || busy) return
+    if (mode === 'replace' && !confirmReplace) {
+      setConfirmReplace(true)
+      return
+    }
+    setBusy(true)
+    void controller.importCommit(mode, parsed).then(r => {
+      setBusy(false)
+      setConfirmReplace(false)
+      if (r === undefined) return
+      setResult(r.mode === 'replace'
+        ? `整册替换完成：导入 ${r.created + r.overwritten} 张（原 ${r.replacedTotal} 张已整册备份）`
+        : `合并完成：新增 ${r.created} 张、覆盖 ${r.overwritten} 张`)
+    })
+  }
+
+  const close = (): void => controller.closeImport()
+
+  return (
+    <div className="dsh-atb-modal-backdrop" onClick={e => { if (e.target === e.currentTarget) close() }}>
+      <div className="dsh-atb-modal dsh-atb-imp" role="dialog" aria-modal="true" aria-label="导入台账">
+        <div className="dsh-atb-modal-head">
+          <span className="dsh-atb-modal-headicon">⬆</span>
+          <div className="dsh-atb-modal-headtext">
+            <h3>导入台账</h3>
+            <p>选择导出的 JSON 备份文件：先预览、再合并或整册替换</p>
+          </div>
+          <button type="button" className="dsh-atb-modal-close" aria-label="关闭" onClick={close}>✕</button>
+        </div>
+        <div className="dsh-atb-modal-body">
+          <div className="dsh-atb-imp-picker">
+            <input
+              ref={fileRef}
+              type="file"
+              accept=".json,application/json"
+              onChange={e => onFile(e.target.files?.[0])}
+            />
+            {fileName.length > 0 && <span className="dsh-atb-imp-filename">{fileName}</span>}
+          </div>
+          <div className="dsh-atb-imp-note">⬇ JSON 导出的文件即为同格式备份，可直接导入恢复；导入文件的 schemaVersion 必须与当前版本一致。</div>
+
+          {parseError !== undefined && <div className="dsh-atb-imp-error">{parseError}</div>}
+          {plan === undefined && parseError === undefined && fileName.length > 0 && <div className="dsh-atb-empty2">预览中…</div>}
+
+          {plan !== undefined && (
+            <>
+              <div className="dsh-atb-imp-stats">
+                <div className="dsh-atb-imp-stat" data-tone="ok"><b>{plan.create.length}</b><span>新增</span></div>
+                <div className="dsh-atb-imp-stat" data-tone="warn"><b>{plan.overwrite.length}</b><span>覆盖（同 id）</span></div>
+                <div className="dsh-atb-imp-stat" data-tone={plan.invalid.length > 0 ? 'bad' : undefined}><b>{plan.invalid.length}</b><span>无效（跳过）</span></div>
+              </div>
+
+              {plan.create.length > 0 && (
+                <div className="dsh-atb-imp-sec">
+                  <h4>新增任务</h4>
+                  <div className="dsh-atb-imp-list">{plan.create.map(r => <PlanRow key={r.id} row={r} />)}</div>
+                </div>
+              )}
+              {plan.overwrite.length > 0 && (
+                <div className="dsh-atb-imp-sec">
+                  <h4>覆盖任务（整卡替换，含执行历史与评论）</h4>
+                  <div className="dsh-atb-imp-list">{plan.overwrite.map(r => <PlanRow key={r.id} row={r} />)}</div>
+                </div>
+              )}
+              {plan.invalid.length > 0 && (
+                <div className="dsh-atb-imp-sec">
+                  <h4>无效条目（不会导入）</h4>
+                  <div className="dsh-atb-imp-list">
+                    {plan.invalid.map((r, i) => (
+                      <div key={r.id ?? `invalid-${i}`} className="dsh-atb-imp-row" data-tone="bad" title={r.id ?? ''}>
+                        <span className="dsh-atb-imp-row-title">{r.id ?? '（无 id）'}</span>
+                        <span className="dsh-atb-imp-row-status">{r.reason}</span>
+                      </div>
+                    ))}
+                  </div>
+                </div>
+              )}
+
+              <div className="dsh-atb-mode-picker">
+                <button type="button" className="dsh-atb-mode-opt" data-on={mode === 'merge'} onClick={() => { setMode('merge'); setConfirmReplace(false) }}>
+                  <span className="dsh-atb-mode-name">⊕ 合并</span>
+                  <span className="dsh-atb-mode-hint">新增 + 按 id 覆盖，其余不动</span>
+                </button>
+                <button type="button" className="dsh-atb-mode-opt" data-on={mode === 'replace'} onClick={() => setMode('replace')}>
+                  <span className="dsh-atb-mode-name">💣 整册替换</span>
+                  <span className="dsh-atb-mode-hint">清空当前台账，以导入文件为准（先自动备份）</span>
+                </button>
+              </div>
+
+              {result !== undefined && <div className="dsh-atb-imp-result">{result}</div>}
+            </>
+          )}
+        </div>
+        <div className="dsh-atb-modal-foot">
+          <span className="dsh-atb-modal-hint">
+            {mode === 'replace'
+              ? confirmReplace ? '⚠ 再次点击确认执行整册替换（不可撤销，已自动备份）' : '整册替换需要二次确认'
+              : '合并只写入预览中列出的任务'}
+          </span>
+          <span className="dsh-atb-modal-footbtns">
+            <button type="button" className="dsh-atb-btn" onClick={close}>{result !== undefined ? '关闭' : '取消'}</button>
+            <button
+              type="button"
+              className="dsh-atb-btn"
+              data-primary="true"
+              data-danger={mode === 'replace' && confirmReplace ? 'true' : undefined}
+              disabled={plan === undefined || busy || (result !== undefined && false)}
+              onClick={commit}
+            >
+              {mode === 'replace' && confirmReplace ? '确认整册替换' : '执行导入'}
+            </button>
+          </span>
+        </div>
+      </div>
+      {alertEl}
+    </div>
+  )
+}

package/src/client/board/TaskBoard.tsx

@@ -12,6 +12,8 @@ import { PLUGIN_VERSION } from '../../shared/version.ts'
 import { DRAG_TYPE, TaskCard } from './TaskCard.tsx'
 import { TaskDetail } from './TaskDetail.tsx'
 import { TaskFormModal } from './TaskFormModal.tsx'
+import { ImportModal } from './ImportModal.tsx'
+import { TemplateManager } from './TemplateManager.tsx'
 import { useAlert } from './AlertModal.tsx'
 
 /** Column labels. */
@@ -85,15 +87,50 @@ export function TaskBoard({ controller }: { controller: BoardController }) {
   const live = filterTasks(state, state.ledger.tasks.filter(t => t.trashedAt === undefined))
   const selected = state.selectedId === undefined ? undefined : state.ledger.tasks.find(t => t.id === state.selectedId)
   const { alert: showAlert, el: alertEl } = useAlert()
+  // + 新建任务 ▼ dropdown (0.4.0): blank / templates / manage / import.
+  const [newMenuOpen, setNewMenuOpen] = useState(false)
+  const closeMenu = (): void => setNewMenuOpen(false)
 
   return (
     <div className="dsh-atb-board">
       <div className="dsh-atb-toolbar">
         <h2 className="dsh-atb-title">Agent 任务看板</h2>
         <span className="dsh-atb-count">{live.length} 任务 · rev {state.ledger.revision}</span>
-        <button type="button" className="dsh-atb-btn" data-primary="true" onClick={() => controller.setComposer(true)}>
-          + 新建任务
-        </button>
+        <div className="dsh-atb-newmenu">
+          <button
+            type="button"
+            className="dsh-atb-btn"
+            data-primary="true"
+            onClick={() => {
+              const next = !newMenuOpen
+              setNewMenuOpen(next)
+              if (next) controller.prepareTemplateMenu()
+            }}
+          >
+            + 新建任务 ▼
+          </button>
+          {newMenuOpen && (
+            <>
+              <div className="dsh-atb-newmenu-backdrop" onClick={closeMenu} />
+              <div className="dsh-atb-newmenu-list">
+                <button type="button" className="dsh-atb-newmenu-opt" onClick={() => { closeMenu(); controller.setComposer(true) }}>空白任务</button>
+                {state.templates.map(t => (
+                  <button
+                    key={t.id}
+                    type="button"
+                    className="dsh-atb-newmenu-opt"
+                    title={t.task.description !== undefined && t.task.description.length > 0 ? t.task.description.slice(0, 120) : t.name}
+                    onClick={() => { closeMenu(); controller.newFromTemplate(t.task) }}
+                  >
+                    {t.name}{t.builtin === true ? '' : ''}
+                  </button>
+                ))}
+                <div className="dsh-atb-newmenu-sep" />
+                <button type="button" className="dsh-atb-newmenu-opt" onClick={() => { closeMenu(); controller.openTemplateManager() }}>⌗ 管理模板…</button>
+              </div>
+            </>
+          )}
+        </div>
         <div className="dsh-atb-spacer" />
         <input
           className="dsh-atb-input dsh-atb-search"
@@ -137,6 +174,8 @@ export function TaskBoard({ controller }: { controller: BoardController }) {
         <button type="button" className="dsh-atb-btn" onClick={() => controller.toggleSecondary()}>
           {state.secondaryOpen ? '返回看板' : '其它任务'}
         </button>
+        <button type="button" className="dsh-atb-btn" title="健康诊断：遗留 worktree、台账基本项" onClick={() => controller.openDiagnostics()}>⚙ 诊断</button>
+        <button type="button" className="dsh-atb-btn" title="从 JSON 备份文件导入台账（预览后合并或整册替换）" onClick={() => controller.openImport()}>⬆ 导入</button>
         <button type="button" className="dsh-atb-btn" title="下载完整台账备份（JSON）" onClick={() => controller.exportJson()}>⬇ JSON</button>
         <button type="button" className="dsh-atb-btn" title="下载任务清单（CSV）" onClick={() => controller.exportCsv()}>⬇ CSV</button>
         <a
@@ -220,11 +259,87 @@ export function TaskBoard({ controller }: { controller: BoardController }) {
         />
       )}
 
+      {state.diagOpen && <DiagnosticsPanel controller={controller} />}
+
+      {state.importOpen && <ImportModal controller={controller} />}
+
+      {state.tplManagerOpen && <TemplateManager controller={controller} />}
+
       {alertEl}
     </div>
   )
 }
 
+/** ⚙ Health-diagnostics panel (plan §3.6): ledger basics + orphan worktrees + one-click cleanup. */
+function DiagnosticsPanel({ controller }: { controller: BoardController }) {
+  const state = controller.getSnapshot()
+  const diag = state.diagnostics
+  const wsName = (id: string): string => {
+    const ws = state.workspaces.find(w => w.id === id)
+    return ws?.title ?? ws?.path ?? id.slice(0, 8)
+  }
+  return (
+    <div className="dsh-atb-modal-backdrop" onClick={e => { if (e.target === e.currentTarget) controller.closeDiagnostics() }}>
+      <div className="dsh-atb-modal dsh-atb-diag" role="dialog" aria-modal="true" aria-label="健康诊断">
+        <div className="dsh-atb-modal-head">
+          <span className="dsh-atb-modal-headicon">⚙</span>
+          <div className="dsh-atb-modal-headtext">
+            <h3>健康诊断</h3>
+            <p>台账基本项与 worktree 遗留清理</p>
+          </div>
+          <button type="button" className="dsh-atb-modal-close" aria-label="关闭" onClick={() => controller.closeDiagnostics()}>✕</button>
+        </div>
+        <div className="dsh-atb-modal-body">
+          {diag === undefined
+            ? <div className="dsh-atb-empty2">读取中…</div>
+            : (
+              <>
+                <div className="dsh-atb-diag-grid">
+                  <div className="dsh-atb-diag-item"><b>{diag.revision}</b><span>台账修订号</span></div>
+                  <div className="dsh-atb-diag-item"><b>{diag.tasks}</b><span>任务总数</span></div>
+                  <div className="dsh-atb-diag-item" data-bad={diag.staleRunning > 0 ? 'true' : undefined}><b>{diag.staleRunning}</b><span>执行中</span></div>
+                  <div className="dsh-atb-diag-item" data-bad={diag.orphanWorktrees.length > 0 ? 'true' : undefined}><b>{diag.orphanWorktrees.length}</b><span>遗留 worktree</span></div>
+                </div>
+                <div className="dsh-atb-diag-sec">
+                  <h4>遗留 worktree（台账无主但目录存在）</h4>
+                  {diag.orphanWorktrees.length === 0
+                    ? <div className="dsh-atb-empty2">无遗留 — 各项目 .dsh-worktrees 目录干净</div>
+                    : (
+                        <div className="dsh-atb-diag-orphans">
+                          {diag.orphanWorktrees.map(o => (
+                            <div key={o.path} className="dsh-atb-diag-orphan">
+                              <span className="dsh-atb-diag-orphan-path" title={o.path}>{wsName(o.workspaceId)} · {o.taskId}</span>
+                              <button type="button" className="dsh-atb-btn" data-danger="true" onClick={() => void controller.cleanupOrphan(o.workspaceId, o.taskId)}>清理</button>
+                            </div>
+                          ))}
+                        </div>
+                      )}
+                  <div className="dsh-atb-empty2">提示：有未提交修改的遗留目录会被拒绝清理，请先手动处理其内容。live 任务的 worktree 请在任务详情页删除。</div>
+                </div>
+                <div className="dsh-atb-diag-sec">
+                  <h4>gitignore 建议</h4>
+                  {(diag.gitIgnoreSuggestions ?? []).length === 0
+                    ? <div className="dsh-atb-empty2">无待办 — 各 git 项目已忽略 .dsh-worktrees 目录</div>
+                    : (
+                        <div className="dsh-atb-diag-orphans">
+                          {diag.gitIgnoreSuggestions.map(s => (
+                            <div key={s.workspaceId} className="dsh-atb-diag-orphan">
+                              <span className="dsh-atb-diag-orphan-path" title={s.workspacePath}>
+                                {wsName(s.workspaceId)} · 建议在 .gitignore 加入一行 <code>.dsh-worktrees/</code>（不会自动修改）
+                              </span>
+                            </div>
+                          ))}
+                        </div>
+                      )}
+                </div>
+              </>
+            )}
+        </div>
+      </div>
+    </div>
+  )
+}
+
 /** Secondary tab: tasks grouped into canceled / archived / trashed columns. */
 function SecondaryTab({ controller, tasks }: { controller: BoardController; tasks: TaskRecord[] }) {
   // Trashed takes precedence (a trashed task still carries its old status,

package/src/client/board/TaskCard.tsx

@@ -86,6 +86,15 @@ export function TaskCard({ task, controller, draggable = false, now, onAlert }:
           <span className="dsh-atb-badge" data-kind="scheduled">⏰ {fmtTime(task.execution.nextRunAt)}</span>
         )}
         {task.model !== undefined && <span className="dsh-atb-badge">{task.model.model}</span>}
+        {task.checklist !== undefined && task.checklist.length > 0 && (
+          <span
+            className="dsh-atb-badge"
+            data-kind={task.status === 'in_review' && task.checklist.some(i => !i.checked) ? 'blocked' : 'checklist'}
+            title={task.status === 'in_review' && task.checklist.some(i => !i.checked) ? '待验收：清单未全部勾选' : '验收清单进度'}
+          >
+            ☑ {task.checklist.filter(i => i.checked).length}/{task.checklist.length}
+          </span>
+        )}
         {task.status === 'done' && <span className="dsh-atb-badge" data-kind="done">完成</span>}
         {last !== undefined && (
           <span className="dsh-atb-badge" data-kind={last.outcome === 'running' ? 'running' : last.outcome}>