Xpersona
agentCLAWHUBUnverified

MindVault 思维永生

Agent 记忆与长期记忆管理：对话备份归档成本地 JSONL，防 AI 失忆——换电脑、换会话都不丢记忆；从历史萃取规则生成快照，支持 Claude Code / WorkBuddy / OpenClaw 等本地框架，纯标准库 Skill: MindVault 思维永生 Owner: zhouxin121 Summary: Agent 记忆与长期记忆管理：对话备份归档成本地 JSONL，防 AI 失忆——换电脑、换会话都不丢记忆；从历史萃取规则生成快照，支持 Claude Code / WorkBuddy / OpenClaw 等本地框架，纯标准库 Tags: DRAS-V:1.1.3, agent:1.2.6, agent memory:1.2.3, archive:1.2.6, claudecode:1.2.6, conversation:1.2.3, conversation-archiver:1.1.3, cross-platform:1.1.3, dras-v:1.0.5, jsonl:1.2.6, latest:1.2.6, long-term memory:1.2.3, memory:1.2.6, memory-evolution:1.0

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

1.1k

Updated

Oct 11, 2026

Version

1.2.6

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 11, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 11, 2026
Adoption signal
1.1K downloadsadoption · observed Oct 11, 2026
Latest release
1.2.6release · observed Oct 2, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17dbbh1tx81e0khknjnnrm5r589bn00:mindvault-agent-memory
  1. Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-zhouxin121-mindvault-agent-memory/snapshot"

Documentation

CLAWHUB

146,542 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: mindvault
slug: mindvault
displayName: MindVault 思维永生
display_name: MindVault 思维永生
version: "1.2.6"
description: "Agent 记忆与长期记忆管理：对话备份归档成本地 JSONL，防 AI 失忆——换电脑、换会话都不丢记忆；从历史萃取规则生成快照，支持 Claude Code / WorkBuddy / OpenClaw 等本地框架，纯标准库"
display_description: "MindVault 对话归档与记忆进化引擎（基础版免费）：对话增量备份为 JSONL、长期规则萃取、项目快照生成、可选 DRAS-V 五步思考协议。支持 OpenClaw / AutoClaw / Marvis / WorkBuddy / CherryStudio / Coze，数据全部保存在本地。"
keywords:
  - memory
  - 记忆
  - long-term memory
  - memory management
  - forget
  - 失忆
  - 对话备份
  - 对话归档
  - Agent 长期记忆
  - 上下文恢复
  - 项目快照
  - 规则萃取
  - 记忆系统
  - 数据主权
  - DRAS-V
  - mindvault
  - conversation-archiver
  - longterm-memory
  - memory-evolution
  - project-snapshot
tags:
  - 对话归档
  - 长期记忆
  - 项目快照
  - Agent 记忆
  - JSONL 备份
  - 上下文恢复
author: zhouxin121
license: MIT
category: memory
platforms:
  - openclaw
  - claudecode
  - autoclaw
  - marvis
  - workbuddy
  - cherrystudio
  - coze
permissions:
  - read
  - write
  - exec
tested:
  date: "2026-09-18"
  os: macOS 15.8
  python: "python3（系统内置，无需 pip 依赖）"
  platforms: OpenClaw / AutoClaw / Marvis / WorkBuddy / CherryStudio / Coze
  rounds: 5000+ 轮实战验证
  source: 同一用户长期持续使用，68 个归档文件 / 14,949 条目 / 951 轮实测
