npm - ai-engineering-init - Versions diffs - 1.17.1 → 1.17.2 - Mend

ai-engineering-init 1.17.1 → 1.17.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/.claude/skills/jenkins-deploy/SKILL.md +53 -126
package/.claude/skills/jenkins-deploy/assets/jk_build.py +58 -20
package/.codex/skills/jenkins-deploy/SKILL.md +53 -126
package/.cursor/skills/jenkins-deploy/SKILL.md +53 -126
package/bin/index.js +16 -10
package/package.json +1 -1
package/.claude/skills/jenkins-deploy/assets/last_cd_env.template.json +0 -7

package/.claude/skills/jenkins-deploy/SKILL.md CHANGED Viewed

@@ -15,21 +15,20 @@ description: |
 # Jenkins + Portainer 自动打包部署
-## 概述
+## 架构
-项目使用 `jenkins/` 目录下的 Python 脚本实现自动化构建部署，流程：
-```
-Jenkins 构建 core → Jenkins 构建 api → Portainer 更新容器
 ```
+技能目录（随框架更新，不复制到项目）:
+  ~/.claude/skills/jenkins-deploy/assets/jk_build.py     ← 构建脚本
+全局配置（一次性配置，所有项目共享）:
+  ~/.claude/jenkins-config.json                           ← 凭证（Jenkins/Portainer）
-## 文件位置
+项目本地（自动生成）:
+  jenkins/last_cd_env.json                                ← 构建状态（环境、分支、模式）
+```
-| 文件 | 作用 |
-|------|------|
-| `jenkins/jk_build.py` | 主构建脚本 |
-| `jenkins/env_param.json` | 环境配置（Jenkins/Portainer 连接参数） |
-| `jenkins/last_cd_env.json` | 上次构建参数（自动保存） |
+脚本按 **本地 `.claude/` > 全局 `~/.claude/`** 优先级查找 `jenkins-config.json`。
 ## 构建模式
@@ -42,156 +41,84 @@ Jenkins 构建 core → Jenkins 构建 api → 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
-```
+| 环境 | 前缀 | Portainer 更新方式 |
+|------|------|-------------------|
+| dev1~15 | `dev` | Webhook 触发 |
+| dev16~43 | `dev` | Force Update（xnzn-dev.xnzn.net） |
+| dev44+ | `dev` | 只支持模式 0（手动更新） |
+| test | `test` | Webhook 触发 |
 ## 使用方式
-### 直接运行脚本
+### 运行构建脚本
 ```bash
-cd jenkins && python jk_build.py
+python ~/.claude/skills/jenkins-deploy/assets/jk_build.py
 ```
-脚本会交互式询问：
-1. **模式**（0/1/2/3）
-2. **环境**（dev1, dev2, test1 等）
-3. **core 分支**（如 release_5.56.0）
-4. **api 分支**（如 master）
-5. **定制工程文件夹**（可选，空格或 None 跳过）
+脚本交互式询问：模式 → 环境 → core 分支 → api 分支 → 定制工程文件夹
-### 通过 Claude 辅助部署
+### 通过 AI 辅助部署
 当用户说"打包到 devX"时：
-1. **读取** `jenkins/last_cd_env.json` 获取上次构建参数
-2. **确认参数**：环境、分支、模式、是否定制项目
-3. **修改** `last_cd_env.json` 写入新参数
-4. **执行** `cd jenkins && python jk_build.py`（脚本读取预设值，用户直接回车即可）
+1. 读取 `jenkins/last_cd_env.json` 获取上次参数
+2. 确认参数：环境、分支、模式
+3. 修改 `jenkins/last_cd_env.json` 写入新参数
+4. 执行 `python ~/.claude/skills/jenkins-deploy/assets/jk_build.py`
-## 配置文件说明
+## 配置文件
-### last_cd_env.json（构建参数）
+### jenkins-config.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 表示标准项目） |
+位置：`~/.claude/jenkins-config.json`（或本地 `.claude/jenkins-config.json`）
-### env_param.json（环境连接配置）
-包含 Jenkins 和 Portainer 的连接参数（用户名、API Token、服务地址等），按 dev/test 环境分组。
+模板：`.claude/skills/jenkins-deploy/assets/env_param.template.json`
 > **注意**：此文件包含敏感凭证，不要将内容输出到对话中。
-## 构建流程详解
-```
-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
-```
-## 常见操作
+### last_cd_env.json（构建状态，项目本地）
-### 只改了 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
-```
-### 部署定制项目
+位置：`jenkins/last_cd_env.json`（脚本自动创建，无需手动初始化）
 ```json
