dsh-qq-stack 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-qq-stack contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,56 @@
-# Temporary Holding Version
+# dsh-qq-stack
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+给 DeepSeek Harness 装上 QQ：LinuxQQ + NapCat 跟着引擎一起启动，扫码一次，之后自动登录。
+
+## 安装
+
+```bash
+dsh plugin --profile web add dsh-qq-stack
+```
+
+或者把打好的 tgz 包拖进 DSH 的「插件 › 添加插件」。
+
+装完重启一次引擎，第一次运行会自动下载 LinuxQQ 和 NapCat（约 250MB），之后就不再下载。
+
+## 使用
+
+打开 `设置 › QQ 底座`：
+
+- **未登录**：显示二维码，用手机 QQ 扫码并在手机上点「允许登录」
+- **已登录**：显示头像、昵称、QQ 号；点「切换账号」可以换号
+- 上方三行是状态：QQ 进程、OneBot 端口、登录状态，绿点是正常
+
+登录成功后，下次打开 DSH 会自动快登这个号，不用再扫码。
+
+## 配置
+
+`~/.dsh/qq-bot/config.env`：
+
+| 键 | 默认 | 说明 |
+| --- | --- | --- |
+| `DSH_QQ_UIN` | 登录后自动写入 | 自动快登的 QQ 号 |
+| `DSH_QQ_WS_PORT` | `3001` | OneBot 正向 WebSocket 端口 |
+| `DSH_QQ_TOKEN` | `dshfish-3001` | WebSocket 令牌，接入 OneBot 的客户端用来认证 |
+
+安装目录默认 `~/.dsh/qq-bot`，可用环境变量 `DSH_QQ_ROOT` 修改。
+
+## 要求
+
+- Linux（aarch64 / amd64），能装 apt 包；Android 的 DSH 运行环境也可以
+- Node ≥ 22.5
+- 首次安装约 250MB 磁盘和下载
+
+## 常见问题
+
+**扫码后一直显示未登录？**
+在手机上确认「允许登录」，只扫码不确认不算登录。确认后十几秒内状态会变成已登录。
+
+**过一段时间掉线？**
+打不开 DSH、或者引擎重启时，插件会把 QQ 拉起来，并按保存的账号自动快登。如果 QQ 进程被系统杀掉，重新打开 DSH 即可恢复；登录态失效时，需要重新扫码一次。
+
+**群里不回复？**
+这是负责聊天的插件自己的设置，本插件只负责让 QQ 保持在线。
+
+## 许可
+
+MIT

package/client.js

