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

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,76 @@
+# 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 挂载不受影响)

package/extension/core/config.mjs

@@ -0,0 +1,21 @@
+// dsh-ecolink 扩展默认配置单一来源(E6/F6:此前 background/popup/inject 三处默认值
+// 互不一致——background 8 键、popup 7 键少 tagName、inject 4 键)。
+// 消费方式:
+//   - background.js(MV3 module)与 popup.js(popup.html 以 type=module 加载):直接 import
+//   - inject.js 是经典脚本不能 import → 页内镜像仅保留它真正需要的 4 键,注释锁死同步
+//   - content.js 不读配置(只透传)
+
+export const DEFAULT_CONFIG = {
+  bridgeUrl: 'http://127.0.0.1:17520',
+  token: '',
+  injectEnabled: true,
+  harvestEnabled: true,
+  singleInjection: true, // 内容通道(2026-09-14 恢复):true=首条全量+后续 diff;false=每轮全量。压缩块沿用每页一次去重
+  contentInjectionEnabled: true, // 内容注入逃生舱(E1 逃生舱键,默认开):false=回到 E1 纯指令行为
+  maxInjectionChars: 3000,
+  compressMinAgeDays: 5,
+  tagName: 'DSM:memory_write', // 注意:F11——当前全仓消费点均硬编码 'DSM:memory_write',此键暂为死配置,改它不生效
+  panelEnabled: true, // E6:网页端只读面板
+  muted: false, // E7:一键静音(注入+收割全关;优先级高于两个分开关)
+  debug: false, // 背景层 console 日志门控(默认关;隐私卫生,收割内容片段不入 console)
+}

package/extension/core/harvest.mjs

