@zoria-lind/dsh-ecolink-adapter 0.3.0 → 1.0.0

package/README.md

@@ -1,6 +1,12 @@
 # dsh-ecolink-adapter
 
-v0.3.0 起提供指定全文读取、记忆侧栏与通用/非通用分类、网页完整成果保存。仅对 DSH `0.2.1-rc.2` 的公开宿主接口做过验证，`dsh.compatibility` 也只声明该版本。发布包需由仓库根目录的 `scripts/build-npm-pkgs.mjs` 生成镜像布局，不能直接把 adapter 子目录当作完整包。
+v1.0.0 起提供指定全文读取、记忆侧栏与通用/非通用分类、网页完整成果保存，并配套可选的桌面宿主补丁（同窗 DeepSeek 网页、划选入池、缩放、带入草稿）。核心接口自 1.0.0 起冻结：新增功能走 1.x，破坏性改动走 2.0.0；桌面宿主补丁是实验性本地补丁，不属于 npm 契约。仅在 DSH `0.2.2-rc.1` 实测，`engines.dsh` 与 `dsh.compatibility` 都只声明该版本。发布包需由仓库根目录的 `scripts/build-npm-pkgs.mjs` 生成镜像布局，不能直接把 adapter 子目录当作完整包。
+
+## 安装与包关系
+
+- DSH 用户只装 `@zoria-lind/dsh-ecolink-adapter` 即可；npm 包里自带 `service/`，适配层会自动拉起本地服务，不需要再装 `@zoria-lind/dsh-ecolink-service`。
+- `@zoria-lind/dsh-ecolink-service` 是可选独立形态：不装 DSH、只用浏览器扩展，或需要登录自启时单独安装。
+- 浏览器扩展不是 DSH 内置网页的前置条件；只有普通浏览器、网页端自动注入或 popup 功能才需要它。
 
 ## 指定读取
 
@@ -30,6 +36,10 @@ v0.3.0 起提供指定全文读取、记忆侧栏与通用/非通用分类、网
 
 保存保留空白、Markdown、代码和标签字面量，正文上限1.5MB；目录摘要和自动短记忆独立。完整成果默认非通用且不参与自动短记忆筛选或压缩。同名保存须确认并校验旧版本；服务保留历史全文，当前面板读取最新版本，暂未提供旧版本浏览界面。断网/失败不会报成功或清空编辑框；同一内容重试采用相同请求 ID 防重复。关闭页面前未保存的编辑内容需要自行保留。
 
+## 桌面宿主补丁
+
+同窗 DeepSeek 网页、页内划选入池、缩放与“带入草稿”由仓库 `desktop/` 提供：需要管理员替换桌面安装的 `app.asar`，基线 DSH `0.2.2-rc.1`，实验性，DSH 升级后需重建。它不属于 npm 包和 1.0.0 稳定契约，详见 [desktop/README.md](../desktop/README.md)。
+
 ## 验收
 
 所有命令必须在隔离 HOME、临时目录和虚构池下运行，不能用真实记忆测试：

package/adapter/README.md

@@ -1,6 +1,12 @@
 # dsh-ecolink-adapter
 
-v0.3.0 起提供指定全文读取、记忆侧栏与通用/非通用分类、网页完整成果保存。仅对 DSH `0.2.1-rc.2` 的公开宿主接口做过验证，`dsh.compatibility` 也只声明该版本。发布包需由仓库根目录的 `scripts/build-npm-pkgs.mjs` 生成镜像布局，不能直接把 adapter 子目录当作完整包。
+v1.0.0 起提供指定全文读取、记忆侧栏与通用/非通用分类、网页完整成果保存，并配套可选的桌面宿主补丁（同窗 DeepSeek 网页、划选入池、缩放、带入草稿）。核心接口自 1.0.0 起冻结：新增功能走 1.x，破坏性改动走 2.0.0；桌面宿主补丁是实验性本地补丁，不属于 npm 契约。仅在 DSH `0.2.2-rc.1` 实测，`engines.dsh` 与 `dsh.compatibility` 都只声明该版本。发布包需由仓库根目录的 `scripts/build-npm-pkgs.mjs` 生成镜像布局，不能直接把 adapter 子目录当作完整包。
+
+## 安装与包关系
+
+- DSH 用户只装 `@zoria-lind/dsh-ecolink-adapter` 即可；npm 包里自带 `service/`，适配层会自动拉起本地服务，不需要再装 `@zoria-lind/dsh-ecolink-service`。
+- `@zoria-lind/dsh-ecolink-service` 是可选独立形态：不装 DSH、只用浏览器扩展，或需要登录自启时单独安装。
+- 浏览器扩展不是 DSH 内置网页的前置条件；只有普通浏览器、网页端自动注入或 popup 功能才需要它。
 
 ## 指定读取
 
