release: v0.93.0

2026-09-24 23:10:56 +08:00 · 2026-03-21 23:10:41 +08:00
parent 43e79847b2
commit dc37baff36
193 changed files with 30459 additions and 13754 deletions
@@ -0,0 +1,164 @@
+---
+title: 运行时 AGENTS 规则
+description: 使用 `~/.lime/AGENTS.md` 与 Workspace `.lime/AGENTS.md` 为 Lime 运行时会话提供稳定指令
+navigation:
+  icon: i-heroicons-document-text
+---
+
+# 运行时 AGENTS 规则
+
+Lime 应用运行时会话现在默认读取 `.lime/AGENTS.md` 体系，而不是仓库根的 `AGENTS.md`。
+
+你也可以在「设置 → 记忆」里点击按钮，显式生成全局、Workspace 或本机私有模板文件。
+如果是本机私有模板，还可以继续点击按钮，把 `.lime/AGENTS.local.md` 一键加入 Workspace 的 `.gitignore`。
+首次创建新项目后，Lime 也会弹出一个非强制提示，允许你直接一键初始化这两个 Workspace 模板。
+
+这让“开发 Lime 源码仓库本身的规则”和“Lime 应用实际运行时的规则”彻底分开：
+
+- 仓库根 `AGENTS.md`：给外部 AI 编辑器或源码协作使用
+- `~/.lime/AGENTS.md`：你的全局运行时偏好
+- `<workspace>/.lime/AGENTS.md`：当前项目 / 工作区的运行时规则
+
+## 加载顺序
+
+Lime 运行时会话默认按下面顺序加载：
+
+1. 全局：`~/.lime/AGENTS.md`
+2. 工作区：`<workspace>/.lime/AGENTS.md`
+
+如果你保留默认记忆来源设置，Lime 还会继续把下面这个文件作为**本机私有补充**读取：
+
+- `<workspace>/.lime/AGENTS.local.md`
+
+推荐做法：
+
+- 把长期个人偏好写进 `~/.lime/AGENTS.md`
+- 把项目约束写进 `<workspace>/.lime/AGENTS.md`
+- 把不想提交到仓库的本机补充写进 `<workspace>/.lime/AGENTS.local.md`
+
+## 什么时候用哪个文件
+
+### `~/.lime/AGENTS.md`
+
+适合放所有项目都通用的偏好，例如：
+
+- 统一回复语言
+- 默认输出结构
+- 常用代码风格
+- 你长期偏好的解释方式
+
+直接复制下面模板即可：
+
+```md
+# 我的全局 Lime 运行时规则
+
+## 回复习惯
+
+- 默认使用中文简体
+- 先给结论，再给关键步骤
+- 没必要时保持简洁，不要过度展开
+
+## 工程偏好
+
+- 优先选择 KISS 方案
+- 优先修根因，不做表面补丁
+- 先说明影响范围，再做改动
+
+## 代码风格
+
+- 尽量沿用现有项目风格
+- 避免无关重构
+- 没有明确收益时，不新增抽象层
+```
+
+## 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
+```
+
+## 注意事项
+
+- Lime 运行时不会读取仓库根 `AGENTS.md`
+- Workspace `.lime/AGENTS.md` 只读取当前 workspace，不会向父目录递归回溯
+- 如果团队要共享规则，请提交 `.lime/AGENTS.md`
+- 如果规则只属于你自己，请放进 `.lime/AGENTS.local.md`
+
+## 推荐起步模板
+
+如果你想先快速用起来，最小可用版本可以直接写：
+
+```md
+# Lime 运行时规则
+
+- 默认使用中文简体
+- 先给结论，再展开说明
+- 保持简洁，优先可执行建议
+- 修改代码时先读后写
+- 只改当前任务相关内容
+```
@@ -113,6 +113,28 @@ pnpm tauri build
 pnpm tauri build --debug
 ```

+### 自动更新产物与签名
+
+Lime 当前的桌面端升级流程分成两步：
+
+- 检查更新：客户端直接请求静态清单 `latest.json`
+- 安装更新：客户端使用 Tauri updater 校验签名并安装对应平台包
+
+`src-tauri/tauri.conf.json` 与 `src-tauri/tauri.conf.headless.json` 已启用 `createUpdaterArtifacts: true`，构建发布包时会额外生成 updater 需要的签名产物与 `latest.json`。
+
+本地或 CI 构建发布版本时，至少需要准备以下环境变量：
+
+```bash
+# updater 校验使用的公钥；编译时注入到桌面端
+export LIME_UPDATER_PUBLIC_KEY="..."
+
+# Tauri 生成 latest.json 和签名文件时使用的私钥
+export TAURI_SIGNING_PRIVATE_KEY="..."
+export TAURI_SIGNING_PRIVATE_KEY_PASSWORD="..."
+```
+
+如果缺少 `LIME_UPDATER_PUBLIC_KEY`，应用仍可读取 `latest.json` 显示新版本信息，但会降级为只能跳转发布页手动下载，无法执行应用内安装。
+
 ### 构建产物

 | 平台    | 产物位置                                |
@@ -190,14 +212,15 @@ git push origin v1.0.1

 - Push 到 main 分支触发构建
 - 创建 tag 触发发布
+- Release 工作流会把 `LIME_UPDATER_PUBLIC_KEY`、`TAURI_SIGNING_PRIVATE_KEY`、`TAURI_SIGNING_PRIVATE_KEY_PASSWORD` 注入构建环境，用于生成可校验的 updater 清单与安装包签名

 ### 构建矩阵

-| 平台    | 架构  | Runner        |
-| ------- | ----- | ------------- |
-| macOS   | arm64 | macos-latest  |
-| macOS   | x64   | macos-13      |
-| Windows | x64   | windows-2022  |
+| 平台    | 架构  | Runner       |
+| ------- | ----- | ------------ |
+| macOS   | arm64 | macos-latest |
+| macOS   | x64   | macos-13     |
+| Windows | x64   | windows-2022 |

 ## 调试

@@ -214,10 +237,10 @@ RUST_LOG=debug pnpm tauri dev

 ### 日志位置

-| 平台    | 路径                             |
-| ------- | -------------------------------- |
-| macOS   | `~/Library/Logs/Lime/`      |
-| Windows | `%APPDATA%\Lime\logs\`      |
+| 平台    | 路径                   |
+| ------- | ---------------------- |
+| macOS   | `~/Library/Logs/Lime/` |
+| Windows | `%APPDATA%\Lime\logs\` |

 ## 常见问题

@@ -251,3 +274,10 @@ Windows 构建强烈建议签名：
 # 设置签名证书
 export TAURI_SIGNING_PRIVATE_KEY="..."
 ```
+
+如果要让桌面端“检查更新后直接安装”可用，还需要同时配置：
+
+```bash
+export LIME_UPDATER_PUBLIC_KEY="..."
+export TAURI_SIGNING_PRIVATE_KEY_PASSWORD="..."
+```
@@ -33,6 +33,7 @@ Lime 是创作类 AI Agent 平台。

 - [首页与工作台](/user-guide/dashboard)
 - [资源库](/user-guide/resources)
+- [运行时 AGENTS 规则](/user-guide/runtime-agents)
 - [图片生成与编辑](/user-guide/image-generation)
 - [设置](/user-guide/settings)
 - [插件中心](/user-guide/plugins)