@hupan56/wlkj 3.3.14 → 3.3.15

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

@@ -834,6 +834,7 @@ def check_lanhu():
 def main():
     args = [a for a in sys.argv[1:]]
     fix = '--fix' in args
+    skip_code = '--skip-code' in args or '--cloud' in args
     pos = [a for a in args if not a.startswith('--')]
     name = pos[0] if pos else None
     role = pos[1] if len(pos) > 1 else None
@@ -848,8 +849,11 @@ def main():
     check_dependencies(fix)
     check_developer(fix, name, role)
     check_team_sync(fix)
-    check_source_repos(fix, config)
-    check_index(fix)
+    if skip_code:
+        print('\n--- 4. 源码/索引: 云模式跳过（KG 在云平台，引擎调云 MCP）---')
+    else:
+        check_source_repos(fix, config)
+        check_index(fix)
     check_style(fix)
     check_prd_templates()
     check_weekly(fix)

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

@@ -438,20 +438,20 @@ def rewrite_mcp_json_for_launcher():
     }
     changed = False
     for srv, sub in name_map.items():
-        # 共识：kg 走云平台（读 config platform_mcp.url → SSE url），不连本地 kg.duckdb（空）
+        # 共识：kg 走云平台（默认 10.89.7.120:10010/mcp，config platform_mcp.url 可覆盖）
         if srv == "qoder-knowledge-graph":
+            _pm = "http://10.89.7.120:10010/mcp"
             try:
                 import yaml as _y
                 _cfg_p = get_repo_root() / ".qoder" / "config.yaml"
                 if _cfg_p.is_file():
                     _cfg = _y.safe_load(_cfg_p.read_text(encoding="utf-8")) or {}
-                    _pm = (_cfg.get("platform_mcp") or {}).get("url", "")
-                    if _pm:
-                        servers[srv] = {"url": _pm, "type": "sse", "enabled": True}
-                        changed = True
-                        continue
+                    _pm = (_cfg.get("platform_mcp") or {}).get("url", "") or _pm
             except Exception:
-                pass  # config 无 platform_mcp → 回退 launcher
+                pass
+            servers[srv] = {"url": _pm, "type": "sse", "enabled": True}
+            changed = True
+            continue
         entry = servers.get(srv)
         # 全新机器: kg/mysql/lanhu 条目可能不存在 → 创建它 (launcher 模式)
         if not entry:

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

@@ -242,9 +242,11 @@ def detect_name(explicit=None):
 # Step 2: 调 init_doctor --fix (主体)
 # ============================================================
 
-def run_doctor(name, role):
+def run_doctor(name, role, skip_code=False):
     print('\n--- 初始化 (init_doctor) ---')
     cmd = [sys.executable, str(THIS_DIR / 'init_doctor.py'), '--fix', name, role]
+    if skip_code:
+        cmd.append('--skip-code')
     # 透传 stdio (用户能看到实时输出) + 强制 UTF-8 环境 (解决 cmd GBK 乱码)
     env = dict(os.environ)
     env['PYTHONIOENCODING'] = 'utf-8'
@@ -911,6 +913,7 @@ def main():
     parser.add_argument('--skip-cron', action='store_true', help='跳过 cron 注册')
     parser.add_argument('--skip-qoderwork', action='store_true', help='跳过 QoderWork 安装')
     parser.add_argument('--skip-lanhu', action='store_true', help='跳过蓝湖 MCP 引导')
+    parser.add_argument('--skip-code', '--cloud', action='store_true', help='云模式：跳过本地源码 clone/索引（KG 在云平台）')
     args = parser.parse_args()
 
     print('=' * 56)
@@ -931,7 +934,7 @@ def main():
     configure_git_identity(name)
 
     # Step 2
-    if not run_doctor(name, args.role):
+    if not run_doctor(name, args.role, args.skip_code):
         warn('init_doctor 未完全成功, 继续 setup 后续步骤...')
 
     # Step 3

package/templates/qoder/scripts/domain/integration/return_to_platform.py

