codexmate 0.0.18 → 0.0.20

package/README.en.md

@@ -23,17 +23,20 @@ Codex Mate is a local-first CLI + Web UI for unified management of:
 - Codex provider/model switching and config writes
 - Claude Code profiles (writes to `~/.claude/settings.json`)
 - OpenClaw JSON5 profiles and workspace `AGENTS.md`
-- Local Codex/Claude sessions (list/filter/export/delete)
+- Local skills market for Codex / Claude Code (target switching, local skills management, cross-app import, ZIP distribution)
+- Local Codex/Claude sessions (list/filter/export/delete) with Usage analytics overview
 
-It works on local files directly and does not require cloud hosting.
+It works on local files directly and does not require cloud hosting. The skills market is also local-first: it operates on local directories and does not depend on a remote marketplace.
 
-## Why Codex Mate?
+## Comparison
 
 | Dimension | Codex Mate | Manual File Editing |
 | --- | --- | --- |
 | Multi-tool management | Codex + Claude Code + OpenClaw in one entry | Different files and folders per tool |
 | Operation mode | CLI + local Web UI | Manual TOML/JSON/JSON5 edits |
-| Session handling | Browse/export/batch cleanup | Manual file location and processing |
+| Session handling | Browse/filter/Usage analytics/export/batch cleanup | Manual file location and processing |
+| Skills reuse | Local skills market + cross-app import + ZIP distribution | Manual folder copy and reconciliation |
+| Operational visibility | Unified view of config, sessions, and Usage summaries | Depends on manual file inspection and scattered commands |
 | Rollback readiness | Backup before first takeover | Easy to overwrite by mistake |
 | Automation integration | MCP stdio (read-only by default) | Requires custom scripting |
 
@@ -49,9 +52,16 @@ It works on local files directly and does not require cloud hosting.
 - Unified Codex + Claude session list
 - Local session pinning with persistent pinned state and pinned-first ordering
 - Keyword/source/cwd filters
+- Usage subview with 7d / 30d session trends, message trends, source share, and top paths
 - Markdown export
 - Session-level and message-level delete (supports batch)
 
+**Skills Market**
+- Switch the skills install target between Codex and Claude Code
+- Inspect local installed skills, root paths, and status
+- Scan importable sources from `Codex` / `Claude Code` / `Agents`
+- Support cross-app import, ZIP import/export, and batch delete
+
 **Engineering Utilities**
 - MCP stdio domains (`tools`, `resources`, `prompts`)
 - Built-in proxy controls (`proxy`)
@@ -74,15 +84,16 @@ flowchart TB
       API["Local HTTP API"]
       MCPS["MCP stdio Server"]
       PROXY["Built-in Proxy"]
-      SERVICES["Config / Sessions / Skills / Workflow"]
+      SERVICES["Config / Sessions & Usage / Skills Market / Workflow"]
       CORE["File IO / Network / Diff / Session Utils"]
     end
 
     subgraph Data["Local Files"]
-      CODEX["~/.codex"]
-      CLAUDE["~/.claude"]
-      OPENCLAW["~/.openclaw"]
-      STATE["sessions / trash / workflow runs"]
+      CODEX["~/.codex/config + auth + models"]
+      CLAUDE["~/.claude/settings.json"]
+      OPENCLAW["~/.openclaw/*.json5 + ~/.openclaw/openclaw.json + workspace/AGENTS.md"]
+      SKILLS["~/.codex/skills / ~/.claude/skills / ~/.agents/skills"]
+      STATE["sessions / usage aggregates / trash / workflow runs / skill exports"]
     end
 
     CLI --> ENTRY
@@ -100,6 +111,7 @@ flowchart TB
     CORE --> CODEX
     CORE --> CLAUDE
     CORE --> OPENCLAW
+    CORE --> SKILLS
     CORE --> STATE
 ```
 
@@ -114,7 +126,9 @@ codexmate status
 codexmate run
 ```
 
