Harbor Test Workbench for VS Code

Harbor Test Workbench 直接展示并编辑 Harbor V3 本地作者文件。CLI 与扩展共享同一套文件契约，扩展不维护第二份资源模型。

V3 工作台

Resources 按 Workspace、Project、Suite 展示 Case、Flow、Script、Document 等资源；选择资源后可用 VS Code 原生编辑器打开其 TypeScript、Markdown 或 JSON 作者文件。
Changes 展示本地新增、修改、已同步和冲突状态，并提供基于远端更新时间锚点的 Pull、Push 与冲突处理。
Inspector 展示当前资源的 local ref、类型、归属、文件入口和同步状态。
Workspace、Project、Suite 与 Case 可在原生树或 Inspector 创建合法下级资源；Case/Suite 可在 Project/Suite 间移动，Flow/Script Library 可切换所属 Project。
Project、Suite 与 Case 可选择同一作用域内的 Flow、Script Library 或 Lifecycle 添加 Binding，也可只移除当前资源直接声明的 Binding；继承结果继续由“查看继承与引用”读取。
Case 的阶段保存在 Case 自身目录；Flow、Script 和 Document 保持独立资源目录，通过稳定 local ref 引用。
Configuration 在同一 Workspace 下分组展示普通参数定义、参数对象和继承层；树只显示 key、字段路径和作用域等安全摘要，点击后才打开对应作者 JSON，不在面板传递普通值或 Secret ID。
本地草稿与已同步资源使用相同目录和内容结构。线上身份、最后拉取时间及个人 deployment 映射只保存在本机状态，不污染作者文件。
文件变化由 harbor local watch 增量投影到面板；所有写操作仍通过 Harbor CLI 执行，扩展不直接调用 Harbor HTTP API。

运行与冲突

Case 节点支持预览和本地运行。需要配置或共享资源时，扩展先展示运行预览，再把审批指纹交回 CLI；证据固定写入 .harbor-state/v3/runs，不会随作者文件推送。

Suite 节点的行内按钮、右键菜单和 Inspector 均提供“顺序运行测试集”。点击后按 Resources 树顺序逐条运行，包含嵌套测试集，跳过已归档用例及归档子树；同级顺序由 sortOrder、目录名自然排序决定。单条失败后继续，进度中显示当前用例，结束后汇总通过、失败、预检阻断和未运行数量。点击取消会等当前用例完成后停止后续运行。需额外批准的绑定资源在批次开始前统一确认一次。

每条 Case 与最新本地 Run 关联，悬停用例可见 Run ID、状态与失败摘要。用例右键或 Inspector 的“查看最新运行结果”可查看错误、失败阶段、原始结果及截图/日志；“打开最新 Trace”会在本机浏览器打开随扩展分发的 Playwright Trace Viewer。Resources 标题的历史图标用于汇总查看各用例的最新结果。扩展重载后会从磁盘恢复关联，Debug 结果同样可见。

本地每条用例只保留最新一次完整运行（成功和失败共用同一个保留名额）。新运行结束、结果复验且 Worker 回收后，CLI 清理同用例旧 Run 的 Trace、截图和日志；运行中、损坏或身份不明的记录不会自动删除。已有历史记录在该用例下次完整运行后收敛，查看动作不删除文件。单用例失败通知可直接进入结果或 Trace，测试集完成通知可查看该集各用例的最新结果。浏览器启动前失败等情况可能没有 Trace，此时仍可查看错误与阶段信息。

下载、Pull 和 Push 统一调用 Harbor CLI。目录预览和正式下载共享当前目录的正文缓存，服务端支持增量协议时只传输变化正文；完成通知显示下载和复用数量。服务端回退全量时会明确提示。纯删除和上次上传的待收尾记录也会进入推送确认，真正没有变化时不执行 Push。

CLI 在 .harbor-state/v3/conflicts/<operation-id> 保存 OURS、THEIRS、BASE。工作台调用 CLI 的三方差异分析，使用 VS Code 原生 Diff 查看双方，在真实作者文件中合并，再点击“确认冲突已解决”。多个文件可逐个选择；删除冲突须选择保留本地或接受远端。原始冲突证据保留，不再寻找 merged 临时目录。

上次上传未完成且作者内容变化时，工作台提供“重新预览”，随后展示新计划供确认，再由 CLI 按新指纹恢复上传。同步前可以保存当前作者目录的未保存文件；取消保存会停止操作。重复点击同步按钮不会并发提交。

以上能力需要配置到包含原生增量同步与恢复功能的 Harbor CLI；更新扩展不会自动更新 CLI 或服务端。

本地 Worker 无论脚本、Flow、Provider、序列化或子进程在哪一阶段失败，都应生成结构化 result.json；异常退出还会保留受限诊断和最后一个 Stage/Flow 上下文，避免把真实失败统一折叠成无效结果。

本机设置

{
  "harbor.cli.path": "",
  "harbor.cli.deploymentPaths": {
    "harbor-local": "/absolute/path/to/q-harbor/apps/cli/dist/main.js",
    "q-harbor": ""
  },
  "harbor.node.path": "",
  "harbor.v3.deployment": "q-harbor",
  "harbor.v3.workspaceId": "remote-workspace-id"
}

harbor.cli.path 留空时使用 PATH 中的 harbor。harbor.cli.deploymentPaths 可按 deployment 覆盖 CLI 路径，空值继承默认路径。harbor.v3.deployment 与 harbor.v3.workspaceId 属于个人机器设置，不写入共享 V3 文件。

扩展只读取 .harbor/v3。V1/V2 目录会被忽略，也不提供历史迁移入口。

开发验证

执行 Node/pnpm 命令前先切换到仓库 .nvmrc 指定版本：

source ~/.nvm/nvm.sh && nvm use
pnpm --filter harbor-test-workbench typecheck
pnpm --filter harbor-test-workbench build
pnpm --filter harbor-test-workbench package:vsix

发布流程仍从仓库根目录执行 pnpm vscode:publish:verify 或 pnpm vscode:publish；发布脚本负责版本、Marketplace 上传、提交、标签和推送的一致性检查。

发布预检可单独运行 pnpm vscode:publish:verify。根入口通过普通 Node 启动器传递 .env.vscode-marketplace，避免 --env-file 与 --run 组合丢失凭据变量；缺失 PAT 时会明确报错。预检最多等待 30 秒，网络超时不会被判断为 PAT 失效，也不会递增版本或上传。预检通过后再运行 pnpm vscode:publish。

Harbor Test Workbench

qysharbor

Harbor Test Workbench for VS Code

V3 工作台

运行与冲突

本机设置

开发验证