@@ -0,0 +1,115 @@
+window.__ModuleLoader__.load({
+  id: 'dsh-qq-stack',
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+    const react = require('react')
+    const h = react.createElement
+    const inject = ['slots']
+    const API = '/api/plugins/qq-stack'
+
+    async function api(method, path, body) {
+      try {
+        const r = await fetch(API + path, {
+          method,
+          headers: { 'content-type': 'application/json' },
+          ...(body ? { body: JSON.stringify(body) } : {}),
+        })
+        return await r.json()
+      } catch { return null }
+    }
+
+    const row = (label, ok, text) => h('div', { className: 'fs-row' },
+      h('span', null, label),
+      h('span', { className: 'fs-val' },
+        h('i', { className: ok ? 'fs-dot fs-on' : 'fs-dot fs-off' }),
+        text))
+
+    const CSS = `
+.fs-wrap{display:flex;flex-direction:column;gap:12px}
+.fs-card{background:var(--dsw-alias-bg-secondary,rgba(127,127,127,.08));border-radius:14px;padding:12px}
+.fs-row{display:flex;justify-content:space-between;align-items:center;padding:6px 0;font-size:13px}
+.fs-val{display:flex;align-items:center;gap:6px;opacity:.9}
+.fs-dot{width:8px;height:8px;border-radius:50%;display:inline-block}
+.fs-on{background:#39d98a}.fs-off{background:#ff5c5c}
+.fs-center{display:flex;flex-direction:column;align-items:center;gap:8px}
+.fs-qr{width:min(62vw,240px);height:auto;border-radius:12px;background:#fff;padding:8px}
+.fs-hint{font-size:12px;opacity:.6}
+.fs-input{width:100%;box-sizing:border-box;border:1px solid rgba(127,127,127,.28);background:transparent;color:inherit;border-radius:9px;padding:9px;font-size:14px}
+.fs-btns{display:flex;gap:8px}
+.fs-btn{flex:1;border:0;border-radius:9px;padding:10px;font-size:14px;background:#2f6fed;color:#fff}
+.fs-ghost{background:rgba(127,127,127,.2);color:inherit}
+.fs-account{display:flex;flex-direction:column;align-items:center;gap:6px;padding:18px 12px}
+.fs-avatar{width:72px;height:72px;border-radius:50%;background:rgba(127,127,127,.15);object-fit:cover}
+.fs-name{font-size:16px;font-weight:600;margin-top:4px}
+.fs-uin{font-size:12px;opacity:.55}
+.fs-btns-col{flex-direction:column;width:100%;margin-top:14px}
+.fs-primary{background:#12b7f5}
+.fs-login{display:flex;flex-direction:column;gap:10px}
+.fs-field{width:100%;box-sizing:border-box;border:0;border-bottom:1px solid rgba(127,127,127,.28);background:transparent;color:inherit;padding:10px 2px;font-size:15px;outline:none}
+.fs-wide{padding:11px}
+.fs-sep{text-align:center;font-size:12px;opacity:.5;margin-top:6px}`
+
+    function Panel() {
+      const [st, setSt] = react.useState(null)
+      const [busy, setBusy] = react.useState('')
+      const [err, setErr] = react.useState(false)
+
+      const load = async () => {
+        const d = await api('GET', '/status')
+        if (d?.ok) { setSt(d); setErr(false) } else setErr(true)
+      }
+      react.useEffect(() => { void load(); const t = setInterval(load, 5000); return () => clearInterval(t) }, [])
+
+      const post = async (path, body) => {
+        setBusy(path)
+        await api('POST', path, body)
+        setTimeout(() => { void load(); setBusy('') }, 8000)
+      }
+
+      const qrUrl = st?.qrAt ? `${API}/qr.png?t=${st.qrAt}` : `${API}/qr.png`
+      const logged = !!st?.loggedIn
+
+      return h('div', { className: 'fs-wrap' },
+        h('style', null, CSS),
+        err ? h('div', { className: 'fs-hint' }, '状态获取失败，稍后自动重试') : null,
+        h('div', { className: 'fs-card' },
+          row('QQ 进程', !!st?.qq, st?.qq ? '运行中' : '未运行'),
+          row('OneBot 端口', !!st?.qq, st?.qq ? '已监听' : '未监听'),
+          row('登录状态', logged, logged ? `已登录 ${st?.nickname || ''} ${st?.uin || ''}` : '未登录'),
+        ),
+        !logged ? h('div', { className: 'fs-card fs-center' },
+          st?.qrAt
+            ? h('img', { className: 'fs-qr', src: qrUrl, alt: '登录二维码' })
+            : h('div', { className: 'fs-hint' }, '正在生成二维码…'),
+        ) : null,
+        logged ? h('div', { className: 'fs-card fs-account' },
+          h('img', {
+            className: 'fs-avatar',
+            src: st?.uin ? `https://q1.qlogo.cn/g?b=sdk&nk=${st.uin}&s=640` : '',
+            alt: '',
+          }),
+          h('div', { className: 'fs-name' }, st?.nickname || '已登录'),
+          h('div', { className: 'fs-uin' }, st?.uin ? `QQ ${st.uin}` : ''),
+          h('div', { className: 'fs-btns fs-btns-col' },
+            h('button', { className: 'fs-btn fs-primary', onClick: () => post('/logout') },
+              busy === '/logout' ? '切换中…' : '切换账号'),
+          ),
+        ) : null,
+      )
+    }
+
+    function apply(ctx) {
+      ctx.slots.inject('settings.section', () => ctx.slots.register({
+        name: 'settings.section',
+        id: 'qq-stack',
+        order: 61,
+        label: () => 'QQ 底座',
+      }, Panel))
+    }
+
+    exports.apply = apply;
+    exports.inject = inject;
+    return module.exports;
+  },
+})

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# dsh-qq-stack bundle patch: 挂载插件
+- insert:
+    - id: dsh-qq-stack
+      name: dsh-qq-stack

package/index.js

