dsh-recall-plugin 1.0.1 → 1.0.2

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

@@ -570,6 +570,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 +578,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.2",
   "description": "DSH 消息撤回插件：在用户消息气泡旁加「撤回」按钮，把项目文件（独立影子 git 仓库快照）与对话历史（官方 fork）一并回退到该消息发送之前。",
   "type": "module",
   "repository": {