dsh-taskboard 0.6.7 → 0.7.0

package/README.md

@@ -74,7 +74,7 @@ dsh plugin --profile web add "link:/path/to/dsh-taskboard"
 link 安装后，仓库里 `npm run build` 重建、刷新页面即生效；改完宿主侧代码需重启 `dsh web`。
 </details>
 
-卸载：`dsh plugin --profile web remove dsh-taskboard`（台账数据保留在 DSH 主目录，见[配置与数据](#配置与数据)）。
+卸载：`dsh plugin --profile web remove dsh-taskboard`（台账数据保留在当前数据目录，见[配置与数据](#配置与数据)）。
 
 > 官方 `@deepseek-ai/dsh-*` 包只写进 profile 的 `bundles` 列表，不要 `plugin add` 进 dependencies（避免 SDK 双实例遮蔽）。
 
@@ -133,7 +133,8 @@ agent：
 - 新建/编辑弹窗：项目、模型（含思考强度）、紧急度、执行方式、cron 实时校验与下次运行预览、执行隔离开关、验收清单编辑
 - 详情面板：状态流转（done 仅限人工；清单未全勾时完成需二次确认并显示未勾数）、agent/用户评论流、执行记录（倒序，最新在最上；会话 ID 点击跳转打开该执行会话；已删除/已归档分开提示）、停止执行、Worktree 隔离块（分支 / 提交 / 改动统计 / 合并与清理）、执行报告块、验收清单块
 - 待验收列卡片快捷操作：「✓ 完成」一键验收、「✗ 退回」退回待办并可附退回原因（agent 开工前会读）
-- **双栏宽屏任务弹窗 + Slash 补全（0.6.0）**：新建/编辑弹窗左右双栏（左栏核心字段与执行配置，右栏描述与 Prompt）；描述/Prompt 输入 `/` 即弹出命令与技能补全（↑↓/Enter/Tab/Esc 键盘导航，宿主动态发现与内置清单合并）；描述与 Prompt 中的 Markdown 图片渲染为缩略图，点击灯箱放大
+- **图片附件（0.7.0）**：任务描述与评论可选择、粘贴或拖放 PNG/JPEG/GIF/WebP，自动插入 Markdown；详情中显示缩略图，点击灯箱放大。图片保存在本机数据目录，单文件上限 5 MiB
+- **双栏宽屏任务弹窗 + Slash 补全（0.6.0）**：新建/编辑弹窗左右双栏（左栏核心字段与执行配置，右栏描述与 Prompt）；描述/Prompt 输入 `/` 即弹出命令与技能补全（↑↓/Enter/Tab/Esc 键盘导航，宿主动态发现与内置清单合并）；描述与 Prompt 中的 Markdown 图片渲染为缩略图，点击灯箱放大
 - **执行权限（0.6.0）**：任务级三档执行权限（📁 可写入工作区 / 🔒 仅可查看 / ⚡ 完全权限），表单选择 + 看板设置默认执行权限；卡片、详情、模板列表显示权限徽章
 - **界面中英双语（0.6.0）**：看板全部界面文案跟随 DSH「设置 → 通用设置 → 语言」（zh/en）实时切换，无需刷新；语言偏好由 DSH 统一存储（settings.yaml 的 locale.preference），插件自身不新增任何配置；无 locale 服务的环境自动按浏览器语言降级
 - **外部会话自动同步（0.5.5）**：看板设置开启「🔄 自动纳入会话」后，工作区直接新建的会话自动在看板生成任务卡片（按会话工作目录映射项目，取首条消息作标题/描述）——运行中进「进行中」并绑定会话（可一键跳转）、成功结算自动流转「待验收」、异常退回「待办」；自动过滤看板内部执行会话（0.6.0 起连同子代理会话一并过滤），多轮续跑延续同一张卡片；出厂默认关闭
@@ -142,7 +143,7 @@ agent：
 - **验收清单 DoD（0.4.0）**：建卡时定验收条件（≤30 项）；agent 用 `taskboard_checklist` 增补/勾选（附证据 note）；用户在详情页直接勾选；待验收时未完成项红色高亮 + 卡片「☑ n/m」角标（未全勾显红）；清单编辑在表单中整组管理（勾选状态与证据保留）
 - **结构化执行报告（0.4.0）**：agent 收尾用 `taskboard_execution_report` 提交（摘要 / 改动文件 / 自验 / 产物 / 剩余风险），自动挂到当前执行记录；待验收详情页分栏渲染；开场框架行明示提交时序（报告 → 评论 → 移待验收）
 - **JSON 导入（0.4.0）**：顶栏「⬆ 导入」选择备份文件 → 干跑预览（新增 / 覆盖 / 无效分类明细）→ 合并（按 id upsert）或整册替换（自动先备份当前台账 + 二次确认）；⬇ JSON 导出的文件即同格式可直接恢复
-- **任务模板（0.4.0）**：「+ 新建任务 ▼」下拉（空白 / 内置 新增功能·Bug 修复·发布检查·例行巡检 / 管理模板）一键预填表单（标题/描述/Prompt/紧急度/定时/隔离/preset/清单）；任务详情「⌗ 存为模板」沉淀常用配置；模板存 DSH 主目录 side file，改名/删除在管理弹窗
+- **任务模板（0.4.0）**：「+ 新建任务 ▼」下拉（空白 / 内置 新增功能·Bug 修复·发布检查·例行巡检 / 管理模板）一键预填表单（标题/描述/Prompt/紧急度/定时/隔离/preset/清单）；任务详情「⌗ 存为模板」沉淀常用配置；模板随台账保存在当前数据目录，改名/删除在管理弹窗
 - **Diff 查看器（0.4.0）**：隔离块提交行、未提交修改文件行点击即在看板内展开 diff（提交 `git show` / 文件 `git diff`，128KB·2000 行封顶标注截断）；worktree 已删时回落主仓（仅限提交与带基线的范围 diff）
 
 **Agent 工具（taskboard_\*）**
@@ -164,7 +165,7 @@ agent：
 
 - **验收权只属于人**：agent 把任务移到 done 的调用被代码级协议闸直接拒绝（不是提示词约定）；任务被持有时不可抢占，跨项目不可认领。
 - **Worktree 隔离是协作约定而非沙箱**：执行会话拥有完整工具权限，隔离依赖分支约定，不适用于运行不可信代码的场景。
-- **数据本地**：台账、模板全部存本机 DSH 主目录；不外发任何数据，无需 Token / API Key。
+- **数据本地**：台账、模板和图片附件全部存本机，可在看板设置中迁移数据目录；不外发任何数据，无需 Token / API Key。
 
 ## 配置与数据 
 
@@ -173,19 +174,21 @@ agent：
 | 环境变量 | 默认 | 说明 |
 | --- | --- | --- |
 | `DSH_TASKBOARD_MAX_CONCURRENT` | `3` | 全局同时执行的会话数上限 |
-| `DSH_HOME` | `~/.dsh` | DSH 主目录（跟随部署，插件数据随之） |
+| `DSH_HOME` | `~/.dsh` | DSH 主目录，也是未自定义时的数据目录及位置引导文件所在目录 |
 | `ATB_TRACE` | 未设置 | `=1` 时 host 打印工具调用跟踪（调试用） |
 
-数据文件（均在 DSH 主目录，卸载插件不删除）：
+数据目录默认是 `DSH_HOME`，可在「🛠 设置 → 数据存储位置」中检查并迁移到其他绝对路径。三个数据项始终一起迁移；卸载插件不删除数据。
 
 | 文件 | 内容 |
 | --- | --- |
-| `dsh-taskboard.json` | 任务台账（全部任务/执行/评论） |
-| `dsh-taskboard-templates.json` | 任务模板 |
-| `dsh-taskboard.json.backup-<时间戳>` | 整册导入替换前的自动备份 |
+| `dsh-taskboard.json` | 任务台账（全部任务/执行/评论） |
+| `dsh-taskboard-templates.json` | 任务模板 |
+| `dsh-taskboard-assets/` | 图片附件（按内容哈希去重） |
+| `dsh-taskboard.json.backup-<时间戳>` | 整册导入替换前的自动备份 |
+| `DSH_HOME/dsh-taskboard-storage.json` | 自定义数据目录的位置引导文件；固定留在 DSH 主目录 |
 | `<项目>/.dsh-worktrees/<任务ID>/` | 任务执行 worktree（多仓库工作区：整区任务镜像，每仓库一个子 worktree） |
 
-随时可顶栏「⬇ JSON」全量备份、「⬇ CSV」导出任务清单（带 BOM，Excel 直接打开）。
+随时可顶栏「⬇ JSON」备份台账、「⬇ CSV」导出任务清单（带 BOM，Excel 直接打开）。图片附件不在 JSON 内；完整备份需复制设置页显示的数据目录中的 `dsh-taskboard-assets/` 文件夹。
 
 ## 常见问题
 
@@ -193,7 +196,7 @@ agent：
 刷新页面；仍没有则确认插件已装进当前 profile 并重启 `dsh web`（宿主半区在进程启动时加载）。三代 shell 均支持：`data-pane`（dev）、哈希类名（官方布局，0.4.2 起）、DSH Desktop 非兼容 extended frame（0.5.2 起）。
 
 **任务数据存在哪？怎么备份？**
-见[配置与数据](#配置与数据)。GUI「⬇ JSON」随时全量导出；「⬆ 导入」可恢复。
+见[配置与数据](#配置与数据)。GUI「⬇ JSON」可导出、恢复台账；图片附件还需备份 `dsh-taskboard-assets/` 文件夹。
 
 **浏览器关了，定时任务还跑吗？**
 跑。调度在 host 进程侧，与浏览器无关；错过的时间窗口跳过不补跑。
@@ -230,9 +233,16 @@ node tests/manual-git-e2e.mjs   # 真 git 端到端手测（worktree 全链路 +
 node scripts/screenshot.mjs     # 重新生成 img/ 截图（需本机 Edge）
 ```
 
-## 升级日志
-
-### 0.6.7
+## 升级日志
+
+### 0.7.0
+
+- **可设置数据存储路径**：看板设置中可检查并迁移数据目录，`dsh-taskboard.json`、`dsh-taskboard-templates.json` 和 `dsh-taskboard-assets/` 始终一起迁移；先完整复制和校验，再切换位置，失败不覆盖原数据。
+- **任务描述与评论支持插入图片（[#25](https://github.com/cloader/dsh-taskboard/issues/25)）**：支持选择、粘贴和拖放 PNG/JPEG/GIF/WebP，自动插入 Markdown，并在详情中显示缩略图与灯箱预览。图片按内容哈希在本地去重保存，台账和 SSE 只记录短链接。
+- **修复模型前缀缓存失效（[#24](https://github.com/cloader/dsh-taskboard/issues/24)）并提高缓存命中率**：协议与 10 个 `taskboard_*` 工具在插件挂载时同步注册，后续工作区/agent 服务就绪或重载不会改变工具定义；依赖尚未就绪时返回 `taskboard_not_ready`。
+- 工具执行等待共享的台账首次加载；工具清理与运行服务生命周期分离。DSH 开发依赖升级到 0.1.5-rc.2 系列。
+
+### 0.6.7
 
 - 内置任务模板及系统评论跟随界面语言显示；JSON 备份导入保留系统评论的本地化信息（[#22](https://github.com/cloader/dsh-taskboard/pull/22)）。
 - 归档卡片时可选择同时归档执行会话，确认前显示会话 ID；默认仅归档卡片，不包含创建会话或认领会话。归档失败会显示逐会话结果，已归档卡片可独立重试；宿主不支持时禁用会话归档选项（[#23](https://github.com/cloader/dsh-taskboard/pull/23)）。