SuperAPI AI 工具集

vscode-extension

测试与质量

查看项目

更新于 10-16 00:31

技能介绍

用途:本技能面向 Aspire VS Code 扩展的开发、调试、测试与审查,代码全部位于 extension/ 目录,是用 yarn(由 package.json 的 packageManager 固定)和 webpack 构建的 TypeScript 扩展,通过 RPC 与 Aspire CLI 通信。

主要能力与结构:extension/src/extension.ts 为激活入口;commands/ 放命令实现;views/ 放树视图、欢迎视图与面板 UI;debugger/ 含调试适配器及 dotnet、node、python、go 各语言调试器;server/、mcp/、dcp/ 分别负责 RPC 服务、MCP 提供者与 DCP 集成;loc/strings.ts 与 package.nls.json 管理本地化字符串;test/ 放 Mocha 单元测试。

使用方式:仅在扩展或 CLI 上工作时不要运行仓库根目录的 ./build.sh。先检查 SDK:./.dotnet/dotnet --version(Linux/macOS)或 ..dotnet\dotnet.exe --version(Windows)成功则把 .dotnet 加入 PATH 并跳过根 restore;否则若 dotnet --version 成功则直接使用;都不行才运行 ./restore.sh 或 .\restore.cmd。之后在 extension/ 下运行 ./build.sh 或 ./build.ps1,它会构建 Aspire CLI 与扩展并安装依赖。扩展命令用 yarn(corepack yarn ...),不要用 npm/npx。构建命令:yarn run compile、yarn run watch、yarn run package。测试:yarn run compile-tests、yarn run test、yarn run lint,pretest 会先跑 compile-tests、compile 和 lint。本地调试可在 VS Code 打开 extension/ 文件夹,使用 Run Extension 或 Run Extension (cli stop on entry) 启动开发宿主,并通过 Aspire Cli Executable Path 指向本地构建的 CLI。

限制与注意:扩展与 CLI 紧耦合,改动扩展行为常需同步改 src/Aspire.Cli/ 并重新构建;必须保持向后兼容,运行时通过包装 aspire config info 的能力检测判断 CLI 支持情况,机器可读输出应传 --nologo 并为旧 CLI 提供回退。所有用户可见字符串必须本地化,不要手改生成的 l10n 产物。不要随意修改 package.json、yarn.lock;yarn.lock 必须走内部 dotnet-public-npm 源。用户可见改动建议补充 E2E 覆盖并在 PR 中提供前后对比证据。其余细节资料未提供。