feat: sync latest workspace changes

2026-09-24 23:10:56 +08:00 · 2026-04-19 18:50:13 +08:00
parent 3715b6e304
commit 9f31ba4cd7
301 changed files with 14618 additions and 14009 deletions
@@ -1,57 +0,0 @@
---
-title: 首页与工作台
-description: 首页与创作工作台总览
-navigation:
-  icon: i-heroicons-chart-bar
---
-
-# 首页与工作台
-
-首页是你进入 Lime 后的主入口。  
-建议把它理解为“创作操作台”，而不是单一功能面板。
-
-## 左侧核心入口
-
- **AI Agent**：对话、任务推进、内容初稿
- **项目**：按创作目标管理长期内容
- **资源**：统一查看文档、图片、语音、视频
- **设置**：调整主题、模块开关、连接与高级选项
-
-## 推荐工作方式
-
-1. 先在项目中选择一个主题方向
-2. 在 AI Agent 中完成结构和首稿
-3. 需要视觉时在 AI Agent 中使用 `@素材` 或图片任务
-4. 回到资源库统一管理本地图片、图库素材与回流结果
-
-## 主题方向
-
-当前支持的主题包括：
-
- 通用对话
- 社媒内容
- 图文海报
- 歌词曲谱
- 知识探索
- 计划规划
- 办公文档
- 短视频
- 小说创作
-
-## 常见操作
-
-### 新建一个创作项目
-
-1. 进入项目页
-2. 选择主题并创建项目
-3. 开始持续沉淀对话与素材
-
-### 从资源继续创作
-
-1. 在资源页选中历史文档或图片
-2. 跳转到 AI Agent 继续改写或扩展
-3. 将新结果再次沉淀回资源库
-
-### 只看某类素材
-
-在资源页切换分类视图，可只看文档、图片、语音或视频。
@@ -1,50 +0,0 @@
---
-title: 提示词模板
-description: 管理可复用提示词，提升稳定产出效率
-navigation:
-  icon: i-heroicons-document-text
---
-
-# 提示词模板
-
-提示词模板用于把“经常重复的表达方式”沉淀下来，减少每次从零开始。
-
-## 模板结构建议
-
-每个模板建议包含：
-
- 名称（便于检索）
- 使用场景（何时用）
- 模板正文（可复用）
- 变量占位（可选）
-
-## 示例：短视频口播模板
-
-```text
-你是一名内容策划。
-请基于主题「{{topic}}」生成一段 {{duration}} 秒口播稿，要求：
-1. 开头 3 秒有抓力
-2. 中段给出 3 个关键点
-3. 结尾有明确行动引导
-语气风格：{{tone}}
-```
-
-## 推荐组织方式
-
- 按主题分类：社媒、短视频、小说、办公
- 按阶段分类：灵感、初稿、润色、发布
- 统一标签：例如 `#高频`、`#可复用`
-
-## 使用建议
-
-### 一次只优化一个模板
-
-避免同时改太多模板，难以判断效果。
-
-### 模板要留“可变空间”
-
-把固定规则写清楚，把创意部分留给变量。
-
-### 和项目结合
-
-在项目中沉淀效果好的模板，后续同类任务可直接复用。
@@ -1,55 +0,0 @@
---
-title: 技能工作流
-description: 把常见任务封装成可复用的 AI 技能
-navigation:
-  icon: i-heroicons-sparkles
---
-
-# 技能工作流
-
-技能可以理解为“可复用的任务卡片”：
-
- 预设目标
- 预设风格
- 预设步骤
-
-这样每次执行同类任务时，不必重复手工组织提示。
-
-## 技能适合做什么
-
- 固定流程写作（如周报、复盘、活动文案）
- 固定结构产出（如短视频脚本、小说章节骨架）
- 固定标准检查（如发布前检查清单）
-
-## 技能卡建议字段
-
- 名称：明确任务类型
- 描述：写清输入与输出
- 系统指令：定义角色与规则
- 参数：控制风格与长度
- 输出格式：约束结果结构
-
-## 示例：活动文案技能
-
-```yaml
-name: "活动文案生成"
-description: "根据主题生成活动预热文案与发布文案"
-system_prompt: |
-  你是一名品牌内容策划，输出要简洁、有行动感。
-output_format: "markdown"
-```
-
-## 组合为流程
-
-你可以把多个技能串成流程，例如：
-
-1. 选题拆解
-2. 初稿生成
-3. 风格统一
-4. 发布前检查
-
-## 团队使用建议
-
-1. 共享高频技能模板
-2. 每个技能指定维护人
-3. 定期清理低使用技能，保持列表可维护
@@ -1,60 +0,0 @@
---
-title: 设置
-description: 管理应用偏好、导航模块和进阶系统选项
-navigation:
-  icon: i-heroicons-cog-6-tooth
---
-
-# 设置
-
-设置页用于管理你的创作体验与系统行为。
-
-## 通用
-
-常见选项：
-
- 主题模式（浅色 / 深色 / 跟随系统）
- 语言选择
- 启动行为（开机自启动、最小化到托盘）
- 声音反馈开关
-
-## 创作与导航偏好
-
-你可以按使用习惯定制入口：
-
- 启用或停用工作区主题（如社媒、短视频、小说）
- 启用或停用导航模块（如 AI Agent、项目、资源、设置、插件）
-
-这样可以让侧边栏更聚焦，减少干扰。
-
-## 连接与系统
-
-系统相关设置在这里管理：
-
- 连接与网络代理
- 安全与证书
- 存储目录与配额
- 外部工具联动
- 实验室与开发者选项
-
-## 关于与版本
-
-在“关于”标签页可以查看：
-
- 当前版本号
- 更新检查入口
- 相关项目信息
-
-## 建议配置
-
-### 个人创作者
-
- 保留：AI Agent、项目、资源
- 关闭：暂时不用的高级模块
- 目的：让工作台聚焦在“日常产出”
-
-### 团队协作
-
- 统一主题配置
- 固定项目命名规则
- 约定资源标签方式
@@ -1,6 +1,6 @@
 ---
 title: 插件中心
