Skip to content

qmvip/v5-memory

Repository files navigation

V5 元记忆系统

AI for Science 认知引擎:基于 V5 势垒方程的科研级长期记忆系统

通用大模型全局记忆框架 | V5 Meta Structure Powered


Commercial Use

For enterprise license, custom integration or consulting, please contact: rhodri777@foxmail.com

核心定位

一句话:让 AI 记住用户的一切,实现跨平台、跨场景的个性化记忆能力。

技术核心:V5 势垒方程 P = 1/(1+e^(-2γ(Input-B))) 驱动记忆的提取、召回、注入全生命周期。

方程本质:Sigmoid 函数变体,将「输入匹配度」映射为 0-1 之间的「记忆激活概率」,实现记忆召回/写入的量化决策。


核心特性

  • 🧠 认知科学驱动:V5 势垒方程(Input=语义/γ=目录)贯穿全流程,复刻大脑记忆跃迁逻辑
  • ⚡ 高效记忆管理:分层存储(Hot/Warm/Cold)+ 混合检索(BM25+向量+知识图谱),检索效率×5
  • 🔬 科研闭环:对接 Graphormer/ViSNet 等科学模型,支持「假设-模拟-实验-反馈」自动化闭环
  • 🖥️ 多模态兼容:解析分子结构/谱图/实验图像,适配材料/生物/物理等科研场景
  • 🧩 生态兼容:支持 MCP 协议,低代码可视化配置,非程序员也能上手

快速开始

安装

npm install @wayne.evan/v5-memory

---

## 基础使用
// 引入核心引擎
import { V5MetaEngine } from 'v5-memory';

// 初始化引擎(配置 V5 势垒方程参数)
const engine = new V5MetaEngine({
  gamma: 1.2, // 目录索引陡度
  barrier: 0.4, // 激活阈值 B
});

// 写入科研记忆(实验参数)
await engine.addMemory({
  content: "EAST 模拟参数:等离子体密度 1e19 m^-3,温度 10keV",
  type: "experiment", // 记忆类型
  priority: "hot" // 分层存储(hot/warm/cold)
});

// 混合检索记忆
const results = await engine.retrieve("EAST 模拟参数");
console.log(results);

---

## 实验闭环(科研核心场景)
// 基于历史记忆生成实验参数建议
const params = await engine.runExperimentLoop({
  task: "优化 EAST 等离子体约束时间",
  model: "Graphormer" // 对接科学基座模型
});
console.log(params);

---

## 核心理论

V5 元记忆系统基于「V5 势垒方程」构建:
P = 1 / (1 + e^(-2·γ·(Input - B)))
- Input:语义网络(信号强度)
- γ:目录索引(结构化陡度)
- B:激活阈值
- P:记忆激活概率

核心理论已通过预印本公开,商用闭源需标注来源(详见 LICENSE)。
---

## 三大版本

| 版本 | 定位 | 用户群体 | 技术栈 | 核心差异 |
|------|------|----------|--------|----------|
| **完整版** | 全功能、全平台适配 | 高级用户、研究者 | Node.js CLI + Web | 支持向量检索、云端同步、自定义元规则 |
| **网页版** | 浏览器插件形态 | 写手、视觉设计师 | Chrome Extension (Manifest V3) | 轻量本地存储、仅关键词检索、主流 LLM 适配 |
| **IDE版** | 开发工具形态 | 程序员、架构师 | VS Code 插件 / Electron | 适配 IDE 内 AI 助手(Cursor/Windsurf)、代码上下文记忆 |

---

## 功能矩阵

| 功能 | 完整版 | 网页版 | IDE版 | 实现说明 |
|------|--------|--------|-------|----------|
| 多平台适配 |||| Meta-Adapt Layer |
| 自动记忆提取 |||| V5 势垒方程阈值过滤 |
| 智能召回注入 |||| V5 势垒方程排序 |
| V5 元规则引擎 |||| 核心引擎驱动 |
| 记忆中心 UI |||| 筛选/编辑记忆 |
| 向量语义检索 | ✅ (可选) ||| LocalEmbedding |
| 云端同步 | ✅ (可选) ||| 加密同步 |
| 自定义角色 |||| namespace 隔离 |