-Default listen address is `127.0.0.1:3737`, and browser auto-open is enabled by default.
+Default listen address is `0.0.0.0:3737` for LAN access, and browser auto-open is enabled by default.
+
+> Safety note: the unauthenticated management UI is exposed to your current LAN by default. Use trusted networks only; for local-only access, set `CODEXMATE_HOST=127.0.0.1` or pass `--host 127.0.0.1`.
 
 ### Run from source
 
@@ -170,8 +184,6 @@ codexmate codex --model gpt-5.3-codex --follow-up "step1" --follow-up "step2"
 - Provider/model switching
 - Model list management
 - `~/.codex/AGENTS.md` editing
-- `~/.codex/skills` management (filter, batch delete, cross-app import)
-
 
 ### Claude Code Mode
 - Multi-profile management
@@ -185,8 +197,16 @@ codexmate codex --model gpt-5.3-codex --follow-up "step1" --follow-up "step2"
 
 ### Sessions Mode
 - Unified Codex + Claude sessions
+- Browser / Usage subview switching
 - Local pin/unpin with persistent storage and pinned-first ordering
 - Search, filter, export, delete, batch cleanup
+- Usage view includes 7d / 30d session trends, message trends, source share, and top paths
+
+### Skills Market Tab
+- Switch the skills install target between `Codex` and `Claude Code`
+- Show the current local skills root, installed items, and importable items
+- Scan importable sources under `Codex` / `Claude Code` / `Agents`
+- Support cross-app import, ZIP import/export, and batch delete
 
 ## MCP
 
@@ -218,7 +238,7 @@ codexmate mcp serve --allow-write
 | Variable | Default | Description |
 | --- | --- | --- |
 | `CODEXMATE_PORT` | `3737` | Web server port |
-| `CODEXMATE_HOST` | `127.0.0.1` | Web listen host |
+| `CODEXMATE_HOST` | `0.0.0.0` | Web listen host (set `127.0.0.1` for local-only access) |
 | `CODEXMATE_NO_BROWSER` | unset | Set `1` to disable browser auto-open |
 | `CODEXMATE_MCP_ALLOW_WRITE` | unset | Set `1` to allow MCP write tools by default |
 | `CODEXMATE_FORCE_RESET_EXISTING_CONFIG` | `0` | Set `1` to force bootstrap reset of existing config |
@@ -232,10 +252,7 @@ codexmate mcp serve --allow-write
 
 ## Contributing
 
-Issues and pull requests are welcome.
-
-- English changelog: `doc/CHANGELOG.md`
-- Chinese changelog: `doc/CHANGELOG.zh-CN.md`
+Issues and pull requests are accepted.
 
 ## License
 

package/README.md

@@ -23,17 +23,20 @@ Codex Mate 提供一套本地优先的 CLI + Web UI，用于统一管理：
 - Codex 的 provider / model 切换与配置写入
 - Claude Code 配置方案（写入 `~/.claude/settings.json`）
 - OpenClaw JSON5 配置与 Workspace `AGENTS.md`
-- Codex / Claude 本地会话浏览、筛选、导出、删除
+- Codex / Claude Code Skills 市场（安装目标切换、本地 skills 管理、跨应用导入、ZIP 分发）
+- Codex / Claude 本地会话浏览、筛选、导出、删除与 Usage 统计概览
 
-项目不依赖云端托管，配置写入你的本地文件，便于审计和回滚。
+项目不依赖云端托管，配置写入你的本地文件，便于审计和回滚。Skills 市场同样坚持本地优先，只操作本地目录，不依赖远程在线市场。
 
-## 为什么选择 Codex Mate？
+## 功能对比
 
 | 维度 | Codex Mate | 手动维护配置 |
 | --- | --- | --- |
 | 多工具管理 | Codex + Claude Code + OpenClaw 统一入口 | 多文件、多目录分散修改 |
 | 使用方式 | CLI + 本地 Web UI | 纯手改 TOML / JSON / JSON5 |