-// last_cd_env.json
 {
-  "api_param_folder": "leniu-tengyun-wuhanxieheyiyuan"
+  "build_mode": "1",
+  "cd_env": "dev1",
+  "core_param_branch": "master",
+  "api_param_branch": "master",
+  "api_param_folder": null
 }
 ```
-## 首次初始化（团队成员）
+## 定制项目
-当用户说"初始化部署环境"或检测到 `jenkins/` 目录不存在时，执行以下步骤：
+指定 `api_param_folder` 后，Jenkins Job 路径变为：
-### 自动初始化流程
-```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
+```
+{folder_name}/dev-后端-core
+{folder_name}/dev-后端-api
 ```
-### 配置凭证
+## 首次初始化（团队成员）
-初始化后，`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 密码 | 向团队负责人获取 |
+```bash
+# 方式 1：从团队成员拷贝
+cp /path/to/teammate/jenkins-config.json ~/.claude/jenkins-config.json
-**快捷方式**：如果团队已有成员配置好，可直接拷贝对方的 `env_param.json` 文件。
+# 方式 2：从模板创建，手动填写凭证
+cp ~/.claude/skills/jenkins-deploy/assets/env_param.template.json ~/.claude/jenkins-config.json
+# 然后替换 __JENKINS_*__ 和 __PORTAINER_*__ 占位符
+```
 ### AI 初始化行为
-当技能被触发但 `jenkins/` 不存在时：
-1. 提示用户"检测到尚未初始化部署环境"
-2. 询问是否执行初始化
-3. 执行上述复制步骤
+当技能被触发但 `jenkins-config.json` 不存在时：
+1. 提示"检测到尚未配置 Jenkins 凭证"
+2. 询问是否从模板创建
+3. 复制模板到 `~/.claude/jenkins-config.json`
 4. 提示用户填写凭证（或拷贝已有配置）
 ## 依赖

package/.claude/skills/jenkins-deploy/assets/jk_build.py CHANGED Viewed

@@ -2,6 +2,7 @@
 import html
 import json
 import os
+import sys
 import time
 import jenkins
@@ -24,6 +25,32 @@ jenkins_api_token = ''
 core_job = ''
 api_job = ''
+# ~~~~~~~~~~~~~~~~~ 配置文件查找 ~~~~~~~~~~~~~~~~~~~~~~~~
+def find_config_file(filename, search_paths):
+    """按优先级查找配置文件：本地 > 全局"""
+    for p in search_paths:
+        filepath = os.path.join(p, filename)
+        if os.path.exists(filepath):
+            return filepath
+    return None
+# 配置文件搜索路径
+project_dir = os.getcwd()
+home_claude_dir = os.path.join(os.path.expanduser('~'), '.claude')
+# jenkins-config.json 搜索路径：项目本地 .claude/ > 全局 ~/.claude/
+config_search_paths = [
+    os.path.join(project_dir, '.claude'),
+    home_claude_dir,
+]
+# last_cd_env.json 搜索路径：项目本地 jenkins/
+state_dir = os.path.join(project_dir, 'jenkins')
 # 执行job方法，通过等待时间来判断是否构建成功
 def do_job_by_time(server, job_name, param_branch, param_env, wait_time):
     queue_num = server.build_job(name=job_name,
@@ -134,8 +161,6 @@ def get_server_id(token):
         "Authorization": f"Bearer {token}",
         "Content-Type": "application/json"
     }
-    # Get list of services
-    # services_response = requests.get(portainer_api_url + "/endpoints/1/docker/services", headers=headers) // dev改成了2
     url = portainer_api_url + f'/endpoints/{portainer_endpoints}/docker/services'
     services_response = requests.get(url, headers=headers)
     services = services_response.json()
@@ -162,8 +187,6 @@ def get_service_web_hook():
         "Content-Type": "application/json"
     }
-    # 查询service的webhook
-    # url = portainer_api_url + f'/webhooks?filters=%7B%22ResourceID%22:%22{service_id}%22,%22EndpointID%22:1%7D' // dev改成了2
     url = portainer_api_url + f'/webhooks?filters=%7B%22ResourceID%22:%22{service_id}%22,%22EndpointID%22:{portainer_endpoints}%7D'
     services_response = requests.get(url, headers=headers)
     webhook_json = services_response.json()
@@ -226,11 +249,33 @@ print('\n~~~~~~~~~~~~~~')
 print('正在使用jenkins+portainer构建工具，目前支持dev和test环境的自动化构建+更新')
 print('~~~~~~~~~~~~~~\n')
-# 获取当前目录
-current_dir = os.getcwd()
-# 读取上一次构建的环境
-with open(current_dir + '/last_cd_env.json', 'r', encoding='utf-8') as f:
-    cd_env_json = json.load(f)
+# 查找环境配置文件（jenkins-config.json）
+config_file = find_config_file('jenkins-config.json', config_search_paths)
+if config_file is None:
+    print('❌ 未找到 jenkins-config.json')
+    print(f'  请将配置文件放到以下任一位置：')
+    for p in config_search_paths:
+        print(f'    - {os.path.join(p, "jenkins-config.json")}')
+    print(f'\n  或运行: npx ai-engineering-init config --type jenkins')
+    exit(1)
+print(f'配置文件: {config_file}')
+# 确保构建状态目录存在
+os.makedirs(state_dir, exist_ok=True)
+state_file = os.path.join(state_dir, 'last_cd_env.json')
+# 读取上一次构建的环境（如果不存在则使用默认值）
+if os.path.exists(state_file):
+    with open(state_file, 'r', encoding='utf-8') as f:
+        cd_env_json = json.load(f)
+else:
+    cd_env_json = {
+        "build_mode": "1",
+        "cd_env": "dev1",
+        "core_param_branch": "master",
+        "api_param_branch": "master",
+        "api_param_folder": None
+    }
 # 从终端获取用户输入模式
 build_mode = input(f"请输入模式 0-只构建 1-全构建+更新 2-构建api+更新 3-只更新（预设{cd_env_json['build_mode']}）：", ) or cd_env_json['build_mode']
@@ -245,7 +290,6 @@ core_param_branch = input(f"请输入core分支（预设：{cd_env_json['core_pa
 api_param_branch = input(f"请输入api分支（预设：{cd_env_json['api_param_branch']}）:") or cd_env_json['api_param_branch']
 # 从终端输入api文件夹名
-# 读取上一次构建的分支
 api_param_folder = input(f"请输入定制工程文件夹名（空格或None表示不需要，预设：{cd_env_json['api_param_folder']}）:") or cd_env_json['api_param_folder']
 # 校验模式：
@@ -270,21 +314,19 @@ if cd_env.startswith('dev') and int(cd_env[3:]) >= 44 and build_mode != '0':
     print("dev43及以上环境只能使用模式0，结束")
     exit(1)
-# 保存到本地环境
+# 保存到本地状态文件
 cd_env_json['cd_env'] = cd_env
 cd_env_json['core_param_branch'] = core_param_branch
 cd_env_json['api_param_branch'] = api_param_branch
 cd_env_json['api_param_folder'] = api_param_folder
 cd_env_json['build_mode'] = build_mode
-json.dump(cd_env_json, open(current_dir + '/last_cd_env.json', 'w', encoding='utf-8'), ensure_ascii=False)
-# exit(0)
+json.dump(cd_env_json, open(state_file, 'w', encoding='utf-8'), ensure_ascii=False)
 # 根据环境输入，设置前缀
 env_prefix = 'dev' if cd_env.startswith('dev') else 'test'
-# 读取上一次构建的环境
-with open(current_dir + '/env_param.json', 'r', encoding='utf-8') as f:
+# 读取环境配置（从全局或本地 jenkins-config.json）
+with open(config_file, 'r', encoding='utf-8') as f:
     env_param = json.load(f)
 jenkins_user_id = env_param['jenkins_user_id'][env_prefix]
@@ -331,10 +373,6 @@ if int(build_mode) < 2:
 if int(build_mode) < 3:
     print('开始构建api：' + api_job + ' ' + time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()))
     rs = do_job(j_server, api_job, api_param_branch, cd_env, api_timeout)
-    # 如果构建api失败，再次构建
-    # if rs is False:
-    #     print('第一次构建api失败，再次构建')
-    #     rs = do_job_1(j_server, api_job, api_param_branch, cd_env, api_timeout)
     if rs is False:
         print('构建api失败，结束')
         exit(1)

package/.codex/skills/jenkins-deploy/SKILL.md CHANGED Viewed

@@ -15,21 +15,20 @@ description: |
 # Jenkins + Portainer 自动打包部署
-## 概述
+## 架构
-项目使用 `jenkins/` 目录下的 Python 脚本实现自动化构建部署，流程：
-```
-Jenkins 构建 core → Jenkins 构建 api → Portainer 更新容器
 ```
+技能目录（随框架更新，不复制到项目）:
+  ~/.claude/skills/jenkins-deploy/assets/jk_build.py     ← 构建脚本
+全局配置（一次性配置，所有项目共享）:
+  ~/.claude/jenkins-config.json                           ← 凭证（Jenkins/Portainer）
-## 文件位置
+项目本地（自动生成）:
+  jenkins/last_cd_env.json                                ← 构建状态（环境、分支、模式）
+```
-| 文件 | 作用 |
-|------|------|
-| `jenkins/jk_build.py` | 主构建脚本 |
-| `jenkins/env_param.json` | 环境配置（Jenkins/Portainer 连接参数） |
-| `jenkins/last_cd_env.json` | 上次构建参数（自动保存） |
+脚本按 **本地 `.claude/` > 全局 `~/.claude/`** 优先级查找 `jenkins-config.json`。
 ## 构建模式
