{ "format": "1.0.0", "metadata": { "lastUpdated": "2025-09-15", "totalReleases": 11, "maintainer": "Claude Code Assistant", "description": "Claude Launcher Assistant 项目的结构化版本更新记录" }, "rules": { "maxReleases": 10, "autoCleanup": true, "sortOrder": "desc", "requiredFields": [ "date", "title", "features", "improvements", "fixes" ], "dateFormat": "YYYY-MM-DD", "versionPattern": "^\\d+\\.\\d+\\.\\d+$", "instructions": "维护此文件时，请保留最新的10个版本记录，自动清理过期版本。每个版本必须包含date、title、features、improvements、fixes字段。只记录真正发布成功的版本。" }, "releases": { "0.5.42": { "title": "EPIPE错误终极解决方案与MCP批量管理全面升级：多层防护根治连接问题", "features": [ "🛡️ EPIPE错误终极解决方案：四层防护机制彻底根治MCP连接断开导致的程序崩溃问题", "🎯 统一MCP批量管理系统：将三个分离的批量管理合并为Tab式统一界面，简化用户体验", "🚀 新增Crush配置管理功能：现代化交互界面与智能转换，支持CLI和交互式两种使用方式", "📤 完整配置导出功能：支持三种导出格式，提供安全脱敏选项和智能文件路径生成" ], "improvements": [ "⚡ MCP批量管理非阻塞交互优化：界面加载立即可操作，后台异步更新状态，零延迟用户体验", "🎨 交互式MCP批量管理界面：实时状态显示、灵活选择、响应时间智能着色、完整快捷键体系", "🔄 MCP服务管理架构重构：统一导入导出与Crush集成，专业化功能分离与双向同步支持", "🔧 上游端点管理专业化：重命名菜单提升技术准确性，统一所有相关位置的命名规范" ], "fixes": [ "🐛 修复严重的EPIPE错误：彻底解决MCP连接清理问题，程序退出时不再出现管道断开错误", "🔧 修复ESC退出时的EPIPE错误：增强MCP连接清理，确保所有资源正确释放和稳定退出", "🛠️ 修复ESM模块兼容性问题：将require改为动态import，避免模块系统冲突导致的程序错误" ], "date": "2025-09-15" }, "0.5.41": { "title": "开发环境智能检测与安装管理增强：批量更新与状态置灰显示", "features": [ "🧠 开发环境智能检测：自动识别开发/生产环境并在界面进行状态标识与功能置灰", "📦 安装管理增强：新增批量更新能力，一次性处理多项组件/配置的更新" ], "improvements": [ "⚡ 安装检测准确性与提示信息优化，提升引导清晰度", "🎯 操作流程与交互文案打磨，减少误操作" ], "fixes": [ "无相关变更" ], "date": "2025-08-26" }, "0.5.40": { "title": "更新检查页面用户体验优化：修复组件卸载问题并改进操作交互方式", "features": [ "无相关变更" ], "improvements": [ "⚡ 更新检查页面操作方式优化：将退出方式改为任意键返回，大幅提升操作便利性和用户体验", "🎯 页面控制逻辑改进：从自动返回改为手动控制返回时机，让用户有充分时间查看更新信息和状态", "🎨 界面视觉优化：使用ASCII对勾符号替代emoji，提升跨终端兼容性和显示一致性", "🔧 调试功能完善：新增详细的调试日志输出，便于问题排查和系统维护" ], "fixes": [ "🐛 修复更新检查页面无法返回的严重组件卸载问题：解决页面卡死导致用户无法返回主菜单的关键错误", "🔧 修复页面状态显示和交互逻辑缺陷：完善更新检查页面的状态管理，确保用户操作流程顺畅", "🛠️ 解决自动返回时机不当的体验问题：通过手动控制返回，避免用户来不及查看更新结果", "⚡ 修复调试信息缺失影响问题诊断：添加完整的调试日志，提升错误排查效率" ], "date": "2025-08-25" }, "0.5.39": { "title": "TUI模式参数传递修复：解决回归错误并优化更新管理用户体验", "features": [ "无相关变更" ], "improvements": [ "⚡ 统一默认模式和TUI模式参数处理逻辑：确保两种模式下透传参数的行为完全一致，提升用户体验的连贯性", "🎯 更新管理流程简化：移除检查完成后的配置调整询问步骤，检查完成后自动返回主菜单减少用户操作负担", "🔧 命令行架构参数传递优化：重构参数过滤和透传逻辑，确保CLI、TUI、默认三种模式的参数处理规则清晰明确" ], "fixes": [ "🐛 修复TUI模式下参数传递丢失的回归错误：解决`bun dev --tui -c`等带参数的TUI调用无法正确透传参数的问题", "🔧 修复更新检查完成后的重复询问问题：移除更新管理模块中检查完成后自动弹出的配置调整询问，避免用户操作中断", "🛠️ 解决默认模式和TUI模式行为不一致问题：统一两种模式的参数处理逻辑，确保用户在不同模式下获得相同的参数透传体验" ], "date": "2025-08-25" }, "0.5.38": { "title": "MCP CLI系统全面升级：创新交互式调用模式与命令行架构重构，实现专业级MCP服务器管理", "features": [ "🚀 完整MCP CLI调用系统：实现`cla --cli mcp`命令套件，支持list/inspect/call/read四大核心操作，提供专业级MCP服务管理能力", "💡 创新交互式会话模式：推出`cla --cli mcp session`交互式模式，解决动态工具命名服务器调用难题，在同一进程中保持MCP连接状态", "🔗 MCP连接池和会话管理：实现McpCliCaller客户端调用器支持HTTP/STDIO/SSE三种协议，集成连接池机制提升调用效率", "⚙️ CLI/TUI模式完全分离：重构命令行架构实现`--cli`纯命令行模式和`--tui`交互界面模式的清晰分离，满足不同用户操作偏好" ], "improvements": [ "⚡ MCP服务器重命名验证优化：完善McpServerEditor重命名功能，添加自动名称规范化处理确保Claude Code兼容性", "🎯 交互式工具调用体验升级：可视化服务器选择和工具调用界面，支持复杂JSON参数传递和多轮交互会话切换", "🔧 命令行参数解析增强：实现McpCliHandler完整参数解析处理，支持verbose详细模式和keep-connection连接保持", "📋 版本检测API统一优化：更新版本检测机制统一使用`--cli --version`标准接口，提升系统兼容性和可维护性" ], "fixes": [ "🐛 解决动态工具命名服务器调用问题：通过交互式会话模式完美解决如tikhub-io-api-docs等动态命名工具的调用难题", "🔧 修复MCP服务器重命名验证缺失：添加完整的名称格式验证和规范化处理，避免配置同步错误", "🛠️ 优化CLI模式用户体验：CLI模式单独运行时显示帮助而不强制进入交互界面，减少不必要的界面切换", "⚡ 改进MCP连接状态管理：实现可靠的连接状态检查和工具发现功能，确保调用过程稳定可靠" ], "date": "2025-08-25" }, "0.5.37": { "title": "Toast组件架构重构与MCP配置管理系统全面优化：大幅清理代码库并统一用户界面体验", "features": [ "🧹 全新统一MCP配置管理界面：整合添加、编辑、删除功能的McpConfigManager统一管理界面，简化操作流程", "🚀 分步引导式服务器添加流程：创建McpServerAdder组件支持SSE/HTTP/STDIO三种传输类型的友好添加体验", "🔧 全功能MCP服务器编辑器：实现McpServerEditor支持所有传输类型的完整编辑功能，提升配置灵活性", "📋 轻量级SimpleList组件：开发专用列表组件替代复杂SearchableList，优化界面性能和维护性" ], "improvements": [ "⚡ Toast组件架构大清扫：删除17个无用文件仅保留3个核心文件，统一使用SimpleControlledToast组件", "🎯 MCP配置管理体验全面升级：修复服务器类型显示UNKNOWN问题，正确显示SSE/HTTP/STDIO传输类型", "🔧 服务器名称格式验证优化：确保Claude Code兼容性，添加完善的名称格式检查和错误处理", "🎨 UI一致性和主题兼容性改进：优化Toast主题系统集成，保持[✓][✗][⚠][i]图标风格统一性", "📦 代码库清洁度大幅提升：移除重复、冗余和实验性组件，减少维护负担并统一开发规范" ], "fixes": [ "🐛 修复MCP服务器名称包含点号时的同步错误：解决特殊字符导致的配置同步失败问题", "🔧 解决MCP配置导出系统兼容性问题：更新InkUiAdapter以支持新的导出配置系统和交互体验", "🛠️ 修复Toast组件层级和定位问题：优化SimpleControlledToast定位逻辑，避免界面重叠和显示异常", "⚡ 消除Toast组件选择困难：统一使用单一Toast组件避免多种实现带来的混乱和不一致" ], "date": "2025-08-21" }, "0.5.36": { "title": "更新系统测试版本：验证极简化更新架构的稳定性和tiny-update-notifier通知机制", "features": [ "🧪 更新系统功能完整性测试：专门验证0.5.35极简化更新架构在实际环境中的稳定性和可靠性", "🔔 tiny-update-notifier通知机制验证：测试新集成的轻量级更新通知库是否正确触发版本检查和用户提示", "⚡ 从0.5.35到0.5.36的版本升级流程测试：验证完整的更新检测→用户提示→手动更新指导流程" ], "improvements": [ "🎯 更新检测准确性验证：确认极简化架构能够准确识别新版本并提供正确的版本差异信息", "🚀 轻量级更新系统性能测试：验证仅2个核心依赖的新架构在各种环境下的响应速度和稳定性", "📋 用户友好提示机制测试：确认更新发现时的手动更新命令指导和重启提示是否清晰有效", "⏰ 智能延迟控制验证：测试适当的延迟机制是否让用户有足够时间阅读更新信息" ], "fixes": [ "🐛 验证极简化架构解决的卡死问题：确认移除复杂进程逻辑后更新系统不再出现阻塞或卡死", "🔧 测试依赖数量优化效果：验证从41个依赖减少到2个依赖是否确实提升了系统稳定性", "🛠️ 确认简化错误处理的可靠性：测试新的简单错误处理机制是否避免了复杂逻辑带来的问题", "⚡ 验证纯粹检查→显示→退出流程：确认新的线性流程彻底消除了进程管理相关的稳定性风险" ], "date": "2025-08-18" }, "0.5.35": { "title": "极简化更新系统重构：彻底移除复杂进程逻辑，专注稳定的轻量级更新检查", "features": [ "🧹 全新极简更新架构：基于tiny-update-notifier构建轻量级更新系统，依赖数量从41个减少到2个", "⚡ 纯净更新检查机制：专注于稳定的版本检查功能，移除所有可能导致进程问题的复杂逻辑", "🎯 友好用户引导系统：发现更新时提供清晰的手动更新命令和重启指引" ], "improvements": [ "🚀 系统稳定性根本性提升：通过移除复合进程逻辑彻底避免卡死和阻塞问题", "📦 极致轻量化：包体积大幅缩减，仅12.2KB核心依赖，提升启动速度和系统响应", "🔧 简化错误处理：采用简单可靠的错误处理机制，避免复杂逻辑带来的未知问题", "⏰ 智能延迟控制：适当延迟让用户阅读更新信息，提升操作体验" ], "fixes": [ "🐛 彻底解决更新系统卡死问题：移除所有自动重启、PATH冲突检测等复杂进程逻辑", "🔧 修复复合进程导致的稳定性问题：改为纯粹的检查→显示→退出流程", "🛠️ 解决tiny-update-notifier超时保护缺陷：移除复杂的超时和spinner管理逻辑", "⚡ 消除所有可能的进程阻塞点：简化为最基础的更新检查和用户提示功能" ], "date": "2025-08-18" }, "0.5.34": { "title": "更新系统架构重构：集成成熟update-notifier库，保留智能功能并大幅提升稳定性", "features": [ "🏗️ 基于update-notifier构建全新更新架构：集成业界成熟的更新通知框架，提供稳定可靠的基础设施", "🚀 新增EnhancedUpdateNotifier类：在update-notifier基础上扩展智能重启、PATH冲突检测、多包管理器支持等创新功能", "🎨 创建EnhancedUpdateUI界面系统：提供友好的进度显示、阶段性状态反馈和用户交互体验", "⚡ 实现混合更新检查机制：支持同步缓存检查和异步主动获取，兼顾响应速度与准确性" ], "improvements": [ "🔧 更新系统稳定性全面升级：从自研解决方案升级到基于成熟库的实现，大幅提升可靠性和兼容性", "⚡ 后台更新通知机制优化：采用update-notifier原生通知系统，提供标准化的更新提醒体验", "🎯 保留所有现有智能功能：PATH冲突检测、智能重启、多包管理器支持等创新特性完整保留并增强", "📦 依赖管理标准化：新增update-notifier@^7.3.1依赖，采用业界标准的更新检查解决方案" ], "fixes": [ "🐛 修复自研更新系统的潜在稳定性问题：通过成熟库替换避免边缘情况和未知错误", "🔧 解决更新检查的兼容性局限：利用update-notifier的广泛兼容性支持更多环境和配置", "🛠️ 改进错误处理和用户反馈机制：基于成熟框架提供更准确的错误信息和处理逻辑", "⚡ 优化更新通知的时机和方式：采用标准的defer通知机制，避免干扰正常使用流程" ], "date": "2025-08-18" }, "0.5.33": { "title": "智能重启机制：彻底解决PATH环境优先级问题，更新后自动使用新版本重启", "features": [ "🚀 实现智能重启机制：更新后自动使用新安装的版本重新启动程序，彻底摆脱PATH优先级困扰", "⚡ 新增restartWithNewVersion函数：自动检测新版本执行路径并启动新版本进程", "🎯 创建独立进程管理系统：使用spawn启动独立进程，确保新版本正常运行和进程独立性" ], "improvements": [ "🔧 进程管理逻辑全面优化：从简单退出升级为智能重启，提供无缝的版本切换体验", "⚡ PATH环境冲突解决方案升级：不再依赖用户手动处理PATH问题，系统自动使用正确版本", "🎯 用户体验革命性提升：更新完成后立即享用新功能，无需任何手动干预或环境配置" ], "fixes": [ "🐛 彻底解决更新后仍使用旧版本的根本问题：通过智能重启机制确保始终运行最新版本", "🔧 修复PATH环境优先级导致的版本冲突：新版本更新后直接重启到新版本，避免环境变量干扰", "🛠️ 解决用户更新后困惑和额外操作负担：实现真正的一键更新体验，更新即可用", "⚡ 消除手动重新运行或重启终端的需求：系统智能处理版本切换，用户无感知享受新功能" ], "date": "2025-08-18" }, "0.5.32": { "title": "PATH冲突检测逻辑紧急修复：解决版本比较错误和误报问题", "features": [ "🔍 新增isVersionOlder版本比较函数：实现准确的语义化版本号新旧关系比较逻辑", "🎯 创建精准版本关系判断机制：正确识别PATH版本是否确实比安装版本旧" ], "improvements": [ "⚡ PATH冲突检测逻辑全面优化：从简单的不相等比较升级为准确的版本新旧比较", "🔧 版本比较算法精确化：支持语义化版本号的正确解析和比较", "🎯 冲突提示准确性提升：只有当PATH版本确实比安装版本旧时才显示冲突警告" ], "fixes": [ "🐛 修复PATH冲突检测核心逻辑错误：纠正错误的版本比较判断，避免相同版本被误判为冲突", "🔧 解决'默认运行 clau 仍使用旧版本'的误报问题：消除版本相同时的错误冲突提示", "🛠️ 修复版本比较函数缺失导致的判断错误：实现正确的语义化版本号比较机制", "⚡ 彻底消除0.5.31版本PATH冲突检测的逻辑缺陷：确保冲突检测逻辑的准确性和可靠性" ], "date": "2025-08-18" } } }