ai-engineering-init 1.16.1 → 1.16.2

package/.claude/skills/mysql-debug/SKILL.md

@@ -42,9 +42,10 @@ description: |
 
 项目目录下的配置文件，优先于全局配置。
 
-### 优先级 3：全局 `~/.claude/mysql-config.json`
+### 优先级 3：全局配置（所有项目共享）
 
-全局配置文件（通过 `npx ai-engineering-init config --scope global` 创建），所有项目共享。
+全局配置文件（通过 `npx ai-engineering-init config --scope global` 创建）。
+查找路径：`~/.claude/mysql-config.json` 或 `~/.cursor/mysql-config.json`（取决于使用的工具）。
 **推荐**：公司统一的数据库连接信息放全局，项目特定的覆盖放本地。
 
 ### 优先级 4：工程配置文件（零配置，本地开发默认）
@@ -115,11 +116,12 @@ brew install mysql-client
 ### 配置文件查找顺序
 
 ```
-1. 本地项目：.claude/mysql-config.json
-2. 全局配置：~/.claude/mysql-config.json
+1. 本地项目：.claude/mysql-config.json（或 .cursor/mysql-config.json）
+2. 全局配置：~/.claude/mysql-config.json（或 ~/.cursor/mysql-config.json）
 ```
 
 本地配置优先。如果本地无配置，使用全局。两者都存在时，本地覆盖全局（同名环境取本地值）。
+`config --scope global` 会同时写入 `~/.claude/` 和 `~/.cursor/`（如果目录存在）。
 
 ### 配置文件结构（支持 range 范围匹配）
 

package/.cursor/skills/loki-log-query/SKILL.md

@@ -25,81 +25,114 @@ description: |
 
 ## 多环境配置
 
-配置文件：`.claude/skills/loki-log-query/environments.json`
+### 配置文件查找顺序
 
-### 环境列表
+```
+1. 本地项目：.claude/loki-config.json（新格式）
+2. 本地项目：.claude/skills/loki-log-query/environments.json（旧格式，兼容）
+3. 全局配置：~/.claude/loki-config.json
+```
+
+本地配置优先。全局配置推荐用 `npx ai-engineering-init config --type loki --scope global` 创建。
+
+### 配置结构（支持 range 范围匹配）
+
+```json
+{
+  "active": "monitor-dev",
+  "environments": {
+    "monitor-dev": {
+      "name": "Monitor 开发环境",
+      "url": "https://monitor-dev.xnzn.net/grafana",
+      "token": "glsa_xxx",
+      "aliases": ["mdev", "dev"],
+      "range": "dev1~15",
+      "projects": ["dev01","dev02","dev03","dev04","dev05","dev06","dev07","dev08","dev09","dev10","dev11","dev12","dev13","dev14","dev15"]
+    }
+  }
+}
+```
+
+### 环境匹配规则（含 range 范围匹配）
 
-| 环境别名 | 名称 | URL | 快捷词 |
-|----------|------|-----|--------|
-| `test13` | 测试13（主测试环境） | `https://test13.xnzn.net/grafana` | test13, 13 |
-| `monitor-test` | Monitor 测试环境 | `https://monitor-test.xnzn.net/grafana` | mtest |
-| `monitor-dev` | Monitor 开发环境 | `https://monitor-dev.xnzn.net/grafana` | mdev, dev |
-| `monitor02-dev` | Monitor02 开发环境 | `https://monitor02-dev.xnzn.net/grafana` | m02, monitor02 |
-| `monitor-tyy-dev` | Monitor 体验园开发环境 | `https://monitor-tyy-dev.xnzn.net/grafana` | tyy, 体验园 |
+用户说的话 → 匹配逻辑：
 
-### 环境匹配规则
+| 用户说法 | 匹配方式 | 结果 |
+|---------|---------|------|
+| "查 test13 的日志" | 精确匹配 key 或 aliases | `test13` 环境 |
+| "去 dev10 查" | **range 匹配**：dev10 在 monitor-dev 的 projects 中 | `monitor-dev` 环境，`project="dev10"` |
+| "去 monitor-dev 查" | 精确匹配 key | `monitor-dev` 环境 |
+| "切到体验园" | aliases 匹配 | `monitor-tyy-dev` 环境 |
+| 未指定环境 | 使用 `active` 字段 | 默认活跃环境 |
 