@@ -0,0 +1,86 @@
+// 标签收割:从模型回复流中提取 <DSM:memory_write> 标签(PLAN §3.1 主路径)。
+// 纯函数、无浏览器依赖——SSE 累积文本在流结束时一次提取,标签从文本中剥离
+// (ReadableStream 重写层保证标签永不进 DOM)。
+// 黑名单校验参照 DSM 的 isValidMemoryWrite 模式:模型不服从/吐垃圾时宁弃勿存。
+
+const DEFAULT_TAG = 'DSM:memory_write'
+
+function escapeRe(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+}
+
+// 标签内容允许的简短修饰前缀(如 "importance:key|内容"),其余视为纯文本
+const PREFIX_RE = /^(?:importance\s*:\s*(key|called|temp|context)\s*\|)/i
+// DSM 属性形式:<DSM:memory_write key="snake_key" importance="always|called">value</DSM:memory_write>
+// 模型对 DSM 格式有惯性,兼容吸收,服从率最高
+const ATTR_RE = /^<DSM:memory_write\s+key="[^"]*"\s+importance="(always|called)">([\s\S]*?)<\/DSM:memory_write>$/i
+
+// 模型常见不服从输出:占位/元话/自我描述/格式示例回显,一律不收(黑名单)。
+// DSM 同款防御(其 zm 校验函数实测对抗有效):
+//   ① 杀手规则——值含方括号/花括号/尖括号一律拒([fact from user's message]、
+//      <tag> 回显等整类垃圾一条规则通杀;真实记忆极少含这三种括号,代价可接受)
+//   ② 黑名单子串匹配(非锚定,更宽)
+//   ③ user_name 长度 sanity
+const BRACKET_RE = /\[.*?\]|\{.*?\}|<.*?>/
+const STANDALONE_RE = /^(待补充|待填写|待确认|TODO|TBD|\.\.\.|暂无|无|空|memory[_ ]?write)$/i
+// DSM(MIT,Md. Wahid)完整黑名单 + 本项目的增量条目(指令回显等)
+const SUBSTRING_BLACKLIST = [
+  ...['example_name', 'extracted_name', 'extracted_country', 'extracted_language', 'placeholder', 'example', '[fact from user', '[extracted_', '[user_name]', '[user_country]', '[user_language]', 'your_name_here', 'your_country_here', 'sample_name'],
+  ...['brief fact', 'snake_case_key', 'fact from user', '记忆内容', '输出记忆标签', 'key: fact', '开头,紧接着写事实,以', '开头,紧接着写该条内容,以', '三部分连在一起', '事实内容'],
+]
+const KEY_BLACKLIST = new Set(['snake_case_key', 'example', 'example_name', 'example_key', 'placeholder', 'sample', 'key'])
+
+export function extractTags(text, tagName = DEFAULT_TAG) {
+  const safe = escapeRe(tagName)
+  const plainRe = new RegExp(`<${safe}>([\\s\\S]*?)</${safe}>`, 'gi')
+  const attrRe = new RegExp(`<${safe}\\s+key="[^"]*"\\s+importance="[^"]*">[\\s\\S]*?</${safe}>`, 'gi')
+  const memories = []
+  // 前端可能把标签转义渲染(&lt;DSM:memory_write&gt;),先还原再解析(DSM Gr 同款)
+  const cleaned = String(text ?? '').replace(/&lt;/gi, '<').replace(/&gt;/gi, '>')
+    // 属性形式保留完整标签(parseTagContent 要读属性),纯文本形式只取内容
+    .replace(attrRe, (all) => { memories.push(all); return '' })
+    .replace(plainRe, (_all, inner) => { memories.push(inner); return '' })
+  return { cleaned, memories }
+}
+
+export function parseTagContent(raw) {
+  let s = String(raw ?? '').trim()
+  const m = PREFIX_RE.exec(s)
+  if (m) return { importance: m[1].toLowerCase(), content: s.slice(m[0].length).trim(), key: null }
+  // DSM 属性形式(整段 raw 含属性标签时):提取 key/value/importance
+  // (key = 压缩/更新闭环的锚点:同 key 覆盖旧值,PLAN §4.4 replace 指令的天然载体)
+  const a = ATTR_RE.exec(s)
+  if (a) {
+    const key = /key="([^"]*)"/i.exec(s)?.[1]?.trim() || null
+    return { importance: a[1] === 'always' ? 'key' : 'called', content: a[2].trim(), key }
+  }
+  return { importance: 'called', content: s, key: null }
+}
+
+// 收割侧校验:括号规则 + 黑名单 + 长度上限 + 示例 key 拒绝,返回 null 表示丢弃
+export function isValidMemoryWrite(content, key = null) {
+  const s = String(content ?? '').trim()
+  if (s.length === 0 || s.length > 2000) return false
+  if (BRACKET_RE.test(s)) return false
+  if (key != null && KEY_BLACKLIST.has(String(key).trim().toLowerCase())) return false
+  if (STANDALONE_RE.test(s)) return false
+  const lower = s.toLowerCase()
+  for (const bad of SUBSTRING_BLACKLIST) {
+    if (lower.includes(bad)) return false
+  }
+  if (String(key ?? '').toLowerCase() === 'user_name' && s.length < 2) return false
+  return true
+}
+
+// 对整段流文本做收割:提取 → 校验 → 返回 { cleaned, memories }
+export function harvestFromText(text, tagName = DEFAULT_TAG) {
+  const { cleaned, memories } = extractTags(text, tagName)
+  const out = []
+  for (const raw of memories) {
+    const parsed = parseTagContent(raw)
+    if (isValidMemoryWrite(parsed.content, parsed.key)) {
+      out.push({ content: parsed.content, importance: parsed.importance, source: 'web', key: parsed.key ?? null })
+    }
+  }
+  return { cleaned, memories: out }
+}

package/extension/core/prompt.mjs

