dsh-sdd-progress-xc

使用 DSH CLI

dsh plugin --profile web add dsh-sdd-progress-xc

或使用 npm

npm install dsh-sdd-progress-xc

安装后重启 DSH，右侧边栏将出现「SDD Progress」tab。

## ⚙️ 配置

| 选项 | 默认值 | 说明 |
|------|--------|------|
| requirementsRoot | ''（空） | 可选：当会话内容只有相对路径时，作为根目录兜底。通常无需设置 |

**为什么默认不需要配置？**  
插件从会话内容直接提取完整路径（如 `D:/workspace/requirements/aiAssistant/sdd/progress.md`），不依赖固定根目录。只要会话中引用过该路径，就能自动定位。

## 🎮 使用

### 查看任务进度
1. 打开右侧边栏
2. 点击「SDD Progress」tab
3. 默认显示「Tasks」tab：统计 + 任务列表
4. 点击「Progress Ledger」tab 查看台账

### 刷新数据
- **自动**：5 秒轮询，无需操作
- **手动**：点击页头右侧「↻ Refresh」按钮

### 切换会话
- 切换到其他会话时，SDD Progress 自动加载该会话的进度
- 每个会话独立，互不干扰

## 🔒 安全设计

- **Markdown 渲染**：使用官方 `MarkdownText`，禁用 raw HTML / 相对链接 / 危险协议
- **路径提取**：仅从会话内容提取路径，不扫描文件系统
- **zstd 解码**：逐帧解码，跳过损坏帧，不崩溃
- **会话隔离**：每个会话独立，不跨会话污染

## 📄 许可证

[MIT](https://github.com/xchannel1987/dsh-sdd-progress-xc/blob/d283264ff4ea78f918816fe37df7bd2a3a71611d/LICENSE)

## 🔗 链接

- [GitHub](https://github.com/xchannel1987/dsh-sdd-progress-xc)
- [npm](https://www.npmjs.com/package/dsh-sdd-progress-xc)
- [问题反馈](https://github.com/xchannel1987/dsh-sdd-progress-xc/issues)
- [DSH 官方仓库](https://github.com/deepseek-ai/DeepSeek-Harness)

## ⚙️ 配置

| 选项 | 默认值 | 说明 |
|------|--------|------|
| requirementsRoot | ''（空） | 可选：当会话内容只有相对路径时，作为根目录兜底。通常无需设置 |

**为什么默认不需要配置？**  
插件从会话内容直接提取完整路径（如 `D:/workspace/requirements/aiAssistant/sdd/progress.md`），不依赖固定根目录。只要会话中引用过该路径，就能自动定位。

## 🎮 使用

### 查看任务进度
1. 打开右侧边栏
2. 点击「SDD Progress」tab
3. 默认显示「Tasks」tab：统计 + 任务列表
4. 点击「Progress Ledger」tab 查看台账

### 刷新数据
- **自动**：5 秒轮询，无需操作
- **手动**：点击页头右侧「↻ Refresh」按钮

### 切换会话
- 切换到其他会话时，SDD Progress 自动加载该会话的进度
- 每个会话独立，互不干扰