4.0 KiB
4.0 KiB
AGENTS.md
输出风格
- 先给结论，再说明必要条件和风险。
- 说业务含义，不只报类名、方法名。
- 不重复用户已经明确的前提。
- 不用长篇背景说明替代直接答案。
- 发现需求表达可能有歧义时，先确认，不要自行扩大范围。
开发原则
- 不过度开发，只做当前需求能闭环的最小改动。
- 每一行改动都要能对应到用户需求。
- 不顺手重构、不清理无关代码、不改无关格式。
- 先定位模板和调用链，再改代码。
- 物理隔离模板优先改各自独立 Drawer，不要改通用
FeatureDrivenDrawer，除非明确要影响所有模板。
项目结构认知
- 这是 AutoCAD 插件项目，主工程是
CadParamPluging.csproj。 - CAD 绘图逻辑主要在
Cad/。 - 模板生成器注册在
Cad/Drawers/。 - 模板参数默认配置在
Common/TemplateSchemaDefaults.cs。 - UI 参数入口主要在
UI/ParamDrawingPanel.cs和相关窗体。 - 断线、中心线、图层、线型样式由
Cad/DrawingStyleManager.cs管理。
模板隔离规则
当前项目模板是物理分开的，改模板前必须先确认对应文件：
-
车加工-轧制-环形：
- Drawer：
Cad/RingMachinedRollingDrawer.cs - Generator：
Cad/Drawers/RingMachinedRollingGenerator.cs
- Drawer：
-
毛料态-轧制-环形：
- Drawer：
Cad/RingRawRollingDrawer.cs - Generator：
Cad/Drawers/RingRawRollingGenerator.cs
- Drawer：
-
毛料态-自由锻-轴杆-圆轴：
- Drawer：
Cad/ShaftRawFreeForgeRoundShaftDrawer.cs - Generator：
Cad/Drawers/ShaftRawFreeForgeRoundShaftGenerator.cs
- Drawer：
-
毛料态-自由锻-轴杆-方轴：
- Drawer：
Cad/ShaftRawFreeForgeSquareShaftDrawer.cs - Generator：
Cad/Drawers/ShaftRawFreeForgeSquareShaftGenerator.cs
- Drawer：
不要因为模板逻辑相似就改错文件。确认 TemplateKeyBuilder.Build(...) 的四个参数后再动代码。
断线相关约定
- “断线数量”和“线型样式”是两回事：
- 几何断线数量：图上实际画几根竖线。
- 线型样式：每一根线内部显示为长线、短线、点划线等。
- 用户说“中间三个短竖线”时，通常指单根断线的线型图案，不是新增第三根几何断线。
- 四个相关模板的断线几何应保持两根竖向断线。
- 断线线型统一走
DrawingStyleManager.Role.BreakLine。 - 断线对象需要显式设置
LinetypeScale = 5.0。 - 若要改断线图案，优先改
DrawingStyleManager的 BreakLine 线型定义，不要在各模板里新增额外断线实体。
轧制环形左侧断口约定
车加工-轧制-环形和毛料态-轧制-环形应保持一致：
- 左侧上下横线需要向断线左侧外延 10 个单位。
- 外延后的最左侧需要加中心线。
- 中心线使用
Centerline样式，线型比例为8.0。 - 上下横线不能穿过两根断线之间，断线区域要断开。
- 底部水平尺寸标注线的左侧起点要和左延后的图形最左边对齐。
验证要求
修改后至少执行：
& "C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Current\Bin\MSBuild.exe" "CadParamPluging.csproj" /p:Configuration=Debug /p:Platform=AnyCPU /nologo
当前项目可能存在既有警告：
- AutoCAD 引用是 AMD64，项目是 AnyCPU，可能出现
MSB3270。 - 个别文件可能有重复
using System警告。
如果编译结果是 0 个错误，这些既有警告不要顺手处理，除非用户明确要求。
测试与回归检查
- 若行为可以用轻量源码级检查覆盖，可以在
Tests/下增加窄范围测试。 - 测试只覆盖本次需求，不要扩大成通用框架。
- 测试生成的临时
.exe要清理，不要留编译产物。
Git 与改动边界
- 可能存在用户未提交改动，不能随意回退。
- 不使用
git reset --hard、git checkout --等破坏性命令，除非用户明确要求。 - 不改
bin/、obj/里的生成产物。 - 最终说明要列清楚改了哪些模板、哪些文件、验证结果。