kinstra-neko 1.0.0 → 1.0.1

package/README.md

@@ -89,14 +89,17 @@ irm https://raw.githubusercontent.com/EROQIN/kinstra-neko/main/installer/windows
 
 ### 🧑‍💻 已有 Node 环境，只想装插件
 
+DSH 是 pnpm 生态（依赖多为 alpha 预发布版本，npm 的严格 peer 校验会报 ERESOLVE），请用 pnpm：
+
 ```bash
-npx kinstra-neko@latest init          # 建 profile、装 bundle、引导写凭据
-dsh --profile kinstra-neko web --port 3090
+npm i -g pnpm                      # 若还没有 pnpm
+pnpm dlx kinstra-neko@latest init  # 建 profile、装 bundle、引导写凭据
+dsh --profile kinstra-neko --port 3090   # 控制台会自动打开带一次性 token 的页面
 ```
 
 ### 装完之后 · 3 分钟向导
 
-1. 浏览器打开 `http://127.0.0.1:3090`（云服务器用 `http://<IP>:3090`，注意安全组放行）。
+1. 打开控制台：Windows 双击桌面图标会自动用带一次性 token 的链接打开；Linux 服务器从安装结尾输出或 `journalctl -u kinstra-neko -n 30 | grep -o 'http://.*token=.*' | tail -1` 取带 token 的地址（裸 `http://<IP>:3090` 会被令牌门挡住，云服务器记得安全组放行 3090）。
 2. 按向导填：**猫娘小号 QQ**、**你的 QQ（主人）**。
 3. 在「连接」页点「生成 OneBot 配置」再点「启动 NapCat」，用猫娘小号扫弹出窗口里的二维码登录；插件会自动核对登录号与配置是否一致。
 4. 在 DSH 设置里配置模型服务商与 API Key（DeepSeek 官方或任意 OpenAI 兼容端点）。
@@ -219,7 +222,7 @@ npm run build                      # tsdown 双入口：lib/index.js + lib/clien
 # 装进本地 DSH 调试：
 dsh kinstra-neko --from-default-profile web --dump-config >/dev/null   # 仅首次
 dsh plugin --profile kinstra-neko add "link:$PWD"
-dsh --profile kinstra-neko web --port 3090
+dsh --profile kinstra-neko --port 3090   # 控制台会自动打开带一次性 token 的页面
 ```
 
 无真实 QQ 环境时，决策、消息解析、记忆、回复拆条均为纯函数，直接跑单测即可；

package/installer/bin/kinstra-neko-init.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // Kinstra Neko 初始化器：创建独立 DSH profile、装入猫娘 bundle、引导最小配置。
 // 用法：
-//   npx kinstra-neko init                 # 从 npm 装插件
+//   pnpm dlx kinstra-neko init            # 从 npm 装插件（推荐；npm/npx 会因 alpha 严格 peer 报 ERESOLVE）
 //   node kinstra-neko-init.mjs init --link /path/to/kinstra-neko   # 开发/离线本地装
 //   node kinstra-neko-init.mjs doctor     # 环境自检
 //   node kinstra-neko-init.mjs set-napcat-dir <NapCat Shell 目录>  # 安装器种协议端目录
@@ -157,7 +157,7 @@ function cmdInit(options) {
   console.log()
   say('初始化完成！接下来：')
   console.log(`  1. 确保 QQ 协议端在跑（NapCat：先执行平台安装脚本；或自行准备 OneBot v11）`)
-  console.log(`  2. 启动控制台：  ${c.bold}dsh --profile ${PROFILE} web --port ${port}${c.reset}`)
+  console.log(`  2. 启动控制台：  ${c.bold}dsh --profile ${PROFILE} --port ${port} --no-open${c.reset}`)
   console.log(`  3. 浏览器打开 http://127.0.0.1:${port} ，按猫娘向导填小号 QQ、你的 QQ、白名单`)
   console.log(`     默认是试运行：她只会在面板记录“本来会说什么”，确认对味后再关试运行\n`)
 }