@@ -42,156 +41,84 @@ Jenkins 构建 core → Jenkins 构建 api → 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
-```
+| 环境 | 前缀 | Portainer 更新方式 |
+|------|------|-------------------|
+| dev1~15 | `dev` | Webhook 触发 |
+| dev16~43 | `dev` | Force Update（xnzn-dev.xnzn.net） |
+| dev44+ | `dev` | 只支持模式 0（手动更新） |
+| test | `test` | Webhook 触发 |
 ## 使用方式
-### 直接运行脚本
+### 运行构建脚本
 ```bash
-cd jenkins && python jk_build.py
+python ~/.claude/skills/jenkins-deploy/assets/jk_build.py
 ```
-脚本会交互式询问：
-1. **模式**（0/1/2/3）
-2. **环境**（dev1, dev2, test1 等）
-3. **core 分支**（如 release_5.56.0）
-4. **api 分支**（如 master）
-5. **定制工程文件夹**（可选，空格或 None 跳过）
+脚本交互式询问：模式 → 环境 → core 分支 → api 分支 → 定制工程文件夹
-### 通过 Claude 辅助部署
+### 通过 AI 辅助部署
 当用户说"打包到 devX"时：
-1. **读取** `jenkins/last_cd_env.json` 获取上次构建参数
-2. **确认参数**：环境、分支、模式、是否定制项目
-3. **修改** `last_cd_env.json` 写入新参数
-4. **执行** `cd jenkins && python jk_build.py`（脚本读取预设值，用户直接回车即可）
+1. 读取 `jenkins/last_cd_env.json` 获取上次参数
+2. 确认参数：环境、分支、模式
+3. 修改 `jenkins/last_cd_env.json` 写入新参数
+4. 执行 `python ~/.claude/skills/jenkins-deploy/assets/jk_build.py`
-## 配置文件说明
+## 配置文件
-### last_cd_env.json（构建参数）
+### jenkins-config.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 表示标准项目） |
+位置：`~/.claude/jenkins-config.json`（或本地 `.claude/jenkins-config.json`）
-### env_param.json（环境连接配置）
-包含 Jenkins 和 Portainer 的连接参数（用户名、API Token、服务地址等），按 dev/test 环境分组。
+模板：`.claude/skills/jenkins-deploy/assets/env_param.template.json`
 > **注意**：此文件包含敏感凭证，不要将内容输出到对话中。
-## 构建流程详解
-```
-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
-```
-## 常见操作
+### last_cd_env.json（构建状态，项目本地）
-### 只改了 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
-```
-### 部署定制项目
+位置：`jenkins/last_cd_env.json`（脚本自动创建，无需手动初始化）
 ```json
-// last_cd_env.json
 {
-  "api_param_folder": "leniu-tengyun-wuhanxieheyiyuan"
+  "build_mode": "1",
+  "cd_env": "dev1",
+  "core_param_branch": "master",
+  "api_param_branch": "master",
+  "api_param_folder": null
 }
 ```
