项目说明与记忆

模型开始干活之前会被告知哪些关于你和项目的信息：项目说明文件（NOETA.md、AGENTS.md、规则）、环境信息，以及自动记忆，也就是模型跨对话留给自己的笔记。另外还有任务清单。每一样都是一个插件，行为照搬 Claude Code，读的是 noeta 自己的文件。

项目说明文件

项目说明文件是你写给模型看的 markdown：怎么构建、怎么跑测试、有哪些约定、哪些地方它不说就会做错。instructions 插件在 Claude Code 读 CLAUDE.md 的那些位置读它们，只是换成 noeta 的文件名（noeta/plugins/instructions/）。Claude Code 自己的文件（CLAUDE.md、.claude/、~/.claude/）一概不读。

bash

noeta              # 然后输入 /init：模型会给这个项目写一份 NOETA.md

读哪些文件、按什么顺序

任务开始时项目说明文件从哪里来，以及碰到某个文件后哪些会跟着补上

任务第一次开始时，插件按下面的顺序读，全部放进你第一句话之前的一条消息里，每个文件都标出路径和类别：

机器统一管理的： 管理目录（/etc/noeta，macOS 上是 /Library/Application Support/Noeta）里的 NOETA.md 和 .noeta/rules/。
你自己的： ~/.noeta/NOETA.md 和 ~/.noeta/rules/。
项目的，从工作目录最外层的上级目录一路往里，直到工作目录本身，每一级读：NOETA.md 和 .noeta/NOETA.md，两个都没有时读这一级的 AGENTS.md（各家工具通用的文件）；.noeta/rules/ 下的规则；然后是 NOETA.local.md（你自己的，不提交）。
记忆： 自动记忆的索引 MEMORY.md（见下文）。

这条消息的第一行说明：这些说明优先于模型的默认行为。文件内容是对话日志的一部分，所以任务在任何工人上恢复，发出去的字节都一样。

规则、导入和按需出现的文件

规则是 .noeta/rules/ 目录（含子目录）下的 *.md 文件。frontmatter 里有 paths: 的规则是按需出现的：
markdown
```
---
paths: ["src/api/**", "tests/api/**"]
---
API handlers return `Result`, never raise.
```
开始时不给，等碰到它匹配的文件时才出现。
导入： 文件里（代码块之外）的 @路径 会把那个文件紧接着导入进来，类别相同，最多往下导入四层；每个文件只读一次。项目文件或本地文件发起的导入，必须留在工作目录内，或留在发起这串导入的那个文件所在的目录内（Claude Code 遇到外面的会先问你；noeta 没有这种提示，直接跳过）。
注释： 开头的 YAML frontmatter 会去掉，自成一块的 HTML 注释也会去掉，所以  不占模型的上下文。

跟着工作补上的文件

Read、Edit、Write 或 NotebookEdit 碰到工作目录里的某个文件，或者 Bash 命令显示了某个文件（cat、head 之类）时，适用于这个文件、而之前还没给过的说明文件会跟在工具结果后面补上：从工作目录到这个文件沿途每一级目录的说明文件，以及 paths: 能匹配上它的规则。所以 packages/api/NOETA.md 会在模型第一次进 packages/api/ 干活时送到。

你每发一条新消息，已经给过的文件都会重读一遍，内容变了的再给一次。压缩时会把它们全部重读，放在摘要前面。

被 Read 拒绝规则覆盖的文件（"deny": ["Read(./NOETA.local.md)"]）不加载，并会告诉你一声。每给出一个文件，InstructionsLoaded hook 触发一次（见 hook）。代理文件写了 omitClaudeMd: true 的（内置的 Explore 和 Plan）只看机器统一管理的那几个文件。终端界面里的 /memory 列出说明文件，可以在 $EDITOR 里打开。

没被信任的项目，它的 NOETA.md 和 AGENTS.md 照样会读：那只是给模型看的文字，不是代码。项目能执行或能改变行为的东西（插件、代理、自定义提示词、技能、设置）要等 noeta trust 之后才加载。

环境信息

environment 插件告诉模型它在什么环境里，相当于 Claude Code 系统提示词里的环境一节（noeta/plugins/environment/）。第一次请求时，紧跟在系统提示词后面：

text

# Environment
This conversation runs in the following environment:
 - Primary working directory: /home/me/src/my-project
 - Is a git repository: true
 - Additional working directories:
  - /home/me/src/shared-lib
 - Platform: linux
 - Shell: bash (login shell: zsh)
 - OS Version: Linux 6.8.0
 - Anything you download or unpack is untrusted input. …

Model: Sonnet 5.5, exact id `claude-sonnet-5-5`; knowledge cutoff ….

