GeWuYou
378d7afb23
fix(concurrency): 修复异步锁管理器中的超时单位错误和资源泄漏问题
...
- 修正 _lockTimeoutTicks 为 _lockTimeoutMs，统一使用毫秒作为时间单位
- 在 AcquireLockAsync 方法中添加异常处理，防止锁等待失败时的资源泄漏
- 为同步 AcquireLock 方法添加 ConfigureAwait(false) 避免死锁风险
- 更新锁统计信息中的 WaitingCount 字段为近似值说明
- 修正清理逻辑中使用正确的超时单位进行比较
2026-03-11 19:17:03 +08:00
GeWuYou
b37873a67c
feat(concurrency): 添加工业级异步键锁管理器
...
- 实现了基于键的细粒度异步锁机制
- 提供自动清理未使用锁的功能，避免内存泄漏
- 集成了统计信息收集功能，便于监控和调试
- 支持同步和异步两种锁获取方式
- 实现了锁句柄的自动释放机制
- 添加了完整的单元测试覆盖各种并发场景
2026-03-10 23:11:35 +08:00
gewuyou
11c7bc1457
Merge pull request #93 from GeWuYou/feat/result-add-try-map-bind-methods
...
feat(Result): 扩展Result结构体功能并优化实现
2026-03-10 21:16:41 +08:00
GeWuYou
c6024bf94a
feat(GFramework.Core.Functional.Result): 增强Result类的安全性和健壮性
...
- 在构造函数中添加强制不变式检查，确保失败状态必须携带非空异常
- 为Try方法添加空值验证，防止传入空委托导致异常
- 为Map方法添加空值验证，增强方法调用的安全性
- 为Bind方法添加空值验证，提升代码健壮性
- 重构Map和Bind方法结构，使其更清晰易读
2026-03-10 21:09:58 +08:00
gewuyou
248a29b4df
Merge pull request #92 from GeWuYou/deepsource-autofix-834b3193
...
refactor: use ternary operator for conditional assignments
2026-03-10 20:25:35 +08:00
gewuyou
1f0eb55288
Merge pull request #94 from GeWuYou/refactor/pool-simplify-warning-messages
...
refactor(pool): 简化对象池释放警告消息
2026-03-10 20:24:58 +08:00
deepsource-autofix[bot]
caeb1ab80f
refactor: use ternary operator for conditional assignments
...
This PR refactors code that used multi-line if/else statements to use the ternary operator for more concise and readable assignments.
- if statement can be rewritten using the ternary operator: The original code assigned values based on Storage.ExistsAsync(key) with separate if and else blocks, leading to verbose multi-line statements. We have replaced these with single-line ternary expressions in both the generic GetAsync<T> method and the UnifiedSettingsFile loader, reducing code duplication and improving clarity.
> This Autofix was generated by AI. Please review the change before merging.
2026-03-10 11:21:39 +00:00
GeWuYou
4750910675
feat(Result): 扩展Result结构体功能并优化实现
...
- 添加StructLayout特性优化内存布局
- 将Failure方法中的Exception替换为InvalidOperationException
- 重构Equals方法提高比较逻辑的可读性
- 简化GetHashCode方法的哈希计算逻辑
- 更新ToString方法移除空值检查
- 新增Try方法用于安全执行可能抛出异常的操作
- 添加Map方法支持将Result成功状态映射到其他类型
- 实现Bind方法用于链式调用Result操作
2026-03-10 19:20:52 +08:00
GeWuYou
43b88e7573
refactor(pool): 简化对象池释放警告消息
...
- 移除冗余的 'Attempting to release object for key' 文本
- 删除重复的 'or incorrect key' 描述
- 简化警告消息以提高可读性
- 保持核心警告信息不变
2026-03-10 19:13:39 +08:00
gewuyou
8e4e794661
Merge pull request #91 from GeWuYou/refactor/namespace-pascalcase
...
Refactor/namespace pascalcase
2026-03-10 19:07:33 +08:00
GeWuYou
52f95c7e5f
refactor(tests): 将Architecture目录重命名为Architectures
...
- 重命名GFramework.Core.Tests/Architecture目录为GFramework.Core.Tests/Architectures
- 更新所有相关文件中的命名空间引用
- 修复GameContextTests中TestArchitecture类的基类引用
- 修复TestArchitectureBase类的基类引用
- 修复ArchitectureTestsBase泛型约束中的类型引用
- 更新其他测试文件中的命名空间导入路径
2026-03-10 19:01:50 +08:00
GeWuYou
8ea462de28
test(architecture): 更新架构上下文测试以验证未注册组件抛出异常
...
- 修改 GetSystem 方法测试用例，验证未注册系统时抛出 InvalidOperationException
- 修改 GetModel 方法测试用例，验证未注册模型时抛出 InvalidOperationException
- 修改 GetUtility 方法测试用例，验证未注册工具时抛出 InvalidOperationException
- 更新异步架构测试中的系统销毁验证逻辑
- 移除对已销毁系统的空值检查断言，改为验证异步测试系统的销毁状态
2026-03-10 10:16:04 +08:00
GeWuYou
95de78efae
refactor(architecture): 优化架构上下文中的服务缓存和空值处理
...
- 将服务缓存从 Dictionary 替换为 ConcurrentDictionary 以提高线程安全性
- 移除所有 GetService 相关方法的可空返回类型，统一改为非空返回
- 修改 GetOrCache 方法实现，使用 GetOrAdd 方法简化缓存逻辑
- 更新命令和事件总线调用方式，移除空值检查操作符
- 调整接口契约，明确服务不存在时抛出异常而非返回 null
- 优化依赖注入容器的服务获取流程，增强错误处理机制
2026-03-10 09:08:13 +08:00
GeWuYou
aeed1f903c
refactor(GFramework.Ecs.Arch): 移除未使用的抽象依赖
...
- 从 ArchEcsModule.cs 中移除未使用的 GFramework.Ecs.Arch.Abstractions 引用
- 清理项目中不必要的命名空间引用以优化代码结构
2026-03-10 08:48:35 +08:00
GeWuYou
027a214479
refactor(core): 将System命名空间重命名为Systems
...
- 更新所有GFramework.Core.Abstractions.System引用为GFramework.Core.Abstractions.Systems
- 重命名GFramework.Core/System目录为GFramework.Core/Systems
- 重命名GFramework.Core.Tests/System目录为GFramework.Core.Tests/Systems
- 更新所有相关using语句和命名空间声明
- 修复测试文件中的命名空间引用
- 添加全局using引用GFramework.Core.Systems
2026-03-10 08:42:53 +08:00
GeWuYou
fb14d7122c
docs(style): 更新文档中的命名空间导入格式
...
- 将所有小写的命名空间导入更正为首字母大写格式
- 统一 GFramework 框架的命名空间引用规范
- 修复 core、ecs、godot 等模块的命名空间导入错误
- 标准化文档示例代码中的 using 语句格式
- 确保所有文档中的命名空间引用保持一致性
- 更新 global using 语句以匹配正确的命名空间格式
2026-03-10 07:18:49 +08:00
gewuyou
53b04c12f0
Merge pull request #90 from GeWuYou/docs/ecs-documentation-improvements-
...
docs(ecs): 更新文档中的类型参数表示和相关链接
2026-03-08 21:54:44 +08:00
GeWuYou
f5d1985a59
docs(ecs): 更新文档中的类型参数表示和相关链接
...
- 将文档中的 `ArchSystemAdapter<T>` 替换为 `ArchSystemAdapter<T>` 以正确显示尖括号
- 移除重复的许可证信息和分隔线
- 删除过时的文档链接，保持导航结构简洁
2026-03-08 21:37:37 +08:00
gewuyou
05d7557fa1
Merge pull request #89 from GeWuYou/refactor/extract-ecs-to-independent-module
...
Refactor/extract ecs to independent module
2026-03-08 21:27:34 +08:00
GeWuYou
f771b7dbef
chore(ci): 添加 GFramework.Ecs.Arch.Tests 测试步骤
...
- 为 CI 工作流添加新的测试步骤
- 配置 GFramework.Ecs.Arch.Tests 的测试运行命令
- 设置测试结果输出目录为 TestResults
- 使用 trx 格式记录测试日志文件
- 保持与现有测试配置一致的结构和格式
2026-03-08 21:01:13 +08:00
GeWuYou
f35c9309f3
docs(menu): 重构 ECS 文档导航结构
...
- 将 ECS 相关菜单项从 Core 部分独立出来
- 新增 ECS 概述页面和 Arch ECS 集成文档
- 删除旧的 Core/ECS 集成文档文件
- 更新侧边栏配置以支持新的 ECS 导航结构
2026-03-08 20:55:03 +08:00
GeWuYou
5c5525e3e9
refactor(architecture): 简化模块注册接口并增强配置管理
...
- 移除 RegisterBuiltInModules 方法中的 ArchitectureProperties 参数
- 更新 ArchitectureModuleRegistry 使用 ConcurrentDictionary 存储模块工厂
- 实现模块注册的幂等性检查，相同模块名只注册一次
- 为 ArchEcsModule 添加 ArchOptions 配置类支持
- 更新 UseArch 扩展方法传递配置选项给 ArchEcsModule
- 移除废弃的 properties 命名空间引用
- 添加显式注册集成测试验证模块配置功能
2026-03-08 20:47:26 +08:00
GeWuYou
ac2a9759e1
refactor(ArchEcsModule): 优化系统适配器管理
...
- 将 _systems 字段类型从 List 改为 IReadOnlyList
- 使用 GetAllByPriority 方法按优先级获取适配器
- 移除手动 AddRange 操作，直接赋值适配器列表
- 销毁时将 _systems 设置为空数组而非 Clear() 操作
2026-03-08 20:38:12 +08:00
GeWuYou
4257d58f86
feat(GFramework.Ecs.Arch): 注册模块自身到容器中
...
- 在 ArchEcsModule 初始化时注册模块自身到容器
- 移除不必要的空行以保持代码整洁
2026-03-08 20:33:00 +08:00
GeWuYou
bca92e52a3
refactor(ecs): 重构 Arch ECS 模块注册机制
...
- 移除自动初始化器，改用显式注册方式
- 修改 UseArch 扩展方法支持可选配置参数
- 更新文档说明新的集成方式和配置选项
- 删除自动注册相关的测试代码
- 调整 README 中的使用示例和架构说明
2026-03-08 20:19:24 +08:00
GeWuYou
af76e0ab0b
refactor(ecs): 移除Arch ECS模块及相关组件和系统
...
- 删除Position组件结构体定义
- 删除Velocity组件结构体定义
- 删除MovementSystem移动系统实现
- 移除ArchEcsModule ECS模块管理器
- 删除ArchSystemAdapter适配器基类
- 从ServiceModuleManager中移除ECS模块注册逻辑
- 从ArchitectureProperties中移除EnableEcs配置选项
- 删除ECS相关的单元测试文件
- 从项目文件中移除Arch和Arch.System包引用
- 从解决方案文件中移除ECS相关项目引用
- 更新项目配置文件中的目标框架和测试项目属性
2026-03-08 19:45:36 +08:00
gewuyou
23f186d395
Merge pull request #88 from GeWuYou/refactor/controllers-to-context-aware-architecture-access
...
refactor(docs): 修正文档中关于IController的描述
2026-03-08 11:39:51 +08:00
GeWuYou
25f7779b4e
refactor(docs): 将 Context 属性访问替换为扩展方法访问
...
- 将 Context.GetModel<T>() 调用替换为 this.GetModel<T>()
- 将 Context.GetSystem<T>() 调用替换为 this.GetSystem<T>()
- 将 Context.GetUtility<T>() 调用替换为 this.GetUtility<T>()
- 将 Context.SendCommand() 调用替换为 this.SendCommand()
- 将 Context.SendQuery() 调用替换为 this.SendQuery()
- 将 Context.SendEvent() 调用替换为 this.SendEvent()
- 将 Context.RegisterEvent<T>() 调用替换为 this.RegisterEvent<T>()
2026-03-08 11:37:31 +08:00
GeWuYou
1b9e81bbdb
refactor(docs): 将控制器实现转换为上下文感知模式
...
- 将 IController 实现改为使用 [ContextAware] 特性和 partial 类
- 移除手动实现的 GetArchitecture 方法
- 将架构交互方法从 this 调用改为 Context 调用
- 添加必要的 using 语句以支持新的架构访问方式
- 更新所有涉及模型、系统、工具和事件的架构访问代码
- 统一架构访问模式以提高代码一致性和可维护性
2026-03-08 11:03:02 +08:00
gewuyou
5190b7a463
Merge pull request #87 from GeWuYou/docs/technical-documentation-update
...
docs(config): 更新文档导航结构并添加新章节
2026-03-07 23:37:01 +08:00
GeWuYou
0d20a28385
fix(docs): 修正 API 参考链接路径并移除重复侧边栏配置
...
- 修正了 API 参考链接路径，移除了末尾多余的斜杠
- 移除了重复的 API 参考侧边栏配置项
- 确保导航链接的一致性和正确性
2026-03-07 23:34:11 +08:00
GeWuYou
eaa59c03c3
docs(config): 更新文档导航结构并添加新章节
...
- 添加最佳实践导航菜单和相关页面链接
- 在核心模块侧边栏增加生命周期、CQRS模式、协程系统等新条目
- 为游戏模块添加数据管理、场景系统、UI系统等功能链接
- 在Godot集成部分新增暂停系统、对象池和日志系统文档
- 将规则生成器重命名为ContextAware生成器
- 在教程部分增加暂停系统实践、数据迁移和单元测试等内容
- 新增API参考、常见问题、故障排查等文档分类
- 为最佳实践页面配置详细的子菜单项
2026-03-07 23:30:15 +08:00
gewuyou
8a070af51b
Merge pull request #86 from GeWuYou/docs/technical-documentation-update
...
docs(guide): 添加 ContextAware 生成器文档并更新相关链接
2026-03-07 23:15:06 +08:00
GeWuYou
740cc66ac4
docs: 更新源生成器文档并调整配置
...
- 移除 .claude 设置文件
- 重构枚举扩展生成器文档，更新 API 使用方式和配置选项
- 调整日志生成器文档，更新属性使用方式和配置参数
- 修改 Git 忽略规则添加 .claude/settings.json
- 更新代码示例和最佳实践指南
2026-03-07 23:13:21 +08:00
GeWuYou
4804b75215
test(PlayerController): 将测试方法转换为异步任务
...
- 将 TestPlayerController 方法从同步改为异步
- 使用 Task 类型替代 void 返回类型
- 为测试方法添加 async 关键字修饰符
2026-03-07 22:56:58 +08:00
GeWuYou
3dce243bcd
docs(source-generators): 修复上下文感知生成器文档中的错别字和链接
...
- 修复了代码注释中的错别字"生命期"为"生命周期"
- 移除了文档末尾的规则验证生成器链接引用
2026-03-07 22:55:37 +08:00
GeWuYou
6d398a515b
docs(guide): 添加 ContextAware 生成器文档并更新相关链接
...
- 新增 ContextAware 生成器完整文档，介绍自动实现 IContextAware 接口的功能
- 更新索引页面中的相关链接，替换规则生成器为 ContextAware 生成器
- 修改基础使用示例中的命名空间引用和代码实现细节
- 补充测试场景配置和多架构场景的使用说明
- 添加最佳实践和诊断信息相关内容
2026-03-07 22:51:42 +08:00
gewuyou
575dcdf27b
Merge pull request #85 from GeWuYou/docs/technical-documentation-update
...
docs(guidelines): 更新错误处理和移动端优化最佳实践
2026-03-07 22:12:35 +08:00
GeWuYou
28ad02dc80
docs(best-practices): 更新移动端优化代码示例
...
- 添加了图形 API 和多线程渲染的配置说明
- 增加了运行时可调整的性能设置选项
- 优化了纹理质量和阴影设置参数
- 添加了目标帧率和 VSync 配置
- 实现了基于设备性能的质量等级自动调整
- 改进了垃圾回收优化策略和相关注释说明
- 添加了设备性能检测的辅助方法
2026-03-07 22:10:14 +08:00
GeWuYou
8554f01423
docs(guidelines): 更新错误处理和移动端优化最佳实践
...
- 添加完整的错误处理最佳实践指南，涵盖Result<T>和Option<T>使用方式
- 补充移动端性能优化策略，包括纹理压缩、对象池、内存管理和电池优化
- 更新单元测试教程中的相关文档链接
- 完善错误处理层次结构和测试示例代码
- 增加移动端UI优化和平台适配最佳实践
2026-03-07 22:05:48 +08:00
gewuyou
519e3a480b
Merge pull request #84 from GeWuYou/docs/technical-documentation-update
...
Docs/technical documentation update
2026-03-07 17:45:19 +08:00
GeWuYou
9edf64193f
docs(architecture): 更新架构设计模式指南文档
...
- 将标题从"架构模式最佳实践"改为"架构设计模式指南"
- 添加全面的架构设计模式介绍和概述
- 新增MVC模式详细说明，包括概念、GFramework实现示例和最佳实践
- 新增MVVM模式详细说明，包括概念、GFramework实现示例和最佳实践
- 新增命令模式详细说明，包括概念、实现示例和撤销功能支持
- 新增查询模式详细说明，包括CQRS概念和复杂查询示例
- 新增事件驱动模式详细说明，包括事件定义和监听实现
- 新增依赖注入模式详细说明，包括构造函数注入示例
- 新增服务定位器模式详细说明，包括与依赖注入对比
- 新增对象池模式详细说明，包括通用对象池实现
- 新增状态模式详细说明，包括异步状态和状态机系统
- 补充模式选择与组合建议，针对小型、中型、大型项目提供不同方案
- 更新代码示例中的泛型语法格式，统一使用尖括号表示法
2026-03-07 17:32:26 +08:00
GeWuYou
739565d278
chore(build): 更新.gitignore配置以忽略AI相关和文档构建缓存文件
...
- 添加ai相关目录到忽略列表
- 忽略.omc/目录及其内容
- 忽略docs/.omc/目录
- 忽略docs/.vitepress/cache/目录
- 移除已删除的依赖文件和缓存文件
2026-03-07 17:12:11 +08:00
GeWuYou
a021941cab
docs(guidelines): 添加文档编写规范和配置设置
...
- 创建 DOCUMENTATION_STANDARDS.md 文件定义 Markdown 语法规范
- 添加泛型标记转义规则和 HTML 标签转义说明
- 提供内部链接验证规则和已存在文档路径列表
- 定义代码块规范和 Frontmatter 规范
- 添加文档结构规范和验证清单
- 配置 .claude/settings.json 启用 oh-my-claudecode 插件
2026-03-07 15:52:08 +08:00
GeWuYou
c969a9a022
docs(core): 修复文档中的泛型符号显示问题
...
- 修复了配置模块文档中 GetConfig、SetConfig、WatchConfig 方法的泛型符号
- 修复了 ECS 模块文档中 ArchSystemAdapter 的泛型符号显示
- 修复了函数式编程文档中 Option 和 Result 类型的泛型符号
- 修复了序列化和存储模块中各类方法的泛型符号显示
- 修正了存储模块文档中的序列化系统链接路径
- 修复了函数式编程教程中 Option 和 Result 的泛型符号显示
2026-03-07 15:51:47 +08:00
GeWuYou
84d7408bef
docs(tutorials): 添加系统实现教程并完善核心组件文档
...
- 新增协程系统、状态机、暂停系统、资源管理和存档系统教程
- 添加 Configuration 包详细使用说明文档
- 创建 ECS 系统集成指南，介绍 Arch.Core 集成方案
- 提供完整的组件定义、系统创建和实体管理示例
- 包含性能优化建议和最佳实践指导
2026-03-07 15:44:34 +08:00
GeWuYou
b4ef62c731
docs: 更新文档链接和相关资源引用
...
- 修改 resource.md 中 Godot 资源仓储链接为 Godot 扩展
- 更新 data.md 中相关文档链接，将存储和序列化系统替换为设置系统和 Godot 集成
- 将多个教程文档中的架构概览链接替换为快速开始链接
- 调整 save-system.md 中的相关文档列表，更新数据迁移和系统依赖链接
- 为 bun.lock 添加 configVersion 字段
2026-03-07 14:00:35 +08:00
GeWuYou
b3838ce8c7
docs(godot): 添加 Godot 架构集成和场景系统文档
...
- 新增 Godot 架构集成文档，介绍 AbstractArchitecture 和 ArchitectureAnchor
- 添加 Godot 场景系统文档，涵盖 SceneBehavior 和场景生命周期管理
- 包含数据与存档系统文档，介绍 IDataRepository 和 ISaveRepository 接口
- 提供完整的代码示例和最佳实践指南
- 覆盖多架构支持、热重载和场景参数传递等高级功能
- 包含常见问题解答和相关文档链接
2026-03-07 13:02:19 +08:00
gewuyou
23f70a6e5a
Merge pull request #83 from GeWuYou/feat/events-enhanced-bus
...
引入增强版事件总线，支持可过滤事件与弱事件，并可选地对事件发布与处理进行统计。
新特性：
新增 EnhancedEventBus，支持标准、优先级、可过滤和弱事件的发布与订阅，并提供可选的统计功能。
引入可过滤事件，支持可插拔的 IEventFilter 实现，包括基于谓词的过滤器和采样过滤器。
新增事件统计抽象及实现，用于跟踪发布/处理/失败计数和监听器指标，并支持生成统计报告。
测试：
新增全面的单元测试覆盖弱事件行为，包括与 GC 的交互、清理、注销以及与统计功能的集成。
新增基于谓词和采样事件过滤器的测试，包括多个过滤器、移除/清空行为以及对无效配置的校验。
新增事件统计测试，用于验证计数器、按事件类型的指标、重置行为、报告输出以及线程安全性。
2026-03-06 17:04:22 +08:00
GeWuYou
c5bd08acfd
fix(events): 修正优先级事件触发传播行为
...
- 将优先级事件的传播模式从 Continue 修改为 All
- 确保事件能够正确传递到所有监听器
2026-03-06 16:58:27 +08:00