-用户说的话 → 匹配环境：
-- "查 test13 的日志" → `test13`
-- "去 monitor-dev 查" → `monitor-dev`
-- "切到体验园" → `monitor-tyy-dev`
-- "去 m02 查一下" → `monitor02-dev`
-- 未指定环境 → 使用 `active` 字段指定的默认环境
+**range 匹配算法**：
+```
+1. 用户输入 "dev10"
+2. 先精确匹配 key / aliases → 未命中
+3. 遍历所有环境的 projects 列表，检查是否包含 "dev10"
+4. 命中 → 使用该环境，并自动添加 project="dev10" 标签过滤
+```
 
-### 读取配置
+### 读取配置（含全局降级 + range 匹配）
 
 ```bash
-SKILL_DIR="$CLAUDE_PROJECT_DIR/.claude/skills/loki-log-query"
-ENV_FILE="${SKILL_DIR}/environments.json"
-
-# 读取指定环境（参数: 环境别名）
-read_env() {
-  local ENV_KEY="${1:-$(python3 -c "import json; print(json.load(open('${ENV_FILE}'))['active'])")}"
-  GRAFANA_URL=$(python3 -c "import json; print(json.load(open('${ENV_FILE}'))['environments']['${ENV_KEY}']['url'])")
-  TOKEN=$(python3 -c "import json; print(json.load(open('${ENV_FILE}'))['environments']['${ENV_KEY}']['token'])")
-  API="${GRAFANA_URL}/api/datasources/proxy/uid/loki/loki/api/v1"
-  echo "Environment: ${ENV_KEY} → ${GRAFANA_URL}"
+# 按优先级查找配置文件
+find_config() {
+  local PROJECT_DIR="${CLAUDE_PROJECT_DIR:-.}"
+  for f in \
+    "${PROJECT_DIR}/.claude/loki-config.json" \
+    "${PROJECT_DIR}/.claude/skills/loki-log-query/environments.json" \
+    "${HOME}/.claude/loki-config.json"; do
+    [ -f "$f" ] && echo "$f" && return
+  done
+  echo ""
 }
 
-# 通过别名查找环境 key
+ENV_FILE=$(find_config)
+
+# 通过别名或 range 查找环境 key + project
 find_env() {
   python3 -c "
-import json
+import json, re
 data = json.load(open('${ENV_FILE}'))
 alias = '${1}'.lower()
+# 1. 精确匹配 key 或 aliases
 for key, env in data['environments'].items():
     if alias == key or alias in env.get('aliases', []):
-        print(key)
-        break
-else:
-    print(data['active'])
+        print(f'{key}|')  # key|project（project 为空）
+        exit()
+# 2. range 匹配：在 projects 列表中查找
+for key, env in data['environments'].items():
+    if alias in env.get('projects', []):
+        print(f'{key}|{alias}')
+        exit()
+# 3. 未命中，返回默认
+print(f'{data[\"active\"]}|')
 "
 }
+
+# 使用示例：
+# result=$(find_env "dev10")
+# ENV_KEY=$(echo "$result" | cut -d'|' -f1)   # monitor-dev
+# PROJECT=$(echo "$result" | cut -d'|' -f2)    # dev10
+# 查询时：{app="yunshitang",project="${PROJECT}"}
 ```
 
-### 切换活跃环境
+### 切换活跃环境 / 更新 Token
 
 ```bash
-# 切换默认环境为 monitor-dev
 python3 -c "
 import json
 data = json.load(open('${ENV_FILE}'))
 data['active'] = 'monitor-dev'
 json.dump(data, open('${ENV_FILE}', 'w'), indent=2, ensure_ascii=False)
-print('Switched to:', data['active'])
 "
-```
 
-### 更新 Token
-
-```bash
-# 为某个环境设置 Token
 python3 -c "
 import json
 data = json.load(open('${ENV_FILE}'))
-data['environments']['monitor-dev']['token'] = 'glsa_新的token值'
+data['environments']['monitor-dev']['token'] = 'glsa_新token'
 json.dump(data, open('${ENV_FILE}', 'w'), indent=2, ensure_ascii=False)
-print('Token updated for monitor-dev')
 "
 ```
 

package/.cursor/skills/mysql-debug/SKILL.md

@@ -27,22 +27,27 @@ description: |
 
 ---
 
