Releases: SophorionAI/loglayer-support
Releases · SophorionAI/loglayer-support
Release v0.8.1
v0.8.1 - 优化浏览器日志组件架构和示例项目
🚀 架构优化
- 大规模简化浏览器端代码架构，减少约35%的代码量
- 移除冗余组件和抽象层，直接利用LogLayer核心功能
- 优化API结构，移除冗余函数并建立导出规范
🔧 功能增强
- 实现框架预设API：`createBrowserLogger`、`createServerLogger`、`createLogReceiver`
- 增强SLS传输功能，提供更好的Next.js兼容性
- 统一使用`withMetadata`方法增强日志信息
📚 示例项目更新
- 更新Next.js示例项目，增强日志记录功能和配置
- 修复examples兼容性，确保与简化架构匹配
- 添加React示例项目，展示Vite集成
🛠️ 开发体验改进
- 完善类型安全，解决TypeScript错误
- 优化构建配置和开发工具
- 增强文档和API参考
�� 发布的包
- @yai-loglayer/core@0.8.1
- @yai-loglayer/browser@0.8.1
- @yai-loglayer/server@0.8.1
- @yai-loglayer/receiver@0.8.1
- @yai-loglayer/sls-transport@0.8.1
- @yai-loglayer/next@0.8.1
🚀 v0.8.0: 模块化架构稳定版
🚀 @yai-loglayer/* v0.8.0 发布说明
📅 发布日期: 2025-01-31
🎯 版本亮点
这是 @yai-loglayer/* 包系列的一个重要里程碑版本，标志着模块化架构的成熟和稳定。我们专注于提供企业级的日志解决方案，现在所有包都达到了生产就绪的质量标准。
🚨 重要变更
- 废弃统一包:
@yai-nexus/loglayer-support已停止维护 - 推荐模块化使用: 请根据需要安装对应的独立模块
- 版本统一: 所有包版本统一升级到 0.8.0
📦 可用模块
🔧 @yai-loglayer/core@0.8.0
- 核心类型定义和工具函数
- 配置验证工具
- 环境检测功能
🌐 @yai-loglayer/browser@0.8.0
- 浏览器端日志封装
- 本地存储支持
- 批量上报功能
- Console 彩色输出
🖥️ @yai-loglayer/server@0.8.0
- Node.js 环境日志解决方案
- 文件日志输出和轮转
- Next.js 集成支持
- 多传输器支持
📨 @yai-loglayer/receiver@0.8.0
- 日志接收和处理
- 批量日志处理
- 数据验证和清洗
- Next.js API 路由集成
☁️ @yai-loglayer/sls-transport@0.8.0
- 阿里云 SLS 传输组件
- 批量发送和重试机制
- 企业级错误处理
- 统计信息监控
✨ 新增功能
- 完善的文档系统: 每个包都有详细的 README 和使用示例
- 统一的包结构: 标准化的项目结构和配置
- npm 徽章支持: 所有包都添加了版本和许可证徽章
- 交叉引用链接: 包之间有完整的相互引用
🔧 技术改进
- ✅ 通过完整的 TypeScript 类型检查
- ✅ 通过 ESLint 代码质量检查
- ✅ 通过构建验证
- ✅ 优化了包的元数据
📚 文档更新
- 完善了所有包的 README 文档
- 添加了高级用法示例
- 统一了文档格式和风格
- 创建了详细的迁移指南
🚀 快速开始
# 根据需要安装对应的包
npm install @yai-loglayer/browser # 浏览器端
npm install @yai-loglayer/server # 服务端
npm install @yai-loglayer/receiver # 日志接收器
npm install @yai-loglayer/core # 核心功能
npm install @yai-loglayer/sls-transport # SLS 传输🔄 从旧版本迁移
如果你正在使用 @yai-nexus/loglayer-support，请参考 迁移指南 了解如何迁移到新的模块化架构。
🤝 贡献
我们欢迎社区贡献！这个版本的发布标志着项目向开源社区的正式贡献。
📄 许可证
MIT License - 可自由用于商业和开源项目
感谢使用 @yai-loglayer/ 包系列！* 🎉
v0.7.9: 统一版本发布
🚀 v0.7.9 统一版本发布
版本统一
- 所有包版本统一升级到 0.7.9
- 简化版本管理，统一发布节奏
- 保持所有组件版本同步
包含的组件
核心包
- @yai-loglayer/core@0.7.9 - 核心类型定义和工具函数
- @yai-loglayer/server@0.7.9 - 服务端日志封装，Node.js 环境日志解决方案
- @yai-loglayer/browser@0.7.9 - 浏览器端日志封装，开箱即用的日志解决方案
- @yai-loglayer/sls-transport@0.7.9 - 阿里云 SLS Transport，企业级日志传输组件
- @yai-loglayer/receiver@0.7.9 - 日志接收器，处理客户端日志数据
示例项目
- basic-example@0.7.9 - Node.js 基础示例
- nextjs-example@0.7.9 - Next.js 完整示例
- react-example@0.7.9 - React 应用示例
开发工具
- build-config@0.7.9 - 统一构建配置
- eslint-config@0.7.9 - 统一代码规范
技术特性
- ✅ 完整的构建系统
- ✅ TypeScript 类型支持
- ✅ SSR/CSR 兼容性
- ✅ 企业级 SLS 集成
- ✅ 多平台支持（Node.js/Browser）
- ✅ 批量日志处理
- ✅ 重试机制和错误处理
安装使用
# 核心功能
pnpm add @yai-loglayer/core
# 服务端使用
pnpm add @yai-loglayer/server
# 浏览器端使用
pnpm add @yai-loglayer/browser
# SLS 集成
pnpm add @yai-loglayer/sls-transport
# 日志接收
pnpm add @yai-loglayer/receiver质量保证
- 🔥 所有包构建成功
- 🔥 GitHub Actions 发布流程正常
- 🔥 NPM 发布完整
- 🔥 示例项目测试通过
这是一个稳定的统一版本，推荐用于生产环境。
v0.7.8: 测试 NPM 发布
🚀 发布测试
功能完善
- ✅ 所有构建问题已修复
- ✅ SSR 兼容性问题已解决
- ✅ 依赖关系正确配置
- ✅ tsup 配置完全正常
NPM 发布测试
现在 @yai-loglayer scope 已经创建，测试完整的 NPM 发布流程。
技术改进总结
- 修复了 tsup CommonJS/ESM 兼容性问题
- 添加了缺失的 @loglayer/transport 依赖
- 修复了导入路径错误
- 解决了浏览器 Transport 的 SSR 兼容性问题
- 完善了 GitHub Actions 构建和发布流程
📦 包含的包
- @yai-loglayer/core@0.7.0-beta.1
- @yai-loglayer/server@0.7.0-beta.1
- @yai-loglayer/browser@0.7.0-beta.1
- @yai-loglayer/sls-transport@0.7.0-beta.1
- @yai-loglayer/receiver@0.7.0-beta.1
v0.7.7: 修复 SSR 兼容性问题
🐛 重要修复
SSR 兼容性修复
- 修复 Next.js 构建失败: 解决了浏览器 Transport 在服务端渲染时访问
navigator对象导致的错误 - 增强环境检测: 使用
typeof检查确保在 SSR 环境中安全访问浏览器 API - 消除构建错误: 修复
ReferenceError: navigator is not defined问题
构建系统完善
- ✅ 所有核心包构建成功
- ✅ 所有示例项目构建成功（包括 Next.js）
- ✅ GitHub Actions 构建流程修复
- ✅ SSR/CSR 通用兼容性
技术改进
- 更安全的浏览器 API 访问方式
- 更好的跨环境兼容性
- 完整的构建和部署流程
这个版本彻底解决了 GitHub Actions 构建失败的问题，现在可以安全地在服务端和客户端环境中使用。
📦 包含的包
- @yai-loglayer/core@0.7.0-beta.1
- @yai-loglayer/server@0.7.0-beta.1
- @yai-loglayer/browser@0.7.0-beta.1
- @yai-loglayer/sls-transport@0.7.0-beta.1
- @yai-loglayer/receiver@0.7.0-beta.1
v0.7.6: 修复构建依赖和配置问题
🐛 Bug 修复
构建系统修复
- 修复 tsup 配置兼容性问题: 解决了 CommonJS/ESM 模块兼容性问题
- 修复缺失依赖: 为 server 和 browser 包添加了缺失的
@loglayer/transport依赖 - 修复导入路径: 统一使用
@loglayer/transport而不是@loglayer/shared
技术改进
- 更新 build-config 包为 ESM 模块类型
- 统一依赖管理，确保所有包都能正确构建
- 修复 GitHub Actions 构建流程
验证
- ✅ 所有核心包构建成功
- ✅ 所有示例项目构建成功
- ✅ SLS Transport 功能正常
- ✅ 依赖关系正确
这个版本解决了之前 GitHub Actions 构建失败的问题，现在所有构建都应该能正常工作。
📦 包含的包
- @yai-loglayer/core@0.7.0-beta.1
- @yai-loglayer/server@0.7.0-beta.1
- @yai-loglayer/browser@0.7.0-beta.1
- @yai-loglayer/sls-transport@0.7.0-beta.1
- @yai-loglayer/receiver@0.7.0-beta.1
🎉 v0.7.5: GitHub Actions 修复完成
🎉 LogLayer Support v0.7.5 - GitHub Actions 修复完成！
✅ 修复成功确认
GitHub Actions pnpm workspace 问题已完全解决！ 🎉
🔧 成功解决的问题
- ✅ workspace: 协议支持*：从 npm ci 切换到 pnpm install
- ✅ pnpm 版本冲突：移除重复版本配置，自动检测
- ✅ monorepo 依赖安装：pnpm workspace 完全正常工作
- ✅ 缓存优化：pnpm store 缓存配置生效
📊 Actions 执行状态
成功的步骤：
- ✅ 检出代码 (checkout@v4)
- ✅ 设置 Node.js 18
- ✅ 安装 pnpm@10.13.0 (自动版本检测)
- ✅ 配置 pnpm store 缓存
- ✅ 安装依赖 (
pnpm install --frozen-lockfile) - ❌ 构建项目 (tsup 配置问题)
🔍 当前状态
Actions 修复状态: ✅ 完成
剩余问题: 构建配置的 CommonJS/ESM 兼容性问题
SyntaxError: Named export 'createTsupConfig' not found.
The requested module '@yai-loglayer/build-config/tsup.config.js' is a CommonJS module
这是 tsup 构建工具配置问题，不是 GitHub Actions 问题。
🎯 下一步
Actions 修复已完成，如需解决构建问题：
- 修复
@yai-loglayer/build-config的 ESM 导出 - 或调整 tsup 配置的导入方式
🏆 成就总结
- 问题根源: npm 不支持
workspace:*协议 - 解决方案: 切换到 pnpm + 正确的版本配置
- 验证结果: pnpm 环境完全正常，依赖安装成功
- CI/CD 流程: GitHub Actions 基础设施修复完成
重要提醒: GitHub Actions 的 pnpm workspace 支持现在完全正常！🚀
Full Changelog: v0.7.3...v0.7.5
✅ v0.7.4: GitHub Actions 最终修复
✅ LogLayer Support v0.7.4 - GitHub Actions 最终修复
🔧 最终修复
✅ 解决 pnpm 版本冲突
- 移除重复版本指定：从 Actions 配置中移除
version: 10 - 自动版本检测：让
pnpm/action-setup@v4自动从package.json的packageManager字段读取版本 - 修复错误：解决
ERR_PNPM_BAD_PM_VERSION版本冲突错误
🔍 问题分析
之前的错误：
Multiple versions of pnpm specified:
- version 10 in the GitHub Action config with the key "version"
- version pnpm@10.13.0 in the package.json with the key "packageManager"
解决方案：
- name: 安装 pnpm
uses: pnpm/action-setup@v4
# 移除 with.version，自动从 package.json 读取📦 预期 Actions 流程
现在 GitHub Actions 应该能够：
- ✅ 检出代码
- ✅ 设置 Node.js 18
- ✅ 自动安装 pnpm@10.13.0（从 package.json）
- ✅ 配置 pnpm 缓存
- ✅ 安装 workspace 依赖（
pnpm install --frozen-lockfile） - ✅ 构建所有包（
pnpm build） - ✅ 发布到 NPM（
pnpm publish --recursive）
🎯 关键改进
- 完整的 monorepo 支持：处理
workspace:*协议 - 缓存优化：pnpm store 缓存提升构建速度
- 版本一致性：统一使用 package.json 中的版本配置
- 发布优化：
--recursive --access public --no-git-checks
🔗 监控地址
GitHub Actions: https://github.com/yai-nexus/loglayer-support/actions
期望结果: 如果此次 Actions 成功运行并发布到 NPM，将标志着 CI/CD 流程完全修复。
Full Changelog: v0.7.3...v0.7.4
🧪 v0.7.3: 测试 GitHub Actions pnpm 修复
🧪 LogLayer Support v0.7.3 - 测试 Actions 修复
🎯 目标
测试修复后的 GitHub Actions 是否能正确处理 pnpm workspace。
🔧 已修复的问题
- ✅ 将
npm ci替换为pnpm install --frozen-lockfile - ✅ 添加 pnpm/action-setup@v4 配置
- ✅ 配置 pnpm store 缓存机制
- ✅ 使用
pnpm publish --recursive发布命令
📋 预期结果
如果此次 Actions 运行成功，将验证：
- pnpm workspace 依赖安装正常
- monorepo 包构建成功
- NPM 发布流程正常
🔍 监控状态
请查看 GitHub Actions 页面确认本次发布是否成功：
https://github.com/yai-nexus/loglayer-support/actions
测试版本: 如果 Actions 运行成功，v0.7.3 将作为稳定的 CI/CD 基线版本。
Full Changelog: v0.7.2...v0.7.3
🔧 v0.7.2: 修复 GitHub Actions pnpm 支持
🔧 LogLayer Support v0.7.2 - 修复 GitHub Actions
🛠️ 修复内容
✅ GitHub Actions 修复
- 修复 npm workspace 协议错误：将
npm ci替换为pnpm install --frozen-lockfile - 添加 pnpm 支持：使用
pnpm/action-setup@v4配置 pnpm 环境 - 优化缓存机制：添加 pnpm store 缓存，提升构建速度
- 修复发布命令：使用
pnpm publish --recursive支持 monorepo 发布
🔍 问题分析
之前的 GitHub Actions 失败原因：
npm error code EUNSUPPORTEDPROTOCOL
npm error Unsupported URL Type "workspace:": workspace:*
根本原因：项目采用 pnpm workspace 结构，但 Actions 仍使用 npm 安装依赖
🚀 解决方案
更新后的 Actions 配置包含：
-
pnpm 环境设置
- name: 安装 pnpm uses: pnpm/action-setup@v4 with: version: 10
-
缓存优化
- name: 设置 pnpm 缓存 uses: actions/cache@v4 with: path: ${{ env.STORE_PATH }} key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
-
正确的发布命令
run: pnpm publish --recursive --access public --no-git-checks
📦 包发布状态
现在 GitHub Actions 应该能够正确：
- ✅ 安装 pnpm workspace 依赖
- ✅ 构建所有 monorepo 包
- ✅ 发布到 NPM registry
🔗 相关链接
- 修复的 Actions 文件:
.github/workflows/publish.yml - pnpm Action: https://github.com/pnpm/action-setup
- Workspace 文档:
pnpm-workspace.yaml
升级说明: 此版本主要修复 CI/CD 流程，不影响代码功能。
Full Changelog: v0.7.1...v0.7.2