更新日志

v2.1.99

v2.1.99 正式推出 Lucky Code 桌面客户端，并进一步改善安装升级、充值和版本信息体验。

新增功能

• 新增 Lucky Code 桌面客户端，支持 Windows、macOS 和 Linux。
• 桌面客户端支持本地与远程两种连接方式：本地模式可自动安装并启动 Lucky Code 内核，远程模式可直接使用带访问令牌的 Lucky Web 地址连接。
• 桌面客户端支持中英文切换、深浅色主题联动、全屏显示、连接管理和版本更新提示。
• TUI 与 Web 新增 /about 和“关于”页面，可查看当前版本以及服务端配置的联系信息。

体验优化

• 桌面客户端会记住本地连接选择，再次启动时可直接进入；重新连接时会自动清理已启动的本地进程。
• 桌面客户端安装内核时新增进度反馈，并在内核未安装或版本过低时提供明确的安装、升级入口。
• Web 充值调整为先选择套餐、再选择支付方式并确认下单，减少误选支付方式的情况。
• 优化 Lucky 安装与升级失败时的诊断信息，便于直接定位 npm 等运行环境问题。

Bug 修复

• 修复部分 Linux 和 macOS 环境无法识别已安装 Lucky Code 内核的问题。
• 修复 Linux 桌面客户端菜单栏、窗口拖动、应用图标和连接状态显示异常的问题。
• 修复 npm 状态异常时安装或升级中断、并可能遗留不可用启动入口的问题。

升级方式

Lucky 会在启动时后台检查更新，也可以立即运行：

lucky update

v2.1.98

v2.1.98 重点改善终端中的鼠标操作、模型与分组选择体验，并优化账号相关提示。

新增功能

• TUI 新增“鼠标交互”设置，可在 /config 中按需开启；开启后会同时启用全屏模式，并在下次启动时生效。
• 开启鼠标交互后，可点击列表选项、使用滚轮浏览候选列表，并在输入框中点击定位光标。
• /model 与 /channel 统一为同一个模型和分组选择页面，可通过 Tab 切换；两个命令会分别打开对应标签页。
• 模型列表新增上下文窗口大小提示，分组列表补充价格倍率和选择说明。

体验优化

• 斜杠命令候选会根据终端高度动态展开，长列表浏览更方便。
• 优化模型、分组和配置列表的鼠标悬浮、点击、滚轮与键盘交互，减少切换标签后失去焦点的问题。
• Lucky 模式精简权限设置和命令入口，移除不适用的选项。
• 未登录、登录失效和余额不足提示改为中英双语，并提供明确的登录或充值入口。

Bug 修复

• 修复部分终端中鼠标点击无效、开启鼠标后滚轮失效的问题。
• 修复 /model 列表需要先按方向键才能响应鼠标，以及切换分组后无法继续悬浮选择的问题。
• 修复 Node.js 24 已安装但自动更新仍尝试重复安装 Node.js 的问题。

升级方式

Lucky 会在启动时后台检查更新，也可以立即运行：

lucky update

v2.1.97

v2.1.97 重点改善 Web 阅读体验、远程登录、命令行交互和安装更新流程，并增强长回答与工具调用的稳定性。

新增功能

• Lucky Web 新增小、中、大三档字体大小，可在设置中随时切换。
• Shell 模式支持需要密码的交互命令，密码输入会完整隐藏。
• Lucky 每次启动都会在后台检查更新，不阻塞当前使用；更新完成后，下次启动自动使用新版本。
• 上游回答因输出长度限制被截断时，会自动尝试续接一次。
• TUI 将模型与分组选择合并到同一设置页，可通过标签快速切换；切换分组后仍会引导重新选择模型。

体验优化

• 远程打开 Lucky Web 登录页时，会保留当前访问域名或 IP，登录后可正确返回远程页面。
• 优化安装与升级流程，补充 Node.js 24 运行环境检查，并及时清理下载和安装残余文件。
• npm 包名升级为 @thkj/lucky-code，已有安装可直接平滑更新，无需手动卸载旧包。
• 改进 Grep 工具兼容性和权限确认提示，减少不同模型调用工具时的参数问题。
• TUI 与 Web 的模型选择列表会显示上下文窗口大小，更容易比较不同模型。

Bug 修复

• 修复部分远程 Web 登录场景错误跳转到 127.0.0.1、导致浏览器拒绝连接的问题。
• 修复 !sudo 等 Shell 命令无法接入密码输入、或输入超时过短的问题。
• 修复登录注册等密码输入场景可能显示部分明文的问题。
• 修复回答达到模型输出上限后直接报错、无法自动恢复的问题。
• 修复部分安装失败、重复安装和旧包迁移场景中残留文件影响后续更新的问题。

