User Guide
运行时 AGENTS 规则
使用 `~/.lime/AGENTS.md` 与 Workspace `.lime/AGENTS.md` 为 Lime 运行时会话提供稳定指令
运行时 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 运行时会话默认按下面顺序加载:
- 全局:
~/.lime/AGENTS.md - 工作区:
<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
适合放所有项目都通用的偏好,例如:
- 统一回复语言
- 默认输出结构
- 常用代码风格
- 你长期偏好的解释方式
直接复制下面模板即可:
# 我的全局 Lime 运行时规则
## 回复习惯
- 默认使用中文简体
- 先给结论,再给关键步骤
- 没必要时保持简洁,不要过度展开
## 工程偏好
- 优先选择 KISS 方案
- 优先修根因,不做表面补丁
- 先说明影响范围,再做改动
## 代码风格
- 尽量沿用现有项目风格
- 避免无关重构
- 没有明确收益时,不新增抽象层
Workspace .lime/AGENTS.md
适合放当前项目独有的规则,例如:
- 仓库使用的语言
- 文档与注释风格
- 目录边界
- 测试、构建、提交前检查要求
把下面内容保存为工作区内的 .lime/AGENTS.md:
# 当前项目运行时规则
## 项目背景
- 这是一个 React + Rust + Tauri 项目
- 前端使用 TypeScript
- 回答和文档默认使用中文简体
## 修改原则
- 先读后写
- 只改当前任务直接相关内容
- 保持现有目录结构和命名习惯
## 验证要求
- 前端改动后优先跑相关前端测试
- Rust 改动后优先跑相关单测
- 若无法完整验证,需要明确说明未验证部分
## 禁止事项
- 不要把临时排障脚本提交进仓库
- 不要修改与当前任务无关的配置
- 不要默认进行 git commit 或 push
.lime/AGENTS.local.md 示例
如果你想保留只在自己机器生效的补充规则,可以新建 .lime/AGENTS.local.md,并把它加入 .gitignore。
例如:
# 本机私有补充
- 优先使用本机已安装的 Node 与 Rust 工具链
- 如需浏览器调试,优先使用本机开发配置
- 涉及大体量编译时,先做定向测试再跑全量
推荐目录结构
workspace-root/
├─ .lime/
│ ├─ AGENTS.md
│ └─ AGENTS.local.md
├─ src/
├─ src-tauri/
└─ ...
你的全局文件位于:
~/.lime/AGENTS.md
注意事项
- Lime 运行时不会读取仓库根
AGENTS.md - Workspace
.lime/AGENTS.md只读取当前 workspace,不会向父目录递归回溯 - 如果团队要共享规则,请提交
.lime/AGENTS.md - 如果规则只属于你自己,请放进
.lime/AGENTS.local.md
推荐起步模板
如果你想先快速用起来,最小可用版本可以直接写:
# Lime 运行时规则
- 默认使用中文简体
- 先给结论,再展开说明
- 保持简洁,优先可执行建议
- 修改代码时先读后写
- 只改当前任务相关内容