dsh-qqbot-buddy 1.0.0-alpha.1 → 1.0.0-alpha.2

package/README.md

@@ -4,7 +4,7 @@
 支持配置档（Profile）/作用域绑定、可管理的工具与技能、SQLite + FTS5 长期记忆与知识库、
 群友库、人格卡与表情包，并提供多机器人隔离运行。
 
-- 适用版本：`1.0.0-alpha.1`（v2 分支）
+- 适用版本：`1.0.0-alpha.2`（v2 分支）
 - 运行环境：**Node.js ≥ 24**（使用内置 `node:sqlite`）、dsh 0.2.x
 - 依赖：QQ 官方机器人平台的 `appId` / `appSecret`（WebSocket 接入，无需公网回调）
 - npm：[dsh-qqbot-buddy](https://www.npmjs.com/package/dsh-qqbot-buddy)（当前 alpha 走 `@next` 标签）
@@ -16,7 +16,7 @@
 
 | 模块 | 说明 |
 | --- | --- |
-| 独立控制台 | 随插件进程启动的 Web 管理台（默认 `127.0.0.1:6198`），token 登录、SSE 实时事件、开机即用，无需额外部署前端或数据库 |
+| 独立控制台 | 随插件进程启动的 Web 管理台（默认 `127.0.0.1:6198`），token 登录、SSE 实时事件、开机即用，无需额外部署前端或数据库；与 dsh Web 双向快捷入口（控制台顶栏 → dsh Web；dsh Web 右下角 → QQ 控制台） |
 | 多机器人 | 每个 bot 独立工作目录 `<workspace>/bots/<botId>`，凭据、会话、日志互不影响；同一进程可管理多个 bot |
 | 配置档与绑定 | 三层策略：`global < bot < profile`；按 `群聊 / 私聊 / 指定 openid` 绑定不同配置档（精确 > 类型通配 > bot 通配 > 默认档），切换配置档不丢记忆 |
 | 提示词管理 | 人设卡、人格卡、口头禅、能力边界、工具指引；控制台提供**提示词拼合预览**，按真实顺序查看每段内容与字符数 |

package/docs/USER-GUIDE.md

@@ -179,6 +179,12 @@ Web 管理控制台。你不需要额外部署数据库、消息队列或前端
 > 顶栏右上角有 **「dsh Web ↗」** 按钮：一键打开当前 dsh 进程的 Web 界面（链接自带本进程的鉴权 token，无需再手抄）。
 > 注意：该 token 每次重启 dsh 都会变，因此按钮只在当前进程生命周期内有效；不要把带 token 的链接转发给别人。
 
+**反向入口（dsh Web → 控制台）**：插件同时带一个 dsh Web 客户端入口——安装本插件的
+web profile 会在页面右下角显示悬浮的 **「QQ 控制台」** 按钮，点击经同源路由 `/qqbot-dashboard`
+302 到控制台（端口/地址跟随配置，不需要改前端）。若 web profile 只用于放入口、控制台跑在
+机器人 profile 里，可在该 profile 的 patch 配置里设 `console.enabled: false`（不重复启动控制台）
+并把 `console.port` 指向已有控制台端口即可。
+
 ![控制台总览](images/console-overview.png)
 
 *图 1：控制台总览——机器人运行状态、SSE 事件流与配置规模一屏可见。*

package/lib/client.js

@@ -0,0 +1,73 @@
+/**
+ * dsh Web 客户端插件：在侧边栏底部（sidebar.footer.action 槽位）加一个
+ * 「QQ」快捷入口，点击后跳到 QQBot 控制台。
+ *
+ * 入口地址不走硬编码端口：服务端注册了同源路由 /qqbot-dashboard，会读取本插件
+ * 当前配置的 console 地址并 302 过去，这样改端口/监听地址都不需要改前端。
+ *
+ * 说明：这是 dsh Web 的 client module（window.__ModuleLoader__ 协议），
+ * 只在安装了本插件的 web profile 里出现；纯前端、无构建依赖。
+ */
+window.__ModuleLoader__.load({
+  id: 'dsh-qqbot-buddy',
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+    Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+    const jsx = require('react/jsx-runtime');
+
+    const inject = ['slots'];
+    const PAGE = 'QQBot 控制台';
+
+    /** 侧边栏底部的 QQ 快捷入口（外链走同源 302）。 */
+    function QqbotDashboardAction() {
+      return jsx.jsxs('a', {
+        href: '/qqbot-dashboard',
+        target: '_blank',
+        rel: 'noreferrer',
+        title: PAGE + '（在新标签页打开）',
+        'aria-label': PAGE,
+        className: 'qqbot-dashboard-entry',
+        style: {
+          position: 'fixed',
+          right: '16px',
+          bottom: '16px',
+          zIndex: 40,
+          pointerEvents: 'auto',
+          display: 'inline-flex',
+          alignItems: 'center',
+          justifyContent: 'center',
+          gap: '4px',
+          padding: '6px 10px',
+          borderRadius: '999px',
+          border: '1px solid var(--dsw-alias-border-l2, rgba(128,128,128,.35))',
+          background: 'var(--dsw-alias-bg-layer-2, rgba(20,20,20,.72))',
+          color: 'var(--dsw-alias-label-primary, inherit)',
+          textDecoration: 'none',
+          fontSize: '12px',
+          fontWeight: 600,
+          letterSpacing: '0.02em',
+          lineHeight: 1,
+          boxShadow: '0 2px 10px rgba(0,0,0,.18)',
+        },
+        children: [
+          jsx.jsx('span', { 'aria-hidden': 'true', children: 'QQ 控制台' }),
+        ],
+      });
+    }
+
+    function apply(ctx) {
+      // shell.overlay 是覆盖层列表槽位：不会被折叠侧栏的 hover mask 挡住，
+      // 用 fixed 定位放在左下角，任何页面都能点。
+      ctx.slots.inject('shell.overlay', () => ctx.slots.register({
+        name: 'shell.overlay',
+        id: 'qqbot-dashboard',
+        order: 20,
+      }, QqbotDashboardAction));
+    }
+
+    exports.apply = apply;
+    exports.inject = inject;
+    return module.exports;
+  },
+});