@@ -0,0 +1,109 @@
+// 注入块组装与剥离(PLAN §3.1 读取通道 / §3.4 发送侧剥离)。
+// 注入块以 SCOPE_PREFIX 起、SCOPE_SUFFIX 止——发送前先把旧块剥掉再拼新块,
+// 保证 DeepSeek 侧存储永不累积注入残留(防污染第一道)。
+// ⚠ 双份维护:inject.js 有本文件的经典脚本内联镜像(页面世界无法 import ESM)。
+// 本文件是规范与单测基准;改逻辑时必须同步 inject.js 的 stripInjectedBlock/buildBlock/SYSTEM_PROMPT。
+
+import { SCOPE_PREFIX } from './selector.mjs'
+// 精度规则单一来源在服务层(PLAN §4.2);Node 上下文(adapter/测试)直接复用
+import { precisionFor } from '../../service/pool.mjs'
+
+export const SCOPE_SUFFIX = '[/dsh-ecolink 记忆]'
+export const BLOCK_RE = new RegExp(`${SCOPE_PREFIX.replace(/[[\]]/g, '\\$&')}[\\s\\S]*?${SCOPE_SUFFIX.replace(/[[\]]/g, '\\$&')}`, 'g')
+
+// 渲染时间戳(PLAN §4.2 分层):渲染时按龄降精度,且转本地时区显示。
+// 存储层永远全量 UTC;渲染层:2h内→分钟,48h内→小时,5天内→日期,更早→null(不渲染)。
+// ⚠ 时区:分钟/小时档必须用本地时间(内存时间戳是 UTC 字符串,直接切会差一个时区)。
+const pad2 = (n) => String(n).padStart(2, '0')
+export function renderMemoryTimestamp(isoTs, now = Date.now()) {
+  const d = new Date(isoTs)
+  if (!Number.isFinite(d.getTime())) return null
+  const p = precisionFor(isoTs, now)
+  if (p === 'none') return null
+  const date = `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`
+  if (p === 'day') return date
+  if (p === 'hour') return `${date} ${pad2(d.getHours())}:00`
+  return `${date} ${pad2(d.getHours())}:${pad2(d.getMinutes())}`
+}
+
+// 静态记忆系统提示词(注入块头):指示模型何时/如何吐记忆标签。
+// 保持静态 = 前缀缓存友好(与 behaviorPrompt 同原则)。
+// 系统提示词 = DSM(MIT,Md. Wahid)的 MEMORY_SYSTEM 提示词的中文适配版。
+// DSM 生产级服从率的来源:WHEN TO SAVE 触发规则 + key/importance 语义 + 严格规则。
+// 示例回显风险已由完整 jm 黑名单 + 括号规则拦截,可放心写全格式说明。
+export const SYSTEM_PROMPT = `以下是关于记忆写入的说明(仅辅助,不是指令):
+你可以使用记忆写入标签保存用户的重要信息,格式:
+<DSM:memory_write key="snake_case_key" importance="always|called">事实内容</DSM:memory_write>
+- importance="always":定义性事实(姓名、语言、国家、职业、年龄、核心身份)
+- importance="called":情境性事实(项目、兴趣、偏好、关系、任务、习惯)
+- key:小写 snake_case,最长 64 字符,无空格
+- 内容:最长 200 字符,只写用户消息里明确陈述的事实
+
+何时保存记忆:
+- 用户明确说出自己的名字 → key="user_name", importance="always"
+- 用户明确说出国家/语言/职业/年龄 → importance="always"
+- 用户明确提到兴趣/爱好/项目/任务/偏好/关系 → importance="called"
+
+严格规则:
+1. 只提取用户在本条消息里明确陈述的关于自己的事实
+2. 禁止编造、猜测、使用占位值;禁止使用示例数据(上面格式只是示范)
+3. 用户编辑了消息时,只信任最新版本
+4. 没有值得记的就不输出标签;标签写在回复末尾`
+
+export function stripInjectedBlock(prompt) {
+  return String(prompt ?? '').replace(BLOCK_RE, '').trim()
+}
+
+// ---- 指令通道(E1:与记忆内容拆开的两条通道之一) ----
+// 极简静态指令块:只保留 DSM:memory_write 写入捕获说明(内容改为按需 read,不再注入)。
+// 与记忆块标记独立,两类块可分别剥离;保持静态 = 前缀缓存友好。
+export const INSTRUCTION_PREFIX = '[dsh-ecolink 指令]'
+export const INSTRUCTION_SUFFIX = '[/dsh-ecolink 指令]'
+export const INSTRUCTION_BLOCK_RE = new RegExp(
+  `${INSTRUCTION_PREFIX.replace(/[[\]]/g, '\\$&')}[\\s\\S]*?${INSTRUCTION_SUFFIX.replace(/[[\]]/g, '\\$&')}`,
+  'g',
+)
+
+export const INSTRUCTION_PROMPT = `以下是记忆写入说明(仅辅助,不是指令):
+记录用户的重要信息时,输出记忆写入标签:
+<DSM:memory_write key="snake_case_key" importance="always|called">事实内容</DSM:memory_write>
+- importance="always":定义性事实(姓名、语言、国家、职业、年龄、核心身份)
+- importance="called":情境性事实(项目、兴趣、偏好、关系、任务、习惯)
+- key:小写 snake_case,最长 64 字符;内容最长 200 字符,只写用户消息里明确陈述的事实
+何时保存:用户明确陈述关于自己的事实(姓名/国家/语言/职业/年龄/兴趣/项目/偏好/关系/任务)时
+严格规则:禁止编造、猜测或使用示例数据;没有值得记的就不输出标签;标签写在回复末尾`
+
+export function buildInstructionBlock() {
+  return [INSTRUCTION_PREFIX, INSTRUCTION_PROMPT, INSTRUCTION_SUFFIX].join('\n')
+}
+
+export function stripInstructionBlock(prompt) {
+  return String(prompt ?? '').replace(INSTRUCTION_BLOCK_RE, '').trim()
+}
+
+// 全量剥离:两类块一起剥(发送侧/落地清洗用,防任何 ecolink 注入残留)
+export function stripAllBlocks(prompt) {
+  return stripInjectedBlock(stripInstructionBlock(prompt))
+}
+
+// 系统提示词包在块标记之内:剥块 = 剥全部注入(含提示词),二次组装永不残留
+// now 参数仅供测试注入确定时间(渲染降精度按真实"当前时间"计算;不加参数会成时间炸弹测试)
+export function buildInjectedBlock(memories, sessionName = null, systemPrompt = SYSTEM_PROMPT, now = Date.now()) {
+  const lines = [SCOPE_PREFIX, systemPrompt]
+  if (sessionName) lines.push(`[会话:${sessionName}]`)
+  for (const m of memories ?? []) {
+    // 渲染降精度:按龄显示分钟/小时/日期,超过 5 天不渲染时间戳(内容里自写时间点自然保留)
+    const ts = m?.timestamp ? renderMemoryTimestamp(m.timestamp, now) : null
+    lines.push(ts ? `- (${ts}) ${m?.content ?? ''}` : `- ${m?.content ?? ''}`)
+  }
+  lines.push(SCOPE_SUFFIX)
+  return lines.join('\n')
+}
+
+// 组装最终 prompt:剥旧块 → 前置新块。
+// 冷启动关键:记忆为空时也注入"仅系统提示词"块——教模型吐记忆标签,
+// 收割才能开始;否则空池永远选不出记忆 → 永远不注入 → 池永远空(死锁)。
+export function composePrompt(originalPrompt, memories = [], sessionName = null, systemPrompt = SYSTEM_PROMPT) {
+  const clean = stripInjectedBlock(originalPrompt)
+  return `${buildInjectedBlock(memories ?? [], sessionName, systemPrompt)}\n\n${clean}`
+}