AIGC:
    Label: "1"
    ContentProducer: 001191440300708461136T1XGW3
    ProduceID: 4fd20e68f8b80beb1e39f35a6c960ac4_5a36f32380cc11f1afc3525400de82e7
    ReservedCode1: cPCUf98FXzhSQuaTmXjcnJEOQKwUqWLgQ8FTrr8cHvIdBg8zVJ947DiNpMHuJpjZM3HwBP9mHw10z3Pv+XdjK9SWKOK4l5l+AGEF5mpaJla0Hp3D9uHa3PVsBVi6o7AOdEXupmUlBLVEUogmyajzXO9W2I0mOcFRorG9QlPwNR8Sa71dVOm1w2pSrqM=
    ContentPropagator: 001191440300708461136T1XGW3
    PropagateID: 4fd20e68f8b80beb1e39f35a6c960ac4_5a36f32380cc11f1afc3525400de82e7
    ReservedCode2: cPCUf98FXzhSQuaTmXjcnJEOQKwUqWLgQ8FTrr8cHvIdBg8zVJ947DiNpMHuJpjZM3HwBP9mHw10z3Pv+XdjK9SWKOK4l5l+AGEF5mpaJla0Hp3D9uHa3PVsBVi6o7AOdEXupmUlBLVEUogmyajzXO9W2I0mOcFRorG9QlPwNR8Sa71dVOm1w2pSrqM=
---

# MindVault 思维永生 — Agent 对话归档与记忆进化引擎（基础版 · 免费）

> **一句话**：把每轮对话存成可检索的本地 JSONL 分片，从历史对话里萃取长期规则、生成项目快照，让新会话不用从零讲背景。
> **输出物**：`archive/<对话标签>/chat_*.jsonl`（对话归档）、`memory/FACT.md`（规则）、`PROJECT_SNAPSHOT.md`（项目快照）
> **触发方式**：用户主动说「归档对话」「执行进化引擎」「生成项目快照」「走流程」；不主动说，Agent 不做任何写入。
> **实测**：5000+ 轮实战验证；68 个归档文件 / 14,949 条目的索引统计耗时 0.07 秒（macOS 15.8）。

本 Skill 解决 Agent 长期使用中的三个具体问题：**对话窗口溢出后内容丢失**、**每次新会话都要重新教规则**、**中断后无法快速恢复项目上下文**。所有数据以开放格式存放在本地，换平台可直接迁移。

---

## Privacy & Security（使用前请阅读）

- **数据存储位置**：所有备份文件写入本地 `archive/` 目录（每个对话一个子目录，含 `_index.json` 索引），不上传任何云端。
- **敏感信息提醒**：对话归档会保存你的原始消息。如果你在对话中输入过密码、密钥、个人信息，它们也会被一并保存。**建议避免在对话中输入敏感信息；已归档的敏感条目可自行编辑或删除对应 JSONL 行。**
- **数据生命周期**：归档文件由用户自行管理，可随时删除、导出、迁移。本 Skill 不设自动清理，也不做异地留存；如需定期清理，由用户自行配置。
- **用户主动触发**：归档、进化、快照三类操作均需用户明确说出触发指令。Agent 不会在后台静默保存；如需自动归档，请用户自行配置 cron 或定时任务（本 Skill 不内置任何定时器）。
- **DRAS-V 思考协议**：DRAS-V 是**用户主动选择**的思考方法，用户说「走流程」/「DRASV」时激活一次，默认不启用，Agent 不会强制覆盖自身行为。
- **规则加载检测短语**：可选的验证短语（默认关闭），内容与位置由用户自行设定，可随时修改或删除；用于自检规则是否仍在上下文内。
- **写操作可审计**：规则写入采用「先 read 再合并」，不整文件覆写；索引写入带 `index_version` 乐观版本令牌。

---

## 一、核心功能：这个 Skill 能做什么

| 能力 |

README.md