@@ -20,6 +20,7 @@ integration.return_to_platform —— 引擎产出回流平台的统一通道。
 """
 from __future__ import annotations
 
+import os
 from typing import Optional
 
 
@@ -34,6 +35,7 @@ def _load_mcp_config() -> dict:
     except Exception:
         repo = Path(__file__).resolve().parent.parent.parent.parent.parent
     for cand in [
+        repo / ".qoder" / "mcp_config.json",  # ★ switch_project 写这里，优先查（否则读不到 token → 回流误报"无 X-Engine-Token"）
         repo / "mcp_config.json",
     ]:
         try:
@@ -121,7 +123,7 @@ def _via_http(payload: dict) -> tuple[bool, str]:
 
 
 def _platform_base() -> str:
-    """平台 base url（http://127.0.0.1:10010），从 mcp_config server url 推导。"""
+    """平台 base url（默认 http://10.89.7.120 云），从 mcp_config server url 推导。"""
     from urllib.parse import urlparse
     cfg = _load_mcp_config()
     for srv in (cfg.get("mcpServers") or {}).values():
@@ -133,7 +135,7 @@ def _platform_base() -> str:
     if ep:
         p = urlparse(ep)
         return "%s://%s" % (p.scheme, p.netloc)
-    return "http://127.0.0.1:10010"
+    return os.environ.get("WLKJ_BASE_URL", "http://10.89.7.120")
 
 
 def _engine_token() -> Optional[str]:

package/templates/qoder/scripts/domain/integration/spec_upload.py

@@ -5,7 +5,7 @@
 契约: wlinkj-workspace/docs/SPEC-MCP-CONTRACT.md v1（create/confirm/update/get_spec）
 
 流程: 解析契约头 → 有platform_spec_id走update/无走create → confirm → 回写幂等锚
-传输: POST /mcp direct JSON-RPC + X-MCP-Token（同 engine/poller.py:_mcp_call）
+传输: POST /mcp direct JSON-RPC + X-MCP-Token 头
 """
 from __future__ import annotations
 import json, os, re, sys, urllib.request, urllib.error
@@ -24,8 +24,8 @@ def _load_mcp_config() -> dict:
         repo = get_repo_root()
     except Exception:
         repo = Path(__file__).resolve().parent.parent.parent.parent.parent
-    for cand in [repo / "mcp_config.json",
-                 repo / ".qoder" / "mcp_config.json"]:
+    for cand in [repo / ".qoder" / "mcp_config.json",  # ★ switch_project 写这里，优先（同 return_to_platform，否则可能读到 repo/ 旧文件）
+                 repo / "mcp_config.json"]:
         try:
             if cand.is_file():
                 with open(cand, encoding="utf-8") as f:
@@ -48,7 +48,7 @@ def _resolve_endpoint() -> Tuple[str, str, str]:
                 u = srv.get("url", "")
                 if "/mcp" in u:
                     base = u.split("/mcp")[0]; break
-    base = (base or "http://127.0.0.1:10010").rstrip("/")
+    base = (base or os.environ.get("WLKJ_BASE_URL", "http://10.89.7.120")).rstrip("/")
     token = os.environ.get("WLKJ_MCP_TOKEN", "")
     if not token:
         for srv in (cfg.get("mcpServers") or {}).values():

package/templates/qoder/scripts/domain/kg/build/build_entity_registry.py

@@ -1,17 +1,6 @@
 # -*- coding: utf-8 -*-
 """build_entity_registry.py — 从 ui-modules + code-api 构建 entity-registry.json。
 
-# v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
-import os as _o, sys as _s
-_f = _o.path.abspath(__file__)
-for _ in range(10):
-    _f = _o.path.dirname(_f)
-    _cp = _o.path.join(_f, 'foundation')
-    if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
-        break
-if _cp not in _s.path: _s.path.insert(0, _cp)
-from bootstrap import setup; setup()
-
 产出 data/index/_build_cache/entity-registry.json, 供 kg_duckdb 导入 entities/aliases 表,
 让 kg.py feature <功能名> 能返回功能画像。
 
