Install
openclaw skills install @thcjp/quick-context-saver-proopenclaw skills install @thcjp/quick-context-saver-pro零依赖本地记忆的完整形态。关系图谱、加密存储、多设备同步,企业级隐私保护。
你需要在本地记忆中建立记忆间的关联关系?你需要对敏感记忆加密存储?你需要多设备间同步记忆但不想用云端?你需要记忆自动过期归档避免膨胀?
快速上下文记忆专业版保持零外部依赖、零API Key、100%本地存储的隐私优势,同时解锁七大高级功能,提供企业级本地记忆管理能力.
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | Quick Context Saver处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
┌─────────────────────────────────────────────────────────────┐
│ 快速上下文记忆专业版 (QUICK CONTEXT SAVER PRO) │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ 关系图谱 │ │ 置信度评分 │ │ 过期机制 │ │
│ │ Relations │ │ Confidence │ │ Expiry │ │
│ │ │ │ │ │ │ │
│ │ 记忆关联 │ │ 来源标注 │ │ 自动归档 │ │
│ │ 关联检索 │ │ 验证次数 │ │ 过期清理 │ │
│ │ ✅ 专业版 │ │ ✅ 专业版 │ │ ✅ 专业版 │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │ │ │ │
│ └────────────────┼────────────────┘ │
│ ▼ │
│ ┌──────────────┐ │
│ │ 加密存储 │ ← AES加密 │
│ │ Encryption │ ✅ 专业版 │
│ └──────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────┐ │
│ │ 高级搜索 │ ← 语义+模糊+关联 │
│ │ Search │ ✅ 专业版 │
│ └──────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────┐ │
│ │ 多设备同步 │ ← Git Gist │
│ │ Sync │ ✅ 专业版 │
│ └──────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
本地初始化,立即可用:
# 安装与初始化
npm install -g quick-context-saver
cd your-project
memory-init
启用关系图谱与高级搜索:
# 存储带关联的记忆
memory-store --type decision --content "采用JWT认证" \
--importance 0.9 --tags auth,security \
--related-to "uuid-of-auth-memory"
# ...
# 三模式搜索
memory-search "认证方式" --mode semantic # 语义搜索
memory-search "auth" --mode fuzzy # 模糊匹配
memory-search "JWT" --mode related # 关联检索
配置全部高级功能:
{
"memory_pro": {
"relations": {
"enabled": true,
"auto_link": true,
"max_relations": 10
},
"confidence": {
"enabled": true,
"track_source": true,
"verify_threshold": 3
},
"expiry": {
"enabled": true,
"default_days": 90,
"auto_archive": true
},
"encryption": {
"enabled": true,
"algorithm": "aes-256-gcm",
"key_env": "MEMORY_ENCRYPTION_KEY"
},
"search": {
"mode": "auto",
"semantic_threshold": 0.7,
"fuzzy_distance": 2
},
"compression": {
"enabled": true,
"compress_after_days": 30,
"algorithm": "gzip"
},
"sync": {
"enabled": false,
"provider": "gist",
"interval": 3600
}
}
}
领先层:热内存(SESSION-STATE.json) - 活跃工作记忆
第二层:冷存储(索引化记忆) - 持久化可搜索记忆
第三层:策展归档(MEMORY.md + daily/) - 人类可读长期记忆
处理: 解析三层记忆架构(基础+增强)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回三层记忆架构(基础+增强)的响应数据,包含状态码、结果和日志.
input_params参数,支持创建/查询/导出操作基础TF-IDF搜索配合三种高级搜索模式:
| 搜索模式 | 算法 | 适用场景 | 专业版 |
|---|---|---|---|
| keyword | TF-IDF关键词匹配 | 精确关键词查询 | 基础 |
| semantic | 语义相似度匹配 | 概念相关查询 | 专业版 |
| fuzzy | 模糊匹配(编辑距离) | 容错查询 | 专业版 |
| related | 关联检索(图谱遍历) | 关联记忆查询 | 专业版 |
| auto | 自动选择最优模式 | 通用场景 | 专业版 |
# 自动模式(专业版智能选择最优搜索算法)
memory-search "数据库选择" --mode auto
# ...
# 语义搜索(找到概念相关的记忆)
memory-search "数据存储方案" --mode semantic
# ...
# 模糊匹配(容错查询)
memory-search "PostgrsSQL" --mode fuzzy # 拼写错误也能找到
# ...
# 关联检索(通过关系图谱遍历)
memory-search "JWT" --mode related # 找到所有关联记忆
处理: 解析TF-IDF智能搜索(基础+高级)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回TF-IDF智能搜索(基础+高级)的响应数据,包含状态码、结果和日志.
记忆间关联关系,支持关联检索:
{
"id": "uuid-1",
"content": "采用JWT认证",
"related_to": ["uuid-of-auth-memory", "uuid-of-security-memory"],
"followed_by": ["uuid-of-token-refresh-memory"],
"contradicts": ["uuid-of-old-auth-memory"]
}
# 存储带关联的记忆
memory-store --type decision --content "采用JWT认证" \
--related-to "uuid-of-auth-memory"
# ...
# 查看记忆的关系图谱
memory-relations --id "uuid-1"
# ...
# 关联检索
memory-search "JWT" --mode related
专业版优势:
处理: 解析记忆关系图谱(专业版)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回记忆关系图谱(专业版)的响应数据,包含状态码、结果和日志.
来源标注与验证次数追踪:
{
"confidence": 0.95,
"source": "explicit_user_statement",
"verified_count": 3,
"verified_by": ["user", "agent", "document"],
"last_verified": "2026-03-15T10:30:00Z"
}
# 存储带置信度的记忆
memory-store --type fact --content "PostgreSQL支持JSONB类型" \
--confidence 0.9 --source "official_docs"
# ...
# 验证记忆(增加验证次数)
memory-verify --id "uuid-1" --by "user"
# ...
# 查看高置信度记忆
memory-list --min-confidence 0.8
专业版优势:
处理: 解析置信度评分(专业版)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回置信度评分(专业版)的响应数据,包含状态码、结果和日志.
自动归档过期记忆:
{
"expires_at": "2026-04-15T00:00:00Z",
"auto_archive": true,
"archived_at": null
}
# 存储带过期的记忆
memory-store --type context --content "当前Sprint使用临时配置" \
--expires-in 30d
# ...
# 查看过期记忆
memory-list --expired
# ...
# 手动归档过期记忆
memory-archive --expired
# ...
# 清理已归档记忆
memory-cleanup --archived --older-than 90d
专业版优势:
处理: 解析过期机制(专业版)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回过期机制(专业版)的响应数据,包含状态码、结果和日志.
AES加密敏感记忆:
# 设置加密密钥
export MEMORY_ENCRYPTION_KEY="your-secret-key"
# ...
# 存储加密记忆
memory-store --type fact --content "API_KEY=sk-placeholder" \
--encrypt --importance 1.0
# ...
# 读取加密记忆(自动解密)
memory-search "API_KEY"
专业版优势:
处理: 解析加密存储(专业版)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回加密存储(专业版)的响应数据,包含状态码、结果和日志.
自动压缩旧记忆,节省存储:
# 启用自动压缩
memory-compress --enable --after-days 30
# ...
# 手动压缩指定时间前的记忆
memory-compress --older-than 30d
# ...
# 查看压缩统计
memory-stats --compression
专业版优势:
处理: 解析记忆压缩(专业版)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回记忆压缩(专业版)的响应数据,包含状态码、结果和日志.
通过Git Gist同步记忆:
# 配置同步
memory-sync --setup --provider gist --token "$GITHUB_TOKEN"
# ...
# 推送记忆到Gist
memory-sync --push
# ...
# 拉取记忆到本地
memory-sync --pull
# ...
# 双向同步
memory-sync --both
专业版优势:
处理: 解析多设备同步(专业版)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回多设备同步(专业版)的响应数据,包含状态码、结果和日志. 能力覆盖范围:本skill的核心能力覆盖以下场景关键词:零依赖本地记忆专、含关系图谱、企业级隐私保护、快速上下文记忆专、业版是零依赖本地、记忆系统的完整形、在免费版基础上解、锁记忆关系图谱、高级搜索算法、关联三模式、七大高级功能等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.
场景描述:企业使用AI Agent处理含敏感信息的业务,要求数据100%本地存储且敏感记忆加密,满足GDPR等合规要求. 配置:
{
"memory_pro": {
"encryption": {
"enabled": true,
"algorithm": "aes-256-gcm"
},
"confidence": {
"enabled": true,
"track_source": true
},
"expiry": {
"enabled": true,
"default_days": 30,
"auto_archive": true
}
}
}
操作流程:
效果:满足GDPR数据本地化要求,敏感记忆加密保护,数据保留周期合规可控.
场景描述:独立开发者使用3台设备(台式机/笔记本/平板)开发,需要记忆在多设备间同步但不想用云端服务. 操作流程:
# 在台式机配置同步
memory-sync --setup --provider gist --token "$GITHUB_TOKEN"
# ...
# 推送记忆到Gist
memory-sync --push
# ...
# 在笔记本拉取记忆
memory-sync --pull
# ...
# 双向同步(合并变更)
memory-sync --both
效果:3台设备记忆实时同步,无需自建服务器,Gist私有保证隐私,切换设备零成本.
场景描述:长期项目需要建立技术决策的知识图谱,决策间有关联关系,支持关联检索. 操作流程:
# 存储带关联的决策
memory-store --type decision --content "采用微服务架构" \
--related-to "uuid-of-domain-design" --importance 1.0
# ...
memory-store --type decision --content "使用API网关" \
--related-to "uuid-of-microservice" --followed-by "uuid-of-auth-design"
# ...
# 关联检索
memory-search "微服务" --mode related
效果:技术决策形成知识图谱,关联检索找到相关决策,架构决策原因可追溯.
场景描述:研究员使用AI Agent协助研究,需要追踪每条记忆的来源与验证状态,确保研究可追溯. 操作流程:
# 存储带来源的记忆
memory-store --type fact --content "实验组准确率提升15%" \
--confidence 0.95 --source "experiment-2026-03-15"
# ...
# 验证记忆
memory-verify --id "uuid-1" --by "peer-review"
# ...
# 按置信度过滤
9 --source "experiment"
效果:研究记忆可追溯来源与验证状态,确保学术严谨性,论文写作时快速引用.
场景描述:法律/医疗机构使用AI Agent,要求敏感信息加密、数据自动过期、完全本地存储. 操作流程:
# 加密存储敏感信息
memory-store --type fact --content "客户案件编号CASE-2026-001" \
--encrypt --expires-in 90d
# ...
# 自动过期清理
memory-archive --expired
memory-cleanup --archived --older-than 180d
效果:敏感信息加密存储,90天自动过期,180天自动清理,满足法律/医疗数据保留周期要求.
场景描述:团队积累大量本地记忆,需要压缩存储、关联检索、自动归档,避免记忆库膨胀. 操作流程:
# 启用自动压缩
memory-compress --enable --after-days 30
# ...
# 关联检索替代全量搜索
memory-search "部署" --mode related
# ...
# 定期归档清理
memory-archive --expired
memory-cleanup --archived --older-than 90d
| 角色 | 典型场景 | 推荐功能组合 | 核心价值 |
|---|---|---|---|
| 数据保护官 | 企业隐私保护 | 加密+置信度+过期 | 合规满足、数据安全 |
| 独立开发者 | 多设备同步 | Git Gist同步+增量 | 多设备无缝切换 |
| 架构师 | 知识图谱 | 关系图谱+关联检索 | 决策追溯、关联发现 |
| 研究员 | 研究可追溯 | 置信度+来源标注 | 学术严谨、可引用 |
| 合规官 | 法律/医疗合规 | 加密+自动过期 | 合规存储、自动清理 |
| 技术负责人 | 大规模记忆管理 | 压缩+归档+关联检索 | 存储优化、效率提升 |
| 安全工程师 | 敏感数据保护 | 加密+置信度+审计 | 数据加密、访问可控 |
# 在CI中同步团队记忆
memory-sync --pull
memory-search "部署配置" --mode related
{
"editor.memory": {
"enabled": true,
"autoRecall": true,
"recallTrigger": "onFileOpen",
"searchMode": "auto",
"maxResults": 5
}
}
# 导出记忆审计报告
memory-export --format json --include-confidence --include-source \
--output audit-report.json
# 加密备份全部记忆
memory-export --format json --encrypt --output encrypted-backup.json
# ...
# 推送备份到Gist
memory-sync --push --backup
--related-to参数--confidence参数--expires-in参数--encrypt参数# 从云端记忆系统导出
memory-export > cloud-backup.json
# ...
# 转换为本地格式
node convert-to-local.js cloud-backup.json > local-backup.json
# ...
# 导入本地记忆系统
memory-import --file local-backup.json
| 版本 | 日期 | 变更内容 |
|---|---|---|
| 1.0.0 | 2026-01 | 初版发布,含七大高级功能 |
| 序号 | 错误场景 | 原因 | 处理方式 | 优先级 |
|---|---|---|---|---|
| 1 | 输入参数缺失 | 用户未提供必要参数 | 提示用户提供所需参数后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令 | P0 |
| 2 | 执行超时 | 处理时间过长 | 检查输入数据量,分批处理 | P1 |
| 3 | 输出格式错误 | 结果不符合预期格式 | 检查output_format参数配置 | P1 |
免费版提供基础本地存储、TF-IDF关键词搜索、手动记忆管理、五类记忆分类。专业版解锁记忆关系图谱、置信度评分、过期机制、加密存储、高级搜索算法(语义/模糊/关联)、记忆压缩、多设备同步七大高级功能。此外提供多角色场景指南、性能优化策略和多平台集成示例.
影响极小。专业版采用选择性加密,仅加密敏感记忆,非敏感记忆明文存储。AES-256-GCM算法在现代CPU上有硬件加速,加密解密延迟<1ms。解密后的记忆会缓存,避免重复解密。建议仅对真正敏感的记忆启用加密.
同步通过GitHub Gist进行,Gist可设为私有,仅你自己可访问。同步数据可选择加密后再上传。增量同步仅传输变更部分。建议同步密钥与Gist token分开存储,避免同时泄露.
关联可通过三种方式建立:(1) 手动指定--related-to参数;(2) 自动链接,基于标签和内容相似度自动建立关联;(3) 时间序列,followed_by关系基于时间顺序自动建立。单记忆最多10个关联,避免图谱膨胀.
auto模式根据查询特征自动选择最优算法:(1) 查询包含精确关键词时用keyword模式;(2) 查询是自然语言问题时用semantic模式;(3) 查询包含拼写错误时用fuzzy模式;(4) 查询是单个概念词时用related模式。可配置各模式的切换阈值.
过期记忆不会立即删除,而是自动归档到memories/archived/目录。归档后可通过memory-list --archived查看,通过memory-restore --id恢复。归档超过90天的记忆可通过memory-cleanup --archived --older-than 90d清理。这是安全的过期处理机制.
置信度基于三个因素:(1) 来源可信度(用户陈述>文档>推断);(2) 验证次数(多次验证置信度更高);(3) 时间新鲜度(近期记忆置信度更高)。综合三因素得出0-1的置信度分数。可通过memory-verify命令增加验证次数.
不会。压缩采用Gzip无损算法,解压后完全恢复原始内容。压缩仅是存储优化,不影响记忆内容。读取时自动解压,使用无感知。建议对30天以上的记忆启用压缩,可节省60%存储空间.
可以。建议先加密敏感记忆,再同步到Gist。同步时加密记忆保持加密状态,Gist上存储的是密文。即使Gist泄露,没有密钥也无法解密。这是双层安全保护.
使用memory-export --encrypt --output backup.json导出加密备份。备份文件包含密文,需要密钥才能解密。建议密钥与备份分开存储,避免同时泄露。恢复时使用memory-import --file backup.json,系统会自动解密.
| 问题 | 可能原因 | 解决方案 | 优先级 |
|---|---|---|---|
| 加密记忆无法解密 | 密钥错误或缺失 | 验证MEMORY_ENCRYPTION_KEY环境变量 | 高 |
| 同步冲突 | 多设备同时修改 | 手动解决冲突;配置自动合并策略 | 中 |
| 关联检索无结果 | 关系图谱未建立 | 检查related_to字段;启用auto_link | 中 |
| 搜索结果不准 | 模式选择不当 | 尝试auto模式;调整阈值 | 低 |
| 压缩后读取失败 | 压缩文件损坏 | 从备份恢复;禁用压缩重新存储 | 高 |
| 过期记忆未归档 | auto_archive未启用 | 检查配置;手动执行memory-archive | 低 |
| 置信度计算异常 | 来源标注缺失 | 补充source字段;手动验证 | 低 |
| Gist同步失败 | token过期或网络问题 | 更新token;检查网络连接 | 中 |
| 关系图谱膨胀 | 关联过多 | 限制max_relations;清理无用关联 | 低 |
| 记忆导出失败 | 文件权限或磁盘空间 | 检查权限;清理磁盘空间 | 高 |
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent平台内置LLM提供 |
| Node.js 14+ | 运行时 | 必需 | 从nodejs.org安装 |
| quick-context-saver | npm包 | 必需 | npm install -g quick-context-saver |
| Node.js crypto | 内置模块 | 加密必需 | Node.js内置 |
| GitHub Gist API | API | 同步可选 | 配置GITHUB_TOKEN |
~/.agent/credentials/目录(已gitignore)本技能基于原始开源作品改进,保留原始版权声明:
本改进作品在原始作品基础上进行了深度差异化改造,包括但不限于:
本专业版相比免费版新增以下能力:
此外,专业版还提供:
| 版本 | 价格 | 功能 | 适用场景 |
|---|---|---|---|
| 免费体验版 | ¥0 | 本地存储+TF-IDF搜索+手动管理+五类分类+基础示例+基础FAQ | 个人试用、轻量记忆需求 |
| 收费专业版 | ¥19.9/月 | 关系图谱+置信度+过期+加密+高级搜索+压缩+多设备同步+多角色指南+性能优化+优先支持 | 团队/企业、隐私合规场景 |
专业版通过SkillHub SkillPay发布.
输出:返回执行结果,包含操作状态和输出数据
用户: 执行核心功能
Skill: 正在执行核心功能...
Skill: 执行完成,结果如下: 操作成功
```bash
# 在此执行相关操作
echo "操作完成"
```json
{
"success": true,
"data": {
"result": "Quick Context Saver处理结果",
"execution_time": "0.5s",
"metadata": {
"version": "1.0",
"processor": "quick context saver pro"
}
},
"execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
"error": null
}
已实现以下异常处理与可靠性保障: