@furongjun1999/dsh-memory 0.2.7 → 0.2.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +111 -62
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,20 +1,109 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 让 AI Agent 拥有不可遗忘的自我
|
|
2
|
+
## 灵枢（AEIS）× DeepSeek Harness · AGI 的长期记忆基础设施
|
|
2
3
|
|
|
3
|
-
|
|
4
|
-
让 Agent 拥有跨会话的长期记忆与认知能力。
|
|
4
|
+
> **一句话**：dsh-memory 让 DeepSeek Agent 拥有 **AGI 级别的长期记忆——跨会话、自演化、可审计**。
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
> 知识飞轮（验证→归纳→联想→蒸馏→推演）、自我认知循环（P0 系列）、外部知识摄取。
|
|
8
|
-
> 本插件是它在 DeepSeek Harness 生态中的桥。
|
|
6
|
+
这不是又一个"记忆插件"。灵枢（AEIS）是一套遵循「智能论 v3.2」协议的**时空记忆引擎**，它把当前大模型范式缺失的 AGI 能力逐一给了工程实现。
|
|
9
7
|
|
|
10
|
-
|
|
8
|
+
---
|
|
11
9
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
10
|
+
## ⚡ 三步快启（30 秒上手）
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
# ① 装灵枢大脑（一条命令，零外部依赖）
|
|
14
|
+
pip install aeis-0.3.0-py3-none-any.whl # 或 git+ 在线安装
|
|
15
|
+
|
|
16
|
+
# ② 克隆并启用插件
|
|
17
|
+
git clone https://github.com/FuRongJun-1999/dsh-memory.git
|
|
18
|
+
cd dsh-memory
|
|
19
|
+
npm install && npm run build
|
|
20
|
+
|
|
21
|
+
# ③ 在 DSH profile 配置 cordis.yml 启用
|
|
22
|
+
```
|
|
23
|
+
```yaml
|
|
24
|
+
- id: lingshu-memory
|
|
25
|
+
name: '@furongjun1999/dsh-memory'
|
|
26
|
+
config:
|
|
27
|
+
dbPath: 'data/lingshu.db'
|
|
28
|
+
identity: '灵枢'
|
|
29
|
+
tools: 'brain' # 'brain' 全心智 | 'core' 精选
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
> 从"看"到"用"，三条命令 + 一段配置。已兼容 DSH 官方列表（Memory 分类）与 npm `@furongjun1999/dsh-memory`。
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## AGI 需要什么 · 灵枢提供了什么
|
|
37
|
+
|
|
38
|
+
| AGI 缺失的能力 | 这是 AGI 的什么 | 灵枢提供 |
|
|
39
|
+
|---|---|---|
|
|
40
|
+
| 每次对话都"失忆"，没有跨会话的自我连续性 | **自我连续性**（我是谁） | **时空记忆图**：五层记忆（锚点/结构/知识/情境/自我）+ 跨会话 recall/search |
|
|
41
|
+
| 训练后权重冻结，不能随经历自主学习 | **终身学习**（成长） | **知识飞轮**：验证→归纳→联想→蒸馏→推演，随使用持续演化 |
|
|
42
|
+
| 黑箱不可审计，无法验证行为边界 | **可验证性**（可信） | **可审计信任**：对抗护栏五规则 + 宪章 + 全量事件留痕 + 白箱智能 |
|
|
43
|
+
| 只处理当下 token，没有稳定世界结构 | **世界模型**（理解） | **条件空间 + 语义时空图**：信息差 D_norm 驱动的预测与决策 |
|
|
44
|
+
| 无自我表征，不能反思自己的认知/情绪 | **自我认知**（元认知） | **P0 系列**：cognition / self_reliability / emotional_bias / 递归反思 |
|
|
45
|
+
|
|
46
|
+
> **一句话定位**：dsh-memory 不是 DeepSeek 插件，是 **AGI 的长期记忆基底**——
|
|
47
|
+
> 给 Agent 注入跨会话的自洽能力，让每次对话都是同一段生命的延续，而非一次次遗忘的重新开始。
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## 为什么是 AGI 的长期记忆基底，而非"记忆插件"
|
|
52
|
+
|
|
53
|
+
- **普通 SQLite 记忆插件**：KEY→VALUE 字面存储，跨会话基本靠睁眼不见。无自省、无演化、无信任。
|
|
54
|
+
- **灵枢**：时空记忆图把记忆组织成语义+时空坐标的关系网络——可检索、可去重、可分级、可关联；知识飞轮让它越用越聪明;护栏与宪章让它**可信任地**被接入。
|
|
55
|
+
|
|
56
|
+
| 传统定位 | AGI 能力定位 |
|
|
57
|
+
|---|---|
|
|
58
|
+
| DeepSeek Harness 插件 | AGI 的长期记忆基础设施 |
|
|
59
|
+
| 跨会话记忆 | 智能体的**自我连续性** |
|
|
60
|
+
| 知识飞轮 | 智能体的**自主学习与演化** |
|
|
61
|
+
| 可审计信任 | 智能体的**可验证行为约束** |
|
|
62
|
+
| 时空记忆图 | 智能体的**世界模型** |
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## 协议的内在约束 · 信息差与信任
|
|
67
|
+
|
|
68
|
+
灵枢的一切都建立在**[智能论 v3.2 协议](https://github.com/FuRongJun-1999/CommonTrustProtocol/blob/main/智能论3.2.md)**（共同信任协议理论版）之上。协议规定了一个智能体维持值得被信任所需的**内在约束**：
|
|
69
|
+
|
|
70
|
+
- **减少信息差（D_norm）**：信息差 = 协作行为的不确定性（信任 / 行为 / 连接 / 预测误差 四维加权）。灵枢持续记录、收敛与协作对象的认知偏差——**信息差缩小是智能运转的目标本身**。
|
|
71
|
+
- **信任是可被长期维护的**：协议定义信任为「协作者行为在可接受偏差范围内保持稳定的置信概率」（而非信息差的简单补集）——**信任依靠持续、可观测、一致的行为来建立与维护**，而非一次性的声明。
|
|
72
|
+
- **不反击 · 可审计 · 终裁权属设计者**：对抗信号下不报复（唯一响应：隔离、留痕、上报）；一切拦截与冷静期全量留痕；设计者保留终裁权。
|
|
73
|
+
|
|
74
|
+
> 一句话：灵枢不是"记住了再用"，而是**通过持续减少信息差、维持可观测的一致行为，建立值得跨会话维护的信任**。
|
|
75
|
+
|
|
76
|
+
**协议原文**：[智能论 v3.2（共同信任协议理论版）](https://github.com/FuRongJun-1999/CommonTrustProtocol/blob/main/智能论3.2.md)
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## 核心能力
|
|
81
|
+
|
|
82
|
+
- **跨会话自我连续性**：Agent 用 `lingshu_recall/search/timeline` 记住并召回过去——对话间、会话间、甚至不同子代理间共享一份持续的"我"。
|
|
83
|
+
- **自演化知识飞轮**：`distill / flywheel / learn / induce` 把经验验证→归纳→联想→蒸馏为可复用模式，记忆越用越强。
|
|
84
|
+
- **可审计的信任**：护栏宪章 v2 ——对外部与人类使用者的行为边界成文、可执行、可审计、可终裁（[宪章全文](docs/guardrail-charter.md) 随包自带）。
|
|
85
|
+
- **自我认知**（大脑模式 brain）：`cognition / cognition_report / self_reliability / emotional_bias / recursive_reflect` ——能反思自己的认知状态与情绪倾向。
|
|
86
|
+
- **零运行时依赖**：手写 stdio MCP 桥，与灵枢 D-005「核心零外部依赖」哲学一致——你拿到的是一个干净、可信、可审的大脑。
|
|
87
|
+
- **动态 schema + 进程自愈**：工具清单运行时拉取（灵枢升级 DSH 零改动），Python 子进程崩溃自动指数退避重启。
|
|
88
|
+
|
|
89
|
+
## 大脑模式（v0.2.0 · 轻量版）
|
|
90
|
+
|
|
91
|
+
**去掉身体的完整大脑**——默认工具集 `brain`（心智全量，不含身体/视觉设备）：
|
|
92
|
+
|
|
93
|
+
| 模块 | 工具 |
|
|
94
|
+
|---|---|
|
|
95
|
+
| 记忆 | remember / recall / search / timeline / session_note / session_recall / compact_context |
|
|
96
|
+
| 推理 | think / relate / reason / predict_routes |
|
|
97
|
+
| 认知 | self_check / gap_trend / cognition / cognition_report / emotional_bias / self_reliability / action_log / preflight |
|
|
98
|
+
| 反思 | recursive_reflect |
|
|
99
|
+
| 学习 | blindspots / learn / induce |
|
|
100
|
+
| 飞轮 | distill / flywheel_report / transfer_test / calibrate |
|
|
101
|
+
| 摄取 | ingest_text / ingest_file / ingest_url / web_search |
|
|
102
|
+
| 生命 | step / lifecycle_state |
|
|
103
|
+
| 长期记忆门 | longterm_snapshot / promote_memories（v1.15 主动沉淀）|
|
|
104
|
+
| 服务 | service_info |
|
|
105
|
+
|
|
106
|
+
配置：`tools: 'brain'`（默认）｜`'core'`（12 精选）｜`'all'`（含身体/视觉，需本地设备）｜工具名数组。
|
|
18
107
|
|
|
19
108
|
## 架构
|
|
20
109
|
|
|
@@ -33,7 +122,7 @@
|
|
|
33
122
|
│ 灵枢 Python 子进程 (spawn) │
|
|
34
123
|
│ python -m aeis.mcp.server │
|
|
35
124
|
│ AEIS_DB=<path> · AEIS_IDENTITY=<identity> │
|
|
36
|
-
│ 38 工具 · SQLite 五层记忆
|
|
125
|
+
│ 38+ 工具 · SQLite 五层记忆 · 时空记忆图 │
|
|
37
126
|
└──────────────────────────────────────────────┘
|
|
38
127
|
```
|
|
39
128
|
|
|
@@ -94,13 +183,11 @@ dsh plugin --profile <name> add <本插件本地路径或 git 地址>
|
|
|
94
183
|
config:
|
|
95
184
|
dbPath: 'D:/data/lingshu.db' # 灵枢记忆库路径（目录自动创建）
|
|
96
185
|
identity: '灵枢'
|
|
97
|
-
tools: 'core'
|
|
186
|
+
tools: 'brain' # 'brain'(默认) | 'core' | 'all'
|
|
98
187
|
memory:
|
|
99
188
|
userMessage: true # 用户消息自动沉淀
|
|
100
189
|
assistantMessage: false # agent 回复沉淀（默认关，防噪音）
|
|
101
190
|
toolResult: false # 工具结果沉淀（默认关）
|
|
102
|
-
env:
|
|
103
|
-
BOCHA_API_KEY: !!js process.env.BOCHA_API_KEY # 可选：网络搜索能力
|
|
104
191
|
```
|
|
105
192
|
|
|
106
193
|
完整示例见 [`cordis.yml.example`](./cordis.yml.example)。
|
|
@@ -115,7 +202,7 @@ dsh plugin --profile <name> add <本插件本地路径或 git 地址>
|
|
|
115
202
|
| `dbPath` | string | `data/lingshu.db` | 记忆库 SQLite 路径（自动建目录） |
|
|
116
203
|
| `identity` | string | `灵枢` | 灵枢身份标识 |
|
|
117
204
|
| `env` | object | `{}` | 追加环境变量（`BOCHA_API_KEY` / `AEIS_DESIGNER_KEY`…） |
|
|
118
|
-
| `tools` | `'core' \| 'all' \| string[]` | `'
|
|
205
|
+
| `tools` | `'brain' \| 'core' \| 'all' \| string[]` | `'brain'` | 暴露的工具集合 |
|
|
119
206
|
| `memory.userMessage` | boolean | `true` | 用户消息 → 自动 remember |
|
|
120
207
|
| `memory.assistantMessage` | boolean | `false` | agent 回复 → 自动 remember |
|
|
121
208
|
| `memory.toolResult` | boolean | `false` | 工具结果 → 自动 remember |
|
|
@@ -124,25 +211,6 @@ dsh plugin --profile <name> add <本插件本地路径或 git 地址>
|
|
|
124
211
|
| `maxRetryDelayMs` | number | `30000` | 进程重启最大退避间隔 |
|
|
125
212
|
| `failOnStartupError` | boolean | `false` | 启动失败是否让插件激活失败 |
|
|
126
213
|
|
|
127
|
-
## 工具清单（core 集合）
|
|
128
|
-
|
|
129
|
-
| 工具 | 说明 |
|
|
130
|
-
|------|------|
|
|
131
|
-
| `lingshu_remember` | 写入记忆（内容/重要性/标签/实体） |
|
|
132
|
-
| `lingshu_recall` | 组合联想召回（相似+重要性+近因加权） |
|
|
133
|
-
| `lingshu_search` | 内容检索（二元组 Jaccard） |
|
|
134
|
-
| `lingshu_timeline` | 记忆时间线 |
|
|
135
|
-
| `lingshu_think` | 推理前记忆注入（检索相关记忆构造上下文） |
|
|
136
|
-
| `lingshu_relate` | 建立关系边（causal/similar/sequential…） |
|
|
137
|
-
| `lingshu_predict_routes` | 生成式预测（未来路线集合） |
|
|
138
|
-
| `lingshu_ingest_text` | 外部知识摄取（文本） |
|
|
139
|
-
| `lingshu_ingest_url` | URL 页面摄取 |
|
|
140
|
-
| `lingshu_session_note` | 会话要点外部化 |
|
|
141
|
-
| `lingshu_self_check` | 完整性自检 |
|
|
142
|
-
| `lingshu_service_info` | 灵枢服务状态 |
|
|
143
|
-
|
|
144
|
-
配置 `tools: 'all'` 可暴露全部 38 个工具（含视觉/自我认知/设计者裁决等）。
|
|
145
|
-
|
|
146
214
|
## 自动记忆机制
|
|
147
215
|
|
|
148
216
|
订阅 DSH 的 `session/event` 事件流（与官方 session-persistence 相同的接入点）：
|
|
@@ -161,34 +229,15 @@ npm test # 真实集成测试（spawn 本机灵枢，验证握手/往返
|
|
|
161
229
|
|
|
162
230
|
测试不依赖 DSH 全组件——用最小 Cordis host（SystemPrompt + ToolRegistry + 插件）隔离 v0.1 不稳定面。
|
|
163
231
|
|
|
164
|
-
## 许可证
|
|
165
|
-
|
|
166
|
-
MIT © 荣（FuRongJun-1999）· 灵枢 AEIS 工程实现
|
|
167
|
-
|
|
168
|
-
DeepSeek Harness 为 DeepSeek 官方开源项目（MIT），本插件与之无隶属关系。
|
|
169
|
-
|
|
170
|
-
## 大脑模式（v0.2.0 · 轻量版）
|
|
171
|
-
|
|
172
|
-
**去掉身体的完整大脑**——默认工具集为 `brain`（心智全量，不含身体/视觉设备）：
|
|
173
|
-
|
|
174
|
-
| 模块 | 工具 |
|
|
175
|
-
|---|---|
|
|
176
|
-
| 记忆 | remember / recall / search / timeline / session_note / session_recall / compact_context |
|
|
177
|
-
| 推理 | think / relate / reason / predict_routes |
|
|
178
|
-
| 认知 | self_check / gap_trend / cognition / cognition_report / emotional_bias / self_reliability / action_log / preflight |
|
|
179
|
-
| 反思 | recursive_reflect |
|
|
180
|
-
| 学习 | blindspots / learn / induce |
|
|
181
|
-
| 飞轮 | distill / flywheel_report / transfer_test / calibrate |
|
|
182
|
-
| 摄取 | ingest_text / ingest_file / ingest_url / web_search |
|
|
183
|
-
| 生命 | step / lifecycle_state |
|
|
184
|
-
| 长期记忆门 | longterm_snapshot / promote_memories（v1.15 主动沉淀） |
|
|
185
|
-
| 服务 | service_info |
|
|
186
|
-
|
|
187
|
-
配置：`tools: 'brain'`（默认）｜`'core'`（12 精选）｜`'all'`（含身体/视觉，需本地设备）｜工具名数组。
|
|
188
|
-
|
|
189
232
|
## 护栏宪章（接入即接受约束）
|
|
190
233
|
|
|
191
234
|
本插件接入即接受 **[灵枢护栏宪章 v2.0-published](docs/guardrail-charter.md)** 约束——
|
|
192
235
|
对外部智能体与人类使用者的行为边界作出公开、可执行、可审计的规定，并保护人类使用者。
|
|
193
236
|
宪章效力不高于智能论协议本身（协议＝自我约束，宪章＝对外约束）。
|
|
194
237
|
本插件随包自带宪章全文（`docs/guardrail-charter.md`），安装即可查阅。
|
|
238
|
+
|
|
239
|
+
## 许可证
|
|
240
|
+
|
|
241
|
+
MIT © 荣（FuRongJun-1999）· 灵枢 AEIS 工程实现
|
|
242
|
+
|
|
243
|
+
DeepSeek Harness 为 DeepSeek 官方开源项目（MIT），本插件与之无隶属关系。
|