内容
# K1 硬件
基于代理的 KiCad 和 PCB 自动化，用于 K1-Lightwave 硬件。
本仓库包含用于 K1-Lightwave 硬件工作流程的公开工具、MCP 服务器、参考资料和原型自动化。产品 PCB 文件、制造输出、BOM 和私有设计文档不会在此仓库的公开 HEAD 中发布。
> [!NOTE]
> 此公开区域正在清理，以便转移到 SpectraSynq 组织。一些旧的原型工具被保留以供参考，但在它们被提取到专用工具仓库之前，不应将其视为稳定的软件包 API。
## 快速入门
```bash
git clone https://github.com/synqing/K1.hardware.git
cd K1.hardware
python3 mcp/verify-servers.py
python3 mcp/test_rag.py
```
对于 Claude Code MCP 设置，请运行：
```bash
python3 mcp/configure_claude.py
```
某些集成需要您自己的 API 凭证。请参阅 [SETUP_CREDENTIALS.md](docs/internal/legacy-root/SETUP_CREDENTIALS.md) 以获取提供商设置说明。
## 内容
- **MCP 服务器**，位于 [mcp/](mcp/)，用于 KiCad CLI 自动化、KiKit、KiBot、SKiDL、FreeRouting、组件采购、制造操作和本地 RAG。
- **代理模块**，位于 [agent/](agent/)，用于 DFM 检查、KiCad 助手、路由、阻抗、热建模和编排。
- **工具原型**，位于 [tools/](tools/)，包括 KiCad 脚本查找工具和保留的 Elite PCB Designer 原型。
- **参考文档**，位于 [docs/](docs/)，用于公共工具说明、供应商参考、数据表和旧实现说明。
## 仓库布局
```text
K1.hardware/
|-- agent/ 用于 PCB 自动化工作流程的 Python 模块
|-- docs/ 公共参考和旧说明
|-- mcp/ 代理驱动的 EDA 工作流程使用的 MCP 服务器
|-- plugins/ KiCad 插件实验
|-- tools/
| |-- elite-pcb-designer/ 原型路由、放置和验证工具
| `-- kicad-footprint-hunter/ 脚本发现和脚本更新实用程序
|-- .github/ 为审查保留的工作流程定义
|-- .gitignore
|-- LICENSE
`-- README.md
```
## 使用工具
使用 [mcp/verify-servers.py](mcp/verify-servers.py) 检查本地依赖和 MCP 服务器可用性。使用 [mcp/test_rag.py](mcp/test_rag.py) 确认本地 RAG 索引可以回答工具查询。
旧的 Elite PCB Designer 原型现在位于 [tools/elite-pcb-designer/legacy-pipeline/](tools/elite-pcb-designer/legacy-pipeline/)。从该目录运行这些脚本，并期望提供您自己的 KiCad 输入文件。
## 社区和支持
- [问题](../../issues) 用于报告错误、清理发现和提取候选项。
- [Discord](https://discord.gg/8y8rXegU8j) 用于 SpectraSynq 构建讨论。
## 许可证
代码在 Apache-2.0 下获得许可；请参阅 [LICENSE](LICENSE)。除非源文档另有说明，否则文档在 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 下获得许可。
MCP 市场