# 2026-03-18

## mac 集群角色语义更新

- 已确认新的稳定角色定义：
  - `mac-5 = brain`（控制与编排）
  - `mac-6 = hands`（执行与算力）
  - `mac-7 = eyes`（浏览器与验收）
- 已据此修改记忆系统相关文档，使长期基线、记忆索引与当前运行态统一到这套角色语义
- 记忆系统规划保持不变：
  - 单 Gateway / 单记忆主入口仍在 `mac-5`
  - `mac-6` 与 `mac-7` 仍作为 Node Host，不各自演化为独立控制面

## opencode 默认模型规则更新

- 原先“`opencode` 默认使用各机器本地模型”的描述已失效，不应继续作为当前默认规则使用
- 当前生效的默认策略为：
  - `mac-5`：`opencode/minimax-m2.5-free`
  - `mac-6`：`vllm/Qwen3.5-27B` via `http://100.64.0.5:8000/v1`
  - `mac-7`：`vllm/Qwen3.5-27B` via `http://100.64.0.5:8000/v1`

## 验证记录

- `mac-5` 上 direct `opencode` 与 ACP 最小测试已通过 `opencode/minimax-m2.5-free`
- 从 `mac-6` / `mac-7` 实测 `http://100.64.0.5:8000/v1/models`，可见模型：
  - `Qwen3.5-27B`
- 已将 `mac-6` / `mac-7` 的 `~/.config/opencode/opencode.json` 更新为 `vllm` provider 配置
- `mac-6` ACP 最小测试结果：`MAC6_VLLM_ACP_OK`
- `mac-7` ACP 最小测试结果：`MAC7_VLLM_ACP_OK`

## 备注

- 这次更新针对的是 `opencode` 默认模型策略，不等于废弃原有 subagent / worker 的本地模型拓扑说明
- 后续涉及 `opencode` 默认模型时，应优先引用本日规则，而不是旧的“每机默认本地 oMLX”说法

## 工程目录默认规则确定

- 已确定正式工程项目的默认根目录使用：`~/project/workspace`
- 理由：
  - 与 `~/openclawd` 运行时目录分离
  - 与 `~/project/collective-memory-repo` 记忆系统分离
  - 便于 `mac-5` / `mac-6` / `mac-7` 统一使用相同路径语义
  - 便于 OpenClaw / ACP / OpenCode 默认按统一路径落盘与调度
- 已确定每个正式项目使用项目容器结构：
  - `~/project/workspace/<project-name>/repos/`
  - `~/project/workspace/<project-name>/worktrees/`
  - `~/project/workspace/<project-name>/shared/`
  - `~/project/workspace/<project-name>/docs/`
  - `~/project/workspace/<project-name>/scripts/`
  - `~/project/workspace/<project-name>/tmp/`
- 多机协作默认采用方案 A：
  - 三台机器各自保留本地项目副本
  - 代码同步以 git remote 为主
  - 不以文件级实时同步 `.git` / `worktree` 元数据作为主协作方式
- 项目环境管理规则已补充：
  - 每个正式项目默认优先使用 Pixi 管理环境
  - 每个项目应有 `pixi.toml`
  - `.pixi/` 不纳入 git 跟踪
  - 若 Pixi 失效或不适用，可使用 UV 作为后备方案
  - 默认应把 Pixi 作为首选项目环境管理器
- 已新增长期决策文档：`shared/long-term/decisions/project-workspace-layout.md`
- 已新增可复用初始化脚本：`scripts/init-project-workspace.sh`
  - 用于快速创建标准项目容器目录
  - 会初始化 `repos/`、`worktrees/`、`shared/`、`docs/`、`scripts/`、`tmp/`
  - 会生成项目级 `docs/PROJECT-RULES.md`
  - 该规则文档内已包含 Pixi 优先、`.pixi/` 不跟踪、UV 作为后备方案的说明