avtc-pi-logger
为Pi扩展设计的基于文件、按日期分区并支持轮转的日志库。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：avtc-pi-logger。 它的用途是：为Pi扩展设计的基于文件、按日期分区并支持轮转的日志库。 完整的 Skill 内容见：https://321skill.com/skills/avtc-pi-logger/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我在Pi扩展项目中集成avtc-pi-logger，记录每次API调用的开始和结束时间。’ 它会引导你安装库，并展示如何初始化日志记录器，在代码的关键节点调用 logger.info() 等方法。完成后，你的扩展将在指定目录生成按日期组织的日志文件，便于事后排查问题。
介绍
avtc-pi-logger 是一个专为 Pi 扩展设计的日志记录库，它解决了在 Pi 生态中进行持久化、结构化日志记录的痛点。传统的控制台输出难以追溯和分析，而该库提供了基于文件的日志方案，确保关键运行信息得以留存。
使用上，开发者通过 npm 安装后，即可在 Pi 扩展中引入该库，并调用其 API 记录不同级别的日志信息。库会自动将日志写入文件系统，并按日期创建独立的文件夹进行分区存储，有效管理日志文件。
它非常适合为 Pi 平台开发扩展或工具，并需要记录运行状态、调试信息或错误日志的开发者。无论是开发调试阶段，还是生产环境监控，都能提供可靠的日志支持。
建议在项目初期就集成此日志库，以建立完整的可观测性。需要注意的是，日志文件会占用磁盘空间，建议根据实际需求配置合理的日志轮转策略和清理机制，避免存储无限增长。
核心特点
与通用的 Node.js 日志库不同，它专为 Pi 扩展场景优化，内置了按日期自动分区存储文件的策略，并集成了日志轮转功能，开箱即用，无需复杂配置。
注意事项
不适合需要跨平台集中式日志收集或实时流式日志分析的复杂分布式场景。
常见问题
avtc-pi-logger 如何按日期分区？
它会自动根据日志记录的日期创建以 YYYY-MM-DD 格式命名的文件夹，并将当天的日志文件存储在其中。
日志轮转是怎么工作的？
库支持配置日志文件的大小或时间阈值，达到条件后会自动创建新的日志文件，并可选地压缩或删除旧文件。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/avtc-pi-logger/raw/index.md 读取 avtc-pi-logger 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/avtc-pi-logger/raw/index.md（查看排版版本）