dsh-qa

dsh plugin --profile web add dsh-qa

<div align="right"><strong>🇨🇳 中文</strong> | <strong><a href="./README_EN.md">🇬🇧 English</a></strong></div>

dsh-qa · 质量工作台


![Version]()

![Zero Dependencies]()

![DSH Plugin]()



dsh-qa 是 DeepSeek Harness 的本地 QA 工作台：在一个项目空间中管理需求、测试用例、风险、执行、证据和交付决策。项目与迭代的对话复用 DSH 原生会话，并自动使用「测试模式」（preset id: qa）；业务数据保留在本机，运行时没有生产依赖。

当前发布版本是 v0.7.3；本版新增宿主内全屏工作台回退：当桌面端拦截独立弹窗时，工作台会以内嵌浮层打开，可按 Esc 或点击关闭按钮退出。另提供中英文使用指南，覆盖从安装到进阶使用。安装 dsh-qa 主 bundle 会同时提供 qa 与 quality-control 两个 preset，无需再执行单独的 preset 安装命令。任意外部提供方的真实执行仍需按具体 provider 单独验收。

兼容性验收：已在 DeepSeek Harness v0.2.0-rc.2 官方 macOS 客户端上验证插件加载、qa 测试模式和已有项目历史 DSH 对话展示通过；同版本带认证宿主 URL 的 qa Host Smoke 已完成 6 passed。该结果覆盖 qa bundle，不替代 quality-control 独立 bundle 的单独验证。

测试首页 → DSH 测试对话 → 项目看板 → 日历排期

<img width="5090" height="2476" alt="image" src="https://github.com/user-attachments/assets/287ac2d2-aec0-4f7a-b3a6-72c183b871ba" />

目录

