Lyra Code 使用文档

English

简体中文

English

简体中文

Appearance

Changelog

Changelog ​

This page automatically loads Lyra Code releases on GitHub when the documentation site is built. Release notes come directly from the application repository and are no longer maintained separately in this documentation repository.

v3.7.1

What's Changed

Full Changelog: https://github.com/lyracode-app/Lyra-Code/compare/v3.7.0...v3.7.1

v3.7.1

新增

  • 为文件管理器添加 Linux rootfs 私有目录访问功能，方便用户管理 PRoot Linux 环境内的文件。

优化

  • 重新编译了应用使用的 PRoot 库，替换原先来自 RikkaHub 的预编译库。自编译库便于后续版本提供更好的支持和维护。
  • 基于 termux/proot 修改的源码已在 https://github.com/Soffd/proot 以 GPLv3 协议公开。

修改

  • 移除 PRoot Linux 中用于跳转共享存储权限设置的按钮。
  • 微调系统提示词，将代码执行的工具使用重心从 Termux 转向 PRoot。
  • 调整安装包签名方案为 V2+V3。
  • 调整目标平台为 Android 17（API 级别 37）。

v3.7.0

What's Changed

Full Changelog: https://github.com/lyracode-app/Lyra-Code/compare/v3.6.1...v3.7.0

v3.7.0

新增

  • 添加对 DeepSeek 官方 API 的缓存字段解析，使用 DeepSeek 官方 API 时，可在消息左下角查看本次请求的缓存命中率。
  • 添加 PRoot 引擎，支持导入几乎任何 ARM64 架构的 Linux rootfs，可通过 AI 和终端直接操控 Linux 环境。原有的 Termux 支持继续保留，避免提高迁移成本。

修复

  • 修复在 AI 输出时点击上下文窗口按钮导致界面错误显示“正在压缩上下文”且无法返回的问题（实际并未进入上下文压缩任务，仅为错误提示）。

修改

  • 更新服务协议中的旧 GitHub 链接为有效地址。
  • 为更新检测添加 GitHub 和 Gitee 支持，当应用自有服务器不可用时，自动回退到 GitHub/Gitee 进行检查，避免无法检测更新。

v3.6.1

What's Changed

Full Changelog: https://github.com/lyracode-app/Lyra-Code/compare/v3.6.0...v3.6.1

v3.6.1

新增

  • 支持通过 SSH 协议连接远程服务器，提供交互式终端会话

优化

  • 依据 DSH 架构进一步优化了缓存命中率

调整

  • 修改了部分页面文案

v3.6.0

What's Changed

New Contributors

Full Changelog: https://github.com/lyracode-app/Lyra-Code/compare/v3.5.0...v3.6.0

v3.6.0

新增

  • 新增繁体中文界面语言，覆盖更广泛的中文用户群体

优化 / 调整

  • 调整字体与大小页面样式，并完善实时预览功能
  • 调整文本语言入口位置，语言切换路径更便捷
  • 重构翻译底层架构，提升多语言切换效率与加载速度
  • 优化对话状态视觉效果，补充更详细的流式状态变更提示
  • 优化文件管理器对 APK 文件的识别与处理逻辑
  • 优化 run_command 工具对后台驻留命令的执行处理方式
  • 对 DeepSeek 原生搜索功能进行兼容性调整
  • 调整统计页面详情说明位置，布局更合理
  • 调整开源许可证协议页面内容展示
  • 移除底部动作面板中不再使用的刷新模型功能

修复

  • 修复部分页面中预测性返回手势的动画异常
  • 修复应用权限未授予时可能导致闪退的问题

v3.5.0

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v3.4.2...v3.5.0

v3.5.0

新增

  • 邮件处理功能（SMTP/IMAP）：支持连接标准邮件服务器，AI 可代您收发、阅读和处理邮件，实现邮件智能化管理
  • 新增预测性返回手势

优化

  • API 输出重试保护：API 流式输出过程中若中途返回错误，系统将自动重试，同时已输出的内容不受影响、不会回退，避免因临时故障导致内容丢失

v3.4.2

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v3.4.1...v3.4.2

v3.4.2

修复

  • 上下文压缩摘要格式：修复了上下文压缩功能在处理某些内容时返回错误格式摘要的问题，确保压缩后摘要可正常使用