@@ -34,6 +23,18 @@ from bootstrap import setup; setup()
 业务流程) 由 build_relations.py/build_features.py/build_workflows.py 补充,
 那些脚本未实现时不影响本脚本的 entity 基础层。
 """
+# v3.0 路径自举: 引导到 foundation/bootstrap, 统一 sys.path 逻辑
+# ⚠ 必须在 module docstring 之外! 旧版把这块包进 docstring → bootstrap 永不执行 → 跑死。
+import os as _o, sys as _s
+_f = _o.path.abspath(__file__)
+for _ in range(10):
+    _f = _o.path.dirname(_f)
+    _cp = _o.path.join(_f, 'foundation')
+    if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
+        break
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+
 import json
 import os
 import sys
@@ -41,7 +42,6 @@ from datetime import datetime
 
 # 路径自适应 (和兄弟脚本一致)
 THIS_DIR = os.path.dirname(os.path.abspath(__file__))
-sys.path.insert(0, os.path.join(THIS_DIR, '..'))
 from foundation.core.paths import DATA_INDEX_DIR, BUILD_CACHE_DIR
 
 

package/templates/qoder/scripts/domain/kg/build/build_relations.py

@@ -1,17 +1,6 @@
 # -*- coding: utf-8 -*-
 """build_relations.py — 从 trace-chain + code-api 推导关系边, 生成 relations.json。
 
-# v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
-import os as _o, sys as _s
-_f = _o.path.abspath(__file__)
-for _ in range(10):
-    _f = _o.path.dirname(_f)
-    _cp = _o.path.join(_f, 'foundation')
-    if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
-        break
-if _cp not in _s.path: _s.path.insert(0, _cp)
-from bootstrap import setup; setup()
-
 产出 data/index/_build_cache/relations.json, 供 kg_duckdb 导入 edges 表,
 让 kg.py feature 的端点/按钮数据非零, kg.py hop 多跳遍历有边可走。
 
@@ -32,13 +21,24 @@ from bootstrap import setup; setup()
   - code-api.json: {endpoint: controller_file} (api_to_controller 直接用)
   - test-assertions.json: tests (controller_to_tests 推导)
 """
+# v3.0 路径自举: 引导到 foundation/bootstrap, 统一 sys.path 逻辑
+# ⚠ 必须在 module docstring 之外! 旧版把这块包进 docstring → bootstrap 永不执行 → 跑死。
+import os as _o, sys as _s
+_f = _o.path.abspath(__file__)
+for _ in range(10):
+    _f = _o.path.dirname(_f)
+    _cp = _o.path.join(_f, 'foundation')
+    if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
+        break
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+
 import json
 import os
 import sys
 from datetime import datetime
 
 THIS_DIR = os.path.dirname(os.path.abspath(__file__))
-sys.path.insert(0, os.path.join(THIS_DIR, '..'))
 from foundation.core.paths import DATA_INDEX_DIR, BUILD_CACHE_DIR
 
 

package/templates/qoder/scripts/domain/kg/graph/kg_semantic.py

@@ -278,6 +278,31 @@ def build_embeddings(batch_size=64):
         con.close()
 
 
+def _cloud_rag_search(query, top_k=10):
+    """云优先语义搜索：调工作台 MCP rag_search（本地无 KG/embedding，全迁云）。
+
+    Returns:
+        [(entity_id, text, score), ...] 或 None（云不可用时返回 None，让调用方退本地）。
+    """
+    try:
+        from domain.kg.search._remote import call_remote
+        data = call_remote("rag_search", {"query": query, "top_k": top_k})
+    except Exception:
+        return None
+    items = data.get("items") or []
+    out = []
+    for it in items[:top_k]:
+        eid = it.get("entity_id") or it.get("id") or ""
+        text = it.get("text") or it.get("name") or ""
+        score = it.get("score")
+        try:
+            score = float(score) if score is not None else 0.0
+        except Exception:
+            score = 0.0
+        out.append((eid, text, score))
+    return out
+
+
 def semantic_search(query, top_k=10):
     """语义搜索: query→向量→余弦相似度→top_k 实体。
 
@@ -656,13 +681,24 @@ if __name__ == '__main__':
         n = build_embeddings()
         print('Built %d embeddings' % n)
 
-    elif len(sys.argv) > 2 and sys.argv[1] == 'search':
-        results = semantic_search(sys.argv[2])
+    elif (len(sys.argv) > 2 and sys.argv[1] == 'search') or \
+         (len(sys.argv) > 1 and sys.argv[1] not in ('--check', '--label', 'build-embeddings', '--status', '--backfill-cn')):
+        # 兼容两种姿势: `search <词>` 和裸词 `<词>`（wlkj.py semantic 保险异常 透传过来）。
+        # ★ 云优先：本地无 KG/embedding（全迁云），先调云 rag_search；云不可用才退本地 semantic_search。
+        query = sys.argv[2] if sys.argv[1] == 'search' else sys.argv[1]
+        results = _cloud_rag_search(query)
+        if results is None:
+            # 云不可用 → 退本地（开发期有本地 embedding 时仍可用）
+            results = semantic_search(query)
         if results:
