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 运行时会话默认按下面顺序加载:

  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

适合放所有项目都通用的偏好,例如:

  • 统一回复语言
  • 默认输出结构
  • 常用代码风格
  • 你长期偏好的解释方式

直接复制下面模板即可:

# 我的全局 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 运行时规则

- 默认使用中文简体
- 先给结论,再展开说明
- 保持简洁,优先可执行建议
- 修改代码时先读后写
- 只改当前任务相关内容
Copyright © 2026