@a9i5k4/dsh-auto-memory 0.1.31 → 0.1.33

package/README.md

@@ -48,7 +48,7 @@
 </details>
 
 <p align="center">
-  <a href="README.md">中文</a> · <b>English</b> · License BSD-3-Clause · <code>pnpm add @a9i5k4/dsh-auto-memory</code>
+  <a href="README.zh-CN.md">中文</a> · <b>English</b> · License BSD-3-Clause · <code>pnpm add @a9i5k4/dsh-auto-memory</code>
 </p>
 
 > **v0.1.30 MAJOR UPDATE** — A brand-new Welcome Tour: every feature introduced step by step with per-feature switches; an Office/Fluent-style liquid-glass app icon family; a changelog intro animation; and an unattended mode built for long batch jobs.

package/lib/client.js

@@ -491,6 +491,7 @@ window.__ModuleLoader__.load({
         '修复:记忆面板默认位置不再遮挡侧边栏「记忆」入口按钮——改为锚定按钮正上方,重叠时自动让出;支持点击面板外部或按 Esc 关闭。感谢 @ProperSAMA(PR #12)。',
         '修复:更新弹窗在小卡形态下内容被裁剪、底部按钮不可达导致无法关闭——新增右上 ✕ 关闭(同步已读版本),内容区自动滚动。',
         '改进:「唤起回顾」决策↔投递时间线——每条决策标注真实投递结果(✓投递×N/未投递/技能✓),判定队列汇总与政策提示;记忆固化(stale 门降版本容忍,语料升版不再整单压制召回)。',
+        '补丁 0.1.31:发布物运行时 section 名 dsh:m6-reference-tail → 裸名(发布身份统一,不再带预览标识)。',
       ], en: [
         '★ MAJOR: Brand-new Welcome Tour — after first launch or upgrade, every feature is introduced step by step with per-feature switches right in the tour (association / snapshot / greeting / night unattended / reflection / summaries / external memory / skill promotion…); engine detection, download, self-test and live external-source scanning are all inline.',
         '★ New brand visuals: an Office/Fluent-style liquid-glass app icon family — each step gets its own colored glass squircle icon (cyan inject / amber greeting / green calendar / violet engine / sky radar / coral finish) with dedicated looping motion (bell sway, page flip, linked rings, prism spin, radar sweep, rising spark); the signature three-slab frosted-glass logo stays on the Core step.',
@@ -500,6 +501,7 @@ window.__ModuleLoader__.load({
         'Fix: The panel no longer covers the sidebar "Memory" entry button — default position anchors above it, overlapping geometry auto-yields, and outside-click/Esc close is supported. Thanks @ProperSAMA (PR #12).',
         'Fix: The update dialog could become impossible to close when its content overflowed the compact card — added an ✕ in the top-right (marks version seen) and made the content area scrollable.',
         'Improved: Recall-review decision↔delivery timeline (delivered×N / not delivered / skill badges per decision), review-queue digest with policy hints, and consolidation stale-gate version tolerance so corpus version bumps no longer suppress recall.',
+        'Patch 0.1.31: release runtime section name dsh:m6-reference-tail → bare name (unified release identity, no preview marker).',
       ] },
       '0.1.29': { zh: [
         '修复:工作区总览一直显示「未发现带记忆的工作区」——DSH 新版会话持久化改为 session.jsonl.zstd 压缩帧,旧逻辑只认 .jsonl 扫描不到任何会话;现已用 zstd 解压读取首行提取 cwd,并让空的 summary 缓存短时失效,避免空结果被永久固化。',
@@ -977,6 +979,11 @@ window.__ModuleLoader__.load({
       '@keyframes dam-tour-swap { from { opacity: 0; transform: translateX(22px); } to { opacity: 1; transform: none; } }',
       '[data-dam-tour-dl] { margin: 8px auto 0; max-width: 420px; text-align: left; font-size: 12px; }',
       '[data-dam-tour-dl-row] { display: flex; justify-content: space-between; gap: 10px; opacity: .75; font-size: 10.5px; margin-bottom: 3px; }',
+      '[data-dam-tour-dl-tier] { margin-top: 8px; border: 1px solid rgba(128,128,128,.22); border-radius: 9px; overflow: hidden; }',
+      '[data-dam-tour-dl-tier-row] { display: flex; justify-content: space-between; align-items: baseline; gap: 10px; padding: 7px 10px; font-size: 11px; }',
+      '[data-dam-tour-dl-tier-row:first-child] { border-bottom: 1px solid rgba(128,128,128,.14); background: rgba(47,164,106,.08); }',
+      '[data-dam-tour-dl-tier-row] b { font-weight: 700; white-space: nowrap; }',
+      '[data-dam-tour-dl-tier-row] span { opacity: .7; font-size: 10.5px; text-align: right; }',
       '[data-dam-tour-bar] { height: 7px; border-radius: 99px; background: rgba(128,128,128,.18); overflow: hidden; }',
       '[data-dam-tour-bar-i] { height: 100%; border-radius: 99px; background: linear-gradient(90deg, var(--dam-accent, #2456c4), #7ea4ff); transition: width .4s ease; }',
       '[data-dam-tour-dots] { display: flex; gap: 7px; justify-content: center; margin: 18px 0 4px; z-index: 2; position: relative; }',
@@ -2518,10 +2525,20 @@ window.__ModuleLoader__.load({
         // 每次向导变为可见时回到第一步,并拉一份当前配置快照(开关步读写用)
         if (tourShowing) {
           setTourStep(0)
+          wizSt.tourCfg = null
+          wizSt.cfgLoaded = false
           fetch('/api/dsh-auto-memory/config').then(function (r) { return r.json() }).then(function (j) {
             wizSt.tourCfg = (j && (j.config || j)) || {}
+            // mode 型开关(唤起注入模式)实际存储在 embedding-config.json(semantic-emit 接口维护),
+            // 需从 semantic-status 合并进来,导览开关才能显示真实当前值并与设置页联动。
+            try {
+              fetch('/api/dsh-auto-memory/semantic-status').then(function (r2) { return r2.json() }).then(function (j2) {
+                if (j2 && j2.activationEmitMode !== undefined) { wizSt.tourCfg.activationEmitMode = j2.activationEmitMode; try { dlgTick() } catch (e13) {} }
+              }).catch(function () {})
+            } catch (_) {}
+            wizSt.cfgLoaded = true
             try { dlgTick() } catch (e11) {}
-          }).catch(function () { wizSt.tourCfg = wizSt.tourCfg || {} })
+          }).catch(function () { wizSt.tourCfg = wizSt.tourCfg || {}; wizSt.cfgLoaded = true })
           fetch('/api/dsh-auto-memory/external').then(function (r) { return r.json() }).then(function (j) {
             wizSt.extScan = j
             try { dlgTick() } catch (e12) {}
@@ -2530,14 +2547,25 @@ window.__ModuleLoader__.load({
       }, [tourShowing])
       useEffect(function () {
         if (!tourShowing) return undefined
-        if (tourDlPhase !== 'downloading' && tourDlPhase !== 'verifying') return undefined
+        if (wizSt.ready) return undefined // 已就绪无需轮询
         var iv = setInterval(function () {
           fetch('/api/dsh-auto-memory/semantic-status').then(function (r) { return r.json() }).then(function (j) {
             Object.assign(wizSt, j); try { dlgTick() } catch (e10) {}
           }).catch(function () {})
         }, 1500)
         return function () { clearInterval(iv) }
-      }, [tourShowing, tourDlPhase])
+      }, [tourShowing, tourDlPhase, wizSt.ready])
+      // 无语义引擎自动引导:进入引擎下载步且引擎未就绪/未下载/未出错时,自动开始下载内置 JS 档(C2 默认)。
+      // 用户可稍后在设置页手动装 Python 进阶档;词法检索 0GB 永远兜底,不阻塞。
+      useEffect(function () {
+        if (!tourShowing) return undefined
+        var curStep = TOUR_STEPS[tourStep]
+        if (!curStep || !curStep.dl) return undefined
+        if (wizSt.ready || wizSt.loaded === false) return undefined
+        var ph = wizSt.download && wizSt.download.phase
+        if (ph === 'downloading' || ph === 'verifying' || ph === 'done' || ph === 'error') return undefined
+        apiPost('/api/dsh-auto-memory/semantic-download', { action: 'start', mirror: 'auto' }).catch(function () {})
+      }, [tourShowing, tourStep, wizSt.ready])
       if (!dialogState) return null
       // 左下角小卡片(记忆按钮上方),高透明毛玻璃,不遮全屏
       var overlay = { position: 'fixed', left: '10px', bottom: '64px', zIndex: 2147483000, width: 'min(360px, calc(100vw - 20px))', maxHeight: 'min(46vh, 430px)', display: 'flex', flexDirection: 'column' }
@@ -2700,7 +2728,9 @@ window.__ModuleLoader__.load({
           : dl.phase === 'verifying' ? t('dlVerifying')
           : dl.phase === 'downloading' ? (t('dlDownloading') + ' · ' + fmtMB(dl.bytesDone || 0) + ' / ' + fmtMB(dl.bytesTotal || totalBytes))
           : dl.phase === 'error' ? (t('dlError') + ': ' + String(dl.error || '').slice(0, 90))
-          : dl.phase === 'done' ? t('dlDone')
+          : dl.phase === 'done' ? (wizSt.assetPresent && !wizSt.peerPresent
+              ? (locale === 'zh' ? '模型已下载,推理库缺失——请运行 pnpm add @huggingface/transformers 后重启' : 'Model downloaded, inference lib missing — run pnpm add @huggingface/transformers and restart')
+              : t('dlDone'))
           : (locale === 'zh' ? '未下载 · 词法检索照常可用' : 'Not downloaded · lexical search keeps working')
         var startDl = function () {
           apiPost('/api/dsh-auto-memory/semantic-download', { action: 'start', mirror: 'auto' }).catch(function () {})
@@ -2709,12 +2739,14 @@ window.__ModuleLoader__.load({
         var EXT_SOURCE_KEYS = ['workbuddy-user', 'workbuddy-profile', 'codebuddy-memory', 'claude-global', 'project-conventions', 'workbuddy-sessions', 'claude-sessions', 'codex-sessions']
         var tourToggleOn = function (tg) {
           var c = wizSt.tourCfg || {}
+          if (!wizSt.cfgLoaded) return false // 配置未加载完,一律视为关且禁用,避免误触默认值
           if (tg.key === 'autoSummaryTimes') return (c[tg.key] || []).length > 0
           if (tg.groupAll) { var v = c[tg.key] || {}; return !!v['workbuddy-user'] }
           if (tg.mode) { var m = c[tg.key]; if (m === undefined) return tg.def === true; return m === 'canary-explicit' || m === 'active' }
           return c[tg.key] === undefined ? tg.def !== false : !!c[tg.key]
         }
         var tourToggleClick = function (tg) {
+          if (!wizSt.cfgLoaded) return // 配置未加载完,禁止写入,防止覆盖用户设置
           var c = wizSt.tourCfg = wizSt.tourCfg || {}
           var on = tourToggleOn(tg)
           var patch = {}
@@ -2724,10 +2756,17 @@ window.__ModuleLoader__.load({
           else patch[tg.key] = !on
           Object.assign(c, patch)
           dlgTick()
-          apiPost('/api/dsh-auto-memory/config', patch).catch(function () {})
+          // mode 型开关(唤起注入模式)走 semantic-emit 接口——与设置页同源(embedding-config.json),
+          // 保证导览切换与设置页双向联动;其余开关写常规 config。
+          if (tg.mode) {
+            apiPost('/api/dsh-auto-memory/semantic-emit', { mode: patch[tg.key] }).catch(function () {})
+          } else {
+            apiPost('/api/dsh-auto-memory/config', patch).catch(function () {})
+          }
         }
         // 外部来源单源勾选(扫描行;勾选即写 externalSources 对象)
         var tourExtToggle = function (id) {
+          if (!wizSt.cfgLoaded) return // 配置未加载完,禁止写入
           var c = wizSt.tourCfg = wizSt.tourCfg || {}
           var cur = Object.assign({}, c.externalSources || {})
           cur[id] = (cur[id] !== false) ? false : true
@@ -2746,17 +2785,15 @@ window.__ModuleLoader__.load({
         var finishTour = function () {
           try { localStorage.setItem('dsh-auto-memory.semWizardDone', '1') } catch (e4) {}
           closeDialog()
-          // v0.1.30 大更新链:向导结束 → 接 CHANGELOG。老用户(seen 落后)带出全部未读版本;
-          // 已追平(含新装)给大更新专卡。apiGet 异步拉当前版本,失败静默(向导本身已完成使命)。
+          // v0.1.30 大更新链:向导结束 → 直接接 0.1.30 大更新卡(老用户历史版本不逐个弹,
+          // 大更新内容才是要传达的)。apiGet 异步拉当前版本,失败静默(向导本身已完成使命)。
           try {
             apiGet(API.updateCheck).then(function (d) {
               var cur = (d && d.current) || '0.1.30'
-              var seen = localStorage.getItem('dsh-auto-memory.seenVersion')
-              if (seen && seen !== cur) {
-                var versions = changelogBetween(seen, cur)
-                if (versions.length) { openDialog({ kind: 'update', versions: versions, currentVersion: cur }); return }
-              }
-              openDialog({ kind: 'update', versions: [{ version: cur, items: CHANGELOG[cur] || CHANGELOG['0.1.30'] }], currentVersion: cur })
+              // 只弹大更新(0.1.30);若当前版本更新(补丁)也并入 0.1.30 卡(补丁内容已在 0.1.30 items 尾部)
+              var latestKey = '0.1.30'
+              openDialog({ kind: 'update', versions: [{ version: latestKey, items: CHANGELOG[latestKey] || CHANGELOG['0.1.30'] }], currentVersion: cur })
+              try { localStorage.setItem('dsh-auto-memory.seenVersion', cur) } catch (e5) {}
             }).catch(function () {
               openDialog({ kind: 'update', versions: [{ version: '0.1.30', items: CHANGELOG['0.1.30'] }], currentVersion: '0.1.30' })
             })
@@ -2835,7 +2872,14 @@ window.__ModuleLoader__.load({
                 wizReady ? null : h('div', { 'data-dam-tour-bar': '' },
                   h('div', { 'data-dam-tour-bar-i': '', style: { width: prog + '%', background: dl.phase === 'error' ? 'linear-gradient(90deg,#c44a4a,#e08a8a)' : undefined } })),
                 !wizReady && wizSt.loaded && !dlActive ? h('div', { 'data-dam-tour-dl-row': '', style: { marginTop: '4px' } },
-                  h('span', null, (locale === 'zh' ? '下载源: ' : 'Source: ') + (dl.mirrorUsed === 'cn' ? t('mCn') : dl.mirrorUsed === 'intl' ? t('mIntl') : t('mAuto')) + (locale === 'zh' ? ' · 失败自动切备用源' : ' · auto-failover'))) : null) : null,
+                  h('span', null, (locale === 'zh' ? '下载源: ' : 'Source: ') + (dl.mirrorUsed === 'cn' ? t('mCn') : dl.mirrorUsed === 'intl' ? t('mIntl') : t('mAuto')) + (locale === 'zh' ? ' · 失败自动切备用源' : ' · auto-failover'))) : null,
+                h('div', { 'data-dam-tour-dl-tier': '' },
+                  h('div', { 'data-dam-tour-dl-tier-row': '' },
+                    h('b', null, locale === 'zh' ? '内置 JS 档（自动）' : 'Built-in JS tier (auto)'),
+                    h('span', null, locale === 'zh' ? 'e5-small · ~129MB · 默认,正在为你安装' : 'e5-small · ~129MB · default, installing for you')),
+                  h('div', { 'data-dam-tour-dl-tier-row': '' },
+                    h('b', null, locale === 'zh' ? 'Python 进阶档（可选）' : 'Python tier (optional)'),
+                    h('span', null, locale === 'zh' ? 'BGE-M3 int8 · 563MB · 追求更高精度的发烧友可在设置页安装' : 'BGE-M3 int8 · 563MB · for enthusiasts chasing higher precision — installable in Settings')))) : null,
               step.final ? h('div', null,
                 h('div', { 'data-dam-tour-chips': '' },
                   allToggles.filter(function (tg) { return tourToggleOn(tg) }).map(function (tg) {
@@ -3498,11 +3542,20 @@ window.__ModuleLoader__.load({
             if (!seen && !localStorage.getItem('dsh-auto-memory.firstRunDone')) {
               openDialog({ kind: 'first', currentVersion: d.current })
             } else if (seen && seen !== d.current) {
-              var versions = changelogBetween(seen, d.current)
-              if (versions.length) openDialog({ kind: 'update', versions: versions, currentVersion: d.current })
-              else try { localStorage.setItem('dsh-auto-memory.seenVersion', d.current) } catch (e3) {}
+              // 只弹 0.1.30 大更新卡(补丁并入其尾部),不逐个弹历史版本——大更新内容才是要传达的
+              var bigKey = '0.1.30'
+              if (CHANGELOG[bigKey]) {
+                openDialog({ kind: 'update', versions: [{ version: bigKey, items: CHANGELOG[bigKey] }], currentVersion: d.current })
+                try { localStorage.setItem('dsh-auto-memory.seenVersion', d.current) } catch (e3b) {}
+              } else {
+                var versions = changelogBetween(seen, d.current)
+                if (versions.length) openDialog({ kind: 'update', versions: versions, currentVersion: d.current })
+                else try { localStorage.setItem('dsh-auto-memory.seenVersion', d.current) } catch (e3) {}
+              }
             } else if (!seen && localStorage.getItem('dsh-auto-memory.firstRunDone')) {
+              // 老用户但 seen 缺失(旧版升级/缓存清理):只看当前版本一条,不补历史链,避免把旧 log 塞给用户
               try { localStorage.setItem('dsh-auto-memory.seenVersion', d.current) } catch (e3) {}
+              if (CHANGELOG[d.current]) openDialog({ kind: 'update', versions: [{ version: d.current, items: CHANGELOG[d.current] }], currentVersion: d.current })
             }
           } catch (e) {}
         }

package/lib/semantic-js.js

@@ -282,7 +282,10 @@ export function createSemanticDownloaderPre(opts = {}) {
   function tmpDir() { return path.join(modelsRoot, '.tmp-dl') }
 
   async function fetchToFile(fileRec, base) {
-    const res = await doFetch(base + fileRelUrl(fileRec.rel), { redirect: 'follow' })
+    // 镜像 base 已含模型子目录(Xenova/multilingual-e5-small/resolve/main/),
+    // rel 带 multilingual-e5-small/ 前缀用于落位;URL 拼接时剥掉前缀避免路径重复 404。
+    const urlRel = fileRec.rel.indexOf(E5_MODELS_SUBDIR + '/') === 0 ? fileRec.rel.slice(E5_MODELS_SUBDIR.length + 1) : fileRec.rel
+    const res = await doFetch(base + fileRelUrl(urlRel), { redirect: 'follow' })
     if (!res.ok) throw new Error('http-' + res.status)
     if (!res.body) throw new Error('no-body')
     const total = Number(res.headers.get('content-length')) || fileRec.bytes

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@a9i5k4/dsh-auto-memory",
   "description": "主动联想记忆插件:记忆不靠模型调用,自己被唤回——Host 观察情境,NLP+向量化双轨检索,固定边界注入不破坏前缀缓存。三层记忆自动沉淀、欢迎向导、唤起回顾、无人值守、AI 问候与反思、日历、跨工具记忆继承。Proactive associative memory for DSH: zero-call recall, three-layer auto-consolidation, welcome tour, unattended mode.",
-  "version": "0.1.31",
+  "version": "0.1.33",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -42,5 +42,8 @@
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1"
   },
+  "optionalDependencies": {
+    "@huggingface/transformers": "^3.7.6"
+  },
   "license": "BSD-3-Clause"
 }