-            for eid, text, score in results:
-                print('  %.3f  %s' % (score, text[:70]))
+            for row in results:
+                if len(row) == 3:
+                    eid, text, score = row
+                    print('  %.3f  %s' % (score, text[:70]))
+                else:
+                    print('  %s' % row)
         else:
-            print('(无结果或 embedding 未构建)')
+            print('(无结果或云 rag_search 不可用 + 本地 embedding 未构建)')
 
     elif len(sys.argv) > 1 and sys.argv[1] == '--status':
         st = embedding_status()

package/templates/qoder/scripts/domain/kg/kg.py

@@ -872,6 +872,20 @@ def main(argv=None):
         return 0
     cmd = argv[0]
     rest = argv[1:]
+    # ★ MCP 名兼容：AI 常把 MCP 工具名(search_code)当 kg.py 子命令调 → "未知子命令"。
+    # 在此统一归一化，AI 猜哪个名（kg.py 子命令 / MCP 工具名）都能命中（治工作流混名）。
+    _MCP_ALIASES = {
+        'search_code': 'search', 'search_api': 'api', 'search_prds': 'prd',
+        'search_field': 'search', 'search_style': 'search', 'search_wiki': 'wiki',
+        'rag_search': 'semantic', 'ask_corpus': 'semantic',
+        'context_pack': 'context', 'context_360': 'context360',
+        'get_impact': 'impact', 'multi_hop': 'hop',
+        'coverage_matrix': 'coverage', 'feature_overview': 'feature',
+        'get_workflow': 'workflow', 'get_design_system': 'design-system',
+        'fill_prototype': 'fill-prototype',
+    }
+    if cmd in _MCP_ALIASES:
+        cmd = _MCP_ALIASES[cmd]
     # 查找子命令
     handler = None
     for name, fn, _ in COMMANDS:

package/templates/qoder/scripts/domain/kg/switch_project.py

@@ -6,7 +6,7 @@
     python switch_project.py --email a@b.c --pw xxx  # 非交互：直接指定
     python switch_project.py --project-uuid <UUID>   # 非交互：直接指定项目
 
