dsh-taskboard 0.6.7 → 0.7.1

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,6 +133,7 @@ agent：
 - 新建/编辑弹窗：项目、模型（含思考强度）、紧急度、执行方式、cron 实时校验与下次运行预览、执行隔离开关、验收清单编辑
 - 详情面板：状态流转（done 仅限人工；清单未全勾时完成需二次确认并显示未勾数）、agent/用户评论流、执行记录（倒序，最新在最上；会话 ID 点击跳转打开该执行会话；已删除/已归档分开提示）、停止执行、Worktree 隔离块（分支 / 提交 / 改动统计 / 合并与清理）、执行报告块、验收清单块
 - 待验收列卡片快捷操作：「✓ 完成」一键验收、「✗ 退回」退回待办并可附退回原因（agent 开工前会读）
+- **图片附件（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 服务的环境自动按浏览器语言降级
@@ -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-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 进程侧，与浏览器无关；错过的时间窗口跳过不补跑。
@@ -232,70 +235,23 @@ node scripts/screenshot.mjs     # 重新生成 img/ 截图（需本机 Edge）
 
 ## 升级日志
 
-### 0.6.7
+### 0.7.1
 
-- 内置任务模板及系统评论跟随界面语言显示；JSON 备份导入保留系统评论的本地化信息（[#22](https://github.com/cloader/dsh-taskboard/pull/22)）。
-- 归档卡片时可选择同时归档执行会话，确认前显示会话 ID；默认仅归档卡片，不包含创建会话或认领会话。归档失败会显示逐会话结果，已归档卡片可独立重试；宿主不支持时禁用会话归档选项（[#23](https://github.com/cloader/dsh-taskboard/pull/23)）。
-- 修正调度器生命周期测试的异步等待条件，避免台账尚未加载时提前断言。
-- 修复模板 Prompt 从第二行开始多出缩进：客户端包装脚本原样保留打包代码，避免给多行字符串插入 Tab。
+**修复：**
 
-### 0.6.6
+- **数据目录迁移成功提示**：迁移完成后在看板设置的存储区显示绿色成功提示（含新路径）；旧数据清理失败以警示样式显示在成功提示下方，不再占用全局错误横幅。
 
-- **修复 DoD 编辑行布局（[#20](https://github.com/cloader/dsh-taskboard/issues/20)）**：checkbox 不再套用整行输入框的宽度、内边距和边框样式，避免文本输入框被挤出。
-- **修复 Windows DSH Desktop 窗口按钮与看板顶栏重叠（[#20 评论](https://github.com/cloader/dsh-taskboard/issues/20#issuecomment-5597498727)）**：根据看板实际位置动态预留顶部空间，兼顾工具条换行和已有独立标题栏的布局；普通 Web 与 macOS 不启用此避让。已通过 Windows 实机验收。
-- **修复 agent 无法取得 DoD 条目 id（[PR #21](https://github.com/cloader/dsh-taskboard/pull/21)）**：`taskboard_get` 的验收清单文本现在逐项输出序号和 `id`，agent 可直接将其作为 `taskboard_checklist check/uncheck` 的 `itemId`，无需猜测；不改变数据模型或账本。
+### 0.7.0
 
-### 0.6.5
+**新特性：**
 
-- **修复：与 dsh-better-sidebar 并存时看板顶栏右侧按钮被其右上角常驻按钮簇遮挡（[#19](https://github.com/cloader/dsh-taskboard/issues/19)）**：看板激活且 better-sidebar 右栏收起时，工具条右侧预留 62px 让出其「展开底部面板 / 展开侧边栏」按钮簇所占的视口右上角（10~70px），作用于全部换行行，任何窗口宽度不再重叠；未装 better-sidebar 或其右栏展开时规则零生效，纯 CSS 修复
+- **可设置数据存储路径**：看板设置中可检查并迁移数据目录，`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 只记录短链接。
+- DSH 开发依赖升级到 0.1.5-rc.2 系列（`@deepseek-ai/cordis` 4.0.2、`@deepseek-ai/schemastery` 3.18.2），实测兼容 DSH 0.1.5-rc.1。
 
-### 0.6.4
+**修复：**
 
-- **修复：界面语言可能被永久定型为英文（[#16](https://github.com/cloader/dsh-taskboard/issues/16)）**：client 激活早于 locale 服务时，一次性回退检测读到服务端渲染的静态 `<html lang="en">` 后不再重试——现在会监听 `<html lang>` 变化即时跟随，并短暂轮询 locale 服务、出现即接管
+- **模型前缀缓存失效（[#24](https://github.com/cloader/dsh-taskboard/issues/24)）**：协议与 10 个 `taskboard_*` 工具在插件挂载时同步注册并提高缓存命中率，后续工作区/agent 服务就绪或重载不会改变工具定义；依赖尚未就绪时返回 `taskboard_not_ready`。工具执行等待共享的台账首次加载；工具清理与运行服务生命周期分离。
 
-### 0.6.3
 
-- **并列多仓库工作空间的 Worktree 镜像模式**：worktree 隔离自动升级为「任务镜像」——有界扫描发现工作区内全部并列 git 仓库（深度 ≤3、上限 8、60s 缓存；submodule / linked worktree 跳过），每仓库各建同名任务分支的 worktree 并按相对路径挂进 `<项目>/.dsh-worktrees/<任务ID>/`；提交证据、diff 查看（`?repo=`）、合并（逐仓库 `--no-ff`，一仓冲突不阻断他仓）与清理（聚合未提交检查、先子后根）全部分仓库进行，未镜像仓库在执行引导中标「禁改」；新增 `branches` / `repos` 附加字段，单仓库行为与旧数据零变化
-- **容器仓库（根仓库以 gitlink 跟踪子仓）完全可用**：嵌套子镜像在根镜像 status 中的结构性噪音（未跟踪目录 / gitlink 漂移 `M 子仓`）已在证据采集、合并 clean 检查与镜像删除预检中豁免——此前真实 git 下已全部提交的镜像仍被清理路由永久拒绝、结算证据出现幻影未提交修改；新增真实 git 端到端集成测试（未跟踪 + gitlink 两形态）锁定
-- **DSH STORE 兼容矩阵扩展至 0.1.2-alpha 线**：0.1.2-alpha.2 / alpha.3 / alpha.4 逐项声明 `compatible`（各版本一次性 Profile 实测：安装 → 挂插件 → 无头启动 → 路由探活 200 → 卸载），解除「最新 3 个官方版本无兼容结论」的暂时下架（[DSH-Store#321](https://github.com/AI-Scarlett/DSH-Store/issues/321)）
-
-### 0.6.2
-
-- **修复 DSH STORE 收录的两个阻断（[DSH-Store#321](https://github.com/AI-Scarlett/DSH-Store/issues/321)）**：client 产物开启压缩（320,851 → 203,793 字节，回到 256 KiB 单文件审核线内）；`package.json` 增补 `dsh.compatibility.dshReleases` 兼容矩阵与 `engines.node >= 22`；新增 client 体积预算测试防无声回退——纯构建与清单整改，无功能变化
-
-### 0.6.1
-
-- **修复：`/` 快捷补全弹层被任务弹窗滚动容器裁剪**：弹层 portal 到 document.body 并 fixed 锚定输入框，不再被表单滚动容器裁剪；上方空间不足自动下翻、贴边收拢，并随滚动/缩放实时跟随
-- **修复：键盘 ↑/↓ 选择补全项时列表不滚动**：高亮项自动滚入视野（含 wrap-around），直调列表 scrollTop 避免连带滚动模态表体
-### 0.6.0
-
-- **任务弹窗左右双栏宽屏布局、输入框 / 快捷补全与执行权限选择： [@jw5555555555](https://github.com/jw5555555555)（[#14](https://github.com/cloader/dsh-taskboard/pull/14)）**
-  - 新建/编辑弹窗升级为左右双栏宽屏布局（左栏核心字段与执行配置、右栏描述与执行 Prompt）
-  - 描述与 Prompt 输入框支持输入 `/` 快捷补全 Slash 命令与 Agent 技能（↑↓ 选择、Enter/Tab 确认、Esc 关闭，宿主动态发现的命令技能与内置清单合并）
-  - 新增任务级「执行权限」三档选择（📁 可写入工作区 / 🔒 仅可查看 / ⚡ 完全权限），看板设置同步新增默认执行权限，卡片与详情页显示权限徽章
-  - 描述与 Prompt 中的 Markdown 图片渲染为可点击缩略图并支持灯箱放大
-  - 修复模型列表发现（运行时缺失时回落宿主 API）
-  - 会话自动同步过滤子代理会话，避免子会话误建卡
-- **界面中英双语，跟随 DSH 语言设置**
-  - 看板全部界面文案（列头 / 卡片 / 详情 / 表单 / 模板 / 导入导出 / 设置 / 诊断 / 侧边栏入口）接入 DSH locale 服务，「设置 → 通用设置 → 语言」切换 zh/en 即时生效（无需刷新）
-  - 语言偏好由 DSH 统一存储（settings.yaml 的 locale.preference），插件自身不新增任何配置
-  - 无 locale 服务的部署按浏览器语言自动降级（中文环境 zh，其余 en）
-  - 新增 src/client/i18n/（zh/en 双语字典 + 轻量适配器 + useT hook），labels 枚举文案改为键映射
-  - 字典键集中英强制一致（编译期类型 + 单测 + 源码扫描三重校验）
-  - 顺带修正 PLUGIN_VERSION 与 package.json 的版本漂移（0.5.4 → 0.5.5）
-
-### 0.5.5
-
-- **外部工作区会话自动同步看板： [@jw5555555555](https://github.com/jw5555555555)（[#13](https://github.com/cloader/dsh-taskboard/pull/13)）**：看板「设置」新增「自动同步工作区会话」开关（出厂默认关闭）——开启后，工作区直接新建的会话自动在看板生成任务卡片：按会话工作目录（cwd）映射到对应项目，取首条用户消息与会话标题作为任务的描述与标题；运行中自动进入「进行中」并绑定会话 ID（卡片可一键跳转），执行成功自动流转「待验收」并生成系统评论，异常退回「待办」；自动过滤看板自身创建的内部执行会话防止重复建卡；多轮续跑延续同一张卡片
-
-### 0.5.4
-
-
-- **看板卡片与任务详情一键跳转执行会话： [@jw5555555555](https://github.com/jw5555555555)（[#11](https://github.com/cloader/dsh-taskboard/pull/11)）**：卡片元数据行新增「🤖 会话ID ↗」按钮、详情页顶部新增「🤖 跳转会话 ↗」按钮、持有者 Chip 可点击——进行中优先、其次最近一次执行对应的会话一键直达（看板自动收起）；已归档 / 已删除 / 会话服务不可用分别给出明确提示
-- **新建任务记住上次选用的模型，支持设置思考强度： [@jw5555555555](https://github.com/jw5555555555)（[#11](https://github.com/cloader/dsh-taskboard/pull/11)）**：create 模式自动带出上次的模型与思考强度（模板预填与编辑不受影响）；模型可固定思考强度（reasoningEffort，如 low/medium/high），随执行会话下发；支持思考强度的模型从 DSH 模型目录读取可用档位
-- **列内排序新增「按标题」： [@Amoss-1](https://github.com/Amoss-1)（[#4](https://github.com/cloader/dsh-taskboard/pull/4)）**：数字感知比较，数字前缀按真实数值排序（`01 < 02 < 10 < 90`，字符串比较会把 `10` 排到 `02` 前）；排序选择随视图状态持久化
-- 界面细节：下拉 / 输入框适配明暗主题（DSH 主题变量 + color-scheme）；模板管理弹窗布局优化
-
-> 📜 更早版本的完整更新日志见 [changelog.md](changelog.md)。
-
-License: Apache-2.0
+> 📜 更早版本的完整更新历史见 [changelog.md](changelog.md)。