第一条用户消息里还有一份 git 快照（分支、截到 2,000 字符的 git status、最近五个提交），以及提交和 PR 的署名说明。之后随着任务推进：

有变化就告诉模型：换了模型、目录变成了仓库或 worktree、多了一个目录。上一轮结束后分支或 HEAD 动过的话，下一轮开始时重新拍一次 git 快照。
日期按你所在的时区算，noeta 的前端会把时区发过来（timezone，IANA 时区名）。没有时区的任务（比如服务器被一个不发时区的客户端驱动）拿到的是 UTC 日期，并注明是 UTC 的，绝不会用服务器本地的日期。过了午夜会告诉模型新的日期。
延迟加载的工具（要用 ToolSearch 加载的）只列名字。

它的设置来自 Claude Code 的设置键和插件参数：

设置	在哪儿	作用
`language`	设置文件	模型用这种语言回答（改了或去掉时会再告诉它）
`attribution.commit`、`attribution.pr`	设置文件	提交和 PR 的署名行；`""` 表示不要（`includeCoAuthoredBy: false` 两个都设为空）
`git_status = false`	`[plugins.environment]`	不要 git 快照
`model_name = false`	`[plugins.environment]`	不要模型那一行
`date_change = false`	`[plugins.environment]`	日期变了不通知
`enabled = false`	`[plugins.environment]`	整个环境信息都不要

自动记忆

自动记忆就是 Claude Code 的 auto memory：一个 markdown 文件目录，模型自己写，一个文件记一件事，跨对话保留（noeta/plugins/memory/）。noeta 命令默认打开它。

在哪儿： ~/.noeta/projects/<project>/memory/，<project> 是仓库主目录（不是某个 worktree；不在仓库里就是工作目录）的路径，其中字母数字以外的字符都换成 -。同一仓库的各个 worktree 共用一份。
怎么写： 系统提示词里的记忆一节告诉模型目录在哪、格式是什么（frontmatter 里的 name、description、metadata.type：user、feedback、project 或 reference）。模型用普通的 Write 和 Edit 工具建文件、改文件，在这个目录里写 markdown 在任何模式下都不用问。你也可以自己改。
索引： 同一目录下的 MEMORY.md，每条记忆一行。任务开始时，它的前 200 行、最多 25,000 个字符，和项目说明文件一起给模型；压缩后再给一次。
召回（可选）： 设了 recall_model，你每发一条消息，就问那个模型哪些记忆文件和它有关，最多附上五个（每个截到 200 行、4,096 字节；整个任务累计最多 61,440 个字符）。两天或更早以前改过的记忆会附一句提醒：可能已经过时。模型已经读过的文件不会再召回。

toml

[plugins.memory]
recall_model = "claude-haiku-5-5"   # 不设就不召回
# enabled = false                    # 不要自动记忆

终端界面里的 /memory 会显示索引的路径。记忆文件是任务执行环境里的普通文件，不是存储里的数据行；多台机器时，~/.noeta/projects 要放在共享盘上，或者放在远端执行环境里（见作为服务端运行）。

代理记忆

代理文件的 memory: 字段给这个代理一个单独的目录（Claude Code 的 agent memory）：

`memory:`	目录
`user`	`~/.noeta/agent-memory/<代理>/`
`project`	`<cwd>/.noeta/agent-memory/<代理>/`
`local`	`<cwd>/.noeta/agent-memory-local/<代理>/`

没有记忆插件的子代理会看到调用者的索引，但没有记忆那一节说明。

任务清单

todos 插件给模型提供 Claude Code 的任务清单：TaskCreate、TaskGet、TaskUpdate 和 TaskList（都要通过 ToolSearch 加载），连续十轮没用它们时提醒一次（noeta/plugins/todos/）。和 Claude Code 2.1.312 一样，默认只有比它的精简提示词更早的 Claude 模型（Claude 3 和 Claude 4，Opus 4.8 除外）才有；Claude 5 系列和其他所有模型（DeepSeek、网关上的模型名）都没有。要让所有模型都有：

toml

[plugins.todos]
all_models = true

只有顶层任务才有这些工具（子代理在后台跑）。清单是从任务日志推算出来的，所以压缩后还在，换哪个工人都一样，分叉或回退出来的任务一开始就带着它。终端界面里 Ctrl+T 显示它；网页版有个面板；编辑器里它就是 ACP 的计划（plan）。

项目说明与记忆 ​

项目说明文件 ​

读哪些文件、按什么顺序 ​

规则、导入和按需出现的文件 ​

跟着工作补上的文件 ​

环境信息 ​

自动记忆 ​

代理记忆 ​

任务清单 ​