---

## V5 元结构

┌─────────────────────────────────────────────────────────────┐ │ V5 Meta Engine │ ├─────────────┬─────────────┬─────────────┬──────────────────┤ │ Meta-Adapt │ Meta-Opera │ Meta-Data │ Meta-Security │ │ Layer │ Layer │ Layer │ Layer │ │ 平台适配 │ 记忆操作 │ 元数据管理 │ 安全管控 │ ├─────────────┴─────────────┴─────────────┴──────────────────┤ │ Storage Layer │ │ (IndexedDB / localStorage / FileSystem) │ └─────────────────────────────────────────────────────────────┘


### 核心组件

1. **Meta-Adapt Layer** - 平台适配器:DeepSeek/ChatGPT/Claude/Gemini/Cursor/Windsurf/Cline
2. **Meta-Opera Layer** - 提取/召回/注入器 + 规则引擎
3. **Meta-Data Layer** - 版本链、关联关系、生命周期
4. **Meta-Security Layer** - 敏感信息、脱敏、审计、隔离

---

## 关键技术实现

### V5 势垒方程

```javascript
export function v5BarrierEquation(input, gamma = 0.85, barrier = 0.5) {
  const normalizedInput = Math.max(0, Math.min(1, input));
  const exponent = -2 * gamma * (normalizedInput - barrier);
  return parseFloat((1 / (1 + Math.exp(exponent))).toFixed(4));
}

// input=0.7 → P=0.8176 (高概率召回)
// input=0.4 → P=0.3820 (低概率召回)

写入得分

export function calculateWriteScore(confidence, importance, platformWeight = 1, freshness = 1) {
  return (confidence * 0.4) + (importance * 0.3) + (platformWeight * 0.2) + (freshness * 0.1);
}

记忆类型阈值

类型 阈值 说明
pinned 1.0 置顶(最高)
persona 0.8 用户画像
core 0.6 核心记忆
episodic 0.4 情境细节

快速开始

完整版

cd src/complete
npm install
node cli.js --init
node cli.js --input "我喜欢Python" --platform deepseek
node cli.js --retrieve "推荐框架"

网页版

cd src/web/frontend
npm install && npm run build
# 加载 dist 到 Chrome

IDE版

cd src/ide/vscode
npm install
# F5 调试

项目结构

v5-memory/
├── README.md
├── SPEC.md
├── src/
│   ├── core/
│   │   ├── engine/
│   │   │   ├── meta_engine.js   # 核心引擎
│   │   │   ├── scorer.js        # V5 势垒方程
│   │   │   ├── extractor.js     # 记忆提取
│   │   │   ├── retriever.js    # 记忆召回
│   │   │   └── injector.js     # 记忆注入
│   │   ├── adapt/
│   │   │   ├── base_adapter.js
│   │   │   └── platform_adapters.js
│   │   ├── security/
│   │   │   └── sanitizer.js    # 敏感信息+审计
│   │   └── storage/
│   │       └── memory_store.js
│   ├── complete/cli.js
│   ├── web/frontend/
│   └── ide/vscode/

合规声明

  • 技术框架,不涉及玄学/占卜
  • 本地存储优先,隐私优先
  • 敏感信息自动脱敏
  • 一键清空功能

开源协议

本项目基于 MIT 协议开源,补充声明:

  1. 核心理论(V5 势垒方程)知识产权归原作者所有;
  2. 非商用修改/使用:完全自由;
  3. 商用闭源修改:需标注「基于 V5 元记忆系统开发」,否则作者将停止技术支持。 DOI 10.5281/zenodo.18643634.

详见 LICENSE

To cite this software, please use the following DOI: 10.5281/zenodo.18703102


作者信息

Zheng Yiting
ORCID: 0009-0008-7750-5687


核心成果引用

1. 理论总纲(英文预印本)

The Generalized Barrier Equation: A Theory of Everything for Phase Transitions
DOI: 10.5281/ZENODO.18643635

2. 工程实现(中文预印本)

V5 广义势垒方程:临界系统相变的统一理论及其在数字孪生领域的应用
DOI: 10.5281/ZENODO.18703307

3. 核心代码仓库


许可证

MIT - 望易 V5 元结构体系