dsh-metabolism 0.2.1 → 0.3.0

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 CHANGED
@@ -1,19 +1,22 @@
1
1
  # dsh-metabolism 茅房
2
2
 
3
- 把每次上下文压缩前的原文,原样存到本地;以后翻得回来。
3
+ 压缩上下文时,先把原文存进本地茅房,再换一块有味道的摘要垫进窗口;要细节,按地址翻回来。
4
4
 
5
5
  DSH 压缩上下文时,被压掉的那一段会换成一行摘要。摘要写得再好,细节也就没了。
6
6
  这个插件不替换任何压缩后端,只做三件事:
7
7
 
8
8
  1. **归档**——每次压缩成功,把被压掉的原文(会话事件原样)、当时模型看到的摘要、一段索引,一起落到本地目录,一天一个文件夹,一行一段。
9
- 2. **接管(可选)**——可以接管自动压缩,自己挑段、自己写只有指针的摘要;默认关着,开一个开关才生效。
9
+ 2. **摘要块**——压掉的那段先留一块叙述式摘要(发生了什么、为什么、什么味道),七天折成索引条目,原文永远在茅房;手动收段会先发预告等你写。摘要分经历和事实两类:经历常驻,事实优先折索引。
10
10
  3. **召回**——提供一个工具,按关键词或日期把原文捞回来,返回片段和出处。带时间加权:同样命中,新的排前面。
11
11
 
12
12
  ## 它跟别的压缩插件差在哪
13
13
 
14
14
  普通的上下文压缩插件靠摘要过日子:压一次,细节糊一层;压到第一百次,剩下的就是一层糊。
15
- 这个插件的压法是**指向空**——正文整段搬进本地,模型那边只留一行地址和一句提示;
16
- 哪天要细节,按地址捞回来就是了。所以压多少次都不糊,也不会有一天「压不动」。
15
+ 这个插件的压法是**原文进茅房、摘要当路标**——被压掉的那段留一块五百字上下的叙述式摘要,
16
+ 带一句当时的话和味道;要细节,按地址捞回来就是了。所以压多少次都不糊,也不会有一天「压不动」。
17
+
18
+ 摘要分层:一周以内是事件摘要,七到三十天折成天摘要,三十天外折成一行索引。
19
+ 但摘要总量有预算,够放就永远不折——不浪费窗口,也不糊。
17
20
 
18
21
  配合四层记忆那类插件一起用,一个窗口可以连着开下去,不必换。
19
22
 
@@ -45,9 +48,14 @@ dsh plugin --profile <你的 profile> add dsh-metabolism
45
48
  {
46
49
  "takeover": true,
47
50
  "dryRun": false,
48
- "softTokens": 150000,
49
- "thresholdTokens": 230000,
50
- "retainTokens": 90000
51
+ "softTokens": 380000,
52
+ "thresholdTokens": 400000,
53
+ "retainTokens": 380000,
54
+ "summaryBlock": true,
55
+ "summaryWaitMs": 300000,
56
+ "foldEnabled": true,
57
+ "foldDryRun": false,
58
+ "summaryBudgetTokens": 65000
51
59
  }
52
60
  ```
53
61
 
@@ -55,6 +63,24 @@ dsh plugin --profile <你的 profile> add dsh-metabolism
55
63
  - `softTokens`:到这个数往会话里插一句提醒,让你自己看目录自己挑段。
56
64
  - `thresholdTokens`:到这个数才让引擎自己动手压。
57
65
  - `retainTokens`:压完留多少。
66
+ - `summaryBlock`:开摘要块(默认开)。
67
+ - `summaryWaitMs`:手动收段往后等多久,等你写摘要。
68
+ - `foldEnabled` / `foldDryRun`:折叠开不开、只演练还是真折。
69
+ - `summaryBudgetTokens`:摘要块总量封顶,超了才折。
70
+
71
+ ## 它不会拆开一对调用和结果
72
+
73
+ DeepSeek 要求「带工具调用的那条消息,后面必须紧跟每个调用的结果」。压缩会往会话尾部追加一条 checkpoint,
74
+ 如果这一刻正好有一条调用发出去、结果还没回来,checkpoint 就插在中间,下一次请求直接报
75
+ `tool calls need immediate results`。
76
+
77
+ 所以引擎里加了一道闸:
78
+
79
+ - 表层末端还悬着调用时,一律不写压缩;
80
+ - 手动点压缩(`metabolism_compact`)时,这条调用本身还没回结果,就先排队,
81
+ 等这次结果落地、下一轮开始前再写。
82
+
83
+ 0.2.3 修的就是这个坑。
58
84
 
59
85
  ## 退回去
60
86
 
@@ -73,7 +99,6 @@ dsh plugin --profile <你的 profile> add dsh-metabolism
73
99
 
74
100
  ## 它不做什么
75
101
 
76
- - 不省 token。想省,去找替换压缩后端的那类插件。
77
102
  - 不删东西。归档只增不减,清理由你自己决定。
78
103
  - 不联网。唯一一次网络访问是装包时下载依赖。
79
104
 
package/cordis.patch.yml CHANGED
@@ -28,3 +28,4 @@
28
28
 
29
29
  - id: metabolism-recall
30
30
  name: dsh-metabolism/recall
31
+ # 骨架工具(metabolism_skeleton)跟着 recall 一起挂,不单列条目