dsh-mini-remote 0.1.3 → 0.1.5

package/lib/pairing.js

@@ -16,8 +16,13 @@ const HINTS = {
   // 有两条来源，只有 Tailscale 那条依赖手机上的 MagicDNS**——公网隧道用的是
   // Cloudflare 的域名，谁都能解析。所以手机上 Tailscale 的 DNS 设置没开的用户，
   // 想要加密连接应该走这一条，而原来的说明里完全没告诉他这一点。
-  public: '不用装任何东西，出门在外也能用，而且它也是加密的——浏览器肯不肯给用通知和'
-    + '麦克风看的就是这个。刚打开时等半分钟再扫；地址每次重启 DSH 会换',
+  //
+  // 2026-09-27 改口径：原来这里写的是「浏览器肯不肯给用通知和麦克风看的就是这个」，
+  // 那两样我们**都没有实现**（系统通知 2026-09-25 起入口就是藏着的，麦克风图标也已
+  // 移除，两条都有测试钉着"别再被加回来"）。拿没实现的功能当理由，是把用户往一个
+  // 不存在的东西上引。加密本身成立，就只说加密——**别再改回去**。
+  public: '不用装任何东西，出门在外也能用，而且它也是加密的（地址栏上会出现 https 那把锁）。'
+    + '刚打开时等半分钟再扫；地址每次重启 DSH 会换',
   // 这条和上面那条 Tailscale 是**同一台电脑、同一个服务**，区别只在连接加不加密。
   // 说清楚「加密能换来什么」——不然用户看不出两条码为什么要并存。
   //
@@ -38,8 +43,10 @@ const HINTS = {
   // 2026-09-25 用户实测走通了：他手机上装的正是 MeshArc，**换成官方客户端之后
   // 那条加密地址就打开了**。所以这一句要给出真正的解法——换客户端，而不是绕开。
   // 原来只写了「用不了就换别的路」，那是在绕，不是在解决。
-  'tailscale-https': '出门在外也能用，而且连接是加密的——手机浏览器只在加密连接上才肯给用'
-    + '通知和麦克风。手机上的 Tailscale 得能解析你这个网络的域名：HarmonyOS 上的第三方'
+  // 2026-09-27 改口径（原因同上一条 public）：不再拿"手机浏览器只在加密连接上才肯给用
+  // 通知和麦克风"当理由——那两样都没实现。加密本身是实打实的好处，就只说加密。
+  'tailscale-https': '出门在外也能用，而且连接是加密的（地址栏上会出现 https 那把锁）。'
+    + '手机上的 Tailscale 得能解析你这个网络的域名：HarmonyOS 上的第三方'
     + '客户端（MeshArc）不支持这一点，换成官方客户端就能用。实在换不了，就退到上面那条'
     + '明文的（它用 IP，不需要解析），或者开公网隧道那条（它也是加密的，不挑手机）',
 }

package/lib/serve.js

@@ -1,9 +1,16 @@
 /**
  * 用 Tailscale 自带的 HTTPS 地址，把本机服务暴露给 tailnet。
  *
- * 为什么值得做：手机端有三样东西被明文 http 挡着——完成后提醒（系统通知）、
- * 语音输入（麦克风）、剪贴板的完整能力。浏览器规定，非安全上下文一律不给用。
- * Tailscale 的 serve 给的是 Let's Encrypt 签的真证书，浏览器认。
+ * 为什么值得做：浏览器只有在安全上下文（https）下才肯把完整能力交出来，明文 http
+ * 一律打折——这正是当初做这条路的理由。Tailscale 的 serve 给的是 Let's Encrypt 签的
+ * 真证书，浏览器认。
+ *
+ * **2026-09-27 修正这段自述**：原来这里写的是"三样东西被明文 http 挡着——完成后提醒
+ * （系统通知）、语音输入（麦克风）、剪贴板的完整能力"。后来其中两样**都没有真正落地**：
+ * 系统通知 2026-09-25 起入口一直藏着（锁屏会冻结后台页面，试到底的结论是这条路走不通），
+ * 麦克风图标也已移除，两条都有测试钉着"别再被加回来"。如今真正成立的只有"连接加密"
+ * 这一条（剪贴板另有 execCommand 退路，明文下也能用，只是不那么顺）。所以对用户说话时
+ * 只讲加密，**别再拿通知和麦克风当理由**（见 lib/pairing.js 里那两条提示的注释）。
  *
  * **这不是新的一条路，是 Tailscale 那条路上的一个升级。** 原来的
  * `http://100.92.105.99:3090` 照旧能用，这里多给一个

package/lib/server.js

@@ -237,7 +237,8 @@ export async function createMiniServer({ store, config, token, bindAddresses, tu
         if (watch) clearInterval(watch)
         resolve(value)
       }
-      waitingQuestions.set(id, { settle })
+      // 题目本身也存进来（不只是 settle）：手机中途重连上来时要能补发给它，见 replayQuestions。
+      waitingQuestions.set(id, { settle, agentId, questions })
       broadcast('question', { id, agentId, questions })
       // 用户选的是「一直等，不还回电脑」——但那不等于「手机都没了还等」。
       // 手机一旦全断开（锁屏、关了页面、网断），立刻收摊还给电脑，否则会永远卡住。
@@ -247,6 +248,27 @@ export async function createMiniServer({ store, config, token, bindAddresses, tu
     })
   }
 
+  /**
+   * 把正在等的题补发给**刚连上来的那一个**连接。
+   *
+   * 题目只在上面推一次，没有第二次。可手机这一端并不总是接着：
+   * 页面正在重连、锁屏醒来刚接上、切了个网络——那一下就错过了，而电脑那边还在等，
+   * 手机上却什么都看不见（2026-09-27 用户报的「电脑弹了选项、手机上什么都没有」，
+   * 有这一类情形在里面）。所以新连接一进来就把还在等的题发给它。
+   *
+   * **只发这一个新连接，不重播给所有人**：已经在看的那个手机可能已经勾好了选项，
+   * 再推一次会把它的勾清掉。
+   */
+  function replayQuestions(res) {
+    for (const [id, entry] of waitingQuestions) {
+      try {
+        res.write(`event: question\ndata: ${JSON.stringify({ id, agentId: entry.agentId, questions: entry.questions })}\n\n`)
+      } catch {
+        return
+      }
+    }
+  }
+
   // 把这两个能力放到插件够得着的固定位置（见文件上方 `miniControl` 的说明）。
   // 放在这里是因为它俩都已定义（函数声明本来也会提升），且不受下面那堆路由逻辑影响。
   miniControl.hasPhone = hasPhone
@@ -427,6 +449,9 @@ export async function createMiniServer({ store, config, token, bindAddresses, tu
       })
       res.write(': connected\n\n')
       clients.add(res)
+      // 留痕：手机连没连上、一共有几台，就看这一句。2026-09-27 测自言自语的这天
+      // 正是卡在这儿——「她怎么没说话」和「手机压根没连上」当时根本分不开。
+      console.log(`[dsh-mini-remote] 手机连上了，现在连着 ${clients.size} 台`)
 
       const beat = setInterval(() => {
         try {
@@ -441,13 +466,21 @@ export async function createMiniServer({ store, config, token, bindAddresses, tu
       // 连上就先补一次全量状态，手机刷新后不用再单独拉一次。
       res.write(`event: state\ndata: ${JSON.stringify(store.snapshot())}\n\n`)
 
+      // 接着把还在等手机回答的题补给它——重连上来的那一下最容易错过（见 replayQuestions）。
+      replayQuestions(res)
+
       // 顺带把这个会话的完整历史准备好：手机上「刷新一下就只剩重启之后的事」
       // 就是这么来的（手里那份只有插件在场时看见的）。读完会再广播一份快照。
       onSessionOpened?.(store.snapshot().boundSessionId)
 
+      // 断开只记一次：req 和 res 各会 close 一次，不挡一下就会打两遍（含义却相反）。
+      let said = false
       const cleanup = () => {
+        if (said) return
+        said = true
         clearInterval(beat)
         clients.delete(res)
+        console.log(`[dsh-mini-remote] 手机断开了，还剩 ${clients.size} 台`)
       }
       req.on('close', cleanup)
       res.on('close', cleanup)
@@ -628,6 +661,9 @@ export async function createMiniServer({ store, config, token, bindAddresses, tu
       const waiting = waitingQuestions.get(body?.id)
       if (!waiting) {
         // 409 而不是 200：多半是这个提问早就结束了，如实说，别装作收下了。
+        // 落一句痕：这是「手机答了、电脑没动静」唯一能查到的线索——手机那边原来
+        // 把失败咽掉了，插件这边再不留痕，下次还是只能靠猜（2026-09-27）。
+        console.log('[dsh-mini-remote] 手机上答晚了：这道题已经交回电脑（' + String(body?.id) + '），没接')
         sendJson(res, 409, { ok: false, error: '这个提问已经结束了。' })
         return
       }

package/lib/store.js

@@ -33,6 +33,14 @@ export function createStore({ file, maxHistory = 50, maxSessions = 12 }) {
      * 任何一条广播都能把它补上。
      */
     liveBySession: {},
+    /**
+     * 模型此刻的「自言自语」：sessionId -> { text, at }。**同样故意不落盘**。
+     *
+     * 只给手机上的鲸鱼娘当台词用，和 latest/history 完全分开——它既不是回答，
+     * 也不是历史的一部分（历史有 50 条上限，思考会把它挤爆）。一轮结束就清掉，
+     * 所以刷新页面看到的是「当前这一句」，而不是上一次的残留。
+     */
+    thoughtBySession: {},
   }
 
   /** 已知会话的元信息：sessionId -> { id, title, running, lastActivity, seq } */
@@ -170,6 +178,18 @@ export function createStore({ file, maxHistory = 50, maxSessions = 12 }) {
     return sessionId ? (state.liveBySession[sessionId] ?? '') : ''
   }
 
+  /**
+   * 模型此刻的自言自语（鲸鱼娘的台词）。
+   *
+   * 和 live 分开存，**不是为了整齐**：页面上的鲸鱼娘只要发现 live 非空就会整块让位
+   * （那是「正在流出来的回答」的规矩），把思考塞进 live 会让该出现台词的时候鲸鱼娘
+   * 直接消失。
+   */
+  function thoughtOf(sessionId) {
+    const t = sessionId ? state.thoughtBySession[sessionId] : null
+    return t ? { text: t.text, at: t.at } : null
+  }
+
   /**
    * 只保留最近碰过的若干会话的数据，免得这个 JSON 文件无限长大。
    * 被丢掉的会话切过去会显示「还没有回复」——**这比显示别人的回答强**。
@@ -182,6 +202,7 @@ export function createStore({ file, maxHistory = 50, maxSessions = 12 }) {
       delete state.historyBySession[id]
       delete state.latestBySession[id]
       delete state.liveBySession[id]
+      delete state.thoughtBySession[id]
     }
   }
 
@@ -297,24 +318,33 @@ export function createStore({ file, maxHistory = 50, maxSessions = 12 }) {
      * interrupted 是「这一轮被中止了，下面只是已经吐出来的那半句」。
      * 手机要把它标出来——不标的话，按了停止之后冒出来的半句话看着像模型答崩了。
      */
-    pushReply({ text, sessionId, reason, interrupted }) {
-      const timestamp = Date.now()
+    pushReply({ text, sessionId, reason, interrupted, timestamp }) {
+      // 同上：事件带过来的 `time` 优先。合成时两边的钟不一样，同一条回复就会
+      // 既从硬盘来一遍、又从手里这份来一遍，手机上显示两遍。
+      const at = timestamp ?? Date.now()
       const session = sessions.get(sessionId)
       state.latestBySession[sessionId] = {
-        text, sessionId, title: session?.title ?? '', timestamp, reason,
+        text, sessionId, title: session?.title ?? '', timestamp: at, reason,
         interrupted: interrupted === true,
       }
       pushHistory(sessionId, {
-        role: 'assistant', text, timestamp, sessionId, interrupted: interrupted === true,
+        role: 'assistant', text, timestamp: at, sessionId, interrupted: interrupted === true,
       })
       persist()
     },
 
     /** 用户（手机上或电脑上）发出了一条指令。 */
-    pushUser({ text, sessionId, id }) {
+    pushUser({ text, sessionId, id, timestamp }) {
       // id 要留着：排队中的指令靠它和 agent 收件箱里的那一条对上号，
       // 界面上才能标出「这条还在排队」、也才能撤掉它。
-      pushHistory(sessionId, { role: 'user', text, timestamp: Date.now(), sessionId, id })
+      //
+      // 时间戳要是有事件带过来的那个 `time`，就用它，别用 Date.now()——理由和
+      // pushCommand 那段一模一样：这一条要和硬盘重放出来的那份按时间戳合成，
+      // **两边得是同一个钟**。差一毫秒就够它被当成「新的一条」再接一遍，手机上
+      // 同一条指令显示两遍（2026-09-27 用户实机报的，实测两份差 1 毫秒）。
+      pushHistory(sessionId, {
+        role: 'user', text, timestamp: timestamp ?? Date.now(), sessionId, id,
+      })
       persist()
     },
 
@@ -389,6 +419,20 @@ export function createStore({ file, maxHistory = 50, maxSessions = 12 }) {
       else delete state.liveBySession[sessionId]
     },
 
+    /**
+     * 记下模型此刻的自言自语，给鲸鱼娘当台词。传 null 就是「没话说了」，清掉。
+     *
+     * 同样不 persist()：它活不过一轮，写盘只会留下一句没头没尾的旧台词。
+     */
+    setThought(sessionId, thought) {
+      if (!sessionId) return
+      if (thought && thought.text) {
+        state.thoughtBySession[sessionId] = { text: thought.text, at: thought.at ?? Date.now() }
+      } else {
+        delete state.thoughtBySession[sessionId]
+      }
+    },
+
     /** 手机是否真的在看着——决定要不要额外发系统推送。 */
     isForeground() {
       return state.presence === 'foreground' && Date.now() - state.lastSeen < 60_000
@@ -436,6 +480,13 @@ export function createStore({ file, maxHistory = 50, maxSessions = 12 }) {
          * 当成答案——真正的答案还是要等不含工具调用的那一步落定（见 events.js）。
          */
         live: liveOf(target),
+        /**
+         * 模型此刻的自言自语（鲸鱼娘的气泡台词），没有就是 null。
+         *
+         * **第三次重申它的边界**：这不是回答、不进历史、不参与「有没有新回复」的
+         * 判断。哪怕它错乱到显示了上一句，代价也只是气泡里一句话旧了。
+         */
+        thought: thoughtOf(target),
         boundSessionId: state.boundSessionId,
         /**
          * 「正在执行」必须跟着会话走。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mini-remote",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "DSH 极简移动端遥控器：只把「你的指令」和「AI 的最终回复」送到手机，屏蔽全部中间过程。",
   "type": "module",
   "main": "lib/index.js",
@@ -36,13 +36,21 @@
     "url": "https://github.com/xingzhen199186/dsh-mini-remote/issues"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh": ">=0.1.5-rc.2 <0.2.0",
+    "@deepseek-ai/schemastery": "^3.18.3"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {
       "optional": true
+    },
+    "@deepseek-ai/dsh": {
+      "optional": true
     }
   },
+  "devDependencies": {
+    "@deepseek-ai/schemastery": "^3.18.3"
+  },
   "keywords": [
     "deepseek-harness",
     "dsh",