-description: 安装和管理扩展插件，按需扩展创作能力
+description: 通过本地包或 URL 安装、启停与卸载插件
 navigation:
  icon: i-heroicons-puzzle-piece
 ---
@@ -8,97 +8,66 @@ navigation:
 # 插件中心

 ::alert{type="info"}
-📢 插件属于进阶能力。若你只做日常创作，可先跳过本页。
+插件属于进阶能力。当前页面只覆盖已经落地的安装与管理链路，不再承诺“推荐插件市场”或“一键精选区”。
 ::

-插件中心用于扩展 Lime 的能力，例如新增工具、接入外部流程、扩展特定场景工作流。
+插件中心用于安装和管理扩展插件。当前可确认的主路径只有两条：从本地插件包安装，或从 URL 安装。

-## 访问插件中心
+## 当前可做的事

-点击左侧导航栏的「插件中心」进入插件管理页面。
-
-## 你能做什么
-
- 浏览推荐插件并一键安装
- 通过本地文件或 URL 安装插件包
- 管理启用状态与卸载
- 查看插件加载与执行状态
+- 从本地文件安装插件包
+- 从 URL 安装插件包
+- 查看 `已安装插件包` 与 `已加载插件`
+- 启用、禁用、卸载、重新加载插件
+- 查看基础状态、最近错误与任务执行情况

 ## 安装插件

-### 方式一：推荐插件一键安装
+### 从本地文件安装

-1. 在「推荐插件」区域找到想要的插件
-2. 点击「一键安装」
-3. 等待下载和安装完成
+1. 打开 `插件中心`
+2. 点击 `安装插件`
+3. 选择本地插件包
+4. 等待校验、解压和安装完成

-### 方式二：从 URL 安装
+当前文件安装支持：

-1. 点击「安装插件」按钮
-2. 输入插件 ZIP 包的下载 URL
-3. 点击「安装」
+- `.zip`
+- `.tar.gz`
+- `.tgz`

-支持的 URL 格式：
- GitHub Release: `https://github.com/org/repo/releases/latest/download/plugin.zip`
- 直接下载链接: `https://example.com/plugin.zip`
+### 从 URL 安装

-### 方式三：从本地文件安装
+1. 打开 `插件中心`
+2. 点击 `安装插件`
+3. 切换到 `URL` 页签
+4. 输入插件包直链并开始安装

-1. 点击「安装插件」按钮
-2. 点击「选择文件」
-3. 选择本地的 `.zip` 文件
-4. 点击「安装」
+当前 URL 安装接受 `http://` 或 `https://` 链接；如果用于团队分发，建议优先使用 `https://` 直链。

-## 使用建议
+## 安装时会校验什么

-### 从小处开始
+插件安装器会先做基础校验，再继续安装：

-先安装 1 到 2 个高频插件，观察是否真正提升你的创作效率，再决定是否扩展更多插件。
+- 压缩包格式是否有效
+- 包内是否包含可解析的 `plugin.json`
+- `name`、`version`、`entry` 等清单字段是否满足当前规则
+- 如果声明了 `hooks`，其命名是否满足当前格式限制

-### 明确用途
+通过校验后，插件会进入 `已安装插件包` 列表；是否真正加载成功，还要以 `已加载插件` 区域的状态为准。

-每个插件都应对应明确目的，例如：
+## 日常管理

- 扩展素材处理
- 增加内容生成模板
- 对接外部工作流
+你可以在插件中心完成这些操作：

-## 管理插件
+- 启用或禁用已安装插件
+- 卸载不再需要的插件包
+- 手动重新加载插件
+- 查看插件状态、最近错误和基础执行信息

-### 启用/禁用
+如果某个插件声明了最低 Lime 版本要求，插件中心会给出版本提示；发布方是否兼容当前版本，仍应以实际安装和加载结果为准。

-在已加载插件列表中，点击电源图标可以启用或禁用插件。
+## 继续阅读