-## 连接信息获取（三级降级，自动查找）
+## 连接信息获取（四级降级，自动查找）
 
 当本技能被激活时，**按以下优先级获取数据库连接信息**：
 
 ### 优先级 1：用户对话中指定（最高优先级）
 
 用户直接给出连接信息，或指定环境名：
-- "连 dev 环境查一下" → 使用 `.claude/mysql-config.json` 中 dev 环境的配置
+- "连 dev 环境查一下" → 使用配置中 dev 环境
+- "去 dev10 查" → **范围匹配** dev 环境（range: "1~15"）
 - 直接给出 host/port/user/password → 直接使用
 
-### 优先级 2：`.claude/mysql-config.json`（显式配置，可选）
+### 优先级 2：本地项目 `.claude/mysql-config.json`
 
-如果文件存在且当前环境的 password 不是占位符 `YOUR_PASSWORD`，使用该配置。
-**此文件为可选**，主要用于连接非本地环境（dev/prod 远程数据库）。
+项目目录下的配置文件，优先于全局配置。
 
-### 优先级 3：工程配置文件（零配置，本地开发默认）
+### 优先级 3：全局 `~/.claude/mysql-config.json`
+
+全局配置文件（通过 `npx ai-engineering-init config --scope global` 创建），所有项目共享。
+**推荐**：公司统一的数据库连接信息放全局，项目特定的覆盖放本地。
+
+### 优先级 4：工程配置文件（零配置，本地开发默认）
 
 从项目的 `bootstrap-dev.yml` 中自动提取连接信息：
 
@@ -107,43 +112,60 @@ brew install mysql-client
 
 ## 多环境支持
 
-### 配置文件结构
+### 配置文件查找顺序
+
+```
+1. 本地项目：.claude/mysql-config.json
+2. 全局配置：~/.claude/mysql-config.json
+```
+
+本地配置优先。如果本地无配置，使用全局。两者都存在时，本地覆盖全局（同名环境取本地值）。
 
-`.claude/mysql-config.json` 支持多环境配置：
+### 配置文件结构（支持 range 范围匹配）
 
 ```json
 {
   "environments": {
-    "local": { "host": "127.0.0.1", "port": 3306, "user": "root", "password": "xxx" },
-    "dev":   { "host": "dev-db.example.com", "port": 3306, "user": "dev_user", "password": "xxx" },
+    "local": { "host": "127.0.0.1", "port": 3306, "user": "root", "password": "xxx", "_desc": "本地环境" },
+    "dev":   { "host": "dev-db.example.com", "port": 3306, "user": "dev_user", "password": "xxx", "range": "1~15", "_desc": "覆盖 dev1→dev15" },
+    "test":  { "host": "test-db.example.com", "port": 3306, "user": "test_user", "password": "xxx", "range": "1~30", "_desc": "覆盖 test1→test30" },
     "prod":  { "host": "prod-db.example.com", "port": 3306, "user": "readonly", "password": "xxx" }
   },
   "default": "local"
 }
 ```
 
+### 环境范围匹配（range）
+
+`range` 字段支持 `起始~结束` 格式，用于一个配置覆盖多个编号环境：
+
+| 用户说法 | 匹配逻辑 | 结果 |
+|---------|---------|------|
+| "去 dev10 查" | 提取前缀 `dev`、编号 `10`，检查 dev 环境 range "1~15"，10 在范围内 | 使用 dev 配置 |
+| "连 test25" | 提取前缀 `test`、编号 `25`，检查 test 环境 range "1~30"，25 在范围内 | 使用 test 配置 |
+| "连 prod" | 精确匹配 prod 环境 | 使用 prod 配置 |
+
+**匹配算法**：
+```
+1. 用户输入的环境名（如 "dev10"）
+2. 先精确匹配环境 key（environments["dev10"]）
+3. 未命中 → 拆分为前缀+编号（"dev" + 10）
+4. 查找有 range 字段的环境，前缀匹配 + 编号在范围内
+5. 命中 → 使用该环境的 host/port/user/password
+```
+
 ### 环境选择规则
 
 | 优先级 | 来源 | 示例 |
 |--------|------|------|
-| 1（最高） | 用户对话中指定 | "连 dev 环境查一下"、"用生产库看看" |
+| 1（最高） | 用户对话中指定 | "连 dev10 环境查一下" |
 | 2 | 配置文件 `default` 字段 | `"default": "local"` |
 
