@hupan56/wlkj 3.2.0 → 3.3.1

package/templates/qoder/scripts/engine/poller.py

@@ -0,0 +1,219 @@
+"""引擎轮询器：后台轮询平台 pending 触发 → 认领 → 执行 → 回流 → 回填结果。
+
+这是"平台→引擎→平台"真闭环的引擎侧执行器：
+1. 轮询 GET /trigger/pending（带项目令牌）
+2. 认领 POST /trigger/{tid}/claim（原子锁）
+3. 执行：根据 command 调 MCP 取知识 + 生成产出（简化版：rag_search + 模板拼接）
+4. 回流：create_prd/submit_return
+5. 回填：PATCH /trigger/{tid}（mcp_tools_called/knowledge_used）
+
+用法：
+  python poller.py --config ../mcp_config.json --interval 10
+
+注：完整版需要接 LLM（qwen-plus）生成 PRD/原型。当前是简化版（rag_search + 模板），
+验证闭环链路。接 LLM 后把 _execute 里的模板拼接换成 cap.mcp.call("ask_corpus",...) 生成。
+"""
+import json
+import time
+import urllib.request
+import urllib.error
+import argparse
+import os
+import sys
+from pathlib import Path
+
+
+def _load_config(config_path: str) -> dict:
+    with open(config_path, encoding="utf-8") as f:
+        return json.load(f)
+
+
+def _get_token(cfg: dict) -> str:
+    for srv in (cfg.get("mcpServers") or {}).values():
+        return srv.get("token", "")
+    return ""
+
+
+def _get_pid(cfg: dict) -> str:
+    for srv in (cfg.get("mcpServers") or {}).values():
+        env = srv.get("env") or {}
+        return env.get("WLKJ_PROJECT_ID", "")
+    return ""
+
+
+def _get_base(cfg: dict) -> str:
+    ep = cfg.get("return_endpoint") or {}
+    url = ep.get("url", "")
+    # 从 return_endpoint.url 提取 base（/api/projects 前面那段）
+    if "/api/" in url:
+        return url.split("/api/")[0]
+    for srv in (cfg.get("mcpServers") or {}).values():
+        u = srv.get("url", "")
+        if "/mcp" in u:
+            return u.split("/mcp")[0]
+    return os.environ.get("WLKJ_BASE_URL", "http://10.89.7.120")
+
+
+def _api(base, method, path, token, body=None):
+    url = base + path
+    data = json.dumps(body).encode() if body else None
+    req = urllib.request.Request(url, data=data, method=method)
+    req.add_header("Content-Type", "application/json")
+    if token:
+        req.add_header("X-Engine-Token", token)
+    try:
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            return resp.status, json.loads(resp.read().decode())
+    except urllib.error.HTTPError as e:
+        return e.code, json.loads(e.read().decode() or "{}")
+    except Exception as e:
+        return 0, {"error": str(e)}
+
+
+def _mcp_call(base, token, tool, args):
+    """通过 MCP JSON-RPC 调工具。"""
+    body = {"jsonrpc": "2.0", "id": 1, "method": "tools/call",
+            "params": {"name": tool, "arguments": args}}
+    data = json.dumps(body).encode()
+    req = urllib.request.Request(base + "/mcp", data=data, method="POST")
+    req.add_header("Content-Type", "application/json")
+    req.add_header("X-MCP-Token", token)
+    try:
+        with urllib.request.urlopen(req, timeout=60) as resp:
+            r = json.loads(resp.read().decode())
+            text = r.get("result", {}).get("content", [{}])[0].get("text", "")
+            return json.loads(text) if text else {}
+    except Exception as e:
+        return {"error": str(e)}
+
+
+def _execute(base, token, pid, command, args):
+    """执行触发的工作流（简化版：rag_search 取知识 + 模板拼 PRD + learn 写回）。
+    完整版应接 LLM（ask_corpus）生成自然语言 PRD。"""
+    query = (args or {}).get("query", "")
+    tools_called = []
+    knowledge_used = []
+
+    # 1) rag_search 取知识
+    if query:
+        r = _mcp_call(base, token, "rag_search", {"query": query, "top_k": 8})
+        tools_called.append("rag_search")
+        knowledge_used = [it.get("entity_id", "") for it in r.get("items", [])[:5]]
+        knowledge_text = "\n".join(
+            "- %s (%s)" % (it.get("text", "")[:60], it.get("entity_id", "")[:30])
+            for it in r.get("items", [])[:8]
+        )
+        # 1b) get_learnings 查之前学到的（反哺）
+        lr = _mcp_call(base, token, "get_learnings", {"project_id": pid, "limit": 5})
+        tools_called.append("get_learnings")
+        learnings_text = "\n".join(
+            "- [%s] %s" % (l.get("category",""), (l.get("pattern","")[:60]))
+            for l in (lr.get("items") or [])[:5]
+        ) or "(暂无学习记录)"
+    else:
+        knowledge_text = "(无关键词)"
+        learnings_text = ""
+
+    # 2) 根据 command 生成产出
+    if "prd" in command.lower():
+        prd_md = f"# {query} PRD（引擎自动生成）\n\n## 概述\n基于知识层自动生成的「{query}」需求文档。\n\n## 相关知识\n{knowledge_text}\n\n## 历史学习\n{learnings_text}\n\n## 功能\n（根据上述知识补充）"
+        # 回流
+        r = _mcp_call(base, token, "create_prd", {
+            "project_id": pid, "title": f"{query}PRD(引擎触发)", "content_md": prd_md, "status": "planning"
+        })
+        tools_called.append("create_prd")
+        # 学习写回：把这次的关键认知沉淀
+        _mcp_call(base, token, "learn", {"project_id": pid, "category": "rule",
+            "pattern": f"{query}: PRD已生成，涉及知识{len(knowledge_used)}条", "source": "wlkj-poller"})
+        tools_called.append("learn")
+        output = f"生成PRD: {query}PRD(引擎触发) + 学习沉淀"
+    elif "design" in command.lower():
+        html = f"<html><body><h1>{query}</h1><p>引擎自动生成原型</p></body></html>"
+        r = _mcp_call(base, token, "create_prototype", {
+            "project_id": pid, "feature": f"{query}(引擎触发)", "platform": "web", "html": html
+        })
+        tools_called.append("create_prototype")
+        output = f"生成原型: {query}(引擎触发)"
+    else:
+        # learn 写回
+        _mcp_call(base, token, "learn", {
+            "project_id": pid, "category": "rule", "pattern": f"{query}相关规则(引擎触发)",
+            "source": "wlkj-poller"
+        })
+        tools_called.append("learn")
+        output = f"执行命令: {command}"
+
+    return {"output": output, "tools": tools_called, "knowledge": knowledge_used}
+
+
+def poll_once(cfg):
+    """轮询一次：取 pending → 认领 → 执行 → 回填。"""
+    token = _get_token(cfg)
+    pid = _get_pid(cfg)
+    base = _get_base(cfg)
+    if not token or not pid:
+        print("[poller] 配置缺 token/project_id，跳过")
+        return
+
+    # 1) 查 pending
+    _, pending = _api(base, "GET", f"/api/projects/{pid}/trigger/pending", token)
+    items = pending.get("pending", [])
+    if not items:
+        return  # 无待执行
+
+    for item in items[:1]:  # 一次只处理 1 条
+        tid = item.get("triggerId")
+        cmd = item.get("command", "")
+        args = item.get("args", {})
+        print(f"[poller] 认领: {tid} {cmd} {args}")
+
+        # 2) claim
+        code, resp = _api(base, "POST", f"/api/projects/{pid}/trigger/workflow/{tid}/claim",
+                          token, {"engine_id": "poller-001"})
+        if code != 200:
+            print(f"[poller] 认领失败({code}): {resp}")
+            continue
+
+        # 3) 执行
+        t0 = time.time()
+        try:
+            result = _execute(base, token, pid, cmd, args)
+            status = "success"
+        except Exception as e:
+            result = {"output": str(e), "tools": [], "knowledge": []}
+            status = "failed"
+
+        # 4) patch 回填
+        _api(base, "PATCH", f"/api/projects/{pid}/trigger/workflow/{tid}", token, {
+            "status": status,
+            "output_summary": result["output"],
+            "knowledge_used": result["knowledge"],
+            "mcp_tools_called": result["tools"],
+            "duration_sec": int(time.time() - t0),
+        })
+        print(f"[poller] 完成: {status} → {result['output']} (tools={result['tools']})")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="wlkj 引擎轮询器")
+    parser.add_argument("--config", default=str(Path(__file__).parent.parent.parent / "mcp_config.json"))
+    parser.add_argument("--interval", type=int, default=10, help="轮询间隔(秒)")
+    parser.add_argument("--once", action="store_true", help="只跑一次")
+    args = parser.parse_args()
+
+    cfg = _load_config(args.config)
+    print(f"[poller] 启动: project={_get_pid(cfg)} interval={args.interval}s")
+    print(f"[poller] 按 Ctrl+C 停止")
+
+    while True:
+        try:
+            poll_once(cfg)
+        except Exception as e:
+            print(f"[poller] 异常: {e}")
+        if args.once:
+            break
+        time.sleep(args.interval)
+
+
+if __name__ == "__main__":
+    main()

