dsh-connect-minimaxcode 0.6.2 → 0.6.4

package/README.en.md

@@ -384,6 +384,19 @@ The OAuth token is valid for about an hour and is refreshed automatically by the
 
 ## Changelog
 
+### 0.6.4 (2026-11-11)
+
+- **Fixed "the self-check report never appeared"**: the previous version put the self-check in the client half (the card reports what the host offered), but **the server half was never landed** — the status document had no field to carry the report and no route to receive it, so the card reported into nowhere. It is complete now: the report is received by the plugin's own route and appears in the status document as `capability`.
+- The episode also exposed a process problem: a few anchors in the patch script missed, and its output was covered by another script in the same command, so a partial application was read as a complete one. **Every patch is now checked individually**, and an end-to-end check was added: the report counts as working only once it has travelled from the card through the route and back into the status document.
+- The route-count cases were brought up to date (the host now mounts four routes: status, action, capability, generation).
+
+### 0.6.3 (2026-11-11)
+
+- **"Could not send it to the conversation" now names the missing piece**: delivering a picture needs several pieces of the host — the session identifier, the sessions service, the session binding, a way to send or to hold a draft, and the input box's attachment channel — and they arrive in different ways. There used to be one blanket failure message; each absence now has its own: the host named no session / offers no sessions service / this session is not reachable / it cannot send / it cannot hold drafts / the input box takes no attachments.
+- **The plugin checks itself and reports**: the card tells the plugin's own route what the host actually offered when it mounts, so the status document carries that report — working on a failure no longer depends only on the sentence on the screen.
+- Also fixed a real defect the tests caught at once: the report referred to the session identifier before it was defined, and the host fires effects early, so the script broke.
+- `tests/generate-dock.spec.ts` grows to 8 cases, covering the report's content and the wording when no session is named.
+
 ### 0.6.2 (2026-11-11)
 
 - **Fixed "could not send it to the conversation"**: the previous version looked for the session among the slot's props, but the host hands the session to the slot's **injection callback** (the slot is session-scoped), so the identifier was always missing and the picture had nowhere to go. The session is now taken the way the host gives it.

package/README.md

@@ -395,6 +395,19 @@ OAuth 令牌有效期约 1 小时，由客户端自动续期。插件**只在自
 
 ## 更新记录
 
+### 0.6.4（2026-11-11）
+
+- **修复「自检报告从未出现」**：上一版把自检能力加在了客户端（卡片上报宿主提供了什么），但**服务端那一半没有落地** —— 状态文档里没有承载报告的字段，也没有接收报告的路由，于是卡片上报到哪里都无人接收。现已补齐：报告由插件自己的路由接收，并出现在状态文档的 `capability` 里。
+- 这次同时暴露了一个流程问题：补丁脚本里有几处锚点未命中，而脚本的输出被同一条命令里的另一个脚本盖住了，于是「部分应用」被当成了「全部应用」。**现在每一处补丁的成败都单独核对**，并且加了端到端验证：报告从卡片出发、经路由回到状态文档，全程贯通才算通过。
+- 顺带补上路由数量的用例（宿主侧现在有四条路由：状态、动作、自检、生成）。
+
+### 0.6.3（2026-11-11）
+
+- **「无法发送到对话」现在会说明缺哪一步**：把图片送进对话需要宿主的好几块能力（会话标识、会话服务、会话绑定、发送或草稿通道、输入框的附件通道），它们分别以不同方式交到插件手上。原先只有一句笼统的失败提示，现在每种缺失都有各自的话：宿主没给会话标识 / 没有会话服务 / 当前会话不可达 / 会话不支持发送 / 不支持草稿 / 输入框不接受附件。
+- **插件会自检并上报**：卡片在挂载时把宿主实际提供了什么报告给插件自己的路由，因此状态文档里能读到这份自检结果 —— 排查时不必只靠屏幕上的那句话。
+- 顺带修掉一处真实缺陷：自检报告引用了后面才定义的会话标识，宿主在效果阶段先跑，导致脚本崩溃（测试当场抓到）。
+- `tests/generate-dock.spec.ts` 增至 8 个用例：覆盖自检报告的内容、以及缺会话标识时的话术。
+
 ### 0.6.2（2026-11-11）
 
 - **修复「无法发送到对话」**：上一版从插槽的 props 里找会话标识，但宿主是把会话交给**插槽的注入回调**的（该插槽是会话作用域的），于是标识始终为空，图片自然送不出去。现在按宿主的方式取会话标识。