package/installer/linux/install.sh

@@ -6,7 +6,7 @@
 #   2. Node.js 22（缺失时用 NodeSource；国内可用 CN_MIRROR=1 走镜像）
 #   3. 全局安装 DeepSeek Harness
 #   4. 调 kinstra-neko init 建 profile、装猫娘 bundle
-#   5. 装 NapCat（官方 NapCat-Installer；无桌面环境自动配 Xvfb+x11vnc 扫码）并生成 OneBot 配置
+#   5. 装 NapCat（官方 NapCat-Installer · rootless Shell：Xvfb 里跑 QQNT，扫码走 NapCat 内置 WebUI）并生成 OneBot 配置
 #   6. 注册 systemd 服务 kinstra-neko（开机自启、崩溃重启、Node 内存上限）
 #
 # 用法：
@@ -14,13 +14,19 @@
 #   # 或下载后：sudo CN_MIRROR=1 bash install.sh
 #
 # 可覆盖变量：DSH_VERSION、KINSTRA_NEKO_SPEC（本地/自定义插件源）、WEB_PORT（默认 3090）、
-#             NAPCAT_INSTALL_URL、SKIP_NAPCAT=1
+#             WEB_HOST（默认主网卡 IP 供远程访问；设 127.0.0.1 只本机）、
+#             NAPCAT_INSTALL_URL、NAPCAT_PROXY（官方脚本 GitHub 加速选项，0=直连；默认 0）、SKIP_NAPCAT=1
 
 set -euo pipefail
 
 WEB_PORT="${WEB_PORT:-3090}"
+# 远程（云服务器）浏览器访问需绑到网卡上的具体 IP（DSH 拒绝 0.0.0.0 通配）。
+# 默认取主网卡首个 IPv4；只想本机访问可 WEB_HOST=127.0.0.1。
+WEB_HOST="${WEB_HOST:-$(hostname -I 2>/dev/null | awk '{print $1}')}"
 DSH_VERSION="${DSH_VERSION:-0.2.1-rc.3}"
-NAPCAT_INSTALL_URL="${NAPCAT_INSTALL_URL:-https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh}"
+# 官方脚本源在 GitHub（NapNeko/NapCat-Installer）；旧默认域名 nclatest.znin.net 已不可达，可用 NAPCAT_INSTALL_URL 覆盖。
+NAPCAT_INSTALL_URL="${NAPCAT_INSTALL_URL:-https://raw.githubusercontent.com/NapNeko/NapCat-Installer/main/script/install.sh}"
+NAPCAT_PROXY="${NAPCAT_PROXY:-0}"
 RUN_USER="${SUDO_USER:-$USER}"
 RUN_HOME="$(eval echo "~$RUN_USER")"
 
@@ -83,54 +89,106 @@ if [ "$need_node" = 1 ]; then
 fi
 
 # ---------- 3. DSH ----------
-if ! su - "$RUN_USER" -c 'command -v dsh' >/dev/null 2>&1; then
+# 系统级 node（NodeSource）的全局 prefix 是 /usr，/usr/lib/node_modules 归 root，
+# 因此全局包必须以 root 身份装（bin 链到 /usr/bin/dsh，普通用户也能调用）。
+# 切勿 su 到普通用户执行 npm -g：写不进 root 目录会 EACCES。
+if ! command -v dsh >/dev/null 2>&1; then
   say "全局安装 DeepSeek Harness @$DSH_VERSION…"
-  su - "$RUN_USER" -c "npm install -g @deepseek-ai/dsh@$DSH_VERSION --no-audit --no-fund"
+  npm install -g "@deepseek-ai/dsh@$DSH_VERSION" --no-audit --no-fund
 fi