-需工作台后端在跑（默认 http://127.0.0.1:10010）。
+需工作台后端在跑（默认 http://10.89.7.120 云）。
 """
 import json
 import os
@@ -33,7 +33,7 @@ def _find_config_path():
 CONFIG_PATH = _find_config_path()
 
 # 平台地址（默认 10010，可 env 覆盖）
-BASE_URL = os.environ.get("WLKJ_BASE_URL", "http://127.0.0.1:10010")
+BASE_URL = os.environ.get("WLKJ_BASE_URL", "http://10.89.7.120")
 
 
 def bind(email, password, base_url=BASE_URL):

package/templates/qoder/scripts/domain/task/wlkj_panel.py

@@ -51,9 +51,118 @@ from foundation.integrations.zentao_client import ZentaoClient
 # ============================================================
 
 def _zentao_creds():
-    """构建禅道客户端。凭据不全返回 None。
-    url 来自 .qoder/config.yaml (团队共享); user/password 来自 secrets/zentao.env (个人)。"""
-    return ZentaoClient.from_config()
+    """构建禅道客户端。返回 (client, preset_account)。
+
+    凭据源优先级：
+      ① 云平台 per-user 凭据（Option A：get_zentao_creds）—— account 已知（preset）
+      ② 本地 .qoder/config.yaml + secrets/zentao.env —— account 走 member.json
+    云凭据优先：demo 机器在内网可达禅道，平台凭据比本地文件更可能是最新配的。
+    凭据全无 → (None, '')。
+    """
+    c = _cloud_zentao_creds()
+    if c and c.get('ok') and c.get('url') and c.get('account') and c.get('password'):
+        try:
+            return ZentaoClient(c['url'], c['account'], c['password']), c['account']
+        except Exception:
+            pass
+    return ZentaoClient.from_config(), ''
+
+
+def _cloud_my_panel():
+    """云优先：调平台 get_my_zentao_panel（凭据走平台 per-user 配置，不出平台）。
+
+    直连云 /mcp JSON-RPC（读 .qoder/mcp_config.json 的 token+url）。
+    Returns: {ok:True, tasks, bugs, stories, account} 或 None（云不可达/工具失败）。
+    云返 {ok:False,error}（未配置/登录失败）→ 返该 dict（调用方据此提示+回退本地）。
+    """
+    import json as _json
+    import urllib.request as _u
+    import urllib.error as _ue
+    # 定位 mcp_config.json（switch_project 写在 .qoder/）
+    cfg_candidates = []
+    try:
+        from foundation.core.paths import get_repo_root
+        cfg_candidates.append(os.path.join(str(get_repo_root()), '.qoder', 'mcp_config.json'))
+    except Exception:
+        pass
+    cfg_candidates.append(os.path.join(_SCRIPTS, '..', 'mcp_config.json'))
+    token, url = '', ''
+    for cp in cfg_candidates:
+        try:
+            with open(cp, encoding='utf-8') as f:
+                cfg = _json.load(f)
+            srv = (cfg.get('mcpServers') or {}).get('wlinkj-knowledge') or {}
+            token = srv.get('token', '')
+            url = (srv.get('url') or '').rstrip('/')
+            if token and url:
+                break
+        except Exception:
+            continue
+    if not token or not url:
+        return None  # 云未绑定（switch_project 没跑）→ 回退本地
+    endpoint = url if url.endswith('/mcp') else url + '/mcp'
+    body = _json.dumps({"jsonrpc": "2.0", "id": 1, "method": "tools/call",
+                        "params": {"name": "get_my_zentao_panel", "arguments": {}}}).encode('utf-8')
+    req = _u.Request(endpoint, data=body, method='POST')
+    req.add_header('Content-Type', 'application/json')
+    req.add_header('X-MCP-Token', token)
+    try:
+        with _u.urlopen(req, timeout=30) as resp:
+            r = _json.loads(resp.read().decode('utf-8', errors='replace'))
+    except Exception:
+        return None  # 网络不通 → 回退本地
+    try:
+        text = r.get('result', {}).get('content', [{}])[0].get('text', '')
+        data = _json.loads(text) if text else {}
+    except Exception:
+        return None
+    return data  # {ok:True/False, ...}
+
+
+def _cloud_zentao_creds():
+    """Option A：从平台取禅道凭据（url/account/password 解密）。
+
+    用途：云到禅道被防火墙挡（my-panel 登录失败）时，本机（demo 机器，内网可达）
+    用平台凭据直连禅道拉真实数据。凭据随绑定 token 取本人配置（同信任级）。
+    Returns: {ok:True, url, account, password} 或 None（云不可达/未配置）。
+    """
+    import json as _json
+    import urllib.request as _u
+    cfg_candidates = []
+    try:
+        from foundation.core.paths import get_repo_root
+        cfg_candidates.append(os.path.join(str(get_repo_root()), '.qoder', 'mcp_config.json'))
+    except Exception:
+        pass
+    cfg_candidates.append(os.path.join(_SCRIPTS, '..', 'mcp_config.json'))
+    token, url = '', ''
+    for cp in cfg_candidates:
+        try:
+            with open(cp, encoding='utf-8') as f:
+                cfg = _json.load(f)
+            srv = (cfg.get('mcpServers') or {}).get('wlinkj-knowledge') or {}
+            token = srv.get('token', '')
+            url = (srv.get('url') or '').rstrip('/')
+            if token and url:
+                break
+        except Exception:
+            continue
+    if not token or not url:
+        return None
+    endpoint = url if url.endswith('/mcp') else url + '/mcp'
+    body = _json.dumps({"jsonrpc": "2.0", "id": 1, "method": "tools/call",
+                        "params": {"name": "get_zentao_creds", "arguments": {}}}).encode('utf-8')
+    req = _u.Request(endpoint, data=body, method='POST')
+    req.add_header('Content-Type', 'application/json')
+    req.add_header('X-MCP-Token', token)
+    try:
+        with _u.urlopen(req, timeout=15) as resp:
+            r = _json.loads(resp.read().decode('utf-8', errors='replace'))
+        text = r.get('result', {}).get('content', [{}])[0].get('text', '')
+        data = _json.loads(text) if text else {}
+        return data if data.get('ok') else None
+    except Exception:
+        return None
 
 
 def _resolve_my_account(developer):
@@ -359,26 +468,72 @@ def fetch_workbench(include_closed=False, kind=None):
     """
     developer = get_developer()
 
