40 lines
2.6 KiB
Markdown
40 lines
2.6 KiB
Markdown
# 项目核心目标与执行纲领
|
||
|
||
## 1. 唯一使命
|
||
本项目（位于 `CNC/` 目录）的唯一目标是**创建一个与 LinuxCNC 完全对标的 G 代码解释器**。
|
||
所有代码修改、测试、文档工作，都必须围绕“对齐 LinuxCNC 官方源码的行为”这一最高准则展开。
|
||
|
||
## 2. 自动连续工作流（步步为营）
|
||
- **主动循环**：在完成一个语法功能的修复/新增并成功通过所有测试后，**严禁等待**。必须立即、主动地执行以下循环：
|
||
1. 扫描项目，找出下一个与 LinuxCNC 源码有差异或尚未实现的功能点。
|
||
2. 开始新一轮的“分析-计划-实现-验证”循环。
|
||
- **小步快跑**：每次循环只聚焦于**一个**极小的语法差异点或功能点。例如：
|
||
- 修复一个 G 代码的参数解析行为。
|
||
- 添加一个缺失的错误检查逻辑。
|
||
- 调整一个 M 代码的副作用。
|
||
- **中断条件**：只有在以下情况才停止自动循环，并向用户报告：
|
||
- 遇到一个无法自行解决的编译错误或逻辑矛盾（需附上详细分析）。
|
||
- 扫描后发现项目行为已与 LinuxCNC 源码在所有已知功能上**完全一致**。
|
||
- 用户明确发出“停止”指令。
|
||
|
||
## 3. 代码行为准则
|
||
- **源码唯一真源**：当对 G/M 代码的行为有任何疑问时，以 LinuxCNC 项目（尤其是 `src/emc/rs274ngc/` 目录）中的 C 源码实现为最终唯一标准，而非文档描述或直觉。
|
||
- **严格对标**：行为必须与 LinuxCNC 一致，包括但不限于：
|
||
- 错误号（`Interp::error` 的数字）
|
||
- 错误发生时的程序状态（是否继续解析、是否写入输出文件）
|
||
- 数值解析规则（如：不允许科学计数法，禁止前导零过多等）。
|
||
- 模态状态变化规则。
|
||
|
||
## 4. 测试铁律
|
||
- **修改必有测试**：任何代码修改，都必须伴随至少一个用于验证该行为的自动化测试用例。
|
||
- **本地测试优先**：实现前，应优先编写一个能展示差异的、会失败的测试用例，然后再修改代码使其通过。
|
||
- **测试命令**：修改完成后，必须运行以下命令来验证：
|
||
- `./test-native.sh` （本地快速测试套件）
|
||
- `./test-linuxcnc-source-link.sh` （针对直接链接 LinuxCNC 后端的完整测试）
|
||
|
||
## 5. 环境与项目结构
|
||
- **主工作目录**：所有命令和执行都基于 `CNC/` 根目录。
|
||
- **关键目录**：
|
||
- `src/emc/rs274ngc/`：LinuxCNC 解释器核心源码所在，是对标的根本依据。
|
||
- `smoke_tests/` 或 `tests/`：存放对标测试用例的目录。
|
||
- `.agents/skills/`：存放自动化技能文件。 |