-## 首次初始化（团队成员）
+## 定制项目
-当用户说"初始化部署环境"或检测到 `jenkins/` 目录不存在时，执行以下步骤：
+指定 `api_param_folder` 后，Jenkins Job 路径变为：
-### 自动初始化流程
-```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
+```
+{folder_name}/dev-后端-core
+{folder_name}/dev-后端-api
 ```
-### 配置凭证
+## 首次初始化（团队成员）
-初始化后，`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 密码 | 向团队负责人获取 |
+```bash
+# 方式 1：从团队成员拷贝
+cp /path/to/teammate/jenkins-config.json ~/.claude/jenkins-config.json
-**快捷方式**：如果团队已有成员配置好，可直接拷贝对方的 `env_param.json` 文件。
+# 方式 2：从模板创建，手动填写凭证
+cp ~/.claude/skills/jenkins-deploy/assets/env_param.template.json ~/.claude/jenkins-config.json
+# 然后替换 __JENKINS_*__ 和 __PORTAINER_*__ 占位符
+```
 ### AI 初始化行为
-当技能被触发但 `jenkins/` 不存在时：
-1. 提示用户"检测到尚未初始化部署环境"
-2. 询问是否执行初始化
-3. 执行上述复制步骤
+当技能被触发但 `jenkins-config.json` 不存在时：
+1. 提示"检测到尚未配置 Jenkins 凭证"
+2. 询问是否从模板创建
+3. 复制模板到 `~/.claude/jenkins-config.json`
 4. 提示用户填写凭证（或拷贝已有配置）
 ## 依赖

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

