v2.1.0 - Phase 2.5 Complete: Context Appending + Source Map Support

ErrorPare v2.1.0

发布日期: 2026-03-07
版本类型: Minor Release (新功能)
上一版本: v2.0.6

---

🎉 重大更新

Phase 2.5 完整发布！本次更新为 AI 开发者带来两大核心功能：代码上下文附加 和 Source Map 堆栈还原，让 AI 调试更高效、更精准。

---

✨ 新增功能

1. 代码上下文附加 (Context Appending)

自动附加报错位置的代码上下文（前后 5 行），帮助 AI 更快定位问题。

CLI 参数:

• --context-lines <number> - 控制上下文行数 (默认：5, 最大：20)

2. Source Map 堆栈还原

对于 TypeScript / Vite / Webpack / esbuild / tsc 生成的 JavaScript 报错，自动还原到原始源码位置。

支持特性:

• ✅ VLQ 编码/解码
• ✅ JSON Source Map 解析
• ✅ 内联 data URL 支持
• ✅ 外部 .map 文件自动发现
• ✅ 多链还原 (ts→js→min.js)
• ✅ LRU 缓存机制

CLI 参数:

• --source-maps - 启用 Source Map 还原 (默认：true)

3. CLI 语法高亮

代码片段现在支持语法高亮，关键字、字符串、注释等使用不同颜色显示。

---

🛠️ 技术改进

安全性修复

• 路径安全: 从 startsWith() 改为 path.relative() 检查，防止 sibling path 绕过

性能优化

• Source Map 缓存: LRU 缓存机制，避免重复解析
• 异步还原: 非阻塞式堆栈还原

代码重构

• Context 绑定: 使用 mergeKey->frame 映射，修复 merge 后索引失效问题

---

📊 测试覆盖

测试文件	测试数	状态
context-reader.test.ts	21	✅
compressor.test.ts	8	✅
source-map.test.ts	4	✅
mcp-server.test.ts	4	✅
总计	37	100% 通过

---

📚 文档更新

• ✅ README.md - 新增 Context Appending 和 Source Map 说明
• ✅ CHANGELOG.md - 完整 v2.1.0 变更日志
• ✅ MCP 集成文档 (Claude Desktop / Cursor)

---

🚀 升级方式

# 更新到最新版本
npm install -g errorpare@latest

# 或指定版本
npm install -g errorpare@2.1.0

---

📈 统计数据

• 新增代码: ~1,100+ 行
• 新增文件: 2 个 (source-map-resolver.ts, source-map.test.ts)
• 修改文件: 6+ 个
• 测试用例: 37 个 (100% 通过)
• 构建时间: DTS 46 秒

---

🙏 致谢

感谢所有贡献者和用户！Phase 2.5 的完成离不开社区的支持。

---

📞 反馈与支持

• 问题反馈: https://github.com/DrPei12/errorpare/issues
• 讨论区: https://github.com/DrPei12/errorpare/discussions
• npm 页面: https://www.npmjs.com/package/errorpare

---

Full Changelog: v2.0.6...v2.1.0

Release v2.0.6 - README Improvements

What's Changed

📝 Documentation Improvements

• Improved README structure with GitHub admonitions
• Added FAQ section
• Added LLM configuration quick reference table
• Reduced emoji usage for cleaner appearance
• Added npm downloads badge

📊 Technical Changes

• README.md: 150 lines added, 185 lines removed (net -35 lines)
• CHANGELOG.md updated with v2.0.5 and v2.0.6 entries

Full Changelog: v2.0.5...v2.0.6

ErrorPare v1.0.1

Fixed

• Python Stack Trace multi-line parsing
• Variable deduplication for same error with different values
• Java/Go stack trace over-splitting issue

Installation

npm install -g errorpare

Usage

errorpare compress errors.txt