dsh-qq-moony 0.4.0 → 0.5.1

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');
@@ -100,61 +100,91 @@
       const [草稿, 设草稿] = React.useState(null);
       const [脏, 设脏] = React.useState(false);
 
+      // 草稿没建起来之前，先用状态里的值兜底——省得"保存"之后闪回空白
+      const 从状态取 = () => ({
+        everyMinMin: 状态?.everyMinMin ?? 45,
+        everyMinMax: 状态?.everyMinMax ?? 90,
+        perHour: 状态?.perHour ?? 20,
+        perDay: 状态?.perDay ?? 60,
+        qzoneMinMin: 状态?.qzoneMinMin ?? 120,
+        qzoneMinMax: 状态?.qzoneMinMax ?? 240,
+        qzonePrompt: 状态?.qzonePrompt ?? '',
+        groupWhitelist: (状态?.groupWhitelist ?? []).join(' '),
+        groupContextSize: 状态?.groupContextSize ?? 30,
+        groupEveryMinMin: 状态?.groupEveryMinMin ?? 8,
+        groupEveryMinMax: 状态?.groupEveryMinMax ?? 20,
+        groupActiveWindowMin: 状态?.groupActiveWindowMin ?? 5,
+        groupCooldownMin: 状态?.groupCooldownMin ?? 10,
+        groupPerDay: 状态?.groupPerDay ?? 20,
+      });
+
       React.useEffect(() => {
         if (状态 && 草稿 === null) {
-          设草稿({
-            everyMinMin: 状态.everyMinMin ?? 45,
-            everyMinMax: 状态.everyMinMax ?? 90,
-            perHour: 状态.perHour ?? 20,
-            perDay: 状态.perDay ?? 60,
-            qzoneMinMin: 状态.qzoneMinMin ?? 120,
-            qzoneMinMax: 状态.qzoneMinMax ?? 240,
-            qzonePrompt: 状态.qzonePrompt ?? '',
-            groupWhitelist: (状态.groupWhitelist ?? []).join(' '),
-            groupContextSize: 状态.groupContextSize ?? 30,
-            groupEveryMinMin: 状态.groupEveryMinMin ?? 8,
-            groupEveryMinMax: 状态.groupEveryMinMax ?? 20,
-            groupActiveWindowMin: 状态.groupActiveWindowMin ?? 5,
-            groupCooldownMin: 状态.groupCooldownMin ?? 10,
-            groupPerDay: 状态.groupPerDay ?? 20,
-          });
+          设草稿(从状态取());
         }
       }, [状态, 草稿]);
 
-      const 数字 = (键, 值) => {
-        设草稿((旧) => ({ ...(旧 ?? {}), [键]: 值 }));
+      const 数字 = (键, 新值) => {
+        设草稿((旧) => ({ ...(旧 ?? 从状态取()), [键]: 新值 }));
         设脏(true);
       };
 
       const 保存 = async () => {
-        if (!草稿) return;
+        const 值 = 草稿 ?? 从状态取();
         await 改({
-          everyMinMin: Number(草稿.everyMinMin),
-          everyMinMax: Number(草稿.everyMinMax),
-          perHour: Number(草稿.perHour),
-          perDay: Number(草稿.perDay),
-          qzoneMinMin: Number(草稿.qzoneMinMin),
-          qzoneMinMax: Number(草稿.qzoneMinMax),
-          qzonePrompt: String(草稿.qzonePrompt ?? ''),
-          groupWhitelist: String(草稿.groupWhitelist ?? ''),
-          groupContextSize: Number(草稿.groupContextSize),
-          groupEveryMinMin: Number(草稿.groupEveryMinMin),
-          groupEveryMinMax: Number(草稿.groupEveryMinMax),
-          groupActiveWindowMin: Number(草稿.groupActiveWindowMin),
-          groupCooldownMin: Number(草稿.groupCooldownMin),
-          groupPerDay: Number(草稿.groupPerDay),
+          everyMinMin: Number(值.everyMinMin),
+          everyMinMax: Number(值.everyMinMax),
+          perHour: Number(值.perHour),
+          perDay: Number(值.perDay),
+          qzoneMinMin: Number(值.qzoneMinMin),
+          qzoneMinMax: Number(值.qzoneMinMax),
+          qzonePrompt: String(值.qzonePrompt ?? ''),
+          groupWhitelist: String(值.groupWhitelist ?? ''),
+          groupContextSize: Number(值.groupContextSize),
+          groupEveryMinMin: Number(值.groupEveryMinMin),
+          groupEveryMinMax: Number(值.groupEveryMinMax),
+          groupActiveWindowMin: Number(值.groupActiveWindowMin),
+          groupCooldownMin: Number(值.groupCooldownMin),
+          groupPerDay: Number(值.groupPerDay),
         });
         设脏(false);
         设草稿(null);
       };
 
-      if (状态 === null || 草稿 === null) {
+      if (状态 === null) {
         return h('div', { style: { padding: '8px 0', opacity: 0.6 } }, 错 || '读状态中…');
       }
 
+      const 值 = 草稿 ?? 从状态取();
+      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: { ...卡片 } },
@@ -178,7 +208,7 @@
             'div',
             null,
             h('div', { style: 标题 }, '主动说话'),
-            h('div', { style: 说明 }, `开着它才会自己找你，大约每 ${草稿.everyMinMin}–${草稿.everyMinMax} 分钟有机会开口一次；关掉就只回不发`),
+            h('div', { style: 说明 }, `开着它才会自己找你，大约每 ${值.everyMinMin}–${值.everyMinMax} 分钟有机会开口一次；关掉就只回不发`),
           ),
           h(开关, { 开: 状态.proactive, 点: () => 改({ proactive: !状态.proactive }) }),
         ),