package/templates/qoder/scripts/foundation/integrations/active_task.py

@@ -44,7 +44,8 @@ try:
     )
 except ImportError:
     _ENV_SESSION_KEYS = (
-        ("qoderwork", ("QODER_SESSION_ID",)),
+        ("qoder-desktop", ("QODER_DESKTOP", "QODER_IDE")),
+        ("qoder-work", ("QODER_SESSION_ID",)),
         ("codex", ("CODEX_SESSION_ID", "CODEX_THREAD_ID")),
         ("claude", ("CLAUDE_SESSION_ID", "CLAUDE_CODE_SESSION_ID")),
         ("cursor", ("CURSOR_SESSION_ID",)),

package/templates/qoder/scripts/orchestration/wlkj.py

@@ -57,6 +57,9 @@ DISPATCH = {
     # ── 需求 / PRD ──
     'req': 'domain/requirement/req.py',
     'archive-prd': 'domain/requirement/archive_prd.py',
+    # ── 回流平台 (引擎产出 → 平台 AI回流Tab) ──
+    # 用法: wlkj.py return prd <路径> <标题> | return prototype <路径> <功能名> [--platform web]
+    'return': 'domain/integration/return_to_platform.py',
     # ── 设计 ──
     'fill-prototype': 'domain/design/fill_prototype.py',
     'design-doc': 'domain/design/gen_design_doc.py',
@@ -118,6 +121,7 @@ def _usage():
         '  同步:      sync pull|push       (team_sync.py)',
         '  需求:      req <子命令>         (req.py, 需求生命周期)',
         '             archive-prd          (PRD 归档)',
+        '  回流平台:  return prd|prototype <文件> <标题> [--platform web]  (PRD/原型回流到平台 AI回流Tab)',
         '  设计:      fill-prototype <tpl> (真实数据预填原型)',
         '             design-doc           (生成 DESIGN.md)',
         '  评估/学习: eval <prd.md>        (eval_prd.py, EVA 评分)',

package/templates/qoder/scripts/protocol/mcp/zentao_mcp_server.py

@@ -190,7 +190,7 @@ class ZentaoMCPServer(BaseMCPServer):
             # fail-closed: 共享账号下无法判定归属 → 拒绝写, 防改错队友
             return ('🚫 未识别禅道身份, 无法校验归属, 已拒绝写操作(防改错队友)。\n'
                     '  修复: /wl-init 配置禅道账号, 或 member.json 加 "zentao_account"。')
-        r = _api('GET', '/%ss/%s' % (kind, item_id))
+        r = _api('GET', '/%s/%s' % ({'task': 'tasks', 'bug': 'bugs', 'story': 'stories'}.get(kind, kind + 's'), item_id))
         if r.status_code not in (200, 201):
             return None  # 查询失败不阻塞 (禅道权限兜底)
         data = r.json()

package/templates/qoder/scripts/protocol/transports/http.py

@@ -72,7 +72,11 @@ class RemoteHttpTransport:
             body["params"] = params
 
         data = json.dumps(body, ensure_ascii=False).encode("utf-8")
-        endpoint = self._url + "/mcp"
+        # 修复双重 /mcp：若 url 已含 /mcp 后缀则直接用，否则拼接。
+        # 历史问题: registry 配的 url 已是 http://host/mcp, 这里又拼 /mcp → /mcp/mcp → 404。
+        # 现在两端都安全: url 配 base 或带 /mcp 都能落到正确的 endpoint。
+        low = self._url.lower()
+        endpoint = self._url if low.endswith("/mcp") else (self._url + "/mcp")
 
         req = urllib.request.Request(
             endpoint,
@@ -81,6 +85,8 @@ class RemoteHttpTransport:
             method="POST",
         )
         if self._token:
+            # 平台 MCP 校验 X-MCP-Token（项目级令牌）；同时带 Authorization Bearer 兼容标准 MCP 客户端
+            req.add_header("X-MCP-Token", self._token)
             req.add_header("Authorization", "Bearer %s" % self._token)
 
         try:

package/templates/qoder/scripts/validation/metrics/present_board.py

@@ -0,0 +1,180 @@
+# -*- coding: utf-8 -*-
+"""present_board.py — 知识层富展示看板（cap.present.widget / 落盘降级）。
+
+子命令（数据走 MCP，HTML 自包含，复用 capability.present_html.present）：
+  impact   — get_impact 影响传播树（分层 upstream/downstream 可折叠）
+  coverage — coverage_matrix 覆盖热力图（功能×测试 有/无）
+  feature  — feature_overview 功能画像卡（端点+按钮+用例+页面+PRD）
+
+用法：
+  python present_board.py impact --entity handleExport --project-id <UUID>
+  python present_board.py coverage --project-id <UUID>
+  python present_board.py feature --feature 资产管理 --project-id <UUID>
+
+QoderWork 桌面端 → HTML 嵌入对话流；CLI/IDE → 落盘 workspace/members/{dev}/journal/。
+"""
+import argparse
+import json
+import os
+import sys
+from pathlib import Path
+
+
+def _resolve_repo():
+    env = os.environ.get("QODER_REPO") or os.environ.get("WLKJ_REPO")
+    if env:
+        return Path(env)
+    p = Path(__file__).resolve()
+    for parent in p.parents:
+        if (parent / ".qoder").is_dir() or (parent / "packages").is_dir():
+            return parent
+    return p.parent
+
+
+def _cap():
+    repo = _resolve_repo()
+    sd = str(repo / ".qoder" / "scripts")
+    if sd not in sys.path:
+        sys.path.insert(0, sd)
+    from capability.registry import resolve
+    return resolve(), repo
+
+
+def _unpack(r):
+    """cap.mcp.call 返回 ToolResult（.text 是 JSON 字符串），解包成 dict。"""
+    if isinstance(r, dict):
+        return r
+    if getattr(r, "is_error", False):
+        return {"error": getattr(r, "text", str(r))}
+    txt = getattr(r, "text", None)
+    if txt is None:
+        return r
+    try:
+        return json.loads(txt)
+    except Exception:
+        return {"raw": txt}
+
+
+_CSS = """
+body{font-family:-apple-system,'Segoe UI',sans-serif;margin:0;padding:20px;background:#f7f8fa;color:#1f2329}
+h1{font-size:20px;margin:0 0 8px} h3{font-size:14px;margin:12px 0 6px;color:#4e5969}
+p{color:#86909c;font-size:13px;margin:4px 0}
+details{background:#fff;border:1px solid #e5e6eb;border-radius:6px;padding:8px 12px;margin:6px 0}
+summary{cursor:pointer;font-weight:600;font-size:13px}
+ul{margin:6px 0;padding-left:20px} li{font-size:13px;line-height:1.8} small{color:#86909c}
+.grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(160px,1fr));gap:8px}
+.cell{padding:10px;border-radius:6px;font-size:13px;text-align:center}
+.covered{background:#e8ffea;color:#00b42a;border:1px solid #b9f0c6}
+.gap{background:#fff2f0;color:#f53f3f;border:1px solid #ffd4d4}
+.cards{display:grid;grid-template-columns:repeat(auto-fill,minmax(240px,1fr));gap:12px}
+.card{background:#fff;border:1px solid #e5e6eb;border-radius:8px;padding:12px}
+.card h3{margin-top:0}
+"""
+
+
+def _wrap(title, body):
+    return ("<!DOCTYPE html><html><head><meta charset='utf-8'>"
+            "<meta name='viewport' content='width=device-width,initial-scale=1'>"
+            "<title>%s</title><style>%s</style></head><body>%s</body></html>"
+            % (title, _CSS, body))
+
+
+def cmd_impact(args):
+    cap, repo = _cap()
+    impact = _unpack(cap.mcp.call("get_impact", {"project_id": args.project_id or "",
+                                                 "entity": args.entity, "depth": args.depth}))
+    from capability.present_html import present
+    if "error" in impact:
+        body = "<h1>影响分析 · %s</h1><p class='gap'>取数失败: %s</p>" % (args.entity, impact["error"][:200])
+        present(_wrap("影响分析-" + args.entity, body), name="impact-" + args.entity[:20], repo_root=repo)
+        return
+    sections = []
+    for direction, label in [("upstream", "↑ 谁依赖我（改动影响范围）"),
+                             ("downstream", "↓ 我依赖谁")]:
+        layers = impact.get(direction) or []
+        items_html = ""
+        for i, lay in enumerate(layers):
+            its = lay.get("items", []) if isinstance(lay, dict) else []
+            lis = "".join("<li>%s <small>%s</small></li>"
+                          % (it.get("id", "?"), it.get("type", "")) for it in its)
+            items_html += "<details open><summary>第%d层 (%d)</summary><ul>%s</ul></details>" % (i + 1, len(its), lis)
+        sections.append("<h3>%s</h3>%s" % (label, items_html))
+    totals = impact.get("totals", {}) or {}
+    bytype = impact.get("byType", {}) or {}
+    body = ("<h1>影响分析 · %s</h1><p>节点 %s · 类型分布 %s · depth %d</p>"
+            % (args.entity, totals.get("nodes", 0),
+               json.dumps(bytype, ensure_ascii=False), args.depth)) + "".join(sections)
+    present(_wrap("影响分析-" + args.entity, body),
+            name="impact-" + args.entity[:20], repo_root=repo)
+
+
+def cmd_coverage(args):
+    cap, repo = _cap()
+    cov = _unpack(cap.mcp.call("coverage_matrix", {"project_id": args.project_id or ""}))
+    from capability.present_html import present
+    if "error" in cov:
+        present(_wrap("覆盖矩阵", "<h1>测试覆盖矩阵</h1><p class='gap'>取数失败: %s</p>" % cov["error"][:200]),
+                name="coverage", repo_root=repo)
+        return
+    items = cov.get("items") or cov.get("matrix") or cov.get("features") or []
+    cells = "".join(_cov_cell(it) for it in items) or "<p>无覆盖数据</p>"
+    covered = sum(1 for it in items if it.get("has_test") or it.get("covered"))
+    body = ("<h1>测试覆盖矩阵</h1><p>共 %d 项 · 已覆盖 %d · 缺口 %d</p>"
+            % (len(items), covered, len(items) - covered)) + '<div class="grid">%s</div>' % cells
+    present(_wrap("覆盖矩阵", body), name="coverage", repo_root=repo)
+
+
+def _cov_cell(it):
+    name = it.get("feature") or it.get("name") or it.get("canonical") or "?"
+    has = it.get("has_test") or it.get("covered")
+    cls = "covered" if has else "gap"
+    return '<div class="cell %s">%s</div>' % (cls, name)
+
+
+def cmd_feature(args):
+    cap, repo = _cap()
+    feat = _unpack(cap.mcp.call("feature_overview", {"project_id": args.project_id or "",
+                                                     "feature": args.feature}))
+    from capability.present_html import present
+    if "error" in feat:
+        present(_wrap("功能画像-" + args.feature, "<h1>功能画像 · %s</h1><p class='gap'>取数失败: %s</p>" % (args.feature, feat["error"][:200])),
+                name="feature-" + args.feature[:20], repo_root=repo)
+        return
+    cards = []
+    for key, label in [("endpoints", "端点"), ("buttons", "按钮"),
+                       ("tests", "测试用例"), ("pages", "页面"), ("prds", "PRD")]:
+        lst = feat.get(key) or []
+        if not lst:
+            continue
+        lis = "".join("<li>%s</li>" % x for x in (lst if isinstance(lst, list) else [str(lst)])[:20])
+        cards.append('<div class="card"><h3>%s (%d)</h3><ul>%s</ul></div>' % (label, len(lst), lis))
+    complete = "完整" if len(cards) >= 4 else "部分"
+    body = ("<h1>功能画像 · %s</h1><p>覆盖 %d 维 · %s画像</p>"
+            % (args.feature, len(cards), complete)) + '<div class="cards">%s</div>' % "".join(cards)
+    present(_wrap("功能画像-" + args.feature, body),
+            name="feature-" + args.feature[:20], repo_root=repo)
+
+
+def main():
+    ap = argparse.ArgumentParser(description="知识层富展示看板")
+    sub = ap.add_subparsers(dest="cmd", required=True)
+    p_imp = sub.add_parser("impact")
+    p_imp.add_argument("--entity", required=True)
+    p_imp.add_argument("--project-id")
+    p_imp.add_argument("--depth", type=int, default=2)
+    p_cov = sub.add_parser("coverage")
+    p_cov.add_argument("--project-id")
+    p_fea = sub.add_parser("feature")
+    p_fea.add_argument("--feature", required=True)
+    p_fea.add_argument("--project-id")
+    args = ap.parse_args()
+    if args.cmd == "impact":
+        cmd_impact(args)
+    elif args.cmd == "coverage":
+        cmd_coverage(args)
+    elif args.cmd == "feature":
+        cmd_feature(args)
+
+
+if __name__ == "__main__":
+    main()

package/templates/qoder/settings.json

@@ -68,6 +68,16 @@
         ]
       }
     ],