-### 卸载
-
-1. 在「已安装插件包」列表中找到要卸载的插件
-2. 点击红色的删除按钮
-3. 确认卸载
-
-卸载会删除插件文件和配置，但不会删除插件产生的数据。
-
-## 进阶阅读
-
- [开放平台 - 总览](/open-platform/overview)
- [开放平台 - 插件中心](/open-platform/plugins)
- [开放平台 - 插件开发](/open-platform/plugin-development)
-
-## 常见问题
-
-### 插件安装失败
-
-1. 检查网络连接
-2. 确认 URL 正确且可访问
-3. 检查 ZIP 包格式是否正确
-
-### 插件无法加载
-
-1. 检查 Lime 版本是否满足插件要求
-2. 查看日志了解详细错误信息
-3. 尝试重新安装插件
-
-### 二进制插件权限问题
-
-部分二进制插件需要管理员权限：
- **Windows**: 以管理员身份运行 Lime
- **macOS/Linux**: 插件会提示需要的权限
+- [插件打包指南](/open-platform/plugin-development)
+- [扩展接入概览](/open-platform/overview)
@@ -1,71 +0,0 @@
---
-title: 资源库
-description: 管理项目中的文档、图片、语音和视频素材
-navigation:
-  icon: i-heroicons-folder-open
---
-
-# 资源库
-
-资源库是 Lime 的创作资产中心。  
-它和项目绑定，用来长期沉淀你的创作结果。
-
-## 资源分类
-
-资源页支持按分类查看：
-
- 全部
- 文档
- 图片
- 语音
- 视频
-
-当你只想找图或找文档时，直接切换分类即可。
-
-## 常见操作
-
-### 新建与上传
-
-1. 选择左侧资源库（项目）
-2. 新建文件夹或新建文档
-3. 上传本地文件到当前目录
-
-### 搜索与排序
-
- 支持按名称、描述、标签搜索
- 支持按更新时间、创建时间、名称排序
-
-### 重命名与删除
-
-在资源列表的操作菜单中，可对资源进行重命名、删除等操作。
-
-## 资源与创作联动
-
-### 从 Claw 与图片任务回流资源库
-
-在 Claw 中发起图片生成任务，或从图片任务结果执行入库后，成功生成的图片会自动写入当前项目。
-
-资料库的图片视图还统一承接：
-
- 本地图片上传
- 我的图片库浏览
- 选图后插入当前画布
-
-### 从资源继续对话创作
-
-在资源页选中素材后，可继续进入 AI Agent 进行改写、扩写或二次创作。
-
-## 常见问题
-
-### 为什么看不到某些图片？
-
-先确认：
-
-1. 当前选择的是否是正确资源库（项目）
-2. 是否切到了“图片”分类
-3. 文件后缀或 MIME 类型是否被识别为图片
-
-### 为什么资源数量和预期不一致？
-
-常见原因是“分类过滤”或“项目切换”导致显示范围变化。  
-建议先切换到“全部”分类再确认总量。
@@ -1,81 +0,0 @@
---
-title: 图片生成与素材链路
-description: 通过 Claw 与资源库完成搜图、图片生成、编辑与资产沉淀
-navigation:
-  icon: i-heroicons-photo
---
-
-# 图片生成与素材链路
-
-Lime 不再把图片能力拆成独立页面。
-现在的事实源是：
-
- Claw：负责联网搜图、图片生成、参考图编辑和任务推进
- 资源库：负责本地图片上传、我的图片库浏览、结果沉淀和插图复用
- 设置：负责图片模型、Provider 与联网搜图 Key 配置
-
-## 基本流程
-
-1. 在 AI Agent 中明确视觉目标
-2. 需要找参考图时，用 Claw `@素材` 进行联网搜图
-3. 需要生成或编辑图片时，在 Claw 发起对应图片任务
-4. 结果自动或手动沉淀到资源库
-5. 在资源库图片视图继续筛选、上传、插图或复用
-
-## 联网搜图与生成
-
-### 联网搜图
-
-当你需要灵感图、风格参考或可复用素材时：
-
- 在 Claw 中使用 `@素材`
- 联网图片搜索结果会以任务结果或素材候选的形式返回
- 选中的图片可以继续进入正文插图、封面或图片任务链路
-
-### 图片生成与编辑
-
-当你已经明确提示词或参考图后：
-
- 在 Claw 发起图片生成任务
- 如模型支持参考图编辑，系统会优先走编辑链路
- 若某条接口不可用，运行时会回退到可用生成链路，尽量保障出图成功率
-
-## 本地图片与我的图片库
-
-本地图片与历史沉淀图片已经统一收口到资源库图片视图，你可以在这里：
-
- 上传本地图片
- 浏览“我的图片库”
- 选图后直接插入当前画布
- 在当前项目下统一管理图片资产
-
-## 与资源库联动
-
-### 结果回流
-
-图片任务会根据当前项目和资源库选择自动回流；如果需要，也可以在结果完成后再手动入库。
-
-### 插图复用
-
-进入资源库的图片可以直接被当前画布复用，不需要再回到旧图片页面挑选。
-
-## 配置入口
-
-相关配置分布在两个位置：
-
- 图片模型与默认策略：设置中的媒体服务配置
- 联网图片搜索 Key：设置中的网络搜索配置
-
-## 实用建议
-
-### 先定方向再出图
-
-先在 AI Agent 里明确画面目标，再决定是 `@素材` 搜图还是直接发起图片任务，会减少无效尝试。
-
-### 一次只改一个变量
-
-每轮仅调整一个维度（提示词、比例、参考图），更容易稳定收敛到理想结果。
-
-### 把可用版本及时入库
-
-选中可用图片后尽快入库，方便后续在资源页检索、插图和复用。
@@ -25,8 +25,8 @@ cloudflared --version
 2. 已准备 Cloudflare 账号和域名（若使用固定域名）
 3. 飞书应用已创建，拿到 `App ID` 与 `App Secret`