@@ -0,0 +1,287 @@
+import { spawn } from 'node:child_process'
+import { existsSync, readFileSync, writeFileSync, statSync, readdirSync, unlinkSync } from 'node:fs'
+import { readFileSync as rf } from 'node:fs'
+
+export const name = 'dsh-qq-stack'
+export const inject = ['webServer']
+
+const SELF = new URL('.', import.meta.url).pathname
+const DEFAULTS = { root: '/root/qq-bot', uin: '', wsPort: 3001, token: '' }
+
+function cfgDir(root) { return `${root}/opt/opt/QQ/resources/app/app_launcher/napcat/config` }
+
+function ensureOnebot(root, port, token) {
+  let changed = false
+  let files = []
+  try { files = readdirSync(cfgDir(root)) } catch { return false }
+  for (const f of files) {
+    if (!/^onebot11_\d{5,12}\.json$/.test(f)) continue
+    const p = `${cfgDir(root)}/${f}`
+    let cfg
+    try { cfg = JSON.parse(readFileSync(p, 'utf8')) } catch { cfg = {} }
+    cfg.network = cfg.network || {}
+    const list = Array.isArray(cfg.network.websocketServers) ? cfg.network.websocketServers : []
+    if (list.some((x) => Number(x.port) === Number(port) && x.enable !== false)) continue
+    cfg.network.websocketServers = [{
+      name: 'dsh', enable: true, host: '127.0.0.1', port: Number(port),
+      messagePostFormat: 'array', reportSelfMessage: false, token,
+      debug: false, heartInterval: 30000, enableForcePushEvent: true,
+    }]
+    try { writeFileSync(p, JSON.stringify(cfg, null, 2)); changed = true } catch {}
+  }
+  return changed
+}
+
+function sessionLoginUin(root) {
+  let pidAt = 0
+  try { pidAt = statSync(`${root}/qq.pid`).mtimeMs } catch {}
+  let best = '', bestAt = 0
+  try {
+    for (const f of readdirSync(cfgDir(root))) {
+      const m = f.match(/^napcat_(\d{5,12})\.json$/)
+      if (!m) continue
+      const at = statSync(`${cfgDir(root)}/${f}`).mtimeMs
+      if (at >= pidAt && at > bestAt) { bestAt = at; best = m[1] }
+    }
+  } catch {}
+  return best
+}
+
+let lastHealAt = 0
+
+function readEnvFile(root) {
+  const out = {}
+  try {
+    for (const line of readFileSync(`${root}/config.env`, 'utf8').split('\n')) {
+      const m = line.match(/^\s*([A-Z_]+)\s*=\s*(.*)\s*$/)
+      if (m) out[m[1]] = m[2].replace(/^["']|["']$/g, '')
+    }
+  } catch {}
+  return out
+}
+
+function resolveConfig(config = {}) {
+  const root = config.root || process.env.DSH_QQ_ROOT || DEFAULTS.root
+  const file = readEnvFile(root)
+  const pick = (a, b, c) => (a !== undefined && a !== '' ? a : b !== undefined && b !== '' ? b : c)
+  return {
+    root,
+    uin: String(pick(config.uin, process.env.DSH_QQ_UIN, file.DSH_QQ_UIN ?? DEFAULTS.uin)),
+    wsPort: Number(pick(config.wsPort, process.env.DSH_QQ_WS_PORT, file.DSH_QQ_WS_PORT ?? DEFAULTS.wsPort)),
+    token: String(pick(config.token, process.env.DSH_QQ_TOKEN, file.DSH_QQ_TOKEN ?? DEFAULTS.token)),
+    autoInstall: config.autoInstall ?? true,
+  }
+}
+
+let probeCache = { at: 0, loggedIn: false, nickname: '', uin: '' }
+async function probeLogin(port, token, force) {
+  if (!force && Date.now() - probeCache.at < 15000) return probeCache
+  const result = await new Promise((resolve) => {
+    let done = false
+    const finish = (v) => { if (!done) { done = true; resolve(v) } }
+    try {
+      const url = `ws://127.0.0.1:${port}/${token ? `?access_token=${encodeURIComponent(token)}` : ''}`
+      const ws = new WebSocket(url)
+      const timer = setTimeout(() => { try { ws.close() } catch {}; finish({ loggedIn: false, nickname: '' }) }, 3000)
+      ws.onopen = () => ws.send(JSON.stringify({ action: 'get_login_info', params: {}, echo: 'probe' }))
+      ws.onmessage = (e) => {
+        try {
+          const d = JSON.parse(e.data)
+          if (d.echo === 'probe') {
+            clearTimeout(timer)
+            const ok = d.retcode === 0 && d.data && d.data.user_id
+            try { ws.close() } catch {}
+            finish({ loggedIn: !!ok, nickname: ok ? String(d.data.nickname || '') : '', uin: ok ? String(d.data.user_id || '') : '' })
+          }
+        } catch {}
+      }
+      ws.onerror = () => { clearTimeout(timer); finish({ loggedIn: false, nickname: '' }) }
+    } catch { finish({ loggedIn: false, nickname: '' }) }
+  })
+  probeCache = { at: Date.now(), ...result }
+  return probeCache
+}
+
+function alive(pid) {
+  if (!pid) return false
+  try { process.kill(pid, 0); return true } catch { return false }
+}
+
+export function apply(ctx, pluginConfig = {}) {
+  try { return applyInner(ctx, pluginConfig) } catch (e) { try { ctx.logger?.warn?.(`[qq-stack] 激活失败：${e?.message ?? e}`) } catch {} }
+}
+
+function applyInner(ctx, pluginConfig = {}) {
+  const cfg = resolveConfig(pluginConfig)
+  const log = (msg) => { try { ctx.logger?.info?.(msg); if (process.env.DSH_QQ_DEBUG) console.log(msg) } catch {} }
+  log(`[qq-stack] 激活 root=${cfg.root} uin=${cfg.uin || '(空)'} autoInstall=${cfg.autoInstall}`)
+
+  const env = {
+    ...process.env,
+    DSH_QQ_ROOT: cfg.root,
+    DSH_QQ_UIN: cfg.uin,
+    DSH_QQ_WS_PORT: String(cfg.wsPort),
+    DSH_QQ_TOKEN: cfg.token,
+  }
+
+  const ensureStarted = () => {
+    try {
+      let pid = 0
+      try { pid = Number(readFileSync(`${cfg.root}/qq.pid`, 'utf8').trim()) || 0 } catch {}
+      if (alive(pid)) return
+      const script = `${cfg.root}/start-qq.sh`
+      if (!existsSync(script)) return
+      const child = spawn('bash', [script], { cwd: cfg.root, detached: true, stdio: 'ignore', env })
+      child.unref()
+      log('[qq-stack] 拉起 QQ')
+    } catch (e) { log(`[qq-stack] 启动失败：${e?.message ?? e}`) }
+  }
+
+  const ensureInstalled = () => {
+    if (existsSync(`${cfg.root}/opt/opt/QQ/qq`)) return ensureStarted()
+    if (!cfg.autoInstall) { log('[qq-stack] 未安装且 autoInstall=false，跳过'); return }
+    const installer = existsSync(`${cfg.root}/install.sh`) ? `${cfg.root}/install.sh` : `${SELF}install.sh`
+    if (!existsSync(installer)) { log('[qq-stack] 找不到 install.sh'); return }
+    log('[qq-stack] 首次安装开始（LinuxQQ + NapCat，约 250MB）')
+    try {
+      const child = spawn('bash', [installer], { cwd: cfg.root, detached: true, stdio: 'ignore', env })
+      child.unref()
+    } catch (e) { log(`[qq-stack] 安装启动失败：${e?.message ?? e}`) }
+  }
+
+  ctx.effect(() => {
+    const timer = setInterval(async () => {
+      try {
+        const envFile = readEnvFile(cfg.root)
+        const port = Number(envFile.DSH_QQ_WS_PORT || cfg.wsPort || 3001)
+        const token = envFile.DSH_QQ_TOKEN || cfg.token
+        const login = await probeLogin(port, token, true)
+        if (login.loggedIn && login.uin && envFile.DSH_QQ_UIN !== login.uin) {
+          const next = { ...envFile, DSH_QQ_UIN: login.uin }
+          writeFileSync(`${cfg.root}/config.env`, Object.entries(next).map(([k, x]) => `${k}=${x}`).join('\n') + '\n')
+          log(`[qq-stack] 记住快登号 ${login.uin}`)
+        }
+        const healed = ensureOnebot(cfg.root, port, token)
+        if (healed && Date.now() - lastHealAt > 90000) {
+          lastHealAt = Date.now()
+          log('[qq-stack] 补齐 OneBot 配置，重启 QQ')
+          try { spawn('bash', ['-c', 'bash stop-qq.sh; bash start-qq.sh'], { cwd: cfg.root, detached: true, stdio: 'ignore' }).unref() } catch {}
+        }
+      } catch (e) { log(`[qq-stack] 巡检失败：${e?.message ?? e}`) }
+    }, 60000)
+    return () => clearInterval(timer)
+  }, 'dsh-qq-stack: config-check')
+
+  ctx.effect(() => {
+    const t = setTimeout(() => { try { ensureInstalled() } catch (e) { log(`[qq-stack] ${e?.message ?? e}`) } }, 8000)
+    return () => clearTimeout(t)
+  }, 'dsh-qq-stack: autostart')
+
+  try {
+    const API = '/api/plugins/qq-stack'
+    const handler = async (req, res) => {
+      try {
+        const url = new URL(req.url, 'http://127.0.0.1')
+        const p = url.pathname.replace(API, '') || '/'
+        const json = (o, code = 200) => { res.writeHead(code, { 'content-type': 'application/json' }); res.end(JSON.stringify(o)) }
+        if (req.method === 'GET' && (p === '/status' || p === '/')) {
+          const envFile = readEnvFile(cfg.root)
+          let qq = false
+          try { qq = alive(Number(readFileSync(`${cfg.root}/qq.pid`, 'utf8').trim())) } catch {}
+          let detectedUin = ''
+          try {
+            const dir = `${cfg.root}/opt/opt/QQ/resources/app/app_launcher/napcat/config`
+            for (const f of readdirSync(dir)) {
+              const m = f.match(/^onebot11_(\d{5,12})\.json$/)
+              if (m) { detectedUin = m[1]; break }
+            }
+          } catch {}
+          const qr = `${cfg.root}/opt/opt/QQ/resources/app/app_launcher/napcat/cache/qrcode.png`
+          let qrAt = 0
+          try {
+            const qrM = statSync(qr).mtimeMs
+            const pidM = statSync(`${cfg.root}/qq.pid`).mtimeMs
+            if (qrM >= pidM) qrAt = Math.floor(qrM)
+          } catch {}
+          const login = qq ? await probeLogin(Number(envFile.DSH_QQ_WS_PORT || cfg.wsPort || 3001), envFile.DSH_QQ_TOKEN || cfg.token) : { loggedIn: false, nickname: '' }
+          if (login.loggedIn) {
+            const qqUin = detectedUin || envFile.DSH_QQ_UIN || ''
+            if (qqUin && envFile.DSH_QQ_UIN !== qqUin) {
+              const env2 = { ...envFile, DSH_QQ_UIN: qqUin }
+              writeFileSync(`${cfg.root}/config.env`, Object.entries(env2).map(([k, x]) => `${k}=${x}`).join('\n') + '\n')
+            }
+          }
+          const portNum = Number(envFile.DSH_QQ_WS_PORT || cfg.wsPort || 3001)
+          const tokenVal = envFile.DSH_QQ_TOKEN || cfg.token
+          const healed = ensureOnebot(cfg.root, portNum, tokenVal)
+          if (healed && !login.loggedIn && Date.now() - lastHealAt > 90000) {
+            lastHealAt = Date.now()
+            try { spawn('bash', ['-c', `bash stop-qq.sh; bash start-qq.sh`], { cwd: cfg.root, detached: true, stdio: 'ignore' }).unref() } catch {}
+          }
+          const probeFresh = Date.now() - (probeCache.at || 0) < 6000
+          if (login.loggedIn && login.uin && probeFresh && envFile.DSH_QQ_UIN !== login.uin) {
+            try {
+              const e2 = { ...envFile, DSH_QQ_UIN: login.uin }
+              writeFileSync(`${cfg.root}/config.env`, Object.entries(e2).map(([k, x]) => `${k}=${x}`).join('\n') + '\n')
+            } catch {}
+          }
+          return json({ ok: true, qq, loggedIn: !!login.loggedIn, nickname: login.nickname, uin: login.loggedIn ? login.uin : (envFile.DSH_QQ_UIN || detectedUin), port: envFile.DSH_QQ_WS_PORT || '3001', token: envFile.DSH_QQ_TOKEN || '', qrAt })
+        }
+        if (req.method === 'GET' && p === '/qr.png') {
+          let detectedUin = ''
+          try {
+            const dir = `${cfg.root}/opt/opt/QQ/resources/app/app_launcher/napcat/config`
+            for (const f of readdirSync(dir)) {
+              const m = f.match(/^onebot11_(\d{5,12})\.json$/)
+              if (m) { detectedUin = m[1]; break }
+            }
+          } catch {}
+          const qr = `${cfg.root}/opt/opt/QQ/resources/app/app_launcher/napcat/cache/qrcode.png`
+          if (!existsSync(qr)) { res.writeHead(404); return res.end() }
+          res.writeHead(200, { 'content-type': 'image/png', 'cache-control': 'no-store' })
+          return res.end(rf(qr))
+        }
+        if (req.method === 'POST' && p === '/save') {
+          let body = ''
+          req.on('data', (c) => { body += c })
+          req.on('end', () => {
+            try {
+              const v = JSON.parse(body || '{}')
+              const allow = {}
+              for (const k of ['DSH_QQ_UIN', 'DSH_QQ_WS_PORT', 'DSH_QQ_TOKEN']) {
+                if (typeof v[k] === 'string') allow[k] = v[k].replace(/[\r\n]/g, '')
+              }
+              const cur = readEnvFile(cfg.root)
+              const next = { ...cur, ...allow }
+              writeFileSync(`${cfg.root}/config.env`, Object.entries(next).map(([k, x]) => `${k}=${x}`).join('\n') + '\n')
+              return json({ ok: true })
+            } catch (e) { return json({ ok: false, error: String(e?.message ?? e) }, 400) }
+          })
+          return
+        }
+        if (req.method === 'POST' && p === '/logout') {
+          try {
+            const cur = readEnvFile(cfg.root)
+            const next = { ...cur, DSH_QQ_UIN: '' }
+            delete next.DSH_QQ_PASSWORD_MD5
+            writeFileSync(`${cfg.root}/config.env`, Object.entries(next).map(([k, x]) => `${k}=${x}`).join('\n') + '\n')
+          } catch {}
+          try {
+            const auth = `${cfg.root}/data/qq-home/.config/QQ/auth/login.enc`
+            if (existsSync(auth)) unlinkSync(auth)
+          } catch {}
+          probeCache = { at: 0, loggedIn: false, nickname: '', uin: '' }
+          try { spawn('bash', ['-c', 'bash stop-qq.sh; bash start-qq.sh'], { cwd: cfg.root, detached: true, stdio: 'ignore' }).unref() } catch {}
+          return json({ ok: true })
+        }
+        if (req.method === 'POST' && p === '/restart') {
+          try { spawn('bash', ['-c', 'bash stop-qq.sh; bash start-qq.sh'], { cwd: cfg.root, detached: true, stdio: 'ignore' }).unref() } catch {}
+          return json({ ok: true })
+        }
+        json({ ok: false }, 404)
+      } catch (e) { try { res.writeHead(500, { 'content-type': 'application/json' }); res.end(JSON.stringify({ error: String(e && e.message || e), stack: String(e && e.stack || '').split('\n').slice(0,3) })) } catch {} }
+    }
+    ctx.effect(() => ctx.webServer.register({ kind: 'prefix', path: API, handler }), 'dsh-qq-stack: api')
+  } catch (e) { log(`[qq-stack] 接口注册失败：${e?.message ?? e}`) }
+
+}

package/install.sh

@@ -0,0 +1,163 @@
+#!/bin/bash
+set -u
+ROOT="${DSH_QQ_ROOT:-/root/qq-bot}"
+mkdir -p "$ROOT"/{logs,opt,data/qq-home/.config,data/qq-home/.local/share,data/qq-home/.cache,data/runtime}
+cd "$ROOT" || exit 1
+
+if [ -f "$ROOT/config.env" ]; then
+  set -a; . "$ROOT/config.env"; set +a
+fi
+UIN="${DSH_QQ_UIN:-}"
+WS_PORT="${DSH_QQ_WS_PORT:-3001}"
+TOKEN="${DSH_QQ_TOKEN:-dshfish-3001}"
+
+if [ ! -f "$ROOT/config.env" ]; then
+  cat > "$ROOT/config.env" <<EOF
+DSH_QQ_UIN=$UIN
+DSH_QQ_WS_PORT=$WS_PORT
+DSH_QQ_TOKEN=$TOKEN
+EOF
+fi
+
+say() { echo "[install $(date +%H:%M:%S)] $*"; }
+
+ARCH="$(dpkg --print-architecture 2>/dev/null || uname -m)"
+case "$ARCH" in
+  arm64|aarch64) QQ_ARCH=arm64 ;;
+  amd64|x86_64)  QQ_ARCH=amd64 ;;
+  *) say "不支持的架构：$ARCH"; exit 1 ;;
+esac
+QQ_VER="3.2.34-53644"
+QQ_DEB_URL="https://qqdl.gtimg.cn/qqfile/QQNT/9.9.36/beta/9ee04bef/linuxqq_${QQ_VER}_${QQ_ARCH}.deb"
+NAPCAT_ZIP="https://github.com/NapNeko/NapCatQQ/releases/latest/download/NapCat.Shell.zip"
+
+missing=""
+for p in xvfb libnss3 libgbm1 libasound2t64 libgtk-3-0 dbus-x11 unzip curl; do
+  dpkg -s "$p" >/dev/null 2>&1 || missing="$missing $p"
+done
+if [ -n "$missing" ]; then
+  say "安装依赖：$missing"
+  export DEBIAN_FRONTEND=noninteractive
+  apt-get update -qq && apt-get install -y $missing || { say "依赖安装失败"; exit 1; }
+fi
+
+if [ ! -x "$ROOT/opt/opt/QQ/qq" ]; then
+  say "下载 LinuxQQ ${QQ_ARCH}（约 200MB）"
+  curl -fL --retry 3 -o /tmp/QQ.deb "$QQ_DEB_URL" || { say "LinuxQQ 下载失败"; exit 1; }
+  dpkg -x /tmp/QQ.deb "$ROOT/opt" || { say "解包失败"; exit 1; }
+  rm -f /tmp/QQ.deb
+else
+  say "LinuxQQ 已存在，跳过"
+fi
+
+QQ_APP="$ROOT/opt/opt/QQ/resources/app"
+
+if [ ! -f "$QQ_APP/app_launcher/napcat/napcat.mjs" ]; then
+  say "下载 NapCat"
+  if [ -f /tmp/NapCat.Shell.zip ] && unzip -t /tmp/NapCat.Shell.zip >/dev/null 2>&1; then
+    say "复用已下载的 NapCat 包"
+  else
+  curl -fL --retry 2 -o /tmp/NapCat.Shell.zip "$NAPCAT_ZIP" \
+    || curl -fL --retry 2 -o /tmp/NapCat.Shell.zip "https://gh-proxy.com/$NAPCAT_ZIP" \
+    || { say "NapCat 下载失败"; exit 1; }
+  fi
+  rm -rf /tmp/napcat-unzip && mkdir -p /tmp/napcat-unzip
+  unzip -q -o /tmp/NapCat.Shell.zip -d /tmp/napcat-unzip || { say "NapCat 解压失败"; exit 1; }
+  mkdir -p "$QQ_APP/app_launcher"
+  cp -a /tmp/napcat-unzip "$QQ_APP/app_launcher/napcat"
+  rm -rf /tmp/napcat-unzip /tmp/NapCat.Shell.zip
+else
+  say "NapCat 已存在，跳过"
+fi
+
+cat > "$QQ_APP/loadNapCat.js" <<'EOF'
+const path = require('node:path');
+const { pathToFileURL } = require('node:url');
+import(pathToFileURL(path.join(__dirname, 'app_launcher/napcat/napcat.mjs')).href);
+EOF
+node -e '
+const fs=require("fs");const p=process.argv[1];
+const j=JSON.parse(fs.readFileSync(p,"utf8"));
+if(j.main!=="./loadNapCat.js"){j.main="./loadNapCat.js";fs.writeFileSync(p,JSON.stringify(j,null,2));}
+' "$QQ_APP/package.json" || { say "补丁失败"; exit 1; }
+
+CFG_DIR="$QQ_APP/app_launcher/napcat/config"
+mkdir -p "$CFG_DIR"
+if ! ls "$CFG_DIR"/onebot11_*.json >/dev/null 2>&1; then
+  say "写入 OneBot 配置（ws ${WS_PORT}）"
+  cat > "$CFG_DIR/onebot11_${UIN:-default}.json" <<EOF
+{
+  "network": {
+    "httpServers": [],
+    "httpSseServers": [],
+    "httpClients": [],
+    "websocketServers": [
+      {
+        "name": "dsh",
+        "enable": true,
+        "host": "127.0.0.1",
+        "port": $WS_PORT,
+        "messagePostFormat": "array",
+        "reportSelfMessage": false,
+        "token": "$TOKEN",
+        "debug": false,
+        "heartInterval": 30000,
+        "enableForcePushEvent": true
+      }
+    ],
+    "websocketClients": [],
+    "plugins": []
+  },
+  "musicSignUrl": "",
+  "enableLocalFile2Url": false,
+  "parseMultMsg": false,
+  "imageDownloadProxy": ""
+}
+EOF
+fi
+
+if [ ! -f "$ROOT/start-qq.sh" ]; then
+cat > "$ROOT/start-qq.sh" <<EOF
+#!/bin/bash
+cd "\$(dirname "\$0")" || exit 1
+[ -f config.env ] && { set -a; . ./config.env; set +a; }
+mkdir -p logs data/qq-home/.config data/qq-home/.local/share data/qq-home/.cache data/runtime
+chmod 700 data/runtime
+export HOME="$ROOT/data/qq-home"
+export XDG_CONFIG_HOME="\$HOME/.config" XDG_DATA_HOME="\$HOME/.local/share" XDG_CACHE_HOME="\$HOME/.cache"
+export XDG_RUNTIME_DIR="$ROOT/data/runtime"
+export ELECTRON_DISABLE_SANDBOX=1
+[ -n "\${DSH_QQ_UIN:-}" ] && export NAPCAT_QUICK_ACCOUNT="\$DSH_QQ_UIN"
+if [ -f qq.pid ] && kill -0 "\$(cat qq.pid)" 2>/dev/null; then echo "QQ 已在运行"; exit 0; fi
+cd opt/opt/QQ
+setsid dbus-run-session -- xvfb-run -a -s "-screen 0 1280x800x24" ./qq \\
+  --no-sandbox --disable-gpu --disable-gpu-sandbox --in-process-gpu \\
+  --disable-dev-shm-usage --disable-gpu-compositing > ../../../logs/qq.log 2>&1 &
+echo \$! > ../../../qq.pid
+echo "QQ 启动中 (pid \$!)"
+EOF
+fi
+
+if [ ! -f "$ROOT/stop-qq.sh" ]; then
+cat > "$ROOT/stop-qq.sh" <<'EOF'
+#!/bin/bash
+cd "$(dirname "$0")" || exit 1
+pid=$(cat qq.pid 2>/dev/null)
+if [ -n "$pid" ]; then
+  pgid=$(ps -o pgid= -p "$pid" 2>/dev/null | tr -d ' ')
+  [ -n "$pgid" ] && kill -TERM -"$pgid" 2>/dev/null
+  for i in $(seq 1 10); do kill -0 "$pid" 2>/dev/null || break; sleep 1; done
+  [ -n "$pgid" ] && kill -KILL -"$pgid" 2>/dev/null
+  kill -KILL "$pid" 2>/dev/null
+fi
+for p in $(ps -eo pid=,comm= 2>/dev/null | awk '$2=="qq"||$2=="Xvfb"{print $1}'); do
+  kill -KILL "$p" 2>/dev/null
+done
+rm -f qq.pid
+EOF
+fi
+
+chmod +x "$ROOT"/*.sh
+say "安装完成，启动 QQ"
+bash "$ROOT/start-qq.sh"
+say "完成（首次需要扫码，之后启动会走 ${UIN:-未设置账号} 的快速登录）"

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "dsh-qq-stack",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "type": "module",
+  "main": "./index.js",
+  "description": "DeepSeek Harness 的 QQ 协议端底座：LinuxQQ + NapCat 随引擎自启，扫码一次后自动快登。",
+  "keywords": [
+    "dsh-plugin",
+    "dsh",
+    "deepseek-harness",
+    "qq",
+    "napcat",
+    "onebot"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.5.0"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "install.sh",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "slots"
+      ]
+    }
+  },
+  "scripts": {
+    "test": "node --input-type=module -e \"await import('./index.js')\""
+  }
+}