atomix-cli 0.1.0 → 1.0.0

package/README.md

@@ -39,6 +39,7 @@ atomix model                # 模型配置管理：list | add | use <名称> | q
 | `!命令` | 直接执行 shell 命令（输出仅本地显示，不进模型上下文） |
 | `/resume` `/clear` `/compact` | 切换会话 / 清空上下文 / 压缩上下文 |
 | `/skills` `/agents` `/mcp` `/marketplace` | 组件启停、列表与插件市场 |
+| `/memory` | 长期记忆 / 人设文件：`list` 状态与路径，`show` / `path <scope>`（scope = `global\|project\|soul`）、`write <global\|project> <一行>`（末尾追加；soul 不支持写，人设由模型维护或编辑器改）、`config <persona\|global\|project> <on\|off>`（写 config.json，重启生效） |
 | `/theme` `/glyphs` `/thinking` | 主题 / 字形风格 / 思考开关 |
 | Ctrl+V | 粘贴剪贴板图片或文本 |
 | Esc / ↑↓ | 中断当前轮 / 输入历史 |
@@ -49,20 +50,43 @@ atomix model                # 模型配置管理：list | add | use <名称> | q
 
 ```
 ~/.atomix/                # 用户级（环境变量 ATOMIX_ROOT 可覆盖）
+├── config.json           # 主题 / 字形 / 生态共享 / persona / memory 开关
 ├── model.conf            # 模型配置
 ├── history/<项目>/       # 会话历史，按项目隔离
-├── skills/ agents/ commands/ mcp.json hooks.json
-└── AGENT.md              # 全局规则
+├── MEMORY.md             # 用户级长期记忆（模型可维护）
+├── projects/<项目>/MEMORY.md   # 项目级长期记忆（与 history/<项目> 同键）
+├── SOUL.md               # 人设（可选，persona.enabled=true 时读取）
+├── harness/<名称>/       # harness 定义（harness.yaml + rules.md）
+└── skills/ agents/ commands/ mcp.json hooks.json
 
 <项目目录>/
-├── AGENT.md | CLAUDE.md  # 项目规则（即本项目的"人设"）
-└── .atomix/              # 项目级 skills / agents / commands / mcp.json / hooks.json
+├── AGENTS.md             # 项目协议（存在即默认加载；入库）
+└── .atomix/              # 项目级 skills / agents / commands / mcp.json / hooks.json / harness-state.json
 ```
 
+### 记忆与人设
+
+- **长期记忆**：用户级 `~/.atomix/MEMORY.md` 与项目级 `~/.atomix/projects/<项目>/MEMORY.md` 在每个新会话（及压缩后）注入上下文，主代理可直接维护（无需逐次确认），子代理只读。文件不存在即不注入，不预创建。
+- **人设**：`~/.atomix/SOUL.md` 属 base（默认关闭，开启后作为最高权威的 persona 段注入，模型可按你的口头调整落盘）；harness 可自带专属人设 `harness/<名称>/SOUL.md`（存在即用，切 profile 即覆盖；不带人设的 harness 下人设为关）。
+- **项目协议** `<项目>/AGENTS.md`：与记忆、人设互不相关，存在即加载；不给子代理默认注入（主代理派任务时转述）。
+- 开关在 `~/.atomix/config.json`，改动重启会话生效：
+
+```jsonc
+{
+  "persona": { "enabled": false },
+  "memory":  { "enabled": true, "global": true, "project": true }
+}
+```
+
+- harness 有两档:`prompt.disable: [memory-notes]` 只关掉"维护记忆"的提示段（仍注入、只是模型不再主动写）;`harness.yaml` 顶层 `memory:` / `persona:` 三态开关注入本身——`off` 本 harness 下连注入一起关（子代理同）、`on` 强制开（`config.json` 关着也开,memory 的 `global`/`project` 细分仍尊重 config）、缺省跟随 config。切走即回 config 状态。设计见 [记忆与人设 v1](docs/memory-v1.md)。
+- `/memory config <persona|global|project> <on|off>` 免开编辑器改 `config.json` 开关（重启会话生效）。
+
 ## 文档
 
 - [开发文档](docs/development.md)：从源码构建、架构、贡献指南
 - [设计方案](docs/dev-plan-v0.md)
+- [记忆与人设 v1](docs/memory-v1.md)：MEMORY.md / SOUL.md / AGENTS.md 的边界、存储、开关与权限
+- [Harness 可插拔 v1](docs/harness-plugin-v1.md)、[P0/P1 验收说明](docs/harness-plugin-p0p1-review.md)
 
 ## License