@@ -15,21 +15,20 @@ description: |
 # Jenkins + Portainer 自动打包部署
-## 概述
+## 架构
-项目使用 `jenkins/` 目录下的 Python 脚本实现自动化构建部署，流程：
-```
-Jenkins 构建 core → Jenkins 构建 api → Portainer 更新容器
 ```
+技能目录（随框架更新，不复制到项目）:
+  ~/.claude/skills/jenkins-deploy/assets/jk_build.py     ← 构建脚本
+全局配置（一次性配置，所有项目共享）:
+  ~/.claude/jenkins-config.json                           ← 凭证（Jenkins/Portainer）
-## 文件位置
+项目本地（自动生成）:
+  jenkins/last_cd_env.json                                ← 构建状态（环境、分支、模式）
+```
-| 文件 | 作用 |
-|------|------|
-| `jenkins/jk_build.py` | 主构建脚本 |
-| `jenkins/env_param.json` | 环境配置（Jenkins/Portainer 连接参数） |
-| `jenkins/last_cd_env.json` | 上次构建参数（自动保存） |
+脚本按 **本地 `.claude/` > 全局 `~/.claude/`** 优先级查找 `jenkins-config.json`。
 ## 构建模式
@@ -42,156 +41,84 @@ Jenkins 构建 core → Jenkins 构建 api → 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
-```
+| 环境 | 前缀 | Portainer 更新方式 |
+|------|------|-------------------|
+| dev1~15 | `dev` | Webhook 触发 |
+| dev16~43 | `dev` | Force Update（xnzn-dev.xnzn.net） |
+| dev44+ | `dev` | 只支持模式 0（手动更新） |
+| test | `test` | Webhook 触发 |
 ## 使用方式
-### 直接运行脚本
+### 运行构建脚本
 ```bash
-cd jenkins && python jk_build.py
+python ~/.claude/skills/jenkins-deploy/assets/jk_build.py
 ```
-脚本会交互式询问：
-1. **模式**（0/1/2/3）
-2. **环境**（dev1, dev2, test1 等）
-3. **core 分支**（如 release_5.56.0）
-4. **api 分支**（如 master）
-5. **定制工程文件夹**（可选，空格或 None 跳过）
+脚本交互式询问：模式 → 环境 → core 分支 → api 分支 → 定制工程文件夹
-### 通过 Claude 辅助部署
+### 通过 AI 辅助部署
 当用户说"打包到 devX"时：
-1. **读取** `jenkins/last_cd_env.json` 获取上次构建参数
-2. **确认参数**：环境、分支、模式、是否定制项目
-3. **修改** `last_cd_env.json` 写入新参数
-4. **执行** `cd jenkins && python jk_build.py`（脚本读取预设值，用户直接回车即可）
+1. 读取 `jenkins/last_cd_env.json` 获取上次参数
+2. 确认参数：环境、分支、模式
+3. 修改 `jenkins/last_cd_env.json` 写入新参数
+4. 执行 `python ~/.claude/skills/jenkins-deploy/assets/jk_build.py`
-## 配置文件说明
+## 配置文件
-### last_cd_env.json（构建参数）
+### jenkins-config.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 表示标准项目） |
+位置：`~/.claude/jenkins-config.json`（或本地 `.claude/jenkins-config.json`）
-### env_param.json（环境连接配置）
-包含 Jenkins 和 Portainer 的连接参数（用户名、API Token、服务地址等），按 dev/test 环境分组。
+模板：`.claude/skills/jenkins-deploy/assets/env_param.template.json`
 > **注意**：此文件包含敏感凭证，不要将内容输出到对话中。
