refactor: 游戏地图接口重构

dev.md

@@ -76,11 +76,12 @@
 - 长文件可使用 `#region` / `#endregion` 分段以支持折叠。
 - TODO 使用 `// TODO:` 或 `// todo:` 格式。
 - 单行注释的 `//` 与注释内容之间留一个空格；不允许出现非 jsDoc 的多行注释，如需多行注释，使用多个单行注释代替。
-- 注释合理换行：考虑中文字符较宽，建议每 40–60 个字符在标点符号后换行，不要频繁换行，每行长度应差不多，不允许在句中换行；参数注释换行后保持对齐。
+- 注释合理换行：考虑中文字符较宽，建议每 40–60 个字符在标点符号后换行，不要频繁换行，每行长度应差不多，不要过短也不要过长，不允许在句中换行；参数注释换行后保持对齐。
 - 单行注释结尾不加句号；较长的多行注释结尾可加句号。
 - 一般不建议给接口（`inteface` 本身）、类型别名、枚举或类本身写注释（即需要紧接着一长段缩进的时候，这时候写注释不好看），特殊情况除外。
 - 对于 jsDoc 注释，方法注释必须使用换行风格；对于成员 jsDoc 注释，除非注释较长需要换行，否则使用不换行的风格。
 - 代码中的注释必须包含价值，说明下一行为什么会出现，不得出现解释下一行代码等类型的无价值注释，如 `// 清空 Xxx` 就属于无价值注释。
+- jsDoc 注释应该包含主要信息，不允许假设其使用场景，非必要不使用符号或英文单词，注释的目的是让用户看完注释就立刻知道接口的用处，而不是给写代码的人看，不得为了注释的正确性而使用奇怪的语序。
 
 ### 类型规范