npm - @offerpilot/axiomruntime - Versions diffs - 0.0.1 - Mend

@offerpilot/axiomruntime 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (99) hide show

package/README.md +185 -0
package/dist/cli/commands/add.js +29 -0
package/dist/cli/commands/context.js +29 -0
package/dist/cli/commands/doctor.js +62 -0
package/dist/cli/commands/edit.js +85 -0
package/dist/cli/commands/help.js +16 -0
package/dist/cli/commands/list.js +25 -0
package/dist/cli/commands/log.js +63 -0
package/dist/cli/commands/memory.js +241 -0
package/dist/cli/commands/report.js +35 -0
package/dist/cli/commands/session.js +74 -0
package/dist/cli/commands/setup.js +86 -0
package/dist/cli/commands/status.js +50 -0
package/dist/cli/commands/telegram.js +701 -0
package/dist/cli/commands/use.js +108 -0
package/dist/cli/commands/version.js +12 -0
package/dist/cli/index.js +276 -0
package/dist/cli/output/table.js +22 -0
package/dist/cli/prompts/prompt.js +37 -0
package/dist/cli/registry.js +16 -0
package/dist/core/config/cache-store.js +193 -0
package/dist/core/config/json-store.js +114 -0
package/dist/core/config/paths.js +85 -0
package/dist/core/config/providers-store.js +89 -0
package/dist/core/config/schema.js +60 -0
package/dist/core/config/session-store.js +30 -0
package/dist/core/config/usage-store.js +18 -0
package/dist/core/context/context-service.js +186 -0
package/dist/core/integrations/integration-state.js +105 -0
package/dist/core/logs/log-service.js +56 -0
package/dist/core/memory/embedding-check.js +121 -0
package/dist/core/memory/memory-config.js +122 -0
package/dist/core/models/model-discovery.js +430 -0
package/dist/core/models/model-filter.js +13 -0
package/dist/core/providers/provider-service.js +212 -0
package/dist/core/reports/report-service.js +166 -0
package/dist/core/runner/command-resolver.js +60 -0
package/dist/core/runner/engine-registry.js +93 -0
package/dist/core/runner/fallback.js +114 -0
package/dist/core/runner/openai-usage-http.js +82 -0
package/dist/core/runner/openai-usage-proxy.js +1 -0
package/dist/core/runner/openai-usage-recording.js +172 -0
package/dist/core/runner/openai-usage-responses.js +469 -0
package/dist/core/runner/openai-usage-server.js +319 -0
package/dist/core/runner/openai-usage-types.js +1 -0
package/dist/core/runner/tool-runner.js +138 -0
package/dist/core/sessions/session-service.js +47 -0
package/dist/core/status/doctor-service.js +391 -0
package/dist/core/status/status-service.js +60 -0
package/dist/core/types.js +1 -0
package/dist/core/usage/pricing.js +113 -0
package/dist/core/usage/usage-service.js +30 -0
package/dist/core/utils/is-record.js +3 -0
package/dist/server/index.js +28 -0
package/dist/server/runtime-server.js +430 -0
package/dist/telegram/bot-registry.js +80 -0
package/dist/telegram/bot.js +128 -0
package/dist/telegram/config.js +235 -0
package/dist/telegram/engine/claude-engine.js +240 -0
package/dist/telegram/engine/codex-engine.js +437 -0
package/dist/telegram/engine/engine-utils.js +67 -0
package/dist/telegram/engine/process-utils.js +132 -0
package/dist/telegram/engine/registry.js +31 -0
package/dist/telegram/engine/types.js +1 -0
package/dist/telegram/handler-registry.js +28 -0
package/dist/telegram/handlers/callback.js +311 -0
package/dist/telegram/handlers/command.js +272 -0
package/dist/telegram/handlers/document.js +108 -0
package/dist/telegram/handlers/memory.js +305 -0
package/dist/telegram/handlers/message.js +701 -0
package/dist/telegram/handlers/provider.js +332 -0
package/dist/telegram/handlers/setup.js +527 -0
package/dist/telegram/handlers/usage.js +124 -0
package/dist/telegram/index.js +93 -0
package/dist/telegram/interaction/approval.js +108 -0
package/dist/telegram/interaction/command-menu.js +253 -0
package/dist/telegram/interaction/formatter.js +487 -0
package/dist/telegram/interaction/keyboards.js +145 -0
package/dist/telegram/interaction/progress-reporter.js +160 -0
package/dist/telegram/interaction/prompt-middleware.js +168 -0
package/dist/telegram/interaction/result-store.js +41 -0
package/dist/telegram/interaction/token-budget.js +21 -0
package/dist/telegram/interaction/tool-name.js +41 -0
package/dist/telegram/lifecycle-registry.js +47 -0
package/dist/telegram/log.js +46 -0
package/dist/telegram/memory/memory-inject.js +52 -0
package/dist/telegram/memory/memory-service.js +413 -0
package/dist/telegram/memory/memory-store.js +216 -0
package/dist/telegram/memory/types.js +1 -0
package/dist/telegram/network-retry.js +22 -0
package/dist/telegram/network.js +53 -0
package/dist/telegram/session/manager.js +229 -0
package/dist/telegram/session/store.js +363 -0
package/dist/telegram/session/types.js +1 -0
package/dist/telegram/supervisor.js +57 -0
package/dist/telegram/templates/messages.js +1 -0
package/docs/README.md +98 -0
package/docs/USAGE.html +853 -0
package/package.json +57 -0