package/lib/client.js

@@ -20,6 +20,7 @@
     const STATUS_PATH = '/plugins/dsh-connect-minimaxcode/status';
     const ACTION_PATH = '/plugins/dsh-connect-minimaxcode/action';
     const GENERATE_PATH = '/plugins/dsh-connect-minimaxcode/generate';
+    const CAPABILITY_PATH = '/plugins/dsh-connect-minimaxcode/capability';
     const POLL_INTERVAL_MS = 20000;
     /**
      * The provider id the host side registers with `llm.registerAdapter`.
@@ -99,6 +100,12 @@
         generateSent: '图片已发送到对话',
         generateDrafted: '图片已放入输入框',
         generateSendFailed: '无法发送到对话，请到插件页生成后下载。',
+        generateNoSession: '宿主没有给出会话标识，无法定位对话。',
+        generateNoSessions: '宿主没有提供会话服务，无法定位对话。',
+        generateNoBinding: '当前会话不可达（宿主没有给出它的绑定）。',
+        generateNoPrompt: '当前会话不支持发送消息。',
+        generateNoDraft: '当前会话不支持草稿附件。',
+        generateNoInput: '输入框不接受附件。',
     };
     const en = {
         title: 'MiniMax Code credits',
@@ -171,6 +178,12 @@
         generateSent: 'The picture is on its way to the conversation',
         generateDrafted: 'The picture is in the input box',
         generateSendFailed: 'Could not send it to the conversation; generate on the plugin page and download it instead.',
+        generateNoSession: 'The host named no session, so the conversation cannot be located.',
+        generateNoSessions: 'The host offers no sessions service, so the conversation cannot be located.',
+        generateNoBinding: 'This session is not reachable (the host gave no binding for it).',
+        generateNoPrompt: 'This session cannot send messages.',
+        generateNoDraft: 'This session cannot hold draft attachments.',
+        generateNoInput: 'The input box does not take attachments.',
     };
     const loader = globalThis.__ModuleLoader__;
     if (loader === undefined)
@@ -454,17 +467,51 @@
                     return template.replace(/\\{(\\w+)\\}/g, (_match, name) => String(params?.[name] ?? ''));
                 });
                 const [open, setOpen] = React.useState(false);
-                const [prompt, setPrompt] = React.useState('');
-                const [busy, setBusy] = React.useState(false);
-                const [note, setNote] = React.useState('');
                 /**
                  * The session the picture belongs to.
                  *
                  * The host hands the session id to the slot through its injection,
                  * because the slot is session-scoped; it is also carried on the
-                 * standard props, so either may deliver it.
+                 * standard props, so either may deliver it. It is read here, before
+                 * anything else in the dock uses it, because an effect can fire
+                 * before the rest of the body has run.
                  */
                 const sessionId = () => props.sessionId;
