@hupan56/wlkj 3.1.31 → 3.2.0

package/templates/qoder/hooks/stop-eval.py

@@ -105,6 +105,35 @@ def _recent_prd_files():
     return candidates
 
 
+# 快速模式 6 章必需标题 (与 prd-quick-template.md 对齐)
+QUICK_REQUIRED_SECTIONS = [
+    '功能入口', '需求背景', '需求说明', '影响范围', '验收标准', '不在本次范围',
+]
+
+
+def _check_quick_prd_complete(prd_path):
+    """检测 quick 模式 PRD 是否缺章。返回缺失章节列表 (空=完整)。
+
+    判定 quick 模式: @contract 头含 mode: quick。
+    必需 6 章: 功能入口/需求背景/需求说明/影响范围/验收标准/不在本次范围。
+    治"残废品" (真实案例: 海外考勤 PRD 只写"功能入口"一段, 6 章缺 5 章)。
+    """
+    try:
+        text = open(prd_path, encoding='utf-8', errors='replace').read()
+    except Exception:
+        return []  # 读不到不拦 (误拦比放过更糟)
+    # 只检 quick 模式 (完整档 13 章另算, 不在此 hook 范围)
+    if 'mode: quick' not in text[:500]:
+        return []
+    missing = []
+    for sec in QUICK_REQUIRED_SECTIONS:
+        # 章节标题: ## 功能入口 / ## 需求背景 等 (允许前后空格)
+        import re
+        if not re.search(r'^#{1,3}\s*' + sec, text, re.MULTILINE):
+            missing.append(sec)
+    return missing
+
+
 def _evald_prds():
     """读 eval-history.jsonl, 返回【已通过门禁】的 prd 文件名集合。
 
@@ -161,6 +190,24 @@ def main():
         recent = _recent_prd_files()
         if not recent:
             sys.exit(0)  # 本轮没产 PRD, 放行
+
+        # ── 先查 quick 模式 PRD 缺章 (残废品门禁, 比 eval 更优先) ──
+        incomplete = []
+        for p in recent:
+            miss = _check_quick_prd_complete(p)
+            if miss:
+                incomplete.append((p, miss))
+        if incomplete:
+            lines = []
+            for p, miss in incomplete[:3]:
+                lines.append('  %s 缺: %s' % (os.path.basename(p), '、'.join(miss)))
+            sys.stderr.write(
+                '【PRD 残废品门禁】检测到快速模式 PRD 缺章 (6 章缺一不可):\n'
+                + '\n'.join(lines) + '\n'
+                '修复: 补齐缺失章节的标题和内容 (不涉及的写一句话说明, 标题必须保留),\n'
+                '      章节顺序: 功能入口/需求背景/需求说明/影响范围/验收标准/不在本次范围。\n'
+                '      模板: .qoder/templates/prd-quick-template.md\n')
+            sys.exit(2)
         evald = _evald_prds()
         last_records = _last_record_by_prd()
         # 区分两种未过门禁: 从没跑过 eval / 跑了但没过线

package/templates/qoder/rules/wl-pipeline.md

@@ -53,6 +53,19 @@ test -f .qoder/.developer && echo "已初始化" || echo "未初始化"
 注意：用户说"同步/保存产出"通常指 team_sync（push），不是 git commit；
 用户说"提交/commit 代码"才是 wl-commit。
 
+## 规则 0.3：命令路由是最终决定（最高优先级，记忆/偏好不可覆盖）
+
+**用户明确打了 `/wl-X` → 就走 X，绝不改道。** 这一条优先级高于一切（包括"问平台"），
+任何"用户偏好""历史记忆""上下文暗示"都不可覆盖当前明确的命令。命令名 = 最终路由。
+
+- 用户打 `/wl-prd`（哪怕描述像 bug："无法提交，时间报错"）→ **必须走 PRD**（为修复写需求），**不准**跑去 `/wl-test` / `/wl-code` / 排查
+- 用户打 `/wl-code` → 走代码；`/wl-test` → 走测试；`/wl-task` → 走任务；其它命令同理
+- 判断不了路由 → **问用户一句**，不要凭"偏好/记忆"自己猜
+
+> 🚫 反面教材（禁止，真实案例）：用户打 `/wl-prd 快速，园林绿化养护计划无法提交，时间有问题报错`，
+> AI 因"记忆里用户偏好报bug走test"擅自改道 `/wl-test` → **违规**。命令是 `/wl-prd`，描述像 bug 也走 PRD
+> （`wl-prd.md` 命令优先铁律连这个例子都举了）。"偏好/记忆"绝不可覆盖用户当前明确的命令。
+
 ## 规则 0.5：数据库查询必须先问环境（安全红线，问了就停）
 
 AI 检测到需要查询**真实数据库**（调用 `mcp__qoder-mysql` 的 query_schema / query_data /
@@ -132,6 +145,30 @@ kg.py context（= context_pack）一条命令返回：相关代码文件 + 同
 > 这是工作流比原生慢的根因——原生 AI 本能地并发，工作流却被"逐步执行"的文档节奏带成了串行。
 > 把串行变并发，同样工作量耗时可砍到 1/3。MCP server（kg/mysql/zentao）都支持 JSON-RPC 并发请求。
 
+## 规则 2.6：思考链收敛——先取证再推理（治"超长思考链"）
+
+**痛点：AI 取证了（读了代码）却没抓住矛盾，在假设上连续空转，15+ 步才定位 3 步能找到的根因。**
+> ⚠️ 本规则**只约束排查/修码/取证类推理**；**探索/规划/写PRD** 类（用 feature/workflow/coverage/context 撒网理解业务）不受约束，反而要多用 kg。
+
+### 2.6.1 先取证再推理（铁律）
+每个推断必须立刻验证，**不许"假设A → 假设B → 假设C"连环空转**；验证不了就换方向。
+**一轮工具调用 = 一轮推理**，不许"无工具调用的纯思考"超过 1 轮。
+
+### 2.6.2 取证优先用知识层（kg 比 grep 快 10 倍，与规则 2 一脉相承）
+- 相关代码文件 → `context_pack` 列文件（**别** grep 全库找）
+- 字段真实类型/命名 → `query_schema` / `field_map` / `db_columns`（**别** Read 整个 Entity 翻）
+- 改动波及面 → `table_impact` / `get_impact`（**别** 手动追踪调用链）
+- API 路由/参数 → `code-api` 索引（**别** grep Controller）
+→ **kg 给了文件才 Read 那几个；kg 给了类型就不读全文。kg 用得更准，不是闲置。**
+
+### 2.6.3 排查/修码类先对齐链路（1-2 步对齐，再动手；kg 一次对齐多环）
+- **后端报错/类型异常**：`query_schema`(DB列类型) + `context_pack`(BO/Entity文件) → Read 对齐 → 找不一致点
+- **接口不通/400**：`code-api`(路由/参数) + `table_impact`(影响面)
+- **前端白屏/NaN**：`context_pack`(组件/API) + `field_map`(字段映射)
+
+> 正例：`query_schema` 得 DB列=Date + `context_pack` 得 BO=String → "类型不一致，改BO"（2步定位）
+> 反例：假设null → 假设Invalid Date → 假设时区 → 假设disabledDate → …（15步空转，养护计划实录）
+
 ## 规则 3：原型风格必须来自真源（含图标）
 
 - 起点永远是平台模板：.qoder/templates/prototype-web.html / prototype-app.html

package/templates/qoder/scripts/deployment/setup/install_qoderwork.py

@@ -537,6 +537,17 @@ def main():
                 print(f"  [SKIP] .repo-root 未更新 ({PROJECT_ROOT} 非真仓库, 缺 workspace/data/.git)")
         except OSError:
             pass
+        # 5. 复制 wlkj 薄壳 (QoderWork 桌面端任意 cwd 直跑 wlkj, 不用每次先算 R)
+        # 治"相对路径在会话临时 cwd 失效"踩坑 (真实: 连续 2 条命令报错浪费一轮)
+        shim_src = SOURCE_COMMANDS_DIR.parent / "scripts" / "deployment" / "setup" / "wlkj_shim.py"
+        shim_dst = _HOME / ".qoderwork" / "wlkj.py"
+        try:
+            if shim_src.is_file():
+                import shutil as _sh2
+                _sh2.copy2(str(shim_src), str(shim_dst))
+                print(f"  [OK]   wlkj 薄壳: {shim_dst} (任意 cwd 可跑: python ~/.qoderwork/wlkj.py ...)")
+        except OSError as e:
+            print(f"  [ERR]  wlkj 薄壳复制失败: {e}")
         return
 
     print("=" * 56)

package/templates/qoder/scripts/deployment/setup/setup.py

@@ -664,6 +664,73 @@ def offer_cron(skip=False):
             print('       跳过。以后可手动跑: bash .qoder/scripts/setup_weekly_cron.sh')
 
 
+# ============================================================
+# Step 3.6: 禅道凭据配置 (每个开发者配自己的禅道账号)
+# ============================================================
+
+def offer_zentao(name):
+    """引导禅道凭据配置。
+
+    禅道 URL 团队共享(配在 config.yaml), 但用户名/密码是个人凭据,
+    存 workspace/members/{dev}/.private/secrets/zentao.env (gitignored)。
+    不配也能用 (kg/search/PRD 不依赖禅道), 但 /wl-task 禅道同步和
+    /wl-report 禅道查询需要。
+    """
+    print('\n--- 禅道凭据 (可选, 不配也能用核心功能) ---')
+
+    # 检查 config.yaml 有没有禅道 URL
+    zentao_url = ''
+    try:
+        from foundation.core.config import load_config_section, SECTIONS
+        cfg = load_config_section(SECTIONS.ZENTAO)
+        zentao_url = (cfg.get('url') or '').strip()
+    except Exception:
+        pass
+
+    if not zentao_url:
+        print('  团队未配置禅道 URL (config.yaml 无 zentao.url)。')
+        print('  管理员配: 在 config.yaml 加 zentao.url: http://你的禅道地址')
+        print('  跳过禅道配置。配好 URL 后重跑 init 即可。')
+        return
+
+    print(f'  禅道地址: {zentao_url}')
+
+    # 检查是否已配
+    try:
+        from foundation.core.paths import get_secrets_dir
+        secrets_dir = get_secrets_dir(name)
+        env_file = os.path.join(secrets_dir, 'zentao.env')
+        if os.path.isfile(env_file):
+            ok('禅道凭据已配置 (zentao.env 存在)')
+            return
+    except Exception:
+        pass
+
+    if not ask('配置禅道账号? (用于同步任务/需求/Bug)', 'n'):
+        print('  跳过。以后需要: npx @hupan56/wlkj init <名字> <角色>')
+        return
+
+    # 交互式收集禅道凭据
+    try:
+        zentao_user = input('  禅道用户名: ').strip()
+        zentao_pwd = input('  禅道密码: ').strip()
+        if not zentao_user or not zentao_pwd:
+            warn('用户名/密码为空, 跳过')
+            return
+
+        # 写入 zentao.env
+        secrets_dir = os.path.join(os.getcwd(), 'workspace', 'members', name, '.private', 'secrets')
+        os.makedirs(secrets_dir, exist_ok=True)
+        env_file = os.path.join(secrets_dir, 'zentao.env')
+        with open(env_file, 'w', encoding='utf-8') as f:
+            f.write(f'ZENTAO_USER={zentao_user}\n')
+            f.write(f'ZENTAO_PASSWORD={zentao_pwd}\n')
+        ok(f'禅道凭据已保存: {env_file}')
+        print('  (个人凭据, 已 gitignored, 不会 push 给团队)')
+    except (EOFError, KeyboardInterrupt):
+        print('  跳过')
+
+
 # ============================================================
 # Step 4.5: 蓝湖 MCP (设计师直读蓝湖设计稿)
 # ============================================================
@@ -873,6 +940,9 @@ def main():
     # Step 3.5: 团队协作仓库 remote (workspace/ 产出 push 到这里)
     configure_team_remote()
 
+    # Step 3.6: 禅道凭据配置 (每个开发者都要配自己的禅道账号)
+    offer_zentao(name)
+
     # Step 4
     offer_cron(skip=args.skip_cron)
 

package/templates/qoder/scripts/deployment/setup/wlkj_shim.py

@@ -0,0 +1,104 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# wlkj_shim.py — QoderWork 桌面端 wlkj 薄壳 (零 import 依赖, 任意 cwd 直接跑)
+#
+# 为什么需要它:
+#   QoderWork 桌面端工作目录是临时会话目录 (workspace/xxx), 不是仓库根。
+#   命令文件里写的相对路径 .qoder/scripts/orchestration/wlkj.py 全部失效
+#   (真实踩坑: AI 连续 2 条命令报错 "can't open file", 浪费一轮, 拖慢)。
+#   本薄壳放在 ~/.qoderwork/wlkj.py, AI 只需记住一个绝对路径:
+#       python ~/.qoderwork/wlkj.py <命令> [参数...]
+#   即可在任意 cwd 跑通工作流, 不用每次先算 R=repo_root。
+#
+# 机制 (与 repo_root.py 一致): 从 ~/.qoderwork/mcp.json 的 kg_mcp_server.py
+# 绝对路径反推仓库根 (换机器重装后 mcp.json 会更新, 无需硬编码)。然后 subprocess
+# 调真正的 wlkj.py, 透传全部 argv 和 exit code。
+#
+# 零依赖: 不能 import 仓库内任何模块 (定位器不能依赖被定位的东西)。
+#
+# 安装: install_qoderwork.py 会把本文件复制到 ~/.qoderwork/wlkj.py。
+"""
+wlkj_shim.py — QoderWork 桌面端 wlkj 薄壳。
+
+用法:
+    python ~/.qoderwork/wlkj.py <命令> [参数...]      # 任意 cwd, 直接转发到真 wlkj.py
+    python ~/.qoderwork/wlkj.py --where-repo          # 只打印仓库根 (调试用)
+
+等价于在仓库根跑:
+    python <repo_root>/.qoder/scripts/orchestration/wlkj.py <命令> [参数...]
+"""
+import json
+import os
+import subprocess
+import sys
+
+HOME = os.path.expanduser('~')
+REPO_ROOT_SH = os.path.join(HOME, '.qoderwork', 'repo_root.py')  # 已验证可用的定位器
+
+
+def _resolve_repo_root():
+    """定位仓库根。优先调已验证的 ~/.qoderwork/repo_root.py (它走 .repo-root 锚点,
+    最可靠); 失败则自己读锚点兜底。返回绝对路径或 None。
+
+    与 repo_root.py 同走 ~/.qoderwork/.repo-root 锚点 (install 时写, 主路径)。
+    不重复造定位逻辑 —— repo_root.py 已经被验证可用。
+    """
+    # 主路径: 调 repo_root.py (它输出仓库根绝对路径, 经 transcript 验证可用)
+    if os.path.isfile(REPO_ROOT_SH):
+        try:
+            out = subprocess.run([sys.executable, REPO_ROOT_SH],
+                                 capture_output=True, text=True, timeout=10)
+            line = out.stdout.strip().splitlines()
+            # repo_root.py 成功时 stdout 第一行是仓库根; 失败时 stderr 报错 stdout 空
+            if line and os.path.isdir(os.path.join(line[0], '.qoder', 'scripts')):
+                return line[0]
+        except Exception:
+            pass
+    # 兜底: 直接读锚点文件 (与 repo_root.py 方法1 一致)
+    anchor = os.path.join(HOME, '.qoderwork', '.repo-root')
+    try:
+        if os.path.isfile(anchor):
+            r = open(anchor, encoding='utf-8').read().strip()
+            if r and os.path.isdir(os.path.join(r, '.qoder', 'scripts')):
+                return r
+    except OSError:
+        pass
+    return None
+
+
+def main():
+    argv = sys.argv[1:]
+    if not argv or argv[0] in ('-h', '--help', 'help'):
+        sys.stderr.write(
+            'wlkj 薄壳 (QoderWork 桌面端专用, 任意 cwd 可跑)\n'
+            '用法: python ~/.qoderwork/wlkj.py <命令> [参数...]\n'
+            '调试: python ~/.qoderwork/wlkj.py --where-repo\n'
+            '命令同仓库内 wlkj.py (kg/search/context/prefetch/task/req/eval/...)\n')
+        return 0 if not argv else 0
+
+    if argv[0] == '--where-repo':
+        root = _resolve_repo_root()
+        print(root if root else '(未定位到仓库根, 检查 ~/.qoderwork/.repo-root 锚点)')
+        return 0
+
+    repo = _resolve_repo_root()
+    if not repo:
+        sys.stderr.write(
+            '【wlkj 薄壳】未定位到仓库根。\n'
+            '  修复: 在仓库内跑 python .qoder/scripts/deployment/setup/install_qoderwork.py\n'
+            '        (会写 ~/.qoderwork/.repo-root 锚点)\n')
+        return 1
+
+    wlkj = os.path.join(repo, '.qoder', 'scripts', 'orchestration', 'wlkj.py')
+    if not os.path.isfile(wlkj):
+        sys.stderr.write('【wlkj 薄壳】真 wlkj.py 不存在: %s\n' % wlkj)
+        return 1
+
+    # 透传: 切到仓库根跑 (避免被调脚本依赖 cwd), 传全部 argv 和 exit code
+    r = subprocess.run([sys.executable, wlkj] + argv, cwd=repo)
+    return r.returncode
+
+
+if __name__ == '__main__':
+    sys.exit(main())
+

package/templates/qoder/scripts/domain/deployment/deploy_to_test.py

@@ -0,0 +1,298 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+deploy_to_test.py - 提交部署: 拉取 → cherry-pick到test分支 → 触发Jenkins构建
+
+面板「提交」按钮调用。在 fywl-ics 代码仓库执行 git 操作。
+
+三步:
+  1. 拉取当前分支最新代码
+  2. cherry-pick 当前提交到 test 分支 (冲突→abort→提示手动)
+  3. 从代码改动推断该构建哪个 Jenkins job → 触发构建
+
+用法:
+  python deploy_to_test.py --json              # 执行全部三步
+  python deploy_to_test.py --json --no-deploy  # 只拉取+cherry-pick, 不触发Jenkins
+  python deploy_to_test.py --jobs              # 列出可选的Jenkins job (供面板展示)
+  python deploy_to_test.py --json --job qas_ics_quality  # 指定构建哪个job
+
+配置 (从 .qoder/config.yaml 读, 没有就用默认):
+  deploy:
+    code_repo: data/code/fywl-ics    # 代码仓库相对路径
+    test_branch: test                # cherry-pick目标分支
+    jenkins_url: http://10.54.6.35:8866
+    jenkins_user: public_ics
+    jenkins_pass: a123456
+    jenkins_view: ICS-QAS            # Jenkins视图名
+
+退出码: 0成功; 3配置错误; 4冲突; 5网络/构建失败
+"""
+import os
+import sys
+import json
+import argparse
+import subprocess
+
+# 路径自举
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_SCRIPTS = os.path.dirname(os.path.dirname(os.path.dirname(_HERE)))  # .qoder/scripts
+_COMMON = os.path.join(_SCRIPTS, 'foundation')
+for _p in (_SCRIPTS, _COMMON):
+    if _p not in sys.path:
+        sys.path.insert(0, _p)
+try:
+    from bootstrap import setup; setup()
+except Exception:
+    pass
+
+
+def _load_config():
+    """从 config.yaml 读 deploy 段, 没有用默认。"""
+    import yaml
+    cfg_path = os.path.join(os.path.dirname(_SCRIPTS), 'config.yaml')
+    defaults = {
+        'code_repo': 'data/code/fywl-ics',
+        'test_branch': 'test',
+        'jenkins_url': 'http://10.54.6.35:8866',
+        'jenkins_user': 'public_ics',
+        'jenkins_pass': 'a123456',
+        'jenkins_view': 'ICS-QAS',
+    }
+    try:
+        with open(cfg_path, encoding='utf-8') as f:
+            full = yaml.safe_load(f) or {}
+        deploy = full.get('deploy', {})
+        defaults.update({k: v for k, v in deploy.items() if v})
+    except Exception:
+        pass
+    return defaults
+
+
+def _git(args, repo_dir, check=True):
+    """在指定仓库目录执行 git 命令。返回 (returncode, stdout, stderr)。"""
+    r = subprocess.run(['git'] + args, capture_output=True, text=True,
+                       cwd=repo_dir, timeout=30)
+    if check and r.returncode != 0:
+        raise RuntimeError('git %s 失败: %s' % (' '.join(args), r.stderr.strip()))
+    return r.returncode, r.stdout.strip(), r.stderr.strip()
+
+
+def _repo_root(cfg):
+    """定位代码仓库根目录。"""
+    from foundation.core.paths import get_repo_root
+    base = get_repo_root()
+    repo = os.path.join(str(base), cfg['code_repo'])
+    if not os.path.isdir(os.path.join(repo, '.git')):
+        # 兜底: 往上找
+        repo = os.path.join(str(base), 'data', 'code', 'fywl-ics')
+    return repo
+
+
+def step_pull(repo_dir):
+    """第1步: 拉取当前分支最新代码。"""
+    _, branch, _ = _git(['branch', '--show-current'], repo_dir)
+    _git(['fetch', 'origin'], repo_dir, check=False)
+    rc, out, err = _git(['pull', 'origin', branch], repo_dir, check=False)
+    if rc != 0:
+        return {'ok': False, 'error': '拉取失败: %s' % err, 'branch': branch}
+    return {'ok': True, 'branch': branch, 'message': '已拉取 %s 分支' % branch}
+
+
+def step_cherry_pick(repo_dir, test_branch):
+    """第2步: cherry-pick 当前提交到 test 分支。冲突→abort→提示手动。"""
+    # 拿当前分支最新 commit
+    _, commit, _ = _git(['rev-parse', 'HEAD'], repo_dir)
+    _, cur_branch, _ = _git(['branch', '--show-current'], repo_dir)
+
+    # 切到 test 分支
+    _git(['fetch', 'origin', test_branch], repo_dir, check=False)
+    rc, out, err = _git(['checkout', test_branch], repo_dir, check=False)
+    if rc != 0:
+        # test 分支不存在, 从 origin 拉远程
+        rc2, out2, err2 = _git(['checkout', '-b', test_branch, 'origin/%s' % test_branch], repo_dir, check=False)
+        if rc2 != 0:
+            return {'ok': False, 'error': '切换test分支失败: %s' % err2}
+
+    _git(['pull', 'origin', test_branch], repo_dir, check=False)
+
+    # cherry-pick
+    rc, out, err = _git(['cherry-pick', commit], repo_dir, check=False)
+    if rc != 0:
+        # 冲突 → abort → 切回原分支 → 提示手动
+        _git(['cherry-pick', '--abort'], repo_dir, check=False)
+        _git(['checkout', cur_branch], repo_dir, check=False)
+        return {'ok': False, 'error': 'cherry-pick 到 %s 分支冲突, 已撤销。请手动解决:\n'
+                '  git checkout %s && git cherry-pick %s' % (test_branch, test_branch, commit[:8]),
+                'conflict': True}
+
+    # 推送
+    rc, out, err = _git(['push', 'origin', test_branch], repo_dir, check=False)
+    if rc != 0:
+        return {'ok': False, 'error': '推送到 %s 失败: %s' % (test_branch, err)}
+
+    # 切回原分支
+    _git(['checkout', cur_branch], repo_dir, check=False)
+
+    return {'ok': True, 'commit': commit[:8], 'test_branch': test_branch,
+            'message': '已 cherry-pick %s 到 %s 并推送' % (commit[:8], test_branch)}
+
+
+def _get_changed_modules(repo_dir):
+    """从 git diff 提取改动的模块名 (用于推断 Jenkins job)。"""
+    _, out, _ = _git(['diff', '--name-only', 'HEAD~1'], repo_dir, check=False)
+    if not out:
+        _, out, _ = _git(['diff', '--name-only', '--cached'], repo_dir, check=False)
+    if not out:
+        _, out, _ = _git(['status', '--porcelain'], repo_dir, check=False)
+    modules = set()
+    for line in out.split('\n'):
+        line = line.strip().split()[-1] if line.strip() else ''
+        if not line:
+            continue
+        # 从路径提取模块: ics-modules/ics-quality/xxx → ics-quality
+        parts = line.split('/')
+        for i, p in enumerate(parts):
+            if p.startswith('ics-') and i + 1 < len(parts):
+                modules.add(p)
+                break
+            # fywl-ui 前端
+            if 'fywl-ui' in line or line.startswith('apps/'):
+                modules.add('ui')
+    return modules
+
+
+def _list_jenkins_jobs(cfg):
+    """拉 Jenkins 视图下的 job 列表。"""
+    import urllib.request, base64
+    url = '%s/view/%s/api/json?tree=jobs[name]' % (cfg['jenkins_url'], cfg['jenkins_view'])
+    req = urllib.request.Request(url)
+    cred = base64.b64encode(('%s:%s' % (cfg['jenkins_user'], cfg['jenkins_pass'])).encode()).decode()
+    req.add_header('Authorization', 'Basic ' + cred)
+    r = urllib.request.urlopen(req, timeout=10)
+    data = json.loads(r.read())
+    return [j['name'] for j in data.get('jobs', [])]
+
+
+def _guess_jobs(modules, all_jobs):
+    """从改动模块推断该构建哪些 Jenkins job。"""
+    matched = []
+    for mod in modules:
+        # 模块名 ics-quality → job名 qas_ics_quality 或 qas-ics-quality
+        mod_norm = mod.replace('-', '_').replace('_', '')
+        for job in all_jobs:
+            job_norm = job.replace('-', '_').replace('_', '').lower()
+            if mod_norm in job_norm:
+                matched.append(job)
+    return list(set(matched))
+
+
+def step_jenkins_build(cfg, job_name):
+    """第3步: 触发 Jenkins 构建。"""
+    import urllib.request, base64
+    # 先拿 crumb (Jenkins CSRF)
+    crumb_url = '%s/crumbIssuer/api/json' % cfg['jenkins_url']
+    cred = base64.b64encode(('%s:%s' % (cfg['jenkins_user'], cfg['jenkins_pass'])).encode()).decode()
+    headers = {'Authorization': 'Basic ' + cred}
+    try:
+        req = urllib.request.Request(crumb_url, headers=headers)
+        crumb_data = json.loads(urllib.request.urlopen(req, timeout=10).read())
+        crumb_field = crumb_data.get('crumbRequestField', '')
+        crumb_value = crumb_data.get('crumb', '')
+        headers[crumb_field] = crumb_value
+    except Exception:
+        pass  # 没 crumb 也试
+
+    build_url = '%s/job/%s/build' % (cfg['jenkins_url'], job_name)
+    req = urllib.request.Request(build_url, data=b'', headers=headers, method='POST')
+    try:
+        r = urllib.request.urlopen(req, timeout=15)
+        return {'ok': True, 'job': job_name, 'message': '已触发 %s 构建 (HTTP %d)' % (job_name, r.status)}
+    except urllib.error.HTTPError as e:
+        if e.code == 201:
+            return {'ok': True, 'job': job_name, 'message': '已触发 %s 构建' % job_name}
+        return {'ok': False, 'error': '触发构建失败 (HTTP %d): %s' % (e.code, str(e)[:60])}
+    except Exception as e:
+        return {'ok': False, 'error': '触发构建异常: %s' % str(e)[:80]}
+
+
+def deploy(job_name=None, skip_deploy=False):
+    """执行部署全流程。返回 (result_dict, exit_code)。"""
+    cfg = _load_config()
+    repo_dir = _repo_root(cfg)
+    if not os.path.isdir(os.path.join(repo_dir, '.git')):
+        return {'ok': False, 'error': '代码仓库不存在: %s' % repo_dir}, 3
+
+    results = {'steps': []}
+
+    # ① 拉取
+    r1 = step_pull(repo_dir)
+    results['steps'].append({'step': 'pull', **r1})
+    if not r1['ok']:
+        return {'ok': False, 'error': r1['error'], 'results': results}, 5
+
+    # ② cherry-pick
+    r2 = step_cherry_pick(repo_dir, cfg['test_branch'])
+    results['steps'].append({'step': 'cherry-pick', **r2})
+    if not r2['ok']:
+        # 冲突不阻塞 Jenkins (开发可能只想先构建), 但标记冲突
+        results['conflict'] = r2.get('conflict', False)
+
+    # ③ Jenkins 构建
+    if not skip_deploy:
+        all_jobs = _list_jenkins_jobs(cfg)
+        if job_name:
+            # 指定了 job
+            r3 = step_jenkins_build(cfg, job_name)
+        else:
+            # 自动推断
+            modules = _get_changed_modules(repo_dir)
+            guessed = _guess_jobs(modules, all_jobs)
+            results['guessed_modules'] = list(modules)
+            results['guessed_jobs'] = guessed
+            if len(guessed) == 1:
+                r3 = step_jenkins_build(cfg, guessed[0])
+            elif len(guessed) > 1:
+                # 多个匹配 → 不自动构建, 让面板让用户选
+                r3 = {'ok': False, 'need_select': True, 'jobs': guessed,
+                      'error': '改动涉及多个模块, 请选择要构建的job: %s' % ', '.join(guessed)}
+            else:
+                # 匹配不到 → 返回全部 job 让用户选
+                r3 = {'ok': False, 'need_select': True, 'jobs': all_jobs,
+                      'error': '无法从改动推断构建模板, 请选择'}
+        results['steps'].append({'step': 'jenkins', **r3})
+
+    return {'ok': not results.get('conflict', False), 'results': results}, 0
+
+
+def main():
+    parser = argparse.ArgumentParser(description='提交部署: 拉取→cherry-pick→Jenkins构建')
+    parser.add_argument('--json', action='store_true', help='JSON输出')
+    parser.add_argument('--no-deploy', action='store_true', help='只拉取+cherry-pick, 不触发Jenkins')
+    parser.add_argument('--job', help='指定构建的Jenkins job名')
+    parser.add_argument('--jobs', action='store_true', help='列出可选的Jenkins job')
+    args = parser.parse_args()
+
+    cfg = _load_config()
+
+    if args.jobs:
+        try:
+            jobs = _list_jenkins_jobs(cfg)
+            result = {'ok': True, 'jobs': jobs}
+            print(json.dumps(result, ensure_ascii=False))
+        except Exception as e:
+            print(json.dumps({'ok': False, 'error': str(e)}))
+        sys.exit(0)
+
+    result, code = deploy(job_name=args.job, skip_deploy=args.no_deploy)
+
+    if args.json:
+        print(json.dumps(result, ensure_ascii=False, default=str))
+    else:
+        for step in result.get('results', {}).get('steps', []):
+            status = 'OK' if step.get('ok') else 'FAIL'
+            print('[%s] %s: %s' % (status, step.get('step'), step.get('message', step.get('error', ''))))
+    sys.exit(code)
+
+
+if __name__ == '__main__':
+    main()