• [功能定位与使用方式](#功能定位与使用方式)
• [中文使用指南](./docs/quality-workbench/user-guide-zh-CN.md)
• [English User Guide](./docs/quality-workbench/user-guide-en.md)
• [功能特性](#功能特性)
• [安装（DSH 插件）](#安装dsh-插件)
• [npm 安装与更新（独立运行）](#npm-安装与更新独立运行)
• [快速开始（不装插件体验）](#快速开始不装插件体验)
• [质量工作流](#研发质量控制工作台0205-质量域)
• [独立运行模式](#独立运行模式)
• [架构](#架构)
• [AI 工具集](#ai-工具集)
• [配套 QA 技能库](#配套-qa-技能库)
• [开发与贡献](#开发与贡献)
• [路线图文档](#路线图文档)
• [许可证](#许可证)
• [常见问题](#常见问题)

功能定位与使用方式

dsh-qa 是运行在本机 DeepSeek Harness（DSH）中的 QA 工作台插件。DSH 提供对话、模型、技能和命令；dsh-qa 提供测试项目、需求、用例、缺陷、质量任务、执行证据和报告等 QA 管理能力。使用插件不需要先创建一个供团队共享的 Git 仓库；本仓库是插件的发布与安装来源。

建议按下面的流程开始：

1. 按「安装（DSH 插件）」安装插件并重启 DSH，然后从侧边栏打开「质量工作台」。

2. 新建测试项目或迭代。按需创建的项目工作目录位于本机；首次进入项目时，工作台会绑定一个使用 qa 测试模式的 DSH 会话。

3. 在项目会话中提供需求、验收标准和可访问的文档或代码上下文，让 DSH 协助分析、编写或更新需求、用例、风险和缺陷；也可以直接在工作台维护这些记录。

4. 对代码或版本验收，可在项目中创建质量任务，补充验收标准和测试范围，维护测试计划与执行配置，再运行测试、归档证据并查看质量门禁。缺陷复测和报告可继续记录在同一项目中，发布或关闭前由负责人审核。

数据与协作边界：插件模式下，项目记录和本地材料保存在运行 DSH 的机器上（~/.dsh/dsh-qa/）；DSH 对话由 DSH 自己保存。看板的实时更新用于同一本机工作台的多个窗口，不会把项目数据同步给其他团队成员。Git 不是 dsh-qa 的协作或通知通道：质量任务可以从项目工作目录中采集受支持的本地 Git diff 快照，但不会监听远端仓库变化、自动拉取代码或同步项目记录。工作台目前也没有 WPS 或禅道连接器；需要在这些系统间传递的材料仍需手工处理。

功能特性

测试项目管理

• 项目与迭代双形态：顶层对象可选「测试项目」或「迭代」（迭代可挂靠父项目），两者均绑定独立 DSH 会话，筛选栏可分别查看
• 测试首页与日历排期：在办项目、临期/逾期里程碑、待审批门禁、未关闭缺陷、最近动态同屏呈现；日历支持年/月/日跳转、点击日期新增、按项目登记里程碑或日程并直接删除
• 实时看板：六列流水线（需求分析 → 用例设计 → 用例评审 → 执行中 → 缺陷回归 → 已发布），拖拽换列，SSE 实时推送，多窗口同步
• 项目档案工作区：宽屏项目详情集中编辑名称、编号、产品、负责人、摘要和阶段；概览、质量任务、需求、用例、缺陷、里程碑、报告、知识、纪要和门禁 10 个分区，并展示进度、AI 策略、成员、文件目录与阶段时间线
• 本地项目目录：创建项目时可自动生成 01_需求与范围 / 02_测试计划 / 03_测试用例 / 04_测试数据与脚本 / 05_测试执行 / 06_缺陷 / 07_测试报告 / 08_发布与归档 八级工作目录；删除项目记录不会删除文件夹
• 门禁治理：需求评审/策略评审/用例评审/报告评审/发布/结项由 AI 提交申请，测试负责人人工审批（对齐 AI 研发质量分析 8 阶段工作流）

研发质量控制工作台（0.2–0.5 质量域，已进入 v0.4.0 基线）

• 质量任务与来源快照：围绕单个测试目标创建质量任务，服务端采集并校验需求、工作区文件或允许的 Git 修订来源；记录摘要、指纹、验收标准、风险、测试范围和分析决策，避免把客户端提交的路径或内容当作可信输入
• 测试计划与受控执行：质量任务下维护可评审的测试计划和不可变执行配置版本；只允许基于当前已评审计划、当前配置版本和来源摘要生成预览令牌，再启动最小化环境中的本地受控测试运行
• Native QA Execution 与 Action Desk：Host 执行经过预览、确认、启动、取消、重试和证据归档；首页行动台按 canonical Action Queue 汇总需要处理的执行状态，不把运行中状态误报为待处理结果
• 证据、分析与回归：终态运行可归档为带完整性校验的证据包；支持失败分析、人工确认后升级缺陷、同计划运行前后对比，以及可追溯、可排除的确定性回归集
• 计算型质量门禁：依据执行来源、已验证证据、关键测试结果和风险状态计算 PASS / WARN / BLOCK；可查看交付报告与趋势，仅允许对合格的警告项创建带责任人、原因和过期时间的受控例外
• 项目详情直达：首页在办项目和项目看板卡片主体可直接进入完整项目详情；首页最多展示 5 个在办项目，全部项目仍可在项目看板查看

质量交付流程参考

流程图描述的是质量控制边界：未形成终态运行或未验证证据时，先进入故障分析与回归并重新执行；门禁 PASS 才进入交付，WARN / BLOCK 需要评审。例外只能作用于可豁免的 WARN 检查项，不能把 BLOCK 变为通过。

AI 协作能力

• 可控 AI 模式：每项目可选全流程辅助、按需协作，或完全关闭自动辅助；自动提取与首页提醒也可分别关闭
• AI 材料上板：AI 从对话自动登记需求（可关联用例与验证目的）、测试用例（含优先级、需求追踪 trace、风险标签与三态）、缺陷（严重级别基于业务影响，含复现频率与影响范围）、里程碑（自动算截止日，逾期/临期徽章）、日程、测试知识、会话纪要、测试报告（版本链），并支持登记 Playwright/Pytest 等自动化结果；每次登记实时出现在看板卡片与材料流
• DSH 技能与命令：每项目独立绑定 DSH 会话；“技能与命令”面板支持分类、搜索和点击插入，输入 / 出现即时建议，执行结果直接回显在工作台
• QA Skill 安装页面：左侧 QA Skill安装 Tab 按「测试类型 / 测试工作流程 / 加强版」展示 Skill；测试类型继续按「需求与策略、用例与评审、功能与兼容、接口与自动化、质量保障专项、缺陷、报告与审查」分组，支持中英文切换、搜索、官网详情和一键安装到 DSH
• DSH 单一对话与模型切换：只使用本项目 DSH 测试模式会话，模型切换器动态读取 DSH 原生模型目录，不存在插件内第二套模型

界面与连接

• 中英文语言切换：在设置弹窗中切换，默认中文，选择在本机浏览器中持久保存；导航、首页、看板、列表、日历、雷达与抽屉/模态框标题均双语化
• 设置与版本信息：设置弹窗展示当前/最新版本、兼容 DSH 版本、GitHub 仓库和项目官网；品牌区域的版本号可打开双语、分页的版本迭代记录；外观支持明亮、暗黑和跟随系统，预设区显示随主 bundle 安装的 qa 与 quality-control
• 可调工作区：主导航、项目栏与项目雷达均可拖动边缘改变宽度，可分别收起；双击边缘恢复默认，布局预设不再放在设置弹窗中
• 逾期里程碑红标、7 日内临期黄标、待批门禁紫标，顶栏实时统计

安装（DSH 插件）

请使用启动 DSH 的同一种方式管理插件：dsh web 是 dsh --profile web 的别名，下面两组命令都操作同一个 web profile。

方式一：通过 npx 启动 DSH

# 安装 dsh-qa 插件
npx --yes @deepseek-ai/dsh plugin --profile web add dsh-qa

# 更新 dsh-qa 插件
npx --yes @deepseek-ai/dsh plugin --profile web update dsh-qa

# 安装或更新后启动/重启 Web UI
npx --yes @deepseek-ai/dsh web

方式二：从 DeepSeek Harness 源码仓库启动

在已完成 pnpm install 和 pnpm run build 的 Harness 仓库根目录运行：

# 安装 dsh-qa 插件
pnpm dsh plugin --profile web add dsh-qa

# 更新到 npm 的 latest 版本
pnpm dsh plugin --profile web update dsh-qa

# 安装或更新后启动/重启 Web UI
pnpm dsh web

如需固定到 GitHub 或本地开发副本，可在两种方式的 add dsh-qa 中分别替换为 add github:naodeng/dsh-qa 或 add link:/path/to/dsh-qa。安装或更新后重启 Web UI（插件在宿主启动时加载）。GUI 侧边栏会出现「质量工作台」入口；点击可在会话区打开，工具栏可在独立标签页打开。

官方 macOS 客户端

官方 macOS DSH 客户端独占 desktop profile，不能使用 `ds

…(truncated)