codexmate 0.0.19 → 0.0.20

package/README.en.md

@@ -24,7 +24,7 @@ Codex Mate is a local-first CLI + Web UI for unified management of:
 - Claude Code profiles (writes to `~/.claude/settings.json`)
 - OpenClaw JSON5 profiles and workspace `AGENTS.md`
 - 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)
+- Local Codex/Claude sessions (list/filter/export/delete) with Usage analytics overview
 
 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.
 
@@ -34,8 +34,9 @@ It works on local files directly and does not require cloud hosting. The skills
 | --- | --- | --- |
 | 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 |
 
@@ -51,6 +52,7 @@ It works on local files directly and does not require cloud hosting. The skills
 - 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)
 
@@ -82,7 +84,7 @@ flowchart TB
       API["Local HTTP API"]
       MCPS["MCP stdio Server"]
       PROXY["Built-in Proxy"]
-      SERVICES["Config / Sessions / Skills Market / Workflow"]
+      SERVICES["Config / Sessions & Usage / Skills Market / Workflow"]
       CORE["File IO / Network / Diff / Session Utils"]
     end
 
@@ -91,7 +93,7 @@ flowchart TB
       CLAUDE["~/.claude/settings.json"]
       OPENCLAW["~/.openclaw/*.json5 + ~/.openclaw/openclaw.json + workspace/AGENTS.md"]
       SKILLS["~/.codex/skills / ~/.claude/skills / ~/.agents/skills"]
-      STATE["sessions / trash / workflow runs / skill exports"]
+      STATE["sessions / usage aggregates / trash / workflow runs / skill exports"]
     end
 
     CLI --> ENTRY
@@ -195,8 +197,10 @@ 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`

package/README.md

@@ -24,7 +24,7 @@ Codex Mate 提供一套本地优先的 CLI + Web UI，用于统一管理：
 - Claude Code 配置方案（写入 `~/.claude/settings.json`）
 - OpenClaw JSON5 配置与 Workspace `AGENTS.md`
 - Codex / Claude Code Skills 市场（安装目标切换、本地 skills 管理、跨应用导入、ZIP 分发）
-- Codex / Claude 本地会话浏览、筛选、导出、删除
+- Codex / Claude 本地会话浏览、筛选、导出、删除与 Usage 统计概览
 
 项目不依赖云端托管，配置写入你的本地文件，便于审计和回滚。Skills 市场同样坚持本地优先，只操作本地目录，不依赖远程在线市场。
 
@@ -34,8 +34,9 @@ Codex Mate 提供一套本地优先的 CLI + Web UI，用于统一管理：
 | --- | --- | --- |
 | 多工具管理 | Codex + Claude Code + OpenClaw 统一入口 | 多文件、多目录分散修改 |
 | 使用方式 | CLI + 本地 Web UI | 纯手改 TOML / JSON / JSON5 |
-| 会话处理 | 支持浏览、导出、批量清理 | 需要手动定位和处理文件 |
+| 会话处理 | 支持浏览、筛选、Usage 统计、导出、批量清理 | 需要手动定位和处理文件 |
 | Skills 复用 | 本地 Skills 市场 + 跨应用导入 + ZIP 分发 | 目录手动复制，容易遗漏 |
+| 使用可见性 | 统一查看配置、会话与 Usage 概览 | 依赖手工翻文件和零散命令 |
 | 可回滚性 | 首次接管前自动备份 | 易误覆盖、回滚成本高 |
 | 自动化接入 | 提供 MCP stdio（默认只读） | 需自行封装脚本 |
 
@@ -51,6 +52,7 @@ Codex Mate 提供一套本地优先的 CLI + Web UI，用于统一管理：
 - 同页查看 Codex 与 Claude 会话
 - 支持本地会话置顶，置顶状态持久化保存并优先排序显示
 - 关键词搜索、来源筛选、cwd 路径筛选
+- Usage 子页：近 7 天 / 近 30 天会话趋势、消息趋势、来源占比、高频路径
 - 会话导出 Markdown
 - 会话与消息级删除（支持批量）
 
@@ -78,7 +80,7 @@ flowchart TB
       ENTRY["cli.js Entry"]
       API["Local HTTP API"]
       MCPS["MCP stdio Server"]
-      SERVICES["Config / Sessions / Skills Market / Workflow"]
+      SERVICES["Config / Sessions & Usage / Skills Market / Workflow"]
       CORE["File IO / Network / Diff / Session Utils"]
     end
 
@@ -87,7 +89,7 @@ flowchart TB
       CLAUDE["~/.claude/settings.json"]
       OPENCLAW["~/.openclaw/*.json5 + ~/.openclaw/openclaw.json + workspace/AGENTS.md"]
       SKILLS["~/.codex/skills / ~/.claude/skills / ~/.agents/skills"]
-      STATE["sessions / trash / workflow runs / skill exports"]
+      STATE["sessions / usage aggregates / trash / workflow runs / skill exports"]
     end
 
     CLI --> ENTRY
@@ -187,8 +189,10 @@ 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 安装目标

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
+};