dsh-island-overlay 0.2.1 → 0.2.3

package/README.md

@@ -83,15 +83,16 @@ dsh plugin --profile desktop add dsh-island-overlay
 | 事件 | 显示 |
 |---|---|
 | `turn/start` | 思考（小鲸鱼 + 计时，2.5s 后缩成小图标） |
-| `approval/asked` | 等待审批（琥珀脉冲，常驻展开） |
+| `approval/asked` | 等待审批（琥珀脉冲，常驻展开，计时接着走） |
 | `tool/call` = `ask_user_question` | 等待回答（同上） |
 | `turn/end` = `completed` | 完成（绿勾，3s 后消失） |
 | `turn/end` = `error` / `blocked` / `max-tokens` | 失败（红色抖动，6s 后消失） |
 | `turn/end` = `aborted` / `interrupted` / `forked` | 不显示，直接消失 |
 
 多个会话同时有事时只显示优先级最高的一个（审批/回答 > 失败 > 完成 > 思考），其余用 `+N` 角标；最多并列显示 3 个会话，每段各自计时。
+计时读的是**回合开始时间**，所以「思考 20 分钟 → 弹审批 → 继续思考」是一条连续的时间轴，不会归零。
 
-交互：拖动可移动位置（记在 `~/.dsh/dsh-island-pos.json`）；点一下把 DSH 拉到前台；
+交互：拖动可移动位置（自动切到「自定义位置」，记在 `~/.dsh/dsh-island-pos.json`）；点一下把 DSH 拉到前台；
 鼠标划过展开全文；检测到前台是全屏程序（视频/游戏）时自动隐藏。
 
 ## 卸载
@@ -102,12 +103,102 @@ dsh plugin --profile desktop add dsh-island-overlay
 
 然后重启 DSH，再把文件夹和 `%LOCALAPPDATA%\dsh-island-runtime` 删掉。
 
