dsh-im-union 0.4.12 → 0.5.0

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 本项目版本号遵循语义化版本；发布面与宿主兼容矩阵见 `scripts/hosts.mjs`（README 管理块同源）。
 
+## 0.5.0（QQ 渠道能力补齐：出站图片 / Markdown / 入站图片文件 / 审批按钮 / 群管理）
+
+对照 `_ref-im/dsh-qqbot`（同一套 QQ 官方 api-v2）逐面解锁 `src/channels/qq.ts`，遵守净室 / 零运行时依赖 / D7 纪律。
+
+### Added
+
+- **出站图片 `caps.fileOut` + `sendFile`**：上传换 file_info → msg_type=7 携带 **`media: { file_info }`**（体形按官方 `@tencent-connect/qqbot-nodejs` 1.0.5 `sendMediaMessage` 对账，非旧式 `image: file_info`）；上传采用**双形态递降**：先官方 SDK 小文件形态（JSON + base64 `file_data`，`file_type=1`、`srv_send_msg=false`），被平台确定性拒绝再回退官方文档记载的 multipart/form-data 形态一次（网络不确定绝不重试，D7 免白占配额）；群/单聊分 `/files` 端点，窗口内带 msg_id/seq；一举激活网关 SVG→PNG 附图链、产物回传与 `/export`。非图片 mime（zip/文件）优雅拒绝（官方 file_type=4 未开放）；304080/40093002 确定性转译
+- **Markdown 出站 msg_type=2**：正文含 `![` 图片内嵌或 `qqbot-media://` 时走 markdown 通道；被平台确定性拒绝（如 304036 无模板权限）自动降级纯文本重发一次
+- **Markdown 内联本地图片自动上传（task_8）**：新增 `QqAdapter.uploadMarkdownImage`（3 步 `/v2/media-images`：prepare→COS 直传→complete，sha256 内容指纹去重、10MB 上限），gateway 投递前将正文 `![](本地路径)` 经宿主 `workspaceFiles` 受管读（workspaceRoot 限定，适配器不碰盘）取字节上传、回替 `qqbot-media://` url；非 QQ/无本地图/读失败/上传失败均原样保留
+- **入站图片/文件 `caps.imageIn/fileIn`**：事件 `attachments[].url`（rkey 时效）即时下载填 `images[]/files[]`（含 mimeType）；群聊图片 content_type 实测为 'file' → 兼用 URL 形态判定；无 arrayBuffer/非 2xx/空字节按占位不丢事件；入站派发改串行链保序（异步下载不打乱消息顺序）
+- **审批/提问按钮 `askChoices`（keyboard）**：msg_type=2 + **`keyboard: { content: { rows } }`**（官方 InlineKeyboard 包装层，少一层平台不渲染），action.type=1 回传；收到 INTERACTION_CREATE 后**best-effort `PUT /interactions/{id} {code:0}` 上确认**再结算；D5 仅接受发起者点按；`config.keyboard=on` 才订阅 INTERACTION intent 并置 `nativeChoices=true`（默认关=零风险，未配置回退数字菜单）
+- **语音入站免解码**：优先取事件原生 `asr_refer_text` 作正文，无则占位；不引入 silk 解码依赖
+- **QQ 群管理**：新建 `src/channels/qq-group-admin.ts`（FEATURE_GATES 门控 + 端点/错误码人话映射），QqAdapter 暴露入群申请列表/审批、群禁言查询/设置、消息撤回；经 `/qq` 命令面可达，仅群聊、作用于本群、需 `config.groupAdminUsers` 授权名单（空=命令惰性拒绝）+ 机器人为群管理员
+
+### Notes
+
+- 撤回/编辑 `editStream`、原生流式 `nativeStream` 本轮不做（协议语义未逐面核实、与 dsh-qqbot 打平）
+- 全量 753 单测绿（QQ +8）；真机农场冒烟需 QQ 凭据待验
+
 ## 0.4.12（飞书审批卡片：权限 ask 走按钮确认）
 
 ### Added

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dsh-im-union",
   "name": "dsh-im-union",