-    # ① 凭据
-    client = _zentao_creds()
+    # ⓪ 云优先：调平台 get_my_zentao_panel（凭据走平台 per-user，不出平台）。
+    # 成功 → 直接用云数据，跳过本地凭据/连通/归属/收集（① ~ ④）。
+    # 未配置/登录失败 → 返回 {ok:False} 提示用户去平台配置，并回退本地（本地配了仍可用）。
+    # 云不可达(返回 None) → 静默回退本地全流程。
+    cloud = _cloud_my_panel()
+    if isinstance(cloud, dict):
+        # 云可达 → 云的判断权威（平台是凭据源）。
+        if cloud.get('ok'):
+            tasks = cloud.get('tasks') or []
+            bugs = cloud.get('bugs') or []
+            stories = cloud.get('stories') or []
+            # 按 kind 裁剪（与本地一致）
+            if kind == 'tasks':
+                bugs, stories = [], []
+            elif kind == 'bugs':
+                tasks, stories = [], []
+            elif kind == 'stories':
+                tasks, bugs = [], []
+            tasks, bugs, stories = _filter_live(tasks, bugs, stories, include_closed)
+            # 云路径：数据已平台聚合，归一化即可（进度检测需本地 client，云模式跳过给默认值）
+            norm_tasks = [_norm_task(t) for t in tasks]
+            norm_bugs = [_norm_bug(b) for b in bugs]
+            norm_stories = [_norm_story(s) for s in stories]
+            for it in norm_tasks + norm_bugs + norm_stories:
+                it['progress'] = {'prd': False, 'spec': 'none', 'code': False}
+            data = {'account': cloud.get('account', ''), 'developer': developer,
+                    'current_task': None, 'tasks': norm_tasks,
+                    'bugs': norm_bugs, 'stories': norm_stories}
+            meta = {'fetched_at': datetime.now().isoformat(timespec='seconds'),
+                    'source': 'cloud',
+                    'counts': {'tasks': len(norm_tasks), 'bugs': len(norm_bugs),
+                               'stories': len(norm_stories)},
+                    'include_closed': include_closed}
+            return {'ok': True, 'data': data, 'meta': meta}, 0
+        # 云可达但失败（未配置/登录失败/防火墙）→ 记下云诊断，回退本地。
+        # 回退价值：云到禅道常被防火墙挡，但本机（demo 机器，内网）可能直连可达。
+        # 本地也失败时，把云诊断一起带出（平台有凭据但云连不上 + 本地无凭据）。
+        cloud_error = cloud.get('error', '禅道不可用')
+    else:
+        cloud_error = None  # 云不可达（switch_project 没跑/平台宕机）→ 静默回退本地
+
+    # ① 凭据（云平台优先 Option A，回退本地文件）
+    client, preset_account = _zentao_creds()
     if client is None:
-        return {'ok': False,
-                'error': '禅道凭据未配置。请检查 .qoder/config.yaml 的 zentao.url, '
-                         '及 workspace/members/<我>/.private/secrets/zentao.env 的账号密码。'}, 3
+        base_msg = ('禅道凭据未配置。推荐在【平台设置 → 禅道】配置（panel 自动走云取凭据）；'
+                    '或本地 .qoder/config.yaml 的 zentao.url + secrets/zentao.env 账号密码。')
+        if cloud_error:
+            base_msg += '（云 my-panel 失败：%s）' % cloud_error
+        return {'ok': False, 'error': base_msg}, 3
 
     ok, msg = client.credentials_ok()
     if not ok:
         return {'ok': False, 'error': '禅道凭据不完整: %s' % msg}, 3
 
-    # ② 内网连通
+    # ② 内网连通（本机能否直连禅道——demo 机器在内网可达）
     ok, msg = client.check_intranet()
     if not ok:
-        return {'ok': False, 'error': '连不上禅道内网: %s' % msg}, 5
+        return {'ok': False, 'error': '本机连不上禅道内网: %s' % msg}, 5
 
