用途:记录 AI 生成或修改的每一处代码变更,并按时间顺序沉淀为可浏览的变更文档。它把每次改动写入 reviews 目录的 Markdown 文件,同时自动生成并更新 HTML 查看器,方便开发者边开发边查阅历史记录。
主要能力:自动生成 Markdown 变更文档;提供 index.html 静态查看器;新增文档时自动刷新文件列表;最新文档默认展示;支持代码高亮与 diff 展示;GitHub 风格深色 UI 与左侧导航;内置浏览器搜索。运行仅依赖 Python,无需 Node.js 或 npm。
使用方式:初始化后,在脚本中导入记录器。 logger = CodeChangeLogger("项目名", user_request="需求") logger.log_file_creation("main.py", "代码", "原因") logger.log_file_modification(...)、logger.log_file_deletion(...) logger.save_and_build() 然后在 reviews 目录启动服务器: cd reviews python3 -m http.server 4000 浏览器访问 http://localhost:4000。后台运行可用: cd reviews && python3 -m http.server 4000 & 端口冲突时改用其他端口,或结束进程: lsof -ti:4000 | xargs kill -9 reviews 目录也可部署到 GitHub Pages、Netlify 或 Vercel。
适用场景:需要为 AI 辅助的连续开发过程留存变更说明、希望以网页快速回看每次改动的个人或团队;也可用于把 reviews 目录直接作为静态站点分享。
限制:文档指出项目结构包含 code_changelog_tracker.py 与 create_changelog.py,但未给出这两个文件本身的获取与安装细节;具体功能依赖这两个脚本的实际实现。除上述内容外,收费、平台支持范围、性能指标等暂未提供。