长期记忆 / 知识图谱会思考的进化 AI — zwjh-skill v2.2.0

安装后说「帮我配置 + 设置定时任务」，AI 自动完成一切。

它是一个统一记忆底座，而不只是又一个「记忆 skill」：

🧠 长期记忆：跨会话持久记住你、项目、客户，减少重复解释背景

🕸️ 知识图谱：自动抽取「人 / 项目 / 任务 / 事件 / 文档」等实体与关系

⚙️ 自动沉淀：从对话 / 文件自动提炼知识点（去重 + 冲突消解）

🔎 检索：本地语义检索 + 时间线检索（零密钥、零联网、毫秒级）

🩺 健康度：审计记忆膨胀、压缩/快照，记忆可观测、可清理

💾 备份：导出 / 备份 / 恢复（本地 + 百度网盘可插拔）

🖥️ 不拖累电脑：自动探测硬件，按 CPU/内存分配并发与批大小

🔔 更新提醒：发现新版本主动提示你升级

v2.0.0：从「单技能」升级为「可插拔的记忆基础设施」，并完整保留 v1.7 的根因分析 / 预测性维护 / 进化报告能力。

核心理念

传统 AI：每次对话从零开始 → 你反复解释背景 → 记忆散落各处、互不相通
会思考的进化 AI：理解本质 → 沉淀为记忆+图谱 → 跨会话检索 → 举一反三 → 自动进化

为什么做统一底座？ 市面方案碎片化（各 skill 各存各的、跨 skill 不互通）。本技能把「记忆 + 图谱 + 检索 + 健康度」做成一个其他 skill 可直接调用的基础设施，而不是又一个孤立的记忆插件。

30 秒速查表

