Lime v1.27.0

Lime v1.27.0

发布日期：2026-05-02

发布概览

• 本次发布目标 tag 为 v1.27.0，重点把 Agent Knowledge 从方案文档推进到 current 主链，同时继续收紧 Agent runtime、Skill 工具门禁、模型解析和 GUI 入口的一致性。
• 版本文件、Tauri 配置、headless 配置、CLI wrapper、release updater 测试样例与发布说明已同步到 1.27.0。
• 该版本继续坚持“一个事实源”：知识包、运行时上下文、命令契约、mock、GUI 页面和输入区发送 metadata 都收敛到同一条可验证链路。

用户可见更新

1. Agent Knowledge 知识库主链

• 新增 知识库 页面入口，支持查看知识包目录、知识包详情、来源导入、编译、默认包设置和运行时 context 预览。
• 新增 Markdown-first 知识包标准目录：.lime/knowledge/packs/<pack-name>/KNOWLEDGE.md、sources/、wiki/、compiled/、runs/。
• 新增知识包导入、编译、列表、详情、默认包和运行时上下文解析能力；GUI 与聊天发送链路都消费同一组 knowledge_* 命令。
• 聊天输入区新增轻量知识包选择菜单：可读取当前工作区知识包，默认选中项目默认包，也可手动切换具体知识包后发送。
• Agent runtime 新增 KnowledgePack prompt stage：从请求 metadata 解析知识包选择，调用 Knowledge Context Resolver，并以 fenced context 注入模型。
• 带知识包 metadata 的请求会强制进入 full runtime，避免 fast route 跳过知识上下文。
• 新增内置 knowledge_builder Skill，帮助把来源资料整理为 KNOWLEDGE.md、wiki/、compiled/brief.md 和 runs/ 草稿。
• 知识库页面提供 Builder 生成 入口，可把项目根目录、pack name、pack 类型和 builder metadata 带入 Agent 执行。

2. Agent runtime、模型解析与工具门禁

• 运行时模型解析继续向后端事实源收敛，增强默认 provider、模型候选、辅助模型和请求级模型能力解析。
• Skill 工具门禁增强：模型首刀 Skill、服务技能、浏览器工具、知识包上下文和 detour tool 抑制逻辑更明确，减少任务跑偏到工具目录发现或本地文件误读。
• Agent turn 输入、队列、session runtime 和 stream submit 链路补齐 request metadata、workspace context、team/runtime state 的传递与测试。
• fastResponseModel 与 full runtime 判定补齐知识包、媒体任务、显式 Skill 和运行时需求判断，避免该走主链的任务被短路。

3. 工作区、任务轻卡与图片任务恢复

• 图片任务 viewer 和 workspace 预览继续向统一 media task artifact 事实源收敛，补齐完成态、失败态、工作台展示和恢复路径。
• Inputbar、workspace send actions、message preview 和 task policy evaluation 增强多模态任务 metadata 传递，减少显式动作与纯文本命令之间的协议漂移。
• Agent UI 性能指标继续补充旧会话打开、消息列表首帧和 runtime session 读取的采集点与回归。

4. 导航、侧栏与本地化

• 侧栏、任务中心资料分组和页面内容区新增知识库入口，并补齐路由、页面类型和导航测试。
• 中英文 patch 增加知识库相关文案，翻译覆盖测试同步更新。
• 旧的 Agent Knowledge 探索文档收敛到 docs/roadmap/knowledge/prd.md 与执行计划，不再保留平行旧文档入口。

开发者与治理更新

1. 命令边界与 mock 同步

• 新增 lime-knowledge Rust crate，Tauri command 只做薄适配，知识包文件事实源集中在后端 crate。
• 新增前端网关 src/lib/api/knowledge.ts 与 feature 边界 src/features/knowledge，页面和 Hook 不直接散落裸 invoke。
• 同步 tauri::generate_handler! 注册、agentCommandCatalog、mockPriorityCommands 和浏览器默认 mock，知识包命令纳入契约检查。
• npm run test:contracts 覆盖新增知识包命令的前端调用、Rust 注册、治理目录册与 mock 边界。

2. 文档与路线图

• 新增 docs/roadmap/knowledge/prd.md，明确 KnowledgePack / Skill / Memory / Inspiration 边界和 P0/P1/P2 目标。
• 新增 docs/exec-plans/agent-knowledge-implementation-plan.md，记录 Phase 1 current 主链、验证记录与后续切片。
• Warp 和多模态运行合同文档补齐 Knowledge Context Resolver、runtime prompt stage 和执行 profile 说明。

已知说明

• 首版 Knowledge 仍坚持 Markdown-first，不做向量库、知识图谱、企业权限或知识包市场。
• knowledge_builder 当前生成草稿，不会自动覆盖用户已确认的知识资产；用户仍需人工确认关键事实。
• 知识包章节级 token 成本提示、细粒度章节选择和更完整 provenance / citation anchors 留在后续切片。

校验状态

• 已完成：
  • cargo fmt --manifest-path "src-tauri/Cargo.toml" --all
  • npm run format
  • npm run verify:app-version
  • npm run lint
  • npm run typecheck
  • npm run test:contracts
• 已做补充检查：
  • npm test -- src/lib/governance/legacyToolPermissionGuard.test.ts
• 待补跑：
  • npm test
  • cargo clippy --manifest-path "src-tauri/Cargo.toml"
  • cargo test --manifest-path "src-tauri/Cargo.toml"
  • npm run verify:gui-smoke
• 说明：
  • 本次按发布优先先行提交 v1.27.0，剩余全量测试与 GUI 冒烟待事后补跑。
  • 全量 npm test 上一轮遇到 Vitest worker onTaskUpdate timeout；verify:gui-smoke 上一轮遇到临时 Cargo target 目录失效，已确认属于执行环境问题，未作为本次提交阻塞项继续追查。

---

完整变更: v1.26.0 -> v1.27.0

Lime v1.26.0

Lime v1.26.0

发布日期：2026-05-01

发布概览

• 本次发布目标 tag 为 v1.26.0，重点继续收敛语音输入、音频转写、AgentUI 旧会话体验与多模态运行合同，让 current 主链只保留单一事实源。
• 版本文件、Tauri 配置、CLI wrapper、浏览器 mock、release updater 测试样例与相关发布说明已同步到 1.26.0。
• 该版本继续坚持“一个事实源”：语音、音频、转写、任务轻卡、Evidence Pack、Replay 与 GUI 恢复层都消费统一的 runtime contract / task artifact / media task index，而不是新增平行协议。

用户可见更新

1. 离线语音模型与 Fn 听写

• 设置页新增 SenseVoice Small 本地语音模型主链：可查看安装状态、下载模型、删除本地模型、设为默认 ASR、执行 WAV 文件测试转写。
• 本地模型按需下载到 Lime 数据目录，不进入桌面安装包；缺失模型文件时会给出明确引导，不会静默拉取大模型。
• voice-core 接入 sherpa-onnx offline recognizer，支持通过 model.int8.onnx 与 tokens.txt 运行 SenseVoice 本地转写。
• voice_asr_service 新增 SenseVoiceLocal 分支，录音采样率非 16kHz 时会转换为 16kHz mono float samples 后再识别。
• macOS 新增 Fn 按住录音第一刀：按住 Fn 打开语音输入，松开 Fn 停止并转写；Fn 不可用或权限不足时保留普通全局快捷键 fallback。
• 语音设置、快捷键设置、onboarding 语音测试与 ASR Provider UI 已补齐 SenseVoice / Fn 状态展示和回归覆盖。

2. Audio Transcription 转写任务