package/docs/USAGE.html ADDED Viewed

@@ -0,0 +1,853 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>AI Runtime 命令参考（Gateway 基础层）</title>
+    <style>
+      :root {
+        color-scheme: light;
+        --bg: #f5f6f8;
+        --surface: #ffffff;
+        --surface-soft: #f9fafb;
+        --text: #172033;
+        --muted: #687386;
+        --line: #d9dee7;
+        --line-strong: #c7ceda;
+        --code: #0f172a;
+        --code-bg: #eef2f6;
+        --accent: #2563eb;
+        --accent-soft: #e8f0ff;
+        --ok: #0f766e;
+        --warn: #b45309;
+        --shadow: 0 12px 36px rgba(15, 23, 42, 0.08);
+      }
+      * {
+        box-sizing: border-box;
+      }
+      html {
+        scroll-behavior: smooth;
+      }
+      body {
+        margin: 0;
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+        background: var(--bg);
+        color: var(--text);
+        line-height: 1.55;
+      }
+      a {
+        color: inherit;
+        text-decoration: none;
+      }
+      code,
+      pre {
+        font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+      }
+      code {
+        color: var(--code);
+        background: var(--code-bg);
+        border: 1px solid var(--line);
+        border-radius: 5px;
+        padding: 1px 5px;
+        font-size: 0.92em;
+      }
+      pre {
+        margin: 8px 0 12px;
+        padding: 12px;
+        overflow-x: auto;
+        color: var(--code);
+        background: var(--code-bg);
+        border: 1px solid var(--line);
+        border-radius: 6px;
+      }
+      header {
+        background: var(--surface);
+        border-bottom: 1px solid var(--line);
+      }
+      .topbar {
+        width: min(1280px, calc(100% - 32px));
+        margin: 0 auto;
+        padding: 24px 0 20px;
+      }
+      h1 {
+        margin: 0 0 6px;
+        font-size: 28px;
+        line-height: 1.2;
+      }
+      .subtitle {
+        margin: 0;
+        color: var(--muted);
+        font-size: 15px;
+      }
+      .layout {
+        display: grid;
+        grid-template-columns: 248px minmax(0, 1fr);
+        gap: 20px;
+        width: min(1280px, calc(100% - 32px));
+        margin: 0 auto;
+        padding: 20px 0 48px;
+      }
+      nav {
+        position: sticky;
+        top: 16px;
+        align-self: start;
+        background: var(--surface);
+        border: 1px solid var(--line);
+        border-radius: 8px;
+        box-shadow: var(--shadow);
+        overflow: hidden;
+      }
+      .nav-title {
+        padding: 13px 14px 8px;
+        color: var(--muted);
+        font-size: 12px;
+        font-weight: 700;
+        text-transform: uppercase;
+      }
+      .nav-link {
+        display: flex;
+        justify-content: space-between;
+        gap: 12px;
+        padding: 9px 14px;
+        border-top: 1px solid var(--line);
+        font-size: 14px;
+      }
+      .nav-link:hover {
+        background: var(--surface-soft);
+      }
+      .nav-count {
+        color: var(--muted);
+        font-size: 12px;
+      }
+      main {
+        min-width: 0;
+      }
+      .panel {
+        min-width: 0;
+        background: var(--surface);
+        border: 1px solid var(--line);
+        border-radius: 8px;
+        box-shadow: var(--shadow);
+      }
+      .finder {
+        padding: 16px;
+      }
+      .finder-header {
+        display: flex;
+        align-items: flex-start;
+        justify-content: space-between;
+        gap: 16px;
+        margin-bottom: 12px;
+      }
+      h2 {
+        margin: 0 0 4px;
+        font-size: 18px;
+        line-height: 1.35;
+      }
+      h3 {
+        margin: 0 0 10px;
+        font-size: 16px;
+      }
+      p {
+        margin: 0 0 10px;
+      }
+      .hint {
+        margin: 0;
+        color: var(--muted);
+        font-size: 13px;
+      }
+      .search {
+        width: min(420px, 100%);
+      }
+      .search input {
+        width: 100%;
+        height: 38px;
+        padding: 0 12px;
+        border: 1px solid var(--line-strong);
+        border-radius: 6px;
+        color: var(--text);
+        background: var(--surface-soft);
+        font: inherit;
+      }
+      .search input:focus {
+        border-color: var(--accent);
+        outline: 3px solid var(--accent-soft);
+      }
+      .chips {
+        display: flex;
+        flex-wrap: wrap;
+        gap: 8px;
+        margin: 0 0 14px;
+      }
+      .chip {
+        border: 1px solid var(--line);
+        border-radius: 999px;
+        padding: 5px 10px;
+        color: var(--muted);
+        background: var(--surface-soft);
+        font-size: 13px;
+      }
+      .command-table {
+        width: 100%;
+        border-collapse: collapse;
+        border: 1px solid var(--line);
+        border-radius: 8px;
+        overflow: hidden;
+      }
+      .command-table th,
+      .command-table td {
+        padding: 10px 12px;
+        text-align: left;
+        border-bottom: 1px solid var(--line);
+        vertical-align: top;
+      }
+      .command-table th {
+        background: #eef2f7;
+        color: #374151;
+        font-size: 13px;
+      }
+      .command-table tr:last-child td {
+        border-bottom: 0;
+      }
+      .command-table tbody tr:hover {
+        background: var(--surface-soft);
+      }
+      .cmd {
+        display: inline-block;
+        white-space: nowrap;
+      }
+      .group-label {
+        display: inline-block;
+        min-width: 70px;
+        color: var(--muted);
+        font-size: 13px;
+      }
+      .tag {
+        display: inline-flex;
+        align-items: center;
+        height: 22px;
+        padding: 0 8px;
+        border-radius: 999px;
+        color: var(--ok);
+        background: #e6f5f3;
+        font-size: 12px;
+        font-weight: 600;
+      }
+      .tag.warn {
+        color: var(--warn);
+        background: #fff4e5;
+      }
+      .sections {
+        display: grid;
+        gap: 14px;
+        min-width: 0;
+        margin-top: 18px;
+      }
+      section.panel {
+        padding: 16px;
+        scroll-margin-top: 18px;
+      }
+      .section-grid {
+        display: grid;
+        grid-template-columns: repeat(2, minmax(0, 1fr));
+        gap: 14px;
+      }
+      .note {
+        min-width: 0;
+        padding: 12px;
+        border: 1px solid var(--line);
+        border-radius: 8px;
+        background: var(--surface-soft);
+      }
+      .note p:last-child {
+        margin-bottom: 0;
+      }
+      details {
+        border: 1px solid var(--line);
+        border-radius: 8px;
+        background: var(--surface-soft);
+      }
+      details + details {
+        margin-top: 8px;
+      }
+      summary {
+        cursor: pointer;
+        padding: 10px 12px;
+        font-weight: 700;
+      }
+      details[open] summary {
+        border-bottom: 1px solid var(--line);
+      }
+      .detail-body {
+        padding: 12px;
+      }
+      ul {
+        margin: 8px 0 0;
+        padding-left: 20px;
+      }
+      li + li {
+        margin-top: 4px;
+      }
+      .empty {
+        display: none;
+        padding: 18px;
+        text-align: center;
+        color: var(--muted);
+        border: 1px dashed var(--line-strong);
+        border-radius: 8px;
+        background: var(--surface-soft);
+      }
+      @media (max-width: 940px) {
+        .layout {
+          grid-template-columns: 1fr;
+        }
+        nav {
+          position: static;
+        }
+        .finder-header {
+          display: block;
+        }
+        .search {
+          width: 100%;
+          margin-top: 12px;
+        }
+        .section-grid {
+          grid-template-columns: 1fr;
+        }
+      }
+      @media (max-width: 720px) {
+        .topbar,
+        .layout {
+          width: min(100% - 24px, 1280px);
+        }
+        h1 {
+          font-size: 24px;
+        }
+        .command-table,
+        .command-table thead,
+        .command-table tbody,
+        .command-table tr,
+        .command-table th,
+        .command-table td {
+          display: block;
+        }
+        .command-table thead {
+          display: none;
+        }
+        .command-table tr {
+          border-bottom: 1px solid var(--line);
+          padding: 10px 0;
+        }
+        .command-table tr:last-child {
+          border-bottom: 0;
+        }
+        .command-table td {
+          border-bottom: 0;
+          padding: 4px 12px;
+        }
+        .group-label {
+          min-width: 0;
+        }
+        .cmd {
+          white-space: normal;
+          overflow-wrap: anywhere;
+          word-break: break-word;
+        }
+        code {
+          overflow-wrap: anywhere;
+          word-break: break-word;
+        }
+        pre {
+          white-space: pre-wrap;
+          overflow-wrap: anywhere;
+        }
+      }
+    </style>
+  </head>
+  <body>
+    <header>
+      <div class="topbar">
+        <h1>AI Runtime 命令参考</h1>
+        <p class="subtitle">当前 Gateway 基础层的命令索引：Provider、Claude/Codex、Telegram、会话与诊断。</p>
+      </div>
+    </header>
+    <div class="layout">
+      <nav aria-label="页面导航">
+        <div class="nav-title">分类</div>
+        <a class="nav-link" href="#install"><span>安装</span><span class="nav-count">npm</span></a>
+        <a class="nav-link" href="#commands"><span>命令索引</span><span class="nav-count">常用入口</span></a>
+        <a class="nav-link" href="#use"><span>使用模型</span><span class="nav-count">use / last</span></a>
+        <a class="nav-link" href="#providers"><span>Provider</span><span class="nav-count">add / edit / delete</span></a>
+        <a class="nav-link" href="#memory"><span>Memory</span><span class="nav-count">embedding</span></a>
+        <a class="nav-link" href="#telegram"><span>Telegram</span><span class="nav-count">Bot</span></a>
+        <a class="nav-link" href="#status"><span>状态诊断</span><span class="nav-count">status / doctor</span></a>
+        <a class="nav-link" href="#sessions"><span>会话报告</span><span class="nav-count">session / report</span></a>
+        <a class="nav-link" href="#files"><span>配置文件</span><span class="nav-count">路径</span></a>
+      </nav>
+      <main>
+        <section id="install" class="panel">
+          <h2>通过 npm 安装</h2>
+          <div class="detail-body">
+            <pre>npm install --global @offerpilot/axiomruntime
+ai --version
+ai setup</pre>
+            <p>npm 包名是 <code>@offerpilot/axiomruntime</code>，安装后注册的可执行命令是 <code>ai</code>。需要 Node.js <code>22.19.0+</code>。</p>
+            <p><code>ai --version</code> 无副作用地验证安装；<code>ai setup</code> 初始化 Runtime，并可在确认后安装缺失的 Claude Code/Codex。</p>
+            <pre>brew tap offerpilot/tap
+brew install axiomruntime
+ai --version
+ai setup</pre>
+            <p>Homebrew Formula 复用同版本 npm tarball并校验 SHA256，固定使用 Homebrew <code>node@22</code>。非 GitHub Tap 首次添加时需提供公开 Git URL。</p>
+          </div>
+        </section>
+        <section id="commands" class="panel finder">
+          <div class="finder-header">
+            <div>
+              <h2>命令索引</h2>
+              <p class="hint">输入命令、场景或关键字过滤；点击左侧分类查看详细规则。</p>
+            </div>
+            <label class="search">
+              <input id="commandSearch" type="search" placeholder="搜索：provider、doctor、telegram..." />
+            </label>
+          </div>
+          <div class="chips" aria-label="常用筛选提示">
+            <span class="chip">需要 Node.js <code>22.19.0+</code></span>
+            <span class="chip">Provider 统一在 <code>ai provider</code></span>
+            <span class="chip">Telegram /model 只显示 AI Gateway 管理的 provider</span>
+          </div>
+          <table class="command-table" id="commandTable">
+            <thead>
+              <tr>
+                <th>分类</th>
+                <th>命令</th>
+                <th>用途</th>
+                <th>备注</th>
+              </tr>
+            </thead>
+            <tbody>
+              <tr data-search="interactive ai help usage">
+                <td><span class="group-label">基础</span></td>
+                <td><code class="cmd">ai</code></td>
+                <td>进入交互模式。</td>
+                <td><span class="tag">推荐入口</span></td>
+              </tr>
+              <tr data-search="version install npm">
+                <td><span class="group-label">基础</span></td>
+                <td><code class="cmd">ai --version</code><br /><code class="cmd">ai version</code></td>
+                <td>输出当前安装版本。</td>
+                <td>不创建配置或日志。</td>
+              </tr>
+              <tr data-search="setup install repair provider claude codex">
+                <td><span class="group-label">基础</span></td>
+                <td><code class="cmd">ai setup</code><br /><code class="cmd">ai setup --yes --install-tools</code></td>
+                <td>初始化 Runtime、引导 Provider，并经授权安装缺失的外部 CLI。</td>
+                <td><code>--yes</code> 本身不授权安装第三方工具。</td>
+              </tr>
+              <tr data-search="help usage html docs">
+                <td><span class="group-label">基础</span></td>
+                <td><code class="cmd">ai help</code></td>
+                <td>打开本页面。</td>
+                <td></td>
+              </tr>
+              <tr data-search="use claude codex provider model fallback">
+                <td><span class="group-label">使用</span></td>
+                <td><code class="cmd">ai use claude</code><br /><code class="cmd">ai use codex</code></td>
+                <td>用默认 provider 和默认模型启动 Claude Code 或 Codex。</td>
+                <td>不指定时使用 <code>level: 1</code>。</td>
+              </tr>
+              <tr data-search="use provider model named">
+                <td><span class="group-label">使用</span></td>
+                <td><code class="cmd">ai use claude 51talk claude-opus-4-6</code><br /><code class="cmd">ai use codex 51talk gpt-5.5</code></td>
+                <td>指定 provider 和模型启动工具。</td>
+                <td>provider 不可用时按 level 降级。</td>
+              </tr>
+              <tr data-search="last resume previous selection">
+                <td><span class="group-label">使用</span></td>
+                <td><code class="cmd">ai last</code></td>
+                <td>继续上次选择的工具、provider 和模型。</td>
+                <td></td>
+              </tr>
+              <tr data-search="provider add create import key">
+                <td><span class="group-label">Provider</span></td>
+                <td><code class="cmd">ai provider add</code><br /><code class="cmd">ai provider add 51talk https://example.com sk-xxx</code></td>
+                <td>添加 provider，探测连通性和模型。</td>
+                <td>也可用旧入口 <code>ai add</code>。</td>
+              </tr>
+              <tr data-search="provider list">
+                <td><span class="group-label">Provider</span></td>
+                <td><code class="cmd">ai provider list</code></td>
+                <td>列出 provider 配置。</td>
+                <td>只读配置，不刷新健康度。</td>
+              </tr>
+              <tr data-search="provider edit rename baseUrl apiKey level model mode">
+                <td><span class="group-label">Provider</span></td>
+                <td><code class="cmd">ai provider edit</code><br /><code class="cmd">ai provider edit 51talk</code></td>
+                <td>修改 name、baseUrl、凭证、mode、level、model。</td>
+                <td>凭证写入 SecretStore，配置只保存 apiKeyRef；编辑时不回显原值。</td>
+              </tr>
+              <tr data-search="provider delete remove fallback">
+                <td><span class="group-label">Provider</span></td>
+                <td><code class="cmd">ai provider delete</code><br /><code class="cmd">ai provider delete 51talk</code></td>
+                <td>删除 provider 和模型缓存。</td>
+                <td>后续执行会按优先级重新选择 provider。</td>
+              </tr>
+              <tr data-search="memory embedding vector jina retrieval config">
+                <td><span class="group-label">Memory</span></td>
+                <td><code class="cmd">ai memory embedding</code><br /><code class="cmd">ai memory embedding set</code><br /><code class="cmd">ai memory embedding test</code><br /><code class="cmd">ai memory embedding clear</code></td>
+                <td>交互配置记忆检索专用 embedding 模型。</td>
+                <td>独立于聊天 provider，保存到 <code>memory.json</code>。</td>
+              </tr>
+              <tr data-search="telegram bot start stop status config logs claude codex remote">
+                <td><span class="group-label">Telegram</span></td>
+                <td><code class="cmd">ai telegram</code><br /><code class="cmd">ai telegram list</code><br /><code class="cmd">ai telegram edit --bot ops</code><br /><code class="cmd">ai telegram start --bot ops</code><br /><code class="cmd">ai telegram status --all</code></td>
+                <td>交互式或按 <code>--bot</code> 精确配置并管理多个 Telegram Bot。</td>
+                <td>复用顶层 provider。</td>
+              </tr>
+              <tr data-search="status health provider model token usage">
+                <td><span class="group-label">诊断</span></td>
+                <td><code class="cmd">ai status</code></td>
+                <td>轻量刷新 provider 健康度和模型缓存。</td>
+                <td>默认不发送真实对话请求。</td>
+              </tr>
+              <tr data-search="doctor deep local strict fix diagnose cli provider token">
+                <td><span class="group-label">诊断</span></td>
+                <td><code class="cmd">ai doctor</code><br /><code class="cmd">ai doctor --local</code><br /><code class="cmd">ai doctor --deep --tool codex</code></td>
+                <td>诊断并安全修复 Runtime 环境；deep 验证真实推理链路。</td>
+                <td>不修改项目源码或自动覆盖 Provider；<span class="tag warn">deep 可能消耗 token</span></td>
+              </tr>
+              <tr data-search="log context project">
+                <td><span class="group-label">诊断</span></td>
+                <td><code class="cmd">ai log</code><br /><code class="cmd">ai log --print</code><br /><code class="cmd">ai context</code></td>
+                <td>打开日志、打印日志、生成项目上下文。</td>
+                <td></td>
+              </tr>
+              <tr data-search="session report clear">
+                <td><span class="group-label">会话</span></td>
+                <td><code class="cmd">ai session</code><br /><code class="cmd">ai session list</code><br /><code class="cmd">ai session clear</code><br /><code class="cmd">ai report</code></td>
+                <td>管理 session 记录并生成报告。</td>
+                <td></td>
+              </tr>
+              <tr data-search="web dashboard panel planned">
+                <td><span class="group-label">其它</span></td>
+                <td><code class="cmd">ai web</code></td>
+                <td>规划中的 Web 控制面板。</td>
+                <td>当前基础版会提示暂未实现。</td>
+              </tr>
+            </tbody>
+          </table>
+          <div class="empty" id="emptyState">没有匹配的命令。试试搜索 provider、status、doctor 或 session。</div>
+        </section>
+        <div class="sections">
+          <section id="use" class="panel">
+            <h2>使用模型</h2>
+            <div class="section-grid">
+              <div class="note">
+                <h3>启动 Claude Code 或 Codex</h3>
+                <pre>ai use claude
+ai use codex
+ai use claude 51talk
+ai use codex 51talk gpt-5.5</pre>
+                <p>不指定 provider 时使用 <code>level: 1</code>；不指定模型时使用 provider 默认 <code>model</code>。</p>
+              </div>
+              <div class="note">
+                <h3>运行规则</h3>
+                <ul>
+                  <li>provider 不可用时按 <code>level</code> 自动降级。</li>
+                  <li>Claude Code 使用临时 <code>--settings</code> 注入环境变量，不修改用户 settings。</li>
+                  <li>Codex 使用本次子进程的 <code>-c model_provider=...</code> 固定所选 provider，并通过 <code>env_key = "OPENAI_API_KEY"</code> 使用 AI Gateway 注入的 Key；不会修改 Codex 全局认证或配置。</li>
+                  <li>provider 的 <code>mode</code> 为 <code>auto</code> 时，Claude Code 会追加 <code>--dangerously-skip-permissions</code>；<code>ask</code> 模式不会追加，并会在启动前确认。</li>
+                  <li>OpenAI 兼容地址用于 Codex 时会使用 <code>/v1</code>，用于 Claude 时会去掉 <code>/v1</code>。</li>
+                  <li>日志只记录 Key 指纹，不记录完整 API Key。</li>
+                </ul>
+              </div>
+            </div>
+          </section>
+          <section id="memory" class="panel">
+            <h2>Memory 配置</h2>
+            <details open>
+              <summary>向量检索模型</summary>
+              <div class="detail-body">
+                <pre>ai memory embedding
+ai memory embedding set
+ai memory embedding set jina https://api.jina.ai/v1 jina_xxx jina-embeddings-v3 --type jina
+ai memory embedding test "ping"
+ai memory embedding clear</pre>
+                <ul>
+                  <li><code>ai memory embedding</code> 会进入交互菜单，可查看、设置、测试或清空 embedding 配置。</li>
+                  <li>这组配置只服务记忆检索，不参与 Claude Code / Codex 聊天 provider 选择。</li>
+                  <li>Jina 会默认写入 <code>retrieval.query</code> 和 <code>retrieval.passage</code>，后续向量查询和记忆入库可分别使用。</li>
+                  <li><code>set</code> 后会调用 embeddings 接口做一次轻量验证；需要跳过时可加 <code>--skip-test</code>。</li>
+                  <li>API Key 只保存在本机 <code>~/.ai-gateway/memory.json</code>，日志会脱敏。</li>
+                </ul>
+              </div>
+            </details>
+          </section>
+          <section id="providers" class="panel">
+            <h2>Provider 管理</h2>
+            <details open>
+              <summary>添加、编辑、删除</summary>
+              <div class="detail-body">
+                <pre>ai provider add
+ai provider add 51talk https://example.com sk-xxx
+ai provider edit
+ai provider edit 51talk
+ai provider delete
+ai provider delete 51talk
+ai provider list</pre>
+                <ul>
+                  <li><code>mode</code> 可选 <code>ask</code> 或 <code>auto</code>。</li>
+                  <li><code>level</code> 是优先级；如果目标等级已占用，会和对应 provider 交换。</li>
+                  <li><code>model</code> 从已探测模型中选择，不手动输入。</li>
+                  <li>删除 provider 会清理模型缓存；后续执行会按 <code>level</code> 从剩余 provider 中重新选择。</li>
+                </ul>
+              </div>
+            </details>
+          </section>
+          <section id="telegram" class="panel">
+            <h2>Telegram Bot</h2>
+            <details open>
+              <summary>配置和进程管理</summary>
+              <div class="detail-body">
+                <pre>ai telegram                 # 交互选择操作，再选择目标 Bot
+ai telegram --bot ops       # 预选 ops，再进入交互菜单
+ai telegram add ops
+ai telegram add support
+ai telegram list
+ai telegram config show --bot ops
+ai telegram config set token &lt;bot-token&gt; --bot ops
+ai telegram config set allowedUserIds 123456789,987654321 --bot ops
+ai telegram config set defaultEngine codex --bot ops
+ai telegram config set defaultCwd /workspace/ops --bot ops
+ai telegram edit --bot ops
+ai telegram start --bot ops
+ai telegram stop --bot ops
+ai telegram status --bot ops
+ai telegram logs --bot ops -f
+ai telegram doctor --bot ops
+ai telegram delete --bot ops
+ai telegram start --all
+ai telegram stop --all
+ai telegram status --all</pre>
+                <ul>
+                  <li><code>--bot=&lt;name&gt;</code> 与 <code>--bot &lt;name&gt;</code> 等价。旧位置参数写法继续兼容；新脚本推荐显式指定 <code>--bot</code> 或 <code>--all</code>。</li>
+                  <li>裸 <code>ai telegram</code> 会先选操作再列出 Bot；生命周期菜单可选 <code>all bots</code>，删除菜单会二次确认。带 <code>--bot</code> 进入交互菜单时会跳过 Bot 选择。</li>
+                  <li><code>edit</code> 交互式编辑指定 Bot；<code>delete</code> 先停止目标 Bot，再删除该 Bot 的 config、PID、log 和 SQLite 文件。旧 <code>remove</code> 是兼容别名。</li>
+                  <li>删除迁移得到的 <code>default</code> Bot 时，同时清理 legacy <code>telegram.json</code> 与数据库，避免后续迁移重新创建绑定。</li>
+                  <li><code>config set ... --bot &lt;name&gt;</code> 只修改指定 Bot，不影响全局或其他 Bot；token 不会出现在命令日志或终端输出中。</li>
+                  <li>命名 Bot 的配置、PID、日志和会话保存在 <code>~/.ai-gateway/telegram/bots/&lt;name&gt;.json|.pid|.log|.sqlite</code>。</li>
+                  <li>为保持兼容，存在命名 Bot 时，无目标 <code>start</code>、<code>stop</code>、<code>status</code> 仍作用于全部命名 Bot。</li>
+                  <li>默认只有 <code>allowedUserIds</code> 中的 Telegram 用户可以访问 Bot；如需开放给所有用户，显式设置 <code>allowAllUsers: true</code>。</li>
+                  <li>远程执行复用 AI Gateway 顶层 provider；不配置固定 provider/model 时按优先级自动选择。</li>
+                  <li><code>/start</code> 或 <code>/reset</code> 先选择 Provider/Model，再直接以按钮列出历史绝对路径，末尾可选择“自定义”，不再先点击“已存在”。</li>
+                  <li><code>/provider</code> 以按钮列出全部 AI Provider，可编辑名称、Base URL、API Key、默认模型、模式和优先级，二次确认后删除，或从列表底部添加。操作复用 <code>ai provider</code> 的核心 CRUD 和检查逻辑。</li>
+                  <li>Provider API Key 在详情中只显示“已配置”，不会写入 Bot 应用日志；输入后 Bot 会尽力立即删除该 Telegram 消息。未完成表单在 Bot 重启后需要重新开始。</li>
+                  <li>Telegram Codex 执行会自动走本地 OpenAI 兼容代理记录 provider usage；<code>/usage</code> 有 provider cost 时直接展示，否则按 <code>model-pricing.json</code> 估算。</li>
+                  <li>如果本机不能直连 <code>api.telegram.org</code>，设置 <code>proxyUrl</code> 或环境变量 <code>HTTPS_PROXY</code> / <code>ALL_PROXY</code>。</li>
+                </ul>
+              </div>
+            </details>
+            <details>
+              <summary>Bot 命令</summary>
+              <div class="detail-body">
+                <pre>/claude prompt
+/codex prompt
+/reset
+/fresh
+/cwd /path/to/project
+/config
+/provider
+/usage
+/pin
+/unpin
+/terminal ls -la
+/restart
+/help</pre>
+                <ul>
+                  <li>普通文本会发送给当前会话的默认引擎。</li>
+                  <li>基础菜单同时提供 Memory、上下文固定、终端和重启命令；选择 CLI 后，会在当前 chat 的 <code>/</code> 菜单追加该 CLI 的 slash 命令映射。</li>
+                  <li>CLI slash 命令不会以消息列表形式额外刷屏，点击菜单项后会转发给当前 CLI 执行。</li>
+                  <li>会话按 1400 token budget 动态选择最近上下文；回复 Bot 回答并发送 <code>/pin</code> 可固定最多 3 个关键 turn，<code>/unpin</code> 可撤销。</li>
+                  <li>回复文字或 caption 会注入转义后的引用上下文；编辑最新普通 prompt 会停止旧任务、清除旧 native session 后重跑。</li>
+                  <li>下一条请求最多消费 8 个附件：UTF-8 文本单文件 ≤2MB、图片单文件 ≤10MB；Codex 图片使用 <code>--image</code>。</li>
+                  <li>进度消息按至少 1500ms 节流显示阶段、工具和有界回答预览；最终结果替换同一条消息。</li>
+                  <li><code>/terminal</code> 最长运行 60 秒且高风险命令必须确认；<code>/restart</code> 会优雅停止并启动 replacement process。</li>
+                  <li>Claude 失败会显示 terminal error，不再把 <code>system/init</code> JSON 当作主错误。</li>
+                  <li><code>full-auto</code> 会映射到 Claude/Codex 的跳过审批模式，但高风险命令文本仍会在 Telegram 侧强制确认。</li>
+                </ul>
+              </div>
+            </details>
+          </section>
+          <section id="status" class="panel">
+            <h2>状态和诊断</h2>
+            <div class="section-grid">
+              <div class="note">
+                <h3>轻量检查</h3>
+                <pre>ai status
+ai provider list
+ai log
+ai log --print
+ai context</pre>
+                <p><code>status</code> 会刷新 provider 健康度和模型缓存，展示 Claude/Codex 各自实际 baseUrl、兼容模型、token 使用量和使用占比。</p>
+              </div>
+              <div class="note">
+                <h3>诊断与自动修复</h3>
+                <pre>ai doctor
+ai doctor --local
+ai doctor --no-fix
+ai doctor --strict
+ai doctor --deep --tool codex
+ai doctor --deep --tool claude</pre>
+                <p>默认创建缺失的 Runtime 状态文件，并备份后重建损坏的可再生文件；不会读取或修改项目源码，也不会自动覆盖 <code>providers.json</code>。<code>--deep</code> 可能消耗 token。</p>
+              </div>
+            </div>
+          </section>
+          <section id="sessions" class="panel">
+            <h2>会话和报告</h2>
+            <div class="section-grid">
+              <div class="note">
+                <h3>Session</h3>
+                <pre>ai session
+ai session list
+ai session clear</pre>
+                <p><code>session</code> 进入最近 session 选择列表；<code>session clear</code> 清空 AI Gateway 记录。</p>
+              </div>
+              <div class="note">
+                <h3>Report</h3>
+                <pre>ai report</pre>
+                <p>选择 session 生成 Markdown 报告，包含 context、真实 token、模型、provider 快照和画像信息。</p>
+              </div>
+            </div>
+          </section>
+          <section id="files" class="panel">
+            <h2>配置文件</h2>
+            <details open>
+              <summary>用户可编辑</summary>
+              <div class="detail-body">
+                <pre>~/.ai-gateway/providers.json
+~/.ai-gateway/memory.json
+~/.ai-gateway/model-pricing.json</pre>
+                <p><code>providers.json</code> 保存聊天 provider 与 <code>apiKeyRef</code>；<code>memory.json</code> 保存记忆检索 embedding 模型与 secret ref；实际凭证进入 SecretStore。<code>model-pricing.json</code> 保存美元 / 百万 token 的模型价格。</p>
+              </div>
+            </details>
+            <details>
+              <summary>内部状态</summary>
+              <div class="detail-body">
+                <pre>~/.ai-gateway/.ai-cache.json
+~/.ai-gateway/usage.json
+~/.ai-gateway/sessions.json
+~/.ai-gateway/telegram.json
+~/.ai-gateway/telegram.sqlite
+~/.ai-gateway/telegram.log
+~/.ai-gateway/reports/
+~/.ai-gateway/exports/
+~/.ai-gateway/.ai-gateway.log</pre>
+                <p>除非调试问题，否则不要手动修改内部文件。</p>
+              </div>
+            </details>
+          </section>
+        </div>
+      </main>
+    </div>
+    <script>
+      const search = document.getElementById("commandSearch");
+      const rows = Array.from(document.querySelectorAll("#commandTable tbody tr"));
+      const emptyState = document.getElementById("emptyState");
+      search.addEventListener("input", () => {
+        const query = search.value.trim().toLowerCase();
+        let visible = 0;
+        for (const row of rows) {
+          const haystack = `${row.textContent} ${row.dataset.search || ""}`.toLowerCase();
+          const match = !query || haystack.includes(query);
+          row.style.display = match ? "" : "none";
+          if (match) visible += 1;
+        }
+        emptyState.style.display = visible ? "none" : "block";
+      });
+    </script>
+  </body>
+</html>