-> 桌面端已支持在「渠道管理 > Gateway 公共隧道」中直接点击：
-> `检测 cloudflared`、`一键安装 cloudflared`（支持 macOS / Windows / Ubuntu 等常见 Linux 发行版）。
+> 当前界面已支持在「渠道管理 > Gateway 公共隧道」中直接点击：
+> `检测 cloudflared`、`一键安装 cloudflared`。安装动作会按当前系统检测到的包管理器环境执行，例如 `brew`、`winget`、`apt-get`、`dnf`、`yum`、`scoop` 或 `choco`。

 ## 步骤 1：配置 Gateway 公共隧道

@@ -65,6 +65,11 @@ Cloudflare 相关字段（二选一）：
 - 将飞书渠道切换为 `webhook` 模式
 - 回填飞书 `webhook_host/webhook_port/webhook_path`

+注意：
+
+- 当前同步动作只支持 `feishu`
+- 同步前需要已经拿到 `public_base_url`，或已填写可推导公网地址的 `DNS Name`
+
 ## 步骤 3：启动隧道并验证状态

 在 Gateway 公共隧道卡片依次点击：
@@ -150,9 +155,9 @@ Cloudflare 相关字段（二选一）：
 桌面端建议按环境选择：

 1. `managed`（应用内托管，默认）  
-   由 Lime 在启动后自动拉起 tunnel，并定时检查进程状态；异常退出会自动重拉。
+   Lime 启动后会启动守护逻辑，约每 `10` 秒检查一次 tunnel 状态；若隧道异常退出且不是手动停止，守护器会尝试重新拉起。
 2. `external`（系统级常驻，生产更稳）  
-   由系统服务管理 `cloudflared`，Lime 仅做状态诊断与 webhook 同步。
+   由系统服务管理 `cloudflared`，Lime 只做状态诊断与 webhook 同步，不负责应用内启动。

 ### 何时用 external

@@ -160,6 +165,10 @@ Cloudflare 相关字段（二选一）：
 - 本机网络波动较大，应用重启不希望影响 tunnel
 - 需要把 tunnel 运维与桌面应用生命周期解耦

+补充说明：
+
+- 如果你在 `managed` 模式下手动点过 `停止`，守护器不会立刻自动再拉起，需手动重新 `启动` 或 `重启`
+
 ### 常见连通性检查

 ```bash
@@ -1,164 +1,101 @@
 ---
 title: 运行时 AGENTS 规则
-description: 使用 `~/.lime/AGENTS.md` 与 Workspace `.lime/AGENTS.md` 为 Lime 运行时会话提供稳定指令
+description: 用 `.lime/AGENTS.md` 体系为 Lime 运行时会话提供指令
 navigation:
  icon: i-heroicons-document-text
 ---

 # 运行时 AGENTS 规则

-Lime 应用运行时会话现在默认读取 `.lime/AGENTS.md` 体系，而不是仓库根的 `AGENTS.md`。
+Lime 应用运行时会话不读取仓库根 `AGENTS.md`，而是使用 `.lime/AGENTS.md` 体系。

-你也可以在「设置 → 记忆」里点击按钮，显式生成全局、Workspace 或本机私有模板文件。
-如果是本机私有模板，还可以继续点击按钮，把 `.lime/AGENTS.local.md` 一键加入 Workspace 的 `.gitignore`。
-首次创建新项目后，Lime 也会弹出一个非强制提示，允许你直接一键初始化这两个 Workspace 模板。
+## 当前事实源

-这让“开发 Lime 源码仓库本身的规则”和“Lime 应用实际运行时的规则”彻底分开：
+运行时 AGENTS 相关能力当前分成两层：

- 仓库根 `AGENTS.md`：给外部 AI 编辑器或源码协作使用
- `~/.lime/AGENTS.md`：你的全局运行时偏好
- `<workspace>/.lime/AGENTS.md`：当前项目 / 工作区的运行时规则
+1. 运行时 AGENTS 主层

-## 加载顺序
+- 全局：`~/.lime/AGENTS.md`
+- 工作区：`<workspace>/.lime/AGENTS.md`

-Lime 运行时会话默认按下面顺序加载：
+这两层会直接进入 Lime 运行时 AGENTS 提示拼接。

-1. 全局：`~/.lime/AGENTS.md`
-2. 工作区：`<workspace>/.lime/AGENTS.md`
-
-如果你保留默认记忆来源设置，Lime 还会继续把下面这个文件作为**本机私有补充**读取：
+2. 本机私有补充层

 - `<workspace>/.lime/AGENTS.local.md`

-推荐做法：
+这层默认通过记忆来源配置进入当前 workspace 的有效记忆，不会向父目录递归查找。

- 把长期个人偏好写进 `~/.lime/AGENTS.md`
- 把项目约束写进 `<workspace>/.lime/AGENTS.md`
- 把不想提交到仓库的本机补充写进 `<workspace>/.lime/AGENTS.local.md`
+## 当前加载口径

-## 什么时候用哪个文件
+默认情况下，可以按下面这条顺序理解：

-### `~/.lime/AGENTS.md`
+1. 先读全局：`~/.lime/AGENTS.md`
+2. 再读工作区：`<workspace>/.lime/AGENTS.md`
+3. 如果保留默认记忆来源配置，再把 `<workspace>/.lime/AGENTS.local.md` 作为本机私有补充带入

-适合放所有项目都通用的偏好，例如：
+推荐分工：

- 统一回复语言
- 默认输出结构
- 常用代码风格
- 你长期偏好的解释方式
+- `~/.lime/AGENTS.md`
+  - 放长期个人偏好
+- `<workspace>/.lime/AGENTS.md`
+  - 放团队共享的项目规则
+- `<workspace>/.lime/AGENTS.local.md`
+  - 放不想提交到仓库的本机补充

-直接复制下面模板即可：
+## 在哪里生成模板

-```md
-# 我的全局 Lime 运行时规则
+当前在 `设置 → 记忆` 页面可以显式生成这些模板：

