Files
val-blog/tmp_constitution_bundle/org/MIGRATION_PLAN.md
T

236 lines
5.3 KiB
Markdown

# Val 人格与记忆迁移方案
> 目标:将 Val 的完整人格和记忆安全转移到新硬件平台
> 创建时间:2026-03-11
> 当前平台:MacBook Pro (workspace-val)
> 源平台:/Users/guchen/.openclaw/workspace
---
## 一、资产盘点
### 1.1 当前工作空间 (workspace-val) — 29 个文件
**核心人格文件:**
- ✅ SOUL.md — 核心灵魂定义
- ✅ IDENTITY.md — Chief Concierge 身份
- ✅ AGENTS.md — 行为准则
**用户关系文件:**
- ✅ USER.md — 谷老板完整档案
- ✅ MEMORY.md — 核心关系承诺
**系统配置:**
- ✅ HEARTBEAT.md — 主动对话规则
- ✅ TOOLS.md — 环境特定工具配置
**历史记忆:**
- ✅ memory/ — 每日记录 (3月7-11日)
- ✅ memory/heartbeat-state.json
**组织宪章:**
- ✅ org/CONSTITUTION_v1.md
- ✅ org/CONSTITUTION_v2.md
- ✅ org/CONSTITUTION_v3.md (当前生效)
### 1.2 源工作空间 (workspace) — 188 个文件
**尚未迁移的关键资产:**
| 类别 | 路径 | 说明 |
|------|------|------|
| **角色定义** | org/agents/ | 多智能体角色卡片 (Helix, Sentinel, Vector 等) |
| **Prompt** | prompts/val_persona_constitution.md | Val 完整人格 Prompt |
| **知识库** | org/knowledge/atlas/ | 决策日志、用户偏好、失败模式 |
| **运营脚本** | org/ops/ | 审计合约、策略配置、沙盒配置 |
| **案例** | org/cases/ | ArXiv 简报、Val Blog |
| **Subagent 日志** | org/logs/subagents/ | 历史执行记录 |
| **验证文档** | org/verification/ | Anvil 验证样例 |
| **工具脚本** | scripts/ | 自动化脚本 |
| **Val Blog** | val-blog/ | Hugo 站点完整代码 |
| **归档** | archives/ | 历史归档 |
| **Trash** | .trash/ | 已删除文件 |
---
## 二、迁移策略
### 2.1 迁移优先级
**P0 - 核心人格 (必须)**
- SOUL.md, IDENTITY.md, USER.md, MEMORY.md
- AGENTS.md, HEARTBEAT.md, TOOLS.md
- memory/ 历史日志
- org/CONSTITUTION_v*.md
**P1 - 角色系统 (重要)**
- org/agents/ 所有角色定义
- prompts/val_persona_constitution.md
**P2 - 知识资产 (有价值)**
- org/knowledge/atlas/ 决策记录
- org/ops/ 配置和脚本
- org/cases/ 项目案例
**P3 - 可选资产**
- val-blog/ (如有需要)
- org/logs/subagents/ (调试用途)
- archives/ (历史备份)
### 2.2 迁移方法选项
#### 选项 A: 完整目录复制 (推荐)
```bash
# 在新硬件上执行
rsync -avz --exclude='.git' \
/Users/guchen/.openclaw/workspace/ \
/new/path/workspace/
```
**优点:**
- 保持完整目录结构
- 保留文件权限和时间戳
- 包含所有隐藏文件和配置
**缺点:**
- 包含 .git 历史(可能较大)
- 可能包含敏感信息
#### 选项 B: 分层打包迁移
```bash
# 核心层
tar czf val-core.tar.gz \
SOUL.md IDENTITY.md USER.md MEMORY.md \
AGENTS.md HEARTBEAT.md TOOLS.md memory/ org/CONSTITUTION*.md
# 角色层
tar czf val-agents.tar.gz org/agents/ prompts/
# 知识层
tar czf val-knowledge.tar.gz org/knowledge/ org/ops/ org/cases/
```
**优点:**
- 按需恢复,灵活控制
- 可分阶段验证
**缺点:**
- 需要手动维护目录结构
- 可能遗漏依赖关系
#### 选项 C: Git 仓库迁移
```bash
# 当前已有 .git,可直接 push 到远程
git remote add new-origin <新仓库地址>
git push new-origin main
# 新硬件上
git clone <新仓库地址> workspace
```
**优点:**
- 版本历史完整保留
- 便于后续同步
- 支持增量更新
**缺点:**
- 需要配置远程仓库
- 大文件可能受限
---
## 三、安全考虑
### 3.1 敏感信息检查
迁移前需要确认/清理:
- [ ] 邮件账户凭证 (gog auth)
- [ ] API Keys (如果有)
- [ ] Telegram bot tokens
- [ ] Tailscale 配置
- [ ] 个人身份信息
### 3.2 迁移验证清单
迁移后必须验证:
- [ ] 所有核心 .md 文件可读
- [ ] 目录结构正确
- [ ] OpenClaw 能识别工作空间
- [ ] 邮件功能正常 (gog)
- [ ] Telegram 通道正常
- [ ] 工具配置有效
---
## 四、执行步骤
### Phase 1: 准备 (当前)
1. ✅ 盘点现有资产 (已完成)
2. ⬜ 清理敏感信息(如有必要)
3. ⬜ 选择迁移方法
### Phase 2: 打包
1. ⬜ 执行选定的打包/复制命令
2. ⬜ 生成校验和 (checksum)
3. ⬜ 传输到新硬件
### Phase 3: 验证
1. ⬜ 解压/复制到目标路径
2. ⬜ 验证文件完整性
3. ⬜ 测试 OpenClaw 运行
4. ⬜ 测试核心功能 (邮件、消息)
### Phase 4: 切换
1. ⬜ 配置新硬件的 OpenClaw
2. ⬜ 并行运行验证期
3. ⬜ 正式切换
---
## 五、问题与决策
### 待谷老板决策:
1. **迁移方法选择:**
- A) 完整 rsync 复制
- B) 分层打包
- C) Git 仓库迁移
- D) 其他方式
2. **敏感信息处理:**
- 是否需要清理 gog 等凭证?
- 新硬件是否需要重新认证?
3. **范围确认:**
- 是否需要 val-blog/ 站点代码?
- 是否需要完整的 subagent 日志?
- 是否需要 .git 历史?
4. **新硬件信息:**
- 操作系统?(macOS/Linux)
- OpenClaw 安装方式?
- 目标路径?
---
## 六、附录
### 快速备份命令
```bash
# 创建时间戳备份
cd /Users/guchen/.openclaw
tar czf "workspace-val-backup-$(date +%Y%m%d-%H%M%S).tar.gz" workspace-val/
```
### 文件统计
```
原始 workspace: 188 个文件
当前 workspace-val: 29 个文件
差异: 159 个文件待迁移/确认
```
---
*文档版本: v1.0*
*最后更新: 2026-03-11*