ai-engineering-init 1.16.4 → 1.17.1

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

@@ -0,0 +1,207 @@
+---
+name: jenkins-deploy
+description: |
+  Jenkins + Portainer 自动打包部署技能。通过 Python 脚本调用 Jenkins API 构建项目，并触发 Portainer Webhook/Update 完成容器更新。
+
+  触发场景：
+  - 需要将代码打包部署到 dev/test 环境
+  - 需要触发 Jenkins 构建 core 或 api 项目
+  - 需要更新 Portainer 容器服务
+  - 需要查看或修改构建配置（分支、环境、模式）
+  - 定制项目的打包部署
+
+  触发词：打包、部署、Jenkins、构建、Portainer、发布到dev、发布到test、更新环境、自动部署
+---
+
+# Jenkins + Portainer 自动打包部署
+
+## 概述
+
+项目使用 `jenkins/` 目录下的 Python 脚本实现自动化构建部署，流程：
+
+```
+Jenkins 构建 core → Jenkins 构建 api → Portainer 更新容器
+```
+
+## 文件位置
+
+| 文件 | 作用 |
+|------|------|
+| `jenkins/jk_build.py` | 主构建脚本 |
+| `jenkins/env_param.json` | 环境配置（Jenkins/Portainer 连接参数） |
+| `jenkins/last_cd_env.json` | 上次构建参数（自动保存） |
+
+## 构建模式
+
+| 模式 | 说明 | 执行步骤 |
+|------|------|---------|
+| `0` | 只构建 | 构建 core + api，不更新 Portainer |
+| `1` | 全构建+更新 | 构建 core + api → 触发 Portainer 更新 |
+| `2` | 构建 api+更新 | 跳过 core，构建 api → 触发 Portainer 更新 |
+| `3` | 只更新 | 不构建，直接触发 Portainer 更新 |
+
+## 环境支持
+
+| 环境 | 前缀 | Jenkins Job | Portainer |
+|------|------|-------------|-----------|
+| 开发环境 | `dev` + 编号 | `dev-tengyun-core` / `dev-tengyun-yunshitang-api` | devops-dev.xnzn.net |
+| 测试环境 | `test` + 编号 | `test-tengyun-core` / `test-tengyun-yunshitang-api` | devops-test.xnzn.net |
+| dev16+ | `dev16` ~ `dev43` | 同 dev | xnzn-dev.xnzn.net（使用 forceupdateservice） |
+| dev44+ | `dev44` 及以上 | 只支持模式 0 | 需手动更新 |
+
+## 定制项目支持
+
+当指定 `api_param_folder`（定制工程文件夹名）时，Jenkins Job 路径变为：
+
+```
+{folder_name}/dev-后端-core    # 替代 dev-tengyun-core
+{folder_name}/dev-后端-api     # 替代 dev-tengyun-yunshitang-api
+```
+
+## 使用方式
+
+### 直接运行脚本
+
+```bash
+cd jenkins && python jk_build.py
+```
+
+脚本会交互式询问：
+1. **模式**（0/1/2/3）
+2. **环境**（dev1, dev2, test1 等）
+3. **core 分支**（如 release_5.56.0）
+4. **api 分支**（如 master）
+5. **定制工程文件夹**（可选，空格或 None 跳过）
+
+### 通过 Claude 辅助部署
+
+当用户说"打包到 devX"时：
+
+1. **读取** `jenkins/last_cd_env.json` 获取上次构建参数
+2. **确认参数**：环境、分支、模式、是否定制项目
+3. **修改** `last_cd_env.json` 写入新参数
+4. **执行** `cd jenkins && python jk_build.py`（脚本读取预设值，用户直接回车即可）
+
+## 配置文件说明
+
+### last_cd_env.json（构建参数）
+
+```json
+{
+  "build_mode": "0",
+  "cd_env": "dev63",
+  "core_param_branch": "release_5.56.0",
+  "api_param_branch": "master",
+  "api_param_folder": null
+}
+```
+
+| 字段 | 说明 |
+|------|------|
+| `build_mode` | 构建模式（0/1/2/3） |
+| `cd_env` | 目标环境（如 dev1, test2） |
+| `core_param_branch` | core 仓库分支 |
+| `api_param_branch` | api 仓库分支 |
+| `api_param_folder` | 定制项目文件夹（null 表示标准项目） |
+
+### env_param.json（环境连接配置）
+
+包含 Jenkins 和 Portainer 的连接参数（用户名、API Token、服务地址等），按 dev/test 环境分组。
+
+> **注意**：此文件包含敏感凭证，不要将内容输出到对话中。
+
+## 构建流程详解
+
+```
+1. 连接 Jenkins（ci.xnzn.net）
+2. 构建 core（参数：BRANCH + VERSION=环境名）
+   └─ 轮询构建进度，超时 10 分钟
+3. 构建 api（参数同上）
+   └─ 轮询构建进度，超时 5 分钟
+4. 更新 Portainer：
+   ├─ dev1~15：Webhook 触发
+   │   └─ 获取 JWT → 查 Service ID → 获取/创建 Webhook → POST 触发
+   └─ dev16+：Force Update
+       └─ 获取 JWT → 查 Service ID → PUT forceupdateservice
+```
+
+## 常见操作
+
+### 只改了 api 代码，快速部署
+
+```bash
+# 修改 last_cd_env.json 的 build_mode 为 "2"，然后运行
+cd jenkins && python jk_build.py
+```
+
+### 只需要更新容器（已在 Jenkins 手动构建完）
+
+```bash
+# build_mode 设为 "3"
+cd jenkins && python jk_build.py
+```
+
+### 部署定制项目
+
+```json
+// last_cd_env.json
+{
+  "api_param_folder": "leniu-tengyun-wuhanxieheyiyuan"
+}
+```
+
+## 首次初始化（团队成员）
+
+当用户说"初始化部署环境"或检测到 `jenkins/` 目录不存在时，执行以下步骤：
+
+### 自动初始化流程
+
+```bash
+# 1. 创建 jenkins 目录
+mkdir -p jenkins
+
+# 2. 从技能模板复制文件（SKILL_DIR 为技能目录路径）
+cp .claude/skills/jenkins-deploy/assets/jk_build.py jenkins/jk_build.py
+cp .claude/skills/jenkins-deploy/assets/last_cd_env.template.json jenkins/last_cd_env.json
+
+# 3. 环境配置需要用户提供（含敏感凭证）
+cp .claude/skills/jenkins-deploy/assets/env_param.template.json jenkins/env_param.json
+
+# 4. 安装依赖
+pip install python-jenkins requests
+```
+
+### 配置凭证
+
+初始化后，`jenkins/env_param.json` 中的占位符需要替换为真实值：
+
+| 占位符 | 说明 | 获取方式 |
+|--------|------|---------|
+| `__JENKINS_DEV_USER__` | Jenkins dev 账号 | 向团队负责人获取 |
+| `__JENKINS_DEV_TOKEN__` | Jenkins dev API Token | Jenkins → 用户 → 设置 → API Token |
+| `__JENKINS_TEST_USER__` | Jenkins test 账号 | 同上 |
+| `__JENKINS_TEST_TOKEN__` | Jenkins test API Token | 同上 |
+| `__PORTAINER_*_USER__` | Portainer 用户名 | 向团队负责人获取 |
+| `__PORTAINER_*_PWD__` | Portainer 密码 | 向团队负责人获取 |
+
+**快捷方式**：如果团队已有成员配置好，可直接拷贝对方的 `env_param.json` 文件。
+
+### AI 初始化行为
+
+当技能被触发但 `jenkins/` 不存在时：
+1. 提示用户"检测到尚未初始化部署环境"
+2. 询问是否执行初始化
+3. 执行上述复制步骤
+4. 提示用户填写凭证（或拷贝已有配置）
+
+## 依赖
+
+```bash
+pip install python-jenkins requests
+```
+
+## 注意
+
+- 本技能用于 dev/test 环境部署，**不涉及生产环境**
+- 如果是 Git 提交/分支管理，请使用 `git-workflow` 技能
+- 如果是代码构建错误排查，请使用 `bug-detective` 技能