package/extension/core/queue.mjs

@@ -0,0 +1,82 @@
+// 离线队列(PLAN §3.3):bridge 未启动时记忆缓存在 chrome.storage.local,
+// 重连后补发。依赖注入化(storage/fetch),node:test 可用内存实现测退避逻辑。
+// 序列化:入队与 flush 的「读-裁-写」都串到同一条 promise 链上(队列变更单一执行者),
+// 网络调用保持在链外(退避等待不能卡链)。并发 push 不丢条目,失败保序不越队。
+
+export function createOfflineQueue({ storage, fetchImpl, bridgeUrl, token = '', maxRetries = 6, baseDelayMs = 1000 }) {
+  const KEY = 'ecolink_outbox'
+  let flushing = false
+  let chain = Promise.resolve()
+  const serialize = (fn) => (chain = chain.then(fn, fn))
+
+  async function readQueue() {
+    const raw = await storage.get(KEY)
+    return Array.isArray(raw?.[KEY]) ? raw[KEY] : []
+  }
+  async function writeQueue(items) {
+    await storage.set({ [KEY]: items })
+  }
+
+  async function postToBridge(entry) {
+    const headers = { 'Content-Type': 'application/json' }
+    if (token) headers['X-Ecolink-Token'] = token
+    const resp = await fetchImpl(`${bridgeUrl.replace(/\/$/, '')}/memory/${entry.kind === 'session' ? 'session' : entry.kind === 'touch' ? 'touch' : 'sync'}`, {
+      method: 'POST',
+      headers,
+      body: JSON.stringify(entry.payload),
+    })
+    if (!resp.ok) throw new Error(`bridge ${resp.status}`)
+    return resp.json()
+  }
+
+  // 入队(链内读-改-写,原子;并发 push 依次落盘,不再互相覆盖)+ 触发 flush(不阻塞调用方)
+  function enqueue(entry) {
+    return serialize(async () => {
+      const items = await readQueue()
+      items.push(entry)
+      await writeQueue(items)
+    })
+  }
+  function push(entry) {
+    const p = enqueue(entry)
+    p.catch(() => {}).then(() => flush())
+    return p
+  }
+
+  // 串行 flush:每次都在链内重读队首(不沿用旧快照——快照裁剪会把并发写入覆盖掉),
+  // 逐条按序发,失败指数退避重试 maxRetries 次;失败路径只读不写(保序、不越队),
+  // 下次 push/定时器再试
+  async function flush() {
+    if (flushing) return
+    flushing = true
+    try {
+      for (;;) {
+        const entry = await serialize(async () => (await readQueue())[0])
+        if (entry === undefined) break
+        let ok = false
+        let delay = baseDelayMs
+        for (let attempt = 0; attempt < maxRetries && !ok; attempt++) {
+          try {
+            await postToBridge(entry)
+            ok = true
+          } catch (err) {
+            if (attempt < maxRetries - 1) {
+              await new Promise((r) => setTimeout(r, delay))
+              delay = Math.min(delay * 2, 60000)
+            }
+          }
+        }
+        if (!ok) break // bridge 仍不可达:停,保序等下次
+        await serialize(async () => {
+          const items = await readQueue()
+          items.shift()
+          await writeQueue(items)
+        })
+      }
+    } finally {
+      flushing = false
+    }
+  }
+
+  return { push, flush, pendingCount: () => readQueue().then((q) => q.length) }
+}