-ok "DSH：$(su - "$RUN_USER" -c 'dsh --version' 2>/dev/null || echo 已安装)"
+ok "DSH：$(dsh --version 2>/dev/null || echo 已安装)"
+
+# pnpm：DSH 的 `dsh plugin add` 用 pnpm 装插件，且本生态全是 alpha 预发布版本，
+# npm 的严格 peer 解析会因版本范围（精确 alpha vs ~x.y.z）报 ERESOLVE，pnpm 只告警不阻断。
+if ! command -v pnpm >/dev/null 2>&1; then
+  say '安装 pnpm（DSH 插件管理器依赖）…'
+  npm install -g pnpm --no-audit --no-fund
+fi
+ok "pnpm $(pnpm -v)"
 
 # ---------- 4. Kinstra Neko 插件 ----------
 say '初始化 Kinstra Neko profile 与插件…'
 INIT_ARGS='init'
 [ -n "${KINSTRA_NEKO_SPEC:-}" ] && INIT_ARGS="init --link $KINSTRA_NEKO_SPEC"
-su - "$RUN_USER" -c "DSH_VERSION=$DSH_VERSION npx -y kinstra-neko@latest $INIT_ARGS </dev/tty" || \
+# init 的 stdin 一律接 /dev/null：唯一交互是可跳过的模型 API Key（EOF 自动取空），
+# 密钥本就改在装完后的面板向导里填，curl|bash 过程中不该卡在输入。
+# 切勿在此重定向 /dev/tty：root 脚本里探测到的控制终端，在 `su - <user>` 经 PAM/setsid
+# 起 login shell 后可能已不可达（交互式 ssh 下 curl|sudo bash 必现），反而让整条 su 失败。
+su - "$RUN_USER" -c "DSH_VERSION=$DSH_VERSION pnpm dlx kinstra-neko@latest $INIT_ARGS </dev/null" || \
   die '插件初始化失败（网络问题可重试；开发版可设 KINSTRA_NEKO_SPEC=本地目录）'
 ok '猫娘插件已装入 profile'
 
 # ---------- 5. NapCat（可跳过）----------
+# 真机确认的官方 NapCat Shell(rootless) 布局（NapCat-Installer --docker n）：
+#   $RUN_HOME/Napcat/opt/QQ/qq                                 QQNT 可执行
+#   $RUN_HOME/Napcat/opt/QQ/resources/app/app_launcher/napcat/ NapCat 插件目录（config/ 在此）
+# 启动是 `xvfb-run -a <qq> --no-sandbox`（无头自动起 Xvfb）；官方【不】注册 systemd 服务、
+# 也【不】装 x11vnc，headless 扫码走 NapCat 内置 WebUI（首启后 config/webui.json 出 token，默认 6099）。
 if [ "${SKIP_NAPCAT:-0}" != 1 ]; then