-| 会话处理 | 支持浏览、导出、批量清理 | 需要手动定位和处理文件 |
+| 会话处理 | 支持浏览、筛选、Usage 统计、导出、批量清理 | 需要手动定位和处理文件 |
+| Skills 复用 | 本地 Skills 市场 + 跨应用导入 + ZIP 分发 | 目录手动复制，容易遗漏 |
+| 使用可见性 | 统一查看配置、会话与 Usage 概览 | 依赖手工翻文件和零散命令 |
 | 可回滚性 | 首次接管前自动备份 | 易误覆盖、回滚成本高 |
 | 自动化接入 | 提供 MCP stdio（默认只读） | 需自行封装脚本 |
 
@@ -49,13 +52,18 @@ Codex Mate 提供一套本地优先的 CLI + Web UI，用于统一管理：
 - 同页查看 Codex 与 Claude 会话
 - 支持本地会话置顶，置顶状态持久化保存并优先排序显示
 - 关键词搜索、来源筛选、cwd 路径筛选
+- Usage 子页：近 7 天 / 近 30 天会话趋势、消息趋势、来源占比、高频路径
 - 会话导出 Markdown
 - 会话与消息级删除（支持批量）
 
+**Skills 市场**
+- 在 Codex 与 Claude Code 之间切换 skills 安装目标
+- 查看本地已安装 skills、根目录与状态
+- 扫描 `Codex` / `Claude Code` / `Agents` 可导入来源
+- 支持跨应用导入、ZIP 导入 / 导出、批量删除
+
 **工程能力**
 - MCP stdio 能力（tools/resources/prompts）
-- 内建代理配置与状态控制（`proxy`）
-- 认证档案管理（`auth`）
 - Zip 压缩/解压（优先系统工具，失败回退 JS 库）
 
 ## 架构总览
@@ -66,40 +74,38 @@ flowchart TB
       CLI["CLI"]
       WEB["Web UI"]
       MCP["MCP Client"]
-      OAI["Codex / OpenAI Client"]
     end
 
     subgraph Runtime["Codex Mate Runtime"]
       ENTRY["cli.js Entry"]
       API["Local HTTP API"]
       MCPS["MCP stdio Server"]
-      PROXY["Built-in Proxy"]
-      SERVICES["Config / Sessions / Skills / Workflow"]
+      SERVICES["Config / Sessions & Usage / Skills Market / Workflow"]
       CORE["File IO / Network / Diff / Session Utils"]
     end
 
     subgraph State["Local State"]
-      CODEX["~/.codex"]
-      CLAUDE["~/.claude"]
-      OPENCLAW["~/.openclaw"]
-      STATE["sessions / trash / workflow runs"]
+      CODEX["~/.codex/config + auth + models"]
+      CLAUDE["~/.claude/settings.json"]
+      OPENCLAW["~/.openclaw/*.json5 + ~/.openclaw/openclaw.json + workspace/AGENTS.md"]
+      SKILLS["~/.codex/skills / ~/.claude/skills / ~/.agents/skills"]
+      STATE["sessions / usage aggregates / trash / workflow runs / skill exports"]
     end
 
     CLI --> ENTRY
     WEB -->|GET / + POST /api| API
     MCP -->|stdio JSON-RPC| MCPS
-    OAI -->|HTTP /v1| PROXY
 
     ENTRY --> SERVICES
     API --> SERVICES
     MCPS --> SERVICES
-    PROXY --> CORE
 
     SERVICES --> CORE
 
     CORE --> CODEX
     CORE --> CLAUDE
     CORE --> OPENCLAW
+    CORE --> SKILLS
     CORE --> STATE
 ```
 
@@ -114,7 +120,9 @@ codexmate status
 codexmate run
 ```
 
-默认监听 `127.0.0.1:3737`，并尝试自动打开浏览器。
+默认监听 `0.0.0.0:3737`，支持局域网访问，并尝试自动打开浏览器。
+
+> 安全提示：默认监听会在当前局域网暴露未鉴权的管理界面。若包含 API Key、provider 配置或 skills 管理，请仅在可信网络中使用；如需仅本机访问，可设置 `CODEXMATE_HOST=127.0.0.1` 或启动时传入 `--host 127.0.0.1`。
 
 ### 从源码运行
 