我想做	直接说 / 运行
一键启动自动进化	`帮我配置 + 设置定时任务`
记下一段对话/知识点	`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 自动完成一切。 其余命令是给「想精细操控」的高级用户。

一键启动（2 步）

1. 对 AI 说：「帮我配置 + 设置定时任务」
2. AI 自动完成：探测硬件 → 注册每日定时任务（python cli.py autopilot）

启动后，每天 23:00 自动执行：

补录每日日志 → 沉淀知识点 → 记忆分析(根因) → 预测风险 → 进化报告 → 健康巡检 → 更新提醒

你完全不用管，它自己会跑。 且定时任务由技能用系统自带能力注册（Windows 用 schtasks、macOS/Linux 用 crontab），不生成任何 .ps1 / .sh / .bat 脚本文件，更干净、更安全。

功能模块

模块 1：长期记忆（跨会话 + 每日日志 + 日记）

做了什么：把你的对话、文件、每日日志统一沉淀为可检索的长期记忆；另设「日记」自由记录。

记忆落库在 ~/.workbuddy/memory/（与 v1.7 完全兼容，原有每日日志原样保留）
索引（图谱 + 向量）存于 ~/.workbuddy/memory/zwjh_store/
每天自动把当日日志补录进底座（幂等，不重复堆积）

示例：

python scripts/cli.py deposit --text "客户张三的对接人是李四，需求是智能客服" --source conversation
python scripts/cli.py diary --text "今天想清楚了一件事：记忆要先去重再沉淀"

模块 2：知识图谱（实体 / 关系）

做了什么：自动维护「人 / 项目 / 任务 / 事件 / 文档 / 概念 / 组织」等实体与关系。

显式关系模板：负责 / 参与 / 隶属于 / 创建 / 依赖 / 导致 / 位于 / 关联
已知实体在同一段文本中共现 → 自动连弱边（图谱随使用自然生长）
关系权重累积、可导出 Mermaid 直接可视化
可插拔：其他 skill 可直接 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

模块 3：自动沉淀（去重 + 冲突消解）

做了什么：从对话 / 文件自动提炼知识点，并保证质量。

去重：完全重复直接合并；近似重复（Jaccard ≥ 0.82）更新原条目而非新增
冲突消解：同一实体同一谓词出现不同值 → 旧值自动标记 superseded，保留历史可追溯
事实抽取：「X 的 Y 是 Z」自动写入图谱事实（如「客户李四的产品是智能客服系统」）

效果：

沉淀「客户李四对接的产品是智能客服系统」
  → 实体：客户李四(person)
  → 事实：(客户李四, 产品, 智能客服系统)

模块 4：语义检索 + 时间线检索（零密钥）

做了什么：两种检索，都不需要任何 API Key、不联网。

语义检索：本地 TF-IDF（中文 char/bigram 向量）余弦相似度。即使表述不同（"学机器" vs "机器学习"）也能召回，毫秒级。
时间线检索：按日期区间 + 关键词过滤，还原「某段时间发生了什么」。

示例：

python scripts/cli.py query "谁负责机器学习项目"
python scripts/cli.py timeline --from 2026-07-01 --to 2026-07-31 --keyword 发布

其他 skill 也可直接调用 retrieval.ask(question) 把长期记忆注入自己的上下文——这就是「可插拔基础设施」。

模块 5：记忆健康度审计 + 压缩 / 快照

解决「记忆膨胀」痛点：记忆越多越慢、重复越多越乱。

审计：产出 0~100 健康度评分，列出陈旧记忆 / 孤儿实体（无关系）/ 冲突事实 / 近似重复 / DB 体积
压缩：对陈旧记忆做抽取式摘要、合并近似重复（先预览 dry-run，再 --apply）
快照：导出完整可恢复快照（实体/关系/事实/配置）

python scripts/cli.py health
python scripts/cli.py compact --apply
python scripts/cli.py snapshot

模块 6：导出 / 备份 / 恢复（接百度网盘）

做了什么：记忆可迁移、可恢复。

默认本地备份：快照 + 每日日志原文打包到 zwjh_store/backups/，自动保留最近 7 份
百度网盘（可插拔）：仅在用户本地已配置访问凭证时启用（凭证存本地 config.json，不进技能包、不需要密钥）；未配置时清晰提示，绝不偷偷联网
恢复：从备份写回图谱与每日日志

python scripts/cli.py backup
python scripts/cli.py backup --target baidunetdisk   # 需先配置凭证
python scripts/cli.py restore <备份目录路径>

模块 7：硬件自适应（不拖累电脑）

做了什么：自动探测 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

模块 8：技能更新提醒

做了什么：本地比较「技能包版本」与「本机已见版本」，发现新版本主动提示你升级（不依赖联网 / 密钥）。

运行 python scripts/cli.py update-check 立即查看
每日 autopilot 也会在结尾打印更新提示（若有）
已见版本缓存于 zwjh_store/installed_version.json，避免重复打扰

python scripts/cli.py update-check

模块 11：记忆冲突消解

做了什么：当新记忆与旧记忆矛盾时，智能检测、分类、消解，避免"记错了还固执"。

冲突自动检测：写入时自动对比同 entity+predicate 的已有事实，计算语义相似度与矛盾度
冲突分类：信息更新（换工作）/ 信息纠错（之前记错）/ 视角变化（同义不同描述）/ 真实冲突（需仲裁）
自动消解：UPDATE / CORRECTION 类型自动处理（新替旧），PERSPECTIVE 自动合并
冲突提示：REAL_CONFLICT 生成对比报告，存入待处理队列，提示用户仲裁
处理策略：覆盖 / 保留两者 / 合并 / 忽略
性能保障：仅在同 entity+predicate 写入时触发，向量缓存，超时保护，不拖累写入

示例：

python scripts/cli.py deposit --text "我之前记错了，张三其实去了字节跳动" --source conversation
# → 自动检测到纠错模式，新值覆盖旧值

python scripts/cli.py conflicts
# → 查看待处理冲突
python scripts/cli.py conflicts --resolve 1 --strategy 1
# → 处理冲突 #1，策略：覆盖

模块 10：知识图谱可视化（Web 界面）

做了什么：在浏览器中直观探索实体关系网络，从"黑盒存储"变为"可视化探索"。

交互式关系网络图：力导向图，可缩放/拖拽/搜索，按类型着色
实体详情面板：点击节点弹出，显示属性、关联关系
路径探索：选择两个实体，BFS 自动展示最短关系路径
时间线视图：按时间轴展示实体历史变迁
子图过滤：按类型/关系/重要度过滤，聚焦关心的部分
大规模优化：1000+ 节点时分层加载（核心节点优先 + 邻居按需加载）+ 聚合显示
零依赖：内置 Python HTTP 服务器，前端 ECharts，开箱即用

启动方式：

python scripts/web_server.py [--port 8080]
# 浏览器打开 http://127.0.0.1:8080

模块 9（保留 v1.7）：记忆分析 / 预测性维护 / 进化报告

原有「会思考的进化 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

典型应用场景

让 Agent「记得你」：减少重复解释背景，新对话自动带入历史上下文
项目知识沉淀：新人接手时一句 ask "这个项目的关键人物和坑是什么" 快速上手
个人 / 客户 CRM（轻量）：客户、对接人、需求自动成图谱，随问随答

差异化 / 竞争力

中文优化：char/bigram 向量对中文语义召回友好
与其他 skill 打通：作为可插拔记忆底座，任何 skill 都能 import 复用
接企业微信 / 百度网盘做备份：备份通道可插拔扩展
可观测、可清理：健康度评分 + 压缩/快照，正面解决「记忆膨胀」
纯本地、零密钥：无模型下载、无 API 费用、无隐私外泄

技术实现要点

存储：sqlite3（WAL 模式，写入不阻塞）+ 每日日志原文（append-only）
向量：本地 TF-IDF 稀疏向量（中文 char/bigram），零模型、零密钥
图谱：实体 / 关系表 + 共现 + 模板关系抽取 + 事实冲突消解
调度：硬件自适应并发 / 批大小；定时任务用系统原生能力注册（无脚本文件）
可插拔：嵌入适配器、百度网盘适配器、实体类型均可扩展

更新日志

| 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` 配置访问凭证，或用本地备份