升级方式

Lucky 会在启动时后台检查更新，也可以立即运行：

lucky update

v2.1.96

v2.1.96 重点优化 Auto 模式、安全确认、TUI diff 展示和发布安装体验。

新增功能

• Auto 模式默认进入 Shift+Tab 模式循环，切换到 Auto 时再展示安全说明。
• Auto 模式增加更清晰的动作编号、风险原因和拒绝提示，便于理解为什么需要确认。
• TUI 文件修改结果支持长 diff 自动折叠，避免大量改动刷屏。
• TUI 切换 channel 时会自动使用服务端推荐的默认模型。

体验优化

• Auto 模式对敏感信息、外部网络、权限配置、子代理委派和沙箱绕过等高风险动作的识别更稳。
• Auto 模式的提示文案更接近日常使用语言，减少不必要的困惑。
• TUI 中较长的 Auto 拒绝原因会自动换行，不再挤出屏幕。

Bug 修复

• 修复部分 Chat Completion 模型工具调用参数流式解析异常的问题。
• 修复 TUI 大文件 diff 未折叠导致聊天记录被顶掉的问题。
• 修复 Windows 安装器在可选终端依赖不可用时可能中断安装的问题。
• 修复 Web 拆分后部分启动检查仍读取旧路径的问题。

升级方式

已安装用户可以运行：

lucky update

v2.1.95

v2.1.95 重点优化 Lucky Web 的文件管理、聊天导入导出、长历史阅读、文件预览和 skills/plugins 兼容性，并修复一批影响日常使用的细节问题。

新增功能

• Web 与 TUI 统一聊天导入导出能力：支持导出 TXT、复制 TXT、导出可完整重导入的 JSON。
• 新增 lucky import <file>，可通过 JSON archive 重建原聊天并继续对话。
• Web 新建聊天旁新增导入入口。
• Web 文件树支持拖拽上传到指定文件夹、拖拽移动文件、自动展开目录和文件重命名。
• skills 支持安装到 Lucky 自身目录，同时继续读取 Claude 相关 skill 目录。
• 兼容全局 ~/.claude/skills。

体验优化

• 导入后的会话会显示在最近会话列表前方。
• 文件预览在没有内容时默认收起，减少空白区域占用。
• 不支持预览的二进制文件会明确提示“不支持预览”，不再显示乱码。
• 优化文件预览和 diff 预览的折叠标题、拖拽提示条、展开图标和滚动条样式。
• 优化 diff 文件列表对齐，文件名和 +/- 统计更稳定。
• 文件操作进一步收敛到右键菜单，界面更简洁。
• 额度不足、/recharge 充值和 lucky web 网页端入口提示增加中英双语。
• skills/plugins 列表提示补充读取来源，减少配置目录误解。

Bug 修复

• 修复 Web 加载更早历史消息后跳到顶部的问题。
• 修复“加载更早消息”提示未双语的问题。
• 修复文件树拖动时滚轮不可用、远距离拖动不方便的问题。
• 修复文件拖放后列表滚动位置短暂跳动的问题。
• 修复拖动文件时 ghost 跟随延迟和位置偏移的问题。
• 修复全局 ~/.claude/skills 没有被读取的问题。
• 修复部分不支持预览的文件显示乱码的问题。

升级方式

已安装用户可以运行：

lucky update

v2.1.94

v2.1.94 是 Lucky Code 的一次大型更新。本次版本累计引入数百项改进，重点补齐了 Web 工作台、本地登录注册、账号计费、模型分组、安装体验、Windows 兼容和长任务工作流。

主要亮点

• 新增 Lucky Code Web 工作台：在浏览器中使用聊天、文件、变更、上下文、终端和操作面板。
• 统一 TUI 与 Web 的本地登录/注册流程：登录成功后凭据安装在本机，TUI 与 Web 共用账号状态。
• 内置账号、余额、账单和充值入口：无需手动配置 API Key，也能查看消耗和订单。
• 强化模型与分组管理：支持按服务分组选择可用模型，并支持远端下发默认模型配置。
• 改进长任务目标管理：/goal、/compact、/rewind 等命令逐步下沉为可复用运行时能力。
• 大幅改善 Windows 安装和运行体验：Git Bash 检测、PortableGit fallback、ripgrep 依赖、终端快捷键和 shell 兼容性都有增强。