-## 回复习惯
+- 全局模板
+- Workspace 模板
+- Workspace 本机模板

- 默认使用中文简体
- 先给结论，再给关键步骤
- 没必要时保持简洁，不要过度展开
+如果是本机模板，还可以继续一键把 `.lime/AGENTS.local.md` 写入当前 Workspace 的 `.gitignore`。

-## 工程偏好
+## 新项目提示

- 优先选择 KISS 方案
- 优先修根因，不做表面补丁
- 先说明影响范围，再做改动
+首次创建新项目后，Lime 会弹出一个非强制提示，允许你一键初始化：

-## 代码风格
+- `.lime/AGENTS.md`
+- `.lime/AGENTS.local.md`

- 尽量沿用现有项目风格
- 避免无关重构
- 没有明确收益时，不新增抽象层
-```
-
-## Workspace `.lime/AGENTS.md`
-
-适合放当前项目独有的规则，例如：
-
- 仓库使用的语言
- 文档与注释风格
- 目录边界
- 测试、构建、提交前检查要求
-
-把下面内容保存为工作区内的 `.lime/AGENTS.md`：
-
-```md
-# 当前项目运行时规则
-
-## 项目背景
-
- 这是一个 React + Rust + Tauri 项目
- 前端使用 TypeScript
- 回答和文档默认使用中文简体
-
-## 修改原则
-
- 先读后写
- 只改当前任务直接相关内容
- 保持现有目录结构和命名习惯
-
-## 验证要求
-
- 前端改动后优先跑相关前端测试
- Rust 改动后优先跑相关单测
- 若无法完整验证，需要明确说明未验证部分
-
-## 禁止事项
-
- 不要把临时排障脚本提交进仓库
- 不要修改与当前任务无关的配置
- 不要默认进行 git commit 或 push
-```
-
-## `.lime/AGENTS.local.md` 示例
-
-如果你想保留**只在自己机器生效**的补充规则，可以新建 `.lime/AGENTS.local.md`，并把它加入 `.gitignore`。
-
-例如：
-
-```md
-# 本机私有补充
-
- 优先使用本机已安装的 Node 与 Rust 工具链
- 如需浏览器调试，优先使用本机开发配置
- 涉及大体量编译时，先做定向测试再跑全量
-```
-
-## 推荐目录结构
-
-```text
-workspace-root/
-├─ .lime/
-│  ├─ AGENTS.md
-│  └─ AGENTS.local.md
-├─ src/
-├─ src-tauri/
-└─ ...
-```
-
-你的全局文件位于：
-
-```text
-~/.lime/AGENTS.md
-```
+同时自动补 `.gitignore` 的本机模板忽略规则。

 ## 注意事项

 - Lime 运行时不会读取仓库根 `AGENTS.md`
- Workspace `.lime/AGENTS.md` 只读取当前 workspace，不会向父目录递归回溯
+- `.lime/AGENTS.md` 与 `.lime/AGENTS.local.md` 都只看当前 workspace 根目录
 - 如果团队要共享规则，请提交 `.lime/AGENTS.md`
 - 如果规则只属于你自己，请放进 `.lime/AGENTS.local.md`

-## 推荐起步模板
+## 最小示例

-如果你想先快速用起来，最小可用版本可以直接写：
+`~/.lime/AGENTS.md`

 ```md
-# Lime 运行时规则
+# 我的全局 Lime 运行时规则

 - 默认使用中文简体