package/.cursor/templates/env-config.md

@@ -0,0 +1,27 @@
+# 环境配置模板
+
+> 填写后运行 `npx ai-engineering-init config --from .claude/templates/env-config.md --scope global`
+> 一键初始化 MySQL 数据库连接和 Loki 日志查询配置。
+
+## MySQL 数据库连接
+
+| 环境 | host | port | user | password | range | 描述 |
+|------|------|------|------|----------|-------|------|
+| local | 127.0.0.1 | 3306 | root | do@u.can | | 本地环境 |
+| dev | YOUR_DEV_HOST | 3306 | YOUR_USER | YOUR_PASSWORD | 1~15 | 开发环境(dev1~dev15) |
+| test | YOUR_TEST_HOST | 3306 | YOUR_USER | YOUR_PASSWORD | 1~30 | 测试环境(test1~test30) |
+| prod | YOUR_PROD_HOST | 3306 | readonly | YOUR_PASSWORD | | 生产环境(只读) |
+
+默认环境: local
+
+## Loki 日志查询
+
+| 环境 | 名称 | URL | Token | 别名 | range |
+|------|------|-----|-------|------|-------|
+| test13 | 测试13 | https://test13.xnzn.net/grafana | YOUR_TOKEN | test13,13 | |
+| monitor-test | Monitor测试 | https://monitor-test.xnzn.net/grafana | YOUR_TOKEN | mtest | test1~12 |
+| monitor-dev | Monitor开发 | https://monitor-dev.xnzn.net/grafana | YOUR_TOKEN | mdev,dev | dev1~15 |
+| monitor02-dev | Monitor02开发 | https://monitor02-dev.xnzn.net/grafana | YOUR_TOKEN | m02,monitor02 | dev16~42 |
+| monitor-tyy-dev | 体验园开发 | https://monitor-tyy-dev.xnzn.net/grafana | YOUR_TOKEN | tyy,体验园 | dev44~58 |
+
+默认环境: test13

