chore: 注释调整与接口微调

dev.md

@@ -47,6 +47,8 @@
     - 长文件可使用 `#region` 分段，可以写上 `#endretion` 允许折叠。
     - TODO 使用 `// TODO:` 或 `// todo:` 格式。
     - 单行注释的双斜杠与注释内容之间添加一个空格，多行注释只允许出现 `jsDoc` 注释，如果需要多行非 `jsDoc` 注释，使用多个单行注释。
+    - 注释进行合理换行，考虑到中文字符较宽，建议 40-60 个字符进行换行。不允许在句中换行，必须在标点符号后换行。
+    - 单行注释结尾不添加句号，对于多行长注释，可以在结尾添加句号。
 - 类型：
     - 不允许出现非必要的 `any` 类型。
     - 所有类的成员必须显式声明类型。
@@ -54,7 +56,7 @@
     - 没用到的变量、方法使用下划线开头。
     - 合理运用 `readonly` `protected` `private` 关键字。
     - 函数不建议使用过多可选参数，如果可选参数过多，可以考虑换用对象。
-    - 尽量少地使用 `as` 关键字进行类型断言，一般情况下不建议进行任何 `as` 类型断言。
+    - 尽量少地使用 `as` 关键字进行类型断言，一般情况下不建议进行任何 `as` 类型断言，除非必要。
 - 其他要求：
     - 严格遵循 `eslint` 配置，不允许出现 `eslint` 报错。
     - 尽量不使用 `?.` 运算符，一般建议仅在副作用函数调用（如 `this.obj?.func()`，`this.obj.func?.()`），或对象 `Required` 化（如 `{ value: obj?.value ?? 0 }`）中使用 `?.` 运算符。