@zoria-lind/dsh-ecolink-adapter 0.1.2 → 0.2.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Zoria Lind
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Zoria Lind
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,76 +1,86 @@
-# dsh-ecolink-adapter
-
-dsh-ecolink 的 DSH 适配层(v1):直读本地记忆池(`~/.dsh-memory/memory.json`,只读),
-经 `agent/pre-step` 维持 DSM:memory_write 指令通道(E1),提供 `/ecolink-push` 显式写回(E4)
-与记忆 skill 按需读取(E2),打通"网页端记住 → DSH 直接用;DSH 产出 → 网页端可用"。
-
-> **v0.1.1 变更摘要(E0–E8)**:离线队列并发丢条目修复(E0,extension/core/queue.mjs);
-> 指令/内容通道分离——指令每轮幂等注入(plugin 快照消息,不改写用户消息、不碰前缀缓存),
-> 内容默认不注入、由 skill 按需 read,`contentInjectionEnabled` 为逃生舱(E1);
-> 记忆 skill `ecolink-memory` 运行时注册(E2);服务端快照/hash/diff 三端点(E3);
-> `/ecolink-push` 写回(复用 /memory/sync,source:'dsh',service 唯一写者)(E4);
-> 建议确认队列(sync 进队列、确认才入池;未确认条目不进 DSH 上下文)(E5);
-> 网页端只读面板 + chrome.alarms badge(E6);静音 + 黑名单(E7);服务默认安全(E8)。
->
-> **v1.1(2026-09-14)**:service 自动拉起——探测到 17520 未监听就本机 spawn 拉起
-> (apply + pre-step 60s 节流;仅本地 URL;`serviceAutoStart` 默认开)。E5 设计纠正:
-> 确认点改到 DSH 侧(待实现),随仓 config.json 设 `autoConfirm: true`,网页收割直入池。
-
-## 安装(link 挂载,与 token-optimizer 同款)
-
-```bash
-dsh plugin --profile web add D:/dsh/dsh-plugins/dsh-ecolink/adapter
-```
-
-## 机制
-
-- **只读池文件**:mtime 缓存(文件变化立即重读,TTL 5s 兜底);唯一写者是 ecolink-service
-- **指令通道(E1,默认开)**:每轮 pre-step 末尾追加一条 `source.kind='plugin'` 的
-  `[dsh-ecolink 指令]` 快照消息(照抄内核 dsh-time-context 形态:prepend 注册 + await next +
-  createUserMessage;决策里的 messages 只喂本步请求、不写会话事件)。剥旧追加 → 每轮幂等不叠加
-- **内容通道(E1,默认关)**:`contentInjectionEnabled: true` 恢复旧行为——改写用户消息注入
-  记忆块(2-gram 打分 + 时间衰减 + 预算 + 长提示词缩减 + singleInjection 会话去重)
-- **`/ecolink-push`(E4)**:斜杠命令,把指定要点 POST 到 service 的 `/memory/sync`
-  (source:'dsh');token 未配置时自动读同仓 `service/config.json`;service 是唯一写者
-- **记忆 skill(E2)**:注册 `ecolink-memory`,指引模型用 read 按需读池原文(引用前必须核对)
-- **service 自动拉起(v1.1)**:apply 时与每次 pre-step(60s 节流)探测 `serviceUrl/memory/status`;
-  任何 HTTP 响应(含 401)= 已活;网络错误 = 未运行 → spawn 同仓 `service/server.mjs`
-  (detached + 无窗口)。仅对 127.0.0.1/localhost/::1 生效;service 目录缺失(独立发布包)静默跳过。
-  与登录自启任务兼容:端口已监听就不会重复起
-- **fail-open**:池不存在/读失败/任何异常 → 静默放行,绝不破坏请求
-- 只处理 `source.kind='user'` 的真实用户消息(DSH runtime-context 快照直接放行)
-
-## 配置(cordis.patch.yml)
-
-```yaml
-adapter:
-  enabled: true
-  poolPath: '~/.dsh-memory/memory.json'
-  poolTtlMs: 5000
-  injectEnabled: true            # 总开关(false = 两个通道全关)
-  singleInjection: true          # 内容通道专用(指令通道天然每轮幂等)
-  maxInjectionChars: 3000        # 内容通道注入预算
-  instructionEnabled: true       # E1 指令通道
-  contentInjectionEnabled: false # E1 内容逃生舱
-  skillName: 'ecolink-memory'    # E2 skill 注册名
-  serviceUrl: 'http://127.0.0.1:17520' # E4 写回目标
-  serviceToken: ''               # E4;留空自动读同仓 service/config.json(E8 自动生成)
-  serviceAutoStart: true         # v1.1;探测到服务未运行就自动拉起(仅本地 URL 生效)
-```
-
-## 测试
-
-```bash
-node adapter/test/smoke.mjs   # 66 项,零 API
-```
-
-## 已知限制
-
-- 会话过滤靠 `#记忆名` 显式调用;DSH CLI 的 `--resume <session>` 只接受会话 id,
-  "按命名会话自动绑定"待 DSH 提供 `--session` 能力后再做
-- 与 token-optimizer / behavior-enhancer 的联动开关(两插件中 `memory_bridge` 占位节)
-  待适配层稳定后启用
-- `inject.js` 仍是经典脚本,INSTRUCTION_PROMPT/BLOCK_RE 等与 core/*.mjs 镜像维护
-  (注释锁死);彻底消除镜像需要构建期注入(P5/0D 结论)
-- adapter npm 发布口径未解决:`src/modules/memoryInject.js` 跨目录 import `extension/core/*`,
-  npm `files` 无法引用包根之外路径(E8#5 有据缓办;Junction 挂载不受影响)
+# dsh-ecolink-adapter
+
+dsh-ecolink 的 DSH 适配层(v1):直读本地记忆池(`~/.dsh-memory/memory.json`,只读),
+经 `agent/pre-step` 维持 DSM:memory_write 指令通道(E1),提供 `/ecolink-push` 显式写回(E4)
+与记忆 skill 按需读取(E2),打通"网页端记住 → DSH 直接用;DSH 产出 → 网页端可用"。
+
+> **v0.1.1 变更摘要(E0–E8)**:离线队列并发丢条目修复(E0,extension/core/queue.mjs);
+> 指令/内容通道分离——指令每轮幂等注入(plugin 快照消息,不改写用户消息、不碰前缀缓存),
+> 内容默认不注入、由 skill 按需 read,`contentInjectionEnabled` 为逃生舱(E1);
+> 记忆 skill `ecolink-memory` 运行时注册(E2);服务端快照/hash/diff 三端点(E3);
+> `/ecolink-push` 写回(复用 /memory/sync,source:'dsh',service 唯一写者)(E4);
+> 建议确认队列(sync 进队列、确认才入池;未确认条目不进 DSH 上下文)(E5);
+> 网页端只读面板 + chrome.alarms badge(E6);静音 + 黑名单(E7);服务默认安全(E8)。
+>
+> **v0.2.0(2026-09-25,与 service/extension 同号发布)**:压缩体系重构在 service/扩展侧
+> (事务暂存池 → 模型自报重复数动态下限 → 提交/回滚,详见 service/README.md);
+> adapter 侧:install 方式改为 npm 包安装(`dsh plugin add @zoria-lind/dsh-ecolink-adapter`),
+> bundle patch 的 `name` 已改为 scoped 包名(修复 npm 安装 `cannot resolve package`)。
+>
+> **v1.1(2026-09-14)**:service 自动拉起——探测到 17520 未监听就本机 spawn 拉起
+> (apply + pre-step 60s 节流;仅本地 URL;`serviceAutoStart` 默认开)。E5 设计纠正:
+> 确认点改到 DSH 侧(待实现),随仓 config.json 设 `autoConfirm: true`,网页收割直入池。
+
+## 安装
+
+```bash
+# npm 安装(0.2.0 起推荐)
+dsh plugin --profile web add @zoria-lind/dsh-ecolink-adapter
+
+# 或本地路径(开发)
+dsh plugin --profile web add D:/dsh/dsh-plugins/dsh-ecolink/adapter
+```
+
+## 机制
+
+- **只读池文件**:mtime 缓存(文件变化立即重读,TTL 5s 兜底);唯一写者是 ecolink-service
+- **指令通道(E1,默认开)**:每轮 pre-step 末尾追加一条 `source.kind='plugin'` 的
+  `[dsh-ecolink 指令]` 快照消息(照抄内核 dsh-time-context 形态:prepend 注册 + await next +
+  createUserMessage;决策里的 messages 只喂本步请求、不写会话事件)。剥旧追加 → 每轮幂等不叠加
+- **内容通道(E1,默认关)**:`contentInjectionEnabled: true` 恢复旧行为——改写用户消息注入
+  记忆块(2-gram 打分 + 时间衰减 + 预算 + 长提示词缩减 + singleInjection 会话去重)
+- **`/ecolink-push`(E4)**:斜杠命令,把指定要点 POST 到 service 的 `/memory/sync`
+  (source:'dsh');token 未配置时自动读同仓 `service/config.json`;service 是唯一写者
+- **记忆 skill(E2)**:注册 `ecolink-memory`,指引模型用 read 按需读池原文(引用前必须核对)
+- **service 自动拉起(v1.1)**:apply 时与每次 pre-step(60s 节流)探测 `serviceUrl/memory/status`;
+  任何 HTTP 响应(含 401)= 已活;网络错误 = 未运行 → spawn 同仓 `service/server.mjs`
+  (detached + 无窗口)。仅对 127.0.0.1/localhost/::1 生效;service 目录缺失(独立发布包)静默跳过。
+  与登录自启任务兼容:端口已监听就不会重复起
+- **fail-open**:池不存在/读失败/任何异常 → 静默放行,绝不破坏请求
+- 只处理 `source.kind='user'` 的真实用户消息(DSH runtime-context 快照直接放行)
+
+## 配置(cordis.patch.yml)
+
+```yaml
+adapter:
+  enabled: true
+  poolPath: '~/.dsh-memory/memory.json'
+  poolTtlMs: 5000
+  injectEnabled: true            # 总开关(false = 两个通道全关)
+  singleInjection: true          # 内容通道专用(指令通道天然每轮幂等)
+  maxInjectionChars: 3000        # 内容通道注入预算
+  instructionEnabled: true       # E1 指令通道
+  contentInjectionEnabled: false # E1 内容逃生舱
+  skillName: 'ecolink-memory'    # E2 skill 注册名
+  serviceUrl: 'http://127.0.0.1:17520' # E4 写回目标
+  serviceToken: ''               # E4;留空自动读同仓 service/config.json(E8 自动生成)
+  serviceAutoStart: true         # v1.1;探测到服务未运行就自动拉起(仅本地 URL 生效)
+```
+
+## 测试
+
+```bash
+node adapter/test/smoke.mjs   # 76 项,零 API
+```
+
+## 已知限制
+
+- 会话过滤靠 `#记忆名` 显式调用;DSH CLI 的 `--resume <session>` 只接受会话 id,
+  "按命名会话自动绑定"待 DSH 提供 `--session` 能力后再做
+- 与 token-optimizer / behavior-enhancer 的联动开关(两插件中 `memory_bridge` 占位节)
+  待适配层稳定后启用
+- `inject.js` 仍是经典脚本,INSTRUCTION_PROMPT/BLOCK_RE 等与 core/*.mjs 镜像维护
+  (注释锁死);彻底消除镜像需要构建期注入(P5/0D 结论)
+- npm 发布口径(0.1.3 起已解决):`src/modules/memoryInject.js` 跨目录 import `extension/core/*`,
+  发布时经 `scripts/build-npm-pkgs.mjs` 生成镜像仓库布局的 staging 包
+  (adapter/+extension/core/+service/ 平铺),发布前必须 `npm pack` 解包实测 import 链

package/adapter/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zoria Lind
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/adapter/README.md

@@ -0,0 +1,86 @@
+# dsh-ecolink-adapter
+
+dsh-ecolink 的 DSH 适配层(v1):直读本地记忆池(`~/.dsh-memory/memory.json`,只读),
+经 `agent/pre-step` 维持 DSM:memory_write 指令通道(E1),提供 `/ecolink-push` 显式写回(E4)
+与记忆 skill 按需读取(E2),打通"网页端记住 → DSH 直接用;DSH 产出 → 网页端可用"。
+
+> **v0.1.1 变更摘要(E0–E8)**:离线队列并发丢条目修复(E0,extension/core/queue.mjs);
+> 指令/内容通道分离——指令每轮幂等注入(plugin 快照消息,不改写用户消息、不碰前缀缓存),
+> 内容默认不注入、由 skill 按需 read,`contentInjectionEnabled` 为逃生舱(E1);
+> 记忆 skill `ecolink-memory` 运行时注册(E2);服务端快照/hash/diff 三端点(E3);
+> `/ecolink-push` 写回(复用 /memory/sync,source:'dsh',service 唯一写者)(E4);
+> 建议确认队列(sync 进队列、确认才入池;未确认条目不进 DSH 上下文)(E5);
+> 网页端只读面板 + chrome.alarms badge(E6);静音 + 黑名单(E7);服务默认安全(E8)。
+>
+> **v0.2.0(2026-09-25,与 service/extension 同号发布)**:压缩体系重构在 service/扩展侧
+> (事务暂存池 → 模型自报重复数动态下限 → 提交/回滚,详见 service/README.md);
+> adapter 侧:install 方式改为 npm 包安装(`dsh plugin add @zoria-lind/dsh-ecolink-adapter`),
+> bundle patch 的 `name` 已改为 scoped 包名(修复 npm 安装 `cannot resolve package`)。
+>
+> **v1.1(2026-09-14)**:service 自动拉起——探测到 17520 未监听就本机 spawn 拉起
+> (apply + pre-step 60s 节流;仅本地 URL;`serviceAutoStart` 默认开)。E5 设计纠正:
+> 确认点改到 DSH 侧(待实现),随仓 config.json 设 `autoConfirm: true`,网页收割直入池。
+
+## 安装
+
+```bash
+# npm 安装(0.2.0 起推荐)
+dsh plugin --profile web add @zoria-lind/dsh-ecolink-adapter
+
+# 或本地路径(开发)
+dsh plugin --profile web add D:/dsh/dsh-plugins/dsh-ecolink/adapter
+```
+
+## 机制
+
+- **只读池文件**:mtime 缓存(文件变化立即重读,TTL 5s 兜底);唯一写者是 ecolink-service
+- **指令通道(E1,默认开)**:每轮 pre-step 末尾追加一条 `source.kind='plugin'` 的
+  `[dsh-ecolink 指令]` 快照消息(照抄内核 dsh-time-context 形态:prepend 注册 + await next +
+  createUserMessage;决策里的 messages 只喂本步请求、不写会话事件)。剥旧追加 → 每轮幂等不叠加
+- **内容通道(E1,默认关)**:`contentInjectionEnabled: true` 恢复旧行为——改写用户消息注入
+  记忆块(2-gram 打分 + 时间衰减 + 预算 + 长提示词缩减 + singleInjection 会话去重)
+- **`/ecolink-push`(E4)**:斜杠命令,把指定要点 POST 到 service 的 `/memory/sync`
+  (source:'dsh');token 未配置时自动读同仓 `service/config.json`;service 是唯一写者
+- **记忆 skill(E2)**:注册 `ecolink-memory`,指引模型用 read 按需读池原文(引用前必须核对)
+- **service 自动拉起(v1.1)**:apply 时与每次 pre-step(60s 节流)探测 `serviceUrl/memory/status`;
+  任何 HTTP 响应(含 401)= 已活;网络错误 = 未运行 → spawn 同仓 `service/server.mjs`
+  (detached + 无窗口)。仅对 127.0.0.1/localhost/::1 生效;service 目录缺失(独立发布包)静默跳过。
+  与登录自启任务兼容:端口已监听就不会重复起
+- **fail-open**:池不存在/读失败/任何异常 → 静默放行,绝不破坏请求
+- 只处理 `source.kind='user'` 的真实用户消息(DSH runtime-context 快照直接放行)
+
+## 配置(cordis.patch.yml)
+
+```yaml
+adapter:
+  enabled: true
+  poolPath: '~/.dsh-memory/memory.json'
+  poolTtlMs: 5000
+  injectEnabled: true            # 总开关(false = 两个通道全关)
+  singleInjection: true          # 内容通道专用(指令通道天然每轮幂等)
+  maxInjectionChars: 3000        # 内容通道注入预算
+  instructionEnabled: true       # E1 指令通道
+  contentInjectionEnabled: false # E1 内容逃生舱
+  skillName: 'ecolink-memory'    # E2 skill 注册名
+  serviceUrl: 'http://127.0.0.1:17520' # E4 写回目标
+  serviceToken: ''               # E4;留空自动读同仓 service/config.json(E8 自动生成)
+  serviceAutoStart: true         # v1.1;探测到服务未运行就自动拉起(仅本地 URL 生效)
+```
+
+## 测试
+
+```bash
+node adapter/test/smoke.mjs   # 76 项,零 API
+```
+
+## 已知限制
+
+- 会话过滤靠 `#记忆名` 显式调用;DSH CLI 的 `--resume <session>` 只接受会话 id,
+  "按命名会话自动绑定"待 DSH 提供 `--session` 能力后再做
+- 与 token-optimizer / behavior-enhancer 的联动开关(两插件中 `memory_bridge` 占位节)
+  待适配层稳定后启用
+- `inject.js` 仍是经典脚本,INSTRUCTION_PROMPT/BLOCK_RE 等与 core/*.mjs 镜像维护
+  (注释锁死);彻底消除镜像需要构建期注入(P5/0D 结论)
+- npm 发布口径(0.1.3 起已解决):`src/modules/memoryInject.js` 跨目录 import `extension/core/*`,
+  发布时经 `scripts/build-npm-pkgs.mjs` 生成镜像仓库布局的 staging 包
+  (adapter/+extension/core/+service/ 平铺),发布前必须 `npm pack` 解包实测 import 链

package/{cordis.patch.yml → adapter/cordis.patch.yml}

@@ -1,19 +1,19 @@
-# dsh-ecolink-adapter bundle layer:挂载适配层。
-- insert:
-    - id: ecolink-adapter
-      name: 'dsh-ecolink-adapter'
-      config:
-        adapter:
-          enabled: true
-          poolPath: '~/.dsh-memory/memory.json'
-          poolTtlMs: 5000
-          injectEnabled: true
-          singleInjection: true
-          maxInjectionChars: 3000
-          # E1 通道分离:指令每轮幂等注入;内容默认不注入(按需 read,见 skill)
-          instructionEnabled: true
-          contentInjectionEnabled: false   # 逃生舱:true 恢复旧的"改写用户消息注入记忆块"行为
-          skillName: 'ecolink-memory'      # E2 记忆 skill 注册名
-          # E4 写回:/ecolink-push 经 service 的 POST /memory/sync 落盘(唯一写者)
-          serviceUrl: 'http://127.0.0.1:17520'
-          serviceToken: ''                 # 留空自动读同仓 service/config.json 的 token(E8 自动生成)
+# dsh-ecolink-adapter bundle layer:挂载适配层。
+- insert:
+    - id: ecolink-adapter
+      name: '@zoria-lind/dsh-ecolink-adapter'
+      config:
+        adapter:
+          enabled: true
+          poolPath: '~/.dsh-memory/memory.json'
+          poolTtlMs: 5000
+          injectEnabled: true
+          singleInjection: true
+          maxInjectionChars: 3000
+          # E1 通道分离:指令每轮幂等注入;内容默认不注入(按需 read,见 skill)
+          instructionEnabled: true
+          contentInjectionEnabled: false   # 逃生舱:true 恢复旧的"改写用户消息注入记忆块"行为
+          skillName: 'ecolink-memory'      # E2 记忆 skill 注册名
+          # E4 写回:/ecolink-push 经 service 的 POST /memory/sync 落盘(唯一写者)
+          serviceUrl: 'http://127.0.0.1:17520'
+          serviceToken: ''                 # 留空自动读同仓 service/config.json 的 token(E8 自动生成)

package/{src → adapter/src}/config.js

@@ -1,49 +1,49 @@
-// dsh-ecolink-adapter 配置。与 token-optimizer / behavior-enhancer 同款 resolveSection 模式。
-
-export const DEFAULT_CONFIG = {
-  adapter: {
-    enabled: true,
-    poolPath: '~/.dsh-memory/memory.json', // 只读;唯一写者是 ecolink-service
-    poolTtlMs: 5000,          // 池文件缓存(mtime 变化立即重读,否则 TTL 兜底)
-    injectEnabled: true,      // 总开关(false = 两个通道全关)
-    singleInjection: true,    // 内容通道专用:每 DSH 会话只注入一次(指令通道天然每轮幂等,不适用)
-    maxInjectionChars: 3000,  // 内容通道注入预算(长提示词自动缩减,与网页端同规则)
-    // E1 通道分离:指令每轮幂等注入(维持 DSM:memory_write 捕获);内容默认不再注入
-    instructionEnabled: true,       // 指令通道(pre-step 追加 plugin 快照消息)
-    contentInjectionEnabled: false, // 内容通道逃生舱(旧行为:改写用户消息注入记忆块)
-    skillName: 'ecolink-memory',    // E2 记忆 skill 的注册名(kebab-case)
-    // E4 写回:POST /memory/sync 到本机 service(service 是唯一写者,DSH 只发请求)
-    serviceUrl: 'http://127.0.0.1:17520',
-    serviceToken: '',               // 留空则自动读同仓 service/config.json 的 token(E8 自动生成)
-    serviceAutoStart: true,         // v1.1:探测到 service 未运行就自动拉起(仅本地 URL;见 serviceGuard.js)
-  },
-}
-
-const NUMERIC_KEYS = new Set(['poolTtlMs', 'maxInjectionChars'])
-
-function resolveSection(section, defaults) {
-  const out = { ...defaults }
-  if (section && typeof section === 'object') {
-    for (const [key, value] of Object.entries(section)) {
-      if (!(key in defaults)) {
-        throw new Error(`dsh-ecolink-adapter config: unknown key "${key}" (allowed: ${Object.keys(defaults).join(', ')})`)
-      }
-      if (NUMERIC_KEYS.has(key)) {
-        if (!Number.isFinite(value) || value <= 0) {
-          throw new Error(`dsh-ecolink-adapter config: ${key} (${value}) must be a positive number`)
-        }
-      } else if (typeof value !== typeof defaults[key]) {
-        throw new Error(`dsh-ecolink-adapter config: "${key}" must be ${typeof defaults[key]}`)
-      }
-      out[key] = value
-    }
-  }
-  return Object.freeze(out)
-}
-
-export function resolveConfig(config = {}) {
-  if (typeof config !== 'object' || config === null) config = {}
-  return Object.freeze({
-    adapter: resolveSection(config.adapter, DEFAULT_CONFIG.adapter),
-  })
-}
+// dsh-ecolink-adapter 配置。与 token-optimizer / behavior-enhancer 同款 resolveSection 模式。
+
+export const DEFAULT_CONFIG = {
+  adapter: {
+    enabled: true,
+    poolPath: '~/.dsh-memory/memory.json', // 只读;唯一写者是 ecolink-service
+    poolTtlMs: 5000,          // 池文件缓存(mtime 变化立即重读,否则 TTL 兜底)
+    injectEnabled: true,      // 总开关(false = 两个通道全关)
+    singleInjection: true,    // 内容通道专用:每 DSH 会话只注入一次(指令通道天然每轮幂等,不适用)
+    maxInjectionChars: 3000,  // 内容通道注入预算(长提示词自动缩减,与网页端同规则)
+    // E1 通道分离:指令每轮幂等注入(维持 DSM:memory_write 捕获);内容默认不再注入
+    instructionEnabled: true,       // 指令通道(pre-step 追加 plugin 快照消息)
+    contentInjectionEnabled: false, // 内容通道逃生舱(旧行为:改写用户消息注入记忆块)
+    skillName: 'ecolink-memory',    // E2 记忆 skill 的注册名(kebab-case)
+    // E4 写回:POST /memory/sync 到本机 service(service 是唯一写者,DSH 只发请求)
+    serviceUrl: 'http://127.0.0.1:17520',
+    serviceToken: '',               // 留空则自动读同仓 service/config.json 的 token(E8 自动生成)
+    serviceAutoStart: true,         // v1.1:探测到 service 未运行就自动拉起(仅本地 URL;见 serviceGuard.js)
+  },
+}
+
+const NUMERIC_KEYS = new Set(['poolTtlMs', 'maxInjectionChars'])
+
+function resolveSection(section, defaults) {
+  const out = { ...defaults }
+  if (section && typeof section === 'object') {
+    for (const [key, value] of Object.entries(section)) {
+      if (!(key in defaults)) {
+        throw new Error(`dsh-ecolink-adapter config: unknown key "${key}" (allowed: ${Object.keys(defaults).join(', ')})`)
+      }
+      if (NUMERIC_KEYS.has(key)) {
+        if (!Number.isFinite(value) || value <= 0) {
+          throw new Error(`dsh-ecolink-adapter config: ${key} (${value}) must be a positive number`)
+        }
+      } else if (typeof value !== typeof defaults[key]) {
+        throw new Error(`dsh-ecolink-adapter config: "${key}" must be ${typeof defaults[key]}`)
+      }
+      out[key] = value
+    }
+  }
+  return Object.freeze(out)
+}
+
+export function resolveConfig(config = {}) {
+  if (typeof config !== 'object' || config === null) config = {}
+  return Object.freeze({
+    adapter: resolveSection(config.adapter, DEFAULT_CONFIG.adapter),
+  })
+}

package/{src → adapter/src}/index.js

@@ -1,77 +1,77 @@
-// dsh-ecolink-adapter(E1/E2):dsh-ecolink 的 DSH 适配层。
-// 职责(PLAN §6/§8):直读 memory.json(只读,唯一写者是 ecolink-service),
-// pre-step 指令通道(每轮幂等追加 plugin 快照消息,E1)+ 可选内容注入逃生舱 +
-// 记忆 skill 运行时注册(E2:内容按需 read),与网页端记忆生态打通。
-// 与 token-optimizer / behavior-enhancer 的联动开关(memory_bridge 配置节)已
-// 在两者中占位,等适配层稳定后在各自 README 说明如何开启。
-
-import { DEFAULT_CONFIG, resolveConfig } from './config.js'
-import { createMemoryInjectModule } from './modules/memoryInject.js'
-import { createMemoryWriteModule } from './modules/memoryWrite.js'
-import { createServiceGuardModule } from './modules/serviceGuard.js'
-import { createMemoryDiffModule } from './modules/memoryDiff.js'
-
-// E2 记忆 skill 正文:指引模型按需 read 记忆池(内容不再自动注入,这里是读取入口)。
-// 引用细节前必须 read 原文核对(沿用 token-optimizer 的堵漏原则)。
-const SKILL_CONTENT = `# dsh-ecolink 跨端记忆池
-
-本机记忆池文件:\`~/.dsh-memory/memory.json\`(归档:\`~/.dsh-memory/archive.json\`)。
-网页端(chat.deepseek.com)与 DSH 共用这一份结构化池;网页端记过的事实在这里能查到。
-
-## 文件结构
-- 顶层:{ version, shared_pool: [...], session_pools: { <网页会话id>: { identity, memories: [...] } } }
-- 条目字段:id / key / content / timestamp(UTC ISO) / time_precision / source(web|dsm-import|dsh) / importance(always|called) / pinned / last_accessed
-- shared_pool 是跨会话共享记忆;session_pools 按网页会话分组,identity 是该会话的人类可读名
-
-## 何时读
-- 用户提到"我在网页端记过 / 之前说过 / 我的偏好"等跨端记忆问题时
-- 需要回忆历史偏好、项目约定、个人事实,而当前上下文没有答案时
-
-## 使用规则
-- 先运行 /ecolink-diff 命令获取记忆池自上次查看以来的新增/变化(本会话或重启后首次调用会返回全量)——多数问题只靠这个结果就能答
-- 禁止在未查询记忆池的情况下回答"不知道/不记得/没有记录":记忆池与本对话上下文是两回事,池里有而上下文没有是常态
-- 需要核对细节或完整历史时,用 read 工具读取 memory.json 原文;引用任何记忆细节前必须先读到原文,禁止凭印象回答
-- timestamp 是 UTC 存储值(例:2026-09-14T10:24Z = 本地 18:24,本机时区 UTC+8)。展示给用户时**必须先转本地时间**,再按龄降精度:2 小时内→分钟,48 小时内→小时,5 天内→日期,更早不显示时间;禁止直接把 UTC 原值当本地时间展示
-- 记忆可能过时:时间戳较旧或与当前对话矛盾时,先向用户复述该记忆并确认,不要当作当前事实直接使用
-`
-
-export function apply(ctx, config = {}) {
-  const resolved = resolveConfig(config)
-  const stats = { bump() {}, addSample() {}, dispose() {}, snapshot() { return {} } }
-  const modules = []
-  modules.push(createMemoryInjectModule(ctx, resolved.adapter, stats))
-  // E4:DSH 记忆写回(/ecolink-push 显式触发;service 是唯一写者)
-  modules.push(createMemoryWriteModule(ctx, resolved.adapter, stats))
-  // E9:记忆 diff 查看(/ecolink-diff;调用即读取事件,游标随调用推进,skill 优先走这条)
-  modules.push(createMemoryDiffModule(ctx, resolved.adapter, stats))
-  // v1.1:service 未运行时自动拉起(先探测后 spawn,已在跑就不会重复起)
-  modules.push(createServiceGuardModule(ctx, resolved.adapter, stats))
-
-  // E2:记忆 skill 运行时注册(register 返回 Cordis disposer,非 Promise;
-  // 同名重复注册是 first-wins + no-op disposer,重复挂载不会叠加)。
-  // inject 依赖缺失时本回调永不执行(插件其余部分不受影响)。
-  const skillDisposers = []
-  ctx.inject?.(['skills'], (skillCtx) => {
-    try {
-      skillDisposers.push(skillCtx.skills.register({
-        name: resolved.adapter.skillName,
-        description: '按需读取 dsh-ecolink 跨端记忆池(~/.dsh-memory/memory.json)',
-        whenToUse: '需要回忆网页端记过的偏好/事实/决策,或用户提到之前记过的内容时',
-        content: SKILL_CONTENT,
-        source: 'runtime',
-      }))
-    } catch (err) {
-      console.warn(`[dsh-ecolink-adapter] skill 注册失败(${err?.message ?? err})`)
-    }
-  })
-
-  return () => {
-    for (const cleanup of modules) cleanup()
-    for (const dispose of skillDisposers) {
-      try { dispose?.() } catch { /* noop */ }
-    }
-    stats.dispose()
-  }
-}
-
-export { DEFAULT_CONFIG, resolveConfig }
+// dsh-ecolink-adapter(E1/E2):dsh-ecolink 的 DSH 适配层。
+// 职责(PLAN §6/§8):直读 memory.json(只读,唯一写者是 ecolink-service),
+// pre-step 指令通道(每轮幂等追加 plugin 快照消息,E1)+ 可选内容注入逃生舱 +
+// 记忆 skill 运行时注册(E2:内容按需 read),与网页端记忆生态打通。
+// 与 token-optimizer / behavior-enhancer 的联动开关(memory_bridge 配置节)已
+// 在两者中占位,等适配层稳定后在各自 README 说明如何开启。
+
+import { DEFAULT_CONFIG, resolveConfig } from './config.js'
+import { createMemoryInjectModule } from './modules/memoryInject.js'
+import { createMemoryWriteModule } from './modules/memoryWrite.js'
+import { createServiceGuardModule } from './modules/serviceGuard.js'
+import { createMemoryDiffModule } from './modules/memoryDiff.js'
+
+// E2 记忆 skill 正文:指引模型按需 read 记忆池(内容不再自动注入,这里是读取入口)。
+// 引用细节前必须 read 原文核对(沿用 token-optimizer 的堵漏原则)。
+const SKILL_CONTENT = `# dsh-ecolink 跨端记忆池
+
+本机记忆池文件:\`~/.dsh-memory/memory.json\`(归档:\`~/.dsh-memory/archive.json\`)。
+网页端(chat.deepseek.com)与 DSH 共用这一份结构化池;网页端记过的事实在这里能查到。
+
+## 文件结构
+- 顶层:{ version, shared_pool: [...], session_pools: { <网页会话id>: { identity, memories: [...] } } }
+- 条目字段:id / key / content / timestamp(UTC ISO) / time_precision / source(web|dsm-import|dsh) / importance(always|called) / pinned / last_accessed
+- shared_pool 是跨会话共享记忆;session_pools 按网页会话分组,identity 是该会话的人类可读名
+
+## 何时读
+- 用户提到"我在网页端记过 / 之前说过 / 我的偏好"等跨端记忆问题时
+- 需要回忆历史偏好、项目约定、个人事实,而当前上下文没有答案时
+
+## 使用规则
+- 先运行 /ecolink-diff 命令获取记忆池自上次查看以来的新增/变化(本会话或重启后首次调用会返回全量)——多数问题只靠这个结果就能答
+- 禁止在未查询记忆池的情况下回答"不知道/不记得/没有记录":记忆池与本对话上下文是两回事,池里有而上下文没有是常态
+- 需要核对细节或完整历史时,用 read 工具读取 memory.json 原文;引用任何记忆细节前必须先读到原文,禁止凭印象回答
+- timestamp 是 UTC 存储值(例:2026-09-14T10:24Z = 本地 18:24,本机时区 UTC+8)。展示给用户时**必须先转本地时间**,再按龄降精度:2 小时内→分钟,48 小时内→小时,5 天内→日期,更早不显示时间;禁止直接把 UTC 原值当本地时间展示
+- 记忆可能过时:时间戳较旧或与当前对话矛盾时,先向用户复述该记忆并确认,不要当作当前事实直接使用
+`
+
+export function apply(ctx, config = {}) {
+  const resolved = resolveConfig(config)
+  const stats = { bump() {}, addSample() {}, dispose() {}, snapshot() { return {} } }
+  const modules = []
+  modules.push(createMemoryInjectModule(ctx, resolved.adapter, stats))
+  // E4:DSH 记忆写回(/ecolink-push 显式触发;service 是唯一写者)
+  modules.push(createMemoryWriteModule(ctx, resolved.adapter, stats))
+  // E9:记忆 diff 查看(/ecolink-diff;调用即读取事件,游标随调用推进,skill 优先走这条)
+  modules.push(createMemoryDiffModule(ctx, resolved.adapter, stats))
+  // v1.1:service 未运行时自动拉起(先探测后 spawn,已在跑就不会重复起)
+  modules.push(createServiceGuardModule(ctx, resolved.adapter, stats))
+
+  // E2:记忆 skill 运行时注册(register 返回 Cordis disposer,非 Promise;
+  // 同名重复注册是 first-wins + no-op disposer,重复挂载不会叠加)。
+  // inject 依赖缺失时本回调永不执行(插件其余部分不受影响)。
+  const skillDisposers = []
+  ctx.inject?.(['skills'], (skillCtx) => {
+    try {
+      skillDisposers.push(skillCtx.skills.register({
+        name: resolved.adapter.skillName,
+        description: '按需读取 dsh-ecolink 跨端记忆池(~/.dsh-memory/memory.json)',
+        whenToUse: '需要回忆网页端记过的偏好/事实/决策,或用户提到之前记过的内容时',
+        content: SKILL_CONTENT,
+        source: 'runtime',
+      }))
+    } catch (err) {
+      console.warn(`[dsh-ecolink-adapter] skill 注册失败(${err?.message ?? err})`)
+    }
+  })
+
+  return () => {
+    for (const cleanup of modules) cleanup()
+    for (const dispose of skillDisposers) {
+      try { dispose?.() } catch { /* noop */ }
+    }
+    stats.dispose()
+  }
+}
+
+export { DEFAULT_CONFIG, resolveConfig }