frostbyte_neo/xlgo-core
1
0
Fork 0
Code Issues Pull Requests Actions Deployments Models Agent Notes Packages Projects Releases Wiki Activity
44 Commits 1 Branch 8 Tags
main
Commit Graph

12 Commits

Author SHA1 Message Date
杭州明婳科技 5dbbce34f5 docs: 同步 GUIDE/README 至 v1.4.0 
补 v1.4.0 发布时漏更的文档（代码与契约已改，文档未跟上）：
- GUIDE 13 定时任务：新增 WithCronTask App 集成模式 + pre-Init cron.AddTask 迁移警示。
- GUIDE 14 链路追踪：新增 WithTrace 生命周期集成 + OTel 进程全局多 App 注意。
- GUIDE 8.4 限流：新增 app.RateLimitRegistry() 多 App 计数隔离 + WithRedisClient。
- GUIDE 5.1 缓存 / 10.3 存储：注明 App 自动初始化（per-App redis 注入 / Close 收口）。
- README：新增 v1.4.0 更新日志条目；cron/缓存/限流段补 v1.4.0 说明。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-13 16:35:47 +08:00
杭州明婳科技 9e11f8f007 refactor: 同义可失败 API 收敛（cache/jwt/storage/ratelimit breaking change） 
按"同一能力只保留一个主入口、框架不替上层吞错、安全路径默认 fail-closed"原则，
收敛历史双轨 API。自定义 CacheService/Storage 实现需同步更新签名（编译失败即迁移信号）。

cache:
- CacheService.Get/Exists 改为 (bool, error)：命中 (true,nil)、未命中 (false,nil)、
  Redis 未就绪/命令错误/反序列化失败返回 (false,err)
- 删除 cache.GetE/cache.ExistsE/CacheGetter/CacheExistChecker/redisCache.GetE/redisCache.ExistsE
  （不保留 deprecated wrapper）
- 新增包级 cache.Get/cache.Exists（带 error）；GetWithPrefix 改为 (bool,error)

jwt:
- TokenBlacklist.IsBlacklisted 改为 (bool, error)，删除 IsBlacklistedE
- IsTokenRevoked 改为 (bool, error)
- ParseToken 默认从 fail-open 改为 fail-closed：黑名单后端不可检查时返回
  ErrBlacklistUnavailable 拒绝该 Token（无 Redis 部署不再支持可靠撤销）
- 删除 ParseTokenFailClosed（主 API 已 fail-closed）
- 保留 ParseTokenWithBlacklistPolicy + BlacklistPolicy/BlacklistFailOpen/BlacklistFailClosed
  供显式 fail-open（仅无 Redis 或低安全场景）

storage:
- Storage.Exists 改为 (bool, error)：存在 (true,nil)、不存在 (false,nil)、
  未初始化/路径非法/穿越/后端错误返回 (false,err)
- LocalStorage.Exists 区分 os.IsNotExist 与其他 Stat 错误
- OSSStorage.Exists 区分 OSS 404/NoSuchKey 与鉴权/网络错误
- 包级 storage.Exists 同步签名，未初始化返回 ErrStorageNotInitialized
- 新增 ErrReadTooLarge：Local/OSSStorage.Get 读取超 maxReadBytes 上限原误用
  ErrInvalidPath（语义不贴切），改为 ErrReadTooLarge

ratelimit:
- NewRedisRateLimiter 加 opts ...RedisRateLimiterOption，新增 WithFailClosed(bool)
  替代原 NewRedisRateLimiterFailClosed
- RedisRateLimit/CustomRedisRateLimit/RedisRateLimitWithIdentifier 同步加 opts 参数
- 删除 NewRedisRateLimiterFailClosed/RedisRateLimitFailClosed/CustomRedisRateLimitFailClosed
- UploadRedisRateLimit 由 fail-open 改为 fail-closed（资源敏感操作，Redis 故障时拒绝）