优化

  • 旧安装包清理：优化了旧版本安装包的清理逻辑，应用占用空间更小
  • 调整了部分界面文本内容，表达更准确清晰

v3.4.1

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v3.4.0...v3.4.1

v3.4.1

修复

  • 推理深度调整入口恢复：修复了 3.3.0 版本中移除推理深度调整入口后，无法进入该界面的问题。现已重新优化推理深度界面及参数调整效果，体验更佳

优化 / 调整

  • 优化对话页对 AI 输出内容的渲染效果和顺序，提升阅读流畅度
  • 调整关于软件页部分 UI 布局，并移除社交群组外部链接

v3.4.0

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v3.3.0...v3.4.0

3.4.0

新增

  • 启用模型功能：预保存的模型列表现需添加至启用模型列表后方可切换使用，避免不需要的模型占用列表空间
  • Responses API 模式：支持 Responses API 的模型现可在服务商配置中启用，兼容新一代 API 规范
  • 对话元数据查看：点击对话页标题区域可展开查看当前对话的元数据信息

优化 / 调整

  • 优化系统提示词，提升指令遵循能力与输出质量
  • 调整子代理逻辑，增加防护机制，防止子代理继续分派子代理或产生互相冲突的执行行为
  • 优化上下文压缩逻辑，支持分段压缩，可提取结构化数据，保留更完整的关键信息

v3.3.0

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v3.2.0...v3.3.0

v3.3.0

全新 UI 设计

  • 重新调整了整体界面 UI，视觉风格更美观简洁

新增

  • 向用户追问工具：AI 在信息不足或需要确认时，可主动向用户发起追问，提升对话交互的完整性与准确性
  • 预设服务商：内置主流 AI 服务商预设配置，用户获取 API key 后可直接选用，无需手动填写和调整默认参数，开箱即用
  • 常用模型排名：在统计页面新增模型用量排行，可直观查看不同模型的使用频率和消耗分布

优化 / 调整

  • 调整对话页底部动作面板，优化模型列表和服务商列表的滑动操作体验
  • 移除推理深度入口，简化面板布局

修复

  • 修复 Gemini 配置修改后可能无法正确生效的问题

v3.2.0

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v3.1.2...v3.2.0

v3.2.0

新增

项目模式

  • 支持用户选择工作区目录作为独立项目
  • 在项目内可创建多个对话，所有对话共享同一项目
  • 有效解决传统会话模式下，多个对话分别维护同一项目历史记录导致的信息碎片化问题，方便集中管理

系统提示词与工具规范调整

  • 重新调整了软件内置的系统提示词和工具调用规范
  • 用户可通过查看项目源代码，或在应用内直接向 AI 询问，获取当前版本的原生提示词内容
  • 移除了原本的默认提示词，保留被修改过的默认提示词，原生提示词不可编辑和删除

文件管理权限增强

  • 文件功能现已支持通过 root 或 Shizuku shell 访问系统受限目录

v3.1.2

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v3.1.1...v3.1.2

v3.1.2

新增

  • 对话分支功能：支持在同一对话中创建独立分支，方便在不同思路上分别探索，而无需新建对话从头开始，有效管理复杂讨论场景
  • API 请求自动重试：当对话过程中因网络不稳定或 API 服务端临时错误导致请求失败时，系统将自动进行重试，避免对话直接中断，提升使用流畅度

修复

  • 修复一处界面中缺失的英文翻译

优化 / 调整

  • 调整对话页面的按钮布局与交互逻辑
  • 优化过程显示：将 AI 输出的过渡性正文内容整合至思考过程区域内展示，主对话区更干净聚焦

v3.1.0

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v3.0.0...v3.1.0

v3.1.0

新增

  • 灵活上下文压缩：重构对话上下文压缩逻辑，现支持三种压缩方式
    • 手动压缩：用户自行触发压缩
    • 按固定轮数压缩：达到设定对话轮数后自动压缩
    • 按固定 tokens 压缩：达到设定 token 阈值后自动压缩
  • 媒体文件预览：支持在应用内直接预览图片、音频、视频等常见媒体格式
  • 补充文件管理部分简单文件操作功能

优化 / 调整

  • 调整部分界面的显示效果

其他

  • 补全用户协议文档，完善法律合规性

v3.0.0

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v2.11.0...v3.0.0

