CoPaw 记忆系统使用指南#

概述#

CoPaw 的记忆系统是一个强大的长期记忆管理工具，能够主动从对话中捕获决策、偏好和待办事项。你使用 CoPaw 越久，它就越了解你。

记忆系统概述#

什么是记忆系统#

记忆系统是 CoPaw 的核心组件之一，负责：

存储对话历史：保存用户与 CoPaw 的对话记录
提取关键信息：从对话中提取重要信息
长期记忆：持久化存储用户的偏好和习惯
智能检索：根据上下文快速检索相关信息

记忆类型#

类型	说明	存储方式	持久化
会话记忆	当前会话的对话历史	内存	否
长期记忆	跨会话的持久化信息	文件 / 数据库	是
工作记忆	当前任务相关的信息	内存	否
知识记忆	用户提供的知识库	文件 / 数据库	是

记忆特性#

特性：

主动性：主动从对话中捕获信息
语义化：使用语义搜索而非关键词匹配
个性化：根据用户行为调整记忆策略
持久化：信息长期保存，跨会话可用

记忆管理#

记忆 CLI 命令#

查看记忆：

PRTCL // BASH

1
# 查看所有记忆
2
copaw memory list
3

4
# 查看会话记忆
5
copaw memory list --type session
6

7
# 查看长期记忆
8
copaw memory list --type long-term
9

10
# 搜索记忆
11
copaw memory search keyword

添加记忆：

PRTCL // BASH

1
# 手动添加记忆
2
copaw memory add "我喜欢喝咖啡"
3

4
# 添加带标签的记忆
5
copaw memory add "我喜欢喝咖啡" --tags preference

删除记忆：

PRTCL // BASH

1
# 删除记忆
2
copaw memory remove <memory-id>
3

4
# 清空所有记忆
5
copaw memory clear

更新记忆：

PRTCL // BASH

1
# 更新记忆
2
copaw memory update <memory-id> "新的内容"
3

4
# 更新记忆标签
5
copaw memory update <memory-id> --tags new-tags

记忆配置#

配置文件：

PRTCL // YAML

1
memory:
2
  enabled: true
3

4
  # 记忆存储
5
  storage:
6
    type: "file"  # file, database, vector_db
7
    path: "~/.copaw/memory/"
8

9
  # 记忆限制
10
  limits:
11
    max_entries: 1000
12
    max_size: 104857600  # 100MB
13
    retention_days: 365
14

15
  # 记忆策略
16
  strategy:
17
    auto_extract: true
18
    extraction_threshold: 0.7
19
    consolidation_enabled: true
20
    consolidation_interval: 86400  # 1 天
21

22
  # 检索配置
23
  retrieval:
24
    enabled: true
25
    method: "semantic"  # semantic, keyword, hybrid
26
    top_k: 5
27
    threshold: 0.7
28

29
  # 缓存配置
30
  cache:
31
    enabled: true
32
    size: 100
33
    ttl: 3600

记忆类型配置#

会话记忆：

PRTCL // YAML

1
session_memory:
2
  enabled: true
3
  max_messages: 20
4
  strategy: "recent"  # recent, summary

长期记忆：

PRTCL // YAML

1
long_term_memory:
2
  enabled: true
3
  max_entries: 1000
4
  auto_extract: true
5
  extraction_types:
6
    - "preference"
7
    - "decision"
8
    - "todo"
9
    - "fact"

工作记忆：

PRTCL // YAML

1
working_memory:
2
  enabled: true
3
  max_items: 10
4
  strategy: "priority"

记忆提取#

自动提取#

CoPaw 会自动从对话中提取以下类型的信息：

偏好：

PRTCL // PLAINTEXT

1
用户：我喜欢喝咖啡，每天早上都要喝一杯
2
CoPaw：[记忆提取] 用户偏好：每天早上喝咖啡

决策：

PRTCL // PLAINTEXT

1
用户：我决定明天去北京出差
2
CoPaw：[记忆提取] 用户决策：明天去北京出差

待办事项：

PRTCL // PLAINTEXT

1
用户：我需要完成这个报告
2
CoPaw：[记忆提取] 用户待办：完成报告

事实：

PRTCL // PLAINTEXT

1
用户：我的手机号码是 13800138000
2
CoPaw：[记忆提取] 用户事实：手机号码 13800138000

手动添加#

添加记忆：

PRTCL // BASH

1
# 添加简单记忆
2
copaw memory add "我的生日是 1990 年 1 月 1 日"
3

4
# 添加带标签的记忆
5
copaw memory add "我的生日是 1990 年 1 月 1 日" --tags personal
6

7
# 添加带优先级的记忆
8
copaw memory add "我的生日是 1990 年 1 月 1 日" --priority high

