leniu-dev 2.0.0 → 2.0.1

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

@@ -25,35 +25,9 @@ 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（或 ~/.cursor/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","...","dev15"]
-    }
-  }
-}
-```
-
-### 环境列表（默认）
+### 环境列表
 
 | 环境别名 | 名称 | URL | 快捷词 |
 |----------|------|-----|--------|
@@ -63,34 +37,31 @@ description: |
 | `monitor02-dev` | Monitor02 开发环境 | `https://monitor02-dev.xnzn.net/grafana` | m02, monitor02 |
 | `monitor-tyy-dev` | Monitor 体验园开发环境 | `https://monitor-tyy-dev.xnzn.net/grafana` | tyy, 体验园 |
 
-### 环境匹配规则（含 range）
+### 环境匹配规则
 
-| 用户说法 | 匹配方式 | 结果 |
-|---------|---------|------|
-| "查 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 匹配）
+### 读取配置
 
 ```bash
-# 按优先级查找配置文件
-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" \
-    "${HOME}/.cursor/loki-config.json"; do
-    [ -f "$f" ] && echo "$f" && return
-  done
+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}"
 }
 
-ENV_FILE=$(find_config)
-
-# 通过别名或 range 查找环境 key + project
+# 通过别名查找环境 key
 find_env() {
   python3 -c "
 import json
@@ -98,11 +69,10 @@ data = json.load(open('${ENV_FILE}'))
 alias = '${1}'.lower()
 for key, env in data['environments'].items():
     if alias == key or alias in env.get('aliases', []):
-        print(f'{key}|'); exit()
-for key, env in data['environments'].items():
-    if alias in env.get('projects', []):
-        print(f'{key}|{alias}'); exit()
-print(f'{data[\"active\"]}|')
+        print(key)
+        break
+else:
+    print(data['active'])
 "
 }
 ```

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

@@ -27,28 +27,22 @@ description: |
 
 ---
 
-## 连接信息获取（四级降级，自动查找）
+## 连接信息获取（三级降级，自动查找）
 
 当本技能被激活时，**按以下优先级获取数据库连接信息**：
 
 ### 优先级 1：用户对话中指定（最高优先级）
 
 用户直接给出连接信息，或指定环境名：
-- "连 dev 环境查一下" → 使用配置中 dev 环境
-- "去 dev10 查" → **范围匹配** dev 环境（range: "1~15"）
+- "连 dev 环境查一下" → 使用 `.claude/mysql-config.json` 中 dev 环境的配置
 - 直接给出 host/port/user/password → 直接使用
 
-### 优先级 2：本地项目 `.claude/mysql-config.json`
+### 优先级 2：`.claude/mysql-config.json`（显式配置，可选）
 
-项目目录下的配置文件，优先于全局配置。
+如果文件存在且当前环境的 password 不是占位符 `YOUR_PASSWORD`，使用该配置。
+**此文件为可选**，主要用于连接非本地环境（dev/prod 远程数据库）。
 
-### 优先级 3：全局配置（所有项目共享）
-
-全局配置文件（通过 `npx ai-engineering-init config --scope global` 创建）。
-查找路径：`~/.claude/mysql-config.json` 或 `~/.cursor/mysql-config.json`（取决于使用的工具）。
-**推荐**：公司统一的数据库连接信息放全局，项目特定的覆盖放本地。
-
-### 优先级 4：工程配置文件（零配置，本地开发默认）
+### 优先级 3：工程配置文件（零配置，本地开发默认）
 
 从项目的 `bootstrap-dev.yml` 中自动提取连接信息：
 

package/bin/index.js