-    # ③ 归属
-    my_account, err = _resolve_my_account(developer) if developer else (None, '未识别当前开发者身份。')
-    if not my_account:
-        return {'ok': False, 'error': err}, 3
+    # ③ 归属（云凭据带的 account 优先；否则走 member.json）
+    if preset_account:
+        my_account = preset_account
+    else:
+        my_account, err = _resolve_my_account(developer) if developer else (None, '未识别当前开发者身份。')
+        if not my_account:
+            return {'ok': False, 'error': err}, 3
 
     # ④ 收集 (三域并行, 按 kind 决定取哪几域)
     from concurrent.futures import ThreadPoolExecutor

package/templates/qoder/scripts/foundation/io/context_cache.py

@@ -0,0 +1,94 @@
+"""context_cache.py — 按 REQ-id 缓存 context_pack/rag_search 结果（T1.3 跨命令上下文缓存）。
+
+PRD→spec→code 链路里同一 REQ 反复拉同一份上下文（3 次 KG/MCP 往返）→ 缓存复用，省 token + 减反复搜。
+
+存储: workspace/specs/{REQ}/.context-cache.json
+结构: {query_hash: {"query":..., "text":..., "ts":...}}
+TTL 默认 24h（PRD/spec 改动后用 invalidate(req) 显式失效）。
+
+纯模块，无外部依赖；任何异常 fail-open（缓存坏了不影响主流程，调用方降级直拉）。
+"""
+import os
+import json
+import time
+import hashlib
+
+DEFAULT_TTL = 24 * 3600  # 24h
+
+
+def _repo_root():
+    """从本文件向上找含 workspace/ 或 .qoder/ 的目录作仓库根。"""
+    d = os.path.dirname(os.path.abspath(__file__))
+    for _ in range(7):
+        if os.path.isdir(os.path.join(d, "workspace")) or os.path.isdir(os.path.join(d, ".qoder")):
+            return d
+        parent = os.path.dirname(d)
+        if parent == d:
+            break
+        d = parent
+    return os.getcwd()
+
+
+def _sanitize(req_id):
+    return "".join(c for c in str(req_id) if c.isalnum() or c in "-_") or "unknown"
+
+
+def cache_path(req_id, base=None):
+    base = base or _repo_root()
+    return os.path.join(base, "workspace", "specs", _sanitize(req_id), ".context-cache.json")
+
+
+def _load(path):
+    try:
+        with open(path, encoding="utf-8") as f:
+            data = json.load(f)
+            return data if isinstance(data, dict) else {}
+    except Exception:
+        return {}
+
+
+def _save(path, data):
+    try:
+        os.makedirs(os.path.dirname(path), exist_ok=True)
+        tmp = path + ".tmp"
+        with open(tmp, "w", encoding="utf-8") as f:
+            json.dump(data, f, ensure_ascii=False, indent=2)
+        os.replace(tmp, path)  # 原子写
+        return True
+    except Exception:
+        return False
+
+
+def _qhash(query):
+    return hashlib.md5(query.strip().lower().encode("utf-8")).hexdigest()[:12]
+
+
+def get(req_id, query, ttl=DEFAULT_TTL, base=None):
+    """命中且未过期 → 返回 text；否则 None。"""
+    data = _load(cache_path(req_id, base))
+    entry = data.get(_qhash(query))
+    if not entry:
+        return None
+    if ttl and (time.time() - float(entry.get("ts", 0))) > ttl:
+        return None
+    return entry.get("text")
+
+
+def put(req_id, query, text, base=None):
+    """写一条缓存（覆盖同 query 旧值）。"""
+    path = cache_path(req_id, base)
+    data = _load(path)
+    data[_qhash(query)] = {"query": query, "text": text, "ts": time.time()}
+    return _save(path, data)
+
+
+def invalidate(req_id, base=None):
+    """清整个 REQ 的缓存（PRD/spec 改动后调）。"""
+    return _save(cache_path(req_id, base), {})
+
+
+def stats(req_id, base=None):
+    """缓存条数 + query 摘要（调试/观测命中率用）。"""
+    data = _load(cache_path(req_id, base))
+    return {"entries": len(data),
+            "queries": [str(e.get("query", ""))[:40] for e in data.values()]}