Install
openclaw skills install @fyniujin/zwjh-skill统一记忆底座:长期记忆 + 知识图谱 + 自动沉淀 + 检索。让 AI「记得你」,跨会话持久记忆、实体/关系图谱、语义与时间线检索、记忆健康度审计、本地备份(可接百度网盘)。纯本地、零密钥、按硬件自适应,不拖累电脑。并保留 v1.7 的根因分析/预测性维护/进化报告。
openclaw skills install @fyniujin/zwjh-skill安装后说「帮我配置 + 设置定时任务」,AI 自动完成一切。
它是一个统一记忆底座,而不只是又一个「记忆 skill」:
- 🧠 长期记忆:跨会话持久记住你、项目、客户,减少重复解释背景
- 🕸️ 知识图谱:自动抽取「人 / 项目 / 任务 / 事件 / 文档」等实体与关系
- ⚙️ 自动沉淀:从对话 / 文件自动提炼知识点(去重 + 冲突消解)
- 🔎 检索:本地语义检索 + 时间线检索(零密钥、零联网、毫秒级)
- 🩺 健康度:审计记忆膨胀、压缩/快照,记忆可观测、可清理
- 💾 备份:导出 / 备份 / 恢复(本地 + 百度网盘可插拔)
- 🖥️ 不拖累电脑:自动探测硬件,按 CPU/内存分配并发与批大小
- 🔔 更新提醒:发现新版本主动提示你升级
v2.0.0:从「单技能」升级为「可插拔的记忆基础设施」,并完整保留 v1.7 的根因分析 / 预测性维护 / 进化报告能力。
传统 AI:每次对话从零开始 → 你反复解释背景 → 记忆散落各处、互不相通
会思考的进化 AI:理解本质 → 沉淀为记忆+图谱 → 跨会话检索 → 举一反三 → 自动进化
为什么做统一底座? 市面方案碎片化(各 skill 各存各的、跨 skill 不互通)。本技能把「记忆 + 图谱 + 检索 + 健康度」做成一个其他 skill 可直接调用的基础设施,而不是又一个孤立的记忆插件。
| 我想做 | 直接说 / 运行 |
|---|---|
| 一键启动自动进化 | 帮我配置 + 设置定时任务 |
| 记下一段对话/知识点 | python scripts/cli.py deposit --text "..." |
| 从文件沉淀知识 | python scripts/cli.py deposit --file notes.md |
| 语义检索记忆 | python scripts/cli.py query "谁负责机器学习项目" |
| 让 AI 用记忆回答 | python scripts/cli.py ask "我最近在做什么项目" |
| 查某段时间发生的事 | python scripts/cli.py timeline --from 2026-07-01 --to 2026-07-31 |
| 看知识图谱 | python scripts/cli.py graph list / graph show(Mermaid) |
| 记忆健康度体检 | python scripts/cli.py health |
| 压缩(去重+摘要) | python scripts/cli.py compact --apply |
| 备份 / 恢复 | python scripts/cli.py backup / restore <路径> |
| 写日记 | python scripts/cli.py diary --text "今天想清楚了一件事" |
| 看是否有新版本 | python scripts/cli.py update-check |
| 查看/消解冲突 | python scripts/cli.py conflicts |
| 一键配置定时任务 | python scripts/cli.py setup |
| 总览 | python scripts/cli.py status |
大部分时候你只需要说第一句,AI 自动完成一切。 其余命令是给「想精细操控」的高级用户。
1. 对 AI 说:「帮我配置 + 设置定时任务」
2. AI 自动完成:探测硬件 → 注册每日定时任务(python cli.py autopilot)
启动后,每天 23:00 自动执行:
补录每日日志 → 沉淀知识点 → 记忆分析(根因) → 预测风险 → 进化报告 → 健康巡检 → 更新提醒
你完全不用管,它自己会跑。 且定时任务由技能用系统自带能力注册(Windows 用 schtasks、macOS/Linux 用 crontab),不生成任何 .ps1 / .sh / .bat 脚本文件,更干净、更安全。
做了什么:把你的对话、文件、每日日志统一沉淀为可检索的长期记忆;另设「日记」自由记录。
~/.workbuddy/memory/(与 v1.7 完全兼容,原有每日日志原样保留)~/.workbuddy/memory/zwjh_store/示例:
python scripts/cli.py deposit --text "客户张三的对接人是李四,需求是智能客服" --source conversation
python scripts/cli.py diary --text "今天想清楚了一件事:记忆要先去重再沉淀"
做了什么:自动维护「人 / 项目 / 任务 / 事件 / 文档 / 概念 / 组织」等实体与关系。
负责 / 参与 / 隶属于 / 创建 / 依赖 / 导致 / 位于 / 关联add-entity / relate 注册自己的实体类型示例:
python scripts/cli.py graph add-entity --type person --name 张三 --importance 0.9
python scripts/cli.py graph relate --from 张三 --to 智能客服系统 --relation 负责
python scripts/cli.py graph show
做了什么:从对话 / 文件自动提炼知识点,并保证质量。
superseded,保留历史可追溯效果:
沉淀「客户李四对接的产品是智能客服系统」
→ 实体:客户李四(person)
→ 事实:(客户李四, 产品, 智能客服系统)
做了什么:两种检索,都不需要任何 API Key、不联网。
示例:
python scripts/cli.py query "谁负责机器学习项目"
python scripts/cli.py timeline --from 2026-07-01 --to 2026-07-31 --keyword 发布
其他 skill 也可直接调用
retrieval.ask(question)把长期记忆注入自己的上下文——这就是「可插拔基础设施」。
解决「记忆膨胀」痛点:记忆越多越慢、重复越多越乱。
--apply)python scripts/cli.py health
python scripts/cli.py compact --apply
python scripts/cli.py snapshot
做了什么:记忆可迁移、可恢复。
zwjh_store/backups/,自动保留最近 7 份config.json,不进技能包、不需要密钥);未配置时清晰提示,绝不偷偷联网python scripts/cli.py backup
python scripts/cli.py backup --target baidunetdisk # 需先配置凭证
python scripts/cli.py restore <备份目录路径>
做了什么:自动探测 CPU 核心数 / 物理内存 / 系统,把机器分 low / mid / high 三档,自动给出:
| 档位 | 并发 | 单批 | 向量缓存 | 适用 |
|---|---|---|---|---|
| low | 1 | 20 | 关 | ≤2 核或 <4GB |
| mid | 2 | 60 | 开 | ≤4 核或 <8GB |
| high | ≤8 | 200 | 开 | 更高配 |
recommend_subtasks(n):按任务量与档位建议拆成几个子任务(给上层调度用)low 档,绝不把电脑跑满python scripts/cli.py hardware
做了什么:本地比较「技能包版本」与「本机已见版本」,发现新版本主动提示你升级(不依赖联网 / 密钥)。
python scripts/cli.py update-check 立即查看autopilot 也会在结尾打印更新提示(若有)zwjh_store/installed_version.json,避免重复打扰python scripts/cli.py update-check
做了什么:当新记忆与旧记忆矛盾时,智能检测、分类、消解,避免"记错了还固执"。
示例:
python scripts/cli.py deposit --text "我之前记错了,张三其实去了字节跳动" --source conversation
# → 自动检测到纠错模式,新值覆盖旧值
python scripts/cli.py conflicts
# → 查看待处理冲突
python scripts/cli.py conflicts --resolve 1 --strategy 1
# → 处理冲突 #1,策略:覆盖
做了什么:多格式、可选中、跨平台迁移,消除数据锁定担忧。
示例:
python scripts/cli.py export --format markdown --output D:\backup
python scripts/cli.py export --format obsidian --from-day 2026-01-01 --to-day 2026-07-31
python scripts/cli.py export --format cypher --types person,project
python scripts/cli.py export --format csv --output D:\export
做了什么:把分散的记忆组织成连贯的叙事,从"数据库"变成"有温度的回忆"。
示例:
python scripts/cli.py narrative project --name "机器学习项目"
python scripts/cli.py narrative person --name "张三"
python scripts/cli.py narrative knowledge --name "Python"
python scripts/cli.py narrative weekly
python scripts/cli.py narrative monthly
做了什么:记忆从文字扩展到图片、音频、文件,全媒体覆盖。
示例:
python scripts/cli.py multimodal index-image --path D:\photo.jpg --entity "张三" --text "项目启动会合影"
python scripts/cli.py multimodal index-audio --path D:\meeting.mp3 --project "智能客服"
python scripts/cli.py multimodal index-file --path D:\contract.pdf --entity "李四" --project "合同审核"
python scripts/cli.py multimodal list --type image
做了什么:把 zwjh-skill 的核心能力暴露为 MCP Tool,让其他 skill / Agent 直接调用,「可插拔基础设施」定位落地。
zwjh_query(语义检索)/ zwjh_deposit(沉淀知识点)/ zwjh_health(健康度报告)mcp 包启动方式:
python scripts/mcp_server.py
# 或
python scripts/cli.py mcp
MCP 配置示例(~/.workbuddy/mcp.json):
{
"mcpServers": {
"zwjh-memory": {
"command": "python",
"args": ["D:/skill/zwjh-skill/scripts/mcp_server.py"]
}
}
}
做了什么:按访问频率 + 时间衰减自动控制记忆膨胀,「热记忆保持、温记忆摘要、冷记忆高压缩归档」。
0.6 × ln(access_count + 1) + 0.4 × exp(-days_since_access / 30)autopilot 末尾自动调用,无需手动干预hardware.tier 分配示例:
python scripts/cli.py archive --dry-run # 查看归档计划
python scripts/cli.py archive # 执行归档
python scripts/cli.py archive --stats # 查看归档统计
做了什么:在原有图谱可视化基础上,新增底部任务状态面板,autopilot 运行可观测。
启动方式:
python scripts/web_server.py
# 浏览器打开 http://127.0.0.1:8080 → 底部任务状态面板
做了什么:接入 bge-small-zh v1.5 ONNX 量化模型,实现真正的语义向量检索。
models/ 即启用语义检索模型信息:
models/bge-small-zh-v1.5-q.onnx做了什么:检索升级为语义/关键词/时间三路召回 RRF 融合排序,返回结果附命中理由。
示例:
python scripts/cli.py query "张三去哪了"
# 返回: [{day, source, score, snippet, explanation: {semantic, keyword, time, summary}}]
做了什么:后台分批重建存量记忆的向量索引,不阻塞使用。
示例:
python scripts/cli.py rebuild-index # 重建全部
python scripts/cli.py rebuild-index --batch 100 # 大批次
python scripts/cli.py embedder-info # 查看模型状态
做了什么:在浏览器中直观探索实体关系网络,从"黑盒存储"变为"可视化探索"。
启动方式:
python scripts/web_server.py [--port 8080]
# 浏览器打开 http://127.0.0.1:8080
原有「会思考的进化 AI」核心能力完整保留:
analyze:智能记忆分析(理解本质 / 根因 / 隐含需求 / 自动修复建议)predict:预测性维护(从历史推断明日风险)report:进化报告(成长趋势统计)demo:无数据时看效果python scripts/cli.py analyze
python scripts/cli.py predict
python scripts/cli.py report
python scripts/cli.py demo
ask "这个项目的关键人物和坑是什么" 快速上手import 复用sqlite3(WAL 模式,写入不阻塞)+ 每日日志原文(append-only)| v2.5.0 | 2026-08-24 | 新增:本地 embedding 层(ONNX BGE 语义向量 + TF-IDF 回退,模型外部放置 + SHA256 校验);新增混合检索(语义/关键词/时间三路召回 RRF 融合排序);新增检索解释(返回结果附命中理由分项);新增存量记忆一键重建索引(后台分批不阻塞);新增 embedder.py / rebuild_index.py;优化 retrieval.py 升级为 hybrid_search | | v2.4.0 | 2026-08-17 | 新增:跨 skill 记忆总线(MCP 服务器,暴露 query/deposit/health 为 MCP Tool,零依赖);新增自动归档策略(冷热分层 + 时间衰减热度分,autopilot 自动触发);新增任务状态 Web 面板(定时任务/健康度/归档统计可视化);新增 mcp_server.py / archive.py;新增 CLI archive / mcp 命令 | | v2.3.0 | 2026-08-07 | 新增:多格式导出(Markdown/JSON/Cypher/CSV/Obsidian/Logseq)与选择性筛选;新增时间线叙事生成(项目/人脉/知识成长/周期回顾);新增多模态记忆(图片/音频/文件索引);新增 export.py / narrative.py / multimodal.py | | v2.2.0 | 2026-07-29 | 新增:记忆冲突消解(冲突自动检测 + 四类分类 + 自动/手动消解策略);新增 conflict_resolver.py;新增 CLI conflicts 命令 | | v2.1.0 | 2026-07-17 | 新增:知识图谱 Web 可视化(力导向图/详情面板/路径探索/时间线/子图过滤);增加 web_server.py 零依赖内置 HTTP 服务器;增加大规模图谱分层加载与聚合;新增 REST API | | v2.0.0 | 2026-07-08 | 新增:统一记忆底座(长期记忆 + 知识图谱 + 自动沉淀 + 检索 + 健康度 + 备份);新增硬件自适应调度与技能更新提醒;保留 v1.7 能力;零密钥纯本地 | | v1.7.0 | 2026-06 | 优化:大幅简化操作(一键启动)、增强自愈能力(极少人工介入) | | v1.6.0 | 2026-05 | 新增:思维进化引擎、根因分析、一键定时任务 | | v1.5.0 | 2026-04 | 优化:友好错误处理、预测冷启动优化 | | v1.0.0 | 2026-03 | 初始版本发布 |
| 不支持 | 替代方案 |
|---|---|
| 修改 SKILL.md 本身 | 手动更新版本 |
| 删除 MEMORY.md | 只追加不删除 |
| 100% 自动修复 | 复杂情况给精确命令 |
| 完美概率预测 | 数据越多越准,冷启动也给建议 |
| 联网语义(默认) | 默认本地向量;如需更强语义可自行挂接嵌入适配器 |
| 百度网盘无凭证自动备份 | 先在 config.json 配置访问凭证,或用本地备份 |
说 「帮我配置 + 设置定时任务」,AI 自动探测硬件、注册定时任务。
说 「模拟演示」,用假数据看效果。之后再聊几天话就有了。
python scripts/cli.py task-status # 查看状态
python scripts/cli.py autopilot # 手动跑一次
python scripts/cli.py remove # 删除定时任务
记忆原文在 ~/.workbuddy/memory/,索引在 ~/.workbuddy/memory/zwjh_store/。
全部本地、不上传任何外部服务器、不要求任何密钥。
不会。技能自动探测硬件并限流:低配机单线程小批量,高配机才多并发;检索/沉淀分批处理。
python scripts/cli.py health 看健康度,compact --apply 压缩去重,snapshot 留底。
python scripts/cli.py backup 导出到本地备份目录,拷贝即可;到新机器 restore <路径>。
支持。定时任务用 crontab(由 setup 命令自动写入,不生成 .sh 文件)。
python scripts/cli.py update-check;每日自动进化也会提示。
直接 from scripts import retrieval, store, graph, deposit 调用;或用 CLI 的 ask / deposit 子命令。
Python 3.8+,标准库即可,无需安装任何第三方包。
~/.workbuddy/memory/ 的 Agent;Windows / macOS / Linux