@@ -804,25 +804,28 @@ function runUpdate(selectedTool) {
   if (force) console.log(`  ${fmt('yellow', '⚠  --force 模式：将同时更新保留文件')}`);
   console.log('');
 
+  // 读取安装元数据，恢复之前的角色和工具选择
+  const meta = readInstallMeta();
   let toolsToUpdate = [];
 
-  // 优先检测用户级安装，其次项目级
-  const detectUserTools = () => Object.keys(GLOBAL_RULES).filter(key =>
-    isRealDir(path.join(HOME_DIR, GLOBAL_RULES[key].targetDir || path.join(HOME_DIR, '.' + key)))
-  );
+  // 优先从元数据恢复，其次自动检测
   const userTools = Object.keys(GLOBAL_RULES).filter(key =>
     isRealDir(GLOBAL_RULES[key].targetDir)
   );
 
   if (!selectedTool || selectedTool === 'all') {
-    // 先尝试用户级，再尝试项目级
-    toolsToUpdate = userTools.length > 0 ? userTools : detectInstalledTools();
-    if (toolsToUpdate.length === 0) {
-      console.log(fmt('yellow', '⚠  未检测到已安装的 AI 工具配置。'));
-      console.log(`   请先运行: ${fmt('bold', hintCmd('install --tool claude'))}\n`);
-      process.exit(1);
+    if (meta && meta.tools && meta.tools.length > 0) {
+      toolsToUpdate = meta.tools.filter(k => GLOBAL_RULES[k]);
+      console.log(`  从安装记录恢复: ${fmt('bold', toolsToUpdate.join(', '))}`);
+    } else {
+      toolsToUpdate = userTools.length > 0 ? userTools : detectInstalledTools();
+      if (toolsToUpdate.length === 0) {
+        console.log(fmt('yellow', '⚠  未检测到已安装的 AI 工具配置。'));
+        console.log(`   请先运行: ${fmt('bold', hintCmd('install --tool claude'))}\n`);
+        process.exit(1);
+      }
+      console.log(`  检测到已安装: ${fmt('bold', toolsToUpdate.join(', '))}`);
     }
-    console.log(`  检测到已安装: ${fmt('bold', toolsToUpdate.join(', '))}`);
   } else {
     if (!GLOBAL_RULES[selectedTool]) {
       console.error(fmt('red', `无效工具: "${selectedTool}"。有效选项: claude | cursor | codex | all`));
@@ -831,9 +834,18 @@ function runUpdate(selectedTool) {
     toolsToUpdate = [selectedTool];
   }
 
+  // 恢复角色过滤（使用安装时选择的角色，或 --role 参数覆盖）
+  const role = installRole || (meta && meta.role) || 'all';
+  const allowedSkills = getSkillsForRole(role);
+  const roleLabels = { backend: '后端研发', frontend: '前端研发', product: '产品经理', all: '全部' };
+
   // 判断是否有用户级安装
   const isUserLevel = userTools.length > 0;
   console.log(`  更新模式: ${fmt('bold', isUserLevel ? '用户级' : '项目级')}`);
+  console.log(`  安装角色: ${fmt('bold', roleLabels[role] || role)}${meta && meta.role ? '' : '（未记录，默认全部）'}`);
+  if (allowedSkills) {
+    console.log(`  技能数量: ${fmt('bold', String(allowedSkills.size))} 个`);
+  }
   console.log('');
   console.log(fmt('bold', '正在更新框架文件...'));
   console.log('');
@@ -841,8 +853,8 @@ function runUpdate(selectedTool) {
   let totalUpdated = 0, totalFailed = 0, totalPreserved = 0;
   for (let i = 0; i < toolsToUpdate.length; i++) {
     if (isUserLevel) {
-      // 用户级更新：使用全局安装逻辑
-      const { installed, failed } = globalInstallTool(toolsToUpdate[i]);
+      // 用户级更新：使用全局安装逻辑 + 角色过滤
+      const { installed, failed } = globalInstallTool(toolsToUpdate[i], allowedSkills);
       totalUpdated += installed;
       totalFailed  += failed;
     } else {
@@ -2051,7 +2063,7 @@ const MCP_REGISTRY = [
     package: 'alibabacloud-devops-mcp-server',
     description: '阿里云效 — DevOps 项目管理、代码仓库、流水线集成',
     env: { YUNXIAO_ACCESS_TOKEN: '<YOUR_TOKEN>' },
-    recommended: false,
+    recommended: true,
   },
   {
     name: 'yuque',
@@ -2068,6 +2080,34 @@ const MCP_REGISTRY = [
     env: {},
     recommended: false,
   },
+  {
+    name: 'lanhu',
+    package: '@anthropic-ai/mcp-lanhu',
+    description: '蓝湖 — 读取 Axure 原型页面、UI 设计图、切图资源',
+    env: { LANHU_TOKEN: '<YOUR_TOKEN>' },
+    recommended: true,
+  },
+  {
+    name: 'apifox',
+    package: '@anthropic-ai/mcp-apifox',
+    description: 'Apifox — 接口文档读取，API 自动化测试联动',
+    env: { APIFOX_TOKEN: '<YOUR_TOKEN>' },
+    recommended: true,
+  },
+  {
+    name: 'firecrawl',
+    package: 'firecrawl-mcp',
+    description: 'Firecrawl — 网页爬取、结构化提取（比 fetch 更强）',
+    env: { FIRECRAWL_API_KEY: '<YOUR_KEY>' },
+    recommended: false,
+  },
+  {
+    name: 'exa',
+    package: 'exa-mcp-server',
+    description: 'Exa — AI 搜索引擎，语义搜索技术文档和代码',
+    env: { EXA_API_KEY: '<YOUR_KEY>' },
+    recommended: false,
+  },
 ];
 
 /** MCP 配置文件路径映射 */
@@ -2925,7 +2965,11 @@ function showInstallMenu() {
       console.log(`  技能:   ${fmt('bold', skillCountStr)}`);
       console.log(`  配置:   ${fmt('bold', selectedConfigs.length > 0 ? selectedConfigs.join(', ') : '无')}`);
       console.log(`  MCP:    ${fmt('bold', installMcp ? '推荐服务器' : '跳过')}`);
-      console.log(`  位置:   ${fmt('bold', '~/.claude/ (用户级)')}`);
+      const locationStr = selectedTool === 'all' ? '~/.claude/ ~/.cursor/ ~/.codex/'
+        : selectedTool === 'claude' ? '~/.claude/'
+        : selectedTool === 'cursor' ? '~/.cursor/'
+        : '~/.codex/';
+      console.log(`  位置:   ${fmt('bold', locationStr + ' (用户级)')}`);
       console.log('');
       const confirm = await ask(fmt('bold', '确认安装？[Y/n]: ')) || 'y';
       if (confirm.toLowerCase() === 'n') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "leniu-dev",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "AI 工程化开发工具 — 一键安装 Skills、Commands、Hooks 到 Claude Code / Cursor / Codex",
   "keywords": [
     "claude-code",

package/src/skills/jenkins-deploy/SKILL.md

@@ -0,0 +1,150 @@
+---
+name: jenkins-deploy
+description: |
+  Jenkins + Portainer 自动打包部署技能。通过 Python 脚本调用 Jenkins API 构建项目，并触发 Portainer Webhook/Update 完成容器更新。
+
+  触发场景：
+  - 需要将代码打包部署到 dev/test 环境
+  - 需要触发 Jenkins 构建 core 或 api 项目
+  - 需要更新 Portainer 容器服务
+  - 需要查看或修改构建配置（分支、环境、模式）
+  - 定制项目的打包部署
+
+  触发词：打包、部署、Jenkins、构建、Portainer、发布到dev、发布到test、更新环境、自动部署
+---
+
+# Jenkins + Portainer 自动打包部署
+
+## 架构
+
+```
+技能目录（随框架更新，不复制到项目）:
+  ~/.claude/skills/jenkins-deploy/assets/jk_build.py     ← 构建脚本
+
+全局配置（一次性配置，所有项目共享）:
+  ~/.claude/jenkins-config.json                           ← 凭证（Jenkins/Portainer）
+
+项目本地（自动生成）:
+  jenkins/last_cd_env.json                                ← 构建状态（环境、分支、模式）
+```
+
+脚本按 **本地 `.claude/` > 全局 `~/.claude/`** 优先级查找 `jenkins-config.json`。
+
+## 构建模式
+
+| 模式 | 说明 | 执行步骤 |
+|------|------|---------|
+| `0` | 只构建 | 构建 core + api，不更新 Portainer |
+| `1` | 全构建+更新 | 构建 core + api → 触发 Portainer 更新 |
+| `2` | 构建 api+更新 | 跳过 core，构建 api → 触发 Portainer 更新 |
+| `3` | 只更新 | 不构建，直接触发 Portainer 更新 |
+
+## 环境支持
+
+| 环境 | 前缀 | Portainer 更新方式 |
+|------|------|-------------------|
+| dev1~15 | `dev` | Webhook 触发 |
+| dev16~43 | `dev` | Force Update（xnzn-dev.xnzn.net） |
+| dev44+ | `dev` | 只支持模式 0（手动更新） |
+| test | `test` | Webhook 触发 |
+
+## 使用方式
+
+### 运行构建脚本
+
+```bash
+python ~/.claude/skills/jenkins-deploy/assets/jk_build.py
+```
+
+脚本交互式询问：模式 → 环境 → core 分支 → api 分支 → 定制工程文件夹
+
+### 命令行模式（推荐，AI 调用）
+
+```bash
+python3 ~/.claude/skills/jenkins-deploy/assets/jk_build.py \
+  --mode 2 --env dev10 --api-branch release_xxx --folder 常州技师学院
+```
+
+| 参数 | 缩写 | 说明 |
+|------|------|------|
+| `--mode` | `-m` | 构建模式（0/1/2/3） |
+| `--env` | `-e` | 目标环境（dev10, test1） |
+| `--core-branch` | | core 分支名 |
+| `--api-branch` | | api 分支名 |
+| `--folder` | `-f` | 定制项目文件夹名 |
+
+未传的参数自动使用 `last_cd_env.json` 中的上次值。
+
+### 通过 AI 辅助部署
+
+当用户说"打包到 devX"时，直接用命令行参数调用，不再需要 heredoc 模拟交互：
+
+```bash
+python3 ~/.claude/skills/jenkins-deploy/assets/jk_build.py --mode 2 --env dev10 --api-branch master
+```
+
+## 配置文件
+
+### jenkins-config.json（凭证，全局）
+
+位置：`~/.claude/jenkins-config.json`（或本地 `.claude/jenkins-config.json`）
+
+模板：`.claude/skills/jenkins-deploy/assets/env_param.template.json`
+
+> **注意**：此文件包含敏感凭证，不要将内容输出到对话中。
+
+### last_cd_env.json（构建状态，项目本地）
+
+位置：`jenkins/last_cd_env.json`（脚本自动创建，无需手动初始化）
+
+```json
+{
+  "build_mode": "1",
+  "cd_env": "dev1",
+  "core_param_branch": "master",
+  "api_param_branch": "master",
+  "api_param_folder": null
+}
+```
+
+## 定制项目
+
+指定 `api_param_folder` 后，Jenkins Job 路径变为：
+
+```
+{folder_name}/dev-后端-core
+{folder_name}/dev-后端-api
+```
+
+## 首次初始化（团队成员）
+
+只需一步：配置全局凭证文件。
+
+```bash
+# 方式 1：从团队成员拷贝
+cp /path/to/teammate/jenkins-config.json ~/.claude/jenkins-config.json
+
+# 方式 2：从模板创建，手动填写凭证
+cp ~/.claude/skills/jenkins-deploy/assets/env_param.template.json ~/.claude/jenkins-config.json
+# 然后替换 __JENKINS_*__ 和 __PORTAINER_*__ 占位符
+```
+
+### AI 初始化行为
+
+当技能被触发但 `jenkins-config.json` 不存在时：
+1. 提示"检测到尚未配置 Jenkins 凭证"
+2. 询问是否从模板创建
+3. 复制模板到 `~/.claude/jenkins-config.json`
+4. 提示用户填写凭证（或拷贝已有配置）
+
+## 依赖
+
+```bash
+pip install python-jenkins requests
+```
+
+## 注意
+
+- 本技能用于 dev/test 环境部署，**不涉及生产环境**
+- 如果是 Git 提交/分支管理，请使用 `git-workflow` 技能
+- 如果是代码构建错误排查，请使用 `bug-detective` 技能

package/src/skills/jenkins-deploy/assets/env_param.template.json

@@ -0,0 +1,51 @@
+{
+  "portainer_api_url": {
+    "dev": "https://devops-dev.xnzn.net/api",
+    "dev16": "https://xnzn-dev.xnzn.net/api",
+    "test": "https://devops-test.xnzn.net/api"
+  },
+  "portainer_user_name": {
+    "dev": "__PORTAINER_DEV_USER__",
+    "dev16": "__PORTAINER_DEV16_USER__",
+    "test": "__PORTAINER_TEST_USER__"
+  },
+  "portainer_user_pwd": {
+    "dev": "__PORTAINER_DEV_PWD__",
+    "dev16": "__PORTAINER_DEV16_PWD__",
+    "test": "__PORTAINER_TEST_PWD__"
+  },
+  "portainer_endpoints": {
+    "dev": "2",
+    "dev16": "1",
+    "test": "2"
+  },
+  "portainer_server_suffix": {
+    "dev": "_yunshitang-api",
+    "dev16": "_yunshitang-api-offline",
+    "test": "_yunshitang-api"
+  },
+  "core_job": {
+    "dev": "dev-tengyun-core",
+    "test": "test-tengyun-core"
+  },
+  "core_job_custom": {
+    "dev": "dev-后端-core",
+    "test": "test-后端-core"
+  },
+  "api_job": {
+    "dev": "dev-tengyun-yunshitang-api",
+    "test": "test-tengyun-yunshitang-api"
+  },
+  "api_job_custom": {
+    "dev": "dev-后端-api",
+    "test": "test-后端-api"
+  },
+  "jenkins_user_id": {
+    "dev": "__JENKINS_DEV_USER__",
+    "test": "__JENKINS_TEST_USER__"
+  },
+  "jenkins_api_token": {
+    "dev": "__JENKINS_DEV_TOKEN__",
+    "test": "__JENKINS_TEST_TOKEN__"
+  }
+}