@@ -144,8 +152,6 @@ npm start run --no-browser
 | `codexmate add <name> <URL> [API_KEY]` | 添加提供商 |
 | `codexmate delete <name>` | 删除提供商 |
 | `codexmate claude <BaseURL> <API_KEY> [model]` | 写入 Claude Code 配置 |
-| `codexmate auth <list\|import\|switch\|delete\|status>` | 认证档案管理 |
-| `codexmate proxy <status\|set\|apply\|enable\|start\|stop>` | 内建代理管理 |
 | `codexmate workflow <list\|get\|validate\|run\|runs>` | MCP 工作流管理 |
 | `codexmate codex [args...] [--follow-up <文本> 可重复]` | Codex CLI 透传入口（默认补 `--yolo`，可追加 queued follow-up） |
 | `codexmate qwen [args...]` | Qwen CLI 透传入口 |
@@ -170,8 +176,6 @@ codexmate codex --model gpt-5.3-codex --follow-up "步骤1" --follow-up "步骤2
 - provider / model 切换
 - 模型管理
 - `~/.codex/AGENTS.md` 编辑
-- `~/.codex/skills` 管理（筛选、批量删除、跨应用导入）
-
 
 ### Claude Code 配置模式
 - 多配置方案管理
@@ -185,8 +189,16 @@ codexmate codex --model gpt-5.3-codex --follow-up "步骤1" --follow-up "步骤2
 
 ### 会话模式
 - Codex + Claude 会话统一列表
+- Browser / Usage 双子视图切换
 - 支持本地会话置顶、持久化保存与置顶优先排序
 - 搜索、筛选、导出、删除、批量清理
+- Usage 视图提供近 7 天 / 近 30 天会话趋势、消息趋势、来源占比与高频路径统计
+
+### Skills 市场标签页
+- 在 `Codex` 与 `Claude Code` 之间切换 skills 安装目标
+- 展示当前目标的本地 skills 根目录、已安装项和可导入项
+- 扫描 `Codex` / `Claude Code` / `Agents` 目录中的可导入来源
+- 支持跨应用导入、ZIP 导入 / 导出、批量删除
 
 ## MCP
 
@@ -219,7 +231,7 @@ codexmate mcp serve --allow-write
 | 变量 | 默认值 | 说明 |
 | --- | --- | --- |
 | `CODEXMATE_PORT` | `3737` | Web 服务端口 |
-| `CODEXMATE_HOST` | `127.0.0.1` | Web 服务监听地址 |
+| `CODEXMATE_HOST` | `0.0.0.0` | Web 服务监听地址（如需仅本机访问，显式设为 `127.0.0.1`） |
 | `CODEXMATE_NO_BROWSER` | 未设置 | 设为 `1` 后不自动打开浏览器 |
 | `CODEXMATE_MCP_ALLOW_WRITE` | 未设置 | 设为 `1` 后默认允许 MCP 写工具 |
 | `CODEXMATE_FORCE_RESET_EXISTING_CONFIG` | `0` | 设为 `1` 时首次可强制重建托管配置 |
@@ -233,10 +245,7 @@ codexmate mcp serve --allow-write
 
 ## 参与贡献
 
-欢迎提交 Issue 和 Pull Request。
-
-- 英文更新日志：`doc/CHANGELOG.md`
-- 中文更新日志：`doc/CHANGELOG.zh-CN.md`
+Issue 与 Pull Request 可按需提交。
 
 ## License
 

package/cli/config-health.js

