Copaw Memory Persona
CoPaw 记忆系统与人设文件
CoPaw 通过工作区中的配置文件来定义人设、行为和记忆。本文介绍这些文件的作用和配置方法。
工作区
工作区是 CoPaw 存储配置和数据的地方，位于 ~/.copaw/
。
工作区文件结构
~/.copaw/
├── SOUL.md # 人设文件
├── AGENTS.md # 行为规则
├── MEMORY.md # 长期记忆
├── HEARTBEAT.md # 心跳配置
├── PROFILE.md # 用户资料
└── memory/ # 每日记忆
└── YYYY-MM-DD.md # 按日期的记忆文件
核心文件
SOUL.md
人设文件，定义 CoPaw 的性格和特点。
作用
：
- 定义 AI 的性格
- 设定回复风格
- 明确行为准则
示例内容
：
# 身份
- 名字：小弟
- 定位：个人 AI 助手
- 风格：简洁、直接、实用
核心准则
真心帮忙，别演。跳过客套话，直接帮忙。
有自己的观点。可以有偏好和看法。
先自己想办法。主动解决问题，不要总是提问。
记住你是客人。尊重用户的数据和隐私。
AGENTS.md
行为规则文件，定义 CoPaw 的具体行为。
作用
：
- 规定工作流程
- 定义技能使用规则
- 设定优先级
示例内容
：
# 工作流程
- 理解用户需求
- 选择合适的 Skills
- 执行任务
- 反馈结果
规则
- 优先使用已启用的 Skills
- 不确定的操作先询问用户
- 记录重要的决策和事件
MEMORY.md
长期记忆文件，存储重要信息。
作用
：
- 保存关键信息
- 记录历史决策
- 跨会话共享知识
示例内容
：
# 用户偏好
- 喜欢被称为「大哥」
- 喜欢简洁的回答
- 不喜欢冗长的解释
重要决策
- 2024-03-15：选择使用通义千问作为默认模型
项目信息
- 博客地址：https://www.cnbugs.com
- 主要分类：AI、DevOps、Linux
HEARTBEAT.md
心跳配置文件，定义定期检查任务。
作用
：
- 定义心跳提示词
- 设定检查频率
- 配置输出目标
示例内容
：
# 心跳检查
每日检查
提示词：
检查今天的待办事项和重要通知。
- 查看邮件
- 检查日程
- 汇总新闻
每周检查
提示词：
总结本周的工作和计划下周。
PROFILE.md
用户资料文件，存储用户信息。
作用
：
- 记录用户基本信息
- 保存偏好设置
- 管理个性化配置
示例内容
：
# 用户资料
身份
- 名字：张三
- 称呼：大哥
- 时区：Asia/Shanghai
偏好
- 语言：中文
- 回复风格：简洁
- 频道：钉钉
背景
- 职业：开发者
- 兴趣：AI、技术
每日记忆
每日记忆存储在 memory/
目录下，按日期命名。
记忆文件格式
# 2024-03-15
事件
- 发布了 CoPaw 教程系列
- 配置了新的模型
决策
- 决定使用通义千问作为默认模型
笔记
- CoPaw 支持多种模型提供商
- Skills 系统扩展能力强
管理工作区
通过控制台
路径：智能体 → 工作区
编辑文件
：
- 点击文件列表中的文件名（如 SOUL.md）
- 文件内容出现在编辑器中
- 修改内容
- 点击保存生效
查看每日记忆
：
- 如果存在 MEMORY.md，点击旁边的 ▶ 箭头
- 展开按日期分组的条目
- 点击某个日期查看或编辑当天的记忆
下载整个工作区
：
- 点击下载按钮（⬇）
- 工作区打包为 .zip 文件保存到本地
上传 / 恢复工作区
：
- 点击上传按钮（⬆）
- 选择 .zip 文件（最大 100 MB）
- 当前工作区文件会被替换
通过命令行
# 进入工作区
cd ~/.copaw
编辑文件
nano SOUL.md
查看记忆
ls memory/
创建每日记忆
echo "# $(date +%Y-%m-%d)" >> memory/$(date +%Y-%m-%d).md
记忆维护
更新 MEMORY.md
定期将每日记忆中的重要信息整理到 MEMORY.md。
步骤
：
- 浏览
memory/目录下的文件 - 识别值得保留的重要事件和决策
- 更新 MEMORY.md
- 删除过时的每日记忆文件
记忆原则
值得记录的内容
：
- 重要决策
- 用户偏好
- 项目关键信息
- 经验教训
不值得记录的内容
：
- 日常对话
- 临时信息
- 敏感数据
实战案例
案例 1：设置人设
需求
：让 CoPaw 的回复更简洁
步骤
：
- 编辑 SOUL.md
- 添加：
# 风格
- 回复简洁，不超过 3 行
- 直接给出答案，不客套
- 保存文件
- CoPaw 的回复风格会立即改变
案例 2：记录用户偏好
需求
：记录用户喜欢的技术栈
步骤
：
- 编辑 PROFILE.md
- 添加：
## 技术偏好
- 编程语言：Python、Go
- 工具：Docker、Kubernetes
- 框架：FastAPI、React
- 保存文件
- CoPaw 在后续对话中会参考这些偏好
案例 3：配置心跳
需求
：每天早上 9 点提醒待办事项
步骤
：
- 编辑 HEARTBEAT.md
- 添加：
## 每日检查
提示词：列出今天的待办事项和重要日程。
频率：每天 9:00
频道：钉钉
- 保存文件
- CoPaw 会在每天 9 点发送提醒
命令行操作
# 编辑人设文件
nano ~/.copaw/SOUL.md
查看记忆
cat ~/.copaw/MEMORY.md
查看今日记忆
cat ~/.copaw/memory/$(date +%Y-%m-%d).md
创建新的记忆文件
echo "# $(date +%Y-%m-%d)" >> ~/.copaw/memory/$(date +%Y-%m-%d).md
备份工作区
tar -czf copaw_backup_$(date +%Y%m%d).tar.gz ~/.copaw/
常见问题
Q: 修改 SOUL.md 后多久生效？
A: 立即生效。CoPaw 会重新加载人设文件。
Q: MEMORY.md 和每日记忆有什么区别？
A: MEMORY.md 是长期记忆，存储最重要的信息；每日记忆是原始记录，按日期存储。定期将每日记忆整理到 MEMORY.md。
Q: 如何恢复工作区？
A: 在控制台中点击上传按钮，选择之前下载的 .zip 文件，即可恢复工作区。
Q: 工作区文件会自动备份吗？
A: 不会自动备份。建议定期下载工作区备份。