-  say '安装 NapCat（官方安装器；无桌面环境会配 Xvfb + x11vnc 供扫码）…'
-  if [ "${CN_MIRROR:-0}" = 1 ]; then
-    warn '国内镜像模式：NapCat 官方脚本从 GitHub 拉取，如缓慢可稍后手动执行其安装指引'
+  NAPCAT_HOME="$RUN_HOME/Napcat"
+  NAPCAT_QQ="$NAPCAT_HOME/opt/QQ"
+  NAPCAT_DIR="$NAPCAT_QQ/resources/app/app_launcher/napcat"   # config 与 run-napcat.sh 所在，种给插件
+  NAPCAT_QQ_BIN="$NAPCAT_QQ/qq"
+
+  if [ -x "$NAPCAT_QQ_BIN" ] && [ -f "$NAPCAT_DIR/napcat.mjs" ]; then
+    # 幂等：已装好就别再下载/重跑官方安装器（重跑几百 MB 且易因 /tmp 残留触发 curl 写错误）。
+    ok "NapCat 已安装：$NAPCAT_HOME（跳过官方安装器）"
+  else
+    say '安装 NapCat（官方 NapCat-Installer · rootless Shell：QQNT + NapCat + Xvfb，约几百 MB）…'
+    # 下到唯一临时文件再执行：curl -o 直接覆盖一个属主为普通用户的 /tmp 残留会报 write error 23
+    # （真机实测），mktemp 新文件可规避；下载失败只跳过 NapCat、不阻断已就绪的核心服务。
+    napcat_inst="$(mktemp /tmp/napcat-installer.XXXXXX.sh)"
+    # --retry 让瞬态网络/写错误就地自愈（curl 23 在真机出现过一次），尽量一次装成；
+    # 最终仍失败才降级为跳过 NapCat，不阻断核心控制台。
+    if curl -fsSL --retry 3 --retry-delay 2 --connect-timeout 20 "$NAPCAT_INSTALL_URL" -o "$napcat_inst"; then
+      # 以 root 跑（apt 装 Xvfb/依赖免密），但 HOME 指向普通用户家目录：rootless 安装器按
+      # $HOME/Napcat 落文件，这样 QQ/NapCat 落在运行用户名下；后面再 chown 兜底归属。
+      # 显式参数跳过交互菜单：--docker n 走 Shell、--cli y 装 napcat 命令、--proxy 直连。
+      HOME="$RUN_HOME" bash "$napcat_inst" --docker n --cli y --proxy "$NAPCAT_PROXY" \
+        || warn 'NapCat 安装器返回非零（多为网络/版本差异）。可稍后重跑本脚本，或面板「连接」改接任意 OneBot v11。'
+    else
+      warn "下载 NapCat 官方安装器失败（网络受限可设 NAPCAT_INSTALL_URL 指向可达镜像）。跳过 NapCat，核心控制台仍可用。"
+    fi
+    rm -f "$napcat_inst"
   fi
-  curl -fsSL "$NAPCAT_INSTALL_URL" -o /tmp/napcat-install.sh
-  # 官方脚本通常支持 sudo bash napcat.sh；交互项尽量走默认（它会处理 QQ/Xvfb/systemd）
-  bash /tmp/napcat-install.sh || warn 'NapCat 安装器返回非零（版本差异）。可稍后手动安装，或在面板「连接」里改接任意 OneBot。'
-
-  NAPCAT_DIR="${NAPCAT_DIR:-$RUN_HOME/napcat}"
-  say "在 $NAPCAT_DIR 准备 OneBot 配置（首次扫码登录小号后，由面板自动写入正式 onebot11_<QQ>.json）…"
-  install -d -o "$RUN_USER" -g "$RUN_USER" "$NAPCAT_DIR/config"
-  cat > "$NAPCAT_DIR/run-napcat.sh" <<'RUNEOF'
+
+  if [ -x "$NAPCAT_QQ_BIN" ] && [ -d "$NAPCAT_DIR" ]; then
+    # root 跑安装器可能在用户家目录留下 root 属主文件；插件以普通用户 spawn，要能写
+    # config（onebot11_*.json），NapCat 首启也要写 webui.json/登录态，故整目录归普通用户。
+    chown -R "$RUN_USER":"$RUN_USER" "$NAPCAT_HOME"
+    install -d -o "$RUN_USER" -g "$RUN_USER" "$NAPCAT_DIR/config"
+    cat > "$NAPCAT_DIR/run-napcat.sh" <<'RUNEOF'
 #!/usr/bin/env bash
-# Kinstra Neko 调起的 NapCat 启动脚本（由安装器生成；如官方安装器的服务名不同，
-# 本脚本作为兜底：优先用 systemd 服务，否则提示手动启动）。
+# Kinstra Neko 调起的 NapCat 启动脚本（安装器生成）。
+# 官方 rootless Shell 形态：没有 systemd 服务、没有 x11vnc；在 Xvfb 虚拟显示里前台跑 QQNT，
+# 扫码/登录管理走 NapCat 内置 WebUI（token 见同目录 config/webui.json，默认端口 6099）。
+# 插件以普通用户 spawn 本脚本（cwd=本目录）；exec 让 QQ 顶替本壳，信号可直达。
 set -e