v3.0.0

🎉 开启 3.x 时代

本次更新为本软件进入 3.x 系列的首个版本，带来了两大核心功能。

新增

1. 内置文件管理器与代码编辑器

  • 轻量级文件管理器：支持复制、移动、删除、重命名等常规文件操作，方便在应用内直接管理文件
  • 内置代码编辑器：
    • 支持主流编程语言的代码高亮
    • 支持文件内搜索与替换，便于快速定位和修改
    • AI 联动编辑：支持快捷拉取 AI 对话页至文件编辑页，AI 可直接读取文件内容并进行修改，大幅提升代码编写和调整效率

2. 记忆功能

  • AI 可在对话中判断并存储用户的个人偏好与关键信息
  • 存储的记忆可在不同对话间跨会话复用，让 AI 越来越懂你的习惯

优化

  • 优化英文界面下，部分弹窗因长文本而被挤压变形的问题
  • 优化工具调用逻辑与字段解析，提升工具执行稳定性与准确性

v2.11.0

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v2.10.0...v2.11.0

v2.11.0

⚠️ 破坏性变更

  • 移除沉浸扮演模式：该模式及其所有相关功能、数据已被彻底删除。
    如果你依赖此功能，请勿升级到本版本（建议停留在 2.10.0 并提前备份数据）。
    升级后，所有相关数据将被清空，即使回退到旧版本也无法恢复。

新增

  • 对话归档功能：支持将对话从历史会话列表中移除，数据保留不删除，可在归档中查看或恢复，便于整理会话列表。

优化 / 调整

  • 优化对话页导航按钮的触发逻辑，切换更灵敏流畅
  • 调整设置页部分内容的排版与分组，结构更清晰

其他

  • 重构部分底层代码，提升稳定性与可维护性

⚠️ Breaking Changes

  • Removal of Immersion Role-Play Mode: This mode and all its related features and data have been completely removed.
    If you rely on this functionality, please do not upgrade to this version (stay on 2.10.0 and back up your data).
    After upgrading, all related data will be cleared and cannot be recovered even by downgrading.

Added

  • Conversation archiving: Remove conversations from the history list without deleting data. Archived conversations can be viewed or restored at any time, helping keep your session list organized.

Optimized / Adjusted

  • Optimized navigation button trigger logic on the conversation page for more responsive switching
  • Adjusted layout and grouping of some settings page sections for clearer structure

Other

  • Refactored parts of the underlying codebase to improve stability and maintainability

v2.10.0

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v2.9.1...v2.10.0

v2.10.0

新增

  • 支持在设置中自由调整界面主题色和字体，打造个性化视觉体验
  • 话题总结从 Agent 工具中分离，现可作为独立功能单独调用

优化 / 调整

  • 优化 web_search 工具的搜索效率和结果准确性
  • 对 UI 进行大范围调整
  • 优化对话页导航按钮的功能逻辑
  • 调整对话页输入框的大部分功能与按钮布局

v2.9.1

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v2.9.0...v2.9.1

v2.9.1

新增

  • @ 命令：与 / 类似，可在工作区中选择文件，触发 AI 优先识别所选文件内容
  • 流式输出渐变动画：可在 设置 → 个性化 → 主题 中开启，渐变模式下文本显示更柔和、更丝滑

优化

  • 优化工具调用结果显示，现支持更完整的查询数据展示，提升可读性

修复

  • 修复因无可用 skill 或未选择 skill 时，以 / 开头的消息无法正常发送的交互问题

v2.9.0

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v2.8.0...v2.9.0

v2.9.0

新增

  • 无审批模式：开启后，执行需审批的命令将自动默认同意，提升自动化流程效率
  • AI 请求 URL 路径自定义
  • 移除全局工作目录设置，现支持在会话中单独配置工作目录，适配不同项目需求，以及防止不同会话污染同一目录
  • 支持手动检测模型服务是否可用
  • 对话完成后展示 token 生成速率
  • 支持通过 / 命令快速选择和调用技能，解决有相关 Skill 但 AI 不调用的问题
  • 输入内容自动保存为草稿，防止页面切换或意外退出导致内容丢失
  • LaTeX 公式渲染增强：对矩阵、行列式、微积分表达式及 /ce 化学公式的更好支持

优化 / 调整

  • 调整保存服务商时的弹窗提示位置
  • 优化 tokens 统计逻辑

