Kicad Studio Kit

KiCad Studio Kit 是 VS Code 扩展仓库。MCP 服务单独开发和发布。本仓库仅负责扩展侧的 MCP 发现、配置、兼容性元数据和用户体验——详见 ADR 0009 和 仓库结构。

当外部工具保存底层设计文件时，KiCad Studio 的 PCB 和原理图预览可以自动刷新，无需依赖 MCP。 实时查看器刷新介绍了事件驱动行为、资源限制、未保存编辑的防护措施以及相关限制。

覆盖率徽章报告的是已配置的 Jest 单元测试分母，而非所有随产品发布的源文件。排除项的归属以及单独的关键模块阈值递增机制，详见测试策略。

本仓库包含：

• KiCad Studio VS Code 扩展（apps/vscode-extension）——此处唯一发布的产品；
• 私有共享测试基础设施（packages/test-harness、packages/kicad-fixtures）；
• 扩展侧 MCP 集成契约和兼容性元数据。 KiCad MCP Pro 服务（kicad-mcp-pro）的 Python 源码、npm 启动器、 容器镜像和 MCP Registry 条目位于 KiCad MCP Pro。

仓库成熟度与标准

**历史上的 OpenSSF Best Practices Silver（MIT 许可时期）：**为便于追溯， Silver 证据予以保留， 但不代表当前的 FLOSS 徽章。许可变更后， 项目编写的源代码采用 PolyForm Noncommercial 1.0.0，该许可证并非经 OSI 批准的开源 许可证。安全、发布、来源证明和治理检查仍会继续运行，不受历史徽章状态影响。

版本基线

本仓库的本地发布内容包括：

• VS Code 扩展：oaslananka.kicadstudiokit（2.1.1）

Python 软件包 kicad-mcp-pro、容器镜像和 MCP Registry 条目 通过 KiCad MCP Pro 发布。

KiCad 兼容性

KiCad Studio Kit 将 KiCad 10.0.x 作为主要测试版本，KiCad 9.x 在上游 EOL 后作为弃用的尽力兼容版本保留，并将 KiCad 8.x 作为弃用的文件级兼容版本保留。规范兼容性矩阵、已测试的补丁版本、CI 覆盖级别和功能门控维护在 docs/support-matrix.md 和 compatibility.yaml 中。

本地验证

corepack enable
corepack pnpm run dev:doctor
corepack pnpm install --frozen-lockfile
corepack pnpm --dir apps/vscode-extension exec playwright install chromium
corepack pnpm run check:forbidden-refs
corepack pnpm run check:version
corepack pnpm --filter kicadstudiokit run check
corepack pnpm --filter kicadstudiokit run package

仓库根目录提供了按产品划分的入口：

corepack pnpm run check:kicad-studio

corepack pnpm --dir packages/test-harness run check
corepack pnpm run check:protocol-schemas
corepack pnpm run check:compatibility-contract
corepack pnpm run check:dev-doctor

Python/MCP 服务检查在 KiCad MCP Pro 仓库中运行。

如需可复现的 VS Code Dev Containers 或 GitHub Codespaces 环境，请使用 仓库内的 devcontainer 配置。该容器会设置 Node、pnpm、Python、uv、Playwright、shellcheck、actionlint、GitHub CLI， 并尽力提供 KiCad CLI 支持，以用于根目录检查和 MCP 测试。如需在没有容器守护进程的 VPS 上以最小权限运行，请使用仓库内的 无根验证主机配置。

安装

从 Visual Studio Marketplace 或 Open VSX 安装扩展，也可以在本地构建：

corepack enable
corepack pnpm install --frozen-lockfile
corepack pnpm run package:kicad-studio

使用方法

打开包含 KiCad 项目的工作区，然后使用 KiCad Studio 活动栏视图和命令。有关引导式工作流，请参阅 docs/getting-started.md； 有关命令目录，请参阅 docs/extension/commands.md。

架构

• 可搜索的文档站点
• 仓库结构
• 产品边界
• 发布模式
• 测试策略
• 开发容器
• 无根验证主机
• KiCad 样例文件库
• 集成模式
• Agent 入门指南
• MCP 客户端配置示例
• VS Code MCP 工作区示例

示例

• 示例概览
• LED Basic KiCad 示例
• MCP Workflow Demo

发布

发布由 .github/workflows 下的 GitHub Actions 工作流处理。有关环境、市场密钥和受信任发布者的外部设置，请参阅 docs/publishing.md。 有关稳定 1.x 版本线的结构化预览（beta）计划和测试者反馈流程，请参阅 docs/beta-program.md。

维护

依赖更新政策、仪表板分流和安全更新处理方式记录在 docs/dependency-lifecycle.md 中。 兼容性支持状态和发布门槛记录在 docs/support-matrix.md 中。 权威仓库和项目组合工作流状态记录在 CANONICAL.md、.repo-health.yaml 和 docs/reusable-workflows.md 中。 遥测和错误报告为可选功能，默认禁用，相关说明见 docs/telemetry.md。

贡献

请阅读 CONTRIBUTING.md，并在提交拉取请求前运行 corepack pnpm run check。

许可证

当前由 KiCad Studio Kit 项目编写的源代码依据 PolyForm Noncommercial License 1.0.0 提供。商业用途需要另行取得书面许可；详情请参阅 LICENSING.md 和 COMMERCIAL-LICENSING.md。此前已依据 MIT 发布的早期修订版本，仍可按照发布时适用的 MIT 条款使用。