npm - @cc-monitoring/proxy-core - Versions diffs - 0.1.5 → 0.1.7 - Mend

@cc-monitoring/proxy-core 0.1.5 → 0.1.7

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 (445) hide show

package/dist/docs/assets/proxy-core_config.md.BXSOyxYE.js ADDED Viewed

@@ -0,0 +1,83 @@
+import{_ as i,o as a,c as n,a2 as t}from"./chunks/framework.D_Xv2a7c.js";const g=JSON.parse('{"title":"proxy-core / 配置与日志","description":"","frontmatter":{},"headers":[],"relativePath":"proxy-core/config.md","filePath":"proxy-core/config.md"}'),h={name:"proxy-core/config.md"};function l(k,s,p,e,d,E){return a(),n("div",null,[...s[0]||(s[0]=[t(`<h1 id="proxy-core-配置与日志" tabindex="-1">proxy-core / 配置与日志 <a class="header-anchor" href="#proxy-core-配置与日志" aria-label="Permalink to &quot;proxy-core / 配置与日志&quot;"></a></h1><h2 id="本文档覆盖的源文件" tabindex="-1">本文档覆盖的源文件 <a class="header-anchor" href="#本文档覆盖的源文件" aria-label="Permalink to &quot;本文档覆盖的源文件&quot;"></a></h2><ul><li><code>apps/proxy-core/src/config/schema.ts</code></li><li><code>apps/proxy-core/src/config/index.ts</code></li><li><code>apps/proxy-core/src/logger/index.ts</code></li><li><code>apps/proxy-core/src/types/config.ts</code> / <code>log.ts</code></li></ul><h2 id="zod-schema" tabindex="-1">Zod Schema <a class="header-anchor" href="#zod-schema" aria-label="Permalink to &quot;Zod Schema&quot;"></a></h2><p><code>apps/proxy-core/src/config/schema.ts:3-29</code>：</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> AppConfigSchema</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">object</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  server: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">object</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    port: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">number</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">int</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">min</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">max</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">65535</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">),</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    host: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">string</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">min</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  }),</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  proxy: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">object</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    target: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">string</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">url</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(),</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    changeOrigin: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">boolean</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(),</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    rewritePrefix: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">string</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">optional</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(),</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    apiKey: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">string</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">min</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">optional</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">()</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  }),</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  logging: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">object</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    level: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">enum</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">([</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;debug&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;info&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;warn&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;error&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">]),</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    file: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">string</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">min</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">),</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    maxSize: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">string</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">default</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;10m&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">),</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    interval: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">string</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">default</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;1d&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">),</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    compress: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">boolean</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">default</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  }),</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  storage: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">object</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    type: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">enum</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">([</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;sqlite&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">]).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">default</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;sqlite&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">),</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    path: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">string</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">min</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">default</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;logs/proxy.db&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">),</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    maxDays: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">number</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">int</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">min</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">0</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">default</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">7</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  }).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">optional</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">default</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({ type: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;sqlite&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, path: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;logs/proxy.db&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, maxDays: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">7</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }),</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  auth: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">object</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    token: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">string</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">min</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  }).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">optional</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">()</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">})</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> function</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> validateConfig</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">config</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">:</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> unknown</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">:</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> ValidationResult</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">...</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span></code></pre></div><h3 id="字段说明" tabindex="-1">字段说明 <a class="header-anchor" href="#字段说明" aria-label="Permalink to &quot;字段说明&quot;"></a></h3><table tabindex="0"><thead><tr><th>段</th><th>字段</th><th>必填</th><th>默认</th><th>备注</th></tr></thead><tbody><tr><td>server</td><td>port</td><td>✔</td><td>—</td><td>1..65535</td></tr><tr><td>server</td><td>host</td><td>✔</td><td>—</td><td>空串会拒</td></tr><tr><td>proxy</td><td>target</td><td>✔</td><td>—</td><td>必须合法 URL</td></tr><tr><td>proxy</td><td>changeOrigin</td><td>✔</td><td>—</td><td>实际上目前<strong>未使用</strong>（应用层 fetch 无 <code>changeOrigin</code> 概念，代码里不读它）</td></tr><tr><td>proxy</td><td>rewritePrefix</td><td>✖</td><td>—</td><td>目前<strong>未使用</strong>，早期透明代理遗留</td></tr><tr><td>proxy</td><td>apiKey</td><td>✖</td><td>—</td><td>若设置，替换客户端 <code>x-api-key</code> / <code>Authorization</code> 发给上游</td></tr><tr><td>logging</td><td>level</td><td>✔</td><td>—</td><td>Pino level 枚举</td></tr><tr><td>logging</td><td>file</td><td>✔</td><td>—</td><td>相对路径按 config 所在目录解析</td></tr><tr><td>logging</td><td>maxSize</td><td>✖</td><td><code>&#39;10m&#39;</code></td><td>file-stream-rotator 参数</td></tr><tr><td>logging</td><td>interval</td><td>✖</td><td><code>&#39;1d&#39;</code></td><td>rotator 参数（当前代码固定用 <code>frequency: &#39;daily&#39;</code>）</td></tr><tr><td>logging</td><td>compress</td><td>✖</td><td><code>true</code></td><td>rotator 参数（当前代码没启用 gzip）</td></tr><tr><td>storage</td><td>type</td><td>✖</td><td><code>&#39;sqlite&#39;</code></td><td>只有 sqlite 一个选项</td></tr><tr><td>storage</td><td>path</td><td>✖</td><td><code>&#39;logs/proxy.db&#39;</code></td><td>相对路径按 config 目录解析</td></tr><tr><td>storage</td><td>maxDays</td><td>✖</td><td>7</td><td>0 或负数 = 不清理</td></tr><tr><td>auth</td><td>token</td><td>✖</td><td>—</td><td>非空字符串；未配置时不校验</td></tr></tbody></table><h3 id="校验入口" tabindex="-1">校验入口 <a class="header-anchor" href="#校验入口" aria-label="Permalink to &quot;校验入口&quot;"></a></h3><p><code>validateConfig(config)</code>（<code>schema.ts:33-45</code>）返回 <code>{ valid: true, data }</code> 或 <code>{ valid: false, errors: [{field, message}] }</code>。</p><h2 id="配置加载" tabindex="-1">配置加载 <a class="header-anchor" href="#配置加载" aria-label="Permalink to &quot;配置加载&quot;"></a></h2><p><code>apps/proxy-core/src/config/index.ts:7-33</code>：</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> async</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> function</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> loadConfig</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">configPath</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> getConfigPath</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">())</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">:</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> Promise</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&lt;</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">AppConfig</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt; {</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">!</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">fsSync.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">existsSync</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(configPath)) {</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">    ensureDataDirs</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">()</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">    await</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> resetConfig</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(configPath)   </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// 首次运行自动写默认</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  }</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> content</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> fs.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">readFile</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(configPath, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;utf-8&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> raw</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> JSON</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">parse</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(content)</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> result</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> validateConfig</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(raw)</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">!</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">result.valid) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">throw</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> new</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> ConfigError</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">...</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> configDir</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> path.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">dirname</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(configPath)</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> config</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> result.data</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">!</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (config.logging.file </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&amp;&amp;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> !</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">path.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">isAbsolute</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(config.logging.file)) {</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    config.logging.file </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> path.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">resolve</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(configDir, config.logging.file)</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  }</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (config.storage?.path </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&amp;&amp;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> !</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">path.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">isAbsolute</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(config.storage.path)) {</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    config.storage.path </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> path.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">resolve</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(configDir, config.storage.path)</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  }</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  return</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> config</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><ul><li><strong>首次自动初始化</strong>：文件不存在 → <code>ensureDataDirs</code>（建 <code>~/.cc-monitoring/logs</code>） + <code>resetConfig</code>（写默认）</li><li><strong>相对路径归一化</strong>：<code>logging.file</code> 和 <code>storage.path</code> 未绝对路径时，以 config 文件所在目录为基准解析。这让「移动 config 到别处 → 相关文件也跟着走」的行为直觉</li><li><strong>校验失败即抛</strong>：不 fallback，服务不启动</li></ul><h3 id="默认配置" tabindex="-1">默认配置 <a class="header-anchor" href="#默认配置" aria-label="Permalink to &quot;默认配置&quot;"></a></h3><p><code>config/index.ts:43-64</code>：</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">  server</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: { </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">port</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">9527</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">host</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;localhost&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">  proxy</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: {</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">    target</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;https://ark.cn-beijing.volces.com/api/coding&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">    changeOrigin</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  },</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">  logging</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: { </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">level</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;info&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">file</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;logs/proxy.log&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">maxSize</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;10m&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">interval</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;1d&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">compress</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">  storage</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: { </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">type</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;sqlite&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">path</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;logs/proxy.db&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">maxDays</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">7</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><p>（<code>host: &#39;localhost&#39;</code>——但仓库根 <code>config.json</code> 是 <code>0.0.0.0</code>，这是用户手动改的。）</p><h3 id="保存与重置" tabindex="-1">保存与重置 <a class="header-anchor" href="#保存与重置" aria-label="Permalink to &quot;保存与重置&quot;"></a></h3><ul><li><code>saveConfig(config, path?)</code>：先 <code>validateConfig</code> 再 <code>fs.writeFile</code>（<code>JSON.stringify(..., 2)</code> 缩进两格）</li><li><code>resetConfig(path?)</code>：<code>saveConfig(defaultConfig, path)</code> 覆盖当前文件</li><li><code>ConfigError</code>：自定义 Error 子类，<code>name = &#39;ConfigError&#39;</code></li></ul><h2 id="logger" tabindex="-1">Logger <a class="header-anchor" href="#logger" aria-label="Permalink to &quot;Logger&quot;"></a></h2><p><code>apps/proxy-core/src/logger/index.ts:25-68</code>：</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> function</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> createLogger</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">config</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">:</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> LogConfig</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">:</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> pino</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">Logger</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  fs.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">mkdirSync</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(path.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">dirname</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(config.file), { recursive: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> })</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> patternFilename</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> path.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">join</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(dirname, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">\`\${</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">basename</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">}-%DATE%.log\`</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> rotatingStream</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> rotator.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getStream</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    filename: patternFilename,</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    frequency: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;daily&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    date_format: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;YYYY-MM-DD&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    size: config.maxSize </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">||</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &#39;10m&#39;</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  })</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> dualStream</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">    write</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: (</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">data</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">:</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> string</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      rotatingStream.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">write</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(data)</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">      try</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">        const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> log</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> JSON</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">parse</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(data)</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">        console.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">log</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">\`[\${</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">time</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">}] \${</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">coloredLevel</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">} (\${</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">pid</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">}): \${</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">cyan</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">(</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">msg</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">)</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">}\${</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">formatBindings</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">(</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">log</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">)</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">}\`</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">catch</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">        console.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">log</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(data)</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      }</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    }</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  }</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  return</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> pino</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({ level: config.level, timestamp: pino.stdTimeFunctions.isoTime }, dualStream)</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><p><strong>双输出机制</strong>：把 <code>dualStream</code> 传给 pino 作为唯一 sink。每条日志同时进两个 destination：</p><ul><li>轮转文件（<code>file-stream-rotator</code> 按天切分 <code>proxy-YYYY-MM-DD.log</code>；size 超过 10m 也切）</li><li>终端 console（重新解析 JSON 后带 ANSI 颜色美化输出）</li></ul><p><strong>颜色映射</strong>（<code>levelColor</code>）：</p><ul><li>trace → 紫</li><li>debug → 青</li><li>info → 绿</li><li>warn → 黄</li><li>error → 红</li><li>fatal → 红底白字</li></ul><p><strong>msg 用青色</strong>。<code>formatBindings</code> 单独把 <code>reqId / req / res / responseTime</code> 从 log 对象中挑出来另起一行显示，避免与主消息挤在一起。</p><h3 id="只有-frequency-daily" tabindex="-1">只有 <code>frequency: &#39;daily&#39;</code> <a class="header-anchor" href="#只有-frequency-daily" aria-label="Permalink to &quot;只有 \`frequency: &#39;daily&#39;\`&quot;"></a></h3><p>尽管 schema 允许 <code>interval</code> 配置，代码里目前<strong>硬编码</strong> <code>frequency: &#39;daily&#39;</code>，<code>config.logging.interval</code> 只有默认值 <code>&#39;1d&#39;</code> 才与实际行为一致。改成小时/其它需修改 <code>createLogger</code>。</p><h3 id="无-gzip-压缩" tabindex="-1">无 gzip 压缩 <a class="header-anchor" href="#无-gzip-压缩" aria-label="Permalink to &quot;无 gzip 压缩&quot;"></a></h3><p><code>config.logging.compress</code> 是 schema 里的字段，但 <code>rotator.getStream</code> 调用未传对应参数——目前不启用压缩。</p><h2 id="readlogs" tabindex="-1"><code>readLogs</code> <a class="header-anchor" href="#readlogs" aria-label="Permalink to &quot;\`readLogs\`&quot;"></a></h2><p><code>logger/index.ts:96-133</code>：CLI <code>logs</code> 命令使用。</p><ul><li>读整个 <code>filePath</code> → split lines</li><li>按 <code>options.level</code>（把用户传的 <code>&#39;info&#39;</code> 等映射到 <code>pino</code> 的数值 level 30）过滤</li><li>按 <code>options.grep</code> 做大小写不敏感 substring 匹配</li><li>按 <code>options.limit</code> 截尾（保留最新 N 行）</li></ul><p>一次性读整个文件，日志膨胀到几十 MB 时会占内存；日常运维（默认 50 行）无感。</p><h2 id="fastify-集成" tabindex="-1">Fastify 集成 <a class="header-anchor" href="#fastify-集成" aria-label="Permalink to &quot;Fastify 集成&quot;"></a></h2><p><code>server/index.ts:17-21</code>：</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> fastify</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> Fastify</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  logger: logger </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">as</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> unknown</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> as</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> FastifyBaseLogger</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  trustProxy: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">})</span></span></code></pre></div><p><code>FastifyBaseLogger</code> 与 <code>pino.Logger</code> 类型定义有差异，<code>as unknown as</code> 强转（<code>server/index.ts:5-6</code> 也导入了 <code>FastifyBaseLogger</code>）。所有 <code>request.log.info(...)</code> 都最终进 pino 的 dualStream。</p><h2 id="类型" tabindex="-1">类型 <a class="header-anchor" href="#类型" aria-label="Permalink to &quot;类型&quot;"></a></h2><p><code>src/types/config.ts</code> 单独定义了 <code>ServerConfig / ProxyConfig / LogConfig / StorageConfig / AuthConfig</code>（供其它文件 import，不是 Zod 推导）。Zod 的 <code>AppConfig</code> 是主类型；<code>types/config.ts</code> 的等价接口是<strong>冗余定义</strong>，历史遗留（Zod 加入前）。</p><p><code>src/types/log.ts</code> 定义面向前端的日志形状（<code>LogEntry / RequestSummaryEntry / LogItem</code>），不是本文的重点，见 <a href="./../proxy-cli/utils-and-i18n.html">../proxy-cli/utils-and-i18n.md</a>。</p>`,43)])])}const o=i(h,[["render",l]]);export{g as __pageData,o as default};

