feat: 动态图层

dev.md

@@ -57,13 +57,15 @@
 
 ### 注释规范
 
-- 常用属性成员、方法、接口、类型必须添加 `jsDoc` 注释。
+- 公共方法、接口必须在**源头处**（多数情况下为 `interface`）添加 `jsDoc` 注释；其他常用成员、方法、类型也必须添加注释（含义极为明确或极少使用的可例外，但建议全部添加）。
+- 继承或 `implements` 而来的 API（方法、成员等），若注释说明无需变更，则**不应重复添加** `jsDoc` 注释。
+- 不对构造器添加注释。若构造器使用了属性声明语法（`constructor(public prop: T)`）且成员需要说明，可仅对该成员添加参数注释，不写构造器描述。**在这种情况下**建议避免在构造器中使用属性声明语法，将成员单独声明并在构造器中赋值。此条建议**并非**要求不使用构造器的属性声明语法，而是仅在这一情况下不建议使用，常规情况下推荐使用此语法来缩短代码长度并提高可读性。
 - 长文件可使用 `#region` / `#endregion` 分段以支持折叠。
 - TODO 使用 `// TODO:` 或 `// todo:` 格式。
 - 单行注释的 `//` 与注释内容之间留一个空格；不允许出现非 jsDoc 的多行注释，如需多行注释，使用多个单行注释代替。
 - 注释合理换行：考虑中文字符较宽，建议每 40–60 个字符在标点符号后换行，不允许在句中换行；参数注释换行后保持对齐。
 - 单行注释结尾不加句号；较长的多行注释结尾可加句号。
-- 一般不建议给接口、类型别名或类本身写注释（不好看），特殊情况除外。
+- 一般不建议给接口（`inteface` 本身）、类型别名或类本身写注释（不好看），特殊情况除外。
 
 ### 类型规范
 
@@ -77,6 +79,7 @@
 
 ### 其他要求
 
+- 不使用字符串作为键或特殊标识符（如枚举值、事件名、状态名等），应使用枚举代替。仅当明确表示字符串本身（如字符串类型的 id 别名、文件路径等）时方可使用字符串字面量。
 - 严格遵循 `eslint` 配置，不允许出现 eslint 报错。
 - 尽量不使用 `?.` 运算符，仅推荐在以下两种场景中使用：
     - 副作用函数调用，如 `this.obj?.func()` 或 `this.obj.func?.()`