修复

  • 修复 MCP 服务端无法修改配置的问题，并补全完整 JSON 数据显示
  • 修复因缓存导致的标签切换异常问题

v2.8.0

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v2.7.1...v2.8.0

v2.8.0

新增

  • 支持将复杂任务自动拆解为多个子任务，以并发方式执行 Agent 流，大幅提升多步骤任务的处理效率。

优化

  • 优化新对话中首次发送消息的交互体验，用户消息现在无需等待 API 响应即可立即显示在对话界面中。

v2.7.0

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v2.6.3...v2.7.0

v2.7.0

新增

  • 为软件界面增加英文语言支持，方便英文用户识别和操作。部分状态说明本次未作翻译，且后续不再安排完善工作，不影响软件核心功能的正常使用。(#2 )

v2.7.0

Added

  • The interface now includes English language support, making it easier for English-speaking users to navigate and understand.
    Please note that certain status descriptions have not been translated in this release, and we do not plan to add translations for them in the future. This does not impact the core functionality of the application.(#2 )

v2.6.3

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v2.6.1...v2.6.3

2.6.3

新增

  • 检测到新版本时自动弹出更新提示，升级更便捷。
  • 支持自定义对话页背景图片或颜色，个性化聊天体验。

调整

  • 移除对话页问候语，减少界面冗余，视觉更干净。
  • 关于软件页新增官网链接入口，方便快速访问官方网站获取帮助或公告。

v2.6.1

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v2.6.0...v2.6.1

v2.6.1

新增

  • 在微型服务器配置中增加自定义用户名选项，提升本地调试时的访问安全性。

调整

  • 调整上传文件列表的显示效果。
  • 调整裁剪图片页面的界面样式。
  • 调整开源许可页面的展示效果。

v2.6.0

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v2.5.0...v2.6.0

v2.6.0

新增

  • 黑名单规则现支持 * 通配符，可一键拉黑整个子域名，提升过滤灵活性。
  • 新增 FTP 系列协议功能及对应 Agent 工具，方便管理远程服务器文件。
  • 每天自动检查新版本，有更新时及时通知用户。
  • 软件可作为本地的 MCP 服务端运行，将 Agent 工具暴露给局域网内其他 MCP 客户端（如 RikkaHub、Operit、Codex、Claude Code、OpenCode 等），实现手机与 PC 协同调用。
  • 对话任务执行过程中实时显示已运行时长，便于监控耗时任务。
  • 统计页粗略显示: 大数值自动以中文单位（万、亿等）缩略显示，界面更简洁。

优化 / 调整

  • 调整模型服务页面布局，简化操作路径。
  • 优化侧边栏个人信息卡片样式，信息更清晰。
  • 改进过程记录中工具结果的显示，突出关键信息。

修复

  • 修复 run_command 工具所有命令均被错误拦截并返回 CommandGuard 异常的问题，现恢复正常执行。

v2.5.0

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v2.4.1...v2.5.0

v2.5.0

新增

  • 支持在工作区目录内一键启动本地静态服务器，方便调试 HTML/CSS/JS 等静态网页。
  • 可手动添加黑名单域名，AI 在联网搜索时将自动屏蔽这些来源，防止垃圾或恶意网页污染输出结果。

优化

  • 重算了 token 计数方式，现更精确地反映实际 API 消耗，便于成本控制。
  • 将主题切换选项移至二级页面（设置内），减少主界面干扰，使布局更整洁。

调整

  • run_command 从白名单模式转为黑名单模式，仅拦截明确禁止的危险命令，不再误拦常规开发或私有项目中的常用指令，提升灵活性和兼容性。

v2.4.1

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v2.3.0...v2.4.1

v2.4.1

新增

  • 支持通过自然语言创建后台任务，也支持手动添加任务；下载操作已整合至任务页，任务完成后可开启桌面通知，实时推送完成提醒。
  • 新增界面刷新率调节选项，可根据设备或偏好自定义。

修复

  • 修复手机信息页返回动画错误的问题。
  • 修复新对话创建逻辑错误，确保流程正常。
  • 修复字体大小无法完整调整的问题，现支持更精细的步进控制。

优化

  • 调整输入框键盘规避逻辑，减少遮挡，提升输入流畅度。
  • 补充 Termux 和 Shizuku 的 GitHub 快捷跳转链接，方便快速访问项目主页。
  • 优化 MCP 工具显示效果，改善视觉层次和可读性。

v2.3.0

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v2.2.2...v2.3.0

v2.3.0

修复

  • 修复点击“继续安装”后按钮无法自动移除的问题。

优化

  • 字体大小调整支持更精确的控制。

新增

  • 可通过 Magisk、KernelSU 等获取 root 权限，或通过 Shizuku 获取 shell 权限，执行系统命令。
  • 新增应用识别 Agent。
  • 内置原生协议下载器 Agent，支持通过 HTTP/HTTPS 下载文件。

v2.2.2

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v2.2.0...v2.2.2

v2.2.2

新增

  • 支持获取设备机型配置及详细型号信息，方便AI和开发者针对不同硬件进行精准适配与调试。

修复

  • 修复对话页中权限设置按钮无法即时生效的问题。
  • 修复在旧会话中点击新建对话时，错误重复创建多个新会话的问题。

优化

  • 为缺少 imePadding() 的旧版 Android 系统补充键盘规避能力，提升输入体验。
  • 优化键盘弹出与收起时的动画效果，使界面过渡更平滑。

v2.2.0

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v2.1.5...v2.2.0

2.2.0

新增

  • 侧边栏新增统计功能入口，可按时间段筛选并查看对话次数、输入 Token 与输出 Token 的用量统计。
  • 长按用户发送的消息即可弹出二次菜单，支持复制消息内容、修改原始消息并触发重新生成回复。

优化

  • 调整过程记录显示逻辑，现在会将模型最后的思考记录也纳入过程记录中，便于回溯推理过程。
  • 补全底部动作面板按钮的动态配色图标，提升视觉一致性。
  • 修改了用户消息气泡样式，更简洁、美观，提升阅读体验。

修复

  • 修复因本地缓存机制导致的第一条消息内容相同时，错误复用旧会话的问题。

v2.1.5

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v2.1.4...v2.1.5

v2.1.5

新增

  • 代码块增强：AI 输出的 Markdown 代码块现在拥有独立的复制按钮和代码高亮，便于单独复制和代码审查。
  • 表格导出：支持将 Markdown 表格导出为 CSV 文件，可一键保存到本地。

优化

  • 调整全段复制按钮的位置，将其移动到输出内容末尾，减少与代码块复制按钮的干扰。

修复

  • 修复沉浸扮演模式下，输入框无法自动避让键盘弹起的问题，确保输入体验流畅。

v2.1.4

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v2.1.1...v2.1.4

v2.1.4

新增

  • 增加skill导入模式，支持从文件导入、手动编辑SKILL.md文件、从代码仓库导入，并支持仅导入单个SKILL.md文件。
  • 应用内更新持久化保存APK路径，防止下载后丢失进度需要重新下载。

修复

  • 修复主题页、skills列表等图标未跟随动态取色功能。
  • 修复补充模式导入备份会重复导入相同对话的问题。

其他

  • 补全开源许可页依赖列表和查看原始许可证。
  • 将termux配置教程的命令改为单行命令，复制粘贴更方便。

v2.1.1

Full Changelog: https://github.com/Soffd/Lyra-Code/compare/v2.0.1...v2.1.1

v2.1.1

新增

  • 支持 Material You 动态配色，自动适配系统主题色
  • 支持字体大小修改，提升阅读体验
  • 支持自定义提示词：优化提示词管理功能，优化编辑页面，并可在对话中快速切换提示词
  • 新增推理深度调整选项
  • 关于软件页：添加 GitHub、Gitee 仓库链接，以及 QQ、Discord 社交群组链接

改进

  • 调整关于软件页面的布局，信息展示更清晰

修复

  • 修复因渲染 key 不稳定导致 AI 输出时无法展开思考过程的错误
  • 修复 WebDAV 备份因使用时间戳命名导致导入备份时返回 404 的错误
  • 修复 AI 对话页整体上移规避输入法的问题，现改为仅输入框上移
  • 修复新建对话图标显示错误
  • 修复沉浸扮演模式下 AI 输出空白消息的错误
  • 修复补充模式中导入空备份配置会覆盖已有配置的逻辑错误

Data fetched：2026/08/23

AGPLv3

Lyra Code Documentation