dsh-conversation-overview 1.1.0 → 1.3.0

package/README.md

@@ -8,22 +8,12 @@ DeepSeek Harness（DSH）插件：在对话/轨迹旁增加「概览」标签页
 
 ## 功能特性
 
-
-- **进展**
-  - 目标（goal）与阶段徽标；任务计划（todos）进度条与逐条状态；
-  - 无任务计划的轮次显示「本轮关键步骤」：最近 6 次工具调用，时间正序（旧上新下），新步骤底部渐入、旧步骤顶部浅出，可一键展开本轮全部步骤；
-  - 等待人为确认（权限审批/提问/计划确认）的步骤以琥珀色确认风格高亮；
-  - 团队会话显示各成员阶段（创建中/运行中/空闲/失败/阻塞），可展开团队详情；
-  - 点击步骤行复制其完整目标文本（命令/文件路径/查询等），悬停查看全文；
-  - 双击 todo 行把「重新执行指定步骤」的提示词填入聊天输入框（不自动发送），提示词模板可自定义（支持 `{index}`、`{content}` 占位符）。
-- **产物**：产出/交付文件列表、按轮次分组的变更审阅入口、Finder/系统定位。
-- **引用**：上下文注入、OpenViking 记忆（`viking://`）、技能目录、文件与会话引用；
-  - 类型多选下拉筛选（选中类型以 chips 显示）、「过滤常见」隐藏每轮都出现的注入、排序（最新/类型/次数，可点击取消）；
-  - `viking://` 记忆在右侧边栏新标签页内预览（frontmatter 结构化 + Markdown 渲染 + 预览/源码切换，经 OpenViking HTTP API）；
-  - 运行时上下文注入可点击打开快照预览标签页；文件路径点击定位。
-- **范围选择器**：最新一轮 / 第 N 轮 / 全部轮次；轮次统计胶囊（用时、工具调用、命令、修改文件、失败数），可整体开关，时间支持「时间点 / 本轮计时」两种显示。
-- **快速导航联动**：可强制显示内置轮次导航轨（含窄容器下），轨道刻度带轮次号提示，点击刻度联动概览切换到对应轮次。
-- **设置页**：DSH 设置中的独立分区 + 插件行内配置，全部选项即时生效；内置「问题反馈」入口直达 GitHub Issues。
+- **进展**：目标与任务计划进度；本轮关键步骤（可展开全部、等待确认高亮、里程碑可置顶）；团队成员状态；双击待办生成重跑提示词。
+- **产物**：生成/交付文件列表、按轮次的变更审阅入口、系统定位与「打开方式」。
+- **引用**：上下文注入、OpenViking 记忆（侧边栏内预览）、技能、文件与会话引用；类型筛选、隐藏常见项、多种排序。
+- **统计与时间轴**：轮次统计胶囊（用时/调用/命令/改动文件/失败，失败可点击查看详情）；打开时间轴拖到任意时间点，回看当时的进展、产物与引用。
+- **轮次导航**：范围选择器（最新 / 第 N 轮 / 全部），与内置轮次导航轨双向联动。
+- **设置**：DSH 设置独立分区 + 插件行内配置，选项即时生效；问题反馈入口与新版本徽标。
 
 ## 安装
 
@@ -37,10 +27,32 @@ dsh-conversation-overview
 
 方式二：GUI「插件管理」中选择安装 bundle，输入上面的 npm 包名（或 `dsh-conversation-overview@latest`）。
 
+方式三：已全局安装 DSH（终端可用 `dsh` 命令）时，用 CLI 安装进指定 profile（`web` 为 profile 名，按需替换；该命令等价于在 profile 目录执行 pnpm）：
+
+```bash
+dsh plugin --profile web add dsh-conversation-overview
+```
+
+CLI 安装后重启 `dsh` 生效（方式一/二安装后刷新浏览器页面即可）。
+
 安装后在「设置 → 会话概览」或插件行内配置中调整选项；对话页刷新即可看到「概览」标签页与右侧边栏入口。
 
 > 注意：若此前安装过开发版 `@local/dsh-conversation-overview`，请先移除它再安装本包——两者使用相同的插件行 id（`conversation-overview`）与插槽 key，不应同时启用。
 
+**插件更新**：
+
+- CLI（已全局安装 DSH）：
+
+  ```bash
+  dsh plugin --profile web update dsh-conversation-overview
+  # 或指定最新版重装：dsh plugin --profile web add dsh-conversation-overview@latest
+  # 卸载：dsh plugin --profile web remove dsh-conversation-overview
+  ```
+
+  更新后重启 `dsh` 生效。
+
+- GUI / 会话内：在 DSH 会话中让 Agent 依次执行插件管理器的 `remove_bundle`（target: `dsh-conversation-overview`）→ `install_bundle`（target: `dsh-conversation-overview@latest`），或在 GUI「插件管理」中移除后重新安装最新版。更新后刷新浏览器页面；若新版本增加了配置字段或宿主端代码有改动，需重启一次 DSH。
+
 ## 配置项
 
 | 字段 | 默认 | 说明 |
@@ -50,6 +62,7 @@ dsh-conversation-overview
 | `showReferences` | `true` | 显示「引用」分区 |
 | `showStats` | `true` | 显示轮次统计胶囊（用时、工具调用等） |
 | `timeMode` | `clock` | 时间显示：`clock` 时间点 / `elapsed` 本轮计时（从 0s 起） |
+| `stepAnchors` | `false` | 里程碑步骤置顶：上下文压缩/用户审批/失败调用固定在关键步骤顶部 |
 | `placement` | `both` | 显示位置：`conversation` 对话页 / `sidebar` 侧边栏 / `both` |
 | `sectionFullHeight` | `false` | 分区完整展示（关闭时限高 320px、内部滚动） |
 | `todoPrompt` | `true` | 双击待办行生成重执行提示词并填入输入框 |