-## 排错
+## 常见问题
+
+### 安装
+
+**`dsh` 命令找不到 / `'dsh' 不是内部或外部命令`**
+DSH 不会把 `dsh` 加进 PATH，得用完整路径：
+
+```powershell
+& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add dsh-island-overlay
+```
+
+装在非默认目录（比如 `D:\`）时，把上面路径换成你的实际位置。
+
+**`install.ps1` 报 `dsh.cmd not found`**
+脚本只在 `%LOCALAPPDATA%\Programs`、`Program Files`、`Program Files (x86)` 三个位置找 DSH。装在别处就手动指定：
+
+```powershell
+powershell -ExecutionPolicy Bypass -File install.ps1 -Cli "D:\...\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd"
+```
+
+**`无法加载文件 install.ps1，因为在此系统上禁止运行脚本`**
+Windows 默认执行策略拦脚本。加 `-ExecutionPolicy Bypass`（上面的命令已经带了），不要改全局策略。
+
+**需要自己装 pnpm / node 吗**
+不需要。DSH 自带一份 pnpm（`resources\runtime\primary-runtime\dependencies\pnpm\bin\pnpm.mjs`），
+`dsh plugin` 内部用 DSH 自己的 Electron 跑它，跟系统的 node/pnpm 无关。系统里有别的 pnpm 也不会冲突。
+
+**pnpm 报 `ERR_PNPM_...` / 网络超时**
+`dsh plugin` 用的是你 npm 配置里的 registry。国内网络建议：
+
+```powershell
+npm config get registry   # 一般是 https://registry.npmmirror.com
+```
+
+本包在 npmmirror 已同步。若公司网络拦 npm，可临时指定源：
+`dsh plugin --profile desktop add dsh-island-overlay --registry=https://registry.npmmirror.com`。
+
+**装完没反应**
+装完必须**重启 DSH**（托盘右键退出，再打开）。热重载不会拉起浮层。
+确认 `~/.dsh/profiles/desktop/package.json` 的 `dsh.profile.bundles` 里有 `dsh-island-overlay`。
+
+**已经用 `link:` 装过本地目录，又想换成 npm 版**
+先卸再装，否则 pnpm 会把 link 改写成 npm 版本、你本地的改动就不再生效：
+
+```powershell
+& "<dsh.cmd 完整路径>" plugin --profile desktop remove dsh-island-overlay
+& "<dsh.cmd 完整路径>" plugin --profile desktop add dsh-island-overlay
+```
+
+反过来（npm 版换成本地开发）把 `add dsh-island-overlay` 换成 `add link:<本目录绝对路径>`。
+
+### 运行时
+
+**状态文件在变，但屏幕上看不到胶囊**
+先看日志，两个文件都在 `%USERPROFILE%\.dsh\`：
+
+- `dsh-island-plugin.log`：`runtime prepared` + `spawn ...` 说明浮层被拉起过；
+  只有 `skip: isElectron=false` 说明插件没跑在 DSH 主进程里。
+- `dsh-island-overlay.log`：每次启动写 `start v0.2.x`，之后每 60 秒一条 `alive`。
+  没有 `start` → 浮层根本没起来。
+
+手动起浮层验证：
+
+```powershell
+& "$env:LOCALAPPDATA\dsh-island-runtime\DeepSeek Harness.exe" "<本目录>\overlay"
+```
+
+正常会弹出一条黑色胶囊（控制台里的 `disk_cache` 报错可以忽略）。
+
+**浮层起不来，日志里连 `start` 都没有**
+多半是运行时镜像不完整。删掉 `%LOCALAPPDATA%\dsh-island-runtime` 再重启 DSH，插件会自动重建
+（同盘用硬链接，不额外占空间）。镜像里必须有 `resources\default_app.asar`，缺它 Electron 就不认命令行给的 app 目录。
+
+**跑一阵子自己消失了**
+已修（0.2.0+）。旧版在心跳短暂中断后不会恢复显示，看起来就是「消失了」。升级后：心跳断 30 秒先隐藏，
+恢复后自动重新显示，连续 5 分钟没恢复才退出进程。仍复现的话看 `dsh-island-overlay.log` 最后几行。
+
+**点胶囊后 DSH 变成窗口化 / 反应慢**
+已修（0.2.0+）。旧版用 `SW_RESTORE` 会把最大化窗口还原；现在只在窗口最小化时才还原。
+慢是因为旧版每次点击都新起一个 PowerShell，现在复用常驻的 `watch.ps1`（约 150–250ms）。
+
+**胶囊挡到浏览器标签页**
+鼠标事件是穿透的（只挡视觉，不挡点击）。想少挡：设置里把「迷你态」调小，或改用「顶部居中 → 右上角」，
+或开「仅 DSH 不在前台时显示」。拖动可以直接改位置（记在 `~/.dsh/dsh-island-pos.json`）。
+
+**换了显示器 / 拔了副屏后胶囊不见了**
+位置会被夹回最近的屏幕工作区，理论上不会跑到屏幕外。真丢了就删 `~/.dsh/dsh-island-pos.json` 重启 DSH。
+
+**改了 `overlay/index.html` 没生效**
+浮层是 DSH 启动时拉起的独立进程，不热重载。改完重启 DSH，或手动 `taskkill` 掉浮层进程（插件 3 秒内会重拉）。
+
+**全屏看视频 / 打游戏时胶囊还在**
+设置里开「全屏应用时自动隐藏」。注意它只认「窗口铺满整块屏幕」，最大化窗口不算全屏。
+少数独占全屏的游戏连置顶窗口都能盖住，这是 Windows 的限制，插件绕不过去。
+
+**多个 DSH 实例会不会叠出两个胶囊**
+不会，浮层有单实例锁，第二个实例直接退出。
+
 
-- **没反应**：确认 `~/.dsh/dsh-island-state.json` 有内容在变（3 秒刷新一次）。没有 → 插件没加载，
-  看 DSH 启动日志，或重新跑一次 `install.ps1`。
-- **有 JSON 没胶囊**：浮层没起来。手动试：
-  `"C:\Users\<你>\AppData\Local\Programs\DeepSeek Harness\DeepSeek Harness.exe" <本目录>\overlay`
-  正常会弹出一条黑色胶囊，控制台有无关紧要的 disk_cache 报错。
-- **胶囊不置顶 / 盖住别人**：Windows 的置顶窗口在少数全屏独占程序（部分游戏）上会被盖住，这是系统限制。
-- **改了 `overlay/index.html` 要重启 DSH**：浮层是启动时拉起的，不热重载。

package/lib/index.js

@@ -167,24 +167,27 @@ export default {
         }
 
         const name = titleOf(session)
+        // since = 这一回合的开始时间，只有 turn/start 能改它。
+        // 以前 approval/asked、approval/decided、tool/call 都把它重置成 now，
+        // 于是「思考 20 分钟 → 弹审批 → 继续思考」的计时会从 0 重新数。
         switch (type) {
           case 'turn/start':
             touch(sid, { state: 'thinking', detail: '', since: Date.now(), title: name })
             break
           case 'approval/asked':
-            touch(sid, { state: 'approval', detail: String(data.toolName || '需要授权'), since: Date.now(), title: name })
+            touch(sid, { state: 'approval', detail: String(data.toolName || '需要授权'), title: name })
             break
           case 'approval/decided':
-            if (items.has(sid)) touch(sid, { state: 'thinking', detail: '', since: Date.now(), title: name })
+            if (items.has(sid)) touch(sid, { state: 'thinking', detail: '', title: name })
             break
           case 'tool/call':
             if (String(data.name || '') === 'ask_user_question') {
-              touch(sid, { state: 'ask', detail: '等待你的回答', since: Date.now(), title: name })
+              touch(sid, { state: 'ask', detail: '等待你的回答', title: name })
             }
             break
           case 'tool/result': {
             const cur = items.get(sid)
-            if (cur && cur.state === 'ask') touch(sid, { state: 'thinking', detail: '', since: Date.now(), title: name })
+            if (cur && cur.state === 'ask') touch(sid, { state: 'thinking', detail: '', title: name })
             break
           }
           case 'turn/end': {

package/overlay/activate.ps1

@@ -1,4 +1,5 @@
 # Bring the DSH main window to the foreground (click-through pill -> click).
+# Fallback path only: the overlay normally sends "activate" over watch.ps1's stdin.
 $ErrorActionPreference = 'SilentlyContinue'
 
 Add-Type -TypeDefinition @"
@@ -7,6 +8,7 @@ using System.Runtime.InteropServices;
 public class IslandFg {
   [DllImport("user32.dll")] public static extern bool SetForegroundWindow(IntPtr h);
   [DllImport("user32.dll")] public static extern bool ShowWindow(IntPtr h, int cmd);
+  [DllImport("user32.dll")] public static extern bool IsIconic(IntPtr h);
   [DllImport("user32.dll")] public static extern void keybd_event(byte vk, byte scan, uint flags, IntPtr extra);
 }
 "@
@@ -20,5 +22,6 @@ if (-not $p) { exit }
 # 先按一下 Alt 骗过前台锁定，再抢焦点
 [IslandFg]::keybd_event(0x12, 0, 0, [IntPtr]::Zero)
 [IslandFg]::keybd_event(0x12, 0, 2, [IntPtr]::Zero)
-[IslandFg]::ShowWindow($p.MainWindowHandle, 9) | Out-Null
+# 只在真最小化时还原。SW_RESTORE 会把最大化窗口缩回普通窗口，就是用户报的「点了变成窗口化」
+if ([IslandFg]::IsIconic($p.MainWindowHandle)) { [IslandFg]::ShowWindow($p.MainWindowHandle, 9) | Out-Null }
 [IslandFg]::SetForegroundWindow($p.MainWindowHandle) | Out-Null

package/overlay/index.html

@@ -150,7 +150,12 @@ function esc(s) {
 
 function fmtTime(sec) {
   sec = Math.max(0, Math.floor(sec))
-  return sec < 60 ? sec + 's' : Math.floor(sec / 60) + 'm' + (sec % 60) + 's'
+  if (sec < 60) return sec + 's'
+  const m = Math.floor(sec / 60)
+  const s = sec % 60
+  if (m < 60) return s ? m + 'm' + s + 's' : m + 'm'
+  const h = Math.floor(m / 60)
+  return m % 60 ? h + 'h' + (m % 60) + 'm' : h + 'h'
 }
 
 function icon(state) {
@@ -202,8 +207,11 @@ function ordered() {
     .sort((a, b) => (RANK[b.state] || 0) - (RANK[a.state] || 0) || (a.since || 0) - (b.since || 0))
 }
 
+const TIMED = { thinking: 1, approval: 1, ask: 1 }
+
 function segHtml(it, primary) {
-  const meta = it.state === 'thinking'
+  // 计时都读 since（= 回合开始），所以「思考 → 审批 → 继续思考」是一条连续的时间轴
+  const meta = TIMED[it.state]
     ? '<span class="meta" data-since="' + (Number(it.since) || Date.now()) + '">' + fmtTime((Date.now() - (Number(it.since) || Date.now())) / 1000) + '</span>'
     : it.state === 'done' ? '<span class="meta">刚刚</span>' : ''
   // 只有主段展开标题，其余段只留图标 + 状态词，避免胶囊被撑爆
@@ -228,6 +236,9 @@ function render() {
     curState = ''
     clearTimeout(shrinkTimer)
     if (tick) { clearInterval(tick); tick = null }
+    // 悬停中被清空时必须把鼠标穿透还回去：窗口本身还在，ignoreMouseEvents=false
+    // 会让它在「看不见」的状态下继续吃掉顶部中间那块区域的点击。
+    if (hovered) { hovered = false; window.islandApi.hover(false) }
     return
   }
 
@@ -235,8 +246,9 @@ function render() {
   const e = cfg.effects || DEFAULTS.effects
   const shown = list.slice(0, MAXSEG)
   const rest = list.length - shown.length
-  // cfg 也进 key：设置页改了缩放/迷你尺寸/动效开关时，items 没变也得重画
-  const key = list.map(it => it.state + it.id + it.since).join(',') + '|' + rest + '|' + JSON.stringify(cfg)
+  // cfg 也进 key：设置页改了缩放/迷你尺寸/动效开关时，items 没变也得重画。
+  // title/detail 同样要进：会话改名、失败原因变化时 since 不变，漏了就不会重绘。
+  const key = list.map(it => it.state + it.id + it.since + '|' + (it.title || '') + '|' + (it.detail || '')).join(',') + '|' + rest + '|' + JSON.stringify(cfg)
   if (key !== curKey) {
     curKey = key
     curState = best.state
@@ -255,9 +267,9 @@ function render() {
     scheduleMini(hovered ? 0 : holdFor(best.state))
   }
 
-  // 只要有思考中的段就跑秒表
-  const anyThinking = list.some(it => it.state === 'thinking')
-  if (anyThinking) {
+  // 只要有一段带计时（思考/审批/等待回答）就跑秒表
+  const anyTimed = list.some(it => TIMED[it.state])
+  if (anyTimed) {
     if (!tick) { paintTimer(); tick = setInterval(paintTimer, 1000) }
   } else if (tick) { clearInterval(tick); tick = null }
 }

package/overlay/main.js

@@ -7,6 +7,7 @@ const { execFile, spawn } = require('child_process')
 const DSH_HOME = process.env.DSH_HOME || path.join(os.homedir(), '.dsh')
 const STATE_FILE = path.join(DSH_HOME, 'dsh-island-state.json')
 const POS_FILE = path.join(DSH_HOME, 'dsh-island-pos.json')
+const CONFIG_FILE = path.join(DSH_HOME, 'dsh-island-config.json')
 const DEAD_MS = 30000
 const LOG_FILE = path.join(DSH_HOME, 'dsh-island-overlay.log')
 
@@ -57,6 +58,20 @@ function savePos() {
   } catch (err) {}
 }
 
+// 拖动 = 切到「自定义位置」。宿主 watchFile 监听同一个配置文件，会立刻把新
+// 配置下发回来（不需要浮层自己刷新界面）。写失败就算了，位置至少本次有效。
+function persistPositionCustom() {
+  try {
+    let cur = {}
+    try { cur = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8')) || {} } catch (err) {}
+    if (cur.position === 'custom') return
+    cur.position = 'custom'
+    const tmp = CONFIG_FILE + '.tmp'
+    fs.writeFileSync(tmp, JSON.stringify(cur, null, 2), 'utf8')
+    fs.renameSync(tmp, CONFIG_FILE)
+  } catch (err) {}
+}
+
 // 窗口比胶囊大一圈：缩放后的胶囊要放得下，还要留出呼吸/涟漪的溢出空间
 function winSize(s) {
   return { w: Math.round(BASE_W * s), h: Math.round(BASE_H * s) }
@@ -113,15 +128,27 @@ function create() {
   win.setIgnoreMouseEvents(true, { forward: true })
   win.loadFile(path.join(__dirname, 'index.html'))
   win.once('ready-to-show', () => win.showInactive())
+  // 首帧会丢：tick() 在页面还没加载完时就把状态 send 出去了（被丢弃），
+  // 而 last 已经记下，之后状态不再变化就一直不重发 —— 结果是浮层起来了却空白。
+  // 页面加载完清掉 last，让下一次 tick 无条件重发。
+  win.webContents.on('did-finish-load', () => { last = '' })
 
   // 诊断：之前浮层会莫名其妙消失且日志里什么都没留下，这里把每种死法都记下来
-  win.webContents.on('render-process-gone', (_e, d) => log('render-process-gone: ' + JSON.stringify(d)))
+  let reloads = 0
+  win.webContents.on('render-process-gone', (_e, d) => {
+    log('render-process-gone: ' + JSON.stringify(d))
+    // 渲染进程挂了窗口会留在那但永远空白。重载一次；连续崩就退出，
+    // 让插件的 3 秒心跳重新拉起一个干净进程，而不是卡在空白窗口上。
+    if (reloads++ < 2) setTimeout(() => { try { win.reload() } catch (err) {} }, 1000)
+    else { log('quit: renderer keeps dying'); app.quit() }
+  })
   win.webContents.on('unresponsive', () => log('unresponsive'))
   win.webContents.on('responsive', () => log('responsive'))
   app.on('child-process-gone', (_e, d) => log('child-process-gone: ' + JSON.stringify(d)))
   win.on('hide', () => log('window hidden'))
   win.on('show', () => log('window shown'))
-  win.on('closed', () => log('window closed'))
+  // 窗口被关掉但进程还在 = 不会再有任何界面；直接退出让宿主重新拉起
+  win.on('closed', () => { log('window closed'); app.quit() })
 
   // 别的置顶窗口偶尔会把我们压下去，定期重新抬一次
   setInterval(() => {
@@ -276,6 +303,9 @@ ipcMain.on('drag-end', () => {
   if (!dragOrigin) return
   dragOrigin = null
   savePos()
+  // 只写 pos.json 没用：place() 只在 position==='custom' 时才读它，
+  // 所以拖完重启又回到顶部居中。这里把配置切成 custom（宿主 watchFile 会接住）。
+  persistPositionCustom()
 })
 
 app.whenReady().then(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-island-overlay",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "type": "module",
   "main": "lib/index.js",
   "exports": {