package/AGENTS.md

@@ -94,6 +94,7 @@
 | `collaborating-with-gemini` | 与 Gemini 协同设计 |
 | `codex-code-review` | 代码审查 |
 | `leniu-marketing-scenario` | 营销规则开发（折扣/满减/限额/限次/补贴/充值赠送/扣款/就餐规则） |
+| `jenkins-deploy` | 打包部署（Jenkins 构建 + Portainer 更新，dev/test 环境） |
 
 ### OpenSpec 规格驱动开发技能（SDD）
 

package/bin/index.js

@@ -55,6 +55,7 @@ let submitIssue = false; // sync-back --submit
 let configType = '';  // config --type <mysql|loki|all>
 let configScope = '';  // config --scope <local|global>
 let configAdd = false; // config --add
+let configFrom = '';   // config --from <file.md>
 
 for (let i = 0; i < args.length; i++) {
   const arg = args[i];
@@ -121,6 +122,13 @@ for (let i = 0; i < args.length; i++) {
     case '--add':
       configAdd = true;
       break;
+    case '--from':
+      if (i + 1 >= args.length || args[i + 1].startsWith('-')) {
+        console.error(fmt('red', `错误：${arg} 需要一个文件路径`));
+        process.exit(1);
+      }
+      configFrom = path.resolve(args[++i]);
+      break;
     case '--help': case '-h':
       printHelp();
       process.exit(0);
@@ -154,6 +162,7 @@ function printHelp() {
   console.log('  --type   <类型>      config 时指定配置类型: mysql | loki | all');
   console.log('  --scope  <范围>      config 时指定范围: local（当前项目） | global（全局 ~/）');
   console.log('  --add                config 时追加环境（不覆盖已有配置）');
+  console.log('  --from   <文件>      config 时从 Markdown 文件解析配置（跳过交互）');
   console.log('  --help,  -h          显示此帮助\n');
   console.log('示例:');
   console.log('  npx ai-engineering-init --tool claude');
@@ -173,6 +182,7 @@ function printHelp() {
   console.log('  npx ai-engineering-init config --type all              # 配置全部');
   console.log('  npx ai-engineering-init config --type mysql --scope global  # 全局配置（所有项目共享）');
   console.log('  npx ai-engineering-init config --type mysql --add          # 追加环境到已有配置');
+  console.log('  npx ai-engineering-init config --from env-config.md --scope global  # 从 MD 文件一键初始化');
 }
 
 // ── 工具定义（init 用）────────────────────────────────────────────────────
@@ -576,6 +586,24 @@ function showDoneHint(toolKey) {
     console.log(`  2. 在 Codex 中使用 .codex/skills/ 下的技能`);
     console.log('');
   }
+  showJenkinsHint();
+}
+
+/** 检测 jenkins/ 是否已初始化，提示用户配置部署环境 */
+function showJenkinsHint() {
+  const jenkinsDir = path.join(targetDir, 'jenkins');
+  const envParamFile = path.join(jenkinsDir, 'env_param.json');
+  const skillAssetsDir = path.join(targetDir, '.claude', 'skills', 'jenkins-deploy', 'assets');
+
+  // 技能 assets 存在但 jenkins/ 未初始化
+  if (fs.existsSync(skillAssetsDir) && !fs.existsSync(envParamFile)) {
+    console.log(fmt('yellow', fmt('bold', '📦 Jenkins 部署环境未初始化')));
+    console.log(`  项目包含 ${fmt('bold', 'jenkins-deploy')} 技能，但 jenkins/ 目录尚未配置。`);
+    console.log(`  初始化方式：`);
+    console.log(`    方式 1：在 AI 对话中说 ${fmt('bold', '"初始化部署环境"')}`);
+    console.log(`    方式 2：从团队成员处拷贝 ${fmt('bold', 'jenkins/')} 目录`);
+    console.log('');
+  }
 }
 
 function run(selectedTool) {
@@ -738,6 +766,7 @@ function runUpdate(selectedTool) {
     console.log(`  强制更新保留文件: ${fmt('bold', hintCmd('update --force'))}`);
   }
   console.log('');
+  showJenkinsHint();
 
   if (totalFailed > 0) process.exitCode = 1;
 }
@@ -1151,8 +1180,14 @@ function runSyncBack(selectedTool, selectedSkill, doSubmit) {
 // ── 环境配置初始化（MySQL / Loki）─────────────────────────────────────────
 
 function runConfig() {
+  // --from 模式：从 MD 文件解析配置（非交互式）
+  if (configFrom) {
+    runConfigFromFile(configFrom, configScope || 'global');
+    return;
+  }
+
   if (!process.stdin.isTTY) {
-    console.error(fmt('red', '错误：config 命令需要交互式终端'));
+    console.error(fmt('red', '错误：config 命令需要交互式终端（或使用 --from <file> 跳过交互）'));
     process.exit(1);
   }
 
@@ -1571,6 +1606,224 @@ function writeLokiConfig(config, configPath, isGlobal) {
   console.log(fmt('green', 'Loki 日志查询配置完成！'));
 }
 
+// ── 从 Markdown 文件解析配置（非交互式）──────────────────────────────────────
+
+function runConfigFromFile(filePath, scope) {
+  if (!fs.existsSync(filePath)) {
+    console.error(fmt('red', `错误：文件不存在 "${filePath}"`));
+    process.exit(1);
+  }
+
+  const content = fs.readFileSync(filePath, 'utf-8');
+  const isGlobal = scope === 'global';
+
+  console.log(fmt('blue', fmt('bold', `从 Markdown 文件解析配置：${filePath}`)));
+  console.log(fmt('magenta', `配置范围：${isGlobal ? '全局（~/.claude/）' : '本地（当前项目）'}`));
+  console.log('');
+
+  // 解析 MySQL 表格
+  const mysqlConfig = parseMysqlFromMd(content);
+  if (mysqlConfig) {
+    const mysqlPath = isGlobal
+      ? path.join(HOME_DIR, '.claude', 'mysql-config.json')
+      : path.join(targetDir, '.claude', 'mysql-config.json');
+
+    const configJson = JSON.stringify(mysqlConfig, null, 2) + '\n';
+    const dir = path.dirname(mysqlPath);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(mysqlPath, configJson, 'utf-8');
+    console.log(`  ${fmt('green', '✔')} MySQL 配置（${Object.keys(mysqlConfig.environments).length} 个环境）→ ${mysqlPath}`);
+
+    // 全局同步到 cursor
+    if (isGlobal && fs.existsSync(path.join(HOME_DIR, '.cursor'))) {
+      const cursorPath = path.join(HOME_DIR, '.cursor', 'mysql-config.json');
+      fs.writeFileSync(cursorPath, configJson, 'utf-8');
+      console.log(`  ${fmt('green', '✔')} 已同步 → ${cursorPath}`);
+    }
+  }
+
+  // 解析 Loki 表格
+  const lokiConfig = parseLokiFromMd(content);
+  if (lokiConfig) {
+    const lokiPath = isGlobal
+      ? path.join(HOME_DIR, '.claude', 'loki-config.json')
+      : path.join(targetDir, '.claude', 'loki-config.json');
+
+    const configJson = JSON.stringify(lokiConfig, null, 2) + '\n';
+    const dir = path.dirname(lokiPath);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(lokiPath, configJson, 'utf-8');
+    console.log(`  ${fmt('green', '✔')} Loki 配置（${Object.keys(lokiConfig.environments).length} 个环境）→ ${lokiPath}`);
+
+    if (isGlobal && fs.existsSync(path.join(HOME_DIR, '.cursor'))) {
+      const cursorPath = path.join(HOME_DIR, '.cursor', 'loki-config.json');
+      fs.writeFileSync(cursorPath, configJson, 'utf-8');
+      console.log(`  ${fmt('green', '✔')} 已同步 → ${cursorPath}`);
+    }
+  }
+
+  if (!mysqlConfig && !lokiConfig) {
+    console.error(fmt('red', '未在文件中找到 MySQL 或 Loki 配置表格。'));
+    console.log('');
+    console.log('期望格式（MySQL）：');
+    console.log('  | 环境 | host | port | user | password | range | 描述 |');
+    console.log('');
+    console.log('期望格式（Loki）：');
+    console.log('  | 环境 | 名称 | URL | Token | 别名 | range |');
+    process.exit(1);
+  }
+
+  if (!isGlobal) ensureGitignore(['mysql-config.json', 'loki-config.json']);
+
+  console.log('');
+  console.log(fmt('green', fmt('bold', '配置初始化完成！')));
+  if (isGlobal) {
+    console.log(fmt('cyan', '技能按 本地(.claude/) → 全局(~/.claude/) 顺序查找，本地优先。'));
+  }
+}
+
+/** 从 Markdown 内容中解析 MySQL 配置表格 */
+function parseMysqlFromMd(content) {
+  // 找到 "MySQL" 标题后的表格
+  const mysqlSection = extractSection(content, /mysql|数据库/i);
+  if (!mysqlSection) return null;
+
+  const rows = parseTable(mysqlSection);
+  if (rows.length === 0) return null;
+
+  const environments = {};
+  for (const row of rows) {
+    const env = row['环境'] || row['env'] || '';
+    if (!env) continue;
+
+    const host = row['host'] || '';
+    const port = parseInt(row['port'] || '3306', 10);
+    const user = row['user'] || '';
+    const password = row['password'] || '';
+    const range = row['range'] || '';
+    const desc = row['描述'] || row['desc'] || `${env}环境`;
+
+    if (!host || host.startsWith('YOUR_')) continue; // 跳过未填写的占位符
+
+    environments[env] = { host, port, user, password, _desc: desc };
+    if (range) environments[env].range = range;
+  }
+
+  if (Object.keys(environments).length === 0) return null;
+
+  // 提取默认环境
+  const defaultMatch = mysqlSection.match(/默认环境[:：]\s*(\S+)/);
+  const defaultEnv = defaultMatch ? defaultMatch[1] : Object.keys(environments)[0];
+
+  return {
+    environments,
+    default: defaultEnv,
+    _comment: '从 Markdown 文件解析生成。支持 range 字段，查找顺序：本地 > 全局 ~/.claude/',
+  };
+}
+
+/** 从 Markdown 内容中解析 Loki 配置表格 */
+function parseLokiFromMd(content) {
+  const lokiSection = extractSection(content, /loki|日志/i);
+  if (!lokiSection) return null;
+
+  const rows = parseTable(lokiSection);
+  if (rows.length === 0) return null;
+
+  const environments = {};
+  for (const row of rows) {
+    const env = row['环境'] || row['env'] || '';
+    if (!env) continue;
+
+    const name = row['名称'] || row['name'] || env;
+    const url = row['url'] || row['URL'] || '';
+    const token = row['token'] || row['Token'] || '';
+    const aliasStr = row['别名'] || row['aliases'] || env;
+    const aliases = aliasStr.split(',').map(s => s.trim()).filter(Boolean);
+    const rangeStr = row['range'] || '';
+
+    if (!url || url.startsWith('YOUR_')) continue;
+
+    const envData = { name, url, token: token.startsWith('YOUR_') ? '' : token, aliases };
+    if (rangeStr) {
+      envData.range = rangeStr;
+      envData.projects = expandRange(rangeStr);
+    } else {
+      envData.projects = [];
+    }
+
+    environments[env] = envData;
+  }
+
+  if (Object.keys(environments).length === 0) return null;
+
+  const defaultMatch = lokiSection.match(/默认环境[:：]\s*(\S+)/);
+  const activeEnv = defaultMatch ? defaultMatch[1] : Object.keys(environments)[0];
+
+  return {
+    _comment: '从 Markdown 文件解析生成。支持 range 字段，查找顺序：本地 > 全局 ~/.claude/',
+    _setup: 'Token：Grafana → Administration → Service accounts → Add（Viewer）→ Add token',
+    active: activeEnv,
+    environments,
+  };
+}
+
+/** 从 Markdown 中按标题提取段落 */
+function extractSection(content, titlePattern) {
+  const lines = content.split('\n');
+  let start = -1;
+  let end = lines.length;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (line.match(/^#+\s/) && titlePattern.test(line)) {
+      start = i;
+      const level = line.match(/^(#+)/)[1].length;
+      // 找到同级或更高级标题作为结束
+      for (let j = i + 1; j < lines.length; j++) {
+        const nextMatch = lines[j].match(/^(#+)\s/);
+        if (nextMatch && nextMatch[1].length <= level) {
+          end = j;
+          break;
+        }
+      }
+      break;
+    }
+  }
+  if (start === -1) return null;
+  return lines.slice(start, end).join('\n');
+}
+
+/** 解析 Markdown 表格为对象数组 */
+function parseTable(text) {
+  const lines = text.split('\n');
+  let headerLine = -1;
+
+  // 找到表头行（含 | 的行，下一行是分隔线 |---|）
+  for (let i = 0; i < lines.length - 1; i++) {
+    if (lines[i].includes('|') && lines[i + 1] && lines[i + 1].match(/^\|[\s-:|]+\|$/)) {
+      headerLine = i;
+      break;
+    }
+  }
+  if (headerLine === -1) return [];
+
+  const parseRow = (line) => line.split('|').map(s => s.trim()).filter(Boolean);
+  const headers = parseRow(lines[headerLine]);
+  const rows = [];
+
+  for (let i = headerLine + 2; i < lines.length; i++) {
+    const line = lines[i];
+    if (!line.includes('|')) break;
+    const cells = parseRow(line);
+    if (cells.length === 0) break;
+    const row = {};
+    headers.forEach((h, idx) => { row[h] = cells[idx] || ''; });
+    rows.push(row);
+  }
+
+  return rows;
+}
+
 // ── Config 工具函数 ─────────────────────────────────────────────────────────
 
 function getLokiConfigPath() {

package/package.json

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