package/dist/docs/assets/proxy-core_config.md.BXSOyxYE.lean.js ADDED Viewed

@@ -0,0 +1 @@

+ import{_ as i,o as a,c as n,a2 as t}from"./chunks/framework.D_Xv2a7c.js";const g=JSON.parse('{"title":"proxy-core / 配置与日志","description":"","frontmatter":{},"headers":[],"relativePath":"proxy-core/config.md","filePath":"proxy-core/config.md"}'),h={name:"proxy-core/config.md"};function l(k,s,p,e,d,E){return a(),n("div",null,[...s[0]||(s[0]=[t("",43)])])}const o=i(h,[["render",l]]);export{g as __pageData,o as default};

package/dist/docs/assets/proxy-core_data-layer.md.Cdomb3Gz.js ADDED Viewed

@@ -0,0 +1,85 @@
+import{_ as i,o as a,c as e,a2 as t}from"./chunks/framework.D_Xv2a7c.js";const E=JSON.parse('{"title":"proxy-core / 数据层","description":"","frontmatter":{},"headers":[],"relativePath":"proxy-core/data-layer.md","filePath":"proxy-core/data-layer.md"}'),n={name:"proxy-core/data-layer.md"};function d(l,s,p,h,r,k){return a(),e("div",null,[...s[0]||(s[0]=[t(`<h1 id="proxy-core-数据层" tabindex="-1">proxy-core / 数据层 <a class="header-anchor" href="#proxy-core-数据层" aria-label="Permalink to &quot;proxy-core / 数据层&quot;"></a></h1><h2 id="本文档覆盖的源文件" tabindex="-1">本文档覆盖的源文件 <a class="header-anchor" href="#本文档覆盖的源文件" aria-label="Permalink to &quot;本文档覆盖的源文件&quot;"></a></h2><ul><li><code>apps/proxy-core/src/utils/db.ts</code></li><li><code>apps/proxy-core/src/utils/request-writer.ts</code></li><li><code>apps/proxy-core/src/utils/migrate-files-to-db.ts</code></li></ul><h2 id="单例-db" tabindex="-1">单例 DB <a class="header-anchor" href="#单例-db" aria-label="Permalink to &quot;单例 DB&quot;"></a></h2><p><code>utils/db.ts</code>。文件级私有变量：</p><ul><li><code>dbPath: string | null</code>——由 <code>configureDbPath(absPath)</code> 设置（<code>server/index.ts:13-15</code> 在 loadConfig 后立即设）</li><li><code>db: Database.Database | null</code>——首次 <code>initDatabase()</code> 时创建</li></ul><p><code>initDatabase()</code> 幂等：已初始化则直接返回。首次会：</p><ol><li>用 <code>dbPath || path.join(logsDir, &#39;proxy.db&#39;)</code> 作为绝对路径</li><li><code>mkdirSync</code> 确保父目录存在</li><li><code>new Database(resolvedPath)</code></li><li><code>PRAGMA journal_mode = WAL</code>（并发读友好）</li><li><code>PRAGMA synchronous = NORMAL</code>（写延迟合理，掉电容忍）</li><li>建 <code>schema_version</code> 表 → 查当前 version → 逐版应用迁移</li></ol><p><code>closeDatabase()</code>：Fastify <code>onClose</code> 钩子调用（<code>proxy.ts:170-173</code>）。</p><p><code>getDatabase()</code>：未 init 抛错，供 handler 中同步查询。</p><h2 id="schema-迁移" tabindex="-1">Schema 迁移 <a class="header-anchor" href="#schema-迁移" aria-label="Permalink to &quot;Schema 迁移&quot;"></a></h2><div class="language-mermaid vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">mermaid</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">graph LR</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  V0[schema_version = 0] --&gt; V1[&quot;v1: requests + stats&quot;]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  V1 --&gt; V2[&quot;v2: providers&quot;]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  V2 --&gt; V3[&quot;v3: ADD is_default&quot;]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  V3 --&gt; V4[&quot;v4: rebuild providers&lt;br/&gt;去掉 NOT NULL&quot;]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  V4 --&gt; V5[&quot;v5: machine_id + mcp_servers&quot;]</span></span></code></pre></div><p><code>initDatabase()</code> 中的 4 个 <code>if (currentVersion &lt; N)</code> 顺序应用，每次成功后 <code>INSERT OR REPLACE INTO schema_version</code> 更新版本号。冷启动新库会一次跑完 v1→v4；旧库按需增量。</p><h3 id="v1-applyschemav1-db-ts-134-210" tabindex="-1">v1：<code>applySchemaV1</code>（<code>db.ts:134-210</code>） <a class="header-anchor" href="#v1-applyschemav1-db-ts-134-210" aria-label="Permalink to &quot;v1：\`applySchemaV1\`（\`db.ts:134-210\`）&quot;"></a></h3><p>建两张表 + 索引。</p><p><strong><code>requests</code> 表</strong>（每次请求一行）：</p><table tabindex="0"><thead><tr><th>字段</th><th>类型</th><th>含义</th></tr></thead><tbody><tr><td>id</td><td>INTEGER PK AUTOINCREMENT</td><td>内部 ID</td></tr><tr><td>request_id</td><td>TEXT UNIQUE NOT NULL</td><td>云端 <code>x-request-id</code> 或 nanoid</td></tr><tr><td>session_id</td><td>TEXT NOT NULL</td><td><code>x-claude-code-session-id</code></td></tr><tr><td>timestamp</td><td>TEXT NOT NULL</td><td>ISO</td></tr><tr><td>method</td><td>TEXT NOT NULL</td><td>POST/GET/...</td></tr><tr><td>path</td><td>TEXT NOT NULL</td><td><code>/v1/messages</code> 等</td></tr><tr><td>status_code</td><td>INTEGER NOT NULL</td><td>HTTP 状态</td></tr><tr><td>response_time</td><td>INTEGER NOT NULL</td><td>毫秒</td></tr><tr><td>api_key</td><td>TEXT</td><td>客户端原始 key</td></tr><tr><td>proxy_api_key</td><td>TEXT</td><td>实际转给上游的 key</td></tr><tr><td>base_url</td><td>TEXT</td><td>上游 origin</td></tr><tr><td>model</td><td>TEXT</td><td>转发后的 model</td></tr><tr><td>input_tokens</td><td>INTEGER</td><td>提取自 message_delta.usage</td></tr><tr><td>output_tokens</td><td>INTEGER</td><td></td></tr><tr><td>cache_read_tokens</td><td>INTEGER</td><td></td></tr><tr><td>cache_creation_tokens</td><td>INTEGER</td><td></td></tr><tr><td>request_headers</td><td>TEXT</td><td>JSON</td></tr><tr><td>request_body</td><td>TEXT</td><td>JSON</td></tr><tr><td>response_headers</td><td>TEXT</td><td>JSON</td></tr><tr><td>response_events</td><td>TEXT</td><td>JSON（SSE events 数组）</td></tr><tr><td>completed_at</td><td>TEXT</td><td>ISO</td></tr><tr><td>closed_at</td><td>TEXT</td><td>ISO（预留）</td></tr><tr><td>error</td><td>TEXT</td><td>错误串</td></tr><tr><td>created_at</td><td>TEXT DEFAULT CURRENT_TIMESTAMP</td><td></td></tr></tbody></table><p><strong>索引</strong>（<code>db.ts:166-190</code>）：</p><ul><li><code>idx_requests_session (session_id, timestamp DESC)</code> — 会话聚合查询</li><li><code>idx_requests_time (timestamp DESC)</code> — 全局时间序</li><li><code>idx_requests_status (status_code)</code> — 错误筛选</li><li><code>idx_requests_path (path)</code></li><li><code>idx_requests_api_key (api_key)</code></li><li><code>idx_requests_proxy_api_key (proxy_api_key)</code></li><li><code>idx_requests_base_url (base_url)</code></li><li><code>idx_requests_model (model)</code></li></ul><p><strong><code>stats</code> 表</strong>（预聚合）：</p><table tabindex="0"><thead><tr><th>字段</th><th>类型</th><th>含义</th></tr></thead><tbody><tr><td>id</td><td>INTEGER PK AUTOINCREMENT</td><td></td></tr><tr><td>period</td><td>TEXT NOT NULL</td><td><code>&#39;hourly&#39;</code> / <code>&#39;daily&#39;</code></td></tr><tr><td>period_key</td><td>TEXT NOT NULL</td><td>时间桶键，见下文</td></tr><tr><td>input_tokens</td><td>INTEGER DEFAULT 0</td><td>SUM</td></tr><tr><td>output_tokens</td><td>INTEGER DEFAULT 0</td><td></td></tr><tr><td>cache_read_tokens</td><td>INTEGER DEFAULT 0</td><td></td></tr><tr><td>cache_creation_tokens</td><td>INTEGER DEFAULT 0</td><td></td></tr><tr><td>request_count</td><td>INTEGER DEFAULT 0</td><td></td></tr><tr><td>updated_at</td><td>TEXT DEFAULT CURRENT_TIMESTAMP</td><td></td></tr><tr><td>UNIQUE(period, period_key)</td><td></td><td></td></tr></tbody></table><p><code>period_key</code> 格式：</p><ul><li>hourly：<code>YYYY-MM-DD-HH</code>（UTC）</li><li>daily：<code>YYYY-MM-DD</code>（本地时区 UTC+8，见 <a href="./stats.html">stats.md</a>）</li></ul><h3 id="v2-applyschemav2-db-ts-68-86" tabindex="-1">v2：<code>applySchemaV2</code>（<code>db.ts:68-86</code>） <a class="header-anchor" href="#v2-applyschemav2-db-ts-68-86" aria-label="Permalink to &quot;v2：\`applySchemaV2\`（\`db.ts:68-86\`）&quot;"></a></h3><p>建 <code>providers</code> 表 + <code>idx_providers_name</code> 唯一索引。字段见 <a href="./providers.html">providers.md</a>。</p><h3 id="v3-applyschemav3" tabindex="-1">v3：<code>applySchemaV3</code> <a class="header-anchor" href="#v3-applyschemav3" aria-label="Permalink to &quot;v3：\`applySchemaV3\`&quot;"></a></h3><p><code>PRAGMA table_info(providers)</code> 找 <code>is_default</code> 列；缺则 <code>ALTER TABLE ADD COLUMN is_default INTEGER NOT NULL DEFAULT 0</code>。</p><h3 id="v4-applyschemav4" tabindex="-1">v4：<code>applySchemaV4</code> <a class="header-anchor" href="#v4-applyschemav4" aria-label="Permalink to &quot;v4：\`applySchemaV4\`&quot;"></a></h3><p>SQLite 不能直接改列约束。检测 <code>base_url / api_key / model</code> 是否仍为 NOT NULL，是则：</p><div class="language-sql vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sql</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">CREATE</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> TABLE</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> providers_new</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (...允许 </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">NULL</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> 的字段...);</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">INSERT INTO</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> providers_new </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">SELECT</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ...;</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">DROP</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> TABLE</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> providers;</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">ALTER</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> TABLE</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> providers_new RENAME </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">TO</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> providers;</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">CREATE</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> UNIQUE INDEX</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> idx_providers_name</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> ON</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> providers(</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span></code></pre></div><p>条件触发，重复运行安全。</p><h3 id="v5-applyschemav5" tabindex="-1">v5：<code>applySchemaV5</code> <a class="header-anchor" href="#v5-applyschemav5" aria-label="Permalink to &quot;v5：\`applySchemaV5\`&quot;"></a></h3><p>两步：</p><ol><li><strong><code>machine_id</code> 列</strong>：<code>PRAGMA table_info(requests)</code> 检测 <code>machine_id</code> 列是否存在，缺失则 <code>ALTER TABLE requests ADD COLUMN machine_id TEXT</code> + 创建索引 <code>idx_requests_machine_id</code></li><li><strong><code>mcp_servers</code> 表</strong>：</li></ol><div class="language-sql vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sql</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">CREATE</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> TABLE</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> IF</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> NOT</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> EXISTS</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> mcp_servers (</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  id </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">INTEGER</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> PRIMARY KEY</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> AUTOINCREMENT,</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  name</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> TEXT</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> UNIQUE</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> NOT NULL</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  transport_type </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">TEXT</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> NOT NULL</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,    </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">-- &#39;stdio&#39; | &#39;sse&#39; | &#39;streamable-http&#39;</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  command </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">TEXT</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,                     </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">-- stdio transport 的命令</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  args </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">TEXT</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,                        </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">-- JSON array string</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  env </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">TEXT</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,                         </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">-- JSON object string</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  url</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> TEXT</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,                         </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">-- HTTP transport 的 URL</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  headers </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">TEXT</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,                     </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">-- JSON object string (auth headers)</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  enabled</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> INTEGER</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> NOT NULL</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> DEFAULT</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  created_at </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">TEXT</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> DEFAULT</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> CURRENT_TIMESTAMP,</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  updated_at </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">TEXT</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> DEFAULT</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> CURRENT_TIMESTAMP</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">CREATE</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> UNIQUE INDEX</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> IF</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> NOT</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> EXISTS</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> idx_mcp_servers_name </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">ON</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> mcp_servers(</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span></code></pre></div><h2 id="er-图" tabindex="-1">ER 图 <a class="header-anchor" href="#er-图" aria-label="Permalink to &quot;ER 图&quot;"></a></h2><div class="language-mermaid vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">mermaid</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">erDiagram</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  REQUESTS ||--o{ STATS : &quot;aggregate by hour/day&quot;</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  REQUESTS {</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text request_id PK</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text session_id</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text timestamp</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text method</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text path</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    int status_code</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    int response_time</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text api_key</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text proxy_api_key</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text base_url</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text model</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text machine_id</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    int input_tokens</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    int output_tokens</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    int cache_read_tokens</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    int cache_creation_tokens</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text request_headers</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text request_body</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text response_headers</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text response_events</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  }</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  STATS {</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text period</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text period_key</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    int input_tokens</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    int output_tokens</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    int cache_read_tokens</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    int cache_creation_tokens</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    int request_count</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text updated_at</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  }</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  PROVIDERS {</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    int id PK</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text name UK</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text base_url</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text api_key</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text model</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text haiku_model</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text sonnet_model</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text opus_model</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text subagent_model</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text provider</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    int is_default</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text created_at</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text updated_at</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  }</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  MCP_SERVERS {</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    int id PK</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text name UK</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text transport_type</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text command</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text args</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text env</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text url</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text headers</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    int enabled</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text created_at</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    text updated_at</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  }</span></span></code></pre></div><p><code>STATS</code> 与 <code>REQUESTS</code> 无外键，靠 <code>stats-aggregator.ts</code> 定时 UPSERT 维持一致性。<code>PROVIDERS</code> 独立表，<code>REQUESTS.base_url</code> 只是快照，不是 FK。<code>MCP_SERVERS</code> 独立表，与 <code>PROVIDERS</code> 无关联——MCP server 是 tool provider，不是 API provider。</p><h2 id="request-writer-ts-三大函数" tabindex="-1"><code>request-writer.ts</code> 三大函数 <a class="header-anchor" href="#request-writer-ts-三大函数" aria-label="Permalink to &quot;\`request-writer.ts\` 三大函数&quot;"></a></h2><h3 id="saverequestdb-sessionid-requestid-data" tabindex="-1"><code>saveRequestDB(sessionId, requestId, data)</code> <a class="header-anchor" href="#saverequestdb-sessionid-requestid-data" aria-label="Permalink to &quot;\`saveRequestDB(sessionId, requestId, data)\`&quot;"></a></h3><p><code>request-writer.ts:57-104</code>。<code>INSERT OR REPLACE INTO requests</code> 全字段。</p><ul><li><code>response_time</code> 现算：<code>completedAt - timestamp</code>（毫秒）</li><li><code>usage</code> 通过 <code>extractTokenUsage(events)</code> 拿：找 <code>type === &#39;message_delta&#39;</code> 的 event，取 <code>.usage</code></li><li>所有 JSON 字段：<code>data.xxx ? JSON.stringify(data.xxx) : null</code></li><li><code>INSERT OR REPLACE</code>：若同 <code>request_id</code> 已存在（比如 SSE 完成后覆盖前面写的空占位），直接替换。目前实际上 <code>proxy.ts</code> 只在响应完成时调用一次，占位仅在内存中</li></ul><h3 id="loadrequestdb-compositeid" tabindex="-1"><code>loadRequestDB(compositeId)</code> <a class="header-anchor" href="#loadrequestdb-compositeid" aria-label="Permalink to &quot;\`loadRequestDB(compositeId)\`&quot;"></a></h3><p><code>request-writer.ts:107-149</code>。<code>compositeId = sessionId + &#39;:&#39; + requestId</code>。用第一个 <code>:</code> 拆分，然后：</p><div class="language-sql vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sql</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">SELECT</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> *</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> FROM</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> requests </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">WHERE</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> request_id </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ? </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">AND</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> session_id </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ?</span></span></code></pre></div><p>行不存在抛 <code>Error(Request not found: ...)</code>。返回值反向组装：<code>request_headers</code> 等字段 <code>JSON.parse</code> 回对象。</p><h3 id="listrequestdb-limit-1000" tabindex="-1"><code>listRequestDB(limit = 1000)</code> <a class="header-anchor" href="#listrequestdb-limit-1000" aria-label="Permalink to &quot;\`listRequestDB(limit = 1000)\`&quot;"></a></h3><p><code>request-writer.ts:152-185</code>。<code>ORDER BY timestamp DESC LIMIT ?</code>。只 SELECT 摘要列（不含 headers/body/events），返回 <code>RequestSummary[]</code>。<code>usage</code> 字段：只要 <code>input_tokens || output_tokens</code> 非空就构造 usage 对象。</p><h3 id="cleanoldrequestsdb-daystokeep-7" tabindex="-1"><code>cleanOldRequestsDB(daysToKeep = 7)</code> <a class="header-anchor" href="#cleanoldrequestsdb-daystokeep-7" aria-label="Permalink to &quot;\`cleanOldRequestsDB(daysToKeep = 7)\`&quot;"></a></h3><p><code>request-writer.ts:189-200</code>。<code>daysToKeep &lt;= 0</code> 直接 return。否则：</p><div class="language-sql vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sql</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">DELETE</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> FROM</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> requests </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">WHERE</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> timestamp</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ?</span></span></code></pre></div><p><code>cutoff = now - daysToKeep * 86400000</code>（ISO 串比较）。<strong>每次业务请求都会调</strong>（<code>proxy.ts:233</code>）——SQLite 对 timestamp 索引 DELETE 微秒级，可以承受。</p><h2 id="extracttokenusage" tabindex="-1"><code>extractTokenUsage</code> <a class="header-anchor" href="#extracttokenusage" aria-label="Permalink to &quot;\`extractTokenUsage\`&quot;"></a></h2><p><code>request-writer.ts:50-54</code>。极简：</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> messageDelta</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> events.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">find</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> e?.type </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">===</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &#39;message_delta&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">return</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> messageDelta?.usage</span></span></code></pre></div><p><code>message_delta</code> 是 Anthropic Messages API 最终事件，<code>usage</code> 里含四个 Token 字段：<code>input_tokens / output_tokens / cache_read_input_tokens / cache_creation_input_tokens</code>。</p><p><strong>JSON 分支不适用</strong>：JSON 响应体作为单一 event 直接 push（<code>proxy.ts:302</code>），<code>type</code> 字段可能不是 <code>message_delta</code>——所以 JSON 错误响应通常无 usage，写库时也是 null。</p><h2 id="一次性迁移脚本-migrate-files-to-db-ts" tabindex="-1">一次性迁移脚本 <code>migrate-files-to-db.ts</code> <a class="header-anchor" href="#一次性迁移脚本-migrate-files-to-db-ts" aria-label="Permalink to &quot;一次性迁移脚本 \`migrate-files-to-db.ts\`&quot;"></a></h2><p>历史上请求以 JSON 文件存 <code>logs/requests/&lt;sessionId&gt;/req-&lt;requestId&gt;.json</code>。此脚本一次性把它们导入 SQLite：</p><ul><li><code>REQUESTS_DIR = path.resolve(&#39;../../logs/requests&#39;)</code>（相对 <code>packages/core</code> 的旧路径——路径已过时，需要在 <code>dist/utils</code> 下手动运行时会失效）</li><li><code>DB_PATH = path.resolve(&#39;../../logs/proxy.db&#39;)</code></li><li>遍历 sessionId 目录 → <code>req-*.json</code> 文件 → 解构字段 → 事务批量 <code>INSERT OR IGNORE</code></li></ul><p><code>INSERT OR IGNORE</code> 让重复运行安全。<strong>当前项目已切到 SQLite 直写</strong>（<code>saveRequestDB</code>），此脚本不再需要，仅供历史迁移参考。文件底部 <code>migrateFilesToDatabase().then(...)</code> 是自动执行块，直接 <code>node dist/utils/migrate-files-to-db.js</code> 即跑。</p>`,61)])])}const c=i(n,[["render",d]]);export{E as __pageData,c as default};