批量导入#

从文件导入：

PRTCL // BASH

1
# 从 CSV 文件导入
2
copaw memory import memories.csv
3

4
# 从 JSON 文件导入
5
copaw memory import memories.json

CSV 格式：

PRTCL // CSV

1
content,tags,priority
2
我喜欢喝咖啡,preference,high
3
我的生日是 1990 年 1 月 1 日,personal,medium
4
我的电话是 13800138000,contact,high

JSON 格式：

PRTCL // JSON

1
[
2
  {
3
    "content": "我喜欢喝咖啡",
4
    "tags": ["preference"],
5
    "priority": "high"
6
  },
7
  {
8
    "content": "我的生日是 1990 年 1 月 1 日",
9
    "tags": ["personal"],
10
    "priority": "medium"
11
  }
12
]

记忆检索#

语义搜索#

语义搜索：

PRTCL // BASH

1
# 语义搜索
2
copaw memory search "咖啡" --method semantic
3

4
# 搜索结果
5
- 我喜欢喝咖啡 ( 相似度: 0.95)
6
- 我每天早上都要喝一杯咖啡 ( 相似度: 0.90)

关键词搜索#

关键词搜索：

PRTCL // BASH

1
# 关键词搜索
2
copaw memory search "咖啡" --method keyword
3

4
# 搜索结果
5
- 我喜欢喝咖啡
6
- 我每天早上都要喝一杯咖啡

混合搜索#

混合搜索：

PRTCL // BASH

1
# 混合搜索
2
copaw memory search "咖啡" --method hybrid
3

4
# 搜索结果（语义 + 关键词）
5
- 我喜欢喝咖啡 ( 相似度: 0.95, 匹配: 是 )
6
- 我每天早上都要喝一杯咖啡 ( 相似度: 0.90, 匹配: 是 )

按标签搜索#

按标签搜索：

PRTCL // BASH

1
# 按标签搜索
2
copaw memory search --tags preference
3

4
# 搜索结果
5
- 我喜欢喝咖啡 ( 标签: preference)
6
- 我喜欢编程 ( 标签: preference)

记忆管理#

记忆维护#

查看记忆统计：

PRTCL // BASH

1
# 查看记忆统计
2
copaw memory stats
3

4
# 输出示例
5
总记忆数: 150
6
会话记忆: 20
7
长期记忆: 130
8
记忆大小: 5.2MB

清理过期记忆：

PRTCL // BASH

1
# 清理过期记忆
2
copaw memory cleanup --days 30
3

4
# 清理重复记忆
5
copaw memory cleanup --duplicates
6

7
# 清理无用记忆
8
copaw memory cleanup --unused

合并相似记忆：

PRTCL // BASH

1
# 合并相似记忆
2
copaw memory merge --threshold 0.8
3

4
# 输出示例
5
合并 5 个相似记忆

记忆导出#

导出记忆：

PRTCL // BASH

1
# 导出为 JSON
2
copaw memory export memories.json
3

4
# 导出为 CSV
5
copaw memory export memories.csv
6

7
# 导出为 Markdown
8
copaw memory export memories.md

记忆备份#

备份记忆：

PRTCL // BASH

1
# 创建备份
2
copaw memory backup --output backup-$(date +%Y%m%d).json
3

4
# 自动备份
5
copaw memory backup --schedule "0 2 * * *"

记忆集成#

在对话中使用记忆#

记忆增强对话：

PRTCL // PLAINTEXT

1
用户：明天我要去北京
2
CoPaw：[检索记忆] 根据之前的记忆，你喜欢去北京出差。需要我帮你准备什么吗？
3

4
用户：帮我订一张去北京的机票
5
CoPaw：[检索记忆] 你的偏好是靠窗座位，我将为你预订靠窗座位。

记忆触发器#

创建触发器：

PRTCL // YAML

1
triggers:
2
  - name: "birthday_reminder"
3
    type: "time"
4
    schedule: "0 0 1 1 *"  # 每年 1 月 1 日
5
    action: "memory_search"
6
    query: "生日"
7
    response: "生日快乐！"
8

9
  - name: "coffee_preference"
10
    type: "keyword"
11
    keyword: "咖啡"
12
    action: "memory_search"
13
    query: "咖啡"
14
    response: "我知道你喜欢喝咖啡！"

记忆与技能集成#

技能使用记忆：

PRTCL // PYTHON

1
from copaw.skills import Skill
2
from copaw.memory import MemoryManager
3

4
class MySkill(Skill):
5
    """我的技能"""
6

7
    def __init__(self, config):
8
        super().__init__(config)
9
        self.memory = MemoryManager()
10

11
    def execute(self, input_data):
12
        # 检索记忆
13
        memories = self.memory.search(input_data['query'])