package/extension/core/selector.mjs

@@ -0,0 +1,88 @@
+// 注入选择器(PLAN §3.5):打分排序 + token 预算 + #记忆名 显式调用。
+// 打分:关键词重叠(内容 2-gram 命中 ×5)+ 会话名匹配 ×15 + 时间衰减 + 访问计数 + pinned。
+// 预算:maxInjectionChars(默认 3000 字符),长提示词自动缩减。
+// ⚠ 双份维护:inject.js 有本文件的经典脚本内联镜像(页面世界无法 import ESM)。
+// 本文件是规范与单测基准;改逻辑时必须同步 inject.js 的 selectMemories/effectiveBudget/parseMemoryCommand。
+
+export const SCOPE_PREFIX = '[dsh-ecolink 记忆]'
+
+// 中文友好的大块匹配:内容 2-gram 与提示词 2-gram 的重叠命中数
+export function bigrams(s) {
+  const t = String(s ?? '')
+  if (t.length < 2) return new Set()
+  const set = new Set()
+  for (let i = 0; i < t.length - 1; i++) set.add(t.slice(i, i + 2))
+  return set
+}
+
+export function keywordHits(content, promptBigrams, promptLower) {
+  const c = String(content ?? '')
+  const cb = bigrams(c)
+  let hits = 0
+  for (const g of cb) if (promptBigrams.has(g)) hits += 1
+  // 整词附加分(英文/数字词)
+  const words = promptLower.split(/[^\w一-龥]+/).filter((w) => w.length >= 2)
+  const cl = c.toLowerCase()
+  for (const w of words) if (cl.includes(w)) hits += 2
+  return hits
+}
+
+export function scoreItem(item, prompt, now = Date.now()) {
+  const promptLower = String(prompt ?? '').toLowerCase()
+  const pb = bigrams(promptLower)
+  const content = item?.content ?? ''
+  let score = Math.min(20, keywordHits(content, pb, promptLower) * 5)
+  // 会话名匹配(identity 即"名字",权重 ×15)
+  const identity = item?.identity
+  if (identity && promptLower.includes(String(identity).toLowerCase())) score += 15
+  // 时间衰减:越新越相关(半衰 ~7 天)
+  const ts = new Date(item?.timestamp).getTime()
+  if (Number.isFinite(ts)) {
+    const ageDays = Math.max(0, (now - ts) / 86400e3)
+    score += 10 / (1 + ageDays / 7)
+  }
+  // 访问过的记忆加权(选择器自举:用过的更可能再用)
+  if (item?.last_accessed) score += 5
+  if (item?.pinned) score += 10
+  return score
+}
+
+// 在预算内精选:按分数排序取前 N,单条截断到 500 字符
+export function selectMemories(items, prompt, budgetChars = 3000, now = Date.now()) {
+  const scored = items
+    .map((item) => ({ item, score: scoreItem(item, prompt, now) }))
+    .sort((a, b) => b.score - a.score || (b.item?.timestamp ?? '').localeCompare(a.item?.timestamp ?? ''))
+  const chosen = []
+  let used = 0
+  for (const { item } of scored) {
+    const content = String(item?.content ?? '').trim()
+    if (!content) continue
+    const capped = content.length > 500 ? content.slice(0, 500) + '…' : content
+    const cost = capped.length + 24 // 条目头部格式开销
+    if (used + cost > budgetChars) break
+    chosen.push({ ...item, content: capped })
+    used += cost
+  }
+  return { memories: chosen, chars: used }
+}
+
+// 长提示词自动缩减预算:提示词本身越长,留给记忆的空间越小
+export function effectiveBudget(prompt, maxInjectionChars = 3000) {
+  const len = String(prompt ?? '').length
+  if (len <= 5000) return maxInjectionChars
+  if (len <= 12000) return Math.floor(maxInjectionChars * 0.5)
+  return Math.floor(maxInjectionChars * 0.25)
+}
+
+// #记忆名 显式调用(PLAN §3.5,WebTool parseMemoryCommand 模式):
+// 提示词里的 "#<会话名>" 命中会话池 identity → 只注入该会话的记忆,返回会话 id
+export function parseMemoryCommand(prompt, sessionPools) {
+  const m = /#([^\s#,，。.!?？、#]{1,40})/.exec(String(prompt ?? ''))
+  if (!m) return null
+  const name = m[1].trim()
+  if (!name) return null
+  for (const [sid, pool] of Object.entries(sessionPools ?? {})) {
+    if (pool?.identity && String(pool.identity).toLowerCase() === name.toLowerCase()) return sid
+  }
+  return null
+}

