Lime Feature Map
September 4, 2026 · View on GitHub
Lime 仓库级产品能力地图。本文回答“用户能完成什么、从哪里进入、运行时事实由谁拥有、应去哪里查看详细规则”。它是导航，不是第二套架构、需求、路线图或 readiness 数据库。
1. 使用规则
- Feature：面向用户或外部调用方可感知的完整能力，不按页面、组件或 crate 数量拆分。
- 用户入口：当前产品中的稳定入口；GUI、CLI、App Server 协议与系统触发入口分开记录。
- Current owner：拥有状态机、运行时不变量或持久事实的唯一领域 owner。Renderer 只拥有交互与投影，Electron 只拥有桌面宿主能力。
- 稳定边界：能力进入 current 主链的 typed gateway、JSON-RPC method family、runtime contract 或 Desktop Host surface。
- 状态：
current可继续演进；compat只能委托；deprecated只能迁出；dead已删除或禁止恢复。
current 表示唯一演进路径，不表示所有 provider、平台、打包产物或 Gate B 证据都已完成。未完成项继续记录在对应执行计划、质量证据和领域事实源中，不在本表伪装成已交付能力。
裁决顺序固定为：
- 当前构建图、协议 schema、运行代码和稳定测试。
- 全局架构图与根
AGENTS.md。 internal/aiprompts/中的领域事实源。- 已确认执行计划、路线图、研究和历史 evidence。
2. Desktop 产品主链
flowchart LR
U[用户 / 外部入口]
UI[React Renderer\nGUI 与局部交互]
HOST[Electron Desktop Host\n系统能力与 sidecar]
APP[App Server JSON-RPC\n业务协议与 read model]
CORE[RuntimeCore / agent-runtime\nThread / Turn / Item]
MODEL[model-provider\n模型目录、路由与 lowering]
TOOL[tool-runtime\n工具、权限与执行]
DATA[thread-store / repository\n持久化与 projection]
U --> UI
UI --> HOST
HOST --> APP
APP --> CORE
CORE --> MODEL
CORE --> TOOL
CORE --> DATA
DATA --> APP
APP --> UI
Desktop GUI 业务能力只通过 App Server JSON-RPC 进入 Rust runtime。Electron IPC 仅承接窗口、文件选择、系统权限、通知、更新、native view 和 sidecar 生命周期，不能成为第二套业务后端。独立 CLI 有自己的任务入口，但不能替代 App Server 的桌面产品协议。完整依赖方向以全局架构图为准。
3. Feature Ownership Map
| Feature | 用户能力 | 当前用户入口 | Current owner / 稳定边界 | 状态与事实源 |
|---|---|---|---|---|
| Agent 任务与对话 | 从目标启动任务，持续执行、取消、恢复和查看 Thread / Turn / Item | “新建任务”与 Agent Workspace | app-server、agent-runtime、agent、thread-store；typed Thread/Turn API 与 canonical projection | current；架构、Query Loop |
| 协作模式与 Multi-Agent | 选择 Default / Plan，并让子 Agent 分工后回到主 Thread | Composer 模式选择与 Agent 运行过程 | collaborationMode/list、agent-runtime、subagent Thread/Turn 与同一 projection | current；任务与 Agent taxonomy、命令边界 |
| Workspace、项目与文件 | 选择项目目录，浏览、读取、写入和预览项目文件 | Agent Workspace、文件浏览器与 Right Surface | App Server workspace/repository；fs/*；Electron 仅提供系统目录选择与文件壳能力 | current；Workspace 边界、命令边界 |
| 终端与后台进程 | 执行一次性命令、交互终端并管理 Thread-owned 后台进程 | Workspace 终端与命令 Item | command/exec*、process/*、thread/backgroundTerminals/*；tool-runtime process supervisor | current；命令边界 |
| 工具、审批与执行策略 | 调用本地工具，在危险操作前审批，并按工作区策略限制执行 | Agent 工具 Item、审批交互与设置 | tool-runtime；permissionProfile/list；App Server server-request；canonical tool Item | current；命令边界、质量工作流 |
| Browser Workspace | 在同一可见浏览器中由用户或 Agent 浏览、操作、下载和接管 | Right Surface 的 Electron WebContentsView | BrowserTabHost、Renderer browser gateway、App Server dynamic-tool host；同一 tab/view owner | current；命令边界 |
| Provider、模型与凭证 | 配置模型服务，选择模型，并按 capability/readiness 路由请求 | 设置中的模型与服务、Composer Model Selector | model-provider；catalog、route、credential readiness、canonical content、lowering、stream、retry/breaker | current；Provider 系统 |
| 多模态与媒体生成 | 在同一任务中理解或生成图片、音频、视频和其他媒体产物 | Composer、Agent Workspace 与 artifact/workbench | model-provider 负责 sampling/lowering；media-runtime 负责媒体任务；Thread/Artifact 持有结果事实 | current；架构、持久化地图 |
| CLI 与 TUI | 在终端交互或非交互运行 Agent，并管理 Thread、MCP 与 Skills | lime、lime exec、lime resume | cli 与 tui 经 app-server-client 复用 App Server、RuntimeCore 和 Thread/Turn/Item | current；CLI 源码、架构 |
| MCP | 管理 MCP server，发现 tools/prompts/resources，并在真实 Thread 中调用工具 | 设置 MCP 页面与 Agent runtime | src/lib/api/mcp.ts -> App Server mcp* -> lime-mcp；Thread-owned McpThreadRuntime | current；MCP、命令边界 |
| Skills | 发现、读取、启停和执行本地或远程 Skill | Plugins 聚合入口中的 Skills Workspace 与 Composer | skills/list、skill/read、skills/config/write；lime-skills 与 Agent Skill snapshot | current；Skill 标准、命令边界 |
| Apps 与 Plugins | 安装、启停和发现扩展，为 Agent 提供 Apps/connectors 与 UI 资源 | Plugins / App Center | App Server app/*、plugin/*；PluginDataSource 与 local plugin catalog | current；Plugin v3 是唯一版本替代路径，hosted connector 的 callable=true 仍以真实 readiness 证据为准；Plugin v3、命令边界 |
| Experts | 从领域专家配置启动一个带 profile、release 和 Skill 约束的新任务 | Plugins 聚合入口中的专家广场 | Expert catalog/launch metadata 只负责入口编排；执行仍归同一 Agent Thread/Turn 主链 | current；入口见 AppPageContent，runtime 归架构 |
| 项目资料与知识上下文 | 导入、编译、选择资料包，并把可信上下文注入任务 | “项目资料”页面与 Agent Composer | lime-knowledge、App Server knowledgePack/* 与 knowledgeContext/*；Renderer 只做选择和状态投影 | current；协议见 app-server-protocol |
| Artifact 与资源工作区 | 查看、编辑、版本化和导出任务生成物及文件快照 | Agent Workbench 与“资源”页面 | canonical FileArtifact / Artifact snapshot、App Server artifact/*、sidecar snapshot store | current；Workspace、持久化地图 |
| Scheduled Tasks | 创建、启停、预览和立即运行周期任务，并查看运行历史 | “已安排任务”页面 | App Server scheduledTask/*、RuntimeCore、scheduler 与 automation storage mapping | current；真实 OS sleep/wake、Windows 通知与 Windows Gate B 仍是平台证据缺口；命令边界 |
| 消息渠道与远程入口 | 从支持的 IM 渠道触发本地 Agent，并管理渠道与 tunnel | “消息渠道”页面 | 消息渠道 runtime 是 current ingress，最终回到现有 Agent session/task/evidence；旧单渠道与部分命令壳不得扩展 | current 入口，含受控 compat/deprecated 边界；Remote runtime |
| 记忆、上下文与压缩 | 在长任务中复用受管记忆，按需读取原文，并压缩上下文后继续执行 | Agent turn 与设置中的记忆控制 | RuntimeCore / App Server、MemoryBackend、memory tools、canonical compaction continuation | current；Memory / Context / Compaction |
| 历史、回退、Review 与 Evidence | 恢复会话、替换后续历史、发起代码审阅，并从 canonical read model 导出证据 | Thread 历史、消息回退入口、Review 与状态面板 | App Server thread/read、thread/resume、thread/revert、review/start；ThreadStore 与 canonical evidence projection | current；状态、历史与遥测、命令边界 |
| 配置与系统设置 | 管理全局配置、实验能力、权限档位、外观和桌面行为 | “设置”页面 | config/*、experimentalFeature/*、permissionProfile/list；系统壳配置归 Electron Host | current；命令边界 |
| Desktop Host 与发布生命周期 | 使用窗口、托盘、通知、系统权限、native helper、自动更新与安装包 | 主窗口、系统菜单、通知和更新入口 | electron/、preload/IPC 白名单、sidecar host、Forge 与平台资源 manifest | current；架构、质量工作流 |
4. Owner Quick Map
| Owner | 负责 | 不负责 |
|---|---|---|
src/ Renderer | 产品交互、i18n、局部 UI 状态、request builder 与 projection | Thread 真相、provider wire、工具执行、生产 mock fallback |
electron/ Desktop Host | 窗口、preload、IPC、系统权限、native view/helper、sidecar、updater | Agent 状态机、模型请求、Thread/Turn/Item、业务 repository |
app-server 与 protocol/client | 唯一业务 JSON-RPC、handler、host context、read model 与领域接线 | provider-specific payload、Electron 系统实现、Renderer 状态 |
agent-runtime / agent | 回合生命周期、队列、取消、stream、runtime scope 与 Agent 编排 | provider 网络、桌面窗口、UI 缓存 |
model-provider | model catalog/switch、capability/readiness、credential route、canonical content、lowering、stream、retry/breaker | Agent loop、工具权限、Thread 持久化 |
tool-runtime | 工具定义、权限、sandbox、dispatch、进程与 MCP step snapshot | GUI、provider catalog、Thread read model |
thread-store / App Server repository | Thread/Turn/Item、event history、projection 与恢复事实 | 临时 UI 状态、系统文件选择、provider wire |
5. 退役与过渡边界
本节只列仓库级高风险边界，不替代治理规则和各领域的完整目录册。
| Surface | 分类 | 处理规则 |
|---|---|---|
| 已退役 runtime 的 vendor、workspace crate、迁移目录与专用 skill | dead / deleted / forbidden-to-restore | 只能作为历史 evidence 或负向守卫；能力缺口在 current owner 内按 Codex 重建 |
已删除的 lime-providers | dead / deleted / forbidden-to-restore | Provider 能力只能进入 model-provider，不得恢复依赖或 compat 包装 |
| 旧 Electron 业务 facade、legacy JSON-RPC/IPC 与生产 mock fallback | dead 或 deprecated | 业务调用迁入 App Server current method；旧名只允许负向守卫或有退出条件的委托层 |
| 旧 MCP、Skills、Automation 与外部 Chrome/CDP 正向入口 | dead / retired guard-only | 不恢复 catalog、Renderer gateway、Desktop command 或正向 fixture |
.lime/AGENTS.md / .lime/AGENTS.override.md 文件位置 fallback | compat | 只委托标准 CODEX_HOME/AGENTS.md 与项目 AGENTS.md，不得扩展新语义 |
| 消息渠道旧单通道入口与 remote command wrapper | compat 或 deprecated | 新能力只能进入 current 消息渠道或浏览器连接器 ingress；按领域计划迁出 |
6. 维护规则
- 改 Feature owner、依赖方向或产品主链时，先更新代码和全局架构图，完成责任开发者确认后再同步本表。
- 改 JSON-RPC method、schema、Desktop Host bridge 或 typed client 时，同步命令边界、消费者、catalog、fixture 与契约测试。
- 改
current / compat / deprecated / dead分类时，先更新治理规则或对应领域事实源；本表只做摘要。 - 新增页面不自动等于新增 Feature；先判断它属于现有能力入口，还是确实建立了新的唯一 owner。
- 路线图、研究、截图和单次测试结果不能单独把能力升级为
current。真实 readiness 以代码、协议和相应证据等级共同裁决。 - 最小文档检查为
npm run docs:boundary、相对链接校验和git diff --check；涉及治理分类时追加npm run governance:legacy-report。
7. 版本替换索引
版本号不自动代表同一能力。下表只记录已经确认的替换关系；未列出的版本目录不能按名称直接删除。
| 历史入口 | Current replacement | 分类与边界 |
|---|---|---|
internal/roadmap/plugin/ 根旧文档、plugin/v2/** | internal/roadmap/plugin/v3/ | 旧 Plugin 版本为 dead / deleted；有效包、安装、恢复和清理决策已迁入 v3。 |
internal/roadmap/images/README.md | internal/roadmap/images/v2/ | 旧图片路线图为 legacy current reference；v2 拥有确定性 Image Command Workflow 和 Media Runtime 边界。 |
internal/roadmap/Writing/ v1 文档 | internal/roadmap/Writing/v2/ + writing-v2-workflow-completion-plan.md | v1 文档为 legacy current reference；v2 拥有普通 Agent turn、workflow audit 和段落级 artifact 合同。 |
internal/roadmap/knowledge/prd.md | internal/roadmap/knowledge/prd-v2.md | v1 只作 legacy reference，Knowledge v2 是 document-first current owner。 |
internal/refactor/v1/ | 无整体替换 | v1 承接 Runtime/App Server 对齐主线，v2 只承接 Renderer projection；两者是不同 owner，不能按版本号删除 v1。 |
8. 详细事实源
- 文档导航
- 项目概览
- 全局架构图
- Desktop Host 与 App Server 命令边界
- 治理规则
- 工程质量工作流
- Workspace 领域边界
- Provider 系统
- MCP
- Remote runtime
- 状态、历史与遥测
本文件只维护能力导航。任何与当前构建图、协议或领域事实源冲突的描述，应直接修正或删除，不能通过新增兼容解释继续保留。