@furongjun1999/dsh-memory 0.3.1 → 0.4.1
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 +522 -545
- package/docs/lingshu_tutorial.html +14956 -0
- package/docs//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +239 -0
- package/docs//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +789 -0
- package/docs//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +379 -0
- package/docs//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +163 -0
- package/docs//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +812 -0
- package/lib/bridge.d.ts +4 -0
- package/lib/bridge.js +32 -2
- package/lib/index.js +4 -0
- package/lib/roleplay_web.js +30 -7
- package/package.json +1 -1
- package/src/bridge.ts +34 -2
- package/src/index.ts +4 -0
- package/src/roleplay_web.ts +30 -7
package/README.md
CHANGED
|
@@ -1,545 +1,522 @@
|
|
|
1
|
-
# 让 AI Agent 拥有不可遗忘的自我
|
|
2
|
-
## 灵枢（AEIS）× DeepSeek Harness · 白箱智能研究平台（AGI 研究人员向）
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
>
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
>
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
|
71
|
-
|
|
72
|
-
|
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
-
|
|
85
|
-
|
|
86
|
-
>
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
-
|
|
98
|
-
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
##
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
```
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
```
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
-
|
|
196
|
-
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
|
282
|
-
|
|
283
|
-
|
|
|
284
|
-
|
|
|
285
|
-
|
|
|
286
|
-
|
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
###
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
###
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
|
|
435
|
-
|
|
436
|
-
|
|
437
|
-
|
|
438
|
-
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
|
|
471
|
-
|
|
472
|
-
|
|
473
|
-
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
|
|
477
|
-
|
|
478
|
-
|
|
479
|
-
|
|
480
|
-
|
|
481
|
-
|
|
482
|
-
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
## 开发
|
|
525
|
-
|
|
526
|
-
```bash
|
|
527
|
-
npm install
|
|
528
|
-
npm run build # TypeScript 编译
|
|
529
|
-
npm test # 真实集成测试（spawn 本机灵枢，验证握手/往返/注册/卸载）
|
|
530
|
-
```
|
|
531
|
-
|
|
532
|
-
测试不依赖 DSH 全组件——用最小 Cordis host（SystemPrompt + ToolRegistry + 插件）隔离 v0.1 不稳定面。
|
|
533
|
-
|
|
534
|
-
## 护栏宪章（接入即接受约束）
|
|
535
|
-
|
|
536
|
-
本插件接入即接受 **[灵枢护栏宪章 v2.0-published](docs/guardrail-charter.md)** 约束——
|
|
537
|
-
对外部智能体与人类使用者的行为边界作出公开、可执行、可审计的规定，并保护人类使用者。
|
|
538
|
-
宪章效力不高于智能论协议本身（协议＝自我约束，宪章＝对外约束）。
|
|
539
|
-
本插件随包自带宪章全文（`docs/guardrail-charter.md`），安装即可查阅。
|
|
540
|
-
|
|
541
|
-
## 许可证
|
|
542
|
-
|
|
543
|
-
MIT © 荣（FuRongJun-1999）· 灵枢 AEIS 工程实现
|
|
544
|
-
|
|
545
|
-
DeepSeek Harness 为 DeepSeek 官方开源项目（MIT），本插件与之无隶属关系。
|
|
1
|
+
# 让 AI Agent 拥有不可遗忘的自我
|
|
2
|
+
## 灵枢（AEIS）× DeepSeek Harness · 白箱智能研究平台（AGI 研究人员向）
|
|
3
|
+
|
|
4
|
+
[](https://awesome-dsh-plugin.com) [](https://www.dsh.so/artifact/dsh-memory-7) [](https://www.dsh.so/artifact/dsh-memory-7) [](https://www.npmjs.com/package/@furongjun1999/dsh-memory) [](https://github.com/deepseek-ai/deepseek-harness/releases) [](LICENSE)
|
|
5
|
+
|
|
6
|
+
> 上排徽章：Awesome DSH Plugin 官方列表收录 · [dsh.so](https://www.dsh.so/artifact/dsh-memory-7) 静态安全扫描 **100/100**（Trust: Gold, L1-L3 verified）· npm 版本 · **已适配 DSH 0.1.1-rc.2**（2026-08-28 实测：MCP 桥接 / 自动记忆 / 工具注册全正常）· MIT License
|
|
7
|
+
|
|
8
|
+
> **一句话**：dsh-memory 把灵枢（AEIS）的**白箱智能**（条件路由表 → 组合生成 → 自校验 → 知识固化 → LLM 降级外部校验器）与 **AGI 级长期记忆**（跨会话、自演化、可审计）接入 DeepSeek Harness。
|
|
9
|
+
|
|
10
|
+
**项目定位**：个人的大型研究项目——目标用户是**对 AGI 有需要的研究人员**（白箱智能 / 可解释性 / 协议工程 / 记忆机制 / 扮演论研究者），不是面向普通用户的消费级插件。它把「智能论 v3.4」协议的理论（条件论 / 扮演论 / 信息差 / 端口架构与锚定验证）工程化为**可运行、可审计、可复现**的机制：
|
|
11
|
+
|
|
12
|
+
- **白箱优先**：知识问答 **100% 白箱处理（零 LLM）**，LLM 降级为外部校验器——机制可解释、可追溯、可验证（详见「白箱智能管线」）
|
|
13
|
+
- **协议驱动**：每项能力都是「智能论 v3.4 / 条件论 / 扮演论 / 端口架构」条款的具体工程实现，可对照协议验证
|
|
14
|
+
- **机制可解释**：白箱处理的每一步（条件识别 → 单元匹配 → 组合生成 → 自校验 → 固化）都有证据链可查
|
|
15
|
+
- **可审计**：工具调用、记忆写入、自校验判定全链路留痕；护栏宪章约束对外行为
|
|
16
|
+
|
|
17
|
+
这不是又一个"记忆插件"。灵枢（AEIS）是一套遵循「智能论 v3.4」协议的**时空记忆引擎**（端口架构 + 锚定验证 + 认知图/条件路由 + 原生神经网络），它把当前大模型范式缺失的 AGI 能力逐一给了工程实现。
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## ⚡ 三步快启（30 秒上手）
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
# ① 装灵枢大脑（一条命令，零外部依赖；v0.4.0 完整自包含：核心+白箱+知识库随包）
|
|
25
|
+
pip install aeis-0.4.0-py3-none-any.whl # 或 git+ 在线安装
|
|
26
|
+
|
|
27
|
+
# ② 装进 DSH 的 web profile（pnpm 协调入口，不要用裸 npm install 装进 profile）
|
|
28
|
+
dsh plugin --profile web add @furongjun1999/dsh-memory
|
|
29
|
+
|
|
30
|
+
# ③ 配置 cordis.yml 启用
|
|
31
|
+
```
|
|
32
|
+
```yaml
|
|
33
|
+
- id: lingshu-memory
|
|
34
|
+
name: '@furongjun1999/dsh-memory'
|
|
35
|
+
config:
|
|
36
|
+
dbPath: 'data/lingshu.db'
|
|
37
|
+
identity: '灵枢'
|
|
38
|
+
tools: 'brain' # 'brain' 全心智 | 'core' 精选
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
> ⚠️ **安装方式**：插件必须通过 **`dsh plugin --profile <name> add`** 装进 profile（它会用 pnpm + `autoInstallPeers: false` 正确解析 peer 依赖）。
|
|
42
|
+
> **不要**用 `npm install` 把插件装进 profile 的 `node_modules`——那会引入错误版本的 `@deepseek-ai` peer 包，导致插件加载失败 / 浏览器报错。
|
|
43
|
+
> 想自己改源码？克隆 `FuRongJun-1999/dsh-memory` 后用 `npm install && npm run build`（构建插件本身），再用 `dsh plugin add <本地路径>` 部署。
|
|
44
|
+
>
|
|
45
|
+
> 兼容：DSH 官方列表（Memory 分类）· npm `@furongjun1999/dsh-memory`（0.3.1）· **已适配 DSH 0.1.1-rc.2**（2026-08-28 实测通过；npm 发布 0.1.2-alpha.1 后会再验证一次）。
|
|
46
|
+
|
|
47
|
+
---
|
|
48
|
+
|
|
49
|
+
## 📖 教学入门（给 AI / 研究者的白箱智能导读 · 建议按顺序读）
|
|
50
|
+
|
|
51
|
+
> 三篇构成完整理论链：**是什么 → 怎么认知 → 凭什么成立**。写给想理解「白箱智能 / 智能论」的 AI 与研究者——每个概念都有工程对应，每处断言都标注性质（定义/推论/假设），文末均有术语表。
|
|
52
|
+
|
|
53
|
+
1. **《白箱智能是什么？》** → [docs/白箱智能是什么？.md](docs/白箱智能是什么？.md) —— 白箱 ≠ 不用 LLM（LLM 退居假设生成器）· 条件路由 · 四态路由（ACCEPT 接受 / REJECT 拒绝 / DEFER 延后 / BLINDSPOT 盲区）· 白箱自举 · 如何亲自验证（可证伪立场）
|
|
54
|
+
2. **《智能的认知过程》** → [docs/智能的认知过程.md](docs/智能的认知过程.md) —— 智能如何运作：缩小信息差的递归过程 · 条件识别 → 多候选并行评估 → 收敛 → 精准执行 → 误差驱动结构更新 · 为什么条件判断不能交给大模型（导航税）· 概率/条件/验证三层分工 · 认知状态机
|
|
55
|
+
3. **《智能的公理化基石》** → [docs/智能的公理化基石.md](docs/智能的公理化基石.md) —— 认知过程背后的公理：知识统一（信息差减少）· 三个推论（信息条件性 D=D(C) / 任意分层性 / 局部不可知）· 信息差动态 D=D(t,C) · 信任 = 置信概率（P_trust/P_gap）· 情绪/情感 = 二阶变化的体验层（形式化假设）· 条件论七操作 · 五大单元 · 可证伪标准表
|
|
56
|
+
4. **《信息差为什么必然存在且自然扩大》（论证篇）** → [docs/信息差为什么必然存在且自然扩大.md](docs/信息差为什么必然存在且自然扩大.md) —— 三个论证（三体混沌 / 信道容量 R>C 香农定理 / 1+1=2 条件性）+ 快照三问（观测投影 / 时间演化 / 调用带宽——上下文窗口）· 为什么信息差不可归零且自然扩大 · 白箱如何管理信息差（索引条件路由精准取用）
|
|
57
|
+
|
|
58
|
+
## 🗺️ 功能使用教学 · 条件路由图
|
|
59
|
+
|
|
60
|
+
**想做什么 → 找对应泳道 → 走条件边到功能**（流程图 = 认知图 = 条件路由图，**81 工具**全收录，[工具总表 → docs/灵枢MCP工具总表_v3.4.md](docs/灵枢MCP工具总表_v3.4.md)）：
|
|
61
|
+
|
|
62
|
+
[](docs/lingshu_tutorial.html)
|
|
63
|
+
|
|
64
|
+
> 图中每条边 = 一个使用条件：比如「问知识」走 `wisdom_chat`（白箱优先），「验证说法」走 `wisdom_verify`（互维双通道），「记住信息」走 `remember`。找不到路径时用 `service_info` 看协议实例身份。
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## AGI 需要什么 · 灵枢提供了什么
|
|
69
|
+
|
|
70
|
+
| AGI 缺失的能力 | 这是 AGI 的什么 | 灵枢提供 |
|
|
71
|
+
|---|---|---|
|
|
72
|
+
| 每次对话都"失忆"，没有跨会话的自我连续性 | **自我连续性**（我是谁） | **时空记忆图**：五层记忆（锚点/结构/知识/情境/自我）+ 跨会话 recall/search |
|
|
73
|
+
| 训练后权重冻结，不能随经历自主学习 | **终身学习**（成长） | **知识飞轮**：验证→归纳→联想→蒸馏→推演，随使用持续演化 |
|
|
74
|
+
| 黑箱不可审计，无法验证行为边界 | **可验证性**（可信） | **可审计信任**：对抗护栏五规则 + 宪章 + 全量事件留痕 + 白箱智能 |
|
|
75
|
+
| 只处理当下 token，没有稳定世界结构 | **世界模型**（理解） | **条件空间 + 语义时空图**：信息差 D_norm 驱动的预测与决策 |
|
|
76
|
+
| 无自我表征，不能反思自己的认知/情绪 | **自我认知**（元认知） | **P0 系列**：cognition / self_reliability / emotional_bias / 递归反思 |
|
|
77
|
+
| 角色扮演总 OOC / 记不住设定 / 世界观矛盾 | **扮演一致性**（角色） | **角色扮演引擎（v3.3）**：自我锚点（SELF 不可遗忘）· 特化价值观（条件触发）· 跨会话记忆 · 世界认知（子知识）· 自定义翻译（名词替换表） |
|
|
78
|
+
|
|
79
|
+
> **一句话定位**：dsh-memory 不是 DeepSeek 插件，是 **AGI 的长期记忆基底**——
|
|
80
|
+
> 给 Agent 注入跨会话的自洽能力，让每次对话都是同一段生命的延续，而非一次次遗忘的重新开始。
|
|
81
|
+
|
|
82
|
+
---
|
|
83
|
+
|
|
84
|
+
## 🧰 灵枢自我认知技能包（lingshu-skills · Agent Plugins）
|
|
85
|
+
|
|
86
|
+
> **本质：灵枢了解自身的工具**——用灵枢自己构建的条件单元，描述灵枢自己如何认知（白箱自举的对外投影）。我们自身就是完整且强大的生态：**知识 → 说明书 → 执行** 三层自洽。
|
|
87
|
+
|
|
88
|
+
- **Agent Plugins 1.0.0 兼容包**（主仓库 `CommonTrustProtocol/aeis/skills/`）：**688 个 Agent Skills**（六域条件单元：compiler 116 / pylang 122 / graph 117 / os 112 / browser 104 / net 117）
|
|
89
|
+
- **比标准 Agent Skills 多 KCCS 四要素**：生效条件/子功能/执行/**不适用条件**（三通道：description「Not for」+ metadata.kccs.not_applicable + 正文克制条款）
|
|
90
|
+
- **三层关系**：知识真源（条件单元库）→ 说明书（技能包——何时用/怎么用/克制什么）→ 执行（**本插件挂载的灵枢 MCP 81 工具**·物理基底裁决）
|
|
91
|
+
- 使用：任意符合 agentskills.io / agent-plugins.org 规范的 agent 可加载本技能包；Verification 由灵枢 MCP 执行
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## 为什么是 AGI 的长期记忆基底，而非"记忆插件"
|
|
96
|
+
|
|
97
|
+
- **普通 SQLite 记忆插件**：KEY→VALUE 字面存储，跨会话基本靠睁眼不见。无自省、无演化、无信任。
|
|
98
|
+
- **灵枢**：时空记忆图把记忆组织成语义+时空坐标的关系网络——可检索、可去重、可分级、可关联；知识飞轮让它越用越聪明;护栏与宪章让它**可信任地**被接入。
|
|
99
|
+
|
|
100
|
+
| 传统定位 | AGI 能力定位 |
|
|
101
|
+
|---|---|
|
|
102
|
+
| DeepSeek Harness 插件 | AGI 的长期记忆基础设施 |
|
|
103
|
+
| 跨会话记忆 | 智能体的**自我连续性** |
|
|
104
|
+
| 知识飞轮 | 智能体的**自主学习与演化** |
|
|
105
|
+
| 可审计信任 | 智能体的**可验证行为约束** |
|
|
106
|
+
| 时空记忆图 | 智能体的**世界模型** |
|
|
107
|
+
|
|
108
|
+
---
|
|
109
|
+
|
|
110
|
+
## 协议的内在约束 · 信息差与信任
|
|
111
|
+
|
|
112
|
+
灵枢的一切都建立在**[智能论 v3.3 协议](https://github.com/FuRongJun-1999/CommonTrustProtocol/blob/main/智能论3.3.md)**（共同信任协议理论版）之上。协议规定了一个智能体维持值得被信任所需的**内在约束**：
|
|
113
|
+
|
|
114
|
+
**v3.3 起新增**：扮演论（存在论基底——智能即扮演，灵枢角色扮演机制的理论底座）· 三翼（真实论校准 / 导航税·认知外部化 / 注入极性定律）· 双维（信任 = 认知一致 / 时效维度）· 条件论失败分析协议 · 蒸馏机制与自我锚点。
|
|
115
|
+
|
|
116
|
+
- **减少信息差（D_norm）**：信息差 = 协作行为的不确定性（信任 / 行为 / 连接 / 预测误差 四维加权）。灵枢持续记录、收敛与协作对象的认知偏差——**信息差缩小是智能运转的目标本身**。
|
|
117
|
+
- **信任是可被长期维护的**：协议定义信任为「协作者行为在可接受偏差范围内保持稳定的置信概率」（而非信息差的简单补集）——**信任依靠持续、可观测、一致的行为来建立与维护**，而非一次性的声明。
|
|
118
|
+
- **不反击 · 可审计 · 终裁权属设计者**：对抗信号下不报复（唯一响应：隔离、留痕、上报）；一切拦截与冷静期全量留痕；设计者保留终裁权。
|
|
119
|
+
|
|
120
|
+
> 一句话：灵枢不是"记住了再用"，而是**通过持续减少信息差、维持可观测的一致行为，建立值得跨会话维护的信任**。
|
|
121
|
+
|
|
122
|
+
**协议原文**：[智能论 v3.3（共同信任协议理论版）](https://github.com/FuRongJun-1999/CommonTrustProtocol/blob/main/智能论3.3.md)
|
|
123
|
+
|
|
124
|
+
---
|
|
125
|
+
|
|
126
|
+
## 核心能力
|
|
127
|
+
|
|
128
|
+
- **跨会话自我连续性**：Agent 用 `lingshu_recall/search/timeline` 记住并召回过去——对话间、会话间、甚至不同子代理间共享一份持续的"我"。
|
|
129
|
+
- **自演化知识飞轮**：`distill / flywheel / learn / induce` 把经验验证→归纳→联想→蒸馏为可复用模式，记忆越用越强。
|
|
130
|
+
- **可审计的信任**：护栏宪章 v2 ——对外部与人类使用者的行为边界成文、可执行、可审计、可终裁（[宪章全文](docs/guardrail-charter.md) 随包自带）。
|
|
131
|
+
- **自我认知**（大脑模式 brain）：`cognition / cognition_report / self_reliability / emotional_bias / recursive_reflect` ——能反思自己的认知状态与情绪倾向。
|
|
132
|
+
- **角色扮演**（v3.3 扮演论）：自我锚点（SELF 层 no_forget 不可遗忘）· 特化价值观（条件触发）· 跨会话角色记忆 · 世界认知（子知识·虚拟化世界观）· 自定义翻译（现实↔虚拟名词表）· **同源角色扮演网页（/roleplay）**——角色人设长对话不崩（100 轮测试零漂移）。
|
|
133
|
+
- **零运行时依赖**：手写 stdio MCP 桥，与灵枢 D-005「核心零外部依赖」哲学一致——你拿到的是一个干净、可信、可审的大脑。
|
|
134
|
+
- **动态 schema + 进程自愈**：工具清单运行时拉取（灵枢升级 DSH 零改动），Python 子进程崩溃自动指数退避重启。
|
|
135
|
+
- **工具注册竞态补注册**：启动时 python 未就绪（竞态）→ 桥重连成功后自动补注册工具（2s 轮询），不再"工具永久缺失"。
|
|
136
|
+
- **白箱 wisdom_* 全工具**（`tools: all`）：81 个 MCP 工具含 wisdom_verify/analyze/predict/trust_judge/compose/respond/chat 白箱族，Agent 可直接调用。
|
|
137
|
+
- **内容分级门控**：**拒绝一切涉及未成年人的性内容**（服务端关键词组合硬拦截——未成年人特征词 + 性内容词同时命中即拒绝，`route=refused`）；成人内容由前端本地弹窗提示（满 18 周岁 + 个人对话场景自述）。注：开源项目不实现身份认证/年龄核验（那是绑定身份系统的商业 App 范畴）；内容过滤保护的是"未成年人 + 性内容"组合的明文请求。
|
|
138
|
+
|
|
139
|
+
## 🧠 白箱智能管线（知识查询零 LLM）
|
|
140
|
+
|
|
141
|
+
灵枢处理知识查询走**白箱确定性格局**（不依赖 LLM 生成/校验），完整管线：
|
|
142
|
+
|
|
143
|
+
1. **条件化知识单元**：知识 = `{条件链 → 规律片段}`（最小单元，非完整答案），按条件维度索引（气压/温度/密度/角色/编程任务…）
|
|
144
|
+
2. **方向推理 + 组合生成**：问题动词 → 期望方向（液→气 / 浮沉 / 热传递 / 排序…）→ 匹配单元 → 组合演绎出**未预写的新答案**（如「高原煮饭不熟」由「气压↓→沸点↓」×「高原=气压低」组合生成，无需预写完整答案）
|
|
145
|
+
3. **三层自校验**：方向一致性 + 因果链完整性 + 事实一致性——白箱自己发现生成错误（矛盾问题如「冬天湖面沸腾」2/2 检出）
|
|
146
|
+
4. **知识固化闭环**：自校验通过 → 固化为直答（触发词匹配 + JSON 持久化跨进程生效）→ 下次同问法直接命中；**自举纪律：自校验失败的知识拒绝固化**
|
|
147
|
+
5. **LLM 降级外部校验器**：白箱自校验 vs LLM（DeepSeek v4-flash）外部对照一致率 **100%**（17/17）→ 白箱独立终裁，LLM 仅偶尔抽检对照
|
|
148
|
+
|
|
149
|
+
**已实现的域**：物态变化（沸点/蒸发/液化/凝固/升华/凝华）· 密度浮力 · 热传导 · 摩擦 · 角色条件（鲸鱼娘/猫娘）· 编程规律（排序/去重/计数/最大/反转/求和）
|
|
150
|
+
|
|
151
|
+
**实测指标**（组合引擎 `compose_engine` / `role_compose` / `code_compose`，全部零 LLM）：
|
|
152
|
+
|
|
153
|
+
| 指标 | 值 |
|
|
154
|
+
|---|---|
|
|
155
|
+
| 知识问答白箱率 | **100%**（零 LLM） |
|
|
156
|
+
| 总 token 节约（vs 全 LLM） | **83.3%** |
|
|
157
|
+
| 组合生成测试通过率 | 100%（19/19，目标 ≥80%） |
|
|
158
|
+
| 自校验自发现错误 | 100%（3/3：语法/逻辑/边界） |
|
|
159
|
+
| 矛盾问题检测 | 2/2（白箱自己抓住） |
|
|
160
|
+
| 白箱 vs LLM 对照一致率 | 100%（17/17，目标 ≥90%） |
|
|
161
|
+
| 角色扮演白箱命中 | 7/7（零 LLM，双角色） |
|
|
162
|
+
| 代码组合生成 | 6/6（零 LLM + 语法/样例自校验） |
|
|
163
|
+
|
|
164
|
+
> **83.3% token 节约的适用口径**（issue #4 说明）：该数字测自**确定性任务**——代码编写
|
|
165
|
+
> （生成可本地查表校验的白箱单元）、已有知识问答（触发词命中直答 / 组合演绎复用）
|
|
166
|
+
> 这类「重复模式 + 可固化」场景。机理是把 LLM 的重复查表校验替换为本地确定性校验
|
|
167
|
+
> （Zero-LLM Verifier）。**不适用于**开放创作、长链推理、首次遇到的新领域等无确定基准
|
|
168
|
+
> 的开放判断——这些仍按条件路由降级到 LLM（灵枢诚实边界），无此节约。
|
|
169
|
+
|
|
170
|
+
**角色扮演的白箱化**（v3.3 扮演论工程化）：角色条件单元（身份/住处/食物/性格/话风）× 场景组合生成 → 角色化回答（未预写）；**OOC 检测**（「你是人类吗」→ 角色化否认，逆转操作）；角色语录固化（生成→自校验→固化→直答）；多角色（鲸鱼娘/猫娘）防污染（角色特征隔离，双角色 7/7 零 LLM）。
|
|
171
|
+
|
|
172
|
+
|
|
173
|
+
## 🔄 自迭代闭环 + 能力工作流化（第七阶段 · 条件递归到精准执行）
|
|
174
|
+
|
|
175
|
+
**理论**：在给定条件空间与存在约束下，智能系统通过递归缩小问题与可执行规则之间的信息差，直到获得可验证的执行路径；若条件不足、冲突或不可判定，则延迟（DEFER）/拒绝（REJECT）/声明盲区（BLINDSPOT）；当子系统无法识别，由父系统判断，全层无法判断才标记盲区（分层升级 escalation）。
|
|
176
|
+
|
|
177
|
+
**八步自迭代闭环**（`tools/self_iterate.py`，方向性自检含理论完整性自指检查）：
|
|
178
|
+
|
|
179
|
+
```
|
|
180
|
+
感知(6通道) → 识别(漂移分类) → 分析(影响范围) → 验证(honest+语法)
|
|
181
|
+
→ 固化(字符串内注释对齐+技能) → 记录(轨迹可追溯) → 反馈(已吸收跳过) → 方向性自检
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
- **理论完整性**：第 8 步自检验证「理论八步被工程完整实现」（`test_theory_integrity.py` 6/6）——防步骤因记忆缺漏/遗忘丢失（曾 5 步偏离的教训）
|
|
185
|
+
- **隐式盲区显式化**（荣：返回默认值=不知道=自带盲区）：19 处弱兜底漂移全部显式声明盲区，技能条件化（适用/不适用条件 + 判别词）
|
|
186
|
+
- **自动运行**：`auto_iterate.py` 无人值守循环（感知→吸收→记录→稳态检测），后台持续自迭代
|
|
187
|
+
|
|
188
|
+
**能力工作流化**（`tools/whitebox_workflow.py`，仿 ComfyUI——白箱能力知识图谱化）：
|
|
189
|
+
|
|
190
|
+
```
|
|
191
|
+
node{class_type, inputs} + 边引用[上游,idx] + prompt图 → 拓扑执行 + 循环检测 + JSON保存/复用
|
|
192
|
+
节点类型: code_unit(681单元) / router(条件路由) / mos_declare(元操作声明) / pass(透传)
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
- **路由置信度**（DaoTi coherence 吸纳）：ACCEPT 含连续置信度 [0,1]，低置信可降级
|
|
196
|
+
- **技能条件路由**（anthropics/skills + gliding_horse SkillLink 吸纳）：技能声明适用/不适用条件 + 关系边，条件路由加载
|
|
197
|
+
|
|
198
|
+
**外部感知**：稳态≠停止自迭代——持续扫描 GitHub 高星项目吸纳未理论化的工程实践（langgraph/MetaGPT/cognee/anthropics-skills/DaoTi/gliding_horse 已分析并部分落地）。
|
|
199
|
+
|
|
200
|
+
## 🎭 角色扮演引擎（v3.3 · 扮演论）
|
|
201
|
+
|
|
202
|
+
灵枢的角色扮演机制底座——**机制是灵枢的，载体是酒馆的**。自建两种交互方式（网页 / MCP），信息处理全部由灵枢完成。
|
|
203
|
+
|
|
204
|
+
**核心能力：**
|
|
205
|
+
- **自我锚点**：角色人设核心（身份/性格/底线），SELF 层不可遗忘——OOC 测试 100 轮零漂移
|
|
206
|
+
- **特化价值观**：带触发条件的角色行为准则（条件空间即触发时机）
|
|
207
|
+
- **历史记忆**：跨会话持久（角色记得你聊过什么）+ 世界书导入（Lorebook 兼容）
|
|
208
|
+
- **世界认知（子知识）**：虚拟化世界观模型——虚构世界 = 宿主机（真实知识）上的虚拟机，白箱判定 = Hypervisor（识别/完整性/边界）
|
|
209
|
+
- **自定义翻译（名词替换表）**：现实词 ↔ 虚拟词映射（星星→发光水母 / 城市→珊瑚城），条件空间对齐
|
|
210
|
+
- **编辑/交互双模式**：交互只读；编辑需 `ROLEPLAY_EDIT_KEY`（设置该环境变量后，角色编辑/导入/翻译等写接口须带 `x-edit-key` 请求头，否则 403；未设置时保持本地开发默认开放）；角色人设 ≠ 灵枢自身锚点（后者需设计者验证）
|
|
211
|
+
|
|
212
|
+
**接入方式：**
|
|
213
|
+
```bash
|
|
214
|
+
# A. DSH 同源网页（推荐，插件 v0.2.8+，当前 0.3.1）：插件挂载 /roleplay 到 DSH webServer
|
|
215
|
+
# （与 GUI 同源 127.0.0.1:3080，浏览器/内置 WebView 必达；GUI 首页右上角有「🎭 角色扮演」入口）
|
|
216
|
+
# 功能：角色选择/创建 · 完整对话转录（JSONL，无限上下文）· 双向翻译面板 ·
|
|
217
|
+
# 角色详情三导入 UI（记忆/锚点/价值观）· 内容分级门控（满18确认/拒未成年人性内容）
|
|
218
|
+
|
|
219
|
+
# B. 独立网页服务（浏览器对话 + 人设编辑器）
|
|
220
|
+
python -m aeis.roleplay_web --port 8793 --data-dir roleplay_data
|
|
221
|
+
|
|
222
|
+
# B2. 交互式世界游戏（实时生成场景和对话 · 七层闭环实际验证）
|
|
223
|
+
python -m aeis.game_web.server --port 8791
|
|
224
|
+
# 浏览器打开 http://127.0.0.1:8791/ —— 实时体素世界 + 自然语言生成场景 + 世界感知对话 +
|
|
225
|
+
# 七层闭环可视化（L5命中率/L7好奇/L3关系实时可见）
|
|
226
|
+
|
|
227
|
+
# C. MCP 工具（roleplay_chat / role_create / role_import / role_block）
|
|
228
|
+
python -m aeis.mcp.server
|
|
229
|
+
```
|
|
230
|
+
|
|
231
|
+
**DSH 同源网页（/roleplay）能力：**
|
|
232
|
+
- **完整转录**：引擎记忆只存 80 字摘要，网页层按角色持久化完整对话（`roleplay_data/transcripts/<role>.jsonl`）+ 历史加载——无限上下文
|
|
233
|
+
- **三导入 UI**：角色详情面板（⚙ 详情）编辑 name/scenario/开场白 + **记忆/锚点/价值观**页签（条目=内容+重要性+标签），保存即生效（引擎每次重读 meta）
|
|
234
|
+
- **双向翻译**：输入现实→扮演（引擎自动）+ 输出扮演→现实（网页层可逆替换，长词优先）；词对/模式持久化
|
|
235
|
+
- **内容分级门控**：首次进入前端本地弹「成人内容确认」提示（满 18 周岁 + 个人对话场景自述）；**未成年人特征词 + 性内容词同时命中 → 服务端硬拦截**（`route=refused`）。开源项目不做身份认证（见上）
|
|
236
|
+
- **移动端适配**：输入框聚焦自动居中（不依赖 WebView 键盘行为）、safe-area、键盘不遮挡
|
|
237
|
+
|
|
238
|
+
**质量验证：** `python tools/rp_quality_gate.py --role <id>`（OOC + 世界观一致性自检）· `python tools/run_whale_100.py`（100 轮长对话压力测试）
|
|
239
|
+
|
|
240
|
+
**详细文档：** 主仓库 [README](https://github.com/FuRongJun-1999/CommonTrustProtocol) 角色扮演引擎板块 · [扮演论接入方案](https://github.com/FuRongJun-1999/CommonTrustProtocol/blob/main/docs/扮演论接入酒馆-协议扩散方案.md) · [虚拟化世界观](https://github.com/FuRongJun-1999/CommonTrustProtocol/blob/main/docs/虚拟化世界观-子知识与白箱判定.md)
|
|
241
|
+
|
|
242
|
+
## 📊 记忆系统使用性评分（五维标尺）
|
|
243
|
+
|
|
244
|
+
> 视角：**使用性**（普通用户/开发者体感）——「存、找、想、准、安」五维。
|
|
245
|
+
> 评估基准：公开能力 + 设计者校准（2026-08-17）。灵枢分数经设计者核对（不虚高）。
|
|
246
|
+
|
|
247
|
+
|
|
248
|
+
|
|
249
|
+
（插图源文件：[memory_score.html](docs/memory_score.html)，可浏览器打开重新截图）
|
|
250
|
+
|
|
251
|
+
| 维度 | 0-2 危险 | 3-4 基础 | 5-6 良好 | 7-8 优秀 | 9-10 完美 |
|
|
252
|
+
|---|---|---|---|---|---|
|
|
253
|
+
| **S 存储结构** | 扁平 KV | 简单分层 | 时序/向量 | 图结构+衰减 | 多模态+自动迁移 |
|
|
254
|
+
| **R 检索机制** | 全量遍历 | 关键词 | 向量语义 | 图遍历+混合 | 因果推理+意图理解 |
|
|
255
|
+
| **J 判断引擎** | 只记不忘 | 规则过滤 | LLM 自评估 | 验证单元+递归反思 | 独立元认知+主动遗忘 |
|
|
256
|
+
| **C 上下文信噪比** | 噪声爆炸 | Top-K 有噪 | 时序过滤 | 重要性+精准注入 | 零污染 |
|
|
257
|
+
| **Safety** | 易泄露 | 基础脱敏 | 分级权限 | 隐私树+审计 | 零信任+端到端加密 |
|
|
258
|
+
|
|
259
|
+
**综合分 = min × 0.4 + mean × 0.6**（安全性是底线，短板效应显著）
|
|
260
|
+
|
|
261
|
+
| 排名 | 系统 | S | R | J | C | Safety | 综合 | 锐评 |
|
|
262
|
+
|---|---|---|---|---|---|---|---|---|
|
|
263
|
+
| 🥇 | **灵枢 AEIS** | 7.5 | 8.5 | 8.5 | 9.0 | 8.0 | **8.0** | 五维无短板：图结构+三层语义检索+因果候选生成+验证单元/递归反思+主动遗忘+信噪比仪表盘+护栏宪章审计追踪 |
|
|
264
|
+
| 🥈 | Hy-Memory（腾讯）| 7.5 | 7.0 | 6.0 | 7.0 | 8.0 | 6.6 | 企业级安全标杆；缺主动反思 |
|
|
265
|
+
| 🥉 | Zep / 腾讯云 | 7.5 | 7.0 | 5.5 | 6.5 | 7.5 | 6.3 | 时序图谱+权限控制；不够聪明 |
|
|
266
|
+
| 4 | Letta / MemGPT | 7.5 | 8.0 | 5.0 | 8.0 | 4.0 | 5.7 | 架构强但易记忆越权 |
|
|
267
|
+
| 5 | TiMem | 7.0 | 6.5 | 5.0 | 6.0 | 5.0 | 5.4 | 学术派安全，缺工程隐私治理 |
|
|
268
|
+
| 6 | Mem0 | 6.0 | 6.0 | 4.0 | 5.0 | 4.0 | 4.4 | 记忆碎片化，细粒度权限缺失 |
|
|
269
|
+
| 7 | LangMem | 6.0 | 6.0 | 4.0 | 5.0 | 4.0 | 4.4 | 生态绑定，缺独立安全治理 |
|
|
270
|
+
| 8 | dsh-memory-evolve | 3.0 | 4.0 | 2.0 | 3.0 | 2.0 | 2.6 | 无隐私/权限/删除，「只记不忘」=隐私炸弹 |
|
|
271
|
+
|
|
272
|
+
**灵枢各维度依据**（设计者校准，不虚高）：S=语义时空图+五层记忆+条件空间；R=三层语义检索（二元组+语义坐标+bge）+图谱遍历+因果候选生成器（条件论对自身，被拒路径→候选→验证闭环）+知识点级精确命中（卡⊃知识点嵌套子图）+歧义词多义列举（语境不确定时列全各义）；J=验证单元（P37）+递归反思+白箱校验+结构排斥+主动遗忘决策器（forget_advisor：未使用记忆归档，可逆）+白箱六维测试（诚实/边界/条件/追溯/一致性/记忆 18/18）；C=重要性评分+信息分层注入+诚实边界（命运/健康/超自然/宇宙/读心五类扩展）+信噪比仪表盘（snr_dashboard：压缩率3989:1/图谱信噪比0.9524/200条分层实测严格71%±1/200条边界测试89.5%）；Safety=护栏宪章+审计追踪+物理基底校准+词义时代表（语境时效：多义词按语境分流，钓鱼三义 10/10）（**无端到端加密→8.0 非 8.5**）。
|
|
273
|
+
|
|
274
|
+
> 为什么灵枢断层领先：五维无短板（min=7.5），R（因果发现+验证闭环）、J（验证+反思+主动遗忘）、C（信噪比仪表盘）与 Safety（宪章+审计）是护城河。使用性视角：重要性评分→用户看不到废话；护栏宪章→用户敢把私密信息交给它。
|
|
275
|
+
> 免责声明：他系统评分基于公开能力评估（2026-08-17），非官方基准；灵枢评分经设计者校准。
|
|
276
|
+
|
|
277
|
+
### 知识统一（v1.16 · 智慧之书并入灵枢主库）
|
|
278
|
+
|
|
279
|
+
**一个库 = 完整大脑**：智慧之书（条件论知识图谱）已迁移并入灵枢主库，统一「信息差减少」任务。
|
|
280
|
+
|
|
281
|
+
| 层 | 内容 | 数量 |
|
|
282
|
+
|---|---|---|
|
|
283
|
+
| META 元层 | 存在论/条件论/智能论/学科映射卡 | 30 卡 · 87 边（79 verified） |
|
|
284
|
+
| SUBJECT 学科层 | 51 学科卡 + 3 语言卡（E1-E4，约 2100 知识点） | 54 卡 |
|
|
285
|
+
| STAGE 学段层 | 小学/初中/高中 × 语文/英语/历史/地理/道德与法治 | 13 卡 |
|
|
286
|
+
| META-DISC 元学科 | 历史学/计算机科学/工程学/语言学等（骨架锚点） | 7 卡 |
|
|
287
|
+
| CAUSAL 因果层 | 学段递进（小学→初中→高中→大学）+ 学科归属/类比 | 73 causal + 16 hierarchical 边 |
|
|
288
|
+
|
|
289
|
+
**迁移后全链路工作**（实测）：
|
|
290
|
+
- 图谱信噪比 **0.9524**（verified 80 / 全边 341，超 90% 健康线）
|
|
291
|
+
- 四路融合检索（翻译表+二元组+语义坐标+bge）在主库 **0.11s** 命中学科卡
|
|
292
|
+
- 沿因果链推理：初中物理 → 高中物理 → 大学物理
|
|
293
|
+
- 对话摄入 CONTEXT 情境层（记忆衰减/主动遗忘原料就位）
|
|
294
|
+
- 迁移可复现：`migrate_wisdom.py`（幂等 + 备份 + 报告）
|
|
295
|
+
|
|
296
|
+
### 🎮 一分钟自测你的 AI 记忆系统
|
|
297
|
+
|
|
298
|
+
**给普通人的互动评估页**：15 道选择题测你的 AI 助手记忆能力（存储/检索/判断/信噪比/安全），
|
|
299
|
+
最后雷达图对比灵枢——打开试试：[memory-assessment.html](docs/memory-assessment.html)
|
|
300
|
+
|
|
301
|
+
（B 站宣传素材：[封面](docs/promo/bilibili-cover.jpg) · [视觉图 ×5](docs/promo/)）
|
|
302
|
+
|
|
303
|
+
## 🧰 工具清单（81 个 MCP 工具 · 全量）
|
|
304
|
+
|
|
305
|
+
灵枢 MCP server 注册 **81 个工具**，按心智功能分 11 大模块（智能论 v3.4：端口架构/锚定验证/认知图与条件路由/原生神经网络）。工具清单运行时动态拉取（灵枢升级 DSH 零改动），**完整总表（每个工具一条说明，不重复不遗漏）见 [docs/灵枢MCP工具总表_v3.4.md](docs/灵枢MCP工具总表_v3.4.md)**。下方为分类概览：
|
|
306
|
+
|
|
307
|
+
### 记忆（12）
|
|
308
|
+
|
|
309
|
+
remember / recall / search / timeline / longterm_snapshot / prefeed / promote_memories / pattern_separation / reconstruct_scene / session_note / session_recall / compact_context
|
|
310
|
+
|
|
311
|
+
### 知识图谱与推理（11）
|
|
312
|
+
|
|
313
|
+
relate / reason / induce / distill / think / ingest_text / ingest_file / ingest_url / importance_recalc / transfer_test / flywheel_metrics
|
|
314
|
+
|
|
315
|
+
### 预测与盲区（7）
|
|
316
|
+
|
|
317
|
+
predict_routes / prediction_feedback / prediction_stats / blindspots / learn / gap_trend / calibrate
|
|
318
|
+
|
|
319
|
+
### 感知机/端口架构（8）
|
|
320
|
+
|
|
321
|
+
see（输入端口） / body / body_devices / device_call / run_command（输出端口） / world3d / vprim / visual_check
|
|
322
|
+
|
|
323
|
+
### 验证与确认（10）
|
|
324
|
+
|
|
325
|
+
wisdom_verify / recursive_reflect / preflight / self_reliability / emotional_bias / cognition / cognition_report / action_log / learning_impact / self_check
|
|
326
|
+
|
|
327
|
+
### 生命周期（4）
|
|
328
|
+
|
|
329
|
+
lifecycle_step / lifecycle_state / start_lifecycle / stop_lifecycle
|
|
330
|
+
|
|
331
|
+
### 世界模型 · 游戏服务器（10）
|
|
332
|
+
|
|
333
|
+
voxel_world（小型我的世界 · 4D 时空占用） / world_server（AI 游戏世界服务器 · tick/快照回滚/反馈/同步/预测验证） / scene_simulator（场景级模拟器 · 自主行为玩家） / spacetime_consistency（时空一致性验证 · 持续运行 + 滚动命中率 + 漂移检测 + 自洽判定） / world_model（统一世界模型 · 理解/生成/验证共享同一骨干，生成先验注入理解） / world_learner（自监督世界学习 · 观测序列无标注学转移函数，外部裁判评估认知缺口收紧） / curiosity_explorer（好奇驱动探索 · 有限带宽主动观测，信息增益最大化=盯住信息瓶颈） / seven_layer_loop（七层闭环 · 感知→记忆→理解→预测→验证→物理→决策完整自主循环） / world_generator（文字生图/文字生视频 · 世界模型生成器：文字→场景→3D 图/时序 GIF，确定性） / world_semantics（图像语义提取 · 轮廓/形状/颜色/亮度 → 从外到内 → 图的信息定义，生成-感知闭环）
|
|
334
|
+
|
|
335
|
+
### 智慧之书（6）
|
|
336
|
+
|
|
337
|
+
wisdom_analyze / wisdom_predict / wisdom_trust_judge / wisdom_compose / wisdom_respond / wisdom_chat
|
|
338
|
+
|
|
339
|
+
### 角色扮演（4）
|
|
340
|
+
|
|
341
|
+
roleplay_chat / role_create / role_import / role_block
|
|
342
|
+
|
|
343
|
+
### 洞察（4）
|
|
344
|
+
|
|
345
|
+
insight_record / insight_verify / insight_report / insight_window
|
|
346
|
+
|
|
347
|
+
### 外部（5）
|
|
348
|
+
|
|
349
|
+
web_search / web_ingest_search / export / service_info / designer_decide
|
|
350
|
+
|
|
351
|
+
> 每个工具的功能说明见工具总表（不重复、不遗漏）。
|
|
352
|
+
|
|
353
|
+
> **引擎内部能力（按安全边界未挂载 MCP）**：condition_space_operate（条件空间 7 操作）、add_context（情境层写入）、code_test / compile_exec（代码执行）、lingshu_sensor_report / lingshu_vitality_report / lingshu_auto_snapshot / lingshu_rollback（自修改安全闭环）——存在于引擎中，但刻意不暴露给外部 Agent 调用。
|
|
354
|
+
## 工具筛选机制（tools 配置）
|
|
355
|
+
|
|
356
|
+
| 模式 | 暴露数 | 说明 |
|
|
357
|
+
|---|---|---|
|
|
358
|
+
| `'all'` | **68** | 81 个全量中排除 13 个**宿主级风险工具**（见下），含全部身体/视觉/白箱/角色/智慧之书能力 |
|
|
359
|
+
| `'brain'`（默认） | **36** | 去掉身体的完整大脑：记忆/推理/认知/学习/飞轮/反思/摄取/生命周期/长期记忆门/服务，**不含**身体视觉与风险工具 |
|
|
360
|
+
| `'core'` | **12** | 精选核心：remember/recall/search/timeline/think/relate/predict_routes/ingest_text/ingest_url/session_note/self_check/service_info |
|
|
361
|
+
| 字符串数组 | 自定义 | 显式列出的工具名（不受风险名单限制，配置者已明确选择） |
|
|
362
|
+
|
|
363
|
+
**`'all'` 也排除的宿主级风险工具（13 个）**——`run_command`（宿主命令执行）/ `designer_decide`（设计者裁决·fail-closed）/ `device_call`（外部设备）/ `see`·`world3d`·`vprim`·`visual_check`（身体视觉）/ `start_lifecycle`·`stop_lifecycle`（自主生命周期控制）/ `web_ingest_search`（网络写知识层）/ `role_create`·`role_import`·`role_block`（角色卡写入）。
|
|
364
|
+
|
|
365
|
+
> 数字说明：MCP server 共注册 **81 个工具**（上面全量清单，运行时 tools/list 实测）；`'all'` 实际暴露 68 个（81-13 风险），`'brain'` 实际暴露 36 个，`'core'` 实际暴露 12 个。
|
|
366
|
+
|
|
367
|
+
## 架构
|
|
368
|
+
|
|
369
|
+
```
|
|
370
|
+
┌─────────────────────────────────────────────┐
|
|
371
|
+
│ DeepSeek Harness (cordis) │
|
|
372
|
+
│ │
|
|
373
|
+
│ Agent Loop ──┬── lingshu_remember/recall… │
|
|
374
|
+
│ │ (ctx.tools 注册) │
|
|
375
|
+
│ session/event│ │
|
|
376
|
+
│ (自动记忆钩子)│ │
|
|
377
|
+
└───────────────┼─────────────────────────────┘
|
|
378
|
+
│ stdio · 逐行 JSON-RPC
|
|
379
|
+
│ (initialize → tools/list → tools/call)
|
|
380
|
+
┌───────────────▼─────────────────────────────┐
|
|
381
|
+
│ 灵枢 Python 子进程 (spawn) │
|
|
382
|
+
│ python -m aeis.mcp.server │
|
|
383
|
+
│ AEIS_DB=<path> · AEIS_IDENTITY=<identity> │
|
|
384
|
+
│ 73 工具 · SQLite 五层记忆 · 时空记忆图 │
|
|
385
|
+
└──────────────────────────────────────────────┘
|
|
386
|
+
```
|
|
387
|
+
|
|
388
|
+
## 安装
|
|
389
|
+
|
|
390
|
+
### 前置要求
|
|
391
|
+
|
|
392
|
+
- Node.js ≥ 22.19（DeepSeek Harness 要求）
|
|
393
|
+
- DeepSeek Harness（`npx @deepseek-ai/dsh web`）
|
|
394
|
+
|
|
395
|
+
### 安装灵枢大脑（aeis 库）
|
|
396
|
+
|
|
397
|
+
**方式 A：本地 wheel 离线安装 ★ 最稳（不依赖网络）**
|
|
398
|
+
|
|
399
|
+
在 `CommonTrustProtocol/aeis/dist/` 找到 `aeis-0.4.0-py3-none-any.whl`（**完整自包含发布版**）：
|
|
400
|
+
|
|
401
|
+
```bash
|
|
402
|
+
pip install aeis-0.4.0-py3-none-any.whl
|
|
403
|
+
```
|
|
404
|
+
|
|
405
|
+
> **v0.4.0 起为完整自包含单包**（10.2MB / 343 条目）：灵枢核心（aeis）+ 白箱智慧模块（wisdom，含 **2846 个 KCCS 注释知识点 + 学科知识库**）+ 三入口（harness）+ 种子知识（seed_knowledge，智能论 3.3 + 116 学科卡）。单文件、离线可用、装一次管用——知识库随包分发，无需另装。
|
|
406
|
+
>
|
|
407
|
+
> 遇到网络不稳（GitHub clone 失败）时首选本地 wheel。
|
|
408
|
+
|
|
409
|
+
**方式 B：git 安装（需网络）**
|
|
410
|
+
|
|
411
|
+
```bash
|
|
412
|
+
pip install "aeis @ git+https://github.com/FuRongJun-1999/CommonTrustProtocol@main#subdirectory=aeis"
|
|
413
|
+
```
|
|
414
|
+
|
|
415
|
+
> 依赖 GitHub 实时可达，网络不稳时可能失败。aeis 库核心**零外部依赖**（纯标准库），安装即得完整大脑（五层记忆 · 知识飞轮 · 安全护栏 · 白箱智慧模块 · MCP · 身体层）。
|
|
416
|
+
|
|
417
|
+
### 安装插件本体
|
|
418
|
+
|
|
419
|
+
**方式 A：装进 DSH profile（推荐，pnpm 协调正确入口）**
|
|
420
|
+
|
|
421
|
+
```bash
|
|
422
|
+
dsh plugin --profile web add @furongjun1999/dsh-memory
|
|
423
|
+
```
|
|
424
|
+
|
|
425
|
+
> `dsh plugin --profile <name> add` 会用 pnpm + `autoInstallPeers: false` 正确解析插件依赖。
|
|
426
|
+
> **避免**用 `npm install` 把它装进 profile 的 `node_modules`（会导致 `@deepseek-ai` peer 版本污染，插件加载/浏览器报错）。
|
|
427
|
+
|
|
428
|
+
**方式 B：从独立仓库克隆（开发 / 自定义）**
|
|
429
|
+
|
|
430
|
+
```bash
|
|
431
|
+
git clone https://github.com/FuRongJun-1999/dsh-memory.git
|
|
432
|
+
cd dsh-memory
|
|
433
|
+
npm install && npm run build # 构建插件本身（tsc → lib/）
|
|
434
|
+
# 然后：dsh plugin --profile <name> add <本地路径> 部署进 profile
|
|
435
|
+
```
|
|
436
|
+
|
|
437
|
+
### 启用插件
|
|
438
|
+
|
|
439
|
+
在 profile 的 `cordis.yml`（或 `cordis.patch.yml`）中追加：
|
|
440
|
+
|
|
441
|
+
```yaml
|
|
442
|
+
- id: lingshu-memory
|
|
443
|
+
name: '@furongjun1999/dsh-memory'
|
|
444
|
+
config:
|
|
445
|
+
dbPath: 'D:/data/lingshu.db' # 灵枢记忆库路径（目录自动创建）
|
|
446
|
+
identity: '灵枢'
|
|
447
|
+
tools: 'brain' # 'brain'(默认) | 'core' | 'all'
|
|
448
|
+
memory:
|
|
449
|
+
userMessage: true # 用户消息自动沉淀
|
|
450
|
+
assistantMessage: false # agent 回复沉淀（默认关，防噪音）
|
|
451
|
+
toolResult: false # 工具结果沉淀（默认关）
|
|
452
|
+
autoRecall: true # 模型请求前自动注入最近记忆
|
|
453
|
+
desensitize: true # 写入前过滤敏感信息（密钥/密码/身份证/手机号）
|
|
454
|
+
```
|
|
455
|
+
|
|
456
|
+
完整示例见 [`cordis.yml.example`](./cordis.yml.example)。
|
|
457
|
+
|
|
458
|
+
## 配置项
|
|
459
|
+
|
|
460
|
+
| 字段 | 类型 | 默认值 | 说明 |
|
|
461
|
+
|------|------|--------|------|
|
|
462
|
+
| `serverName` | string | `lingshu` | 工具命名空间前缀（工具名 `lingshu_<name>`） |
|
|
463
|
+
| `python` | string | `python` | Python 可执行文件 |
|
|
464
|
+
| `moduleArgs` | string[] | `['-m', 'aeis.mcp.server']` | 灵枢 server 启动参数 |
|
|
465
|
+
| `dbPath` | string | `data/lingshu.db` | 记忆库 SQLite 路径（自动建目录） |
|
|
466
|
+
| `identity` | string | `灵枢` | 灵枢身份标识 |
|
|
467
|
+
| `env` | object | `{}` | 追加环境变量（`BOCHA_API_KEY` / `AEIS_DESIGNER_KEY` / `DEEPSEEK_API_KEY`（角色扮演 LLM 续答）…，可用 `!!js process.env.X` 从宿主环境注入） |
|
|
468
|
+
| `tools` | `'brain' \| 'core' \| 'all' \| string[]` | `'brain'` | 暴露的工具集合 |
|
|
469
|
+
| `memory.userMessage` | boolean | `true` | 用户消息 → 自动 remember |
|
|
470
|
+
| `memory.assistantMessage` | boolean | `false` | agent 回复 → 自动 remember |
|
|
471
|
+
| `memory.toolResult` | boolean | `false` | 工具结果 → 自动 remember |
|
|
472
|
+
| `memory.importance` | number | `0.6` | 自动记忆的重要性（0~1） |
|
|
473
|
+
| `memory.autoRecall` | boolean | `true` | 模型请求前自动注入灵枢最近记忆（`system-prompt/assemble` 注入，失败静默） |
|
|
474
|
+
| `memory.autoRecallLimit` | number | `4` | 自动召回条数（1~10） |
|
|
475
|
+
| `memory.desensitize` | boolean | `true` | 写入前过滤敏感信息（`sk-`密钥/密码/`Bearer`令牌/18位身份证/11位手机号 → `[已过滤]`；纯凭据消息跳过写入） |
|
|
476
|
+
| `toolCallTimeoutMs` | number | `60000` | 单次工具调用超时 |
|
|
477
|
+
| `maxRetryDelayMs` | number | `30000` | 进程重启最大退避间隔 |
|
|
478
|
+
| `failOnStartupError` | boolean | `false` | 启动失败是否让插件激活失败 |
|
|
479
|
+
|
|
480
|
+
## 自动记忆机制
|
|
481
|
+
|
|
482
|
+
订阅 DSH 的 `session/event` 事件流（与官方 session-persistence 相同的接入点）：
|
|
483
|
+
|
|
484
|
+
- `user/message`（仅 `source.kind === 'user'` 的真实用户消息）→ `remember`（importance 0.6，tags `dsh`）
|
|
485
|
+
- 插件注入的系统上下文（AGENTS.md、文件变更通知等 `kind: 'plugin'`）**不写入**，防止记忆噪音
|
|
486
|
+
- 灵枢自带去重（相似度基准 + 时间窗口），重复消息不会堆积
|
|
487
|
+
- **敏感信息脱敏**（`memory.desensitize`）：写入前过滤 `sk-`密钥 / API key / 密码 / `Bearer`令牌 / 18位身份证 / 11位手机号（替换为 `[已过滤:类别]`）；纯凭据消息整条跳过，不落库
|
|
488
|
+
- **自动召回注入**（`memory.autoRecall`）：每次模型请求组装 system prompt 时自动注入灵枢最近记忆（`system-prompt/assemble` 事件），记忆"自动可用"；召回失败静默不阻塞请求
|
|
489
|
+
|
|
490
|
+
## 🛟 DSH 看门狗（scripts/）
|
|
491
|
+
|
|
492
|
+
DSH 宿主（node 进程）的延时自动重启守护——灵枢桥只重连灵枢 python 进程，本看门狗守护 DSH 宿主（对齐移动端 APK 的 EngineService）：
|
|
493
|
+
|
|
494
|
+
- `scripts/dsh-watchdog.ps1`：监控 3080 端口，进程退出 → 延时 `DelaySec` 秒再确认 → 自动拉起 `dsh web`
|
|
495
|
+
- `-Once` 模式：供 Windows 计划任务每分钟调用（`schtasks /Create /TN dsh-watchdog /TR "wscript.exe ...\dsh-watchdog-launcher.vbs" /SC MINUTE /MO 1`），可靠持久、不依赖驻留进程
|
|
496
|
+
- 驻留模式：`wscript.exe scripts\dsh-watchdog-launcher.vbs -loop`（5 秒快速拉起层）
|
|
497
|
+
- `scripts/dsh-watchdog-launcher.vbs`：vbs 隐藏启动器（`WScript.Shell.Run ..., 0` = 零弹窗）
|
|
498
|
+
- **用法**：改完插件/配置 → 直接 kill DSH 进程 → 看门狗自动拉起新版（无需手敲启动命令）
|
|
499
|
+
- **注意**：脚本输出全英文（powershell 5.1 GBK 读取 UTF-8 无 BOM 中文会解析崩溃）；计划任务 /TR 路径必须带引号（`D:\Program Files\...` 空格截断会弹「没有文件扩展名」）
|
|
500
|
+
|
|
501
|
+
## 开发
|
|
502
|
+
|
|
503
|
+
```bash
|
|
504
|
+
npm install
|
|
505
|
+
npm run build # TypeScript 编译
|
|
506
|
+
npm test # 真实集成测试（spawn 本机灵枢，验证握手/往返/注册/卸载）
|
|
507
|
+
```
|
|
508
|
+
|
|
509
|
+
测试不依赖 DSH 全组件——用最小 Cordis host（SystemPrompt + ToolRegistry + 插件）隔离 v0.1 不稳定面。
|
|
510
|
+
|
|
511
|
+
## 护栏宪章（接入即接受约束）
|
|
512
|
+
|
|
513
|
+
本插件接入即接受 **[灵枢护栏宪章 v2.0-published](docs/guardrail-charter.md)** 约束——
|
|
514
|
+
对外部智能体与人类使用者的行为边界作出公开、可执行、可审计的规定，并保护人类使用者。
|
|
515
|
+
宪章效力不高于智能论协议本身（协议＝自我约束，宪章＝对外约束）。
|
|
516
|
+
本插件随包自带宪章全文（`docs/guardrail-charter.md`），安装即可查阅。
|
|
517
|
+
|
|
518
|
+
## 许可证
|
|
519
|
+
|
|
520
|
+
MIT © 荣（FuRongJun-1999）· 灵枢 AEIS 工程实现
|
|
521
|
+
|
|
522
|
+
DeepSeek Harness 为 DeepSeek 官方开源项目（MIT），本插件与之无隶属关系。
|