Lucky Web

本次版本正式引入 Lucky Code Web。它不是单独的演示页，而是与 Lucky TUI 共用底层会话、账号、模型、权限和工作区状态的浏览器工作台。

你可以在 Web 中完成：

• 多项目与多会话管理
• 时间线式对话与工具调用展示
• 文件树、文件预览、上下文附件和拖拽上传
• Git 变更查看、按轮次 diff 摘要和文件级回退入口
• 账单、充值、模型、权限和设置面板
• 终端、工作区、文件搜索和快捷命令面板

登录、注册与账号

• /login 支持本地浏览器登录/注册，不再依赖单独的设备码页面完成基础账号流程。
• Web 首次打开时会检查本地账号状态；未登录或凭据失效时进入登录/注册页。
• 登录页支持中英文切换，并适配窄屏和移动端。
• 账号信息、余额、账单与充值状态统一接入 Lucky 运行时。
• 优化注册、登录、错误提示和登录成功页的用户文案，隐藏底层服务实现细节。

TUI 体验

• 登录后新增 Lucky Code 使用引导，帮助用户快速了解 /model、/channel、/resume、/new、/recharge、/billing 等常用命令。
• 首页视觉更新为 Lucky Code 专属像素菱形图标。
• 优化模型选择、分组切换、语言提示和命令文案。
• 修复 Windows Terminal、Apple Terminal 等环境中回车、Ctrl+Enter、扩展键协议相关的输入兼容问题。
• 优化文件 @ 补全和路径搜索，尤其是 Windows 路径、斜杠和目录层级场景。

模型、分组与权限

• 支持从远端配置按分组下发默认模型，减少用户切换分组后的手动选择成本。
• 当前分组可用模型会参与补全和选择，避免选到不可用模型。
• 模型选择逻辑统一到运行时 provider，便于 TUI 与 Web 共享。
• 权限、自动模式和拒绝原因的提示更明确，部分命令标记会在进入 classifier 前做清理。

目标、命令与长上下文

• /goal 增强为更适合长任务的目标管理能力，支持启动、查看、恢复和清理目标。
• /compact 在 Web/TUI 运行链路中统一返回压缩结果，便于确认长上下文是否处理成功。
• /rewind 和轮次恢复能力继续向统一底层靠拢，为编辑历史对话、重试和文件回退提供基础。
• 新增 lucky uninstall，卸载 Lucky 本体时可询问是否同时清理聊天记录和用户配置。
• 对 slash command catalog 做了梳理，为后续 TUI/Web 共用命令底层打基础。

文件、附件与上下文

• 支持图片、PDF、文档和普通文件作为对话上下文。
• 文件 @ 选择改进为按目录层级加载，减少大型仓库一次性扫描压力。
• 文件树展示追踪与未追踪文件，并补充常见文件类型图标。
• PDF、SVG、图片和文本文件预览能力增强，非 ASCII 文件名处理更稳。
• 数学公式渲染引入 KaTeX 支持。

安装与跨平台

• 安装包构建和 Web 静态资源打包流程统一到发布链路。
• Linux/WSL 裸安装脚本可自动准备 Node.js。
• Windows 安装增强 Git Bash 检测；没有合适 Git Bash 时可使用 PortableGit fallback。
• Windows 默认依赖补齐 ripgrep，提升文件搜索和 @ 补全可用性。
• 避免误用 WindowsApps 下的 WSL bash.exe stub，减少“没有安装 WSL 分发”类错误。
• 隐藏部分 Windows helper 进程窗口，减少运行 shell 和后台任务时的弹窗干扰。

账单、充值与 Bridge

• 充值支付状态、账单查询、余额刷新和订单展示更完整。
• Bridge 登录页和管理页视觉更新，布局更贴近 Lucky Code 产品风格。
• Bridge 支持频道模型默认值、模型价格和通道配置相关能力。
• 注册验证码、登录流程和账号状态校验更加一致。

稳定性与工程质量

• 增加大量 Web 运行时、会话、附件、命令、文件树、diff、权限、账单和工作区相关测试。
• 增强 CI/CD、包构建、安装 smoke、VPS smoke 和发布验证脚本。
• 优化长历史会话读取，减少不必要的全量扫描。
• 改进启动时自动更新输出、node-pty 可选依赖启动路径、keychain 预取和 shell 探测。
• 补充 AGENTS.md 仓库协作规范，强调先定位根因再修复。

升级方式

已安装用户可以运行：

lucky update

首次安装请参考 快速开始。