fix: resolve ops-metrics test failure and sync README_ZH for mode separation

- Fix ops-metrics test: use dynamic date instead of hardcoded 2026-04-05
  to prevent Logger cleanupOldLogs from deleting test fixtures before
  ops:metrics can read them
- Sync README_ZH.md with mode separation: add --mode flag to setup:local,
  update integration modes section, add CONTEXTATLAS_EXPOSURE_MODE to
  Claude Desktop config example

Author: codefromkarl

README_ZH.md

@@ -133,7 +133,10 @@ npm install -g @codefromkarl/context-atlas
 
 ```bash
 contextatlas init
-contextatlas setup:local
+# 选择接入模式：
+contextatlas setup:local --mode cli-skill   # 终端 + skill 集成
+# 或
+contextatlas setup:local --mode mcp         # MCP 客户端集成
 ```
 
 默认配置文件位置：
@@ -169,7 +172,7 @@ INDEX_UPDATE_MIN_CHANGED_FILES=5
 - `contextatlas index:diagnose`：直接回显当前阈值和升级判定配置，适合排查“为什么升级成 full / 为什么仍保持 incremental”
 
 > `init` 会写入一份可直接编辑的示例 `.env`，包括默认的 SiliconFlow endpoint 和推荐模型配置。
-> `setup:local` 会继续把 Claude / Codex / Gemini 所需的 MCP 配置、提示词文档和 Codex skill 一起写好。
+> `setup:local --mode <mode>` 仅写入所选模式的配置文件。模式选择指引见 [首次使用](./docs/guides/first-use.md)。
 
 更多配置与部署细节见 [部署手册](./docs/guides/deployment.md) 和 [CLI 文档](./docs/reference/cli.md)。
 
@@ -218,7 +221,14 @@ contextatlas mcp
 
 ## 接入方式
 
-### 1. 作为本地 CLI / Skill Backend
+ContextAtlas 支持两种互斥的接入模式，通过 `setup:local --mode <mode>` 选择：
+
+- **cli-skill**：终端 + skill 集成，所有操作通过 `contextatlas` CLI 命令完成，不暴露 MCP server
+- **mcp**：MCP 客户端集成，通过 Claude Desktop、Cursor、Codex MCP 等标准工具协议调用
+
+详见 [首次使用](./docs/guides/first-use.md) 中的模式选择指引。
+
+### 1. 作为本地 CLI / Skill Backend（cli-skill 模式）
 
 适合：
 
@@ -240,7 +250,7 @@ contextatlas decision:list
 contextatlas health:full
 ```
 
-### 2. 作为 MCP Server
+### 2. 作为 MCP Server（mcp 模式）
 
 适合：
 
@@ -254,7 +264,10 @@ Claude Desktop 配置示例：
   "mcpServers": {
     "contextatlas": {
       "command": "contextatlas",
-      "args": ["mcp"]
+      "args": ["mcp"],
+      "env": {
+        "CONTEXTATLAS_EXPOSURE_MODE": "mcp"
+      }
     }
   }
 }

tests/ops-metrics.test.ts

@@ -240,9 +240,13 @@ test('ops:metrics CLI 在未显式传 log-dir 时默认读取 baseDir/logs', ()
   const previousBaseDir = process.env.CONTEXTATLAS_BASE_DIR;
   process.env.CONTEXTATLAS_BASE_DIR = baseDir;
 
+  // 使用当天日期，避免日志被 Logger.cleanupOldLogs 在启动时自动清理
+  const today = new Date();
+  const todayStr = today.toISOString().slice(0, 10);
+
   try {
     recordToolUsage({
-      timestamp: '2026-04-05T09:00:00.000Z',
+      timestamp: `${todayStr}T09:00:00.000Z`,
       source: 'mcp',
       toolName: 'codebase-retrieval',
       projectId: 'proj-metrics-default-log',
@@ -258,8 +262,8 @@ test('ops:metrics CLI 在未显式传 log-dir 时默认读取 baseDir/logs', ()
     const logsDir = path.join(baseDir, 'logs');
     fs.mkdirSync(logsDir, { recursive: true });
     fs.writeFileSync(
-      path.join(logsDir, 'app.2026-04-05.log'),
-      `2026-04-05 09:00:00 [INFO] MCP codebase-retrieval 完成 ${JSON.stringify({
+      path.join(logsDir, `app.${todayStr}.log`),
+      `${todayStr} 09:00:00 [INFO] MCP codebase-retrieval 完成 ${JSON.stringify({
         requestId: 'req-default-log',
         projectId: 'proj-metrics-default-log',
         totalMs: 321,