桌面应用图形学【免费下载链接】LorienInfinite canvas drawing/whiteboarding app for Windows, Linux and macOS. Made with Godot.项目地址https://gitcode.com/gh_mirrors/lo/Lorien点击查看免费下载本文基于 Lorien 官方贡献指南docs/contributing.md编写系统梳理了向这个基于 Godot 引擎的开源无限画布白板应用提交贡献时需要遵循的版本约束、协作流程与 GDScript 编码规范并结合仓库源码逐一印证每条规则在真实代码中的落地方式。读完本文你将掌握 Lorien 的开发者协作约定能够写出符合项目审阅标准、可直接被维护者合入的代码与提交。一、贡献概览三条基本约定Lorien 的贡献指南首先给出了三条贯穿所有贡献流程的基本约定它们是参与该项目开发的前提统一使用 Godot 4.3-stable项目在project.godot中声明config/featuresPackedStringArray(4.3)明确项目基于 Godot 4.3 特性构建。因此所有本地开发、代码测试与场景编辑都应基于 Godot 4.3 稳定版进行使用其他版本的引擎可能导致场景文件、GDScript 语法或导出行为不一致。重大功能先沟通后动手如果要实现一个大的功能应当先开一个 issue或在项目的 GitHub Discussions 中发起讨论与维护者确认设计方向后再写代码。这能避免大方向偏离导致的返工。提交信息以可读性为先commit message 要清晰表达改了什么、为什么改方便维护者审阅与后续追溯历史。二、代码风格规范四条硬性要求贡献指南中的代码风格部分定义了四类必须遵守的规则。下面逐一结合仓库源码说明其具体形态。1. 适配项目既有代码风格新提交的代码应当在结构、命名、缩进上与仓库现有.gd文件保持一致。阅读 lorien/Misc/Utils.gd 等核心文件是理解风格的最佳途径——每个工具函数都以统一模式组织详见下文函数分隔符。2. 使用 C 风格逻辑运算符项目中禁止使用 GDScript 关键字形式的and、or、not必须改用 C 风格运算符、||、!。这一约定在整个代码库中执行得相当彻底几乎每个脚本都能看到实例lorien/Misc/Utils.gdreturn InputMap.action_has_event(action_name, event) event.is_pressed() !event.is_echo()用串联三个条件、用!取反lorien/Misc/Utils.gdcalculate_rect中连续使用判断坐标象限lorien/InfiniteCanvas/Tools/SelectionTool.gdif event is InputEventMouseButton !disable_stroke:lorien/Main.gdif !_is_mouse_on_ui() _canvas ! null !is_dialog_open():。从搜索统计看、||、!遍布 BrushStroke、InfiniteCanvas 及其 Tools 子目录等几乎所有脚本而and/or/not关键字仅剩零星残留如 lorien/Misc/SvgExporter.gd 中的个别历史代码新贡献代码显然应当紧跟主流写法。3. 使用函数分隔符仓库中的每个.gd文件都在函数定义前使用一行由-组成的注释分隔符# ----...用于视觉上区分不同函数。以 lorien/Misc/Utils.gd 为例get_native_mouse_position_on_screen、remove_signal_connections、is_mouse_in_control等每个函数前都有分隔注释lorien/InfiniteCanvas/Tools/SelectionTool.gd 中同样如此连常量分组# ----分隔 const、enum、变量区也遵循同一模式。新函数定义前请复制这一分隔符保证文件内视觉节奏统一。4. 始终使用静态类型这是该项目代码风格的核心要求所有变量声明、函数参数与返回值都要显式标注类型充分利用 GDScript 的静态类型能力。仓库中的典型写法包括显式类型注解func calculte_bounding_boxes(strokes: Array[BrushStroke], margin: float 0.0) - Dictionary:lorien/Misc/Utils.gd类型推断声明var s : 、var idx : randf_range(0, UUID_ALPHABET.length()-1)同文件 L72-L77循环变量类型for stroke: BrushStroke in strokes:lorien/Misc/Utils.gd场景类显式继承与类型化成员class_name SelectionTool/extends CanvasTool、var _selection_rectangle: SelectionRectanglelorien/InfiniteCanvas/Tools/SelectionTool.gd。项目甚至通过引擎级配置强制这一约束在 lorien/project.godot 的[debug]段中开启了gdscript/warnings/untyped_declaration1即把无类型声明作为警告暴露在编辑器中提示你补全类型同时关闭了unused_parameter、unused_signal等无关警告0/false将编译期注意力集中在类型与声明质量上。三、从源码看规范的落地一次典型的代码审阅视角除了贡献指南明文列出的规则理解以下实现细节有助于新贡献者写出与项目融为一体的代码1输入与快捷键的处理约定。项目把输入动作统一定义在 lorien/project.godot 的[input]段如shortcut_new_project、shortcut_brush_tool、toggle_zen_mode等并在运行时通过 lorien/Misc/KeybindingsManager.gd 支持用户自定义重绑定。新增快捷键动作时应在 project.godot 中注册动作并在 lorien/Main.gd 的_unhandled_input中按既有 if/elif 链处理。2工具系统的扩展约定。Lorien 的画笔、橡皮、直线、矩形、圆形、选择六类工具都继承自CanvasTool如 lorien/InfiniteCanvas/Tools/SelectionTool.gd 的extends CanvasTool工具切换由 lorien/Main.gd 的_on_tool_changed转发到画布。如果你想新增一个工具应当按同样的继承与tool_event(event)分发模式实现并在 lorien/Misc/Types.gd 的Tool枚举中注册。3设置项的存放约定。全局常量默认画布色、画笔大小、FPS 上限等集中在 lorien/Config.gd 中例如DEFAULT_BRUSH_SIZE : 10、DEFAULT_FOREGROUND_FPS : 144、DEFAULT_BACKGROUND_FPS : 10用户可调设置则由 lorien/Misc/Settings.gd 读写user://settings_v4.cfg。新增可配置项时遵循Config 定义默认值 Settings 读写的分工。4提交前的自检清单。综合指南与仓库实践一份合格贡献的代码应满足Godot 4.3-stable 下可运行大改动有 issue/discussion 讨论记录commit message 清晰说明动机逻辑运算符全部为/||/!每个函数前有分隔注释所有声明带类型或:推断编译无 untyped 警告。四、贡献流程参考与更多资料贡献指南本身篇幅精简但它链接到的项目文档共同构成了完整的协作上下文docs/i18n.md翻译与本地化贡献指南——Lorien 支持英、德、西、法、意、韩、葡巴西、俄、土、乌克兰、中简/繁等多语言lorien/Assets/I18n/下的.txt文件即为各语言翻译表docs/changelog.md 与 docs/roadmap.md了解版本演进与规划方向便于对齐贡献目标docs/file_format.md.lorien存档文件格式规范涉及存档格式的改动务必先读此文用户手册 docs/manuals/manual_v0.7.0.md从使用角度理解各工具的行为预期。需要注意的是Lorien 仍处于活跃开发期当前版本见 lorien/Config.gd 中的VERSION_STRING存档格式未来仍可能变化贡献时应对此保持预期同时向项目提交 bug 报告、代码、美术或翻译都属于受欢迎的贡献形式参见 README.md。结语Lorien 的贡献指南虽然只有寥寥数条却精准地刻画了项目的工程气质明确的引擎版本锚点、先讨论后实现的协作节奏、以及近乎强迫症的 GDScript 编码纪律。对于希望加入这个项目的开发者遵循Godot 4.3 C 风格运算符 函数分隔符 全静态类型这条主线再对照仓库源码中的既有实现你的第一份贡献就能顺利通过审阅。赞分享桌面应用图形学【免费下载链接】LorienInfinite canvas drawing/whiteboarding app for Windows, Linux and macOS. Made with Godot.项目地址https://gitcode.com/gh_mirrors/lo/Lorien点击查看免费下载相关推荐SocketRocket开源贡献者指南代码风格与PR规范SocketRocket开源贡献者指南代码风格与PR规范 作为iOS/macOS平台最受欢迎的WebSocket套接字库SocketRocket的代码质网络通信Yaegi开源贡献者指南代码风格与提交规范Yaegi开源贡献者指南代码风格与提交规范 贡献前准备 Yaegi作为Go语言解释器项目采用标准Go开发流程。贡献前需确保本地环境满足 go.mod htt编程语言解释器语言运行时为OpenConnector贡献代码Provider开发规范与代码风格完整指南为OpenConnector贡献代码Provider开发规范与代码风格完整指南 OpenConnector 是一个开源认证网关通过 SDK、CLI、MCP后端API网关LLM 网关上一篇StateADK 中基于作用域前缀的会话状态读写机制下一篇FunASR OpenAI 兼容 API 的 Gradio 浏览器演示从本地部署到音频上传与录制转写创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考