14

15
        # 使用记忆
16
        result = self.process_with_memory(input_data, memories)
17

18
        return result

记忆安全#

访问控制#

配置访问权限：

PRTCL // YAML

1
security:
2
  enabled: true
3
  access_control:
4
    read:
5
      enabled: true
6
      allowed_users:
7
        - "user@example.com"
8
    write:
9
      enabled: true
10
      allowed_users:
11
        - "user@example.com"
12
    delete:
13
      enabled: true
14
      allowed_users:
15
        - "user@example.com"

数据加密#

加密配置：

PRTCL // YAML

1
encryption:
2
  enabled: true
3
  algorithm: "AES-256"
4
  key_source: "env"
5
  key_name: "MEMORY_ENCRYPTION_KEY"

隐私保护#

敏感信息过滤：

PRTCL // YAML

1
privacy:
2
  enabled: true
3
  filters:
4
    - type: "phone"
5
      action: "mask"
6
    - type: "email"
7
      action: "mask"
8
    - type: "address"
9
      action: "mask"
10
    - type: "password"
11
      action: "skip"

记忆优化#

检索优化#

优化检索速度：

PRTCL // YAML

1
retrieval:
2
  enabled: true
3
  method: "semantic"
4
  top_k: 5
5
  threshold: 0.7
6
  cache:
7
    enabled: true
8
    size: 100
9
    ttl: 3600
10
  index:
11
    type: "faiss"  # faiss, hnsw
12
    dimension: 768

存储优化#

优化存储空间：

PRTCL // YAML

1
storage:
2
  type: "file"
3
  path: "~/.copaw/memory/"
4
  compression:
5
    enabled: true
6
    algorithm: "gzip"
7
  cleanup:
8
    enabled: true
9
    interval: 86400
10
    retention_days: 365

性能监控#

监控记忆性能：

PRTCL // BASH

1
# 查看记忆性能
2
copaw memory performance
3

4
# 输出示例
5
检索平均时间: 0.05s
6
检索成功率: 99.5%
7
存储使用率: 52%

故障排查#

记忆无法保存#

问题：记忆无法保存

解决方案：

PRTCL // BASH

1
# 检查记忆配置
2
copaw memory config validate
3

4
# 检查存储权限
5
ls -la ~/.copaw/memory/
6

7
# 检查磁盘空间
8
df -h

记忆检索失败#

问题：记忆检索失败

解决方案：

PRTCL // BASH

1
# 重建索引
2
copaw memory rebuild-index
3

4
# 检查记忆状态
5
copaw memory status
6

7
# 查看检索日志
8
copaw logs | grep memory

记忆重复#

问题：记忆重复

解决方案：

PRTCL // BASH

1
# 清理重复记忆
2
copaw memory cleanup --duplicates
3

4
# 合并相似记忆
5
copaw memory merge --threshold 0.8

最佳实践#

记忆管理建议#

定期清理：定期清理过期和无用的记忆
合理分类：使用标签对记忆进行分类
控制数量：控制记忆数量，避免信息过载
备份重要记忆：定期备份重要记忆

记忆提取建议#

主动标注：对重要记忆进行标注
定期整理：定期整理和更新记忆
验证准确性：验证记忆的准确性
保护隐私：保护敏感信息

记忆使用建议#

合理检索：使用合适的检索方法
上下文相关：确保记忆与上下文相关
持续更新：持续更新和优化记忆
监控性能：监控记忆系统性能

资源链接#

CoPaw 记忆文档: https://copaw.bot/docs/memory
记忆系统论文: https://arxiv.org/abs/xxxx.xxxxx
向量数据库文档: https://copaw.bot/docs/vector-db

最后更新: 2026-03-12 作者: EchoHaoRan

CoPaw 记忆系统使用指南#

概述#

记忆系统概述#

什么是记忆系统#

记忆类型#

记忆特性#

记忆管理#

记忆 CLI 命令#

记忆配置#

记忆类型配置#

记忆提取#

自动提取#

手动添加#

批量导入#

记忆检索#

语义搜索#

关键词搜索#

混合搜索#

按标签搜索#

记忆管理#

记忆维护#

记忆导出#

记忆备份#

记忆集成#

在对话中使用记忆#

记忆触发器#

记忆与技能集成#

记忆安全#

访问控制#

数据加密#

隐私保护#

记忆优化#

检索优化#

存储优化#

性能监控#

故障排查#

记忆无法保存#

记忆检索失败#

记忆重复#

最佳实践#

记忆管理建议#

记忆提取建议#

记忆使用建议#

资源链接#

CoPaw记忆系统使用指南

Dify知识库使用指南

Ollama使用指南

CoPaw安装和部署指南

网工

评论