- 先给结论，再展开说明
- 保持简洁，优先可执行建议
- 修改代码时先读后写
- 只改当前任务相关内容
+- 先给结论，再给关键步骤
+- 没必要时保持简洁
+```
+
+`<workspace>/.lime/AGENTS.md`
+
+```md
+# 当前项目运行时规则
+
+- 先读后写
+- 只改当前任务直接相关内容
+- 若无法完整验证，需要明确说明
+```
+
+`<workspace>/.lime/AGENTS.local.md`
+
+```md
+# 本机私有补充
+
+- 优先使用本机已安装工具链
+- 涉及大体量编译时先跑定向测试
 ```
@@ -1,61 +0,0 @@
---
-title: 创作数据与监控
-description: 查看创作产出趋势、调用状态与问题定位信息
-navigation:
-  icon: i-heroicons-eye
---
-
-# 创作数据与监控
-
-监控页帮助你回答三个问题：
-
-1. 最近创作是否稳定
-2. 哪些任务成功率更高
-3. 出现异常时该从哪里排查
-
-## 你能看到什么
-
-### 概览指标
-
-常见指标包括：
-
- 请求总量与成功率
- 平均响应耗时
- 活跃连接数量
- 近期错误趋势
-
-### 趋势视图
-
-你可以按时间查看：
-
- 调用量变化
- 成功率变化
- 延迟波动
-
-这能帮助你判断问题是偶发，还是持续性异常。
-
-## 日志排查
-
-当某次生成失败时，优先看请求日志：
-
-1. 找到失败时间点
-2. 查看模型与请求参数
-3. 对照错误信息定位问题（超时、认证、限流等）
-
-## 对创作者最有用的用法
-
-### 判断工作流是否健康
-
-如果成功率持续下降，建议先减少并发任务，确认连接状态后再恢复批量生成。
-
-### 对比不同创作任务
-
-同样是生成任务，不同主题的耗时差异可能很大。通过趋势图可以更快选择稳定方案。
-
-### 复盘高峰时段
-
-高峰期（例如集中出图）出现波动时，可根据日志回看是否需要拆分任务批次。
-
-## 数据导出
-
-如果你需要做团队复盘，可导出统计数据用于周报或复盘记录。
@@ -1,55 +0,0 @@
---
-title: 模型连接与账号
-description: 管理模型连接方式与多账号状态（进阶）
-navigation:
-  icon: i-heroicons-key
---
-
-# 模型连接与账号
-
-::alert{type="info"}
-这是进阶页。普通创作者可直接使用默认连接能力，按需再回来配置。
-::
-
-该页面用于管理模型连接与账号状态，适合以下场景：
-
- 你有多个账号需要统一管理
- 你需要手动添加 API Key
- 你希望在连接异常时快速排查
-
-## 常见连接方式
-
-### 自动检测
-
-应用会尝试检测本地常见凭证文件，检测成功后可直接使用。
-
-### 手动添加
-
-如果自动检测失败，可手动添加：
-
-1. 选择连接类型
-2. 填写必要凭证信息
-3. 保存后执行连接测试
-
-## 账号状态说明
-
- 可用：可正常调用
- 即将过期：建议尽快刷新
- 已失效：需重新登录或更新凭证
- 未验证：建议先执行测试
-
-## 多账号使用建议
-
-### 日常创作
-
-保留 1 到 2 个稳定账号即可，优先保证可用性。
-
-### 高强度创作
-
-如果你需要长时间连续生成，可配置多个账号做冗余，降低单点失败影响。
-
-## 安全建议
-
-1. 不在聊天记录或公开文档里粘贴密钥
-2. 定期清理失效连接
-3. 导出配置时确认敏感信息不会被带出
@@ -1,110 +0,0 @@
---
-title: 进阶配置示例
-description: 按创作场景选择配置思路（示例）
-navigation:
-  icon: i-heroicons-document-text
---
-
-# 进阶配置示例
-
-::alert{type="info"}
-本页示例用于说明配置思路，不要求你逐字段照抄。具体字段以应用设置界面为准。
-::
-
-## 示例 1：个人创作者（推荐起步）
-
-目标：少配置、快开始。
-
-```yaml
-profile: "solo-content"
-navigation:
-  enabled:
-    - agent
-    - projects
-    - resources
-    - image-gen
-themes:
-  enabled:
-    - general
-```
-
-适用：统一通用工作台入口，按项目内容继续细分任务。
-
-## 示例 2：团队协作
-
-目标：统一入口和主题，降低沟通成本。
-
-```yaml
-profile: "team-content"
-navigation:
-  enabled:
-    - agent
-    - projects
-    - resources
-    - tools
-themes:
-  enabled:
-    - general
-resource:
-  naming: "project-date-version"
-```
-
-适用：品牌运营、活动策划、小团队协作的统一工作台配置。
-
-## 示例 3：API 缓存策略（高级）
-
-目标：精确控制哪些响应状态码参与短时缓存（非流式）。
-
-```yaml
-server:
-  host: "127.0.0.1"
-  port: 8999
-  api_key: "your-api-key"
-  response_cache:
-    enabled: true
-    ttl_secs: 600
-    max_entries: 200
-    max_body_bytes: 1048576
-    cacheable_status_codes: [200]  # 默认仅缓存 200；可按需扩展 [200, 201]
-```
-
-适用：对缓存命中与语义一致性有要求的自动化/API 调用场景。
-
-## 示例 4：运行时诊断接口（高级）
-
-目标：像 ClawRouter 一样快速查看网关健康、缓存与统计信息。
-
-```bash
-# 基础健康检查（兼容旧行为）
-curl "http://127.0.0.1:8999/health"
-
-# 扩展健康检查（包含完整诊断）
-curl "http://127.0.0.1:8999/health?full=true"
-
-# 响应缓存配置与命中统计
-curl "http://127.0.0.1:8999/cache"
-
-# 统计诊断（默认最近 7 天，可传 days=1~30）
-curl "http://127.0.0.1:8999/stats?days=7"
-
-# 查看请求级调试头（缓存/去重/幂等等状态）
-curl -i "http://127.0.0.1:8999/v1/chat/completions" \
-  -H "Authorization: Bearer your-api-key" \
-  -H "Content-Type: application/json" \
-  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"ping"}]}'
-```
-
-适用：排查“为什么慢/为什么回退/是否命中缓存”等线上联调问题。
-
-可观测调试头示例：
- `x-lime-request-id`
- `x-lime-cache`（`hit/store/skip-*`）
- `x-lime-dedup`（`replay/wait-replay/new/removed-on-error`）
- `x-lime-idempotency`（`replay/in-progress/new/removed-on-error`）
- `x-lime-requested-provider` / `x-lime-effective-provider` / `x-lime-model`
-
-## 调整顺序建议
-
-1. 先确认导航与主题
-2. 再确认连接与稳定性
-3. 最后再做自动化与诊断扩展
@@ -1,66 +0,0 @@
---
-title: 模型分发规则
-description: 按任务类型将请求分发到不同模型（进阶）
-navigation:
-  icon: i-heroicons-arrows-right-left
---
-
-# 模型分发规则
-
-::alert{type="info"}
-这是进阶能力。只有在“多模型并行使用”时才需要配置。
-::
-
-分发规则用于把不同任务自动交给更合适的模型。
-
-## 什么时候需要它
-
- 文本创作和图片任务使用不同模型
- 同一主题需要“快速草稿 + 高质量润色”两种路径
- 你希望把高成本任务限制在特定模型上
-
-## 常见策略
-
-### 按任务类型分发
-
- 长文写作走高质量模型
- 快速问答走低延迟模型
- 图片任务走图片专用模型
-
-### 按阶段分发
-
- 初稿阶段：速度优先
- 定稿阶段：质量优先
-
-### 按兜底分发
-
-主模型异常时，自动回退到备用模型。
-
-## 示例（示意）
-
-```yaml
-routes:
-  - pattern: "video-script-*"
-    provider: "primary"
-    model: "high-quality-model"
-    priority: 10
-  - pattern: "quick-*"
-    provider: "fast-lane"
-    model: "fast-model"
-    priority: 20
-  - pattern: "*"
-    provider: "fallback"
-    priority: 100
-```
-
-## 配置建议
-
-1. 先只配 2 到 3 条关键规则
-2. 给兜底规则留最后优先级
-3. 每次改完都做一次路由测试
-
-## 常见误区
-
- 规则过多导致难以维护
- 没有兜底规则，异常时直接失败
- 频繁改规则但不做回归测试
@@ -1,68 +0,0 @@
---
-title: 稳定性与容错
-description: 在高强度创作下保持调用稳定（进阶）
-navigation:
-  icon: i-heroicons-shield-check
---
-
-# 稳定性与容错
-
-::alert{type="info"}
-这是进阶能力。只有在你频繁遇到超时、失败、波动时才需要细调。
-::
-
-稳定性配置的核心目标是：
-
- 少失败
- 失败后可恢复
- 出错时可定位
-
-## 三个关键参数
-
-### 重试
-
-用于处理偶发失败。
-
-建议：
-
- 最大重试次数：2 到 3 次
- 首次重试延迟：1 秒左右
- 使用递增退避，避免短时间反复打满请求
-
-### 超时
-
-用于避免单次请求长时间卡住。
-
-建议：
-
- 普通文本任务：较短超时
- 长文或复杂任务：适当放宽
- 图片任务：通常需要更长超时
-
-### 故障回退
-
-主连接失败后自动走备用连接，减少中断。
-
-## 推荐调参顺序
-
-1. 先调超时
-2. 再调重试
-3. 最后配置回退策略
-
-## 诊断建议
-
-### 连续失败
-
-优先检查：
-
-1. 连接状态是否可用
-2. 当前模型是否可调用
-3. 是否触发限流
-
-### 偶发失败
-
-通常先提高重试效果更明显。
-
-### 高峰波动
-
-建议拆分任务批次，避免同一时刻大量并发。
@@ -1,63 +0,0 @@
---
-title: 配置管理与迁移
-description: 导出、导入、备份与跨设备迁移配置
-navigation:
-  icon: i-heroicons-document-duplicate
---
-
-# 配置管理与迁移
-
-配置管理适合两类人：
-
- 想把当前工作台快速迁移到另一台设备
- 团队内需要统一一套基础配置
-
-## 导出配置
-
-你可以将当前设置导出为配置文件，常用于备份和迁移。
-
-常见导出内容：
-
- 主题与导航偏好
- 部分连接与路由策略
- 稳定性相关参数
-
-::alert{type="warning"}
-导出文件通常不包含敏感凭证信息。导入后需重新检查连接状态。
-::
-
-## 导入配置
-
-1. 在设置页选择导入
-2. 预览配置差异
-3. 选择覆盖或合并策略
-4. 导入后做一次连接与功能自检
-
-## 备份建议
-
-### 个人用户
-
-至少保留最近 2 到 3 份配置备份。
-
-### 团队用户
-
-建议按版本管理配置文件，例如：
-
- `team-config-v1.yaml`
- `team-config-v1.1.yaml`
-
-## 跨设备迁移清单
-
-1. 导出配置文件
-2. 在新设备导入配置
-3. 重新校验连接状态
-4. 检查主题、导航、资源路径是否符合预期
-5. 进行一次完整创作演练
-
-## 什么时候需要重置
-
-当你长期调参后“越调越乱”，最稳妥的方式是：
-
-1. 先备份当前配置
-2. 恢复到基础配置
-3. 只按必要场景逐项开启进阶能力
@@ -1,50 +0,0 @@
---
-title: 工作模式切换
-description: 在不同创作场景间快速切换配置
-navigation:
-  icon: i-heroicons-arrows-up-down
---
-
-# 工作模式切换
-
-如果你在不同场景下有明显不同的工作方式，可以使用配置档案快速切换。
-
-## 典型模式
-
-### 日更模式
-
- 目标：快速产出
- 适合：社媒短内容、灵感快写
- 特点：速度优先、流程简化
-
-### 深度创作模式
-
- 目标：质量优先
- 适合：长文、小说章节、方案定稿
- 特点：更强调结构和多轮迭代
-
-### 出图冲刺模式
-
- 目标：集中生成并沉淀图片素材
- 适合：活动海报、视觉素材周更
- 特点：图片相关入口前置、资源回流优先
-
-## 建议的档案字段
-
-每个档案建议包含：
-
- 启用的导航模块
- 启用的工作区主题
- 关键连接与稳定性偏好
-
-## 切换步骤
-
-1. 选择目标档案
-2. 应用后检查核心入口是否符合预期
-3. 用一个小任务做快速验证
-
-## 使用建议
-
-1. 档案数量控制在 3 个以内
-2. 一个档案只服务一个明确场景
-3. 变更档案后记录用途，避免后续混乱
@@ -1,53 +1,82 @@
 ---
 title: MCP 工具扩展
-description: 让 AI 调用外部工具与资源（进阶）
+description: 管理 MCP 服务器配置，并浏览可用 Tools、Prompts 与 Resources
 navigation:
  icon: i-heroicons-puzzle-piece
 ---

 # MCP 工具扩展

-MCP 可以让 AI 不只“回答问题”，还可以调用外部工具完成动作。
-
 ::alert{type="info"}
-这是进阶能力。建议先熟悉基础创作流程，再接入 MCP。
+MCP 属于进阶能力，当前仍应按实验功能理解。它不会替代 Lime 的主创作路径，更适合已经明确需要外部工具或资源接入的场景。
 ::

-## 适合的场景
+当前 Lime 已提供 MCP 服务器管理与运行时浏览面板。你可以集中维护服务器配置，把它同步到常用外部工具，并在 Lime 内验证可用的 Tools、Prompts 和 Resources。

- 让 AI 读取指定目录素材
- 连接外部知识源或服务
- 把重复操作做成可调用工具
+## 当前可做的事

-## 基本使用流程
+- 新增、编辑、删除 MCP 服务器配置
+- 使用预设快速创建常见服务器
+- 从 Claude、Codex、Gemini CLI 导入已有 MCP 配置
+- 将当前配置同步回外部应用
+- 查看服务器运行状态并手动启动、停止
+- 浏览运行中服务器暴露的 Tools、Prompts、Resources

-1. 添加 MCP 服务器配置
-2. 启动并确认连接状态
-3. 在工具列表里验证可用工具
-4. 在实际任务里小范围试跑
-
-## 一个简单示例
+## 一个最小配置示例

 ```json
 {
-  "mcpServers": {
-    "filesystem": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/workspace"]
-    }
-  }
+  "command": "npx",
+  "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/workspace"],
+  "env": {}
 }
 ```

+如果你只是想先验证链路，`filesystem` 是最容易起步的示例。
+
+## 推荐使用流程
+
+1. 先选择一种来源
+
+- 直接新建服务器配置
+- 从 Claude、Codex、Gemini CLI 导入已有配置
+
+2. 再决定同步范围
+
+- 只在 Lime 内启用
+- 或同步到 Claude、Codex、Gemini CLI 一起使用
+
+3. 保存后验证运行状态
+
+- 确认服务器能正常启动
+- 确认 Lime 能读取到对应能力列表
+
+4. 最后做小范围试跑
+
+- 先试一个简单 Tool
+- 再验证 Prompt 或 Resource 是否符合预期
+
+## 当前常见入口
+
+当前面板已经内置一些常见预设，适合快速起步：
+
+- `Filesystem`
+- `GitHub`
+- `PostgreSQL`
+- `自定义`
+
+如果团队已有现成配置，优先导入；如果只是单机试验，优先从最小自定义或 `Filesystem` 开始。
+
 ## 安全边界建议

-1. 只授权必要目录和资源
-2. 敏感环境变量不要硬编码在公开配置里
-3. 新工具先在测试项目验证
+1. 只给服务器开放必要目录、数据库或环境变量
+2. 新接入的 MCP 先在测试目录验证，不要直接连生产数据
+3. 对外同步前，先确认对应应用确实需要这台服务器
+4. 涉及密钥时，避免把敏感值直接写进会提交的公共配置

 ## 排错顺序

-1. 看连接状态是否正常
-2. 看工具是否成功注册
-3. 看调用参数是否符合工具定义
-4. 看服务器日志定位具体错误
+1. 先看服务器配置 JSON 是否有效
+2. 再看服务器是否能成功启动
+3. 再看 Tools、Prompts、Resources 是否已被正确发现
+4. 最后再检查具体调用参数、环境变量和外部依赖