dsh-qiyu-stack 0.15.4 → 0.15.5

package/docs/status.md

@@ -6,10 +6,38 @@
 
 **能用了，也发出去了，但还没被陌生人在干净机器上验证过。**
 
-- npm：`dsh-qiyu-stack@0.15.3`（`latest`），`npx dsh-qiyu-stack preflight --json` 实测可跑
+- npm：`dsh-qiyu-stack@0.15.5`（`latest`）
 - GitHub：<https://github.com/aesfls/dsh-qiyu-stack>（公开，main）
 - 千语（爸爸本人的实例）：正常运行中，桥、NapCat、Docker 都通
 
+## 2026-10-23 第四轮：验收命令也补上沙箱降级（v0.15.5）
+
+第三轮只修了 `preflight`，**验收命令 `doctor` 漏了**——在 workspace-write 下它照样报
+「装了 Docker，但引擎没起来」，`有失败: true`。而 AGENTS.md 写的验收标准是「不通必须为 0」，
+陌生人跑验收会永远看到 1 个失败。0.15.5 补上：
+
+1. `doctor` 接 `沙箱受限过()`：Docker / 容器 / 端口相关的 fail 降级成 `warn`，
+   标题加「沙箱限制，这条不可信」，并附一句「去用户终端或提权再验」
+2. `qr.mjs` 的 `docker cp` 改走 `跑()`（原来直连 `execFileSync`，沙箱里会假失败「拿不到二维码」）
+
+## 2026-10-23 第三轮：沙箱假阴性（重要）
+
+另一个会话在**默认沙箱**（workspace-write）里实测发现：`preflight` 报「这台机器上没有 Docker」，
+可机器上 Docker 装着、容器还在跑。
+
+**根因**（平台文档写明）：受限沙箱不允许程序开命名管道，所以任何
+`execFile/spawn` 抓输出（`stdio: 'pipe'`）都会 `EPERM`。而 qiyu 的每个 `跑()` 都靠抓输出，
+于是所有判断变成假阴性——这是 agent 路径上最危险的一类 bug，会让 agent 去让用户装一个已经装好的东西。
+
+**修法（v0.15.4）**：
+
+1. 新增 `src/run.mjs`：先试管道，`EPERM/EACCES/EPIPE` 时**改走「重定向到临时文件再读」**
+   （沙箱允许写工作区），并把这次运行标记为「沙箱受限过」
+2. `preflight` 在受限时**把 Docker/端口/Python 这类 fail 降级成 `warn`**，
+   标题加「沙箱限制，这条不可信」，并明确告诉 agent：别让用户重装，去他自己的终端或提权再验
+3. `AGENTS.md` 专门加了一节讲这个坑
+4. `AGENTS.md` 已进 npm 包（`files` 字段，0.15.4 起 80 个文件）
+
 ## 2026-10-23 第二轮补的（agent 入口）
 
 一个陌生人会话实测后提的问题，采纳了三条：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-qiyu-stack",
-  "version": "0.15.4",
+  "version": "0.15.5",
   "description": "栖语栈：让一个智能体住进 QQ —— QQ 双向桥、长期记忆、心情、语音、作息，以及把 NapCat 部署这件事一次做对",
   "type": "module",
   "bin": {

package/src/doctor.mjs

@@ -9,7 +9,7 @@ import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs'
 import { join, dirname, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { 读配置 } from './config.mjs'
-import { 跑 } from './run.mjs'
+import { 跑, 沙箱受限过 } from './run.mjs'
 
 const 包根 = join(dirname(fileURLToPath(import.meta.url)), '..')
 
@@ -284,6 +284,33 @@ export async function doctor({ 只输出JSON = false, 跳过WebSocket = false }
     记('skip', '跳过模板体检', String(错.message || 错))
   }
 
+  // ---------- 沙箱兜底：读不到子进程输出时，别把「没装/没起」当成事实 ----------
+  //
+  // 受限沙箱不允许程序开管道，所有"跑条命令看输出"的判断都可能拿到空结果。
+  // 这时把 Docker / 容器 / 端口相关的 fail 降级成 warn——否则 agent 会把
+  // 「验收标准：不通必须为 0」理解成"装失败了"，去修一台根本没坏的机器。
+  if (沙箱受限过()) {
+    let 降级了 = 0
+    for (const x of 结果) {
+      if (x.级别 !== 'fail') continue
+      if (!/Docker|引擎|容器|端口/.test(x.标题)) continue
+      x.级别 = 'warn'
+      x.标题 = '沙箱限制，这条不可信：' + x.标题
+      x.怎么修 = '在用户自己的终端里跑 qiyu doctor 再确认一次；或者把这次会话提到 danger-full-access'
+      降级了++
+    }
+    if (降级了) {
+      结果.push({
+        级别: 'warn',
+        标题: '当前沙箱读不到子进程输出',
+        依据:
+          '受限沙箱不允许程序开管道（stdio: pipe 会 EPERM）。qiyu 已改用"重定向到文件再读"兜底，' +
+          '但个别命令仍可能失败，上面 ' + 降级了 + ' 条结论已降级。',
+        怎么修: '这类结论不能当真：让用户在自己终端跑一遍，或把会话权限提到 danger-full-access',
+      })
+    }
+  }
+
   // ---------- 输出 ----------
   const 有失败 = 结果.some((x) => x.级别 === 'fail')
 

package/src/qr.mjs

@@ -2,10 +2,11 @@
 //
 // 约定：需要用户扫码时，不能只给一个路径（用户还得自己去找文件）。
 // 一律「复制出来 + 用系统默认看图程序打开 + 在终端里说清什么时候过期」。
-import { execFileSync, spawn } from 'node:child_process'
+import { spawn } from 'node:child_process'
 import { resolve } from 'node:path'
 import { statSync } from 'node:fs'
 import { 读配置 } from './config.mjs'
+import { 跑 } from './run.mjs'
 
 export function 打开文件(路径) {
   try {
@@ -47,15 +48,11 @@ export async function qr() {
 
   const 目标 = resolve(process.cwd(), 'napcat-qrcode.png')
 
-  try {
-    execFileSync('docker', ['cp', `${配置.napcat.container}:/app/napcat/cache/qrcode.png`, 目标], {
-      encoding: 'utf8',
-      windowsHide: true,
-      timeout: 15000,
-      stdio: ['ignore', 'pipe', 'pipe'],
-    })
-  } catch (错) {
-    console.error('拿不到二维码：' + String((错 && (错.stderr || 错.message)) || 错).trim().slice(0, 200))
+  // 走 run.mjs：受限沙箱里 execFileSync 抓管道会 EPERM，
+  // 它会自动改成「重定向到临时文件再读」，不然会误报「拿不到二维码」。
+  const 复制 = 跑('docker', ['cp', `${配置.napcat.container}:/app/napcat/cache/qrcode.png`, 目标], 15000)
+  if (!复制.ok) {
+    console.error('拿不到二维码：' + String(复制.错 || 'docker cp 失败').trim().slice(0, 200))
     console.error('')
     console.error('可能的原因：')
     console.error('  · 容器没起 —— 跑 qiyu doctor 看看')