+                /**
+                 * What the host offers this dock, described once.
+                 *
+                 * Delivering a picture needs several pieces of the host and they
+                 * arrive in different ways, so a failure otherwise reads as one
+                 * undifferentiated message. The report is sent to the plugin's own
+                 * route, so it can be read from the status document — by whoever is
+                 * looking at the problem, not only by the person who hit it.
+                 */
+                const reportCapability = () => {
+                    const id = sessionId();
+                    const services = clientContext?.sessions;
+                    const binding = id === undefined ? undefined : services?.binding?.(id);
+                    const scoped = id === undefined ? undefined : services?.scope?.(id);
+                    const conversation = scoped?.get?.('conversation');
+                    const findings = {
+                        sessionId: id === undefined ? 'missing' : 'present',
+                        sessionsService: services === undefined ? 'missing' : 'present',
+                        binding: binding === undefined ? 'missing' : 'present',
+                        sessionPrompt: typeof binding?.session?.prompt === 'function' ? 'present' : 'missing',
+                        scope: scoped === undefined ? 'missing' : 'present',
+                        conversationService: conversation === undefined ? 'missing' : 'present',
+                        createDrafts: typeof conversation?.createDrafts === 'function' ? 'present' : 'missing',
+                        inputActions: typeof props.inputActions?.addAttachments === 'function' ? 'present' : 'missing',
+                    };
+                    void fetch(`${CAPABILITY_PATH}?report=${encodeURIComponent(JSON.stringify(findings))}`).catch(() => {
+                        // The report is a courtesy; failing to send it changes nothing.
+                    });
+                };
+                React.useEffect(() => {
+                    reportCapability();
+                }, []);
+                const [prompt, setPrompt] = React.useState('');
+                const [busy, setBusy] = React.useState(false);
+                const [note, setNote] = React.useState('');
                 /**
                  * The session's own send path.
                  *
@@ -542,6 +589,14 @@
                         // Sending the picture as a turn is what the dock promises; the
                         // draft channel is the fallback for a host that only offers that.
                         const face = sessionFace();
+                        if (face === undefined) {
+                            const id = sessionId();
+                            setNote(id === undefined
+                                ? t('generateNoSession')
+                                : clientContext?.sessions === undefined
+                                    ? t('generateNoSessions')
+                                    : t('generateNoBinding'));
+                        }
                         if (face !== undefined) {
                             await face.prompt([part, { type: 'text', text }], 'queue', undefined, `minimax-h3-${Date.now()}`);
                             setPrompt('');
@@ -553,7 +608,19 @@
                         }
                         const drafts = draftFace();
                         const addAttachments = props.inputActions?.addAttachments;
-                        if (drafts !== undefined && typeof addAttachments === 'function') {
+                        if (drafts === undefined) {
+                            setNote(sessionId() === undefined
+                                ? t('generateNoSession')
+                                : clientContext?.sessions === undefined
+                                    ? t('generateNoSessions')
+                                    : t('generateNoDraft'));
+                            return;
+                        }
+                        if (typeof addAttachments !== 'function') {
+                            setNote(t('generateNoInput'));
+                            return;
+                        }
+                        {
                             const file = new File([base64Bytes(body.dataUrl)], 'minimax-h3-image.jpg', { type: body.mediaType ?? 'image/jpeg' });
                             const created = drafts.createDrafts(sessionId(), [file], true);
                             addAttachments(created.map(draft => draft.id));

package/lib/index.d.ts

@@ -1087,6 +1087,13 @@ interface StatusDocument {
   usageProfile?: UsageProfileStatus;
   /** The choices the generation endpoints offer. */
   generation?: GenerationOptions;