+    "PreToolUse": [
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "command": "python .qoder/hooks/pre-tool-use.py || python3 .qoder/hooks/pre-tool-use.py"
+          }
+        ]
+      }
+    ],
     "PostToolUse": [
       {
         "matcher": "*",

package/templates/root/AGENTS.md

@@ -190,21 +190,20 @@ Style priority: Code > PDF > Default
 **独立性**：每个模块认文件不认流程。缺上游 → 手动喂个契约文件，或用自然语言 +
 `context_pack.py` 让 AI 自检索补全（见 `.qoder/contracts/fallback.md`）。
 
-## Qoder 全系列兼容（IDE / Quest / CLI / QoderWork）
+## Qoder 系列兼容（Desktop / QoderWork）
 
 This pipeline works on Windows + macOS, across the **whole Qoder family**.
 Each product loads rules from a different carrier — keep them in sync:
 
-| 产品/模式 | 规则载体 | 命令载体 |
-|-----------|---------|---------|
-| Qoder IDE 默认编辑器 | .qoder/rules/wl-pipeline.md (always_on) | .qoder/commands/wl-*.md |
-| Qoder Quest 模式 | .qoder/rules/ + .qoder/skills/ + .qoder/agents/ | 自然语言 -> skills |
-| Qoder CLI (qodercli) | 本文件 AGENTS.md | 自然语言 -> scripts |
-| QoderWork 桌面 Agent | 安装 .qoder/skills/ 下的技能 | 自然语言 -> skills |
+| 产品 | 定位 | 规则载体 | 命令载体 |
+|-----------|------|---------|---------|
+| Qoder Desktop/IDE 1.0（含 Quest 模式）| 主开发宿主 | .qoder/rules/wl-pipeline.md + .qoder/skills/ + .qoder/agents/ | .qoder/commands/wl-*.md；Quest 走自然语言→skills |
+| QoderWork 桌面 Agent | 办公（非开发者）| 安装 .qoder/skills/ 下的技能 | 自然语言→skills；~/.qoderwork/ 投影 |
 
-> 本流水线聚焦 Qoder 全系列，4 种载体功能等价。知识图谱 17 个能力（影响分析/
-> 覆盖矩阵/功能画像/业务流程/多跳遍历…）通过统一 CLI `python .qoder/scripts/domain/kg/kg.py`
-> 全系列触达；QoderWork 环境也可直接调 MCP 工具。
+> 本流水线聚焦 Qoder 系列（主开发 Desktop + 办公 QoderWork），载体功能等价。知识图谱 17 个能力
+> （影响分析/覆盖矩阵/功能画像/业务流程/多跳遍历…）通过统一 CLI
+> `python .qoder/scripts/domain/kg/kg.py` 全系列触达；Desktop/QoderWork 环境也可直接调 MCP 工具。
+> （Qoder CLI / Cloud Agents 后续按需对接。）
 
 ## QoderWork Integration: Optional Enhancement Only (Progressive Enhancement)