@@ -208,7 +238,7 @@
             h('input', {
               type: 'number',
               min: 5,
-              value: 草稿.everyMinMin,
+              value: 值.everyMinMin,
               onChange: (e) => 数字('everyMinMin', Number(e.target.value)),
               style: { ...输入框, width: '78px' },
             }),
@@ -216,7 +246,7 @@
             h('input', {
               type: 'number',
               min: 5,
-              value: 草稿.everyMinMax,
+              value: 值.everyMinMax,
               onChange: (e) => 数字('everyMinMax', Number(e.target.value)),
               style: { ...输入框, width: '78px' },
             }),
@@ -235,7 +265,7 @@
             type: 'number',
             min: 1,
             max: 200,
-            value: 草稿.perHour,
+            value: 值.perHour,
             onChange: (e) => 数字('perHour', Number(e.target.value)),
             style: 输入框,
           }),
@@ -253,7 +283,7 @@
             type: 'number',
             min: 1,
             max: 1000,
-            value: 草稿.perDay,
+            value: 值.perDay,
             onChange: (e) => 数字('perDay', Number(e.target.value)),
             style: 输入框,
           }),
@@ -279,7 +309,7 @@
           ),
           h('input', {
             type: 'text',
-            value: 草稿.groupWhitelist,
+            value: 值.groupWhitelist,
             placeholder: '群号白名单，空格或逗号分隔；空着 = 群聊不生效',
             onChange: (e) => 数字('groupWhitelist', e.target.value),
             style: { ...输入框, width: '100%', boxSizing: 'border-box' },
@@ -292,7 +322,7 @@
               type: 'number',
               min: 5,
               max: 100,
-              value: 草稿.groupContextSize,
+              value: 值.groupContextSize,
               onChange: (e) => 数字('groupContextSize', Number(e.target.value)),
               style: { ...输入框, width: '70px' },
             }),
@@ -300,7 +330,7 @@
             h('input', {
               type: 'number',
               min: 2,
-              value: 草稿.groupEveryMinMin,
+              value: 值.groupEveryMinMin,
               onChange: (e) => 数字('groupEveryMinMin', Number(e.target.value)),
               style: { ...输入框, width: '70px' },
             }),
@@ -308,7 +338,7 @@
             h('input', {
               type: 'number',
               min: 2,
-              value: 草稿.groupEveryMinMax,
+              value: 值.groupEveryMinMax,
               onChange: (e) => 数字('groupEveryMinMax', Number(e.target.value)),
               style: { ...输入框, width: '70px' },
             }),
@@ -316,7 +346,7 @@
             h('input', {
               type: 'number',
               min: 1,
-              value: 草稿.groupActiveWindowMin,
+              value: 值.groupActiveWindowMin,
               onChange: (e) => 数字('groupActiveWindowMin', Number(e.target.value)),
               style: { ...输入框, width: '70px' },
             }),
@@ -329,7 +359,7 @@
             h('input', {
               type: 'number',
               min: 1,
-              value: 草稿.groupCooldownMin,
+              value: 值.groupCooldownMin,
               onChange: (e) => 数字('groupCooldownMin', Number(e.target.value)),
               style: { ...输入框, width: '70px' },
             }),
@@ -337,7 +367,7 @@
             h('input', {
               type: 'number',
               min: 1,
-              value: 草稿.groupPerDay,
+              value: 值.groupPerDay,
               onChange: (e) => 数字('groupPerDay', Number(e.target.value)),
               style: { ...输入框, width: '70px' },
             }),
@@ -363,7 +393,7 @@
             ),
             h('textarea', {
               rows: 3,
-              value: 草稿.qzonePrompt,
+              value: 值.qzonePrompt,
               placeholder: '例：一周发一次，写点最近的感受，两三句，不要提具体的人和地点',
               onChange: (e) => 数字('qzonePrompt', e.target.value),
               style: {
@@ -387,7 +417,7 @@
               h('input', {
                 type: 'number',
                 min: 10,
-                value: 草稿.qzoneMinMin,
+                value: 值.qzoneMinMin,
                 onChange: (e) => 数字('qzoneMinMin', Number(e.target.value)),
                 style: { ...输入框, width: '78px' },
               }),
@@ -395,7 +425,7 @@
               h('input', {
                 type: 'number',
                 min: 10,
-                value: 草稿.qzoneMinMax,
+                value: 值.qzoneMinMax,
                 onChange: (e) => 数字('qzoneMinMax', Number(e.target.value)),
                 style: { ...输入框, width: '78px' },
               }),

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.1",
   "description": "把 QQ 小号接进 DeepSeek Harness：收发消息、发表情包、发 QQ 空间说说、参与群聊，能自己找话题，自带启动与限速防封。",
   "keywords": [
     "dsh",