-  "version": "0.4.12",
+  "version": "0.5.0",
   "description": {
     "en": "Union IM bridge for DeepSeek Harness: multi-account bots across messaging platforms, each chat bound to its own session, with cross-host-version compatibility (0.1.2-rc.1 .. 0.2.1-rc.3).",
     "zh": "DeepSeek Harness 的 IM 联合桥：多平台多账号机器人、每个聊天绑定独立会话，跨宿主版本兼容（0.1.2-rc.1 至 0.2.1-rc.3）。"

package/lib/channels/meta.js

@@ -70,7 +70,12 @@ export const CHANNEL_META = {
         id: 'qq',
         label: { zh: 'QQ', en: 'QQ' },
         bind: 'qr-or-credentials',
-        fields: [cred('appId', 'AppID', 'AppID'), cred('appSecret', 'AppSecret', 'AppSecret')],
+        fields: [
+            cred('appId', 'AppID', 'AppID'),
+            cred('appSecret', 'AppSecret', 'AppSecret'),
+            plain('keyboard', '审批/提问按钮面 on/off（需机器人已开通交互事件与按钮模板）', 'Approval/question keyboard on/off (requires interaction events + button template)'),
+            plain('groupAdminUsers', '群管理(/qq)授权成员 openid（逗号分隔；空=禁用）', 'Group-admin (/qq) authorized member openids (comma separated; empty=disabled)'),
+        ],
     },
     slack: {
         id: 'slack',

package/lib/channels/qq-group-admin.d.ts

@@ -0,0 +1,35 @@
+/**
+ * QQ 普通群管理 —— 能力门控元数据与人话映射（P6/F6）。
+ *
+ * 依据 QQ 官方 api-v2「群聊管理」接口的开放度分档（2026 实测，与 dsh-qqbot 侧同源事实核对）：
+ *   🔴 未开放（内邀中）：成员列表 / 成员信息 —— 调用得 11253（仅白名单/未开放）；
+ *   🟡 门槛=机器人为群管理员：入群申请列表/审批、群禁言查询/设置、群消息撤回（2 分钟窗口）；
+ *   🟢 踢人（batch_remove_members）：2026-10-20 起后台「权限」页可勾选，按错误码动态裁决、不硬关。
+ *
+ * 本文件只放「门控表 + 端点常量 + 错误码→人话」这类纯数据/纯函数，实际 REST 由 QqAdapter 复用
+ * 其既有 token/http 面发起（见 qq.ts 群管方法），避免另起一套凭证缓存。
+ *
+ * 端点（base=https://api.bot.qq.com，鉴权头 QQBot {access_token}）：
+ * - 入群申请列表  GET  /v2/groups/{gid}/join_request_list
+ * - 审批入群申请  POST /v2/groups/{gid}/approval_join_request/{member_openid}  {op:'approve'|'decline', join_request_id?}
+ * - 群禁言查询    GET  /v2/groups/{gid}/restrict_chat_setting
+ * - 设置群禁言    POST /v2/groups/{gid}/restrict_chat_setting  {members:[{op:'add'|'del', member_openid, mute_expire_at}]}
+ * - 撤回群消息    DELETE /v2/groups/{gid}/messages/{message_id}   （仅机器人自己发的，窗口 2 分钟）
+ */
+/** 群管能力门控：UI/命令据此裁决；官方开放后把对应项 open 改 true 即可点亮，未开门一律拒绝不猜发。 */
+export interface QqGroupGate {
+    readonly open: boolean;
+    readonly human: string;
+}
+export declare const QQ_GROUP_FEATURE_GATES: Record<string, QqGroupGate>;
+/** 官方群管/权限相关错误码 → 面向用户的一句话（人话），映射不到回落通用文案。 */
+export declare function qqGroupErrHuman(code: string | number): string;
+/** 单个群管 REST 调用的返回形态：成功带 data，失败带 code + human（UI/命令直接展示 human）。 */
+export type QqGroupResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    code: string;
+    human: string;
+};

package/lib/channels/qq-group-admin.js

@@ -0,0 +1,43 @@
+/**
+ * QQ 普通群管理 —— 能力门控元数据与人话映射（P6/F6）。
+ *
+ * 依据 QQ 官方 api-v2「群聊管理」接口的开放度分档（2026 实测，与 dsh-qqbot 侧同源事实核对）：
+ *   🔴 未开放（内邀中）：成员列表 / 成员信息 —— 调用得 11253（仅白名单/未开放）；
+ *   🟡 门槛=机器人为群管理员：入群申请列表/审批、群禁言查询/设置、群消息撤回（2 分钟窗口）；
+ *   🟢 踢人（batch_remove_members）：2026-10-20 起后台「权限」页可勾选，按错误码动态裁决、不硬关。
+ *
+ * 本文件只放「门控表 + 端点常量 + 错误码→人话」这类纯数据/纯函数，实际 REST 由 QqAdapter 复用
+ * 其既有 token/http 面发起（见 qq.ts 群管方法），避免另起一套凭证缓存。
+ *
+ * 端点（base=https://api.bot.qq.com，鉴权头 QQBot {access_token}）：
+ * - 入群申请列表  GET  /v2/groups/{gid}/join_request_list
+ * - 审批入群申请  POST /v2/groups/{gid}/approval_join_request/{member_openid}  {op:'approve'|'decline', join_request_id?}
+ * - 群禁言查询    GET  /v2/groups/{gid}/restrict_chat_setting
+ * - 设置群禁言    POST /v2/groups/{gid}/restrict_chat_setting  {members:[{op:'add'|'del', member_openid, mute_expire_at}]}
+ * - 撤回群消息    DELETE /v2/groups/{gid}/messages/{message_id}   （仅机器人自己发的，窗口 2 分钟）
+ */
+export const QQ_GROUP_FEATURE_GATES = {
+    listJoinRequests: { open: true, human: '入群申请列表：机器人需为该群管理员' },
+    approveJoinRequest: { open: true, human: '入群申请审批：机器人需为该群管理员' },
+    getMuteState: { open: true, human: '群禁言状态查询：机器人需为该群管理员' },
+    setMute: { open: true, human: '设置禁言：机器人需为该群管理员（仅普通成员，最长 30 天，单次 ≤20 人）' },
+    recallMessage: { open: true, human: '撤回群消息：仅机器人自己发的、2 分钟窗口内' },
+    // 内邀中：不调用、命令侧直接告知未开放（开放后改 open:true 即自动可用）。
+    listMembers: { open: false, human: '获取群成员列表：官方尚未开放（内邀中），等待公测后自动可用' },
+    getMemberInfo: { open: false, human: '获取群成员信息（含昵称）：官方标注「内邀接入中」，申请到白名单后自动可用' },
+};
+/** 官方群管/权限相关错误码 → 面向用户的一句话（人话），映射不到回落通用文案。 */
+export function qqGroupErrHuman(code) {
+    const c = String(code);
+    const table = {
+        '11253': '该能力官方尚未开放/无接口权限（内邀中或需白名单），请联系平台运营或改为管理员后重试',
+        '11703': '机器人无该接口权限：需为该群管理员，或该能力尚未对应用开放',
+        '11201': '机器人不在该群，或群 openid/参数错误',
+        '40103004': '不能操作该成员：群主/管理员/机器人不可被禁言（只能禁普通成员）',
+        '40101': '频控：请求太快，稍等再试',
+        '401': '访问凭证无效，请刷新后重试',
+        '403': '机器人缺少群管理员身份或未授权',
+        '11001': '接口或参数不正确（多为路径/字段写错）：检查 URL 与参数',
+    };
+    return table[c] ?? `调用失败（错误码 ${c}），请稍后重试`;
+}

package/lib/channels/qq.d.ts

@@ -46,9 +46,12 @@
  * 3. 编辑/撤回（PATCH/DELETE .../messages/{id}）：群聊撤回路径未逐面核实 → editStream=false。
  * 4. keyboard 按钮面（需后台模板/回调配置 + INTERACTION_CREATE 链路）→ nativeChoices=false，
  *    审批/提问由公共层自动落「数字菜单」回退，本适配器无按钮实现。
- * 5. 入站附件下载（attachments[].url 带 rkey 时效，语音/文件下载权限未核）→ imageIn=false、fileIn=false，
- *    只给占位文案，不丢事件。
- * 6. 出站富媒体（须换 file_info + 日配额 40093002 + file_type=4「暂不开放」）→ fileOut=false。
+ * 5. 入站附件下载（P3/F3 已实现图片/文件档）：attachments[].url 带 rkey 时效 → 事件到达即下载填
+ *    images[]/files[]；content_type 群聊图片实测为 'file' → 兼用 URL 形态判定；下载失败/过期/无 arrayBuffer
+ *    面 → 按占位文案不丢事件。语音（voice=false）不解码，取事件原生 asr_refer_text 转写（见 inboundText）。
+ * 6. 出站富媒体（P1/F1 已实现图片档）：先上传换 file_info、msg_type=7 携带；file_type=4 文件官方
+ *    「暂不开放」→ 仅图片（png/jpeg/gif/webp）可发，非图片优雅拒绝；日配额 40093002、file_info 过期 304080
+ *    均确定性转译。群/单聊上传接口不互通 → 按 address.kind 选端点。
  * 7. 频道（guild/子频道/私信）事件与 REST、语音 AUDIO_* 位、表情表态是否对群/C2C 开放 → 均不实现
  *    （threads=false、voice=false、statusReaction=false）。
  * 8. webhook 回调模式（op12/op13）与多分片（shard>1）：只走 WS 长连接单分片 [0,1]。
@@ -58,18 +61,23 @@
  * fetchImpl/SocketImpl，不发真实网络请求。
  */
 import type { ChatAddress } from '../engine/router.js';
-import type { ChannelAdapter, ChannelCaps, ChannelDiagnosisCheck, MessageListener, Receipt, SemanticMessage } from './types.js';
+import type { ChannelAdapter, ChannelCaps, ChannelDiagnosisCheck, MessageListener, OutboundFile, Receipt, SemanticMessage } from './types.js';
+import type { QqGroupResult } from './qq-group-admin.js';
 /** 群/C2C 事件族（1<<25）：C2C_MESSAGE_CREATE + GROUP_AT_MESSAGE_CREATE。 */
 export declare const QQ_INTENTS_GROUP_AND_C2C: number;
+/** 交互事件族（INTERACTION_CREATE，1<<26）：仅在 config 开 keyboard 时订阅（无权限会致 IDENTIFY 拒载）。 */
+export declare const QQ_INTENTS_INTERACTION: number;
 interface JsonHttpFace {
     ok: boolean;
     status: number;
     json(): Promise<unknown>;
+    /** 入站附件下载用（P3/F3）：全局 fetch 的 Response 自带；测试替身缺位则视为不可下载、优雅跳过。 */
+    arrayBuffer?(): Promise<ArrayBuffer>;
 }
 type JsonHttpCall = (url: string, init: {
     method?: string;
     headers?: Record<string, string>;
-    body?: string;
+    body?: string | FormData | Uint8Array;
     signal?: AbortSignal;
 }) => Promise<JsonHttpFace>;
 interface SocketFace {
@@ -94,6 +102,8 @@ export interface QqAdapterOptions {
     fetchImpl?: JsonHttpCall;
     SocketImpl?: SocketDial;
     logger?: (msg: string) => void;
+    /** 开启 keyboard 按钮面（审批/提问）：订阅 INTERACTION intent + nativeChoices 置真；默认关（零风险）。 */
+    enableKeyboard?: boolean;
     /** 下列三项为测试/调参面，默认取协议保守值。 */
     passiveWindowMs?: number;
     passiveMaxUses?: number;
@@ -138,6 +148,10 @@ export declare class QqAdapter implements ChannelAdapter {
     private shuttingDown;
     private readonly windows;
     private readonly seen;
+    private readonly pendingChoice;
+    /** 入站派发串行链：保证按到达顺序派发（附件消息先下好字节再发，不越过后续消息）。 */
+    private dispatchTail;
+    private readonly enableKeyboard;
     constructor(options: QqAdapterOptions);
     onMessage(listener: MessageListener): () => void;
     /** 换 access_token 并缓存；文档口径 expires_in≤7200s 且期内不刷新，故提前 120s 续期。 */
@@ -174,8 +188,6 @@ export declare class QqAdapter implements ChannelAdapter {
      * 相同消息 id 重复推送（协议明载「相同 msg_id 可能重复推送」，按 d.id 去重）。
      */
     normalize(type: string, frame: UnknownRecord): SemanticMessage | undefined;
-    /** 富文本/卡片/附件入站给占位文案而不丢事件（caps.imageIn/fileIn=false，不下载字节）。 */
-    private inboundText;
     /** message_type=103 引用消息：被引用正文在 msg_elements[0].content（协议可据）。 */
     private quoteOf;
     private timeOf;
@@ -185,8 +197,9 @@ export declare class QqAdapter implements ChannelAdapter {
     private liveWindow;
     private endpoint;
     /**
-     * 文本出站：msg_type=0（官方文档口径；台账原文写 1，以公开文档为准，见文件头接口页引用）。
-     * 窗口内带 msg_id+msg_seq（被动回复），否则为主动消息（无 msg_id）。
+     * 文本出站：默认 msg_type=0（官方文档口径）。含 markdown 图片内嵌（`![` 或 `qqbot-media://`）时
+     * 走 msg_type=2（markdown 通道才渲染图）；若 markdown 档被平台确定性拒绝（未开通/体不符）且非窗口类
+     * 拒绝，降级重发一次纯文本（协议安全：纯文本通道总是可用）。窗口内带 msg_id+msg_seq，每次 HTTP 尝试递增 seq 防撞去重。
      */
     reply(address: ChatAddress, text: string, signal?: AbortSignal): Promise<Receipt>;
     /**
@@ -195,14 +208,94 @@ export declare class QqAdapter implements ChannelAdapter {
      * 失败一律吞：typing 属装饰面，不得影响主回复链。
      */
     setTyping(address: ChatAddress): Promise<void>;
+    /** 富媒体上传端点：群/单聊不互通（文件头 6），路径与消息端点同构但尾缀 /files。 */
+    private uploadEndpoint;
+    /**
+     * 上传换 file_info（仅图片档 file_type=1）。**双形态递降**：先按官方 Node SDK（
+     * @tencent-connect/qqbot-nodejs 1.0.5 `MediaApi.uploadMedia`）的小文件形态——JSON +
+     * base64 `file_data`（已被在跑的真机器人证明可用）；若平台确定性拒绝，再回退官方文档记载的
+     * multipart/form-data 形态一次。网络不确定（uncertain）绝不重试（D7：上传重试会白占配额）。
+     * 两种形态均带 `srv_send_msg=false`，否则平台会自己把图发出去与我们后续 msg_type=7 构成重发。
+     */
+    private uploadFile;
+    /** 小文件上传（官方 SDK 形态）：POST …/files 体 {file_type, file_name, file_data(base64), srv_send_msg:false}。 */
+    private uploadFileJson;
+    /** 上传备形态（官方文档记载）：multipart/form-data，file_data 为二进制部分。 */
+    private uploadFileForm;
+    /**
+     * 出站图片：先上传换 file_info，再以 msg_type=7 携带 image 发送（群/单聊分端点）。窗口内带
+     * msg_id+msg_seq（同 reply 纪律，撞窗清空窗口）。QQ 官方机器人仅图片档开放，非图片 mime 优雅
+     * 拒绝（不静默）；空字节拒发。file_info 过期(304080)/日配额(40093002)→确定性转译上抛。
+     */
+    sendFile(address: ChatAddress, file: OutboundFile, signal?: AbortSignal): Promise<Receipt>;
+    /** 富文本/卡片/附件入站给占位文案而不丢事件；语音取事件原生 ASR 转写（P4/F5、免解码）。 */
+    private inboundText;
+    /**
+     * 入站派发（P3/F3）：若附件可下载且本渠道开了 imageIn/fileIn → 先抢时效下载再派发；否则同步派发。
+     * 下载失败/过期不阻断（fillInboundAttachments 内部逐项吞错），事件绝不丢。
+     */
+    private dispatchInbound;
+    /**
+     * 逐个下载附件字节填入 images[]/files[]（rkey 时效，事件到达即拉）。图片优先按 content_type，
+     * 群聊图片 content_type 实测为 'file' → 兼用 URL 形态兵底；无 arrayBuffer 面/非 2xx/空字节 → 跳过不丢。
+     * 语音/视频不归入下载（voice=false，不入字节）。
+     */
+    private fillInboundAttachments;
+    /**
+     * 审批/提问按钮（P5/F4）：msg_type=2 + keyboard 行按钮（action.type=1 回传交互），等 INTERACTION_CREATE
+     * 回包结算。未启用 keyboard / 多选 / 选项为空 → 抛错（引擎回落文本菜单）；发送失败同样上抛→回落。
+     * D5：仅接受发起者（ownerUserId）点按，非发起者忽略；超时/取消→空答（uncertain=false）。
+     */
+    askChoices(address: ChatAddress, question: string, options: readonly string[], multi: boolean, signal?: AbortSignal, opts?: {
+        ownerUserId?: string;
+    }): Promise<{
+        answer: string;
+        uncertain: boolean;
+    }>;
+    /** INTERACTION_CREATE 消息按钮回传：解出 token+idx → 定位 pending → D5 发起者校验 → 结算。 */
+    private handleInteraction;
     /** 渠道内不做准入判断：白名单归网关（红线 D6），恒交回 undefined。 */
     authorize(): boolean | undefined;
+    /**
+     * markdown 内联本地图的媒体上传原语（P8/task_8）：走 3 步 /v2/media-images——prepare→PUT presigned→complete，
+     * 返 `qqbot-media://` url 供写进 msg_type=2 正文。**适配器不读盘**：字节由调用方（gateway 受管工作区读）传入。
+     * 先查服务端同名（含内容指纹）复用不占配额；md5/sha1/sha256 走 node:crypto；网络/平台码→QqGroupResult 失败体。
+     */
+    uploadMarkdownImage(file: OutboundFile, signal?: AbortSignal): Promise<QqGroupResult<{
+        url: string;
+        imageId: string;
+    }>>;
+    /** 能力门：官方未开（内邀中）直接回人话拒绝，不发请求（未逐面核协议不猜发）。 */
+    private gateGroup;
+    /** REST 抛错→统一群管返回体：平台码人话化，网络不确定标记为需复查（不自动重试）。 */
+    private toGroupErr;
+    /** 入群申请列表（🟡 群管理员）。 */
+    qqGroupListJoinRequests(gid: string, signal?: AbortSignal): Promise<QqGroupResult<UnknownRecord[]>>;
+    /** 审批入群申请（🟡 群管理员；op=approve|decline）。 */
+    qqGroupApproveJoin(gid: string, memberOpenid: string, op: 'approve' | 'decline', opts?: {
+        joinRequestId?: string;
+        signal?: AbortSignal;
+    }): Promise<QqGroupResult<true>>;
+    /** 查询群禁言状态（🟡 群管理员）。 */
+    qqGroupGetMuteState(gid: string, signal?: AbortSignal): Promise<QqGroupResult<UnknownRecord>>;
+    /**
+     * 设置群禁言（🟡 群管理员；仅普通成员，单次≤20 人）。muteSeconds<=0 → 解除禁言（del）；
+     * 否则 add 逐条发（官方 add 批量会 50015013，del 支持一次多）。mute_expire_at 用 RFC3339。
+     */
+    qqGroupSetMute(gid: string, memberOpenids: readonly string[], muteSeconds: number, signal?: AbortSignal): Promise<QqGroupResult<true>>;
+    /** 撤回消息（🟡 仅机器人自己发的、2 分钟窗口；scope=group|c2c）。DELETE 容忍空回包。 */
+    qqGroupRecall(peerId: string, msgId: string, scope?: 'group' | 'c2c', signal?: AbortSignal): Promise<QqGroupResult<true>>;
     /**
      * 诊断三态：token 面实探（只回显有效期，零 secret）；gateway 会话位；
      * roundtrip（真实收发闭环）恒 unverified；富媒体能力 unverified（平台侧开通/日配额）。
      */
     diagnose(signal?: AbortSignal): Promise<ChannelDiagnosisCheck[]>;
 }
+/**
+ * 扫描正文 `![alt](path)` 将本地图片路径交给 resolveAndUpload（由调用方以受管工作区读+上传实现），
+ * 拿到 url 则替换，拿不到（不可解/越界/上传失败）保留原样。网络图/data:/qqbot-media: 不碰。
+ */
+export declare function rewriteMarkdownLocalImages(text: string, resolveAndUpload: (rawPath: string, alt: string) => Promise<string | undefined>): Promise<string>;
 /** 按 UTF-8 字节预算安全截断（不切裂代理对），超限补省略号。 */
 export declare function fitByteBudget(text: string, maxBytes?: number): string;
 /** 工厂：secrets 取 meta(qq) 字段名 appId/appSecret；config 可覆盖 apiBaseUrl/tokenUrl。 */