• @转写 / @transcribe / @Audio Extractor 归并到 audio_transcription 运行合同，入口只作为 binding，不再直接伪造 transcript 事实源。
• 新增 transcription_generate task artifact 主链：任务会写入 contract snapshot、transcript 状态、provider 结果、错误码与统一媒体任务索引。
• 最小 lime-transcription-worker 接入 OpenAI-compatible /audio/transcriptions provider：支持本地 source_path 与远程 source_url，成功后写入 .lime/runtime/transcripts/*。
• 转写失败会保留结构化错误，例如 provider 未配置、source 不可读、provider 请求失败、空 transcript、输出写入失败等；不会退回前端直连 ASR 或普通文件读取。
• 前端转写轻卡和 workspace viewer 可从媒体任务索引恢复完成态或失败态，完成态支持 transcript 文本、语言、输出格式、路径和时间轴信息展示。
• Transcript parser 支持从 verbose JSON、VTT / SRT 内容中恢复分段、时间戳和说话人信息。
• 转写校对产物新增 transcriptCorrection* metadata：保存修订版本时保留原始 transcript 不可变，并记录修订文本、分段数量、说话人数量和来源路径。

3. 音频生成与多模态任务恢复

• audio_generate 与 transcription_generate 继续统一到媒体任务索引，任务轻卡、运行时文档、DevBridge mock 和恢复层消费同一份 artifact。
• 音频预览 runtime 会优先读取统一索引中的 audio output 状态，不再依赖隐藏 task JSON；provider 失败时不会保留旧音频路径或伪造可播放结果。
• TaskMessagePreview、taskPreviewFromToolResult、媒体任务 API 与 mock 输出补齐 audio / transcript 状态字段，减少完成态、失败态、缺 trace 之间的误判。

4. AgentUI 首页、任务中心与旧会话性能

• Agent Chat 首页补齐 Home Start Surface、引导卡、技能卡片、更多技能抽屉、Starter Chips 与稳定回归。
• 新建任务、打开已有会话、任务中心 tab、侧栏会话列表之间的事件链收敛到 taskCenterDraftTaskEvents，减少旧导航和本地 tab 状态双写。
• 旧会话打开继续降载：最近会话首屏请求从大窗口降到 11，任务中心 topics 初始请求降到 21，归档列表也改为可见数量 +1 的哨兵分页。
• 侧栏 hover / focus 旧会话预取延迟到约 900ms，点击时取消未触发预取，避免鼠标扫过列表时抢占正式切换链路。
• 侧栏打开旧会话后，路由追平会在短窗口内去重，避免同一用户意图触发两次 switchTopic / agent_runtime_get_session。
• 旧会话恢复首帧优先正文和输入区，运行轨迹、thread items、queued turns、pending actions 等投影延迟到 idle；正在发送、聚焦 timeline 或存在 A2UI 待处理时不会延迟实时反馈。
• MessageList 继续强化旧会话轻量渲染：历史窗口只先渲染最近消息，timeline 延迟构建，长历史 Markdown 使用轻量预览，Provider / Prompt Cache 配置扫描推迟到首帧后。
• 新增 window.__LIME_AGENTUI_PERF__ 性能采集器，可按 session 汇总 clickToMessageListPaintMs、runtimeGetSessionDurationMs、隐藏历史数量、最终渲染消息数量和可用堆内存指标。

5. Browser Assist 与工作区展示

• Browser Assist renderer 增强运行结果展示，支持更清晰地呈现浏览器会话、页面、操作结果与可恢复状态。
• Workspace 的音频任务预览、转写任务预览、图片任务预览和 general workbench 恢复逻辑进一步对齐 task artifact / media index 事实源。
• Inputbar 与消息渲染继续收紧多模态、运行态、队列态和任务文件展示，减少过程信息污染最终正文。

6. Provider、模型能力与设置体验

• API Key Provider 设置页补齐 provider 配置、模型能力和 Prompt Cache 相关展示与回归。
• OpenAI-compatible provider 和 credential bridge 增强，为音频转写、模型能力推断和 provider 解析提供更稳定的后端事实源。
• LimeHub local dev models 与本地 provider 模型列表同步更新，减少设置页和运行时模型认知漂移。
• 外观配色扩展：在原有配色基础上新增 霓虹、青柠、暮色、极简、鲜活、文学、奢华 等主题，并调整现有配色名称与描述。

开发者与治理更新

1. 运行合同与治理校验

• modalityRuntimeContracts 新增 / 更新 audio_transcription，并同步 Rust 合同常量、前端 registry、mock 和校验脚本。
• 新增 modalityArtifactGraph.json，把 entry binding、executor binding、artifact、viewer 和 evidence / replay 关系显式化。
• scripts/check-modality-runtime-contracts.mjs 扩展校验范围，覆盖 capability、model role、artifact kind、artifact graph 与 current contract 同步关系。
• npm run test:contracts 现在覆盖 agent runtime client 生成检查、命令契约、harness 契约、modality contracts 与 cleanup report contract。
• 收紧 runtime evidence pack 和 modality contract 的测试专用边界，移除生产构建里的 unused import / dead code 噪音，并把 API Key 候选解密失败降为 debug，避免启动阶段无意义 warn 刷屏。

2. Evidence Pack 与 Replay

• Evidence Pack 可导出 audio transcription contract snapshot、transcript 索引、audio output 索引、provider 失败状态与 runtime verification 信息。
• Replay case 可携带 audio_transcription、voice_generation、pdf_extract、browser_control、web_research、text_transform 等合同进入 grader checks。
• Replay 对音频和转写失败做更细分类：可区分 provider failure、缺少输出、缺少 trace、合同不匹配等情况。

3. 文档与路线图

• 新增 AgentUI 路线图文档，覆盖目标架构、代码地图、事件流、时序图、后端协作和实施路线。
• 新增离线语音模型路线图，明确 SenseVoice Small、Fn 听写、模型下载、测试转写和后续 VAD / 历史规划。
• Warp roadmap 补齐 artifact graph、contract schema、acceptance 与 evolution guide，用于多模态 / runtime contract 后续演进。
• Playwright E2E 指南补充真实 GUI 续测约束，继续优先复用稳定桌面 Chrome / Lime 页签。
• AGENTS.md 与执行计划文档同步更新，保留本轮关键决策和验证记录。

已知说明

• SenseVoice Small 当前按需从上游 release 下载；内置清单会记录下载摘要，但上游未在本地清单内提供可信 sha256 时不会声明强校验完成。
• Fn 按住录音当前只作为 macOS 第一刀能力；第三方键盘或缺少系统权限时，用户应继续使用普通语音快捷键。
• audio_transcription 执行器当前只接入 OpenAI-compatible transcription adapter；其他 provider runtime type 仍需要后续补 client。
• 真实联网 web search 测试默认 gated，需要设置 LIME_REAL_API_TEST=1 才会执行。

校验状态

• 已通过：
  • cargo fmt --manifest-path "src-tauri/Cargo.toml" --all
  • npm run format
• npm run verify:app-version（版本一致性检查通过：1.26.0）
  • npm run lint
  • npm run typecheck
  • npm test（44 个 Vitest 批次通过）
  • npm run test:contracts
  • npm run lint:rust（命令通过；仓库仍保留若干既有 Clippy warning，未配置为阻断）
  • cargo test --manifest-path "src-tauri/Cargo.toml" -p voice-core
  • cargo test --manifest-path "src-tauri/Cargo.toml"（主库 1120 项通过，DeepSeek runtime 2 项通过，真实联网 web search 2 项按环境变量门禁 ignored）
  • npm run verify:gui-smoke -- --reuse-running --timeout-ms 600000
• 说明：完整 cargo test 首次因本机磁盘空间不足中断；清理已确认无进程占用的临时 GUI smoke target 后重跑通过。
• GUI 主路径：已复用运行中的 headless Tauri 完成最小冒烟，覆盖 DevBridge、默认 workspace、browser runtime、site adapter、Agent service skill entry 与 runtime tool surface。

---

完整变更: v1.25.0 -> v1.26.0

Lime v1.25.0

Lime v1.25.0

发布日期：2026-04-30

发布概览

• 本次发布目标 tag 为 v1.25.0，重点把 Lime 的语音输入、音频转写、AgentUI 旧会话体验和多模态运行合同推进到同一条 current 主链。
• 版本文件、Tauri 配置、Cargo / npm lockfile、CLI wrapper、浏览器 mock 与 release updater 测试样例已同步到 1.25.0。
• 该版本继续坚持“一个事实源”：语音、音频、转写、任务轻卡、Evidence Pack、Replay 与 GUI 恢复层都消费统一的 runtime contract / task artifact / media task index，而不是新增平行协议。

用户可见更新

1. 离线语音模型与 Fn 听写

• 设置页新增 SenseVoice Small 本地语音模型主链：可查看安装状态、下载模型、删除本地模型、设为默认 ASR、执行 WAV 文件测试转写。
• 本地模型按需下载到 Lime 数据目录，不进入桌面安装包；缺失模型文件时会给出明确引导，不会静默拉取大模型。
• voice-core 接入 sherpa-onnx offline recognizer，支持通过 model.int8.onnx 与 tokens.txt 运行 SenseVoice 本地转写。
• voice_asr_service 新增 SenseVoiceLocal 分支，录音采样率非 16kHz 时会转换为 16kHz mono float samples 后再识别。
• macOS 新增 Fn 按住录音第一刀：按住 Fn 打开语音输入，松开 Fn 停止并转写；Fn 不可用或权限不足时保留普通全局快捷键 fallback。
• 语音设置、快捷键设置、onboarding 语音测试与 ASR Provider UI 已补齐 SenseVoice / Fn 状态展示和回归覆盖。

2. Audio Transcription 转写任务

• @转写 / @transcribe / @Audio Extractor 归并到 audio_transcription 运行合同，入口只作为 binding，不再直接伪造 transcript 事实源。
• 新增 transcription_generate task artifact 主链：任务会写入 contract snapshot、transcript 状态、provider 结果、错误码与统一媒体任务索引。
• 最小 lime-transcription-worker 接入 OpenAI-compatible /audio/transcriptions provider：支持本地 source_path 与远程 source_url，成功后写入 .lime/runtime/transcripts/*。
• 转写失败会保留结构化错误，例如 provider 未配置、source 不可读、provider 请求失败、空 transcript、输出写入失败等；不会退回前端直连 ASR 或普通文件读取。
• 前端转写轻卡和 workspace viewer 可从媒体任务索引恢复完成态或失败态，完成态支持 transcript 文本、语言、输出格式、路径和时间轴信息展示。
• Transcript parser 支持从 verbose JSON、VTT / SRT 内容中恢复分段、时间戳和说话人信息。
• 转写校对产物新增 transcriptCorrection* metadata：保存修订版本时保留原始 transcript 不可变，并记录修订文本、分段数量、说话人数量和来源路径。

3. 音频生成与多模态任务恢复

• audio_generate 与 transcription_generate 继续统一到媒体任务索引，任务轻卡、运行时文档、DevBridge mock 和恢复层消费同一份 artifact。
• 音频预览 runtime 会优先读取统一索引中的 audio output 状态，不再依赖隐藏 task JSON；provider 失败时不会保留旧音频路径或伪造可播放结果。
• TaskMessagePreview、taskPreviewFromToolResult、媒体任务 API 与 mock 输出补齐 audio / transcript 状态字段，减少完成态、失败态、缺 trace 之间的误判。

4. AgentUI 首页、任务中心与旧会话性能

• Agent Chat 首页补齐 Home Start Surface、引导卡、技能卡片、更多技能抽屉、Starter Chips 与稳定回归。
• 新建任务、打开已有会话、任务中心 tab、侧栏会话列表之间的事件链收敛到 taskCenterDraftTaskEvents，减少旧导航和本地 tab 状态双写。
• 旧会话打开继续降载：最近会话首屏请求从大窗口降到 11，任务中心 topics 初始请求降到 21，归档列表也改为可见数量 +1 的哨兵分页。
• 侧栏 hover / focus 旧会话预取延迟到约 900ms，点击时取消未触发预取，避免鼠标扫过列表时抢占正式切换链路。
• 侧栏打开旧会话后，路由追平会在短窗口内去重，避免同一用户意图触发两次 switchTopic / agent_runtime_get_session。
• 旧会话恢复首帧优先正文和输入区，运行轨迹、thread items、queued turns、pending actions 等投影延迟到 idle；正在发送、聚焦 timeline 或存在 A2UI 待处理时不会延迟实时反馈。
• MessageList 继续强化旧会话轻量渲染：历史窗口只先渲染最近消息，timeline 延迟构建，长历史 Markdown 使用轻量预览，Provider / Prompt Cache 配置扫描推迟到首帧后。
• 新增 window.__LIME_AGENTUI_PERF__ 性能采集器，可按 session 汇总 clickToMessageListPaintMs、runtimeGetSessionDurationMs、隐藏历史数量、最终渲染消息数量和可用堆内存指标。

5. Browser Assist 与工作区展示

• Browser Assist renderer 增强运行结果展示，支持更清晰地呈现浏览器会话、页面、操作结果与可恢复状态。
• Workspace 的音频任务预览、转写任务预览、图片任务预览和 general workbench 恢复逻辑进一步对齐 task artifact / media index 事实源。
• Inputbar 与消息渲染继续收紧多模态、运行态、队列态和任务文件展示，减少过程信息污染最终正文。

6. Provider、模型能力与设置体验

• API Key Provider 设置页补齐 provider 配置、模型能力和 Prompt Cache 相关展示与回归。
• OpenAI-compatible provider 和 credential bridge 增强，为音频转写、模型能力推断和 provider 解析提供更稳定的后端事实源。
• LimeHub local dev models 与本地 provider 模型列表同步更新，减少设置页和运行时模型认知漂移。
• 外观配色扩展：在原有配色基础上新增 霓虹、青柠、暮色、极简、鲜活、文学、奢华 等主题，并调整现有配色名称与描述。

开发者与治理更新

1. 运行合同与治理校验

• modalityRuntimeContracts 新增 / 更新 audio_transcription，并同步 Rust 合同常量、前端 registry、mock 和校验脚本。
• 新增 modalityArtifactGraph.json，把 entry binding、executor binding、artifact、viewer 和 evidence / replay 关系显式化。
• scripts/check-modality-runtime-contracts.mjs 扩展校验范围，覆盖 capability、model role、artifact kind、artifact graph 与 current contract 同步关系。
• npm run test:contracts 现在覆盖 agent runtime client 生成检查、命令契约、harness 契约、modality contracts 与 cleanup report contract。

2. Evidence Pack 与 Replay

• Evidence Pack 可导出 audio transcription contract snapshot、transcript 索引、audio output 索引、provider 失败状态与 runtime verification 信息。
• Replay case 可携带 audio_transcription、voice_generation、pdf_extract、browser_control、web_research、text_transform 等合同进入 grader checks。
• Replay 对音频和转写失败做更细分类：可区分 provider failure、缺少输出、缺少 trace、合同不匹配等情况。

3. 文档与路线图

• 新增 AgentUI 路线图文档，覆盖目标架构、代码地图、事件流、时序图、后端协作和实施路线。
• 新增离线语音模型路线图，明确 SenseVoice Small、Fn 听写、模型下载、测试转写和后续 VAD / 历史规划。
• Warp roadmap 补齐 artifact graph、contract schema、acceptance 与 evolution guide，用于多模态 / runtime contract 后续演进。
• Playwright E2E 指南补充真实 GUI 续测约束，继续优先复用稳定桌面 Chrome / Lime 页签。
• AGENTS.md 与执行计划文档同步更新，保留本轮关键决策和验证记录。

已知说明

• SenseVoice Small 当前按需从上游 release 下载；内置清单会记录下载摘要，但上游未在本地清单内提供可信 sha256 时不会声明强校验完成。
• Fn 按住录音当前只作为 macOS 第一刀能力；第三方键盘或缺少系统权限时，用户应继续使用普通语音快捷键。
• audio_transcription 执行器当前只接入 OpenAI-compatible transcription adapter；其他 provider runtime type 仍需要后续补 client。
• 真实联网 web search 测试默认 gated，需要设置 LIME_REAL_API_TEST=1 才会执行。

校验状态

• 已通过：
  • cargo fmt --manifest-path "src-tauri/Cargo.toml" --all
  • npm run format
  • npm run verify:app-version（版本一致性检查通过：1.25.0）
  • npm run lint
  • npm run typecheck
  • npm test（44 个 Vitest 批次通过）
  • npm run test:contracts
  • npm run lint:rust（命令通过；仓库仍保留若干既有 Clippy warning，未配置为阻断）
  • cargo test --manifest-path "src-tauri/Cargo.toml" -p voice-core
  • cargo test --manifest-path "src-tauri/Cargo.toml"（主库 1120 项通过，DeepSeek runtime 2 项通过，真实联网 web search 2 项按环境变量门禁 ignored）
  • npm run verify:gui-smoke -- --reuse-running --timeout-ms 600000
• 说明：完整 cargo test 首次因本机磁盘空间不足中断；清理已确认无进程占用的临时 GUI smoke target 后重跑通过。
• GUI 主路径：已复用运行中的 headless Tauri 完成最小冒烟，覆盖 DevBridge、默认 workspace、browser runtime、site adapter、Agent service skill entry 与 runtime tool surface。

---

完整变更: v1.24.0 -> v1.25.0

Lime v1.24.0

Lime v1.24.0

发布日期：2026-04-30

发布概览

• 本次发布目标 tag 为 v1.24.0。
• 本次发布聚焦多模态运行合同底座、Browser / PDF / Voice / Research / Text Transform 合同闭环、任务中心与旧会话打开体验、工作台首页技能入口，以及版本发布配置同步。
• 本轮待递交内容覆盖 Rust 后端、Tauri 配置、前端 Agent Workspace / Home / Settings / Provider / DevBridge、治理合同 registry、测试覆盖、版本锁文件、图片素材与执行计划文档。

重点更新

1. 版本号同步到 v1.24.0

• 应用版本已同步为 1.24.0：
  • package.json
  • package-lock.json
  • src-tauri/Cargo.toml
  • src-tauri/Cargo.lock
  • src-tauri/tauri.conf.json
  • src-tauri/tauri.conf.headless.json
• packages/lime-cli-npm/package.json 与 packages/lime-cli-npm/README.md 已同步到 1.24.0，保持 CLI wrapper 与桌面 release 版本一致。
• 浏览器模式默认 mock 的 update current version 已同步为 1.24.0。
• GitHub release asset staging 测试中的当前发布样例已同步到 v1.24.0。

2. 多模态运行合同底座

• 新增并扩展 ModalityRuntimeContract 前端 registry 与 Rust 侧合同常量，统一 image_generation、browser_control、pdf_extract、voice_generation、web_research、text_transform 六类底层运行合同。
• scripts/check-modality-runtime-contracts.mjs 与 npm run governance:modality-contracts 继续作为合同 registry 的机器校验入口，保护 contract key、entry binding、executor binding 与 metadata path 不漂移。
• 图片生成任务、媒体任务 API、DevBridge mock 与治理目录册同步合同字段，避免入口层直接拥有底层 task / model / artifact / evidence 事实源。
• docs/roadmap/warp/contract-schema.md 与 docs/exec-plans/multimodal-runtime-contract-plan.md 更新合同 schema、执行阶段与 current / compat / deprecated / dead 分类。

3. Browser / PDF / Voice / Research / Text Transform 合同闭环

• @浏览器 / Browser Assist 发送链路注入 browser_control 合同快照，Rust 侧保留 Browser Assist runtime hint，并把 browser tool timeline metadata 纳入 evidence / replay。
• @读PDF 入口收敛到 pdf_extract 合同，前端 metadata、Rust prompt 准备、Skill(pdf_read) timeline、evidence pack 与 replay 检查保持同一份合同事实源。
• @配音 服务型入口收敛到 voice_generation 合同，ServiceSkill / voice runtime 的 request metadata、timeline args 与 replay grader 统一识别音频运行证据。
• @搜索、@深搜、@站点搜索、@研报、@竞品 统一归入 web_research 合同，并补齐 evidence snapshotIndex，让联网研究可以按 contract/source/routing/tool trace 检索。
• @读文件、@总结、@翻译、@分析、@发布合规、@Logo拆解 统一归入 text_transform 合同，禁止回退为前端直出、ToolSearch / WebSearch 或普通聊天摘要。

4. Evidence Pack / Replay / Task Runtime

• runtime_evidence_pack_service 与 runtime_replay_case_service 扩展多模态合同快照、索引、expected checks 与 grader 规则，回放样本能判断是否真实命中对应 executor trace。
• 媒体 runtime 与 media_task_cmd 补齐合同字段归一化、能力缺口提示、artifact payload 与任务预览字段。
• 前端 agentRuntime media/session 类型、mediaTasks API、ImageTask viewer 与工作台预览 runtime 同步消费合同字段，减少 viewer 自行猜测 artifact 类型。
• modalityRuntimeContracts 的前端/Rust 双侧测试覆盖合同解析、fallback 与 mock 分发，保持浏览器模式不是假绿。

5. 工作台首页、任务中心与旧会话体验

• Agent Chat 新增 Home Start Surface、技能卡片画廊、更多技能抽屉与场景技能管理弹窗，并提交对应 home cover 素材。
• EmptyState / Workspace / AppSidebar 接入新的首页入口、补充快捷入口与任务中心事件桥，一级“新建任务”与会话侧栏切换保持可取消草稿语义。
• 旧会话打开性能继续收口：首屏优先最近消息、timeline 延后物化、历史消息与流式 delta overlap 合并，降低旧会话切换卡顿与布局跳动。
• MessageList / Team Workspace / Workspace Send Actions 增补回归，覆盖新建草稿、旧会话切换、图片任务预览和合同 metadata 发送。

6. Provider / 设置页 / 云端能力边界

• Provider 与 API Key 设置页进一步收口模型能力、Prompt Cache、云端套餐 / 权益 / API Key 展示口径，避免本地设置页重新承载用户中心商业工作台。
• OEM cloud access、LimeHub provider sync、model registry service 与 provider list 工具函数补齐测试，保护登录态、权益摘要、模型支持和 provider capability 展示。
• withI18nPatch、Settings Provider 页面与相关 hooks 做格式化和回归更新，保持当前设置入口与 mock / Rust 模型事实源一致。

待递交范围确认

• 版本与发布：版本文件、lockfile、Tauri 配置、CLI wrapper、release updater 测试样例与 release notes。
• Rust 主链：多模态合同、媒体任务、Browser Assist、PDF / Research / Summary / Translation / Analysis / ServiceSkill launch、evidence pack、replay case、model registry。
• 前端主链：Agent Chat Workspace、Home Start Surface、MessageList、ImageTask Viewer、任务中心事件桥、Settings Provider、API Key Provider、DevBridge、tauri mock。
• 治理与文档：modalityRuntimeContracts registry / 校验脚本、Warp contract schema、执行计划与旧会话性能计划。
• 素材与测试：home cover 素材、新增/更新的 Vitest、Rust 回归与治理合同测试。

校验状态

• 已执行：
  • cargo fmt --manifest-path "src-tauri/Cargo.toml" --all
  • npm run format
  • npm run verify:app-version
  • cargo test --manifest-path "src-tauri/Cargo.toml" --target-dir "src-tauri/target/codex-release-v124"
  • cargo clippy --manifest-path "src-tauri/Cargo.toml" --target-dir "src-tauri/target/codex-release-v124" --all-targets --all-features
  • npm run lint
  • npm test
  • npm run test:contracts
  • npm run verify:gui-smoke
  • git diff --check
• 结果：上述校验均已通过；cargo test 结果为 1103 passed; 0 failed; 0 ignored，另有 2 个真实联网测试按预期 ignored。
• 备注：cargo clippy 仍保留既有 warning（manual_repeat_n、too_many_arguments、needless_lifetimes），本轮未扩大 warning 面。
• GUI 主路径：npm run verify:gui-smoke 已通过，覆盖 DevBridge、默认 workspace、browser runtime、site adapter catalog、服务技能入口与 runtime tool surface 页面烟测。

---

完整变更: v1.23.0 -> v1.24.0

Lime v1.23.0

Lime v1.23.0

发布日期：2026-04-29

发布概览

• 本次发布目标 tag 为 v1.23.0。
• 本次发布聚焦稳定版 GitHub Release / R2 分发链路收口、lime-cli 独立产物发布、Provider / Credential 旧路径清退、云端用户中心商业边界收口，以及 Agent 会话恢复与模型选择体验稳定性。
• 本轮待递交内容覆盖 Rust 后端、Tauri 配置、发布工作流、release asset 脚本、Provider / Model / Credential 治理、前端 Workspace / Settings / Provider API Key 主路径、测试覆盖、版本锁文件与执行计划文档。

重点更新

1. 版本号同步到 v1.23.0

• 应用版本已同步为 1.23.0：
  • package.json
  • package-lock.json
  • src-tauri/Cargo.toml
  • src-tauri/Cargo.lock
  • src-tauri/tauri.conf.json
  • src-tauri/tauri.conf.headless.json
• packages/lime-cli-npm/package.json 与 packages/lime-cli-npm/README.md 已同步到 1.23.0，保持 CLI wrapper 与桌面 release 版本一致。
• 浏览器模式默认 mock 的 update current version 已同步为 1.23.0。
• GitHub release asset staging 测试中的当前发布样例已同步到 v1.23.0。

2. 稳定版发布与 R2 分发链路

• .github/workflows/release.yml 将桌面应用构建、GitHub Release 资产发布、R2 updater 发布和 lime-cli 资产发布拆成更清晰的阶段。
• 新增 scripts/prepare-github-release-assets.mjs，在上传 GitHub Release 前统一整理资产名，避免 macOS Lime.app.tar.gz / .sig 同名跨架构冲突。
• GitHub Release 上传改为使用 release-github-assets 暂存目录，并在资产上传后显式发布 release、标记 latest。
• R2 updater 发布改为独立 job，从 GitHub Release 或 RELEASE_NOTES.md 准备 updater release notes，再生成稳定版 manifest。
• Cloudflare R2 上传 / 列表 / 删除命令补齐 --remote，并在 wrangler 不支持 r2 object list 时跳过旧版本清理而不是阻塞发布。
• lime-cli release binary 与 npm wrapper 资产改为独立矩阵 job 发布，保留 macOS / Windows / Linux CLI 产物，不再耦合桌面安装包矩阵。

3. Provider / Credential 旧路径清退

• 清退旧 Provider Pool 页面、凭证卡片、Credential 表单、OAuth / Kiro / Antigravity / Claude OAuth / usage 等旧命令与服务路径。
• Rust 后端删除旧 credential crate、provider pool DAO / service、Kiro credential handler、旧 provider converter / translator / fingerprint 模型等 dead surface。
• 前端保留当前 API Key Provider 设置主路径，并继续收口模型启用、模型能力、Prompt Cache 与 companion provider 概览口径。
• agentCommandCatalog、legacySurfaceCatalog、DevBridge mock 与相关测试同步更新，避免已删除命令继续作为 current surface 出现。
• 模型资源索引删除旧 Antigravity / Kiro / Codex alias/provider 静态入口，减少 provider 真相源分叉。

4. Agent 会话恢复与工作台稳定性

• 会话切换 / 恢复详情默认按 historyLimit: 40 拉取近期历史，完整历史加载仍通过显式 historyLimit: 0 入口完成。
• useAsterAgentChat 回归断言已同步新的 session detail 拉取参数，覆盖 stop refresh、timeline cache hydrate、workspace guard 与 stale 快照刷新路径。
• 工作台消息流、模型选择、Provider selector、Team Workspace、artifact / saved content 展示继续保持与 runtime execution metadata 对齐。
• ModelSelector、useConfiguredProviders、useProviderModels、Prompt Cache 支持判断与 companion provider overview 补齐回归覆盖。

5. 云端用户中心与商业边界

• 新增 docs/exec-plans/cloud-commerce-user-center-boundary.md，明确套餐购买、支付、账单、用量明细统一收敛到 limecore 用户中心网页。
• Lime 客户端云端服务设置面继续收口为会话状态、当前套餐、积分余额、待支付提醒与用户中心跳转入口。
• 客户端移除直接创建套餐 / 充值订单的旧处理面，避免本地商业工作台与用户中心形成双轨。
• useOemCloudAccess 与 OEM cloud / LimeHub provider 同步测试继续覆盖登录态、权益摘要、API Key 与回跳刷新路径。

6. 文档、治理与回归

• docs/aiprompts/ 下 Provider、Credential Pool、Services、Hooks、Components、Overview 等导航文档同步当前 provider / credential / model registry 事实源。
• docs/content/03.providers/1.overview.md 与 src/components/api-key-provider/README.md 更新当前 Provider 配置入口说明。
• scripts/release-updater-manifest.test.mjs 增加 GitHub release asset staging 覆盖，保护 macOS 同名 updater bundle 重命名逻辑。
• src-tauri/proptest-regressions/ 已纳入本轮待递交范围，保留 property test 回归种子。

待递交范围确认

• 版本与发布：版本文件、lockfile、Tauri 配置、CLI wrapper、release workflow、GitHub release asset staging 脚本与测试。
• Rust 主链：Provider / Credential / Server / Services / Agent / DevBridge / model registry / router / websocket 相关 current surface 收口。
• 前端主链：Agent Chat Workspace、MessageList、ModelSelector、Settings Provider、API Key Provider、Provider hooks、mock 与治理目录册。
• 商业边界：云端用户中心执行计划、OEM cloud access / LimeHub provider sync、设置页云端服务入口。
• 验证与治理：新增/更新测试、legacy catalog、release updater contract、删除旧 Provider Pool / credential / Kiro / Antigravity 等 dead surface。

校验状态

• 已通过：
  • npm run verify:app-version
  • cargo fmt --manifest-path "src-tauri/Cargo.toml" --all
  • cargo test --manifest-path "src-tauri/Cargo.toml" --target-dir "src-tauri/target/codex-release-v123" — 1085 passed / 0 failed / 2 ignored
  • cargo clippy --manifest-path "src-tauri/Cargo.toml" --target-dir "src-tauri/target/codex-release-v123" --all-targets --all-features
  • npm run lint
  • npm test — 43 个 Vitest smart 批次通过
  • npm run test:contracts
  • git diff --check
• cargo clippy 通过，当前存在 5 条预存 warning：
  • crates/services/src/aster_session_store.rs 的 manual_repeat_n
  • crates/skills/src/lime_llm_provider.rs 的 2 处 too_many_arguments
  • crates/agent/src/request_tool_policy.rs 的 too_many_arguments
  • crates/agent/src/session_execution_runtime.rs 的 needless_lifetimes
• GUI 主路径未额外执行 npm run verify:gui-smoke；本轮发布收口以版本、发布链路、Provider / Credential 治理和前端 / Rust 回归为主要风险覆盖。

---

完整变更: v1.22.0 -> v1.23.0

Lime v1.22.0

Lime v1.22.0

发布日期：2026-04-29

发布概览

• 本次发布目标 tag 为 v1.22.0。
• 本次发布聚焦稳定版 GitHub Release / R2 分发链路收口、lime-cli 独立产物发布、Provider / Credential 旧路径清退、云端用户中心商业边界收口，以及 Agent 会话恢复与模型选择体验稳定性。
• 本轮待递交内容覆盖 Rust 后端、Tauri 配置、发布工作流、release asset 脚本、Provider / Model / Credential 治理、前端 Workspace / Settings / Provider API Key 主路径、测试覆盖、版本锁文件与执行计划文档。

重点更新

1. 版本号同步到 v1.22.0

• 应用版本已同步为 1.22.0：
  • package.json
  • package-lock.json
  • src-tauri/Cargo.toml
  • src-tauri/Cargo.lock
  • src-tauri/tauri.conf.json
  • src-tauri/tauri.conf.headless.json
• packages/lime-cli-npm/package.json 与 packages/lime-cli-npm/README.md 已同步到 1.22.0，保持 CLI wrapper 与桌面 release 版本一致。
• 浏览器模式默认 mock 的 update current version 已同步为 1.22.0。
• GitHub release asset staging 测试中的当前发布样例已同步到 v1.22.0。

2. 稳定版发布与 R2 分发链路

• .github/workflows/release.yml 将桌面应用构建、GitHub Release 资产发布、R2 updater 发布和 lime-cli 资产发布拆成更清晰的阶段。
• 新增 scripts/prepare-github-release-assets.mjs，在上传 GitHub Release 前统一整理资产名，避免 macOS Lime.app.tar.gz / .sig 同名跨架构冲突。
• GitHub Release 上传改为使用 release-github-assets 暂存目录，并在资产上传后显式发布 release、标记 latest。
• R2 updater 发布改为独立 job，从 GitHub Release 或 RELEASE_NOTES.md 准备 updater release notes，再生成稳定版 manifest。
• Cloudflare R2 上传 / 列表 / 删除命令补齐 --remote，并在 wrangler 不支持 r2 object list 时跳过旧版本清理而不是阻塞发布。
• lime-cli release binary 与 npm wrapper 资产改为独立矩阵 job 发布，保留 macOS / Windows / Linux CLI 产物，不再耦合桌面安装包矩阵。

3. Provider / Credential 旧路径清退

• 清退旧 Provider Pool 页面、凭证卡片、Credential 表单、OAuth / Kiro / Antigravity / Claude OAuth / usage 等旧命令与服务路径。
• Rust 后端删除旧 credential crate、provider pool DAO / service、Kiro credential handler、旧 provider converter / translator / fingerprint 模型等 dead surface。
• 前端保留当前 API Key Provider 设置主路径，并继续收口模型启用、模型能力、Prompt Cache 与 companion provider 概览口径。
• agentCommandCatalog、legacySurfaceCatalog、DevBridge mock 与相关测试同步更新，避免已删除命令继续作为 current surface 出现。
• 模型资源索引删除旧 Antigravity / Kiro / Codex alias/provider 静态入口，减少 provider 真相源分叉。

4. Agent 会话恢复与工作台稳定性

• 会话切换 / 恢复详情默认按 historyLimit: 40 拉取近期历史，完整历史加载仍通过显式 historyLimit: 0 入口完成。
• useAsterAgentChat 回归断言已同步新的 session detail 拉取参数，覆盖 stop refresh、timeline cache hydrate、workspace guard 与 stale 快照刷新路径。
• 工作台消息流、模型选择、Provider selector、Team Workspace、artifact / saved content 展示继续保持与 runtime execution metadata 对齐。
• ModelSelector、useConfiguredProviders、useProviderModels、Prompt Cache 支持判断与 companion provider overview 补齐回归覆盖。

5. 云端用户中心与商业边界

• 新增 docs/exec-plans/cloud-commerce-user-center-boundary.md，明确套餐购买、支付、账单、用量明细统一收敛到 limecore 用户中心网页。
• Lime 客户端云端服务设置面继续收口为会话状态、当前套餐、积分余额、待支付提醒与用户中心跳转入口。
• 客户端移除直接创建套餐 / 充值订单的旧处理面，避免本地商业工作台与用户中心形成双轨。
• useOemCloudAccess 与 OEM cloud / LimeHub provider 同步测试继续覆盖登录态、权益摘要、API Key 与回跳刷新路径。

6. 文档、治理与回归

• docs/aiprompts/ 下 Provider、Credential Pool、Services、Hooks、Components、Overview 等导航文档同步当前 provider / credential / model registry 事实源。
• docs/content/03.providers/1.overview.md 与 src/components/provider-pool/api-key/README.md 更新当前 Provider 配置入口说明。
• scripts/release-updater-manifest.test.mjs 增加 GitHub release asset staging 覆盖，保护 macOS 同名 updater bundle 重命名逻辑。
• src-tauri/proptest-regressions/ 已纳入本轮待递交范围，保留 property test 回归种子。

待递交范围确认

• 版本与发布：版本文件、lockfile、Tauri 配置、CLI wrapper、release workflow、GitHub release asset staging 脚本与测试。
• Rust 主链：Provider / Credential / Server / Services / Agent / DevBridge / model registry / router / websocket 相关 current surface 收口。
• 前端主链：Agent Chat Workspace、MessageList、ModelSelector、Settings Provider、API Key Provider、Provider hooks、mock 与治理目录册。
• 商业边界：云端用户中心执行计划、OEM cloud access / LimeHub provider sync、设置页云端服务入口。
• 验证与治理：新增/更新测试、legacy catalog、release updater contract、删除旧 Provider Pool / credential / Kiro / Antigravity 等 dead surface。

校验状态

• 已通过：
  • npm run verify:app-version
  • cargo fmt --manifest-path "src-tauri/Cargo.toml" --all
  • cargo test --manifest-path "src-tauri/Cargo.toml" — 1070 passed / 0 failed / 2 ignored
  • cargo clippy --manifest-path "src-tauri/Cargo.toml" --all-targets --all-features
  • npm run lint
  • npx vitest run "src/components/agent/chat/hooks/useAsterAgentChat.test.tsx"
  • npm test — 43 个 Vitest smart 批次通过
  • npm run test:contracts
  • git diff --check
• cargo test 通过，当前存在 1 条预存 warning：
  • write_auxiliary_runtime_projection_fixture 的 dead_code
• cargo clippy 通过，当前存在 6 条 warning：
  • crates/services/src/aster_session_store.rs 的 manual_repeat_n
  • crates/skills/src/lime_llm_provider.rs 的 2 处 too_many_arguments
  • crates/agent/src/request_tool_policy.rs 的 too_many_arguments
  • crates/agent/src/session_execution_runtime.rs 的 needless_lifetimes
  • src/services/runtime_evidence_pack_service.rs 的 dead_code
• GUI 主路径未额外执行 npm run verify:gui-smoke；本轮发布收口以版本、发布链路、Provider / Credential 治理和前端 / Rust 回归为主要风险覆盖。

---

完整变更: v1.21.0 -> v1.22.0

Lime v1.21.0

Lime v1.21.0

发布日期：2026-04-28

发布概览

• 本次发布目标 tag 为 v1.21.0。
• 本次发布聚焦稳定版自动更新与 R2 分发链路、OEM 云端商业闭环、工作台首页与侧栏体验、资源管理器、Provider 模型管理收口、主题外观与设置页更新。
• 本轮待递交内容覆盖 Rust 后端、Tauri update command、DevBridge / mock、发布工作流、前端 Workspace / Settings / Provider Pool / Resource Manager、测试覆盖、版本锁文件与临时产物清理。

重点更新

1. 稳定版更新与 R2 发布链路

• .github/workflows/release.yml 补齐稳定版 updater 发布门禁，要求签名密钥与更新地址就绪后再生成 updater artifacts。
• 发布流程会规范化 Tauri updater 公钥，并在仅产出 sidecar .sig 时由发布脚本生成稳定版 latest.json。
• 新增 scripts/release-updater-manifest.mjs，聚合各平台 latest.json，生成统一 latest.json、版本化清单、R2 上传计划与 manifest metadata。
• 新增 scripts/plan-r2-release-cleanup.mjs，按稳定版本窗口规划旧 R2 updater 产物清理，避免发布桶无限增长。
• scripts/release-updater-manifest.test.mjs 覆盖平台缺失、版本不匹配、同名跨平台 artifact 与旧版本清理保护逻辑。
• src-tauri/src/commands/update_cmd.rs 与 src-tauri/crates/services/src/update_check_service.rs 切到静态清单检查 + Tauri updater 安装主链，并补齐 semver 比较与缓存兜底。

2. 版本号同步到 v1.21.0

• 应用版本已同步为 1.21.0：
  • package.json
  • package-lock.json
  • src-tauri/Cargo.toml
  • src-tauri/Cargo.lock
  • src-tauri/tauri.conf.json
  • src-tauri/tauri.conf.headless.json
• packages/lime-cli-npm/package.json 与 packages/lime-cli-npm/README.md 已同步到 1.21.0，保持 CLI wrapper 与桌面 release 版本一致。
• 浏览器模式默认 mock 的 update current version 已同步为 1.21.0。

3. OEM 云端商业闭环

• 新增 src/lib/oemCloudPaymentReturn.ts，统一生成、解析、暂存并分发 lime://payment/return 支付回跳事件。
• useDeepLink 识别支付回跳 deep link，直接分发云端商业刷新事件，不再走旧 handle_deep_link 命令分支。
• useOemCloudAccess 接入云端激活、支付配置、套餐订单、充值订单、账本、积分余额与访问令牌刷新主链。
• 套餐购买和积分充值 checkout 支持 HTTPS bridge 回跳 URL，支付完成后自动刷新云端权益、积分余额与订单 watcher。
• docs/exec-plans/oem-cloud-commerce-loop-progress.md 记录当前阶段、已清退的旧支付配置入口与下一轮真实渠道沙箱验证计划。

4. 工作台首页、侧栏与导航体验

• AppSidebar 增加最近对话 / 归档会话架、分页加载、归档切换、外观切换、账户菜单与折叠态细节。
• 新增 src/components/app-sidebar/AppSidebarConversationShelf.tsx，把会话架从侧栏主体中拆出，降低侧栏单体复杂度。
• 工作台首页空态升级为“先开始这一轮 / 继续这轮 / 直接开工”入口，强化任务起手、推荐模板与继续上下文。
• Workspace / Task Center / ChatNavbar / Inputbar / EmptyState / Team Workspace 等主路径继续收口视觉状态、运行时状态与回归断言。
• src/lib/windowControls.ts、窗口 chrome 与主窗口启动链路继续补齐 macOS / headless 场景下的窗口控制一致性。

5. 资源管理器

• 新增 src/features/resource-manager/，提供资源管理器页面、侧栏、工具栏、预览面板、Inspector、搜索与导航意图。
• 支持图片、文本、Markdown、PDF、Office、音视频、数据文件、压缩包与系统委托类型的分层预览渲染。
• 支持资源下载、复制、系统打开、Finder 揭示、聊天位置与项目资源上下文回跳。
• 补齐 ResourceManagerPage、资源预览搜索、会话状态和导航意图测试。

6. Provider Pool 与设置页收口

• Provider 模型管理改为“启用的模型”左侧列表 + 添加模型面板，删除旧 API Key 列表 / Provider 表单 / 模型列表拆分组件。
• 新增 ModelProviderList、ModelAddPanel、providerConfigUtils 与连接测试类型，统一 Provider 配置工具函数与 UI 入口。
• 设置页 Provider、About、Developer、Experimental、Appearance、Channels 与 Automation 页面继续收口布局、状态展示和回归断言。
• Prompt Cache 与 Anthropic-compatible 能力口径更新，避免把显式 cache_control 能力误显示为自动缓存。

7. App Update 前端与 mock

• src/lib/api/appUpdate.ts 扩展 release notes URL / pubDate / 错误信息字段。
• src/lib/tauri-mock/core.ts 补齐 check_update、check_for_updates 与下载无更新态 mock，浏览器模式不再落入 unknown command。
• About 设置页更新检查、下载失败、诊断错误和版本展示补齐测试覆盖。

8. 文档、治理与临时产物

• README.md 更新产品定位文案：从“本地优先的 AI API Proxy 桌面应用”收敛为 AI Agent 创作工作台。
• src/lib/governance/legacySurfaceCatalog.json 与测试补充新的 legacy surface 口径。
• 删除根目录临时调试产物：monitor.sh、network-before.md、post-hmr-state.png、tmp-e2e-home.png、knip.governance.json。
• 新增 theme-scope-messages-ocean.png 作为本轮主题视觉验证产物。

待递交范围确认

• 版本与发布：版本文件、lockfile、CLI wrapper、release workflow、R2 updater manifest / cleanup 脚本与测试。
• Rust 主链：update command、update service、window chrome、runner/app 模块、DevBridge dispatcher、tray 事件与菜单处理。
• 前端主链：AppSidebar、Workspace、Task Center、EmptyState、Inputbar、Team Workspace、Settings、Provider Pool、Resource Manager、MCP、Memory、SceneApps、Resources。
• 商业闭环：OEM cloud control plane API、支付回跳 deep link、权益 / 积分 / 账本刷新、订单 watcher 与执行计划文档。
• 验证与治理：新增/更新测试、legacy catalog、release updater contract、删除临时调试文件与旧 Provider Pool 组件。

校验状态

• 已通过：
  • npm run verify:app-version
  • cargo fmt --manifest-path "src-tauri/Cargo.toml" --all
  • cargo test --manifest-path "src-tauri/Cargo.toml" — 1112 passed / 0 failed / 2 ignored
  • cargo clippy --manifest-path "src-tauri/Cargo.toml" --all-targets --all-features
  • npm run lint
  • npm test — 44 个 Vitest smart 批次通过
  • npm run test:contracts
  • npm run smoke:agent-runtime-tool-surface
  • npm run smoke:agent-runtime-tool-surface-page
  • git diff --check
• cargo test 通过，当前存在 1 条预存 warning：
  • write_auxiliary_runtime_projection_fixture 的 dead_code
• cargo clippy 通过，当前存在 4 条预存 warning：
  • crates/services/src/aster_session_store.rs 的 manual_repeat_n
  • crates/skills/src/lime_llm_provider.rs 的 too_many_arguments
  • crates/agent/src/session_execution_runtime.rs 的 needless_lifetimes
  • src/services/runtime_evidence_pack_service.rs 的 dead_code
• GUI 主路径补充复测已通过：smoke:agent-runtime-tool-surface 与 smoke:agent-runtime-tool-surface-page 均确认 Harness 入口在执行态可见，修复此前等待 Harness 按钮超时的问题。

---

完整变更: v1.20.0 -> v1.21.0

Lime v1.20.0

Lime v1.20.0

发布日期：2026-04-26

发布概览

• 本次发布目标 tag 为 v1.20.0。
• 本次发布聚焦工作台（Workbench）入口上线、会话管理增强、技能选择器优化、数据库性能提升，以及大量测试覆盖补充。
• 涉及 106+ 文件变更，约 7800 行新增，覆盖 Rust 后端、前端组件、工具函数与测试。

重点更新

1. 工作台（Workbench）入口上线

• 侧边栏新增「工作台」导航项，支持通过 buildClawAgentParams 进入 Claw Agent 工作台模式 (sidebarNav.ts, AppSidebar.tsx)
• 新增 sessionIdentity.ts，提供辅助 Agent 会话识别能力 (sessionIdentity.ts)
• WorkspaceShellScene 支持归档会话打开回调 (WorkspaceShellScene.tsx)

2. 新增 Workbench 技能命令

• 新增文件阅读工作台命令：fileReadWorkbenchCommand (fileReadWorkbenchCommand.ts)
• 新增增长分析工作台命令：growthWorkbenchCommand (growthWorkbenchCommand.ts)
• 新增 Logo 分解工作台命令：logoDecompositionWorkbenchCommand (logoDecompositionWorkbenchCommand.ts)
• 新增写作工作台命令：writingWorkbenchCommand (writingWorkbenchCommand.ts)

3. 会话管理增强

• 会话列表支持归档筛选、工作目录过滤与分页加载 (session_runtime.rs, agent.rs)
• 新增 SessionArchiveFilter 枚举，支持灵活的归档会话查询 (agent.rs)
• AsterAgentWrapper::list_sessions_sync 支持 archive_filter、workspace_id、limit 参数 (session_runtime.rs)
• 侧边栏会话列表实现分页加载与"加载更多"机制 (AppSidebar.tsx)
• 会话状态管理支持 allowDetachedCandidate 选项，允许恢复已断开的候选会话 (agentSessionState.ts)
• 初始会话导航支持去重，防止重复导航 (useWorkspaceInitialSessionNavigation.ts)

4. Chat 侧栏归档会话支持

• ChatSidebar 新增 onOpenArchivedTopic 回调，支持在 Task Center 打开归档会话 (ChatSidebar.tsx)
• handleOpenTaskItem 根据 section 类型自动路由到归档或常规会话打开逻辑

5. 技能选择器优化

• 优化输入能力分区逻辑 (inputCapabilitySections.ts)
• 改进技能选择绑定配置 (skillSelectionBindings.ts)

6. 数据库性能优化

• 新增 idx_agent_sessions_working_dir_archived_updated_at 复合索引，优化按工作目录和归档状态查询 (schema.rs)
• 新增 idx_agent_sessions_session_type_updated_at 索引，优化按会话类型查询 (schema.rs)
• Agent 会话仓储支持新的查询参数 (agent_session_repository.rs)

7. 测试覆盖大幅补充

• 新增/更新 42 个测试文件，约 3185 行测试代码
• 覆盖工作台命令、会话状态、侧栏导航、技能选择、Workspace 导航等核心模块
• seededCommandPackage.test.ts 大幅扩展测试用例

8. 其他改进

• 导航偏好配置更新 (preferences.ts)
• 命令清单 schema 同步更新 (agentRuntimeCommandSchema.json)
• 会话客户端与类型定义完善 (sessionClient.ts, types.ts)
• Agent API 测试补充 (agent.test.ts)
• limenext-progress.md 进度日志同步更新

9. 测试修复

• 修复 runtime_project_hooks 中 persist_session_access_mode 测试用例，解决测试 DB 与全局 LimeSessionStore DB 不一致导致 recent_access_mode 无法正确读取的问题 (runtime_project_hooks.rs)
• 测试修复后直接写入 extension_data 和测试消息到测试 DB，确保 get_runtime_session_detail 能正常构建 execution_runtime

版本同步

• 应用版本已同步为 1.20.0：
  • package.json
  • src-tauri/Cargo.toml
  • src-tauri/tauri.conf.json
  • src-tauri/tauri.conf.headless.json

校验状态

• 本会话已实际执行并通过：
  • cargo fmt --manifest-path "src-tauri/Cargo.toml" --all
  • cargo test --manifest-path "src-tauri/Cargo.toml" — 1089 passed / 0 failed / 0 ignored
  • cargo clippy --manifest-path "src-tauri/Cargo.toml" --all-targets --all-features
  • npm run lint
• cargo clippy 通过，当前存在 2 条预存 warning：
  • crates/skills/src/lime_llm_provider.rs 的 too_many_arguments
  • src/services/runtime_evidence_pack_service.rs 的 dead_code

---

完整变更: v1.19.0 -> v1.20.0

Lime v1.19.0

Lime v1.19.0

发布日期：2026-04-25

发布概览

• 本次发布目标 tag 为 v1.19.0。
• 本说明按当前待递交工作树重新整理，覆盖这次准备一起递交的版本同步、Agent runtime/current surface、聊天工作台布局、Task Center、SceneApp、Memory、automation、bridge、roadmap 文档与现场材料，不再沿用旧版“只写版本号”的简化摘要。
• 本次发布额外吸纳了近期关于人物切换、最新对话容器高度、导航层级精简与工作台展示密度的一组 UI 收口，确保 v1.19.0 对外指向的是当前完整提交状态。

递交范围

• 已跟踪改动主要覆盖：src/ 工作台与业务页面、src-tauri/ runtime 与命令面、docs/ 路线图与执行文档，以及根目录版本/打包文件。
• 未跟踪新增项主要包含：
  • 工作台布局与任务中心相关新文件：TaskCenterTabStrip、chatLayoutVisibility、taskCenterTabs、chatSurfaceProps.test.ts
  • Rust 侧新增服务实现：src-tauri/src/services/runtime_auxiliary_projection_service.rs
  • 一组 Playwright/截图/控制台现场材料，用于保留这批 GUI 调整与回归排查证据
• 本次 release note 继续以“整批递交”视角书写，默认当前工作树中的这些版本、代码、文档和现场材料都属于本轮提交范围。

重点更新

0. 发布同步与提交口径收口

• 根目录应用版本、Tauri 配置、CLI wrapper、Cargo 版本与 release note 统一提升到 1.19.0，避免发布 tag、桌面端版本、npm wrapper 和分发说明继续错位。
• 本说明继续按“当前完整工作树一起递交”的口径整理，明确这次不是单点补版本，而是把当前待提交的 runtime、前端、文档和证据材料统一归档到同一个发布切片。
• 校验章节会同步记录这次实际跑过的 verify:app-version、Rust 校验和前端 lint，方便后续直接作为发布前检查清单引用。

1. Agent runtime、任务层与模型层继续 current 化

• src-tauri/crates/agent/、src-tauri/src/commands/aster_agent_cmd/、src-tauri/src/services/ 与 src/lib/api/agentRuntime/ 继续围绕 session runtime、tool policy、handoff/evidence/replay/review 以及请求模型解析收敛 current surface。
• src-tauri/crates/core/ 与 src-tauri/crates/services/ 继续补齐 agent session 数据层、schema、模型注册和 provider 归一化，减少运行时事实源分叉。
• docs/roadmap/task/、docs/exec-plans/limenext-progress.md 与相关 acceptance/runtime-integration 文档同步更新，把任务层、模型层和交付验收条件继续沉淀为可追踪路线图。

2. 工作台、导航层级与布局展示继续整理

• src/components/agent/chat/components/、workspace/、hooks/ 与 utils/ 大范围调整聊天工作台、导航栏、侧栏、对话区和画布区的布局关系，重点围绕一级导航收敛、人物切换稳定性、最新对话容器高度和页面可视区域利用率继续修正。
• 新增 TaskCenterTabStrip、chatLayoutVisibility、taskCenterTabs 等文件，把任务中心与聊天主视图的布局控制收成更清晰的 current 结构，减少 UI 逻辑散落在多个组件里。
• MessageList、ChatSidebar、ChatNavbar、WorkspaceConversationScene、WorkspaceMainArea、WorkspaceShellScene 及其测试一并更新，确保工作台密度调整不会把最新对话区域挤空、重载或遮挡。

3. SceneApp、Memory、Resources 与设置页继续并行收口

• src/components/sceneapps/、src/components/memory/、src/components/resources/、src/components/skills/、src/components/settings-v2/ 继续同步调整页面结构、结果展示和 follow-up 入口，让工作台新布局和周边页面表达保持一致。
• useSceneAppsPageRuntime.ts、sceneAppExecutionFollowupDestinations.ts、SceneAppExecutionSummaryCard.tsx 与相关测试持续补齐 SceneApp 结果去向、复盘和后续动作表达。
• MemoryPage.tsx、ResourcesPage.tsx、AutomationHealthPanel.tsx、AutomationJob*、ChannelsDebugWorkbench.tsx 等页面也同步纳入这轮整理，避免只有聊天主路径更新、外围页面仍停留在旧密度和旧结构。

4. Bridge、API、mock 与前端事实源同步补齐

• src/lib/dev-bridge/、src/lib/api/、src/lib/governance/、src/lib/tauri-mock/ 与 src-tauri/src/dev_bridge/dispatcher/agent_sessions.rs 等文件继续同步命令契约、前端客户端、mock 与治理目录册，减少 runtime surface 在桌面端和浏览器 fallback 之间继续漂移。
• src/lib/navigation/sidebarNav.ts、src/components/AppSidebar.tsx、src/RootRouter.tsx 等导航事实源同步更新，配合这轮“只保留一级导航”的整理口径。
• src/hooks/useConfiguredProviders.ts、src/lib/serviceModels.ts、src/components/provider-pool/api-key/ProviderConfigForm.tsx 及测试也随之刷新，保证 provider/model 配置与工作台入口描述保持一致。

5. 文档、测试与现场材料继续跟上

• 相关 *.test.tsx / *.test.ts 随工作台、导航、runtime、provider、SceneApp、settings 调整一并更新，保证这批用户可见改动有稳定回归。
• docs/roadmap/task/acceptance.md、runtime-integration.md 与 docs/exec-plans/limenext-progress.md 继续同步当前主线进度和验收口径。
• 截图、快照、console/network 导出等现场材料保留在工作树中，作为这批 GUI 调整和问题复盘的直接证据。

版本同步

• 应用版本事实源已同步为 1.19.0：
  • package.json
  • package-lock.json
  • src-tauri/Cargo.toml
  • src-tauri/tauri.conf.json
  • src-tauri/tauri.conf.headless.json
• 发布与分发相关版本串已同步为 1.19.0：
  • packages/lime-cli-npm/package.json
  • packages/lime-cli-npm/README.md
  • src-tauri/Cargo.lock
  • src-tauri/crates/aster-rust/Cargo.lock
  • src-tauri/crates/aster-rust/crates/aster/tests/mcp_replays/cargorun--quiet-paster-server--binasterd--mcpdeveloper

校验状态

• 本会话已实际执行并通过：
  • npm run verify:app-version
  • cargo fmt --manifest-path "src-tauri/Cargo.toml" --all
  • cargo test --manifest-path "src-tauri/Cargo.toml"
  • cargo clippy --manifest-path "src-tauri/Cargo.toml" --all-targets --all-features
  • npm run lint
• cargo test 实际结果为 1087 passed / 0 failed / 2 ignored；ignored 用例是显式依赖真实联网环境的 real_web_search_*。
• cargo clippy 通过，但当前工作树仍存在 3 条 warning：
  • crates/skills/src/lime_llm_provider.rs 的 too_many_arguments
  • crates/agent/src/session_execution_runtime.rs 的 needless_lifetimes
  • src/services/runtime_evidence_pack_service.rs 的 dead_code

---

完整变更: v1.18.0 -> v1.19.0

Lime v1.18.0

Lime v1.18.0

发布日期：2026-04-24

发布概览

• 本次发布目标 tag 为 v1.18.0。
• 本说明按当前待递交工作树重新整理，覆盖这次准备一起递交的版本同步、Rust/runtime、前端工作台、SceneApp、Memory、automation、bridge、roadmap 文档与 Playwright 复盘材料，不再沿用旧版“只写版本号”的简化摘要。
• 本次重新发布还补充纳入了聊天空态、技能入口、图片预览容错，以及 macOS release workflow 诊断文案修正，确保 v1.18.0 对外指向的是当前完整提交状态。

递交范围

• 已跟踪改动主要分布在：src/ 94 个文件、src-tauri/ 42 个文件、docs/ 6 个文件，以及根目录/版本与打包文件。
• 未跟踪新增项共 27 个，包含：
  • docs/roadmap/task/ 任务层/模型层/经济调度路线图整套专题文档
  • 18 份 Playwright 现场记录与 playwright-network-after-image.json 抓包结果
  • src-tauri/src/dev_bridge/dispatcher/files.rs
  • src/components/agent/chat/hooks/agentSilentTurnRecovery.{ts,test.ts}
  • src/components/agent/chat/utils/saveSceneAppExecutionAsInspiration.{ts,test.ts}
  • src/components/agent/chat/utils/sceneAppExecutionInspirationDraft.{ts,test.ts}
  • src/components/memory/MemoryCuratedTaskSuggestionPanel.tsx
• 本次 release note 以“整批递交”视角书写，默认上述内容均属于本轮提交范围。

重点更新

0. 补充收口：发布前端构建阻断与 release 诊断信息校正

• src/components/agent/chat/components/{EmptyState,ImageTaskViewer}.tsx、src/components/agent/chat/skill-selection/{CharacterMentionPanel,inputCapabilitySections}.ts 与配套测试继续收口聊天空态、技能入口和图片预览体验。
• src/components/provider-pool/api-key/ProviderModelList.tsx 修正 provider 模型来源判断的类型收窄问题，避免 release 构建因前端 TypeScript 报错提前中断。
• ImageTaskViewer.tsx 为补图预览和弹窗预览统一补齐 RenderableTaskImage 的 fallback 渲染，避免新 props 约束下的构建失败。
• .github/workflows/release.yml 将原先误导性的 “macOS notarization failed twice” 兜底报错改成“release build failed before notarized artifact became available”，方便后续直接定位真实前序构建错误，而不是被公证文案误导。

1. Agent runtime、任务层与模型层主线继续 current 化

• src-tauri/crates/agent/src/session_execution_runtime.rs、protocol.rs、provider_safety.rs、credential_bridge.rs，以及 src-tauri/src/commands/aster_agent_cmd/{request_model_resolution,runtime_turn,dto,subagent_runtime}.rs 继续扩展 runtime 路由、任务画像、provider 安全边界、会话上下文与事件投影。
• src-tauri/crates/aster-rust/crates/aster/src/{agents/agent.rs,skills/tool.rs} 与 src-tauri/src/agent/{aster_agent.rs,mod.rs} 同步收敛 current runtime surface，减少 compat 语义继续回流。
• 新增 docs/roadmap/task/README.md 及 overview.md、architecture.md、task-taxonomy.md、model-routing.md、oem-and-local-policy.md、cost-limit-events.md、event-chain.md、runtime-integration.md、diagrams.md、rollout-plan.md、acceptance.md，把任务层、模型层、成本/限额事件与 OEM/本地协同沉淀为专题路线图。

2. 模型路由、媒体运行时与图片任务协议升级

• src-tauri/crates/services/src/model_registry_service.rs、src-tauri/crates/core/src/api_host_utils.rs、src-tauri/src/commands/auxiliary_model_selection.rs 持续补齐模型 taxonomy、host 归一化与服务模型选择主链。
• src-tauri/crates/media-runtime/src/lib.rs、src-tauri/crates/server/src/handlers/image_api_provider.rs、src-tauri/src/commands/media_task_cmd.rs、src-tauri/src/commands/aster_agent_cmd/tool_runtime/{creation_tools,media_cli_bridge}.rs 继续收敛图片任务创建、artifact、执行与桥接协议。
• 本轮额外修正两处图片任务契约漂移：
  • 图片任务 tool schema 不再公开 outputPath，但仍保留 output_path 兼容解析。
  • 图片任务 artifact 内的 storyboard_slots 逐格字段统一按 snake_case 写回，避免 current 文件协议和测试断言继续分叉。
• src-tauri/resources/default-skills/image_generate/SKILL.md 与相关 command/runtime 也同步更新，保持默认技能与当前运行时口径一致。

3. 聊天工作台、图片工作流、SceneApp 与 Memory 继续重构

• src/components/agent/chat/ 大范围更新，涉及 AgentChatWorkspace.tsx、EmptyState.tsx、CuratedTaskLauncherDialog.tsx、CharacterMention{,Panel}.tsx、CuratedTaskBadge.tsx、ImageTaskViewer.tsx、ImageWorkbenchMessagePreview.tsx、useWorkspaceImageTaskPreviewRuntime.ts、useWorkspaceImageWorkbenchActionRuntime.ts、useWorkspaceSendActions.ts、workspaceSendHelpers.ts 等主链文件及配套测试。
• 新增 agentSilentTurnRecovery，用于处理用户发送后出现“静默 turn”时的恢复判定，减少聊天面板看起来“没发出去”但后台其实已入队的错觉。
• 新增 saveSceneAppExecutionAsInspiration 与 sceneAppExecutionInspirationDraft，支持把 SceneApp 执行结果沉淀到灵感库，并与精选任务推荐信号联动。
• src/components/memory/MemoryPage.tsx 与新增的 MemoryCuratedTaskSuggestionPanel.tsx 把 Memory 页面从“看数据”继续推进到“基于记忆继续下一步任务”。
• src/components/sceneapps/{SceneAppsPage,SceneAppRunDetailPanel,useSceneAppsPageRuntime}.tsx 与 SceneAppExecutionSummaryCard.tsx 继续补齐 follow-up、复盘和结果去向表达。

4. Provider 设置、服务模型偏好与自动化页面整理

• src/components/provider-pool/api-key/{ProviderSetting,ProviderModelList}.tsx 及测试继续增强 provider 设置、模型推荐、默认图片服务偏好与 UI 反馈。
• src/lib/mediaGeneration.ts、src/components/image-gen/useImageGen.ts、src/components/workspace/video/VideoCanvas.tsx 与媒体相关前端状态同步更新，进一步对齐媒体默认配置与工作台行为。
• src/components/settings-v2/system/automation/ 下的 AutomationJobDetailsDialog、AutomationJobFocusStrip、AutomationOverviewFocusCard、index.tsx 继续围绕自动化任务焦点、结果复盘与下一步动作整理 UI。

5. Bridge、API、mock、文档与证据材料同步补齐

• 新增 src-tauri/src/dev_bridge/dispatcher/files.rs，补上会话文件保存、路径解析与文件预览桥接分发。
• src-tauri/src/dev_bridge/dispatcher/{app_runtime,providers,project_resources,agent_sessions}.rs、src/lib/api/{agentProtocol,agentExecutionRuntime}.ts、src/lib/api/agentRuntime/{agentClient,types}.ts、src/lib/dev-bridge/mockPriorityCommands.ts、src/lib/tauri-mock/core.ts 同步更新，确保 bridge、mock、前端协议和 runtime 消费者保持同一组 current surface。
• docs/README.md、docs/aiprompts/{command-runtime,providers,query-loop,task-agent-taxonomy}.md、docs/exec-plans/limenext-progress.md 同步刷新；未跟踪的 Playwright 记录与抓包文件一并纳入本轮递交说明，作为这批图片/工作台链路调整的现场证据。

版本同步

• 应用版本事实源已同步为 1.18.0：
  • package.json
  • package-lock.json
  • src-tauri/Cargo.toml
  • src-tauri/tauri.conf.json
  • src-tauri/tauri.conf.headless.json
• 发布与分发相关版本串已同步为 1.18.0：
  • packages/lime-cli-npm/package.json
  • packages/lime-cli-npm/README.md
  • src-tauri/Cargo.lock
  • src-tauri/crates/aster-rust/Cargo.lock
  • src-tauri/crates/aster-rust/crates/aster/tests/mcp_replays/cargorun--quiet-paster-server--binasterd--mcpdeveloper

校验状态

• 本会话已实际通过：
  • npm run verify:app-version
  • cargo fmt --manifest-path "src-tauri/Cargo.toml" --all
  • npm run lint
  • cargo test --manifest-path "src-tauri/Cargo.toml"
  • cargo clippy --manifest-path "src-tauri/Cargo.toml"

---

完整变更: v1.17.0 -> v1.18.0