package/lib/index.js

@@ -371,6 +371,52 @@ export async function apply(ctx, config) {
     }
   }
 
+  // ── dsh Web → QQBot 控制台快捷入口 ──
+  // 客户端插件（lib/client.js）只挂一个 href="/qqbot-dashboard" 的按钮；
+  // 这里注册同源 302 路由，读取当前 console 配置并跳转，改端口/地址无需动前端。
+  try {
+    ctx.inject(['webServer'], (webCtx) => {
+      try {
+        const resolveConsoleUrl = () => {
+          try {
+            const address = runtime.console && typeof runtime.console.address === 'function' ? runtime.console.address() : null;
+            const url = address && address.url ? String(address.url) : '';
+            if (url !== '') return url.endsWith('/') ? url : url + '/';
+          } catch { /* 控制台未启动/已关闭 */ }
+          // console.enabled=false 只表示「本 profile 不启动控制台」（例如 web profile 只放入口，
+          // 控制台跑在机器人 profile 里）；跳转仍按配置的 host/port 生成。
+          const consoleCfg = cfg.console || {};
+          let host = typeof consoleCfg.host === 'string' && consoleCfg.host !== '' ? consoleCfg.host : '127.0.0.1';
+          if (host === '0.0.0.0' || host === '::') host = '127.0.0.1';
+          const port = Number(consoleCfg.port) || 6198;
+          return 'http://' + host + ':' + port + '/';
+        };
+        webCtx.webServer.register({
+          kind: 'exact',
+          path: '/qqbot-dashboard',
+          handler: (req, res) => {
+            const target = resolveConsoleUrl();
+            if (target === '') {
+              res.statusCode = 503;
+              res.setHeader('content-type', 'text/plain; charset=utf-8');
+              res.end('QQBot 控制台未启用（dsh-qqbot-buddy 配置 console.enabled）');
+              return;
+            }
+            res.statusCode = 302;
+            res.setHeader('location', target);
+            res.setHeader('cache-control', 'no-store');
+            res.end();
+          },
+        });
+        logger.info('dsh Web 快捷入口已注册: /qqbot-dashboard');
+      } catch (err) {
+        logger.warn('dsh Web 快捷入口注册失败: ' + errText(err));
+      }
+    });
+  } catch (err) {
+    logger.warn('dsh Web 快捷入口注入失败: ' + errText(err));
+  }
+
   // ── 机器人宿主 ──
   try {
     const mod = await import('./host/agent.js');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-qqbot-buddy",
-  "version": "1.0.0-alpha.1",
+  "version": "1.0.0-alpha.2",
   "description": "DSH QQ 机器人插件 v2：自包含管理控制台、配置档/会话级配置、可管理的工具与技能、SQLite+FTS5 记忆与知识库",
   "type": "module",
   "license": "MIT",
@@ -25,6 +25,7 @@
   "exports": {
     ".": "./lib/index.js",
     "./console": "./lib/console/server.js",
+    "./client": "./lib/client.js",
     "./package.json": "./package.json"
   },
   "engines": {
@@ -57,6 +58,13 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-renderer"
+      ]
     }
   },
   "bin": {