-if systemctl list-unit-files | grep -q napcat; then
-  sudo systemctl start napcat
-else
-  echo "未发现 napcat systemd 服务，请用 NapCat 官方方式启动（如 sudo napcat）" >&2
-  exit 1
-fi
+DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# 本脚本在 resources/app/app_launcher/napcat 下，上溯四级到 opt/QQ，QQ 本体在那。
+QQ="$(cd "$DIR/../../../.." && pwd)/qq"
+[ -x "$QQ" ] || QQ="$HOME/Napcat/opt/QQ/qq"
+exec xvfb-run -a "$QQ" --no-sandbox "$@"
 RUNEOF
-  chmod +x "$NAPCAT_DIR/run-napcat.sh"
-  chown -R "$RUN_USER":"$RUN_USER" "$NAPCAT_DIR"
-  ok 'NapCat 安装/引导完成（首次需扫码登录小号，见 NapCat 官方输出或面板连接页）'
+    chmod 755 "$NAPCAT_DIR/run-napcat.sh"
+    chown "$RUN_USER":"$RUN_USER" "$NAPCAT_DIR/run-napcat.sh"
+    # 关键：把 NapCat 插件目录（config 所在）种进插件配置，否则 detect() 回落到
+    # ~/.dsh/plugins-data/kinstra-neko/napcat，与真实安装目录不一致而判“未安装”。
+    su - "$RUN_USER" -c "pnpm dlx kinstra-neko@latest set-napcat-dir '$NAPCAT_DIR' </dev/null" \
+      || warn '未能把 NapCat 目录写入插件配置，可在面板「连接」页手填：'"$NAPCAT_DIR"
+    ok "NapCat 就绪：$NAPCAT_HOME（首次启动后经 SSH 隧道开 WebUI 扫码，见下方上线步骤）"
+  else
+    warn "NapCat 似乎没装完整（缺 $NAPCAT_QQ_BIN 或 $NAPCAT_DIR，多为下载失败）。可重跑本脚本，或面板「连接」改接 OneBot。"
+  fi
 fi
 
 # ---------- 6. systemd 服务 ----------
 say '注册 systemd 服务 kinstra-neko…'
 NODE_BIN="$(su - "$RUN_USER" -c 'command -v node')"
 DSH_BIN="$(su - "$RUN_USER" -c 'command -v dsh')"
+# --host 只接受具体本机 IP（拒绝通配）；取不到就不传给 DSH（回落其默认 loopback）。
+BIND_ARGS="--port $WEB_PORT --no-open"
+[ -n "$WEB_HOST" ] && BIND_ARGS="--host $WEB_HOST $BIND_ARGS"
 cat > /etc/systemd/system/kinstra-neko.service <<SVCEOF
 [Unit]
 Description=Kinstra Neko — DSH web with QQ catgirl
@@ -143,7 +201,7 @@ User=$RUN_USER
 Environment=NODE_ENV=production
 # 2H2G 内存上限：给 NapCat/系统留足，DSH 侧压缩到 ~700MB 老生代
 Environment=NODE_OPTIONS=--max-old-space-size=700
-ExecStart=$DSH_BIN --profile kinstra-neko web --port $WEB_PORT --no-open
+ExecStart=$DSH_BIN --profile kinstra-neko $BIND_ARGS
 Restart=on-failure
 RestartSec=5
 WorkingDirectory=$RUN_HOME
@@ -157,20 +215,41 @@ systemctl enable kinstra-neko >/dev/null 2>&1
 systemctl restart kinstra-neko
 ok '服务已启动并设为开机自启'
 
