dsh-recall-plugin 1.0.1 → 1.0.3

package/README.md

@@ -26,7 +26,7 @@
 
 - **文件 + 对话，整段回退**：撤回的不只是聊天记录，agent 改过的文件也一并回到原样。
 - **不碰你项目自己的 git**：快照存在独立的影子 git 仓库里，你的分支、暂存区、未提交改动统统不受影响；`.git`、`node_modules` 自动排除。
-- **项目目录保持干净**：快照始终存在 `$DSH_HOME` 下，不会往项目里塞任何东西；与会话的沙箱权限无关（workspace-write / read-only 会话照常快照与回退），仅当 home 本身不可写（如指到只读盘）才降级到项目内 `.dsh-recall-snapshots`，home 恢复后自动迁走、清理干净。
+- **项目目录保持干净**：快照始终存在 `$DSH_HOME` 下，不会往项目里塞任何东西；与会话的沙箱权限无关（workspace-write / read-only 会话照常快照与回退），仅当 home 本身不可写（如指到只读盘）才降级到项目内 `.dsh-recall-snapshots`（降级时页面会提示），home 恢复后自动迁走、清理干净。
 - **可以反复后悔**：快照全量保留、永不修剪。撤回一次后还能再撤到更早；撤回时被覆盖的文件也一直找得回来。
 - **先看清单再动手**：点撤回先弹出将变更的文件清单（修改 / 恢复 / 删除），确认后才执行，不会稀里糊涂覆盖。
 - **磁盘友好**：快照走 git delta 压缩，是增量不是整目录拷贝；超过 100MB 的大文件自动跳过。
@@ -40,7 +40,7 @@
 
 ## 安装
 
-前置：Windows + git CLI（未装 git 时插件静默降级，不显示撤回按钮，不影响 DSH 运行）；PowerShell 5.1 / 7 均可；DSH 0.1.0-rc.x（依赖版本见 `peerDependencies`）。
+前置：Windows + git CLI（未装 git 时撤回按钮不出现，页面顶部会提示安装 git，不影响 DSH 运行）；PowerShell 5.1 / 7 均可；DSH 0.1.0-rc.x（依赖版本见 `peerDependencies`）。
 
 
 - DSH 官方插件命令：安装并自动挂载进 web profile

package/lib/client.js