-### 环境关键词映射
-
-用户说的话 → 对应环境名：
-
-| 用户说法 | 环境 |
-|---------|------|
-| "本地"、"local"、"本地环境" | `local` |
-| "开发"、"dev"、"测试环境"、"开发环境" | `dev` |
-| "生产"、"prod"、"线上"、"正式环境" | `prod` |
-
 ### 连接示例
 
 ```bash
-# 用户说"连 dev 环境查一下 order_info"
-# → 读取 environments.dev 的连接信息 + 日志提取的数据库名
+# 用户说"连 dev10 环境查一下 order_info"
+# → range 匹配到 dev 环境的连接信息 + 日志提取的数据库名
 mysql -h dev-db.example.com -P 3306 -u dev_user -p'xxx' 546198574447230976 -e "SELECT ..."
 ```
 

package/README.md

@@ -27,6 +27,8 @@ npx ai-engineering-init --tool all      # 全部
 | `npx ai-engineering-init` | 交互式初始化到当前项目 |
 | `npx ai-engineering-init@latest update` | 更新已安装的框架文件 |
 | `npx ai-engineering-init@latest global` | 全局安装到 `~/.claude` 等，所有项目生效 |
+| `npx ai-engineering-init config` | 初始化数据库连接 / Loki 日志配置（支持全局/本地/追加） |
+| `npx ai-engineering-init mcp` | MCP 服务器管理（安装/卸载/状态） |
 | `npx ai-engineering-init sync-back` | 对比本地技能修改，反馈回源仓库 |
 
 > 所有命令均支持 `--tool <claude|cursor|codex|all>` 指定工具。运行 `--help` 查看全部选项。

package/bin/index.js

@@ -1350,12 +1350,23 @@ async function runMysqlConfig(ask, isGlobal) {
     _comment: '环境支持 range 字段（如 "1~15"），用户说"dev10"时自动匹配。查找顺序：本地 .claude/ > 全局 ~/.claude/',
   };
 
+  const configJson = JSON.stringify(config, null, 2) + '\n';
+  // 写入主路径
   const dir = path.dirname(configPath);
   if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-  fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+  fs.writeFileSync(configPath, configJson, 'utf-8');
   console.log(`  ${fmt('green', '✔')} 已写入：${configPath}`);
 
-  if (!isGlobal) ensureGitignore(['mysql-config.json']);
+  // 全局模式：同时写入 ~/.cursor/（如果目录存在）
+  if (isGlobal) {
+    const cursorConfigPath = path.join(HOME_DIR, '.cursor', 'mysql-config.json');
+    if (fs.existsSync(path.join(HOME_DIR, '.cursor'))) {
+      fs.writeFileSync(cursorConfigPath, configJson, 'utf-8');
+      console.log(`  ${fmt('green', '✔')} 已同步：${cursorConfigPath}`);
+    }
+  } else {
+    ensureGitignore(['mysql-config.json']);
+  }
 
   console.log('');
   console.log(fmt('green', 'MySQL 数据库配置完成！'));
@@ -1540,11 +1551,22 @@ async function collectLokiEnvInput(ask, index, total) {
 }
 
 function writeLokiConfig(config, configPath, isGlobal) {
+  const configJson = JSON.stringify(config, null, 2) + '\n';
   const dir = path.dirname(configPath);
   if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-  fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+  fs.writeFileSync(configPath, configJson, 'utf-8');
   console.log(`  ${fmt('green', '✔')} 已写入：${configPath}`);
-  if (!isGlobal) ensureGitignore(['loki-config.json', 'environments.json']);
+
+  // 全局模式：同时写入 ~/.cursor/（如果目录存在）
+  if (isGlobal) {
+    const cursorConfigPath = path.join(HOME_DIR, '.cursor', 'loki-config.json');
+    if (fs.existsSync(path.join(HOME_DIR, '.cursor'))) {
+      fs.writeFileSync(cursorConfigPath, configJson, 'utf-8');
+      console.log(`  ${fmt('green', '✔')} 已同步：${cursorConfigPath}`);
+    }
+  } else {
+    ensureGitignore(['loki-config.json', 'environments.json']);
+  }
   console.log('');
   console.log(fmt('green', 'Loki 日志查询配置完成！'));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-engineering-init",
-  "version": "1.16.1",
+  "version": "1.16.2",
   "description": "AI 工程化配置初始化工具 — 一键为 Claude Code、OpenAI Codex 等 AI 工具初始化 Skills 和项目规范",
   "keywords": [
     "claude-code",