-sleep 3
-systemctl is-active --quiet kinstra-neko && ok 'kinstra-neko 正在运行' || warn '服务没起来：journalctl -u kinstra-neko -n 50 看日志'
+# web 首次挂载插件要十几秒，等到 active 且端口起来（最多 ~40s）
+BIND_IP="${WEB_HOST:-127.0.0.1}"
+for _ in $(seq 1 20); do
+  systemctl is-active --quiet kinstra-neko || { warn '服务没起来：journalctl -u kinstra-neko -n 50 看日志'; break; }
+  curl -s -o /dev/null --max-time 2 "http://$BIND_IP:$WEB_PORT/" && break
+  sleep 2
+done
+systemctl is-active --quiet kinstra-neko && ok "kinstra-neko 正在运行（监听 $BIND_IP:$WEB_PORT）"
+
+# DSH web 默认带一次性 token 门，从日志取带 token 的直达 URL
+TOKEN_URL="$(journalctl -u kinstra-neko --no-pager 2>/dev/null | grep -oE 'http://[^ ]*\?token=[^ ]+' | tail -1)"
+if [ -n "$TOKEN_URL" ]; then
+  TOKEN_URL="${TOKEN_URL/127.0.0.1/$BIND_IP}"
+  TOKEN_URL="${TOKEN_URL/localhost/$BIND_IP}"
+else
+  TOKEN_URL="http://$BIND_IP:$WEB_PORT/（按页面提示取 token：journalctl -u kinstra-neko -n 30）"
+fi
 
 echo
 say '安装完成！'
 cat <<TIPS
 
-  控制台：    http://<服务器IP>:$WEB_PORT
+  控制台（带免输 token 的直达地址）：
+    $TOKEN_URL
+  （也可运行： journalctl -u kinstra-neko -n 30 | grep -o 'http://.*token=.*' | tail -1）
+  云服务器：确认安全组/防火墙放行 $WEB_PORT/tcp；只想本机访问用 WEB_HOST=127.0.0.1 重装。
   服务管理：  sudo systemctl {status|restart|stop} kinstra-neko
   实时日志：  journalctl -u kinstra-neko -f
 
   上线步骤：
   1. 控制台按猫娘向导填「猫娘小号 QQ」和「你的 QQ」
-  2. 扫码登录 NapCat 里的小号（无桌面服务器走 x11vnc，见 NapCat 安装输出）
+  2. 扫码登录 NapCat 里的小号（headless 服务器走 SSH 隧道，勿对公网开放 6099）：
+       本机执行  ssh -L 6099:127.0.0.1:6099 $RUN_USER@<服务器 IP>
+       浏览器开  http://127.0.0.1:6099  ，token 见服务器上
+       $NAPCAT_DIR/config/webui.json 的 "token" 字段
   3. 在 DSH 设置里配置模型服务商与 API Key
   4. 把要养她的群加进白名单
   5. 出厂是试运行：先在「试运行」页确认她会说什么，再关试运行开麦

package/installer/windows/install.ps1

@@ -49,22 +49,28 @@ try { dsh --version | Out-Null; Ok "DSH $(dsh --version)" } catch {
   npm install -g "@deepseek-ai/dsh@$DshVersion" --no-audit --no-fund
 }
 
-# 3. 插件初始化
+# 2.5 pnpm：DSH 插件管理器用 pnpm；本生态全是 alpha 预发布版本，npm 严格 peer 会 ERESOLVE，pnpm 只告警。
+try { pnpm --version | Out-Null; Ok "pnpm $(pnpm --version)" } catch {
+  Say '全局安装 pnpm（DSH 插件管理器依赖）…'
+  npm install -g pnpm --no-audit --no-fund
+}
+
+# 3. 插件初始化（用 pnpm dlx，不用 npx：避开 npm 对 alpha peer 的 ERESOLVE）
 Say '初始化 Kinstra Neko …'
 $initArgs = @('init')
 if ($env:KINSTRA_NEKO_SPEC) { $initArgs = @('init', '--link', $env:KINSTRA_NEKO_SPEC) }
 $env:DSH_VERSION = $DshVersion
