# ecu.test（本地，多版本）使用本地 ecu.test 文件作为事实来源。出厂时 (<=2025.1) 首选 RST (`*_sources/*.rst.txt`)，否则使用 Sphinx HTML 文档 (>=2025.2)。始终确认 `Templates\ApiClient\ApiClient.py` / `Templates\ApiClient\ApiClient.xml` 中的准确 Python 签名。 ## 基本路径/环境 * `.env`（此文件旁边）定义已安装的 ecu.test 根目录，例如： * `ECU_TEST_2024_3_HOME=C:\Program Files\ecu.test 2024.3` * `ECU_TEST_2025_4_HOME=C:\Program Files\ecu.test 2025.4` * 可选覆盖：`ECU_TEST_HOME=...`（强制使用单个版本而不传递`--version`） ## 版本选择（重要） * 如果用户指定版本（例如 **2025.4**），请使用 `ECU_TEST_2025_4_HOME` 作为安装根目录。 * 如果用户未指定版本： * 如果设置则使用`ECU_TEST_HOME`，否则 * 使用在`.env`中找到的最新`ECU_TEST_<版本>_HOME`。 * 如果版本很重要（API 已更改）并且用户未指定，请询问要针对哪个 ecu.test 版本。 ## 文档根（按版本自动）下面的路径相对于所选的 ecu.test 安装根目录（请参阅版本选择）。 * 主要 API 文档根目录： * <=2025.1: `Help\APIDoc\` (RST 在 `Help\APIDoc\_sources\` 中) * > =2025.2：“Help\api\”（仅限 HTML；无“_sources\”） * 跟踪分析文档根目录： * <=2025.1: `Help\APIDoc\TraceanalysisAPI\` * > =2025.2: `帮助\api\TraceAnalysisAPI\` * 跟踪步骤模板文档根目录： * <=2025.1: `Help\TraceStepTemplatesDoc\` (RST 在 `...\_sources\root\` 中) * > =2025.2: `Help\trcp\`（仅限 HTML） ## 编写相关 api 代码时必须遵循模块/示例（关键位置） * 通用API（对象API + 内部API）： * RST/HTML: 主文档根目录下的 `general_api\` * 关键文档：`general_api\api`、`general_api\objectApi`、`general_api\objectApiExamples` * 用户工具/用户实用程序： * RST/HTML：主文档根目录下的“用户实用程序” * 工具框架： * RST/HTML：主文档根目录下的`tools\` * 发电机： * RST/HTML：主文档根目录下的`generators\` * 实用程序 API Python 示例： * <=2025.1: `Help\APIDoc\ExampleUtilities\` * > =2025.2: `Help\api\ExampleUtilities\` ## 事实来源（按顺序） 1. Python API接口定义（签名正确者优先）： * `模板\ApiClient\ObjectApiProxy.py` * `模板\ApiClient\ApiClient.py` * `模板\ApiClient\ApiClient.xml` 2. 文档（使用所选版本中存在的内容）： * <=2025.1: `Help\APIDoc\_sources\...` 下的 RST * > =2025.2: `Help\api\...` / `Help\trcp\...` 下的 HTML 3. Python 示例（真实的使用模式；更喜欢这些而不是猜测）。 ## 编写代码时必须遵循本地经验/标准 * `references\coding-standards.md` （包括 API 入口点 + 来之不易的安全规则） ## 调试代码时必须首先遵循现有的调试经验 * `references\debug-patterns.md` （过去的调试经验） ## 快速查找工作流程 1. 通过 Sphinx 索引搜索（首选；自动选择 RST 与 HTML）： * 主要文档：`python script/search_api.py --version 2025.4 --docset main --query AnalysisJobApi` *跟踪分析：`python脚本/search_api.py--版本2025.4--docset跟踪分析--查询模板` * 跟踪步骤模板：`python script/search_api.py --version 2025.4 --docset tracestep --query Threshold` 2. Grep 获取详细信息（精确匹配）： * RST: `rg -n "<关键字>" "\Help\APIDoc\_sources" -g "*.rst.txt"` * HTML: `rg -n "<关键字>" "\Help\api" -g "*.html"` * 签名： `rg -n "class .*Api" "\Templates\ApiClient\ApiClient.py"` 3. 生成Python代码时，确认`ApiClient.py` / `ApiClient.xml`中的名称/参数。 ## 回答规则（保持回答准确） * 首选 RST 源（如果可用）；否则使用附带的 HTML 文档。 * 始终引用您使用的本地文件路径（文档和/或 Python 源文件）。

Ecutest API技能

包含技能