+  /** What the host offered the card the last time it looked. */
+  capability?: {
+    /** When the card reported it. */
+    at: number;
+    /** One entry per piece the card looked for. */
+    findings: Record<string, string>;
+  };
 }
 /** Inputs the document is derived from. */
 interface StatusDeps {
@@ -1119,6 +1126,13 @@ interface StatusDeps {
   usageProfile?: UsageProfileStatus;
   /** The choices the generation endpoints offer. */
   generation?: GenerationOptions;
+  /** What the host offered the card the last time it looked. */
+  capability?: {
+    /** When the card reported it. */
+    at: number;
+    /** One entry per piece the card looked for. */
+    findings: Record<string, string>;
+  };
 }
 /**
  * Build the card's status document.

package/lib/index.js

@@ -746,6 +746,16 @@ const MINIMAX_ACTION_PATH = "/plugins/dsh-connect-minimaxcode/action";
 * takes a minute and a half and is polled.
 */
 const MINIMAX_GENERATE_PATH = "/plugins/dsh-connect-minimaxcode/generate";
+/**
+* Route the card reports what the host offers it on.
+*
+* Delivering a generated picture into a conversation needs several pieces of
+* the host — the session, its face, the input box's attachment channel — and
+* they are handed over in different ways. Reporting what is actually there
+* turns "it did not work" into "this piece is missing", which is the only
+* useful answer when something like that goes wrong.
+*/
+const MINIMAX_CAPABILITY_PATH = "/plugins/dsh-connect-minimaxcode/capability";
 const HINTS = {
 	"app-missing": "未找到 MiniMax Code 的登录信息。请先安装并登录 MiniMax Code 桌面 App，然后重启 DSH。",
 	"not-signed-in": "MiniMax Code 尚未登录。请在 MiniMax Code 桌面 App 中登录后重启 DSH。",
@@ -776,6 +786,7 @@ function statusDocument(deps) {
 		...deps.signin === void 0 ? {} : { signin: deps.signin },
 		...deps.login === void 0 ? {} : { login: deps.login },
 		...deps.usageProfile === void 0 ? {} : { usageProfile: deps.usageProfile },
+		...deps.capability === void 0 ? {} : { capability: deps.capability },
 		...deps.generation === void 0 ? {} : { generation: deps.generation }
 	};
 	if (auth.state === "expired") return {
@@ -2646,6 +2657,8 @@ function apply(ctx) {
 	let loginPending = false;
 	/** Whether the server refused the plugin's own credential. */
 	let revokedByServer = false;
+	/** What the card last reported about what the host offered it. */
+	let capability;
 	/**
 	* Give up on the plugin's own credential after the server refused it.
 	*
@@ -3092,6 +3105,7 @@ function apply(ctx) {
 			signin: buildSigninStatus(),
 			login: buildLoginStatus(),
 			usageProfile: buildUsageProfileStatus(),
+			capability,
 			generation: {
 				imageModels: [...IMAGE_MODELS],
 				imageAspectRatios: [...IMAGE_ASPECT_RATIOS],
@@ -3407,6 +3421,36 @@ function apply(ctx) {
 				}
 			}
 		}));
+		webCtx.effect(() => webCtx.webServer.register({
+			kind: "exact",
+			path: MINIMAX_CAPABILITY_PATH,
+			handler: async (req, res) => {
+				if (!isLoopback(req.headers.host)) {
+					res.writeHead(403, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({ error: "loopback only" }));
+					return;
+				}
+				try {
+					const raw = new URL(req.url ?? "/", "http://127.0.0.1").searchParams.get("report") ?? "";
+					let findings = {};
+					try {
+						const parsed = JSON.parse(raw);
+						if (typeof parsed === "object" && parsed !== null) for (const [key, value] of Object.entries(parsed)) findings[key] = String(value);
+					} catch {
+						findings = { report: "unreadable" };
+					}
+					capability = {
+						at: Date.now(),
+						findings
+					};
+					res.writeHead(204);
+					res.end();
+				} catch (error) {
+					res.writeHead(500, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({ error: error instanceof Error ? error.message : String(error) }));
+				}
+			}
+		}));
 		webCtx.effect(() => webCtx.webServer.register({
 			kind: "exact",
 			path: MINIMAX_GENERATE_PATH,

package/package.json

@@ -2,7 +2,7 @@
   "name": "dsh-connect-minimaxcode",
   "displayName": "DSH Connect MiniMax Code",
   "description": "把本机已登录的 MiniMax Code 桌面 App 模型接入 DeepSeek Harness：零配置、Anthropic Messages 兼容、动态模型目录，并显示积分余额与到期 — bring MiniMax Code desktop app models into DSH with a dynamic model catalog and a credit balance with expiry details.",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "author": "JeffTsuiCUG",
   "contributors": [
     {