-npx -y kinstra-neko@latest @initArgs
+pnpm dlx kinstra-neko@latest @initArgs
 if ($LASTEXITCODE -ne 0) { Die '插件初始化失败，检查网络后重试（开发版设 KINSTRA_NEKO_SPEC=本地目录）。' }
 Ok '猫娘插件已装入 profile'
 
-# 调用本包 CLI（npm 源或本地 --link 源），用于把探测到的 NapCat 目录种入插件配置。
+# 调用本包 CLI（pnpm 源或本地 --link 源），用于把探测到的 NapCat 目录种入插件配置。
 function Invoke-KinstraCli([string[]]$CliArgs) {
   if ($env:KINSTRA_NEKO_SPEC) {
     $scriptPath = Join-Path $env:KINSTRA_NEKO_SPEC 'installer\bin\kinstra-neko-init.mjs'
     node $scriptPath @CliArgs
   } else {
-    npx -y kinstra-neko@latest @CliArgs
+    pnpm dlx kinstra-neko@latest @CliArgs
   }
 }
 
@@ -177,8 +183,8 @@ $startBat = Join-Path $appData 'start-kinstra.bat'
 REM Kinstra Neko 启动脚本（安装器生成）
 title Kinstra Neko
 echo Starting Kinstra Neko on http://127.0.0.1:$WebPort ...
-start "" http://127.0.0.1:$WebPort
-dsh --profile $ProfileName web --port $WebPort
+echo 浏览器会自动打开带一次性 token 的控制台；若没弹出，复制本窗口日志里 http://...?token=... 的链接。
+dsh --profile $ProfileName --port $WebPort
 pause
 "@ | Set-Content -Encoding UTF8 $startBat
 Ok "启动脚本：$startBat（已在桌面放快捷方式）"

package/lib/index.js

@@ -727,7 +727,7 @@ function createNapCatManager(opts) {
 			child = spawn(script, [], {
 				cwd: installDir(),
 				windowsHide: process.platform !== "win32",
-				detached: false,
+				detached: process.platform !== "win32",
 				stdio: [
 					"ignore",
 					"pipe",
@@ -756,8 +756,11 @@ function createNapCatManager(opts) {
 			message: "已启动"
 		};
 	}
-	/** 结束 NapCat 进程。Windows 下 spawn(.bat, shell:true) 的 pid 是 cmd.exe，
-	*  只 kill 它会孤儿化 NapCat/QQ，必须 taskkill /T 连整棵进程树一起结束。 */
+	/** 结束 NapCat 进程。
+	*  Windows 下 spawn(.bat, shell:true) 的 pid 是 cmd.exe，只 kill 它会孤儿化
+	*  NapCat/QQ，必须 taskkill /T 连整棵进程树一起结束。
+	*  POSIX 下 start() 用 detached:true 建了新进程组，对负 pid 发 SIGTERM 即可连同
+	*  xvfb-run → Xvfb + QQ(+zygote) 整组结束；进程组已不在（ESRCH）时兜底 kill 直接子。 */
 	function killTree(me) {
 		if (process.platform === "win32") try {
 			execFileSync("taskkill", [
@@ -768,6 +771,10 @@ function createNapCatManager(opts) {
 			], { stdio: "ignore" });
 			return;
 		} catch {}
+		if (typeof me.pid === "number") try {
+			process.kill(-me.pid, "SIGTERM");
+			return;
+		} catch {}
 		try {
 			me.kill();
 		} catch {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kinstra-neko",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Kinstra Neko —— 住在 QQ 群里的猫娘，基于 DeepSeek Harness 的 OneBot v11 社交陪伴发行版（自部署）",
   "license": "MIT",
   "author": "Kinstra Neko contributors",