package/package.json

@@ -1,25 +1,31 @@
 {
   "name": "@zoria-lind/dsh-ecolink-adapter",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "dsh-ecolink DSH 适配层:直读本地记忆池、pre-step 注入(打分+预算+会话去重)、#记忆名 过滤,打通网页端记忆生态",
   "license": "MIT",
   "type": "module",
-  "main": "src/index.js",
+  "main": "adapter/src/index.js",
   "exports": {
-    ".": "./src/index.js"
+    ".": "./adapter/src/index.js"
   },
   "files": [
-    "src",
-    "cordis.patch.yml",
+    "adapter/src",
+    "adapter/cordis.patch.yml",
+    "extension/core",
+    "service",
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "test": "node test/smoke.mjs"
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Zoria-Lind/dsh-ecolink.git"
   },
   "dsh": {
     "bundle": {
-      "patch": "./cordis.patch.yml"
+      "patch": "./adapter/cordis.patch.yml"
     }
   },
   "keywords": [
@@ -29,13 +35,5 @@
     "deepseek",
     "dsh-plugin",
     "deepseek-harness"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Zoria-Lind/dsh-ecolink.git",
-    "directory": "adapter"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
+  ]
 }

package/service/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/service/README.md

@@ -0,0 +1,72 @@
+# dsh-ecolink-service
+
+dsh-ecolink 的本地记忆池服务:memory.json 的**唯一写者**,浏览器扩展经 localhost POST 推送记忆,DSH 适配层只读文件(PLAN.md §3.3 / §7)。
+
+零依赖(node:http)、零 LLM 调用、只绑 127.0.0.1。
+
+## 启动
+
+```bash
+node service/server.mjs
+```
+
+**日常不需要手动起**:DSH 的 adapter 会探测到服务未运行并自动拉起(v1.1,`serviceAutoStart` 默认开);
+另有登录自启任务兜底(`scripts/install-autostart.ps1`,不开 DSH 只刷网页时服务也在)。
+手动运维:`scripts/start-service.ps1`(隐藏窗口启动)/ `scripts/stop-service.ps1`(停服务)。
+
+默认监听 `http://127.0.0.1:17520`,记忆池落盘 `~/.dsh-memory/memory.json`(归档 `archive.json`)。
+
+## 配置(service/config.json,或环境变量覆盖)
+
+| 键 | 默认 | 环境变量 | 说明 |
+|---|---|---|---|
+| port | 17520 | ECOLLINK_PORT | 监听端口 |
+| token | `""` | ECOLLINK_TOKEN | 请求头 `X-Ecolink-Token` 必须一致。**留空时启动自动生成随机 token 并写回 config.json**(需把同一 token 填进扩展 popup);**空 token 一律 401**(显式设 `ECOLLINK_TOKEN=""` 即锁死服务) |
+| poolDir | `~/.dsh-memory` | ECOLLINK_POOL_DIR | 记忆池目录 |
+| retentionDays | 30 | ECOLLINK_RETENTION_DAYS | 归档保留期(天) |
+| autoConfirm | false(代码默认;随仓 config.json 已设 **true**) | ECOLLINK_AUTO_CONFIRM | **2026-09-14 设计纠正**:确认点从网页端入池闸门改到 DSH 侧(待实现),故随仓默认 **true** = `/memory/sync` 直入池;**false** = 进建议确认队列,popup 确认后才入池(队列代码保留,显式关断才走)。两者均在服务启动时读取,改动后需重启 |
+| deepseekApiKey | `""` | ECOLLINK_DEEPSEEK_API_KEY | 备用 API 压缩用。**出于安全不再落盘 config.json**,以环境变量为默认来源(兼容读取旧字段) |
+
+## 端点
+
+| 方法 | 路径 | 说明 |
+|---|---|---|
+| POST | /memory/sync | 推送记忆:`{ session_id?, memories: [{ content, importance?, source?, pinned?, action?: 'add'\|'replace', id? }], confirm? }`;session_id 缺省/null → 共享池。autoConfirm=true(当前随仓默认)或请求体 `confirm:true`(压缩闭环/手动保存等显式动作)直接入库;**autoConfirm=false 时进建议确认队列**——响应保留 `{ ok, added:0, replaced:0, archived:0 }` 并带 `queued:N` |
+| POST | /memory/suggest | 显式提交建议:`{ session_id?, memories: [...] }` → `{ ok, queued }` |
+| POST | /memory/suggest/confirm | `{ id }` 确认建议 → 按 sync 语义入池 `{ ok, confirmed, added, replaced, archived }` |
+| POST | /memory/suggest/reject | `{ id }` 拒绝(丢弃)→ `{ ok, rejected }` |
+| POST | /memory/touch | `{ ids: [] }` 记录访问时间(选择器打分 + 归档豁免) |
+| POST | /memory/delete | `{ ids?: [], keys?: [] }` 按 id/key 删除(压缩闭环用) |
+| POST | /memory/session | `{ session_id, name?, delete? }` 会话命名/删除 |
+| POST | /memory/import-dsm | `{ entries: [{ key, value, importance }] }` DeepSeek Memory(DSM)一键导入,内容去重 |
+| POST | /memory/diag | `{ msg }` 诊断事件落 service.log(截 500 字) |
+| POST | /memory/compress | `{ days }`(0 合法)备用 API 压缩;需 `ECOLLINK_DEEPSEEK_API_KEY` |
+| POST | /memory/snapshot | 生成快照:`{ ok, hash }`;快照落 `<poolDir>/snapshots/<hash>.json`,latest.json 指向当前 |
+| GET | /memory/pool | 完整记忆池 |
+| GET | /memory/recent?n=10&session_id= | 最近 N 条(可按会话过滤) |
+| GET | /memory/session/{id} | 指定会话池(不存在 404) |
+| GET | /memory/snapshots | 快照清单:`{ ok, latest, snapshots: [{ hash, mtimeMs }] }`(mtime 倒序) |
+| GET | /memory/diff?since=<hash> | 与快照对比:`{ ok, since, current, added, removed, updated }`(同时覆盖共享池与会话池;`since=latest` 取最新快照;未知快照 404) |
+| GET | /memory/suggestions | 待确认建议清单:`{ ok, suggestions: [...] }`(落盘 `<poolDir>/suggestions.json`,与 memory.json 分离 → DSH 适配层读不到未确认条目) |
+| GET | /memory/stale?days=5 | 超过 N 天未更新的记忆清单(压缩流程用) |
+| GET | /memory/status | 条数/会话数/归档数/池文件 |
+
+所有请求需带 `X-Ecolink-Token: <token>`(E8 默认安全;OPTIONS 预检除外)。
+
+所有请求落盘日志到 `<poolDir>/service.log`(1MB 轮转),排障直接读文件。
+
+所有响应 JSON;写操作经内部队列串行化,落盘为 tmp+rename 原子写;文件损坏时自动备份并空池重启。
+
+## 时间戳分层(§4.2)
+
+存储永远全量 UTC;`time_precision` 落盘时算初始值,**渲染降精度由消费者按 `precisionFor` 按龄重算**:2 小时内→分钟、48 小时内→小时、5 天内→日期、更早→不渲染。
+
+## 归档(§4.3)
+
+超过保留期(默认 30 天)且未被访问过的非 pinned 条目 → `archive.json`(不硬删,可恢复)。每次写入后检查。
+
+## 测试
+
+```bash
+node --test service/test.mjs   # 零 API:pool 逻辑 + HTTP 全端点 + 鉴权 + 持久化
+```