@@ -0,0 +1,338 @@
+const { isValidHttpUrl, normalizeBaseUrl } = require('../lib/cli-utils');
+const { buildModelProbeSpecs } = require('../lib/cli-models-utils');
+const { probeJsonPost } = require('../lib/cli-network-utils');
+
+const DEFAULT_TIMEOUT_MS = 6000;
+const JSON_RESPONSE_MAX_BYTES = 256 * 1024;
+
+function buildRemoteHealthMessage(issueCode, statusCode, detail) {
+    if (!issueCode) {
+        return '远程模型探测通过：endpoint、鉴权与模型均可用';
+    }
+
+    if (issueCode === 'remote-model-probe-unreachable') {
+        return '远程模型接口不可达，请检查 endpoint、网络或 DNS';
+    }
+
+    if (issueCode === 'remote-model-probe-auth-failed') {
+        return '远程模型探测鉴权失败（401/403），请检查 API Key、endpoint 与模型权限';
+    }
+
+    if (issueCode === 'remote-model-probe-not-found') {
+        return '远程模型探测返回 404，请检查 base_url、接口路径或模型名';
+    }
+
+    if (issueCode === 'remote-model-probe-error') {
+        return detail || '远程模型接口返回错误，请检查模型名与账号权限';
+    }
+
+    if (issueCode === 'remote-model-probe-http-error' && statusCode) {
+        return `远程模型探测返回 HTTP ${statusCode}，请检查 endpoint 与模型`;
+    }
+
+    return '远程模型探测失败，请检查配置与远端服务状态';
+}
+
+function extractPayloadErrorMessage(payload) {
+    if (!payload || typeof payload !== 'object') {
+        return '';
+    }
+    if (typeof payload.error === 'string' && payload.error.trim()) {
+        return payload.error.trim();
+    }
+    if (!payload.error || typeof payload.error !== 'object') {
+        return '';
+    }
+    if (typeof payload.error.message === 'string' && payload.error.message.trim()) {
+        return payload.error.message.trim();
+    }
+    if (typeof payload.error.code === 'string' && payload.error.code.trim()) {
+        return payload.error.code.trim();
+    }
+    return '';
+}
+
+async function runRemoteHealthCheck(providerName, provider, modelName, options = {}) {
+    const issues = [];
+    const baseUrl = normalizeBaseUrl(provider && provider.base_url ? provider.base_url : '');
+    const summary = {
+        type: 'remote-health-check',
+        provider: typeof providerName === 'string' ? providerName.trim() : '',
+        endpoint: baseUrl,
+        ok: false,
+        statusCode: null,
+        message: '',
+        checks: {}
+    };
+
+    if (!baseUrl) {
+        issues.push({
+            code: 'remote-skip-base-url',
+            message: '无法进行远程探测：base_url 为空',
+            suggestion: '补全 base_url 或关闭远程探测'
+        });
+        summary.message = '无法进行远程探测：base_url 为空';
+        return { issues, remote: summary };
+    }
+
+    if (!isValidHttpUrl(baseUrl)) {
+        issues.push({
+            code: 'remote-skip-base-url',
+            message: '无法进行远程探测：base_url 无效',
+            suggestion: '补全 base_url 或关闭远程探测'
+        });
+        summary.message = '无法进行远程探测：base_url 无效';
+        return { issues, remote: summary };
+    }
+
+    const modelProbeSpecs = buildModelProbeSpecs(provider, modelName, baseUrl);
+    if (!modelProbeSpecs.length) {
+        issues.push({
+            code: 'remote-skip-model',
+            message: '无法进行远程探测：当前模型未设置',
+            suggestion: '补全 model 后重试'
+        });
+        summary.message = '无法进行远程探测：当前模型未设置';
+        return { issues, remote: summary };
+    }
+
+    const requiresAuth = provider && provider.requires_openai_auth !== false;
+    const apiKey = typeof provider.preferred_auth_method === 'string'
+        ? provider.preferred_auth_method.trim()
+        : '';
+    const authValue = requiresAuth ? apiKey : (apiKey || '');
+    const timeoutMs = Number.isFinite(options.timeoutMs)
+        ? Math.max(1000, Number(options.timeoutMs))
+        : DEFAULT_TIMEOUT_MS;
+    const runProbeJsonPost = typeof options.probeJsonPost === 'function' ? options.probeJsonPost : probeJsonPost;
+
+    let modelProbeSpec = modelProbeSpecs[0];
+    let modelProbe = null;
+    for (let index = 0; index < modelProbeSpecs.length; index += 1) {
+        const candidate = modelProbeSpecs[index];
+        const probeResult = await runProbeJsonPost(candidate.url, candidate.body, {
+            apiKey: authValue,
+            timeoutMs,
+            maxBytes: JSON_RESPONSE_MAX_BYTES
+        });
+        modelProbeSpec = candidate;
+        modelProbe = probeResult;
+        const shouldTryNextCandidate = index < modelProbeSpecs.length - 1
+            && (!probeResult.ok || probeResult.status === 404);
+        if (!shouldTryNextCandidate) {
+            break;
+        }
+    }
+
+    summary.checks.modelProbe = {
+        url: modelProbeSpec.url,
+        ok: !!modelProbe.ok,
+        status: Number.isFinite(modelProbe.status) ? modelProbe.status : 0,
+        durationMs: Number.isFinite(modelProbe.durationMs) ? modelProbe.durationMs : 0
+    };
+
+    if (!modelProbe.ok) {
+        issues.push({
+            code: 'remote-model-probe-unreachable',
+            message: `模型可用性探测失败：${modelProbe.error || '无法连接'}`,
+            suggestion: '检查 endpoint、网络或模型接口是否可用'
+        });
+    } else if (modelProbe.status === 401 || modelProbe.status === 403) {
+        issues.push({
+            code: 'remote-model-probe-auth-failed',
+            message: '模型可用性探测鉴权失败（401/403）',
+            suggestion: '检查 API Key 或认证方式'
+        });
+    } else if (modelProbe.status === 404) {
+        issues.push({
+            code: 'remote-model-probe-not-found',
+            message: '模型可用性探测返回 404',
+            suggestion: '检查 base_url、接口路径或模型名'
+        });
+    } else if (modelProbe.status >= 400) {
+        issues.push({
+            code: 'remote-model-probe-http-error',
+            message: `模型可用性探测返回异常状态: ${modelProbe.status}`,
+            suggestion: '检查 endpoint、模型名或服务状态'
+        });
+    } else {
+        let payload = null;
+        try {
+            payload = modelProbe.body ? JSON.parse(modelProbe.body) : null;
+        } catch (e) {
+            payload = null;
+        }
+        const payloadError = extractPayloadErrorMessage(payload);
+        if (payloadError) {
+            issues.push({
+                code: 'remote-model-probe-error',
+                message: `模型可用性探测失败：${payloadError}`,
+                suggestion: '检查模型名与权限'
+            });
+        }
+    }
+
+    const primaryIssue = issues[0] || null;
+    summary.ok = issues.length === 0;
+    summary.statusCode = Number.isFinite(modelProbe.status) && modelProbe.status > 0
+        ? modelProbe.status
+        : null;
+    summary.message = buildRemoteHealthMessage(
+        primaryIssue ? primaryIssue.code : '',
+        summary.statusCode,
+        primaryIssue ? primaryIssue.message : ''
+    );
+
+    return { issues, remote: summary };
+}
+
+async function buildConfigHealthReport(params = {}, deps = {}) {
+    const issues = [];
+    const {
+        readConfigOrVirtualDefault,
+        readModels
+    } = deps;
+
+    if (typeof readConfigOrVirtualDefault !== 'function') {
+        throw new Error('buildConfigHealthReport 缺少 readConfigOrVirtualDefault 依赖');
+    }
+    if (typeof readModels !== 'function') {
+        throw new Error('buildConfigHealthReport 缺少 readModels 依赖');
+    }
+
+    const status = readConfigOrVirtualDefault();
+    const config = status.config || {};
+
+    if (status.isVirtual) {
+        const parseFailed = status.errorType === 'parse';
+        const readFailed = status.errorType === 'read';
+        issues.push({
+            code: parseFailed ? 'config-parse-failed' : (readFailed ? 'config-read-failed' : 'config-missing'),
+            message: status.reason || (parseFailed
+                ? 'config.toml 解析失败'
+                : (readFailed ? '读取 config.toml 失败' : '未检测到 config.toml')),
+            suggestion: parseFailed
+                ? '修复 config.toml 语法错误后重试'
+                : (readFailed ? '检查文件权限后重试' : '在模板编辑器中确认应用配置，生成可用的 config.toml')
+        });
+        if (parseFailed || readFailed) {
+            return {
+                ok: false,
+                issues,
+                summary: {
+                    currentProvider: '',
+                    currentModel: ''
+                },
+                remote: null
+            };
+        }
+    }
+
+    const providerName = typeof config.model_provider === 'string' ? config.model_provider.trim() : '';
+    const modelName = typeof config.model === 'string' ? config.model.trim() : '';
+    if (!providerName) {
+        issues.push({
+            code: 'provider-missing',
+            message: '当前 provider 未设置',
+            suggestion: '在模板中设置 model_provider'
+        });
+    }
+
+    if (!modelName) {
+        issues.push({
+            code: 'model-missing',
+            message: '当前模型未设置',
+            suggestion: '在模板中设置 model'
+        });
+    }
+
+    const providers = config.model_providers && typeof config.model_providers === 'object'
+        ? config.model_providers
+        : {};
+    const provider = providerName ? providers[providerName] : null;
+    if (providerName && !provider) {
+        issues.push({
+            code: 'provider-not-found',
+            message: `当前 provider 未在配置中找到: ${providerName}`,
+            suggestion: '检查 model_providers 是否包含该 provider 配置块'
+        });
+    }
+
+    if (provider && typeof provider === 'object') {
+        const baseUrl = typeof provider.base_url === 'string' ? provider.base_url.trim() : '';
+        if (!isValidHttpUrl(baseUrl)) {
+            issues.push({
+                code: 'base-url-invalid',
+                message: '当前 provider 的 base_url 无效',
+                suggestion: '请设置为 http/https 的完整 URL'
+            });
+        }
+
+        const requiresAuth = provider.requires_openai_auth;
+        if (requiresAuth !== false) {
+            const apiKey = typeof provider.preferred_auth_method === 'string'
+                ? provider.preferred_auth_method.trim()
+                : '';
+            if (!apiKey) {
+                issues.push({
+                    code: 'api-key-missing',
+                    message: '当前 provider 未配置 API Key',
+                    suggestion: '在模板中设置 preferred_auth_method'
+                });
+            }
+        }
+    }
+
+    if (modelName) {
+        const models = readModels();
+        if (!models.includes(modelName)) {
+            issues.push({
+                code: 'model-unavailable',
+                message: `模型未在可用列表中找到: ${modelName}`,
+                suggestion: '在模型列表中添加该模型或切换到已有模型'
+            });
+        }
+    }
+
+    let remote = null;
+    if (params.remote) {
+        if (!provider) {
+            issues.push({
+                code: 'remote-skip-provider',
+                message: '无法进行远程探测：provider 未找到',
+                suggestion: '检查 model_provider 配置或关闭远程探测'
+            });
+            remote = {
+                type: 'remote-health-check',
+                provider: providerName,
+                endpoint: '',
+                ok: false,
+                statusCode: null,
+                message: '无法进行远程探测：provider 未找到',
+                checks: {}
+            };
+        } else {
+            const remoteReport = await runRemoteHealthCheck(providerName, provider, modelName, {
+                timeoutMs: Number.isFinite(params.timeoutMs) ? Number(params.timeoutMs) : undefined,
+                probeJsonPost: deps.probeJsonPost
+            });
+            issues.push(...remoteReport.issues);
+            remote = remoteReport.remote;
+        }
+    }
+
+    return {
+        ok: issues.length === 0,
+        issues,
+        summary: {
+            currentProvider: providerName,
+            currentModel: modelName
+        },
+        remote
+    };
+}
+
+module.exports = {
+    runRemoteHealthCheck,
+    buildConfigHealthReport
+};