# MindVault 思维永生
> 📦 **一键安装**：[ClawHub 页面](https://clawhub.ai/zhouxin121/skills/mindvault-agent-memory) · OpenClaw 用户搜索 `mindvault-agent-memory` 直接装
 — Agent 对话归档与记忆进化引擎

> **把你的 Agent 对话存成可检索的本地 JSONL，从历史里萃取规则，新会话不用再从零讲背景。**
> 5000+ 轮实战验证 · 纯本地存储 · 输出 `archive/*.jsonl` + `memory/FACT.md` + `PROJECT_SNAPSHOT.md` · MIT 开源
> 跨平台：OpenClaw / AutoClaw / Marvis / WorkBuddy / CherryStudio / Coze

MindVault 是一套**Agent 对话归档与长期记忆基础设施**，解决 AI Agent 长期使用中的三个具体问题：**对话窗口溢出后内容丢失**、**每次新会话都要重新教规则**、**中断后无法快速恢复项目上下文**。它用三层架构（对话归档 → 规则萃取 → 项目快照）让 Agent 拥有可检索的长期记忆与结构化思考能力，所有数据以开放格式存在本地，换平台可无缝迁移。

---

## 快速开始（3 条命令）

```bash
# 1) 全量归档对话（以 OpenClaw 为例；Marvis 走 data.db，WorkBuddy 走 ~/.workbuddy）
python3 scripts/archive_export.py openclaw <sessions目录> <归档目录> --conv-label <对话标签>

# 2) 查看归档规模与待处理文件
python3 scripts/archive_index.py <归档目录> stats

# 3) 日常增量归档（可反复执行，只导出新轮次）
python3 scripts/archive_export.py openclaw <sessions目录> <归档目录> --conv-label <对话标签> --incremental
```

无第三方依赖，`python3` 标准库即可运行（Python 3.10+）。完整参数与故障排查见 [SKILL.md](SKILL.md)。

---

## 它能做什么

| 能力 | 说明 | 输出物 | 实现 |
|------|------|--------|------|
| **对话归档 / 对话备份** | 每 15 轮切分一个 JSONL，按对话隔离存储，增量归档不重复不丢轮次 | `archive/<标签>/chat_*.jsonl` + `_index.json` | `archive_export.py`（openclaw / marvis / workbuddy 三模） |
| **规则萃取（记忆进化）** | 从历史对话提取偏好规则与项目模式，标注置信度（推测 / 确认 / 反复验证） | `memory/FACT.md` | `archive_index.py` + Agent 提炼 |
| **项目快照（上下文恢复）** | 用三遍扫描法生成项目快照，下次对话直接继承全部背景 | `PROJECT_SNAPSHOT.md` | 三遍扫描法 |
| **归档可读回溯** | JSONL 一键转人类可读 Markdown | `*.md` | `jsonl_to_md.py`（minimal 模式） |
| **可选五步思考** | 说「走流程」/「DRASV」时激活一次完整推理链路，不跳步、可审计 | 推理过程（不落盘） | DRAS-V 协议 |

---

## 技术架构

```
Layer 1 对话归档            Layer 2 规则萃取            Layer 3 项目快照
┌────────────────┐        ┌────────────────┐        ┌────────────────────┐
│ 每轮对话         │  ───→  │ 高频模式提取     │  ───→  │ PROJECT_SNAPSHOT.md │
│ → JSONL 分片     │        │ → FACT.md 规则   │        │ （唯一真相源）        │
│ 每 15 轮一切割   │        │ → 置信度标注     │        │ → 新会话直接继承      │
│ 对话隔离存储     │        │ → 写前先 read    │        │ → 快速恢复上下文      │
└────────────────┘        └────────────────┘        └────────────────────┘
```

---

## 为什么选择 MindVault

- **数据主权**：JSONL / Markdown 开放格式，不绑定任何平台，换平台无缝迁移。
- **可审计**：DRAS-V 协议下每一步工具调用与推理过程可回溯；写操作「先 read 再合并」，不整文件覆写。
- **增量安全**：以 `_index.json` 的轮次游标为界，只导出新内容；无新轮次时不产生任何写入。
- **轻量部署**：单文件 `SKILL.md` 加载即可运行，无需数据库、无需服务器、无需 pip 依赖。
- **实战验证**：5000+ 轮真实对话验证，覆盖代码开发、项目规划、文档撰写等场景。

---

## 实测数据

| 指标 | 数值 | 环境 |
|------|------|------|
| 归档样本规模 | 15.1 MB / 69 个 JSONL 分片 / 13,930 行 | macOS 15.8 / python3 |
| 索引规模 | 68 个文件 / 14,949 条目 / 951 轮 | 同上 |
| `archive_index.py stats` | 0.07 秒（68 文件全量统计） | 同上 |
| `jsonl_to_md.py` 转换 | 单分片约 0.1 秒 → 174 KB / 2,095 行 Markdown | 同上 |

---

## 文件结构

| 文件 | 用途 |
|------|------|
| `SKILL.md` | 核心指令集（DRAS-V 协议 + 三层架构 + 命令参数速查），Agent 直接加载执行 |
| `README.md` | 本文档，项目概览与快速入门 |
| `scripts/archive_export.py` | 对话归档导出引擎（OpenClaw / Marvis / WorkBuddy 三模 + 增量合并） |
| `scripts/archive_index.py` | 归档索引管理（基础版：stats / pending） |
| `scripts/js

_meta.json

{
  "ownerId": "kn75ppn5446drk90tjknz007d589atky",
  "slug": "mindvault-agent-memory",
  "version": "1.2.6",
  "publishedAt": 1790955406612
}

CHANGELOG.md

## v1.2.6（2026-10-02）

- 链接口径统一：包内所有引导链接指向官方详情页（jinengpu.chat/mindvault-detail.html），购买动作在详情页完成，包内不出现支付直链
- 落地页链接定值（原占位符 16 处全替换）

## v1.2.5（2026-10-02）

- 锁口提示语口径调整：archive_index 的 mark/search/summary 与 jsonl_to_md 的运行提示改为中性「需按版本核对」措辞（行为不变：提示 + 退出码 1）
- jsonl_to_md 新增未渲染内容中性提示（分片含工具调用记录时显示条数，N=0 不打印）
- README / SKILL / _meta.json 付费对照表链接统一（官方渠道占位）
- README 尾注 / SKILL 末尾版本注记同步（原 v1.2.2 残留修正）
- 平台表补 Claude Code（~/.claude/projects/，CherryStudio Claude Code 模式覆盖）；frontmatter platforms 补 claudecode

## [1.2.4] - 2026-09-30

### Changed
- skillhub/ClawHub 搜索描述关键词化：前 100 字意图词命中 3→8（记忆×2/备份/换电脑/AI 失忆/Claude/WorkBuddy/归档），skill 逻辑零改动

## [1.2.3] - 2026-09-29

### Changed
- Listing 文案（description/keywords）补「记忆」词根，提升 memory/记忆/forget 泛词检索命中（skill 逻辑零改动）

## [1.2.2] - 2026-09-18
- **版本命名规则调整（重制）**：完整版 patch 以 `.1` 结尾，公开免费版以 `.2` 结尾；本版由原 v1.1.4 统一更名为 **v1.2.2**，功能内容与 v1.1.4 一致，仅版本号与本文档同步刷新
- **双文档联动断裂修复（与完整版 v1.2.1 同步）**：`PROJECT_SNAPSHOT.md`（唯一真相源）与 `PROJECT.md`（详细版）此前只要求"改后同步对端 + diff 关键字段"，实测出现更新日志条数不等（27 vs 31）、同日期条目重复、同日期文本漂移、章节正文残留旧事实（快照仍写 v1.0.1）——关键字段 diff 通过 ≠ 真正同步
- **新增 `scripts/snapshot_sync_check.py`（基础版免费开放，不加锁）**：纯标准库六维核账校验（更新日志条数 / 日期序列 / 逐字一致 / 倒序 / 章节标题集合 / 头部元数据），支持 `--help` 与 `--snapshot` / `--detail` 入参，发现断裂退出码非 0；已用真实双文档实跑通过，并以篡改样本反向验证（正确报断裂、退出码 1）
- **SKILL.md**：第四部分新增「Layer 3 双文档联动与核账校验（强制）」规范；故障排查由 10 条扩充至 12 条；Agent 评估块 `failure_paths` 同步为 12；版本统一至 1.2.2（日期 2026-09-18）
- **README.md / _meta.json**：文件结构与说明同步新增校验脚本，版本统一至 1.2.2
- **锁 4 口策略不变**：`archive_index` 的 mark/search/summary、`jsonl_to_md` 的 `--style full` / `--css` 仍为赞赏版功能，函数体完整保留未重写；新增校验脚本不锁

## [1.1.3] - 2026-09-17
- **GEO / 可信度改造（免费版）**：按 AI 可读性思路重构 SKILL.md 结构——`description` 前 128 字符改写为「核心功能 + 分片规则 + 输出物」（129→125 字符）；`keywords` 前置搜索意图词（对话备份/对话归档/Agent 长期记忆/上下文恢复/项目快照/规则萃取）；新增 `display_description`、`tags`、`slug`、`displayName` 字段
- **SKILL.md 结构重排**：核心用法（核心功能表 + 快速开始 + 命令参数速查）前置到前 500 字内；注意事项、FAQ、故障排查依次靠前；设计背景/迭代记录/作者信息后置
- **SKILL.md 新增**：FAQ 6 条（自然语言问答，含边界与增量安全性说明）、实测数据表（15.1MB / 69 分片 / 68 文件 14,949 条目 / stats 0.07s / 转换 ≈0.1s）、首次集成时间预估（约 10 分钟）、故障排查由 8 条扩充至 10 条、参考链接新增 GitHub/ClawHub/SkillHub 互链
- **README.md 改写**：首段与标题带入核心关键词；快速开始前置为 3 条命令；新增实测数据表、常见问题、数据与隐私章节；保留开源面貌（赞赏版说明置于文末）
- **_meta.json**：版本升至 1.1.3；新增 `slug` / `display_name` / `tested_evidence` / `links` 字段；keywords 中英文均按搜索意图重排
- **doc 修正（不动函数体）**：`archive_index.py`、`jsonl_to_md.py` 模块 docstring 中残留的"（完整版）"及完整版命令清单改为"（基础版 · 免费）"+ 实际可用命令（archive_index 的 usage 由 `print(__doc__)` 输出，此修正同时修正了运行时的帮助文本）
- 完整版（赞赏版 v1.1.1）不受本次改造影响，未做任何修改
- `LICENSE` 重命名为 `LICENSE.md` 并补全 MIT 协议全文（SkillHub 不接受无扩展名文件；GitHub 同样识别 LICENSE.md）

## [1.1.2] - 2026-09-15
- 恢复双版本拆分：以 v1.1.1 完整版为基线派生**基础版（免费）**，函数体不重写，仅施加 4 类锁定
- archive_index.py：锁定 mark/search/summary 三命令（print 赞赏提示 + sys.exit(1)），基础版保留 stats/pending
- jsonl_to_md.py：--style 仅允许 minimal；--css 注释移除；保留 minimal 渲染全链路
- SKILL.md / _meta.json：版本统一至 1.1.2，注明基础版能力边界与赞赏版获取方式（https://wzyp.cn/item/p0r2lb）
- archive_export.py：无差异，三模归档 + 增量合并全量开放

## [1.1.1] - 2026-09-14
- **archive_export.py（P

LICENSE.md

# MIT License

Copyright (c) 2026 zhouxin121 (者琥科技 / MindVault 思维永生)

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Related agents

Same protocol, similar job.

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/zhouxin121/skills/mindvault-agent-memory",
      "sourceUrl": "https://clawhub.ai/zhouxin121/skills/mindvault-agent-memory",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T09:36:03.445Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-zhouxin121-mindvault-agent-memory/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-zhouxin121-mindvault-agent-memory/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-11T09:36:03.445Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.1K downloads",
      "href": "https://clawhub.ai/zhouxin121/mindvault-agent-memory",
      "sourceUrl": "https://clawhub.ai/zhouxin121/mindvault-agent-memory",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T09:36:03.445Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.2.6",
      "href": "https://clawhub.ai/zhouxin121/mindvault-agent-memory",
      "sourceUrl": "https://clawhub.ai/zhouxin121/mindvault-agent-memory",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-10-02T15:36:46.612Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-zhouxin121-mindvault-agent-memory/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-zhouxin121-mindvault-agent-memory/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.2.6",
      "description": "链接口径统一：包内所有引导链接指向官方详情页，购买动作在详情页完成，包内不出现支付直链；原占位符定值",
      "href": "https://clawhub.ai/zhouxin121/mindvault-agent-memory",
      "sourceUrl": "https://clawhub.ai/zhouxin121/mindvault-agent-memory",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-10-02T15:36:46.612Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 11, 2026.

Sponsored

Ads related to MindVault 思维永生 and adjacent AI workflows.