automotive-cursor-agents

# Automotive DeepSeek Agents（汽车工程智能助手库）

本项目主要基于开源项目 [theja0473/automotive-claude-code-agents](https://github.com/theja0473/automotive-claude-code-agents) 进行 DeepSeek 化迁移与增强。
由于部分人群无法访问Claude Code，这里对源项目进行基于DeepSeek/DeepSeek的适配。

_本项目主要使用DeepSeek Agent完成迁移，可能存在功能不完善的情况，后续会持续更新_

## 项目定位

- 在 DeepSeek 中直接使用汽车领域 `skills`、`rules`、`agents`、`workflows`、`knowledge-base`
- 提供 DeepSeek API 接入与本地持久化配置（`tools/cursor_config.py`、`tools/cursor_setup.py`）
- 保留 LLM Council 多模型辩论能力（`tools/llm_council.py`）

## 上游项目致谢与引用说明

本项目基于开源项目 [theja0473/automotive-claude-code-agents](https://github.com/theja0473/automotive-claude-code-agents) 进行二次开发与适配，核心目标是在 DeepSeek 环境下提供更易用的汽车工程智能助手能力。

主要改动方向包括：

- 面向 DeepSeek 的规则与工作流适配（`.deepseek/rules/`、`AGENTS.md`、`CLAUDE.md`）
- DeepSeek API 的接入与本地持久化配置（`tools/cursor_config.py`、`tools/cursor_setup.py`）
- LLM Council 在本仓库内的可用性增强与成本统计优化（`tools/llm_council.py`）
- 文档、目录与使用方式的本地化调整

## 许可证与合规说明

- 上游项目许可证：请参见上游仓库中的 LICENSE 文件  
  [theja0473/automotive-claude-code-agents](https://github.com/theja0473/automotive-claude-code-agents)
- 本项目许可证：请参见本仓库 LICENSE 文件
- 对上游代码与文档的引用、改写与再发布，保留原许可证要求的版权与许可声明。

> 声明：本项目为社区维护的衍生项目，与上游项目作者及组织无官方隶属关系。

## 快速开始（DeepSeek）

```bash
# 1) 安装 Python 依赖
pip install -r requirements.txt

# 2) 初始化 DeepSeek Key（会保存到用户目录）
python -m tools.cursor_setup

# 3) 检查是否已配置
python -m tools.cursor_setup --status

# 4) 运行一次 LLM Council 验证
python tools/llm_council.py "Generate FTA for overcurrent protection in ASIL-D BMS" -t general -r 1
```

> 说明：`llm_council.py` 默认会并行调用两个模型（`deepseek-chat` + `deepseek-reasoner`），并在结束后进行一次综合结论（synthesis）。

## 运行前提

- Python 3.10+（推荐 3.11/3.12）
- 已购买并创建 DEEPSEEK API KEY（默认 `https://api.deepseek.com`）
- 已配置 `DEEPSEEK_API_KEY` 或已执行 `python -m tools.cursor_setup`

## Key 持久化机制

- 优先级：环境变量 `DEEPSEEK_API_KEY` > 本地配置文件
- 配置文件路径：
  - Windows：`%USERPROFILE%\.automotive-deepseek-agents\config.json`
  - Linux/macOS：`~/.automotive-deepseek-agents/config.json`
- 常用命令：
  - `python -m tools.cursor_setup --status`
  - `python -m tools.cursor_setup --for