@a9i5k4/dsh-auto-memory 0.1.12 → 0.1.14

package/lib/client.js

@@ -7,9 +7,9 @@
  *   3. settings.section      — 自动记忆设置页(存储位置、注入、反思风格)
  * Data flows over /api/dsh-auto-memory/* (loopback-only host routes).
  */
-console.log('[dsh-auto-memory] client v0.1.9 fingerprint: drawer-summary-ok')
+console.log('[dsh-auto-memory] client v0.1.13 fingerprint: drawer-summary-ok')
 window.__ModuleLoader__.load({
-  id: '@deepseek-ai/dsh-auto-memory',
+  id: '@a9i5k4/dsh-auto-memory',
   factory: (require) => {
     var module = { exports: {} }
     var exports = module.exports
@@ -86,6 +86,8 @@ window.__ModuleLoader__.load({
         panelClosing = true; emit()
         closeTimer = setTimeout(function () {
           panelOpen = false; panelClosing = false; closeTimer = null; emit()
+          // 面板关闭时记录本次活动时间:离开>1小时再回来时自动弹开+欢迎语
+          try { localStorage.setItem('dsh-auto-memory.lastActive', String(Date.now())) } catch (e) {}
         }, 170)
       },
       subscribe: function (fn) { listeners.add(fn); return function () { listeners.delete(fn) } },
@@ -113,6 +115,15 @@ window.__ModuleLoader__.load({
         kvAvail: '可用', kvUnavail: '不可用', kvDup: '项目笔记重复标题', kvDupCount: ' 个',
         kvMem: '记忆文件', kvMemUser: '用户', kvMemNotes: '笔记', kvMemLog: '日志', kvMemMissing: '缺失',
         kvWs: '当前工作区', kvWsUnknown: '(未取到)', kvApi: 'API 连通', unknown: '(未知)',
+        guideTitle: '欢迎使用 dsh-auto-memory', guideSub: '这个插件能干什么:',
+        gFeat1: '三层记忆自动注入与检索:用户级 / 项目笔记 / 每日日志,每轮对话自动读、自动写',
+        gFeat2: '每轮对话结束自动沉淀:修了什么 bug、做了哪些决策,自动按主题写进今日日志',
+        gFeat3: 'AI 时段问候与三级抽屉:打开「记忆」面板,AI 按时段向你汇报当天进展',
+        gFeat4: '智能检索与日历:自然语言提问找记忆;AI 自动把 deadline 记进日历并提醒',
+        gFeat5: '接续其他 AI 工具的记忆:CodeBuddy / Claude Code / Codex 等的历史记忆一键接入',
+        gFeat6: '自动检查更新:启动时检测新版本,设置页可一键更新',
+        guideTip: '打开侧边栏「记忆」按钮即可使用;所有记忆都是本地明文文件,可随时查看修改。',
+        updateTitle: 'dsh-auto-memory 已更新', updateSub: '本次更新内容:', gotIt: '知道了',
         refresh: '刷新', refreshing: '刷新中…', close: '关闭', dragMove: '拖动移动', dragResize: '拖动调整大小', resetPos: '恢复默认位置',
         generated: '已生成', failed: '失败: ',
         generatedAt: '生成于 ',
@@ -194,6 +205,15 @@ window.__ModuleLoader__.load({
       kvAvail: 'available', kvUnavail: 'unavailable', kvDup: 'Duplicate note headings', kvDupCount: '',
       kvMem: 'Memory files', kvMemUser: 'user', kvMemNotes: 'notes', kvMemLog: 'log', kvMemMissing: 'missing',
       kvWs: 'Current workspace', kvWsUnknown: '(unknown)', kvApi: 'API probes', unknown: '(unknown)',
+      guideTitle: 'Welcome to dsh-auto-memory', guideSub: 'What this plugin does:',
+      gFeat1: 'Three-layer memory with automatic injection & retrieval: user / project notes / daily logs',
+      gFeat2: 'Auto-consolidation after every turn: bugs fixed and decisions made are written into today\'s log automatically',
+      gFeat3: 'AI period greetings with three-level drawers: open the Memory panel for a period-by-period digest',
+      gFeat4: 'Smart search & calendar: ask in natural language; AI files deadlines into the calendar and reminds you',
+      gFeat5: 'Inherit memories from other AI tools: CodeBuddy / Claude Code / Codex etc. in one click',
+      gFeat6: 'Auto update check at boot, one-click update in settings',
+      guideTip: 'Click the Memory button in the sidebar to start; all memories are plain local Markdown files you can inspect anytime.',
+      updateTitle: 'dsh-auto-memory Updated', updateSub: 'What\'s new in this update:', gotIt: 'Got it',
         refresh: 'Refresh', refreshing: 'Refreshing…', close: 'Close', dragMove: 'Drag to move', dragResize: 'Drag to resize', resetPos: 'Reset position',
         generated: 'Generated', failed: 'Failed: ',
         generatedAt: 'Generated ',
@@ -284,6 +304,40 @@ window.__ModuleLoader__.load({
     function t(key) { return (I18N[locale] && I18N[locale][key]) || I18N.zh[key] || key }
     function setLocale(l) { if (l !== 'zh' && l !== 'en') return; if (l === locale) return; locale = l; localeListeners.forEach(function (fn) { try { fn(l) } catch (e) {} }) }
     function onLocale(fn) { localeListeners.add(fn); return function () { localeListeners.delete(fn) } }
+    // 暂离检测:距离上次关闭面板超过 1 小时视为暂离回来
+    function isAway() {
+      var lastSeen = 0
+      try { lastSeen = Number(localStorage.getItem('dsh-auto-memory.lastActive') || 0) } catch (e) {}
+      return lastSeen > 0 && (Date.now() - lastSeen) > 3600000
+    }
+
+    // ───────────────────────── 更新弹窗 / 首次指导 ─────────────────────────
+    var CHANGELOG = {
+      '0.1.14': { zh: ['新增:更新后自动弹出更新说明窗口,首次安装有功能指导窗口', '新增:暂离超过 1 小时回来,记忆窗口自动打开并显示 AI 总结', '优化:弹窗改为左下角毛玻璃小卡片,更透明更轻量'], en: ['New: update dialog shows what changed after an upgrade; first-run guide dialog for new installs', 'New: the memory panel auto-opens with an AI summary after returning from >1h away', 'Polish: dialogs are now compact frosted-glass cards in the bottom-left corner'] },
+      '0.1.13': { zh: ['修复 npm 安装后客户端面板无法加载(bundle 注册名拼写)', '修复秒级时间戳击穿 DeepSeek 前缀缓存(改日期级,大幅节省 token)', '修复记忆接续导入报错'], en: ['Fix client panel not loading after npm install (bundle registration id)', 'Fix second-level timestamp breaking DeepSeek prefix cache (date-level now, big token savings)', 'Fix memory import error (inherit external memory)'] },
+      '0.1.12': { zh: ['声明 @deepseek-ai/cordis 为 peerDependency(插件市场收录规范)'], en: ['Declare @deepseek-ai/cordis as peerDependency (plugin market checklist)'] },
+      '0.1.11': { zh: ['界面语言跟随 DSH 系统语言,实时切换', 'README 重构:宣传图/真实截图/快速安装', '修复设置页加载崩溃'], en: ['UI language follows the DSH system language', 'README overhaul: banner, real screenshots, quick install', 'Fix settings page crash'] },
+      '0.1.10': { zh: ['自动检查更新 + 设置页一键更新', '日界:凌晨的活儿归前一天(默认 7:30)', '记忆根目录系统文件夹选择器,换位置自动迁移', '每日写入预算,超限自动压缩旧内容', '30 天 AI 蒸馏'], en: ['Auto update check + one-click update in settings', 'Day boundary: late-night work logs to yesterday (default 07:30)', 'Native OS folder picker for memory root, auto-migration', 'Daily write budget with auto-compaction', '30-day AI distillation'] },
+    }
+    var dialogListeners = new Set()
+    var dialogState = null // {kind:'update', versions:[...]} | {kind:'first'}
+    function openDialog(d) { dialogState = d; dialogListeners.forEach(function (fn) { try { fn() } catch (e) {} }) }
+    function closeDialog() { dialogState = null; dialogListeners.forEach(function (fn) { try { fn() } catch (e) {} }) }
+    function onDialog(fn) { dialogListeners.add(fn); return function () { dialogListeners.delete(fn) } }
+    function cmpVersion(a, b) {
+      var pa = String(a).split('.').map(Number), pb = String(b).split('.').map(Number)
+      for (var i = 0; i < 3; i++) {
+        var x = pa[i] || 0, y = pb[i] || 0
+        if (x > y) return 1
+        if (x < y) return -1
+      }
+      return 0
+    }
+    function changelogBetween(fromVer, toVer) {
+      var keys = Object.keys(CHANGELOG).filter(function (v) { return cmpVersion(v, fromVer) > 0 && cmpVersion(v, toVer) <= 0 })
+      keys.sort(function (a, b) { return cmpVersion(a, b) })
+      return keys.map(function (v) { return { version: v, items: CHANGELOG[v] } })
+    }
 
     // ───────────────────────── API ─────────────────────────
     var API = {
@@ -389,7 +443,7 @@ window.__ModuleLoader__.load({
       if (document.getElementById(STYLE_ID)) return
       var tag = document.createElement('style')
       tag.id = STYLE_ID
-      tag.dataset.plugin = '@deepseek-ai/dsh-auto-memory'
+      tag.dataset.plugin = '@a9i5k4/dsh-auto-memory'
       tag.textContent = CSS
       document.head.appendChild(tag)
     }
@@ -472,11 +526,7 @@ window.__ModuleLoader__.load({
           return base
         })()
       // 离开>1小时后回来
-      function away() {
-        var lastSeen = 0
-        try { lastSeen = Number(localStorage.getItem('dsh-auto-memory.lastActive') || 0) } catch (e) {}
-        return lastSeen > 0 && (Date.now() - lastSeen) > 3600000
-      }
+      function away() { return isAway() }
       var rows = []
       rows.push(h('div', { 'data-dam-content': '' }, greetLine))
       // 抽屉列表(AI 生活化总结缓存)
@@ -593,10 +643,7 @@ window.__ModuleLoader__.load({
         }, 30000)
         return function () { clearInterval(timer) }
       }, [])
-      useEffect(function () {
-        // 记录本次活动时间;下次打开若相隔>1小时,GreetingCard 显示"欢迎回来"
-        try { localStorage.setItem('dsh-auto-memory.lastActive', String(Date.now())) } catch (e) {}
-      }, [])
+
       if (!state) return h(Loading)
       function oneClickReflect() {
         if (reflectBusy) return
@@ -1211,6 +1258,50 @@ window.__ModuleLoader__.load({
         kv(t('kvApi'), probes ? Object.keys(probes).map(function (k) { return k + '=' + (probes[k].status !== undefined ? probes[k].status : probes[k].error) }).join('  ') : '…', apiBad))
     }
 
+    // ───────────────────────── 更新弹窗 / 首次指导(毛玻璃) ─────────────────────────
+    function DialogHost() {
+      var tickPair = useTick()
+      useEffect(function () { return onDialog(tickPair[1]) }, [])
+      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' }
+      var box = {
+        overflow: 'auto', borderRadius: '14px', padding: '12px 14px', display: 'flex', flexDirection: 'column', gap: '6px',
+        background: 'color-mix(in srgb, var(--dsw-alias-bg-overlay, rgba(24,26,32,.9)) 58%, transparent)',
+        backdropFilter: 'blur(14px) saturate(1.3)', WebkitBackdropFilter: 'blur(14px) saturate(1.3)',
+        border: '1px solid color-mix(in srgb, var(--dsw-alias-border-l1, rgba(128,128,128,.35)) 45%, transparent)',
+        boxShadow: '0 8px 28px rgba(0,0,0,.18)',
+      }
+      var head = { fontSize: 'calc(13px * var(--dam-scale))', fontWeight: 700, color: 'var(--dsw-alias-text-primary, inherit)' }
+      var sub = { fontSize: 'calc(11px * var(--dam-scale))', opacity: .7 }
+      var item = { fontSize: 'calc(11px * var(--dam-scale))', lineHeight: 1.55, padding: '1px 0 1px 16px', position: 'relative' }
+      var close = { alignSelf: 'flex-end', padding: '4px 16px', borderRadius: '8px', border: '1px solid color-mix(in srgb, var(--dsw-alias-border-l1, rgba(128,128,128,.35)) 45%, transparent)', background: 'color-mix(in srgb, var(--dsw-alias-brand-primary, #4f7cff) 12%, transparent)', color: 'var(--dsw-alias-text-primary, inherit)', cursor: 'pointer', fontSize: 'calc(11.5px * var(--dam-scale))' }
+      var dot = { position: 'absolute', left: '0', top: '10px', width: '7px', height: '7px', borderRadius: '50%', background: 'var(--dsw-alias-brand-primary, #4f7cff)' }
+      if (dialogState.kind === 'first') {
+        var feats = [t('gFeat1'), t('gFeat2'), t('gFeat3'), t('gFeat4'), t('gFeat5'), t('gFeat6')]
+        return h('div', { style: overlay },
+          h('div', { style: box },
+            h('div', { style: head }, t('guideTitle')),
+            h('div', { style: sub }, t('guideSub')),
+            feats.map(function (f) { return h('div', { style: item }, h('span', { style: dot }), f) }),
+            h('div', { style: { fontSize: 'calc(12px * var(--dam-scale))', opacity: .8, marginTop: '4px' } }, t('guideTip')),
+            h('button', { 'data-dam-btn': '', style: close, onClick: closeDialog }, t('gotIt'))))
+      }
+      var versions = dialogState.versions || []
+      var lastV = versions.length ? versions[versions.length - 1].version : ''
+      return h('div', { style: overlay },
+        h('div', { style: box },
+          h('div', { style: head }, t('updateTitle') + ' v' + lastV),
+          h('div', { style: sub }, t('updateSub')),
+          versions.map(function (v) {
+            var items = (v.items && (v.items[locale] || v.items.zh)) || []
+            return h('div', null,
+              h('div', { style: { fontSize: 'calc(13px * var(--dam-scale))', fontWeight: 700, margin: '6px 0 2px', opacity: .9 } }, 'v' + v.version),
+              items.map(function (it) { return h('div', { style: item }, h('span', { style: dot }), it) }))
+          }),
+          h('button', { 'data-dam-btn': '', style: close, onClick: closeDialog }, t('gotIt'))))
+    }
+
     // ───────────────────────── 设置页 ─────────────────────────
     var STYLE_IDS = ['auto', 'life', 'professional']
     var LOCALE_IDS_LIST = ['system', 'zh', 'en']
@@ -1403,6 +1494,34 @@ window.__ModuleLoader__.load({
       })
       // 语言切换时通知所有订阅者重渲染
       onLocale(function () { emit() })
+      // 暂离回来自动弹开记忆窗口:距离上次关闭面板超过 1 小时,页面加载或切回标签页时自动打开(欢迎语在 GreetingCard 展示)
+      function autoOpenOnReturn() {
+        try {
+          if (isAway() && !controller.isOpen()) controller.open()
+        } catch (e) {}
+      }
+      autoOpenOnReturn()
+      try {
+        document.addEventListener('visibilitychange', function () {
+          if (!document.hidden) autoOpenOnReturn()
+        })
+      } catch (e) {}
+      // 更新弹窗 / 首次指导:对比本地记录的已见版本,有更新或首次安装时弹窗(host 12h 缓存,不重复查网)
+      apiGet(API.updateCheck).then(function (d) {
+        if (d && d.current) {
+          try {
+            var seen = localStorage.getItem('dsh-auto-memory.seenVersion')
+            if (!seen && !localStorage.getItem('dsh-auto-memory.firstRunDone')) {
+              try { localStorage.setItem('dsh-auto-memory.firstRunDone', '1') } catch (e2) {}
+              openDialog({ kind: 'first' })
+            } else if (seen && seen !== d.current) {
+              var versions = changelogBetween(seen, d.current)
+              if (versions.length) openDialog({ kind: 'update', versions: versions })
+            }
+            try { localStorage.setItem('dsh-auto-memory.seenVersion', d.current) } catch (e3) {}
+          } catch (e) {}
+        }
+      }).catch(function () {})
 
       var surfaceDisposers = []
       function registerSurfaces() {
@@ -1413,6 +1532,9 @@ window.__ModuleLoader__.load({
           surfaceDisposers.push(slots.inject('shell.overlay', function () {
             return slots.register({ name: 'shell.overlay', id: 'auto-memory', order: 5 }, function () { return h(MemoryPanel) })
           }))
+          surfaceDisposers.push(slots.inject('shell.overlay', function () {
+            return slots.register({ name: 'shell.overlay', id: 'auto-memory-dialogs', order: 6 }, function () { return h(DialogHost) })
+          }))
           surfaceDisposers.push(slots.inject('settings.section', function () {
             return slots.register({ name: 'settings.section', id: 'auto-memory', order: 25, label: t('autoMemory') }, function (props) { return h(SettingsPage, { close: props && props.close }) })
           }))

package/lib/index.js

@@ -106,7 +106,7 @@ const DEFAULT_CONFIG = {
 const pad = (n) => String(n).padStart(2, '0')
 const todayStr = () => { const d = new Date(); return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}` }
 const nowHm = () => { const d = new Date(); return `${pad(d.getHours())}:${pad(d.getMinutes())}` }
-const nowHms = () => { const d = new Date(); return `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}` }
+
 const dateStrOf = (ts) => { const d = new Date(ts); return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}` }
 const DATE_RE = /^\d{4}-\d{2}-\d{2}$/
 const truncateHead = (s, n) => (s && s.length > n) ? s.slice(0, n) + '\n…(截断,完整内容用 memory_recall 或 GUI 面板)' : (s || '')
@@ -663,7 +663,7 @@ class MemoryEngine {
       lines.push('\n[欢迎回来]')
       lines.push('用户离开已超过 1 小时(暂离/下班后回来)。在本轮回复的开头,先用一句简短温暖的话欢迎用户回来(如"欢迎回来!你离开的这段时间,我已经帮你把日志整理好了。"),然后提示"自动记忆窗口将打开,方便你了解这段时间的状况"(如已由 GUI 弹出概览则不必重复提示)。语气自然,一两句即可,不要长篇大论。')
     }
-    lines.push('\n[铭文 · 每轮提醒 ' + nowHms() + ']')
+    lines.push('\n[铭文 · 每轮提醒 ' + this.memToday() + ']') // 日期级刷新(秒级时间戳会击穿 DeepSeek 前缀缓存,每步全量重编码)
     lines.push('思维链=本轮推理(用完即焚);铭文=落盘的记忆文件(跨会话永久)。你的记忆更新必须落在铭文层——显式调用工具写盘,不能只"想过"。')
     lines.push('本提醒由框架在每一轮对话开始时重新注入(时间戳即刷新证明,衰减期只有一轮):读写只走工具、路径写死、每轮结束框架自动评估沉淀兜底——记忆无法被绕过,也不依赖自觉。')
     lines.push('\n[记忆写入纪律 — 必须遵守]')
@@ -2016,7 +2016,7 @@ class ExternalMemory {
     const src = srcs.find((s) => s.id === sourceId)
     if (!src) return '外部源不存在: ' + sourceId
     if (src.kind === 'sessions') return '会话类源不支持整体接入,请用 memory_recall 按需检索(' + src.files.length + ' 个会话文件)。'
-    const stamp = '## 来自 ' + src.tool + '(' + src.name + ') — 接入于 ' + this.memToday()
+    const stamp = '## 来自 ' + src.tool + '(' + src.name + ') — 接入于 ' + engine.memToday() // ExternalMemory 类,this 无 memToday,必须用 engine
     if (target === 'user') {
       const p = await engine.resolvePaths(agent)
       const body = await engine.appendText(p.userFile, '\n' + stamp + '\n' + src.content.slice(0, 120000))

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@a9i5k4/dsh-auto-memory",
   "description": "DSH 自动记忆插件:三层记忆(用户级/项目笔记/每日日志)自动注入与检索、每轮对话自动沉淀、每日反思、可视化面板与设置页,支持继承其他 AI 工具的记忆。",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "type": "module",
   "main": "lib/index.js",
   "exports": {