# A_Memorix 同步说明

## 当前约定

- A_Memorix 主线源码位于 `src/A_memorix`
- 宿主接入层位于 `src/services/memory_service.py`、`src/webui/routers/memory.py` 与 dashboard 长期记忆页面
- 运行配置位于 `config/a_memorix.toml`
- 运行数据位于 `data/plugins/a-dawn.a-memorix/`
- 上游同步方式固定为 `git subtree`

## 首次接入

```bash
./scripts/sync_a_memorix_subtree.sh add
```

默认同步源：

- 远端：`https://github.com/A-Dawn/A_memorix.git`
- 分支：`MaiBot_branch`
- 前缀：`src/A_memorix`

## 后续更新

```bash
./scripts/sync_a_memorix_subtree.sh pull
```

等价命令：

```bash
git subtree pull --prefix=src/A_memorix https://github.com/A-Dawn/A_memorix.git MaiBot_branch --squash
```

## 本地修改边界

- `src/A_memorix` 只保留上游源码和必须的宿主兼容补丁
- 宿主接入、配置暴露、图谱页与控制台页优先放在 MaiBot 侧 host service / memory router / dashboard 页面中
- 不再通过插件框架特判承载 A_Memorix

## 同步后检查

1. 确认 `config/a_memorix.toml` 仍指向 `data/plugins/a-dawn.a-memorix`
2. 运行 `python src/A_memorix/scripts/runtime_self_check.py --help`
3. 运行 A_memorix 相关测试或最少执行一次针对性导入验证