From 4ce74541bfd7282427e7c24cdf7e3c1f9decd791 Mon Sep 17 00:00:00 2001
From: starmen1265 <starmen1265@163.com>
Date: Fri, 13 Feb 2026 17:24:18 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=E6=89=A7=E8=A1=8C?=
 =?UTF-8?q?=E6=96=B9=E5=BC=8F=E5=92=8C=E7=8E=AF=E5=A2=83=E5=8F=98=E9=87=8F?=
 =?UTF-8?q?=E9=85=8D=E7=BD=AE=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 skills/kb-deep-analyzer/SKILL.md | 47 ++++++++++++++++++++++++++++++--
 1 file changed, 45 insertions(+), 2 deletions(-)

diff --git a/skills/kb-deep-analyzer/SKILL.md b/skills/kb-deep-analyzer/SKILL.md
index c58e78c..4cbf26c 100644
--- a/skills/kb-deep-analyzer/SKILL.md
+++ b/skills/kb-deep-analyzer/SKILL.md
@@ -13,8 +13,9 @@
 ## Commands
 
 ```bash
-# 分析内容
-python deep_analyzer.py --metadata meta.json --content content.json --output analysis.md
+# 分析内容（推荐：使用 -u 参数强制无缓冲输出）
+AI_API_KEY="your-api-key" AI_PROVIDER="zhipu" AI_MODEL="glm-4.7" \
+  python3 -u deep_analyzer.py --metadata meta.json --content content.json --output analysis.md
 
 # 指定类型
 python deep_analyzer.py --metadata meta.json --content content.json --type tutorial --output tutorial.md
@@ -23,6 +24,48 @@ python deep_analyzer.py --metadata meta.json --content content.json --type tutor
 python deep_analyzer.py -m meta.json -c content.json -o out.md --provider zhipu --model glm-4
 ```
 
+## 环境变量配置
+
+**必须设置以下环境变量**：
+
+```bash
+export AI_API_KEY="your-api-key"
+export AI_PROVIDER="zhipu"           # 或 openai, minimax
+export AI_MODEL="glm-4.7"           # 模型名称
+export AI_BASE_URL="https://..."    # 可选，自定义 API 地址
+```
+
+### 重要提示
+
+**必须使用 `-u` 参数运行 Python**，确保输出实时显示在终端：
+
+```bash
+python3 -u deep_analyzer.py ...
+```
+
+如果不使用 `-u` 参数，Python 的 stdout 缓冲会导致输出延迟或看不到进度。
+
+## 执行方式选择
+
+### 方式1: 并发执行（推荐，默认）
+- 使用 `batch_size=3`（默认）
+- 6个分片约 100 秒完成
+- 适合快速分析
+
+```bash
+python3 -u deep_analyzer.py --metadata meta.json --content content.json -o out.md
+```
+
+### 方式2: 顺序执行
+- 使用 `batch_size=1`
+- 6个分片约 735 秒完成
+- 适合调试和问题排查
+
+```bash
+# 在代码中设置 batch_size=1
+# analyzer.analyze(metadata, content, "video", batch_size=1)
+```
+
 ## Metadata Format
 
 支持两种元数据格式：