-## 构建流程详解
-```
-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
-```
-## 常见操作
+### last_cd_env.json（构建状态，项目本地）
-### 只改了 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
-```
-### 部署定制项目
+位置：`jenkins/last_cd_env.json`（脚本自动创建，无需手动初始化）
 ```json
-// last_cd_env.json
 {
-  "api_param_folder": "leniu-tengyun-wuhanxieheyiyuan"
+  "build_mode": "1",
+  "cd_env": "dev1",
+  "core_param_branch": "master",
+  "api_param_branch": "master",
+  "api_param_folder": null
 }
 ```
-## 首次初始化（团队成员）
+## 定制项目
-当用户说"初始化部署环境"或检测到 `jenkins/` 目录不存在时，执行以下步骤：
+指定 `api_param_folder` 后，Jenkins Job 路径变为：
-### 自动初始化流程
-```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
+```
+{folder_name}/dev-后端-core
+{folder_name}/dev-后端-api
 ```
-### 配置凭证
+## 首次初始化（团队成员）
-初始化后，`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 密码 | 向团队负责人获取 |
+```bash
+# 方式 1：从团队成员拷贝
+cp /path/to/teammate/jenkins-config.json ~/.claude/jenkins-config.json
-**快捷方式**：如果团队已有成员配置好，可直接拷贝对方的 `env_param.json` 文件。
+# 方式 2：从模板创建，手动填写凭证
+cp ~/.claude/skills/jenkins-deploy/assets/env_param.template.json ~/.claude/jenkins-config.json
+# 然后替换 __JENKINS_*__ 和 __PORTAINER_*__ 占位符
+```
 ### AI 初始化行为
-当技能被触发但 `jenkins/` 不存在时：
-1. 提示用户"检测到尚未初始化部署环境"
-2. 询问是否执行初始化
-3. 执行上述复制步骤
+当技能被触发但 `jenkins-config.json` 不存在时：
+1. 提示"检测到尚未配置 Jenkins 凭证"
+2. 询问是否从模板创建
+3. 复制模板到 `~/.claude/jenkins-config.json`
 4. 提示用户填写凭证（或拷贝已有配置）
 ## 依赖

package/bin/index.js CHANGED Viewed

@@ -591,17 +591,23 @@ function showDoneHint(toolKey) {
 /** 检测 jenkins/ 是否已初始化，提示用户配置部署环境 */
 function showJenkinsHint() {
-  const jenkinsDir = path.join(targetDir, 'jenkins');
-  const envParamFile = path.join(jenkinsDir, 'env_param.json');
+  const homeClaudeDir = path.join(os.homedir(), '.claude');
+  const globalConfig = path.join(homeClaudeDir, 'jenkins-config.json');
+  const localConfig = path.join(targetDir, '.claude', 'jenkins-config.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/')} 目录`);
+  // 全局安装时也检查全局技能目录
+  const globalSkillDir = path.join(homeClaudeDir, 'skills', 'jenkins-deploy', 'assets');
+  const hasSkill = fs.existsSync(skillAssetsDir) || fs.existsSync(globalSkillDir);
+  const hasConfig = fs.existsSync(globalConfig) || fs.existsSync(localConfig);
+  // 技能存在但凭证未配置
+  if (hasSkill && !hasConfig) {
+    console.log(fmt('yellow', fmt('bold', '📦 Jenkins 部署凭证未配置')));
+    console.log(`  已安装 ${fmt('bold', 'jenkins-deploy')} 技能，但 ${fmt('bold', 'jenkins-config.json')} 尚未配置。`);
+    console.log(`  配置方式：`);
+    console.log(`    方式 1：从团队成员处拷贝 ${fmt('bold', '~/.claude/jenkins-config.json')}`);
+    console.log(`    方式 2：在 AI 对话中说 ${fmt('bold', '"初始化部署环境"')}`);
     console.log('');
   }
 }

package/package.json CHANGED Viewed

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

package/.claude/skills/jenkins-deploy/assets/last_cd_env.template.json DELETED Viewed

@@ -1,7 +0,0 @@
-{
-  "build_mode": "1",
-  "cd_env": "dev1",
-  "core_param_branch": "master",
-  "api_param_branch": "master",
-  "api_param_folder": null
-}