docs: expand metrics configuration guide

Author: TiaraBasori

docs/configuration.md

@@ -36,6 +36,10 @@
 | `OPENCODE_INTERNAL_ALLOWED_TOOLS` | `(none)` | 当请求未传入 `tools` 时允许使用的 OpenCode 内置工具列表，逗号分隔 |
 | `OPENCODE_INTERNAL_TOOL_METRICS_ENABLED` | `true` | 输出 internal allowlist 模式的调试/指标日志 |
 | `OPENCODE_TOOL_DISCOVERY_FIXTURE` | `(none)` | 集成测试/本地调试用的固定后端工具 ID 列表，逗号分隔 |
+| `OPENCODE_HEALTH_DETAILS_ENABLED` | `true` | 控制 `/health/details` 是否暴露 |
+| `OPENCODE_HEALTH_DETAILS_REQUIRE_AUTH` | `true` | 控制 `/health/details` 是否要求 Bearer 认证 |
+| `OPENCODE_METRICS_ENABLED` | `false` | 控制 Prometheus `/metrics` 是否暴露 |
+| `OPENCODE_METRICS_REQUIRE_AUTH` | `true` | 控制 `/metrics` 是否要求 Bearer 认证 |
 | `USE_ISOLATED_HOME` | `false` | 使用隔离的 OpenCode 配置目录 |
 | `PROMPT_MODE` | `standard` | 提示词处理模式 |
 | `OMIT_SYSTEM_PROMPT` | `false` | 忽略传入的 system prompt |
@@ -132,6 +136,8 @@ OpenCode2API 现在支持把外部客户端传入的 OpenAI-compatible `tools` 
 ### 结构化健康诊断接口
 
 可以通过 `GET /health/details` 接口获取代理内部的运行状态与指标。这不仅有助于问题排查，也是用于编写集成行为测试的重要依据。
+- `OPENCODE_HEALTH_DETAILS_ENABLED=false` 时，接口返回 `404`。
+- `OPENCODE_HEALTH_DETAILS_REQUIRE_AUTH=true` 时，接口要求 Bearer 认证；否则返回 `401`。
 返回值格式如下：
 ```json
 {
@@ -154,11 +160,34 @@ OpenCode2API 现在支持把外部客户端传入的 OpenAI-compatible `tools` 
       "tool_ids_cached": true,
       "tool_id_count": 3,
       "age_ms": 12000
+    },
+    "audit": {
+      "available": true,
+      "fields": [
+        "requestedAllowlist",
+        "allowedToolNames",
+        "deniedRequestedTools",
+        "resolutionPath",
+        "resultingMode"
+      ]
     }
   }
 }
 ```
 
+### Prometheus 指标接口
+
+可以通过 `GET /metrics` 获取 Prometheus 文本格式指标。
+- `OPENCODE_METRICS_ENABLED=false` 时，接口返回 `404`。
+- `OPENCODE_METRICS_REQUIRE_AUTH=true` 时，接口要求 Bearer 认证；否则返回 `401`。
+当前暴露的核心指标包括：
+- `opencode_internal_tool_mode_requests_total{mode="external_bridge"}`
+- `opencode_internal_tool_mode_requests_total{mode="internal_allowlist"}`
+- `opencode_internal_tool_mode_requests_total{mode="disabled"}`
+- `opencode_internal_tool_discovery_failures_total`
+- `opencode_internal_tool_fallback_disabled_total`
+- `opencode_internal_tool_cache_ids`
+
 ### 推荐生产配置
 
 ```bash
@@ -168,11 +197,16 @@ OPENCODE_EXTERNAL_TOOLS_CONFLICT_POLICY=namespace
 OPENCODE_INTERNAL_ALLOWED_TOOLS=web_fetch
 OPENCODE_INTERNAL_TOOL_METRICS_ENABLED=true
 OPENCODE_TOOL_DISCOVERY_FIXTURE=
+OPENCODE_HEALTH_DETAILS_ENABLED=true
+OPENCODE_HEALTH_DETAILS_REQUIRE_AUTH=true
+OPENCODE_METRICS_ENABLED=false
+OPENCODE_METRICS_REQUIRE_AUTH=true
 OPENCODE_PROXY_PROMPT_MODE=plugin-inject
 OPENCODE_PROXY_OMIT_SYSTEM_PROMPT=true
 OPENCODE_PROXY_AUTO_CLEANUP_CONVERSATIONS=true
 ```
 
+
 ---
 
 ## 🎯 Prompt Mode 说明
@@ -195,11 +229,16 @@ OPENCODE_EXTERNAL_TOOLS_CONFLICT_POLICY=namespace
 OPENCODE_INTERNAL_ALLOWED_TOOLS=web_fetch
 OPENCODE_INTERNAL_TOOL_METRICS_ENABLED=true
 OPENCODE_TOOL_DISCOVERY_FIXTURE=
+OPENCODE_HEALTH_DETAILS_ENABLED=true
+OPENCODE_HEALTH_DETAILS_REQUIRE_AUTH=true
+OPENCODE_METRICS_ENABLED=false
+OPENCODE_METRICS_REQUIRE_AUTH=true
 OPENCODE_PROXY_PROMPT_MODE=plugin-inject
 OPENCODE_PROXY_OMIT_SYSTEM_PROMPT=true
 OPENCODE_PROXY_AUTO_CLEANUP_CONVERSATIONS=true
 ```
 
+
 ### 💻 本地开发
 
 ```bash