package/dist/docs/assets/proxy-core_data-layer.md.Cdomb3Gz.lean.js ADDED Viewed

@@ -0,0 +1 @@

+ import{_ as i,o as a,c as e,a2 as t}from"./chunks/framework.D_Xv2a7c.js";const E=JSON.parse('{"title":"proxy-core / 数据层","description":"","frontmatter":{},"headers":[],"relativePath":"proxy-core/data-layer.md","filePath":"proxy-core/data-layer.md"}'),n={name:"proxy-core/data-layer.md"};function d(l,s,p,h,r,k){return a(),e("div",null,[...s[0]||(s[0]=[t("",61)])])}const c=i(n,[["render",d]]);export{E as __pageData,c as default};

package/dist/docs/assets/proxy-core_entry.md.BZmIcCUM.js ADDED Viewed

@@ -0,0 +1,90 @@
+import{_ as i,o as a,c as n,a2 as e}from"./chunks/framework.D_Xv2a7c.js";const E=JSON.parse('{"title":"proxy-core / 启动链","description":"","frontmatter":{},"headers":[],"relativePath":"proxy-core/entry.md","filePath":"proxy-core/entry.md"}'),t={name:"proxy-core/entry.md"};function p(l,s,h,k,r,d){return a(),n("div",null,[...s[0]||(s[0]=[e(`<h1 id="proxy-core-启动链" tabindex="-1">proxy-core / 启动链 <a class="header-anchor" href="#proxy-core-启动链" aria-label="Permalink to &quot;proxy-core / 启动链&quot;"></a></h1><h2 id="本文档覆盖的源文件" tabindex="-1">本文档覆盖的源文件 <a class="header-anchor" href="#本文档覆盖的源文件" aria-label="Permalink to &quot;本文档覆盖的源文件&quot;"></a></h2><ul><li><code>apps/proxy-core/bin/proxy-cli.ts</code></li><li><code>apps/proxy-core/src/cli/index.ts</code></li><li><code>apps/proxy-core/src/server/index.ts</code></li><li><code>apps/proxy-core/src/utils/paths.ts</code></li><li><code>apps/proxy-core/src/utils/esm-dirname.ts</code></li><li><code>apps/proxy-core/ecosystem.config.cjs</code></li></ul><h2 id="三条入口" tabindex="-1">三条入口 <a class="header-anchor" href="#三条入口" aria-label="Permalink to &quot;三条入口&quot;"></a></h2><p><code>proxy-core</code> 有三种被启动的方式，都最终走到 <code>startServer()</code>：</p><div class="language-mermaid vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">mermaid</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">flowchart TB</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  A[pnpm cli / proxy CLI] --&gt; BIN[bin/proxy-cli.ts]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  BIN --&gt; CLI[src/cli/index.ts]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  CLI -- start --&gt; PM2[PM2 start ecosystem.config.cjs]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  PM2 --&gt; SERVER[src/server/index.ts]</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  B[pnpm dev:proxy-core] --&gt; TSX[tsx src/server/index.ts]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  TSX --&gt; SERVER</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  C[PM2 daemon 重启] --&gt; SERVER</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  SERVER --&gt;|_isPm2 ‖ _isDirectExecution| START[startServer]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  START --&gt; LOAD[loadConfig]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  START --&gt; DB[configureDbPath]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  START --&gt; LOG[createLogger]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  START --&gt; FASTIFY[Fastify + hooks]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  FASTIFY --&gt; UI[setupUiRoutes]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  FASTIFY --&gt; PROXY[setupProxy&lt;br/&gt;init MCP + preloadMachineId]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  FASTIFY --&gt; CHAT[setupChatRoute&lt;br/&gt;MCP-enhanced endpoint]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  FASTIFY --&gt; LISTEN[listen host:port]</span></span></code></pre></div><h2 id="bin-proxy-cli-ts" tabindex="-1"><code>bin/proxy-cli.ts</code> <a class="header-anchor" href="#bin-proxy-cli-ts" aria-label="Permalink to &quot;\`bin/proxy-cli.ts\`&quot;"></a></h2><p><code>apps/proxy-core/bin/proxy-cli.ts:1-3</code>：</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">#!/usr/bin/env node</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &#39;../dist/cli/index.js&#39;</span></span></code></pre></div><p>只有两行：加 shebang 让它可直接执行，然后 side-effect import 编译产物。<code>package.json</code> 的 <code>bin</code> 字段指向 <code>./dist/cli/index.js</code>，全局装包（<code>npm i -g @cc-monitoring/cli-core</code>）后终端有 <code>proxy</code> 命令。</p><h2 id="src-cli-index-ts-—-commander-注册" tabindex="-1"><code>src/cli/index.ts</code> — Commander 注册 <a class="header-anchor" href="#src-cli-index-ts-—-commander-注册" aria-label="Permalink to &quot;\`src/cli/index.ts\` — Commander 注册&quot;"></a></h2><p><code>apps/proxy-core/src/cli/index.ts:1-80</code>。核心结构：</p><ul><li>顶层 <code>program</code>：<code>name(&#39;proxy&#39;)</code>、<code>version(&#39;1.0.0&#39;)</code>、全局参数 <code>-c, --config &lt;path&gt;</code></li><li><code>preAction</code> hook（<code>cli/index.ts:20-25</code>）：如果传了 <code>--config</code>，用 <code>path.resolve</code> 得到绝对路径调用 <code>setConfigPathOverride</code>，供后续 <code>loadConfig</code> 命中</li><li>8 条显式命令：<code>start / stop / status / logs / config / reload / test / ui</code>（详见 <a href="./cli.html">cli.md</a>）</li><li>1 条隐藏命令：<code>clean-requests</code>（<code>cli/index.ts:63-78</code>），带 <code>--days &lt;days&gt;</code> 参数（默认 7），动态 import <code>cleanOldRequestsDB</code> 清 SQLite 老数据</li></ul><p>命令 action 从 <code>commands/&lt;name&gt;.ts</code> 导入，保持文件级模块化。</p><h2 id="src-server-index-ts-—-服务端引导" tabindex="-1"><code>src/server/index.ts</code> — 服务端引导 <a class="header-anchor" href="#src-server-index-ts-—-服务端引导" aria-label="Permalink to &quot;\`src/server/index.ts\` — 服务端引导&quot;"></a></h2><p><code>apps/proxy-core/src/server/index.ts:11-42</code>：</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> async</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> function</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> createServer</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">()</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">:</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> Promise</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&lt;</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">FastifyInstance</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt; {</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> config</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> await</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> loadConfig</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">()</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (config.storage?.path) </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">configureDbPath</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(config.storage.path)</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> logger</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> createLogger</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(config.logging)</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> fastify</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> Fastify</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({ logger, trustProxy: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> })</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  fastify.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">register</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(requestIdMiddleware)</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  await</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> setupUiRoutes</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(fastify)        </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// 必须先于 setupProxy，否则 /ui/* 会被 /v1/* 通配</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  await</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> setupProxy</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(fastify, config.proxy)</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  await</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> setupChatRoute</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(fastify, config.proxy)  </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// MCP-enhanced chat endpoint</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  return</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> fastify</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> async</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> function</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> startServer</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">()</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">:</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> Promise</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&lt;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">void</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt; {</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> config</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> await</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> loadConfig</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">()</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> server</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> await</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> createServer</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">()</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> server.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">listen</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({ port: config.server.port, host: config.server.host })</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><h3 id="注册顺序为什么重要" tabindex="-1">注册顺序为什么重要 <a class="header-anchor" href="#注册顺序为什么重要" aria-label="Permalink to &quot;注册顺序为什么重要&quot;"></a></h3><p><code>setupProxy</code> 内部注册 <code>fastify.all(&#39;/v1/*&#39;, ...)</code>（<code>proxy.ts:178</code>）。Fastify 的路由匹配按注册顺序，先注册的先命中。<code>setupUiRoutes</code> 里既有 <code>/ui</code>、<code>/ui/api/*</code>，也有 <code>/ui/*</code>（静态资源，<code>ui-route.ts:398-404</code>）。若顺序颠倒，静态资源的 wildcard 可能会吞掉 <code>/v1/*</code> 之外的路径——因此 <code>server/index.ts:24</code> 有明确注释 <code>UI routes registered BEFORE proxy</code>。</p><h3 id="trustproxy-true" tabindex="-1"><code>trustProxy: true</code> <a class="header-anchor" href="#trustproxy-true" aria-label="Permalink to &quot;\`trustProxy: true\`&quot;"></a></h3><p>信任反向代理头（如 <code>X-Forwarded-For</code>）。用户可能把 proxy-core 再套一层 nginx，这样 <code>request.ip</code> 才能反映真实客户端。</p><h3 id="requestidmiddleware-提前注册" tabindex="-1"><code>requestIdMiddleware</code> 提前注册 <a class="header-anchor" href="#requestidmiddleware-提前注册" aria-label="Permalink to &quot;\`requestIdMiddleware\` 提前注册&quot;"></a></h3><p><code>middleware/request-id.ts</code> 通过 <code>onRequest</code> hook 给每个请求分配 <code>request.id</code>。放在最外层让所有日志与后续 handler 都用同一 ID（Fastify 默认自己会生成 UUID，本项目替换为 <code>nanoid(12)</code> 或客户端提供的 <code>x-request-id</code>）。</p><h2 id="esm-pm2-双重入口守卫" tabindex="-1">ESM + PM2 双重入口守卫 <a class="header-anchor" href="#esm-pm2-双重入口守卫" aria-label="Permalink to &quot;ESM + PM2 双重入口守卫&quot;"></a></h2><p><code>apps/proxy-core/src/server/index.ts:42-60</code>：</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> _isPm2</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> process.env.pm_id </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">!==</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> undefined</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> ||</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> process.env.</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">NODE_APP_INSTANCE</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> !==</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> undefined</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> _currentModuleUrl</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> getCurrentModuleUrl</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">()   </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// wraps import.meta.url</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> _mainModulePath</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> process.argv[</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">] </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">?</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> path.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">resolve</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(process.argv[</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">]) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">:</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &#39;&#39;</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> _mainModuleUrl</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> _mainModulePath </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">?</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> \`file://\${</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">_mainModulePath</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">}\`</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> :</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &#39;&#39;</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> _isDirectExecution</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> _currentModuleUrl </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">===</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> _mainModuleUrl</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (_isPm2 </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">||</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> _isDirectExecution) {</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">  startServer</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">catch</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">err</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { console.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">error</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;Server start failed:&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, err); process.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">exit</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) })</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><p>两个场景都会自动启动：</p><ul><li><strong>PM2 fork 模式</strong>：PM2 会把 <code>process.argv[1]</code> 改成 <code>ProcessContainerFork.js</code> 包装脚本，导致 <code>import.meta.url === main module url</code> 判定失败；用 <code>pm_id</code> / <code>NODE_APP_INSTANCE</code> 环境变量补检测</li><li><strong>直接执行</strong>（<code>tsx src/server/index.ts</code> 或 <code>node dist/server/index.js</code>）：URL 相等判定成立</li></ul><p>第三种情况（只 import 不执行，例如测试）两条判定都不成立，<code>startServer</code> 不会自动跑。</p><h2 id="数据目录锚点-paths-ts" tabindex="-1">数据目录锚点 <code>paths.ts</code> <a class="header-anchor" href="#数据目录锚点-paths-ts" aria-label="Permalink to &quot;数据目录锚点 \`paths.ts\`&quot;"></a></h2><p><code>apps/proxy-core/src/utils/paths.ts</code>：</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> dataDir</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> path.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">join</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(os.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">homedir</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(), </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;.cc-monitoring&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> logsDir</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> path.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">join</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(dataDir, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;logs&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span></code></pre></div><ul><li>全局 npm/pnpm 安装后 <code>process.cwd()</code> 无法预测，锚定到用户主目录才可靠</li><li>CLI 全局 <code>--config</code> → <code>setConfigPathOverride</code> → 存到模块级变量 <code>configPathOverride</code></li><li><code>getConfigPath()</code> 优先级：override &gt; <code>process.env.CONFIG_PATH</code> &gt; <code>path.join(dataDir, &#39;config.json&#39;)</code></li><li><code>ensureDataDirs()</code> 首次运行时 <code>mkdirSync(logsDir, { recursive: true })</code></li></ul><h2 id="ecosystem-config-cjs" tabindex="-1">ecosystem.config.cjs <a class="header-anchor" href="#ecosystem-config-cjs" aria-label="Permalink to &quot;ecosystem.config.cjs&quot;"></a></h2><p><code>apps/proxy-core/ecosystem.config.cjs</code>（本项目唯一的 CommonJS 文件）：</p><div class="language-js vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">js</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> dataDir</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> process.env.</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">CC_DATA_DIR</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> ||</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> path.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">join</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(os.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">homedir</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(), </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;.cc-monitoring&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
+<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> configPath</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> process.env.</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">CONFIG_PATH</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> ||</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> path.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">join</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(dataDir, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;config.json&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">module</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">exports</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  apps: [{</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    name: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;cc-monitoring&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    script: path.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">join</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(__dirname, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;dist/server/index.js&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">),</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    cwd: dataDir,</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    instances: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    exec_mode: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;fork&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,       </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// 必须 fork：ESM 与 cluster 不兼容</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    autorestart: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    watch: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">false</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    max_memory_restart: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;200M&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    env: { NODE_ENV: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;production&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, CONFIG_PATH: configPath },</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    env_development: { NODE_ENV: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;development&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, CONFIG_PATH: configPath },</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    log_date_format: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;YYYY-MM-DD HH:mm:ss Z&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    error_file: path.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">join</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(logsDir, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;error.log&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">),</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    out_file: path.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">join</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(logsDir, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;out.log&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">),</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    merge_logs: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  }]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><ul><li><code>script</code> 用 <code>path.join(__dirname, ...)</code>：ecosystem 无论从哪个 cwd 调都能找到编译产物</li><li><code>cwd: dataDir</code>：让相对路径日志/DB 落到用户目录，不污染项目工程</li><li><code>exec_mode: fork</code>：cluster 模式基于 <code>worker_threads</code> 子进程复制 <code>main</code>，ESM 会在 worker 里报 <code>Cannot use import statement</code>；fork 直接 spawn Node，安全</li><li><code>.cjs</code> 扩展名：根 <code>package.json</code> <code>type: &quot;module&quot;</code> 让 <code>.js</code> 变 ESM；PM2 是 CJS，必须 <code>.cjs</code> 让 Node 按 CJS 加载</li></ul><p>更多细节 → <a href="./pm2.html">pm2.md</a>。</p><h2 id="冷启动时序" tabindex="-1">冷启动时序 <a class="header-anchor" href="#冷启动时序" aria-label="Permalink to &quot;冷启动时序&quot;"></a></h2><div class="language-mermaid vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">mermaid</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">sequenceDiagram</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  autonumber</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  actor U as 用户</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  participant CLI as bin/proxy-cli.ts</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  participant CMD as commands/start.ts</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  participant PM2 as pm2.startProcess</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  participant D as PM2 daemon</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  participant S as dist/server/index.js</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  participant N as waitForPort</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  U-&gt;&gt;CLI: proxy start</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  CLI-&gt;&gt;CMD: startCommand()</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  CMD-&gt;&gt;CMD: loadConfig（读 ~/.cc-monitoring/config.json）</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  CMD-&gt;&gt;PM2: startProcess(ecosystemPath)</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  PM2-&gt;&gt;D: pm2 connect + start</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  D-&gt;&gt;S: fork dist/server/index.js</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  S-&gt;&gt;S: createServer → setupUi → setupProxy → setupChatRoute</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  S-&gt;&gt;S: listen host:port</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  Note over S: init SQLite 4 版 schema</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  CMD-&gt;&gt;N: waitForOnline (轮询 pm2 list)</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  N--&gt;&gt;CMD: online</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  CMD-&gt;&gt;N: waitForPort (递增退避 5 次)</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  N--&gt;&gt;CMD: listening</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  CMD--&gt;&gt;U: 打印 base URL / dashboard / logs 路径</span></span></code></pre></div><p><code>start.ts</code> 用 <code>ora</code> spinner 打印 6 步进度（Loading config → Locating PM2 config → Starting → Waiting online → Verifying port → Summary），失败时 spinner 变红并给出日志路径提示。</p>`,41)])])}const c=i(t,[["render",p]]);export{E as __pageData,c as default};

package/dist/docs/assets/proxy-core_entry.md.BZmIcCUM.lean.js ADDED Viewed

@@ -0,0 +1 @@

+ import{_ as i,o as a,c as n,a2 as e}from"./chunks/framework.D_Xv2a7c.js";const E=JSON.parse('{"title":"proxy-core / 启动链","description":"","frontmatter":{},"headers":[],"relativePath":"proxy-core/entry.md","filePath":"proxy-core/entry.md"}'),t={name:"proxy-core/entry.md"};function p(l,s,h,k,r,d){return a(),n("div",null,[...s[0]||(s[0]=[e("",41)])])}const c=i(t,[["render",p]]);export{E as __pageData,c as default};