@@ -59,7 +59,10 @@ window.__ModuleLoader__.load({
           '.dsh-recall-btn{border:none;border-radius:8px;padding:5px 14px;font-size:13px;line-height:20px;cursor:pointer;color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-interactive-bg-hover)}',
           '.dsh-recall-btn:hover{color:var(--dsw-alias-label-primary)}',
           '.dsh-recall-btn-danger{background:var(--dsw-alias-state-error-primary);color:#fff}',
-          '.dsh-recall-btn-danger:hover{color:#fff;filter:brightness(1.08)}'
+          '.dsh-recall-btn-danger:hover{color:#fff;filter:brightness(1.08)}',
+          '.dsh-recall-toast{position:fixed;top:18px;left:50%;transform:translateX(-50%);z-index:10000;max-width:min(560px,86vw);box-sizing:border-box;background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-primary);border:1px solid var(--dsw-alias-border-l2);border-radius:12px;padding:10px 16px;font-size:13px;line-height:20px;box-shadow:0 8px 28px rgba(0,0,0,.22);display:flex;align-items:baseline;gap:8px;opacity:0;transition:opacity .25s ease;pointer-events:auto}',
+          '.dsh-recall-toast.dsh-recall-toast-in{opacity:1}',
+          '.dsh-recall-toast-tag{flex:none;font-weight:600;color:var(--dsw-alias-state-error-primary)}'
         ].join('')
         // 静态 bundle 的 ctx 可能不提供 styles 服务，降级为直接注入 <style>
         const stylesSvc = ctx.get('styles')
@@ -75,6 +78,37 @@ window.__ModuleLoader__.load({
         let initedSessionId = null
         let initDone = Promise.resolve()
 
+        // 降级提示：每个种类每次页面加载只弹一次（Set 去重），避免切会话时
+        // 反复打扰。纯 DOM 直插（与剪贴板同样的零依赖思路），7 秒后自动淡出。
+        const noticeShown = new Set()
+        function showNotice(kind, text) {
+          if (noticeShown.has(kind) || typeof document === 'undefined') return
+          noticeShown.add(kind)
+          try {
+            const el = document.createElement('div')
+            el.className = 'dsh-recall-toast'
+            const tag = document.createElement('span')
+            tag.className = 'dsh-recall-toast-tag'
+            tag.textContent = '撤回插件'
+            const body = document.createElement('span')
+            body.textContent = text
+            el.appendChild(tag)
+            el.appendChild(body)
+            el.addEventListener('click', () => dismiss(), { once: true })
+            document.body.appendChild(el)
+            requestAnimationFrame(() => el.classList.add('dsh-recall-toast-in'))
+            const timer = setTimeout(dismiss, 7000)
+            let dismissed = false
+            function dismiss() {
+              if (dismissed) return
+              dismissed = true
+              clearTimeout(timer)
+              el.classList.remove('dsh-recall-toast-in')
+              setTimeout(() => el.remove(), 300)
+            }
+          } catch (e) { /* 提示失败不影响主流程 */ }
+        }
+
         // 每个会话只向 Host 注册一次（预热其根目录解析缓存）。
         // 返回 init 的 promise：Host 端 init 要跑数条 PowerShell（建仓/loadIndex），
         // snapshot-info 必须等它完成后再查，否则冷启动时索引尚未载入会误判
@@ -82,7 +116,15 @@ window.__ModuleLoader__.load({
         function ensureInit(sessionId) {
           if (!sessionId || initedSessionId === sessionId) return initDone
           initedSessionId = sessionId
-          initDone = api('init', { sessionId }).catch(() => {})
+          initDone = api('init', { sessionId }).then((res) => {
+            const notice = res && res.notice
+            if (notice && notice.gitMissing) {
+              showNotice('git', '未检测到 git CLI，撤回功能不可用（快照引擎依赖 git）。安装 git 并重启 DSH 后即可使用。')
+            }
+            if (notice && notice.homeFallback) {
+              showNotice('home', 'home 目录不可写，快照已降级存储到项目内 .dsh-recall-snapshots 目录。')
+            }
+          }).catch(() => {})
           return initDone
         }
 

package/lib/index.js

@@ -83,16 +83,35 @@ export function apply(ctx) {
       const sp = ctx.get('sandboxPolicy')
       if (sp && sp.workspaceRoot) root = sp.workspaceRoot
     }
+    // 规范化尾部反斜杠（保留 "D:\" 三字符盘根形态，去掉会变成无效的 "D:"）：
+    // cwd 是否带尾斜杠由上游决定，不归一会让哈希输入不一致（换 store 目录），
+    // 也会让大文件排除扫描的 Substring($root.Length + 1) 相对路径错一位。
+    if (root && root.length > 3) root = root.replace(/\\+$/, '')
     if (root) state.roots.set(key, root)
     return root
   }
 
   // 解析 git 可执行文件路径：DSH 进程 PATH 可能不含 git，
   // 求值一次并缓存，脚本里用绝对路径调用，避免每条命令依赖 PATH。
+  // 候选覆盖 PATH / 64 位 / 32 位 / 用户级（LocalAppData）四类安装位置，
+  // 并用 -PathType Leaf 挡掉 PATH 里恰有名为 git 的目录这种极端情形。
   async function resolveGit() {
     if (state.gitExe !== null) return state.gitExe
     try {
-      let path = stripBom(await runShell("$g = (Get-Command git -ErrorAction SilentlyContinue).Source; if (-not $g -and (Test-Path -LiteralPath 'C:\\Program Files\\Git\\cmd\\git.exe')) { $g = 'C:\\Program Files\\Git\\cmd\\git.exe' }; if ($g) { Write-Output $g }", { stdoutMaxBytes: 4096 })).trim()
+      // 逐项判空再 Join-Path：个别 env 在特殊环境（32 位系统无
+      // ProgramFiles(x86)）取到 null，EAP=Stop 下 Join-Path 抛错会
+      // 让整个探测失败、误报 gitMissing。
+      const script = [
+        '$candidates = @()',
+        '$g = (Get-Command git -ErrorAction SilentlyContinue).Source',
+        'if ($g) { $candidates += $g }',
+        "if (${env:ProgramFiles}) { $candidates += (Join-Path ${env:ProgramFiles} 'Git\\cmd\\git.exe') }",
+        "if (${env:ProgramFiles(x86)}) { $candidates += (Join-Path ${env:ProgramFiles(x86)} 'Git\\cmd\\git.exe') }",
+        "if (${env:LocalAppData}) { $candidates += (Join-Path ${env:LocalAppData} 'Programs\\Git\\cmd\\git.exe') }",
+        "$g = $candidates | Where-Object { $_ -and (Test-Path -LiteralPath $_ -PathType Leaf) } | Select-Object -First 1",
+        'if ($g) { Write-Output $g }'
+      ].join('\n')
+      const path = stripBom(await runShell(script, { stdoutMaxBytes: 4096 })).trim()
       state.gitExe = path || ''
     } catch (error) {
       state.gitExe = ''
@@ -105,9 +124,13 @@ export function apply(ctx) {
   // 后两者是 .NET 5+（仅 PS 7）API，别人机器的 shell 若是 Windows PowerShell
   // 5.1 会抛错，导致 home 存储永远降级到项目内；前者两个版本都可用。
   async function homeDirFor(root, sessionId) {
+    // DSH 的 pwsh 子进程按白名单重建 env，会话级导出的 DSH_HOME 传不进去；
+    // 主进程（node）仍能看到它，作为字面量回退注入，保证「DSH_HOME 指到哪、
+    // 快照就存哪」在任意导出层级下都成立。
+    const envHome = (process.env && process.env.DSH_HOME) || ''
     const dirScript = [
       '$r = ' + psq(root),
-      '$h = if ($env:DSH_HOME) { $env:DSH_HOME } else { Join-Path $env:USERPROFILE ".dsh" }',
+      "$h = if ($env:DSH_HOME) { $env:DSH_HOME } elseif (" + psq(envHome) + ") { " + psq(envHome) + " } else { Join-Path $env:USERPROFILE \".dsh\" }",
       '$sha = [Security.Cryptography.SHA256]::Create()',
       "$hex = ([BitConverter]::ToString($sha.ComputeHash([Text.Encoding]::UTF8.GetBytes($r))) -replace '-','').ToLower()",
       "Write-Output (Join-Path $h ('dsh-recall-snapshots\\' + $hex))"
@@ -260,7 +283,10 @@ export function apply(ctx) {
       dropGitlinksScript(),
       '& $git --git-dir=$g --work-tree=$root add -A',
       dropGitlinksScript(),
-      'Get-ChildItem -LiteralPath $root -Recurse -File -Force | Where-Object { $_.Length -gt ' + MAX_FILE_BYTES + ' } | ForEach-Object {',
+      // 扫描加 SilentlyContinue：EAP=Stop 下个别不可访问子目录（杀软锁定、
+      // 异常 ACL、损坏 junction）的非致命错误会被升级为终止，整条快照作废；
+      // 本扫描只用于排除超大文件，漏看个别文件是 fail-open，可接受。
+      'Get-ChildItem -LiteralPath $root -Recurse -File -Force -ErrorAction SilentlyContinue | Where-Object { $_.Length -gt ' + MAX_FILE_BYTES + ' } | ForEach-Object {',
       "  $rel = $_.FullName.Substring($root.Length + 1).Replace('\\','/')",
       '  & $git --literal-pathspecs --git-dir=$g update-index --force-remove -- $rel',
       '}',
@@ -290,7 +316,7 @@ export function apply(ctx) {
       dropGitlinksScript(),
       '& $git --git-dir=$g --work-tree=$root add -A',
       dropGitlinksScript(),
-      'Get-ChildItem -LiteralPath $root -Recurse -File -Force | Where-Object { $_.Length -gt ' + MAX_FILE_BYTES + ' } | ForEach-Object {',
+      'Get-ChildItem -LiteralPath $root -Recurse -File -Force -ErrorAction SilentlyContinue | Where-Object { $_.Length -gt ' + MAX_FILE_BYTES + ' } | ForEach-Object {',
       "  $rel = $_.FullName.Substring($root.Length + 1).Replace('\\','/')",
       '  & $git --literal-pathspecs --git-dir=$g update-index --force-remove -- $rel',
       '}',
@@ -342,7 +368,7 @@ export function apply(ctx) {
       dropGitlinksScript(),
       '& $git --git-dir=$g --work-tree=$root add -A',
       dropGitlinksScript(),
-      'Get-ChildItem -LiteralPath $root -Recurse -File -Force | Where-Object { $_.Length -gt ' + MAX_FILE_BYTES + ' } | ForEach-Object {',
+      'Get-ChildItem -LiteralPath $root -Recurse -File -Force -ErrorAction SilentlyContinue | Where-Object { $_.Length -gt ' + MAX_FILE_BYTES + ' } | ForEach-Object {',
       "  $rel = $_.FullName.Substring($root.Length + 1).Replace('\\','/')",
       '  & $git --literal-pathspecs --git-dir=$g update-index --force-remove -- $rel',
       '}',
@@ -390,7 +416,11 @@ export function apply(ctx) {
     ].join('\n')
   }
 
-  // 索引写入合并为单次 shell 调用：pwsh 进程启动是主要耗时，能省一次是一次
+  // 索引写入合并为单次 shell 调用：pwsh 进程启动是主要耗时，能省一次是一次。
+  // base64 以内联字面量传递时受 Windows 命令行 32767 字符硬上限约束（DSH 的
+  // pwsh 执行器把命令串作为 -Command 的单个 argv 元素 spawn），快照攒到几百条
+  // 就会超限 spawn 失败——按 20000 字符分块，首块 Set-Content、续块 Add-Content，
+  // 常规体量仍是单次调用，超限后自动多写几块。
   async function saveIndex(root, sessionId) {
     const store = state.stores.get(root)
     if (!store) return
@@ -400,7 +430,16 @@ export function apply(ctx) {
     const json = JSON.stringify(entries)
     try {
       const b64 = Buffer.from(json, 'utf8').toString('base64')
-      await runShell("New-Item -ItemType Directory -Force -Path " + psq(store.dir) + " | Out-Null; [Text.Encoding]::UTF8.GetString([Convert]::FromBase64String('" + b64 + "')) | Set-Content -LiteralPath " + psq(store.dir + '\\index.json') + ' -Encoding utf8 -NoNewline', { stdoutMaxBytes: 4096 })
+      const file = psq(store.dir + '\\index.json')
+      let first = true
+      for (let i = 0; i < b64.length; i += 20000) {
+        const piece = "[Text.Encoding]::UTF8.GetString([Convert]::FromBase64String('" + b64.slice(i, i + 20000) + "')) | "
+        const cmd = first
+          ? 'New-Item -ItemType Directory -Force -Path ' + psq(store.dir) + ' | Out-Null; ' + piece + 'Set-Content -LiteralPath ' + file + ' -Encoding utf8 -NoNewline'
+          : piece + 'Add-Content -LiteralPath ' + file + ' -Encoding utf8 -NoNewline'
+        await runShell(cmd, { stdoutMaxBytes: 4096 })
+        first = false
+      }
     } catch (error) {
       console.error('recall saveIndex failed:', String(error))
     }
@@ -570,6 +609,7 @@ export function apply(ctx) {
         if (name === 'init') {
           const sessionId = args && args.sessionId ? String(args.sessionId) : null
           const root = await resolveRoot(sessionId)
+          let notice = null
           if (root) {
             let store = await resolveStore(root, sessionId)
             store = await tryUpgradeToHome(root, sessionId)
@@ -577,8 +617,15 @@ export function apply(ctx) {
             await loadIndex(root, sessionId)
             await rebuildOrphans(root, sessionId)
             cleanupLegacy(root, sessionId)
+            // 降级状态随 init 下发，Client 弹一次性提示（每次页面加载各弹一次）：
+            // gitMissing=未检测到 git CLI（撤回按钮不出现）；homeFallback=home
+            // 不可写，快照降级存进项目内 .dsh-recall-snapshots。
+            notice = {
+              gitMissing: state.gitExe === '',
+              homeFallback: store ? !store.home : false
+            }
           }
-          sendJson(res, 200, { ok: Boolean(root), root: root || null })
+          sendJson(res, 200, { ok: Boolean(root), root: root || null, notice })
           return
         }
         if (name === 'snapshot-info') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-recall-plugin",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "DSH 消息撤回插件：在用户消息气泡旁加「撤回」按钮，把项目文件（独立影子 git 仓库快照）与对话历史（官方 fork）一并回退到该消息发送之前。",
   "type": "module",
   "repository": {