@@ -30,6 +36,10 @@ v0.3.0 起提供指定全文读取、记忆侧栏与通用/非通用分类、网
 
 保存保留空白、Markdown、代码和标签字面量，正文上限1.5MB；目录摘要和自动短记忆独立。完整成果默认非通用且不参与自动短记忆筛选或压缩。同名保存须确认并校验旧版本；服务保留历史全文，当前面板读取最新版本，暂未提供旧版本浏览界面。断网/失败不会报成功或清空编辑框；同一内容重试采用相同请求 ID 防重复。关闭页面前未保存的编辑内容需要自行保留。
 
+## 桌面宿主补丁
+
+同窗 DeepSeek 网页、页内划选入池、缩放与“带入草稿”由仓库 `desktop/` 提供：需要管理员替换桌面安装的 `app.asar`，基线 DSH `0.2.2-rc.1`，实验性，DSH 升级后需重建。它不属于 npm 包和 1.0.0 稳定契约，详见 [desktop/README.md](../desktop/README.md)。
+
 ## 验收
 
 所有命令必须在隔离 HOME、临时目录和虚构池下运行，不能用真实记忆测试：

package/adapter/src/client.js

@@ -2,6 +2,49 @@ window.__ModuleLoader__.load({id:'@zoria-lind/dsh-ecolink-adapter',factory:requi
   const React=require('react'), h=React.createElement
   const KIND='ecolink-memory', PAGE=1500
   const control={color:'inherit',background:'var(--dsw-alias-bg-layer-2, transparent)',border:'1px solid var(--dsw-alias-border-l2, #8886)',borderRadius:6,padding:'5px 8px'}
+  const HEADER_BUTTON_CSS = `
+    .ecolink-header-button {
+      display: inline-flex;
+      flex: none;
+      align-items: center;
+      justify-content: center;
+      height: 28px;
+      padding: 0 8px;
+      border: 0;
+      border-radius: 6px;
+      background: transparent;
+      color: var(--dsw-alias-label-secondary, inherit);
+      font: inherit;
+      font-size: 12px;
+      white-space: nowrap;
+      cursor: pointer;
+    }
+    .ecolink-header-button:hover,
+    .ecolink-header-button:focus-visible {
+      background: var(--dsw-alias-interactive-bg-hover, #8882);
+      color: var(--dsw-alias-label-primary, inherit);
+    }
+    .ecolink-header-button:focus-visible {
+      outline: 2px solid var(--dsw-alias-brand-primary, currentColor);
+      outline-offset: 2px;
+    }
+    .ecolink-switch {
+      position: fixed;
+      inset: 6px auto auto 152px;
+      z-index: 1800;
+      -webkit-app-region: no-drag;
+      app-region: no-drag;
+    }
+    .ecolink-web-surface {
+      position: fixed;
+      inset: 40px 0 0;
+      z-index: 1799;
+      background: var(--dsw-alias-bg-layer-1, Canvas);
+    }
+    .ecolink-web-surface[hidden] { display: none; }
+    .ecolink-web-guest, .ecolink-web-guest webview { width: 100%; height: 100%; }
+    .ecolink-web-error { position: absolute; top: 8px; left: 20px; }
+  `
   async function api(args,method='GET',signal) {
     const path='api/ecolink'
     const response=await fetch(method==='GET'?`${path}?${new URLSearchParams(args)}`:path,
@@ -12,7 +55,7 @@ window.__ModuleLoader__.load({id:'@zoria-lind/dsh-ecolink-adapter',factory:requi
     const date=new Date(value)
     return value && Number.isFinite(date.getTime())?date.toLocaleString('zh-CN',{hour12:false}):'时间未知'
   }
-  function Panel({sessionId}) {
+  function Panel({sessionId,inputActions}) {
     const [q,setQ]=React.useState(''),[page,setPage]=React.useState(null),[selected,setSelected]=React.useState(null),
       [read,setRead]=React.useState(null),[state,setState]=React.useState(null),[message,setMessage]=React.useState(''),[busy,setBusy]=React.useState(false),
       [loading,setLoading]=React.useState(false),[offset,setOffset]=React.useState(0),[policy,setPolicy]=React.useState('all')
@@ -66,6 +109,11 @@ window.__ModuleLoader__.load({id:'@zoria-lind/dsh-ecolink-adapter',factory:requi
       }catch(e){if(active.current===target)setMessage(e.message)}finally{if(active.current===target)setBusy(false)}
     }
     const button=(text,onClick,disabled=false)=>h('button',{type:'button',onClick,disabled:busy||disabled,style:{...control,margin:'3px'}},text)
+    const insertDraft=()=>{
+      if(!read?.complete||active.current!==selected?.sessionId||!inputActions?.captureInsertion)return
+      const ok=inputActions.insertText(read.content,inputActions.captureInsertion())
+      setMessage(ok?'已带入当前对话草稿。':'当前草稿暂时无法编辑，请稍后重试。')
+    }
     const refresh=()=>{clearPreview();setMessage('');list()}
     const filter=value=>{setPolicy(value);clearPreview();setMessage('');setPage(null);list(0,undefined,value)}
     const detail=()=>h('section',{'aria-label':'记忆完整正文','aria-busy':busy,style:{padding:'8px 0'}},
@@ -76,6 +124,7 @@ window.__ModuleLoader__.load({id:'@zoria-lind/dsh-ecolink-adapter',factory:requi
       ...(state?.items??[]).filter(i=>i.ref===selected?.ref&&i.version===selected?.version).map(i=>h('p',{key:i.token,role:'status'},i.status==='admitted'?'这条记忆已进入当前对话上下文':`这条记忆已排队${i.partial?'（所选分段）':''}，下次发送时注入当前对话`)),
       read?.complete&&h('div',null,
         button('注入全文',()=>mutate('inject'),!sessionId),
+        window.dshDesktop?.browser?.acquireEcolink&&inputActions?.insertText&&button('带入草稿',insertDraft,!sessionId),
         button(selected.injectionPolicy==='universal'?'改为非通用':'改为通用',()=>mutate('policy')),
         read.totalChars>PAGE&&h('details',null,h('summary',null,'长文分段注入'),
           h('p',null,`当前段 ${offset+1}–${Math.min(offset+PAGE,read.totalChars)} / ${read.totalChars} 字`),
@@ -102,10 +151,70 @@ window.__ModuleLoader__.load({id:'@zoria-lind/dsh-ecolink-adapter',factory:requi
       state&&h('div',null,state.notice,state.omitted>0&&h('p',null,`开局超预算未注入 ${state.omitted} 条`),
         ...state.items.map(i=>h('div',{key:i.token},`${i.status==='admitted'?'已进入上下文':'待注入'}${i.partial?'（部分正文）':''} · ${i.ref}`))))
   }
+  function DeepSeekSwitch() {
+    const bridge=window.dshDesktop?.browser
+    const [shown,setShown]=React.useState(false),[started,setStarted]=React.useState(false)
+    const [error,setError]=React.useState('')
+    const host=React.useRef(null)
+    React.useEffect(()=>{
+      if(!started||!bridge?.acquireEcolink)return
+      let disposed=false,lease,guest
+      const target=host.current
+      const failure=()=>{if(!disposed)setError('DeepSeek 网页加载失败。可切回 Harness 后重新打开应用再试。')}
+      async function mount(){
+        const reservation=await bridge.acquireEcolink()
+        lease=reservation.lease
+        if(disposed){await bridge.release(lease);return}
+        guest=document.createElement('webview')
+        guest.dataset.sidebarBrowserFrame='webview'
+        guest.setAttribute('aria-label','DeepSeek 网页')
+        guest.setAttribute('name',lease)
+        guest.setAttribute('partition',reservation.partition)
+        guest.setAttribute('src','about:blank#'+lease)
+        guest.addEventListener('dom-ready',()=>{
+          if(!disposed)guest.loadURL('https://chat.deepseek.com/').catch(failure)
+        },{once:true})
+        guest.addEventListener('did-fail-load',event=>{
+          if(event.isMainFrame&&event.errorCode!==-3)failure()
+        })
+        guest.addEventListener('did-finish-load',()=>{
+          if(!disposed)setError('')
+        })
+        target.append(guest)
+      }
+      mount().catch(failure)
+      return ()=>{
+        disposed=true
+        guest?.remove()
+        if(lease)bridge.release(lease).catch(()=>{})
+      }
+    },[started,bridge])
+    if(!bridge?.acquireEcolink)return null
+    const toggle=()=>{
+      if(!started)setStarted(true)
+      setShown(!shown)
+    }
+    return h(React.Fragment,null,
+      h('button',{type:'button',className:'ecolink-header-button ecolink-switch','aria-pressed':shown,
+        title:shown?'返回当前 Harness 对话':'在当前窗口打开 DeepSeek 网页',onClick:toggle},
+        shown?'返回 Harness':'DeepSeek 网页'),
+      started&&h('section',{className:'ecolink-web-surface',hidden:!shown,'aria-label':'内嵌 DeepSeek 网页'},
+        h('div',{ref:host,className:'ecolink-web-guest'}),
+        error&&h('p',{className:'ecolink-web-error',role:'alert'},error)))
+  }
   function OpenMemory({openMemory}) {
-    return h('button',{type:'button',onClick:openMemory,title:'浏览完整记忆并注入当前对话','aria-label':'打开记忆池',style:control},'记忆池')
+    return h('button',{type:'button',onClick:openMemory,title:'浏览完整记忆并注入当前对话','aria-label':'打开记忆池',className:'ecolink-header-button'},'记忆池')
   }
   return {inject:['slots','sidebarRightTabs','sidebarRight'],apply(ctx){
+    ctx.effect(()=>{
+      const style=document.createElement('style')
+      style.textContent=HEADER_BUTTON_CSS
+      document.head.appendChild(style)
+      return ()=>style.remove()
+    })
+    if(window.dshDesktop?.browser?.acquireEcolink)ctx.effect(()=>ctx.slots.inject('shell.overlay',()=>ctx.slots.register({
+      name:'shell.overlay',id:'ecolink-deepseek-switch'
+    },DeepSeekSwitch)))
     ctx.effect(()=>ctx.sidebarRightTabs.register({id:KIND,kind:KIND,title:()=> '记忆池',
       guide:[{id:'ecolink',order:50,title:()=> '记忆池',description:()=> '浏览完整正文并注入当前对话'}]}))
     ctx.effect(()=>ctx.slots.inject('sidebar.right.pane.tab',()=>ctx.slots.register({name:'sidebar.right.pane.tab',key:KIND},Panel)))

package/adapter/src/modules/memoryReader.js

@@ -37,7 +37,13 @@ function integer(value, fallback, max) {
 }
 export function createMemoryReader(config, deps={}) {
   const readFile=deps.readFile ?? (p=>readFileSync(p,'utf8'))
-  const entries=()=>flattenPool(JSON.parse(readFile(expandHome(config.poolPath))))
+  function entries() {
+    try { return flattenPool(JSON.parse(readFile(expandHome(config.poolPath)))) }
+    catch (error) {
+      if (error?.code === 'ENOENT') return []
+      throw error
+    }
+  }
   function select(args={}) {
     let all=entries()
     if (args.pool) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zoria-lind/dsh-ecolink-adapter",
-  "version": "0.3.0",
+  "version": "1.0.0",
   "description": "DSH 跨端记忆：指定全文读取、侧栏浏览与注入、通用/非通用分类",
   "license": "MIT",
   "type": "module",
@@ -24,7 +24,8 @@
     "!service/fix-pool.mjs"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=18.0.0",
+    "dsh": "0.2.2-rc.1"
   },
   "repository": {
     "type": "git",
@@ -35,9 +36,9 @@
       "patch": "./adapter/cordis.patch.yml"
     },
     "compatibility": {
-      "dsh": "0.2.1-rc.2",
+      "dsh": "0.2.2-rc.1",
       "dshReleases": {
-        "0.2.1-rc.2": "compatible"
+        "0.2.2-rc.1": "compatible"
       }
     },
     "client": {

package/service/README.md

@@ -1,4 +1,4 @@
-> **v0.3.0（2026-10-29）**：新增 `/memory/artifact` 完整成果存储（独立于短记忆，保留历史修订）、池条目的类型与时间排序、跨池分页读取。规则与限制见 [adapter/README.md](../adapter/README.md)。
+> **v1.0.0（2026-11-06）**：本版 service 无功能变化；1.0.0 的核心是把 adapter、扩展与桌面补丁的接口冻结。`/memory/artifact`（完整成果、历史修订）、池条目类型/时间排序、跨池分页读取沿用 0.3.0。规则与限制见 [adapter/README.md](../adapter/README.md)。
 
 # dsh-ecolink-service
 

package/service/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zoria-lind/dsh-ecolink-service",
-  "version": "0.3.0",
+  "version": "1.0.0",
   "description": "dsh-ecolink 本地记忆服务:网页扩展与 DSH 共享记忆池的唯一写者(零依赖、127.0.0.1、token 鉴权)",
   "license": "MIT",
   "type": "module",