测试与文档:
- cache_m10_internal_test.go 重写 4 个 M10 测试为 Get/Exists 契约测试，新增 mock 编译覆盖
- jwt_test.go 改 4 处；jwt_c9c_internal_test.go 改 IsTokenRevoked 2-value
- examples/full/main_test.go 加 miniredis 注入（ParseToken fail-closed 后认证需 Redis）
- middleware_test.go 改 5 处 FailClosed 调用为 WithFailClosed(true)；auth_test.go 加 Redis
- storage 测试改 6 处 Exists/Get 断言为新签名/错误类型
- README/GUIDE 同步示例为新签名；CHANGELOG 新增 Breaking 升级说明与迁移示例

验证：go build / go vet / go test -race -count=1 ./... 全绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-12 22:22:10 +08:00
杭州明婳科技 21021d4001 fix: 收口剩余语义契约问题 2026-07-08 23:52:23 +08:00
杭州明婳科技 18eb62e2f0 fix app shutdown config and guide gaps 2026-07-08 20:22:30 +08:00
杭州明婳科技 74b65216b6 fix docs rate limit handler examples 2026-07-08 19:57:39 +08:00
杭州明婳科技 89721132a1 fix database default manager resource leaks 2026-07-08 19:11:37 +08:00
杭州明婳科技 1ea3d8751f fix cache lock context propagation 2026-07-08 19:02:01 +08:00
杭州明婳科技 86e126c42b release: v1.2.0 版本号提升 + 脚手架对齐 + 文档核验 
- 版本号 1.1.1 → 1.2.0：app.go Version 常量；脚手架 GoMod 模板经 xlgo.Version 自动跟随；GUIDE 文档版本同步
- CHANGELOG/README 新增 v1.2.0 破坏性版本条目（包级全局 atomic.Pointer 治理、jwt.DefaultJWT 删除、FindWhereOrdered 签名变更、response 去 omitempty、cache.ErrRedisNotReady、config.Clone 深拷贝等）
- 脚手架对齐：RepositoryMake 模板 FindByName 改用 FindOne（走 readConn 读写分离，避免 M-35 GetDB 不路由 footgun）
- 文档核验修复（README/GUIDE 逐行对照源码 6595e94）：
  - README DB 示例 users := ...Find(&users) 自引用声明编译错误
  - GUIDE xlgo.StartServer(engine,8080) 不存在 → engine.Run(":8080")
  - GUIDE app.token_expire 死键（v1.1.0 已移除 AppConfig.TokenExpire）
  - GUIDE jwt.expire: 86400 类型错（time.Duration 需字符串 "24h"）
  - GUIDE storage.Init(&cfg.Storage) 吞错误 → 显式 err 处理
  - GUIDE 登录示例 token,_:=jwt.GenerateToken 吞错误 + time.Duration(cfg.JWT.Expire)*time.Second 双重转换
  - GUIDE 验证规则表补 phone_strict / username
- .gitignore 忽略 8 个评审报告文件（仅本地保留，不入库；已从未推送提交中 filter-branch 清除）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-04 11:46:59 +08:00
杭州明婳科技 6595e94677 fix: 多模型评审终审收口 — P0安全 + 主线A并发治理 + 文档对齐 
经 deepseek/GLM/Claude 三轮对抗性评审 + 交叉核验 + 终审（见
last_report.md、cross_review_assessment.md），逐条回读源码核实并修复。
go build / vet / test -race ./... 全绿。

安全（P0）：
- JWT alg confusion：WithValidMethods 固定 HMAC + keyfunc 方法断言
- JWT 空密钥 / 不支持算法 fail-closed（ErrEmptySecret / ErrUnsupportedAlgorithm）
- 上传大小实测封顶（enforceUploadSize），不信任客户端 file.Size
- HTTP headers/cookies map 竞态（写锁+快照）+ SSRF 防护（opt-in dialer.Control）

