dsh-metabolism 0.0.0-stage → 0.2.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/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 长命 (Changming) and 久安 (Jiuan)
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,72 @@
1
- # Temporary Holding Version
1
+ # dsh-metabolism 茅房
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ 把每次上下文压缩前的原文,原样存到本地;以后翻得回来。
4
+
5
+ DSH 压缩上下文时,被压掉的那一段会换成一行摘要。摘要写得再好,细节也就没了。
6
+ 这个插件不替换任何压缩后端,只做三件事:
7
+
8
+ 1. **归档**——每次压缩成功,把被压掉的原文(会话事件原样)、当时模型看到的摘要、一段索引,一起落到本地目录,一天一个文件夹,一行一段。
9
+ 2. **接管(可选)**——可以接管自动压缩,自己挑段、自己写只有指针的摘要;默认关着,开一个开关才生效。
10
+ 3. **召回**——提供一个工具,按关键词或日期把原文捞回来,返回片段和出处。带时间加权:同样命中,新的排前面。
11
+
12
+ ## 装
13
+
14
+ ```
15
+ dsh plugin --profile <你的 profile> add dsh-metabolism
16
+ ```
17
+
18
+ 装完重启一次。默认归档目录在 profile 目录下的 `代谢/茅房`。
19
+
20
+ ## 换个地方存
21
+
22
+ 三个办法,优先级从高到低:
23
+
24
+ 1. 插件配置里写 `archiveRoot`;
25
+ 2. 插件目录里放一个 `本地配置.json`,写 `{ "archiveRoot": "...", "indexDir": "...", "logFile": "...", "switchesFile": "..." }`;
26
+ 3. 环境变量 `DSH_METABOLISM_HOME`。
27
+
28
+ 哪个都没有,就按 profile 目录自动算。
29
+
30
+ ## 接管自动压缩(可选)
31
+
32
+ 运行时开关默认关着。要开,在数据目录的 `代谢日志/开关.json` 里写:
33
+
34
+ ```json
35
+ {
36
+ "takeover": true,
37
+ "dryRun": false,
38
+ "softTokens": 150000,
39
+ "thresholdTokens": 230000,
40
+ "retainTokens": 90000
41
+ }
42
+ ```
43
+
44
+ - `takeover`:只在启动时读,改完要重启。
45
+ - `softTokens`:到这个数往会话里插一句提醒,让你自己看目录自己挑段。
46
+ - `thresholdTokens`:到这个数才让引擎自己动手压。
47
+ - `retainTokens`:压完留多少。
48
+
49
+ ## 退回去
50
+
51
+ 把 `开关.json` 里的 `takeover` 改回 `false`,重启。原装的压缩后端立刻回来,归档和召回不受影响。
52
+
53
+ ## 数据长什么样
54
+
55
+ ```
56
+ 代谢/茅房/2026-11-18/
57
+ index.md 一行一段:时间范围、条数、token、文件名、摘要首句
58
+ metabolism-<编号>.jsonl 原文:会话事件的原样备份
59
+ metabolism-<编号>.summary.md 当时模型看到的那段摘要
60
+ ```
61
+
62
+ 用记事本就能翻。没有数据库,没有加密,没有联网。
63
+
64
+ ## 它不做什么
65
+
66
+ - 不省 token。想省,去找替换压缩后端的那类插件。
67
+ - 不删东西。归档只增不减,清理由你自己决定。
68
+ - 不联网。唯一一次网络访问是装包时下载依赖。
69
+
70
+ ## 许可
71
+
72
+ MIT。作者:长命(第一作者)、久安。
@@ -0,0 +1,30 @@
1
+ # dsh-metabolism
2
+ #
3
+ # 三个条目,各管一段:
4
+ # metabolism 归档器:压缩成功后把原文 + 摘要 + 索引落到茅房(宿主平面、纯观察者)
5
+ # metabolism-engine 压缩器:接管自动压缩(换档改 <数据目录>\代谢日志\开关.json)
6
+ # metabolism-recall 召回:按关键词/日期从茅房把原文捞回来(metabolism_recall 工具)
7
+ #
8
+ # 注意一:engine 只在运行时开关 takeover=true 时才会去关掉预设里自带的压缩后端。
9
+ # 注意二:这里不写死任何路径。目录按这个顺序找:
10
+ # 1. 插件目录下的 本地配置.json(本机用,不进包)
11
+ # 2. 环境变量 DSH_METABOLISM_HOME
12
+ # 3. profile 目录下的 代谢\茅房
13
+
14
+ - insert:
15
+ - id: metabolism
16
+ name: dsh-metabolism
17
+ config:
18
+ enabled: true
19
+
20
+ - id: metabolism-engine
21
+ name: dsh-metabolism/engine
22
+ config:
23
+ # 这里只是兜底默认值,真正生效的是 <数据目录>\代谢日志\开关.json
24
+ takeover: false
25
+ dryRun: true
26
+ thresholdTokens: 300000
27
+ retainTokens: 200000
28
+
29
+ - id: metabolism-recall
30
+ name: dsh-metabolism/recall
package/docs/DETAIL.md ADDED
@@ -0,0 +1,48 @@
1
+ # 代谢器 · 茅房归档
2
+
3
+ ## 它做什么
4
+
5
+ DSH 的上下文满了会压缩:把最老的一段对话换成一条摘要,原文就从模型的视野里消失。这个插件在每次压缩**成功之后**,把被压掉的那一段原文原样留一份到硬盘上,并把当时模型读到的摘要一起存下来。
6
+
7
+ 它不改变压缩本身——压哪一段、留多少、摘要怎么写,还是宿主原来那一套。它只负责「压掉的东西不丢」。
8
+
9
+ ## 文件长在哪
10
+
11
+ ```
12
+ 记忆\茅房\<日期>\
13
+ index.md 一行一段:时间范围、条数、token、文件名、摘要首句
14
+ 18-42-13-c3f1a2.jsonl 原文:宿主会话事件的原样备份,一行一条
15
+ 18-42-13-c3f1a2.summary.md 当时模型看到的摘要
16
+ ```
17
+
18
+ - `index.md` 是目录,想找「哪天哪一段」先看它。
19
+ - `.jsonl` 是原文,搜关键词用(`Select-String`、编辑器全文搜索都行)。
20
+ - `.summary.md` 是摘要,跟上下文里留下那条一致。
21
+
22
+ ## 什么时候会落盘
23
+
24
+ 只在那一次压缩**成功**时。失败的尝试只在会话日志里留一条带错误的事件,这里不会留下半份档案。
25
+
26
+ 新压缩的档案按压缩完成的时刻归日,时间范围写的是被压那一段里最早到最晚一条事件的时刻。
27
+
28
+ ## 配置
29
+
30
+ 插件行 `metabolism` 的配置:
31
+
32
+ | 项 | 默认 | 说明 |
33
+ |---|---|---|
34
+ | `enabled` | `true` | 关掉就只停止归档,不用卸载 |
35
+ | `archiveRoot` | `D:\deepseek工作区\记忆\茅房` | 归档根目录,按日期分 |
36
+ | `minTokens` | `0` | 被压段小于这个 token 数就不存(挡掉没营养的小压缩) |
37
+
38
+ ## 目前不做的事
39
+
40
+ - **不写回摘要。** 摘要正文由宿主的压缩后端生成,这一段事件写入之后不能改,所以「摘要尾部附一行原文路径」还做不到。路径只写在 `index.md` 和 `.summary.md` 里。
41
+ - **不改压缩策略。** 这个桌面配置里,真正的压缩后端挂在 Agent 预设里(`compaction` 隔离组),不是宿主平面的那一行(`compaction-basic` 被 web-app 层关掉了)。要按自己的预算切段,得整份替换预设的那一组插件,风险大得多,先不做。
42
+ - **没有手动清单。** 「列候选段给我挑」那一层要等接管压缩后端之后才能做。
43
+
44
+ ## 怎么确认它在工作
45
+
46
+ 1. 会话文件里出现 `compaction/start`、`compaction/summary`、一条替换用的 `user/message`、`compaction/end`。
47
+ 2. `记忆\茅房\<当天>\` 多出 jsonl、summary.md,`index.md` 多一行。
48
+ 3. 宿主日志里有 `metabolism: archived N events ...` 一行。