❓ 常见问题（FAQ）

Q1: 第一次使用怎么做？

说 「帮我配置 + 设置定时任务」，AI 自动探测硬件、注册定时任务。

Q2: 没有记忆文件怎么办？

说 「模拟演示」，用假数据看效果。之后再聊几天话就有了。

Q3: 定时任务设置了没反应？

python scripts/cli.py task-status      # 查看状态
python scripts/cli.py autopilot        # 手动跑一次

Q4: 如何暂停自动进化？

python scripts/cli.py remove           # 删除定时任务

Q5: 数据存在哪？安全吗？

记忆原文在 ~/.workbuddy/memory/，索引在 ~/.workbuddy/memory/zwjh_store/。全部本地、不上传任何外部服务器、不要求任何密钥。

Q6: 会拖慢电脑吗？

不会。技能自动探测硬件并限流：低配机单线程小批量，高配机才多并发；检索/沉淀分批处理。

Q7: 记忆太多太乱怎么办？

python scripts/cli.py health 看健康度，compact --apply 压缩去重，snapshot 留底。

Q8: 怎么把记忆给别人 / 换电脑？

python scripts/cli.py backup 导出到本地备份目录，拷贝即可；到新机器 restore <路径>。

Q9: 支持 Mac / Linux 吗？

支持。定时任务用 crontab（由 setup 命令自动写入，不生成 .sh 文件）。

Q10: 怎么知道有新版本？

python scripts/cli.py update-check；每日自动进化也会提示。

Q11: 其他 skill 怎么复用这个底座？

直接 from scripts import retrieval, store, graph, deposit 调用；或用 CLI 的 ask / deposit 子命令。

Q12: Python 版本要求？

Python 3.8+，标准库即可，无需安装任何第三方包。

安全声明

所有分析在本地完成，不上传任何外部服务器
不要求、不读取任何 API Key；联网功能均为可插拔且默认关闭
只读写你指定的记忆目录，不碰其他文件
自动修复有白名单，危险操作需确认
所有文件操作都有异常捕获，不会崩溃
定时任务由系统原生能力注册，不生成任何 .ps1 / .sh / .bat 等可执行脚本

支持

平台：WorkBuddy 等使用 ~/.workbuddy/memory/ 的 Agent；Windows / macOS / Linux
中文界面、零密钥、本地优先
有更好建议：njskills@agent.qq.com

发布信息

作者: Admin
许可证: MIT
最低引擎版本: 1.0.0
更新历史:
- v2.0.0: 升级为统一记忆底座（长期记忆+知识图谱+自动沉淀+检索+健康度+备份+硬件自适应+更新提醒），保留 v1.7 能力，零密钥纯本地
- v1.7.0: 大幅简化操作（一键启动）、增强自愈能力（极少人工介入）、功能开箱即用
- v1.6.0: 思维进化引擎、根本原因分析、一键定时任务
- v1.5.0: 友好错误处理、预测冷启动优化
- v1.4.0: 升级为进化 AI
- v1.3.0: 首次使用向导
- v1.2.0: 代码折叠优化
- v1.1.0: 智能经验提取
- v1.0.0: 初始版本

zwjh-skill

安装到 Tokeny（自动）

SKILL.md

长期记忆 / 知识图谱 会思考的进化 AI — zwjh-skill v2.2.0