dsh-qq-moony 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # CHANGELOG
 
+## 0.5.0 — 2026-10-25
+
+装完之后不再一片红：缺什么会自己说出来。
+
+**新增**
+- 体检：设置页顶部检查三件事——QQ NT 装没装、NapCat 找不找得到、能不能连上；缺哪样就列出来，写清去哪儿下、哪几步
+- 状态接口多返回 `qqnt` / `napcat` 两个字段
+
+**为什么不能一条命令全装**
+QQ NT 是几百兆的客户端（要管理员权限），NapCat 要往 QQ 进程里注入（要匹配版本）——npm 包装不下这两样。插件能做的是：缺东西的时候说清楚缺什么，而不是让人装完盯着一片红发呆。
+
 ## 0.4.0 — 2026-10-25
 
 群聊从"只回 @"变成"会参与聊天"。

package/README.md

@@ -64,7 +64,9 @@ NapCat 是接管整个 QQ 客户端的行为——消息收发、登录态、空
 
 ## 三、设置页（名字叫「QQ嗦嗨嗨」）
 
-装完重启 DSH，设置里会多一项 **QQ嗦嗨嗨**：
+装完重启 DSH，设置里会多一项 **QQ嗦嗨嗨**。
+
+**顶上一块是体检**：QQ NT 装没装、NapCat 找不找得到、能不能连上。缺哪样它就列哪样，写明去哪儿下、哪几步——不用盯着一片红猜。
 
 - **连接状态**：在线没有、登录的是谁、今天发了多少、上限多少
 - **主动说话**：开关（点一下即时保存）

package/client.js

@@ -1,4 +1,4 @@
-window.__ModuleLoader__.load({
+window.__ModuleLoader__.load({
   id: 'dsh-qq-moony',
   factory(require) {
     const React = require('react');
@@ -152,9 +152,35 @@
         return h('div', { style: { padding: '8px 0', opacity: 0.6 } }, 错 || '读状态中…');
       }
 
+      const 缺口 = [];
+      if (!状态.qqnt) 缺口.push('没找到 QQ NT —— 去 im.qq.com 装新版（9.9.x）。老版 9.7 注不进去，这是死条件。');
+      if (!状态.napcat) 缺口.push('没找到 NapCat —— 去 github.com/NapNeko/NapCatQQ 下 Shell 版，解压后把 napCatDir 指过去。');
+      if (状态.qqnt && 状态.napcat && !状态.online)
+        缺口.push('QQ NT 和 NapCat 都在，但连不上 —— 检查 NapCat 启没启、3000 端口、token 三样。');
+
       return h(
         'div',
         null,
+        缺口.length > 0
+          ? h(
+              'div',
+              {
+                style: {
+                  ...卡片,
+                  flexDirection: 'column',
+                  alignItems: 'stretch',
+                  gap: '6px',
+                  borderColor: 'var(--dsw-alias-warning-1, #d99b2b)',
+                },
+              },
+              h(
+                'div',
+                { style: { ...标题, color: 'var(--dsw-alias-warning-1, #d99b2b)' } },
+                '还差几步才能用',
+              ),
+              缺口.map((行, i) => h('div', { key: i, style: 说明 }, `${i + 1}. ${行}`)),
+            )
+          : null,
         h(
           'div',
           { style: { ...卡片 } },

package/index.js

@@ -120,6 +120,19 @@ export function apply(ctx, 配置) {
 
   ctx.logger?.info?.(`qq-moony: 接到 ${c.baseUrl}（限额 ${c.perHour}/时、${c.perDay}/天）`);
 
+  /** 体检：QQ NT 装没装、NapCat 在不在——缺东西的时候要能说清缺什么。 */
+  function 体检() {
+    const 候选 = [
+      'C:/Program Files/Tencent/QQNT/QQ.exe',
+      'C:/Program Files (x86)/Tencent/QQNT/QQ.exe',
+      join(homedir(), 'AppData/Local/Programs/QQNT/QQ.exe'),
+      'D:/Tencent/QQNT/QQ.exe',
+    ];
+    const qqnt = 候选.some((p) => existsSync(p));
+    const napcat = Boolean(c.napCatDir) && existsSync(join(c.napCatDir, 'launcher-user.bat'));
+    return { qqnt, napcat };
+  }
+
   /** DSH 起来时顺手看一眼 NapCat：没跑就自己拉起来（免扫码，用 -q 快速登录）。 */
   async function 确认NapCat在跑() {
     if (c.autoStartNapCat === false) return;
@@ -658,6 +671,8 @@ export function apply(ctx, 配置) {
             ok: true,
             online: 在线,
             nickname: 昵称,
+            qqnt: 体检().qqnt,
+            napcat: 体检().napcat,
             uin: Number(c.uin ?? 0),
             proactive: Boolean(c.proactive),
             autoReply: Boolean(c.autoReply),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-qq-moony",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "把 QQ 小号接进 DeepSeek Harness：收发消息、发表情包、发 QQ 空间说说、参与群聊，能自己找话题，自带启动与限速防封。",
   "keywords": [
     "dsh",