@tapdb/tapdb-data-analysis 0.1.22 → 0.1.24

package/README.md

@@ -34,14 +34,17 @@ TapDB 有国内(CN)和海外(SG)两套部署，需配置认证密钥。
 
 ### 必需变量
 
-```bash
-# 国内(CN)部署密钥
-export TAPDB_MCP_KEY_CN="your-cn-mcp-key-here"
+密钥**必须写入 shell 配置文件**（zsh 用户写 `~/.zshrc`，bash 用户写 `~/.bashrc`），以确保所有终端会话和 AI 工具都能读取到：
 
-# 海外(SG)部署密钥
-export TAPDB_MCP_KEY_SG="your-sg-mcp-key-here"
+```bash
+export TAPDB_MCP_KEY_CN="your-cn-mcp-key-here"   # 国内(CN)部署密钥
+export TAPDB_MCP_KEY_SG="your-sg-mcp-key-here"   # 海外(SG)部署密钥
 ```
 
+将上面两行写入对应的 shell 配置文件后执行 `source` 使其生效。
+
+> **注意**：仅在当前终端 `export` 而不写入配置文件的话，新终端窗口或 AI Agent 启动的 shell 会话将无法读取到密钥。Skill 在每次会话首次使用时会自动检查配置文件中是否存在密钥，如果缺失会自动写入。
+
 ### 验证配置
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tapdb/tapdb-data-analysis",
-  "version": "0.1.22",
+  "version": "0.1.24",
   "description": "TapDB 游戏数据分析 AI Agent Skill - 查询和分析 TapDB 中的游戏运营数据（活跃/留存/付费/来源/LTV 等）",
   "keywords": [
     "tapdb",

package/tapdb-data-analysis/SKILL.md

@@ -11,7 +11,7 @@ description: >
 
 # TapDB 数据分析
 
-> Skill 版本：v0.1.21
+> Skill 版本：v0.1.24
 
 通过 Python 脚本调用 TapDB 运营数据查询接口，获取游戏的活跃、留存、付费、来源等指标数据并分析。
 
@@ -49,7 +49,11 @@ rm -rf package tapdb-tapdb-data-analysis-*.tgz
 [ -z "$TAPDB_MCP_KEY_SG" ] && echo "❌ SG 未设置" || echo "✅ SG 已配置"
 ```
 
-缺少则**停止操作**，引导配置：秘钥在 **TapDB 页面右上角 → 账号设置 → 秘钥管理**。国内 CN/海外 SG 各需独立秘钥。用户提供后根据 `$SHELL` 写入对应 shell 配置文件并 `source` 生效，然后运行 `list_projects` 验证。
+缺少则**停止操作**，引导配置：秘钥在 **TapDB 页面右上角 → 账号设置 → 秘钥管理**。国内 CN/海外 SG 各需独立秘钥。用户提供后按步骤 3 写入 shell 配置文件并验证。
+
+### 3. 持久化检查
+
+环境变量必须写入 shell 配置文件（根据 `$SHELL` 判断，zsh → `~/.zshrc`，bash → `~/.bashrc`），确保重启终端 / 新会话后仍可用。检查配置文件中是否已包含 `TAPDB_MCP_KEY_CN` / `TAPDB_MCP_KEY_SG` 的 export 语句，缺失的自动追加并 `source` 生效，然后运行 `list_projects` 验证。
 
 ## 工作流程