waygate-mmcode 0.0.0-stage → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zhanghaojie513
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,197 @@
-# Temporary Holding Version
+# waygate-mmcode
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<div align="center">
+
+**途关 · MiniMax Code 反代**
+
+把 MiniMax Code 客户端的订阅，变成你自己的本地 API
+
+![Node](https://img.shields.io/badge/Node-%E2%89%A520-3C873A?style=flat-square&logo=node.js&logoColor=white)
+![Platform](https://img.shields.io/badge/Platform-Windows-0078D4?style=flat-square&logo=windows&logoColor=white)
+![License](https://img.shields.io/badge/License-MIT-blue?style=flat-square)
+
+[快速开始](#快速开始) · [凭证互斥](#凭证互斥必读) · [客户端配置](#客户端怎么填) · [工作原理](#工作原理) · [常见问题](#常见问题) · [相关项目](#相关项目)
+
+</div>
+
+---
+
+> [!CAUTION]
+> **凭证互斥（必读）**：MiniMax 的 refresh token 是**一次性**的，且**同一账号同时只有一个有效会话**。
+> 本工具与官方客户端登录**同一个账号**会**互相踢下线**（你一登录客户端，本工具就失效；反之亦然）。
+>
+> **解决**：给本工具配一个**专用账号**（与日常使用的客户端分开注册一个即可）。
+> 登录专用账号 → 跑 `mmcode login` → 此后**不再在那个账号上登录官方客户端**。
+
+**读取本机 MiniMax Code 客户端的登录态，在本机起一个 Anthropic / OpenAI 兼容的聊天端点** ——
+Cursor、Claude Code、Cherry Studio、任何能改 base_url 的工具，都能直接用你的订阅额度。
+
+- **零配置接入** —— 一条命令起服务，打印出「代理地址 + 密钥 + 模型 ID」
+- **两个协议都认** —— `POST /v1/chat/completions`（OpenAI）与 `POST /v1/messages`（Anthropic）
+- **只在本机转** —— 读本机客户端文件、写 `~/.waygate/`、本机转发；不向任何第三方上传数据
+
+## 快速开始
+
+```bash
+# 全局安装
+npm i -g waygate-mmcode
+
+# 导入客户端登录态（在 MiniMax Code 客户端里登录专用账号后执行）
+mmcode login
+
+# 启动
+mmcode
+```
+
+```
+途关 · MiniMax Code 反代 v0.2.0
+
+凭证    ✓ access 有效约 187 分钟（下次请求自动刷新）
+上游    https://agent.minimax.cn  (Anthropic 兼容)
+代理    http://127.0.0.1:8788
+密钥    sk-mmcode-1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d
+
+模型 ID（填进你的客户端）：
+  MiniMax-M3
+  MiniMax-M3.1-Flash-Preview
+  MiniMax-M2.7
+  MiniMax-M2.7-highspeed
+
+把上面的「代理地址 + 密钥」填进 Cursor / Claude Code / Cherry Studio 等客户端即可。
+按 Ctrl+C 停止。
+```
+
+
+**要求**：Node.js ≥ 20；本机装有 MiniMax Code 桌面客户端**且已登录**（建议专用账号）。
+
+## 凭证互斥（必读）
+
+MiniMax 的会话机制决定了**同一个账号同时只有一个有效会话**。这意味着：
+
+| 你做的事 | 后果 |
+| --- | --- |
+| 本工具在跑 → 你登录官方客户端（同一账号） | **本工具失效**，需重跑 `mmcode login` |
+| 官方客户端在用 → 你启动本工具（同一账号） | 官方客户端被踢下线 |
+
+**正确姿势**：注册一个专用账号，**只在客户端登录一次**（为了导入凭证），之后**永远不在那个账号上登录客户端**。日常客户端用你的主账号，两边互不干扰。
+
+## 命令
+
+```bash
+mmcode               # 启动反代（同 mmcode serve），打印模型 ID 与代理地址
+mmcode models        # 只列出模型 ID（不起服务）
+mmcode doctor        # 自检：端口 / 凭证 / 令牌刷新 / 上游连通
+mmcode login         # 重新读取客户端登录态（令牌被顶掉/过期时用）
+mmcode checkin       # 每日签到领积分（用本工具令牌代签，无需开客户端）
+mmcode credits       # 查积分账本（剩余 / 已消耗 / 累计，精确到 0.01）
+```
+
+**签到与积分**（MiniMax Code 专属）：
+
+```bash
+$ mmcode checkin
+✓ 签到成功 +400 积分（连续第 4 天）
+
+$ mmcode credits
+MiniMax Code 积分账本
+
+剩余    4188.65
+已消耗  6611.35
+累计发放 10800
+最近到期 2026-10-14
+
+批次明细（17 笔）：
+  +400  剩 400  用 0  到期 2026-11-12
+  +800  剩 188.65  用 611.35  到期 2026-11-05
+  …（还有 7 笔）
+
+注：上游不回报单次请求消耗，以上为账户级批次累计（精确到 0.01）。
+```
+
+> **为什么能代签**：签到接口用的就是本工具已在维护的 access token。所以你**不需要为了签到去登录客户端**
+> ——（登录客户端反而会踢掉本工具）。加 `--json` 可得到机器可读输出，便于脚本/定时任务。
+
+| 参数 | 说明 |
+| --- | --- |
+| `--port <n>` | 监听端口（默认 8788） |
+| `--host <addr>` | 监听地址（默认 `127.0.0.1`） |
+| `--key <sk-…>` | 指定入站密钥（默认自动生成并缓存） |
+| `--json` | 机器可读输出 |
+| `--verbose` | 打印每个请求的路由日志 |
+
+## 客户端怎么填
+
+**Cursor / Cherry Studio / OpenAI SDK**
+
+- Base URL：`http://127.0.0.1:8788/v1`
+- API Key：启动时打印的 `sk-mmcode-…`
+- 模型：模型 ID（如 `MiniMax-M3`）
+
+**Claude Code**
+
+```bash
+ANTHROPIC_BASE_URL=http://127.0.0.1:8788
+ANTHROPIC_API_KEY=sk-mmcode-…
+```
+
+暴露的端点：`POST /v1/chat/completions` · `POST /v1/messages` · `GET /v1/models` · `GET /healthz`
+
+支持流式（SSE）与非流式（`stream: false` 时自动聚合为单个 JSON）两种响应模式。
+
+## 工作原理
+
+```mermaid
+flowchart LR
+  C[你的客户端<br/>Cursor / Claude Code]
+  M[mmcode<br/>本机 8788]
+  G[MiniMax mavis 网关]
+
+  C -->|OpenAI / Anthropic 协议| M
+  M -->|Anthropic 兼容协议| G
+
+  subgraph local [本机]
+    M
+    F[~/.waygate/mmcode/credential.json]
+  end
+  F -.->|mmcode login 写入| M
+
+  style M fill:#EDE9FE,stroke:#8B5CF6,color:#1F2328
+  style F fill:#FFFFFF,stroke:#D0D7DE,color:#1F2328
+  style C fill:#FFFFFF,stroke:#D0D7DE,color:#1F2328
+  style G fill:#FFFFFF,stroke:#D0D7DE,color:#1F2328
+  style local fill:#F6F8FA,stroke:#D0D7DE
+```
+
+- **凭证**：MiniMax Code 客户端把登录态存在 `~/.minimax/auth/prod/cn/mcode-public/auth.json`（**明文 JSON**）。`mmcode login` 读出令牌写到 `~/.waygate/mmcode/credential.json`（0600）。
+- **令牌生命周期**：access token（`mmoat_`）寿命短（约 1–4 小时），到期前 2 分钟自动刷新；refresh token（`mmort_`）刷新后会被上游**轮换**，本工具自动写回本地。
+- **模型清单**：上游**没有**清单端点（实测 `/models` 恒 503）—— 用内置清单（4 个模型），这是「目录 = 接口」原则的唯一例外。
+
+> [!NOTE]
+> **单次请求的积分消耗上游不回报** —— MiniMax 的聊天响应只有 token 数，没有单次费用字段。
+> 积分余额以[官方客户端](https://www.minimax.io)的账本页为准（精确到 0.01）。
+
+## 常见问题
+
+**要装 MiniMax Code 客户端吗？** 要。本工具不提供账号，只是把你**已有**的客户端登录态转成本地 API。
+
+**令牌被顶掉了怎么办？** 你（或别人）用同一账号登录了客户端 —— 本工具被踢。在客户端**重新登录**（用专用账号），然后跑一次 `mmcode login`。
+
+**会不会把我的令牌上传？** 不会。全程只在本机读写：读客户端文件 → 写 `~/.waygate/` → 本机转发。代码开源可查。
+
+**端口被占用？** `mmcode --port 9790`，或 `mmcode doctor` 看是哪一项没过。
+
+**支持 macOS / Linux 吗？** 是。凭证是明文 JSON，无平台专有加密。
+
+## 免责声明
+
+仅供**个人学习与研究**使用，请遵守 MiniMax 的服务条款。上游接口随时可能变更，届时本工具可能失效（`mmcode doctor` 是排查入口）。作者不对使用后果负责。
+
+## 相关项目
+
+- **[waygate-qoder](https://github.com/zhanghaojie513/waygate-qoder)** —— 同款工具，对应 Qoder CN（无凭证互斥问题）
+- **[waygate-core](https://github.com/zhanghaojie513/waygate-core)** —— 两个工具共用的骨架（`npm i waygate-core`）
+- **[relay-station](https://github.com/zhanghaojie513/relay-station)** —— 同一作者的完整多提供商反代（含控制台、用量统计）
+
+## License
+
+MIT

package/dist/activity.d.ts

@@ -0,0 +1,79 @@
+/**
+ * MiniMax Code 签到与积分账本（命令：`mmcode checkin` / `mmcode credits`）。
+ *
+ * ## 端点（自官方客户端逆向 + 生产实测）
+ *   GET  /minimax-cloud/api/v1/signin/status?timezone_id=Asia/Shanghai  —— 签到面板
+ *   POST /minimax-cloud/api/v1/signin/claim?timezone_id=Asia/Shanghai   —— 领取（body {}）
+ *   GET  /minimax-cloud/api/v1/credit/details                           —— 积分账本明细
+ *
+ * ## 为什么能代签（这是本工具相对其他方案的独特价值）
+ * Qoder / MiniMax 的「登录客户端签到」和「反代挂着」是互斥的（客户端登录会踢掉反代）。
+ * 但签到接口用的就是**本工具已在维护的 access token** —— 于是不必登客户端，直接代签。
+ *
+ * ## 积分口径（铁律：不编造）
+ * 账本是**批次级累计**（每笔发放的 授予/剩余/已消耗 + 到期时间）；上游**不回报单次请求消耗**
+ * （实测 usage 里无 credit 字段）。所以 `credits` 只给账户级余额，不做单次估算。
+ */
+/** 签面板里的一天。 */
+export interface SigninDay {
+    day_no: number;
+    points: number;
+    /** 1 = 未到，2 = 可签，3 = 已签。 */
+    status: number;
+    is_today: boolean;
+}
+export interface SigninPanel {
+    days: SigninDay[];
+    /** 今天是否可签。 */
+    claimable: boolean;
+    /** 连续天数（今天在周期里的 day_no）。 */
+    streak: number | null;
+    /** 今日应得积分（可签时）。 */
+    todayPoints: number | null;
+}
+export interface SigninResult {
+    outcome: 'claimed' | 'already' | 'unavailable' | 'error';
+    points: number | null;
+    streak: number | null;
+    message: string;
+}
+/** 一笔积分发放。 */
+export interface CreditGrant {
+    creditType: number;
+    granted: number;
+    remaining: number;
+    consumed: number;
+    grantedAt: number;
+    expireAt: number;
+}
+export interface CreditLedger {
+    /** 账户累计：授予 / 剩余 / 已消耗（各批次求和，精确到 0.01）。 */
+    granted: number;
+    remaining: number;
+    consumed: number;
+    /** 最近一笔到期时刻（epoch ms）；null = 无。 */
+    nextExpireAt: number | null;
+    grants: CreditGrant[];
+}
+export declare class MinimaxActivity {
+    private readonly token;
+    constructor(token: () => Promise<string>);
+    /** 打一次签到接口，返回 data 段。 */
+    private callSignin;
+    /** 查签到面板（不领取）。 */
+    panel(): Promise<SigninPanel>;
+    /**
+     * 签到（幂等：上游对重复 claim 会拒，这里先查面板再决定）。
+     * 领取成功后返回本次积分与连续天数。
+     */
+    checkin(): Promise<SigninResult>;
+    /**
+     * 拉积分账本。
+     * 三个金额任一缺失的批次**跳过**（宁可少算也不编）；全批次数不出来就抛错（不返回假 0）。
+     */
+    credits(): Promise<CreditLedger>;
+}
+/** 人读渲染：签到结果。 */
+export declare function renderCheckin(r: SigninResult): string;
+/** 人读渲染：积分账本。 */
+export declare function renderCredits(l: CreditLedger): string;

package/dist/activity.js

@@ -0,0 +1,183 @@
+/**
+ * MiniMax Code 签到与积分账本（命令：`mmcode checkin` / `mmcode credits`）。
+ *
+ * ## 端点（自官方客户端逆向 + 生产实测）
+ *   GET  /minimax-cloud/api/v1/signin/status?timezone_id=Asia/Shanghai  —— 签到面板
+ *   POST /minimax-cloud/api/v1/signin/claim?timezone_id=Asia/Shanghai   —— 领取（body {}）
+ *   GET  /minimax-cloud/api/v1/credit/details                           —— 积分账本明细
+ *
+ * ## 为什么能代签（这是本工具相对其他方案的独特价值）
+ * Qoder / MiniMax 的「登录客户端签到」和「反代挂着」是互斥的（客户端登录会踢掉反代）。
+ * 但签到接口用的就是**本工具已在维护的 access token** —— 于是不必登客户端，直接代签。
+ *
+ * ## 积分口径（铁律：不编造）
+ * 账本是**批次级累计**（每笔发放的 授予/剩余/已消耗 + 到期时间）；上游**不回报单次请求消耗**
+ * （实测 usage 里无 credit 字段）。所以 `credits` 只给账户级余额，不做单次估算。
+ */
+import { UpstreamError } from './errors.js';
+const MINIMAX_API = 'https://agent.minimax.cn/minimax-cloud/api/v1';
+/** 签到「今天」的时区边界（与官方客户端一致；缺参数上游报 invalid timezone_id）。 */
+const SIGNIN_TZ = 'Asia/Shanghai';
+const REQUEST_TIMEOUT_MS = 20_000;
+/** 上游信封里的业务码闸（非 0 抛错，带上游 msg）。 */
+function assertOk(body) {
+    const code = body.base_resp?.status_code;
+    if (typeof code === 'number' && code !== 0) {
+        throw new UpstreamError(body.base_resp?.status_msg ?? `上游业务码 ${code}`);
+    }
+}
+/** 取数字（数字或数字字符串）；取不到 null。 */
+function toAmount(v) {
+    if (typeof v === 'number' && Number.isFinite(v))
+        return v;
+    if (typeof v === 'string' && v.trim() !== '' && Number.isFinite(Number(v)))
+        return Number(v);
+    return null;
+}
+const round2 = (n) => Math.round(n * 100) / 100;
+export class MinimaxActivity {
+    token;
+    constructor(token) {
+        this.token = token;
+    }
+    /** 打一次签到接口，返回 data 段。 */
+    async callSignin(action) {
+        const token = await this.token();
+        const url = `${MINIMAX_API}/signin/${action}?timezone_id=${encodeURIComponent(SIGNIN_TZ)}`;
+        const res = await fetch(url, {
+            method: action === 'claim' ? 'POST' : 'GET',
+            headers: {
+                authorization: `Bearer ${token}`,
+                accept: 'application/json',
+                ...(action === 'claim' ? { 'content-type': 'application/json' } : {}),
+            },
+            ...(action === 'claim' ? { body: '{}' } : {}),
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+        if (!res.ok)
+            throw new UpstreamError(`签到接口 HTTP ${res.status}`);
+        const body = (await res.json());
+        assertOk(body);
+        if (!body.data || typeof body.data !== 'object')
+            throw new UpstreamError('签到响应缺少 data 段');
+        return body.data;
+    }
+    /** 查签到面板（不领取）。 */
+    async panel() {
+        const data = await this.callSignin('status');
+        const days = Array.isArray(data.days) ? data.days : [];
+        const today = days.find((d) => d.is_today) ?? null;
+        return {
+            days,
+            claimable: today?.status === 2,
+            streak: today?.day_no ?? null,
+            todayPoints: today?.status === 2 ? today.points : null,
+        };
+    }
+    /**
+     * 签到（幂等：上游对重复 claim 会拒，这里先查面板再决定）。
+     * 领取成功后返回本次积分与连续天数。
+     */
+    async checkin() {
+        let panel;
+        try {
+            panel = await this.panel();
+        }
+        catch (err) {
+            return { outcome: 'error', points: null, streak: null, message: err.message };
+        }
+        if (!panel.claimable) {
+            const already = panel.streak !== null;
+            return {
+                outcome: 'already',
+                points: null,
+                streak: panel.streak,
+                message: already ? `今天已签到（连续第 ${panel.streak} 天）` : '今日不可签到（活动未开始或已结束）',
+            };
+        }
+        try {
+            const data = await this.callSignin('claim');
+            const points = toAmount(data.points);
+            const streak = typeof data.day_no === 'number' ? data.day_no : panel.streak;
+            return { outcome: 'claimed', points, streak, message: `签到成功 +${points ?? '?'} 积分（连续第 ${streak ?? '?'} 天）` };
+        }
+        catch (err) {
+            return { outcome: 'error', points: null, streak: panel.streak, message: err.message };
+        }
+    }
+    /**
+     * 拉积分账本。
+     * 三个金额任一缺失的批次**跳过**（宁可少算也不编）；全批次数不出来就抛错（不返回假 0）。
+     */
+    async credits() {
+        const token = await this.token();
+        const res = await fetch(`${MINIMAX_API}/credit/details`, {
+            headers: { authorization: `Bearer ${token}`, accept: 'application/json' },
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+        if (!res.ok)
+            throw new UpstreamError(`账本接口 HTTP ${res.status}`);
+        const body = (await res.json());
+        assertOk(body);
+        if (!Array.isArray(body.details))
+            throw new UpstreamError('账本响应缺少 details 数组');
+        const grants = [];
+        for (const raw of body.details) {
+            if (!raw || typeof raw !== 'object')
+                continue;
+            const d = raw;
+            const granted = toAmount(d.granted_amount);
+            const remaining = toAmount(d.remaining_amount);
+            const consumed = toAmount(d.consumed_amount);
+            if (granted === null || remaining === null || consumed === null)
+                continue;
+            grants.push({
+                creditType: typeof d.credit_type === 'number' ? d.credit_type : 0,
+                granted,
+                remaining,
+                consumed,
+                grantedAt: typeof d.granted_at_ms === 'number' ? d.granted_at_ms : 0,
+                expireAt: typeof d.expire_at_ms === 'number' ? d.expire_at_ms : 0,
+            });
+        }
+        if (grants.length === 0) {
+            throw new UpstreamError('账本里没有可识别的积分批次（响应形状变化？）');
+        }
+        const sum = (pick) => round2(grants.reduce((s, g) => s + pick(g), 0));
+        const future = grants.filter((g) => g.expireAt > Date.now()).map((g) => g.expireAt);
+        return {
+            granted: sum((g) => g.granted),
+            remaining: sum((g) => g.remaining),
+            consumed: sum((g) => g.consumed),
+            nextExpireAt: future.length > 0 ? Math.min(...future) : null,
+            grants,
+        };
+    }
+}
+/** 人读渲染：签到结果。 */
+export function renderCheckin(r) {
+    const icon = r.outcome === 'claimed' ? '✓' : r.outcome === 'already' ? '·' : '✗';
+    return `${icon} ${r.message}`;
+}
+/** 人读渲染：积分账本。 */
+export function renderCredits(l) {
+    const lines = [];
+    lines.push('MiniMax Code 积分账本');
+    lines.push('');
+    lines.push(`剩余    ${l.remaining}`);
+    lines.push(`已消耗  ${l.consumed}`);
+    lines.push(`累计发放 ${l.granted}`);
+    if (l.nextExpireAt)
+        lines.push(`最近到期 ${new Date(l.nextExpireAt).toISOString().slice(0, 10)}`);
+    lines.push('');
+    lines.push(`批次明细（${l.grants.length} 笔）：`);
+    for (const g of l.grants.slice(0, 10)) {
+        const exp = g.expireAt ? new Date(g.expireAt).toISOString().slice(0, 10) : '—';
+        lines.push(`  +${g.granted}  剩 ${g.remaining}  用 ${g.consumed}  到期 ${exp}`);
+    }
+    if (l.grants.length > 10)
+        lines.push(`  …（还有 ${l.grants.length - 10} 笔）`);
+    lines.push('');
+    lines.push('注：上游不回报单次请求消耗，以上为账户级批次累计（精确到 0.01）。');
+    return lines.join('\n');
+}

package/dist/adapter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MiniMax Code 适配器：把「本机客户端登录态」变成「本地 Anthropic/OpenAI 兼容反代」。
+ *
+ * 与 waygate-qoder 同构（同一个 core 骨架），差异只有三处：
+ *   · 凭证：读客户端**明文** auth.json（无需解密，比 Qoder 简单）；
+ *   · 协议：上游是 **Anthropic 兼容**（`/mavis/api/v1/llm/v1/messages`），不是自研签名；
+ *   · ⚠️ 有**凭证互斥**问题（见 README），必须给用户明确告警。
+ */
+import { type Adapter, type ModelEntry } from 'waygate-core';
+export declare const DEFAULT_MMCODE_BASE_URL = "https://agent.minimax.cn";
+export declare const DEFAULT_MMCODE_CHAT_PATH = "/mavis/api/v1/llm/v1/messages";
+/**
+ * MiniMax 模型清单：上游**没有**清单端点（实测 `/mavis/api/v1/llm/v1/models` 恒 503），
+ * 故用内置清单（与 relay 的种子一致）。这是「目录 = 接口清单」原则的**唯一例外** ——
+ * 上游确实不提供，不编造其他来源，只列已知可用的这几个。
+ */
+export declare const MINIMAX_MODELS: ModelEntry[];
+/** 追加一条 OAuth 行（`~/.waygate/mmcode/oauth.json`），让 token 刷新可独立记录过期时间。 */
+export declare function statePath(): string;
+export declare function createMmcodeAdapter(opts?: {
+    baseUrl?: string;
+    chatPath?: string;
+}): Adapter;

package/dist/adapter.js

@@ -0,0 +1,150 @@
+/**
+ * MiniMax Code 适配器：把「本机客户端登录态」变成「本地 Anthropic/OpenAI 兼容反代」。
+ *
+ * 与 waygate-qoder 同构（同一个 core 骨架），差异只有三处：
+ *   · 凭证：读客户端**明文** auth.json（无需解密，比 Qoder 简单）；
+ *   · 协议：上游是 **Anthropic 兼容**（`/mavis/api/v1/llm/v1/messages`），不是自研签名；
+ *   · ⚠️ 有**凭证互斥**问题（见 README），必须给用户明确告警。
+ */
+import { chmodSync, writeFileSync } from 'node:fs';
+import { commandDir, } from 'waygate-core';
+import { join } from 'node:path';
+import { MinimaxTokenManager, clientAuthFile, credentialPath, readClientCredential, readSavedCredential, saveCredential, } from './credential.js';
+import { CredentialError, UpstreamError } from './errors.js';
+import { MinimaxActivity, renderCheckin, renderCredits } from './activity.js';
+import { anthropicToOpenAiSse } from './protocol/stream-decode.js';
+import { toAnthropicRequest } from './protocol/translate.js';
+export const DEFAULT_MMCODE_BASE_URL = 'https://agent.minimax.cn';
+export const DEFAULT_MMCODE_CHAT_PATH = '/mavis/api/v1/llm/v1/messages';
+/**
+ * MiniMax 模型清单：上游**没有**清单端点（实测 `/mavis/api/v1/llm/v1/models` 恒 503），
+ * 故用内置清单（与 relay 的种子一致）。这是「目录 = 接口清单」原则的**唯一例外** ——
+ * 上游确实不提供，不编造其他来源，只列已知可用的这几个。
+ */
+export const MINIMAX_MODELS = [
+    { id: 'MiniMax-M3', displayName: 'MiniMax M3' },
+    { id: 'MiniMax-M3.1-Flash-Preview', displayName: 'MiniMax M3.1 Flash Preview' },
+    { id: 'MiniMax-M2.7', displayName: 'MiniMax M2.7' },
+    { id: 'MiniMax-M2.7-highspeed', displayName: 'MiniMax M2.7 Highspeed' },
+];
+/** 追加一条 OAuth 行（`~/.waygate/mmcode/oauth.json`），让 token 刷新可独立记录过期时间。 */
+export function statePath() {
+    return join(commandDir('mmcode'), 'oauth.json');
+}
+export function createMmcodeAdapter(opts = {}) {
+    const baseUrl = (opts.baseUrl ?? DEFAULT_MMCODE_BASE_URL).replace(/\/+$/, '');
+    const chatPath = opts.chatPath ?? DEFAULT_MMCODE_CHAT_PATH;
+    const tokens = new MinimaxTokenManager((line) => process.stdout.write(`[mmcode] ${line}\n`));
+    const activity = new MinimaxActivity(() => tokens.accessToken());
+    return {
+        command: 'mmcode',
+        displayName: 'MiniMax Code',
+        defaultPort: 8788,
+        upstreamLabel: `${baseUrl}  (Anthropic 兼容)`,
+        // 注意：MiniMax 无需登录态就能列模型 —— 用内置清单（上游无清单端点）。
+        /** [专属子命令] MiniMax 的签到与积分 —— 用本工具维护的令牌代签，无需开客户端。 */
+        extraCommands: [
+            {
+                name: 'checkin',
+                summary: '每日签到领积分（用本工具令牌代签，无需开客户端）',
+                usage: 'checkin',
+                async run({ json }) {
+                    const r = await activity.checkin();
+                    return json ? JSON.stringify(r, null, 2) : renderCheckin(r);
+                },
+            },
+            {
+                name: 'credits',
+                summary: '查询积分账本（剩余/已消耗/累计，精确到 0.01）',
+                usage: 'credits',
+                async run({ json }) {
+                    const l = await activity.credits();
+                    return json ? JSON.stringify(l, null, 2) : renderCredits(l);
+                },
+            },
+        ],
+        async credentialStatus() {
+            const saved = readSavedCredential();
+            if (saved) {
+                const left = saved.expiresAt ? Math.round((saved.expiresAt - Date.now()) / 60000) : null;
+                const state = left !== null && left > 0 ? `access 有效约 ${left} 分钟` : 'access 可能已过期（下次请求会自动刷新）';
+                return { ok: true, detail: `${state}${saved.account ? `（账号 ${saved.account}）` : ''}`, source: credentialPath() };
+            }
+            try {
+                const c = readClientCredential();
+                return { ok: true, detail: `已从客户端读取登录态${c.account ? `（${c.account}）` : ''} —— 建议跑一次 mmcode login 落盘`, source: clientAuthFile() };
+            }
+            catch (err) {
+                return { ok: false, detail: err.message };
+            }
+        },
+        async login() {
+            const cred = readClientCredential();
+            const path = saveCredential(cred);
+            /* 独立的状态文件：记录过期时刻，便于 doctor 展示（凭证本体在 credential.json）。 */
+            writeFileSync(statePath(), JSON.stringify({ expiresAt: cred.expiresAt, account: cred.account ?? null }, null, 2) + '\n', { mode: 0o600 });
+            try {
+                chmodSync(statePath(), 0o600);
+            }
+            catch {
+                /* Windows 语义有限 */
+            }
+            const left = cred.expiresAt ? Math.round((cred.expiresAt - Date.now()) / 60000) : null;
+            process.stdout.write(`已读取客户端登录态${cred.account ? `（账号 ${cred.account}）` : ''}\n` +
+                `已保存到 ${path}\n` +
+                (left !== null ? `access token 剩余约 ${left} 分钟（到期自动刷新）\n` : '') +
+                `\n⚠️  提醒：MiniMax 同一账号只能有一个有效会话 —— 本工具与官方客户端同时登录同一账号会互相踢下线。\n` +
+                `    建议给本工具配专用账号（与日常使用的客户端分开）。\n`);
+        },
+        async listModels() {
+            /* 上游无清单端点（实测 503）—— 用内置清单，见 MINIMAX_MODELS 注释。 */
+            return MINIMAX_MODELS;
+        },
+        async doctorChecks() {
+            const checks = [];
+            /* [复核修正] 此前 .catch(()=>null) 吞掉了所有网络错误 → 「上游连通」恒报 ✓。
+               fetch 只在网络不可达（DNS/超时/拒连）时抛错；HTTP 404/502 不抛（反而证明可达）。 */
+            try {
+                await fetch(`${baseUrl}/mavis/api/v1/llm/v1/models`, { signal: AbortSignal.timeout(8000) });
+                checks.push({ name: '上游连通', ok: true, detail: `${baseUrl} 可达` });
+            }
+            catch (err) {
+                checks.push({ name: '上游连通', ok: false, detail: err.message });
+            }
+            /* 取一次 token：既验证刷新链是否可用，也把轮换写回（doctor 顺手做体检）。 */
+            try {
+                const t = await tokens.accessToken();
+                checks.push({ name: '令牌刷新', ok: true, detail: `可刷新（${t.slice(0, 8)}…）` });
+            }
+            catch (err) {
+                checks.push({ name: '令牌刷新', ok: false, detail: err.message });
+            }
+            return checks;
+        },
+        async chat(body, signal) {
+            const token = await tokens.accessToken();
+            const payload = JSON.stringify(toAnthropicRequest(body));
+            const res = await fetch(`${baseUrl}${chatPath}`, {
+                method: 'POST',
+                headers: {
+                    authorization: `Bearer ${token}`,
+                    'content-type': 'application/json',
+                    accept: 'text/event-stream',
+                    'anthropic-version': '2023-06-01',
+                    'user-agent': 'MiniMaxCode',
+                },
+                body: payload,
+                signal,
+            });
+            if (!res.ok || !res.body) {
+                const text = await res.text().catch(() => '');
+                if (res.status === 401 || res.status === 403) {
+                    throw new CredentialError(`上游鉴权失败（HTTP ${res.status}）—— 令牌可能已被官方客户端顶掉或过期：在客户端重新登录后跑一次 mmcode login`);
+                }
+                throw new UpstreamError(`上游 HTTP ${res.status}${text ? `：${text.slice(0, 200)}` : ''}`);
+            }
+            /* 上游 Anthropic 事件流 → OpenAI SSE（core 负责把流吐给客户端）。 */
+            return { stream: res.body.pipeThrough(anthropicToOpenAiSse()), status: 200 };
+        },
+    };
+}