并发/资源（主线A 闭合）：
- 包级可变全局一律 atomic.Pointer：DefaultRedis / DefaultStorage /
  DefaultManager / Validator / DefaultCache 等，消除裸指针数据竞争
- trace.Close 去 sync.Once（防 exporter 泄漏）；app OnReady 失败走 Shutdown
- ws.Hub.Stop stopOnce 防 double-close；cron 接入 App 生命周期（WithCron）
- ratelimit failClosed atomic.Bool；Recover Written() 守卫
- cron checkAndRun 锁内收集锁外 spawn（wg.Add 在锁内防 Stop 竞态）

终审剩余项收口（H-A~M-H + L 系列）：
- 副本连接池 MaxOpenConns/2 截断修复（replicaMaxOpenConns）
- JWT 黑名单 1s 超时 + 显式错误；ratelimit GetRedis 取一次复用
- GetPage 深分页上限；HashFile 流式；ReadFile 去 TOCTOU
- config Clone() 深拷贝；cache 锁操作返 ErrRedisNotReady
- compress 解压残留清理；正则预编译；EqualsIgnoreCase→EqualFold
- 删 redisLimiters 死代码；CLI 输入校验 + 回滚

文档：
- README/GUIDE/CHANGELOG 对齐当前 API（含破坏性变更迁移说明）
- docs/README 索引修正；config 注释修正（RS256 已不支持）

破坏性变更详见 CHANGELOG.md [Unreleased]。项目处于研发初期、无下游用户。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-03 23:16:03 +08:00
杭州明婳科技 0f13292a46 GLM 5.2修改版 2026-07-02 18:26:27 +08:00
杭州明婳科技 dcfd24b624 release: v1.0.3 bug fix release 
v1.0.3 定位为 bug fix release，收口 v1.0.2 引入的破坏性清理并修复
4 个轻量 bug + 依赖复查 + 版本号治理 + 文档对齐。同时包含此前未提交
的 v1.0.2 全部工作。

v1.0.3 变更：

Fixed:
- generateJTI 忽略 rand.Read 错误（jwt）— 改为 (string, error) 并传播
- QueryBuilder.Page Count 受残留 Limit 截断（repository）— countDB 加 Limit(-1).Offset(-1)
- OSS/本地存储文件名冲突（storage）— 新增 uniqueFilename 加 8 字节随机后缀
- 数据库重试策略对不可恢复错误无效（database）— 新增 isTransientDBError

Dependencies:
- go mod tidy 补全 postgres 方言传递依赖；安全补丁升级
  x/crypto v0.49→v0.53、golang-jwt/jwt/v5 v5.2.1→v5.3.1、gorilla/websocket v1.5.1→v1.5.3

Removed:
- Breaking: 清理 v1.0.2 兼容别名（InitMySQL* / driverName）
- 死代码 database.DBResolver
- 代码中 292 行"评分/理由"自夸注释（#26，23 个文件）

Changed:
- Breaking: 错误码体系重构 CodeSuccess 1→0、CodeFail 0→1，删除 CodeInvalidParams，加编译期防撞码
- database/mysql.go → manager.go；Logger 拆分三独立 core 修复 Tee 重复写入
- 版本号常量化：app.go 新增 const Version 作为唯一来源，CLI/脚手架模板引用之，不再散落字面量

Security:
- CORS 中间件按 W3C 规范修复 Allow-Credentials / Vary: Origin / 非白名单不回显

Added:
- console 包显式 level 控制（SetLevel/WithLevel/LevelSilent，atomic.Int32 并发安全）
- 新增测试 jwt/repository/storage/database/router/middleware/app
- 文档：新增 CHANGELOG.md、Version_v1.0.2_report.md；更新 README/GUIDE 顶部更新日志
- 文档对齐：删除对不存在的 config.DefaultManager() getter 的描述（保持 API 与文档一致）

详见 CHANGELOG.md 与 README.md 更新日志。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 21:40:10 +08:00
杭州明婳科技 2dfcbbbb22 init 2026-04-30 23:26:14 +08:00