@hupan56/wlkj 3.1.32 → 3.3.0

package/templates/qoder/scripts/capability/registry.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-nexus.registry —— 宿主发现 + Nexus Facade。
+capability.registry —— 宿主发现 + Nexus Facade。
 
 设计模式:
     - Registry（HOST_TABLE 单一事实源，泛化 common.active_task._ENV_SESSION_KEYS）
@@ -8,7 +8,7 @@ nexus.registry —— 宿主发现 + Nexus Facade。
     - Bridge（Cap 抽象 × 宿主实现 正交）
 
 主轴: 工作流面向能力编程，不面向宿主。
-    cap = nexus.resolve()
+    cap = resolve()
     cap.memory.recall(...)   # 不管在 QoderWork 还是 CLI，同一行代码
 """
 from __future__ import annotations
@@ -36,26 +36,24 @@ from .caps import (
 # =============================================================================
 
 HOST_TABLE: dict[str, dict] = {
-    # ── Qoder 产品线（第一宿主系列）─────────────────────────────
+    # ── Qoder 系列（第一宿主系列，2026-07 对齐最新产品线）─────────────
+    # 主开发宿主 + 办公产品。（Qoder CLI / Cloud Agents 后续按需再加；QoderWake 架构性不接。）
+    #   features = 引擎已接（非 NoOp adapter）；native = 产品原生能力（仅建模，不算实现）。
+    "qoder-desktop": {
+        # Qoder 1.0 "Autonomous Development Desktop"（原 qoder-ide；Quest Window/Agent Mode 是其模式，故原 qoder-quest 合并于此）
+        "detect": ("QODER_DESKTOP", "QODER_IDE"),
+        "features": ("mcp", "memory", "cron", "present"),
+        "native": ("agent-mode", "context-engine", "vm-sandbox", "hooks", "skills", "mcp-sse"),
+        "mcp_servers": ["qoder-knowledge-graph", "qoder-zentao", "qoder-mysql", "lanhu"],
+        "note": "Qoder Desktop/IDE 1.0（主开发宿主；Quest 是其模式，非独立宿主）",
+    },
     "qoder-work": {
+        # QoderWork：办公产品（非开发者，文档/报告/PPT/M365）。~/.qoderwork/ 投影 + qoder_show_widget 是其接入点。
         "detect": ("QODER_SESSION_ID",),
-        # features = 当前已实现 (非 NoOp) 的能力。notify/present/sandbox 暂无
-        # 宿主原生 Adapter，声明即误报可用，故不列。后续补齐 Adapter 再加。
-        "features": ("mcp", "memory", "cron"),
+        "features": ("mcp", "memory", "cron", "present"),
+        "native": ("office-agent", "m365", "human-in-loop", "hooks", "show-widget"),
         "mcp_servers": ["qoder-knowledge-graph", "qoder-zentao", "qoder-mysql", "lanhu"],
-        "note": "QoderWork 桌面 Agent，全能力",
-    },
-    "qoder-ide": {
-        "detect": ("QODER_IDE",),
-        "features": ("mcp", "memory"),
-        "mcp_servers": ["qoder-knowledge-graph", "qoder-zentao", "qoder-mysql"],
-        "note": "Qoder IDE (VSCode 扩展)",
-    },
-    "qoder-quest": {
-        "detect": ("QODER_QUEST",),
-        "features": ("mcp", "memory"),
-        "mcp_servers": ["qoder-knowledge-graph", "qoder-zentao"],
-        "note": "Qoder Quest，自然语言入口",
+        "note": "QoderWork 桌面办公 Agent（非开发者；文档/PPT/M365）；~/.qoderwork/ 投影入口",
     },
     # ── 其他宿主（通用 AI 工具）────────────────────────────────
     "codex": {
@@ -124,7 +122,7 @@ def detect_host() -> str:
 class Nexus:
     """宿主能力 Facade —— 聚合所有能力，对外统一入口。
 
-    工作流永远只调 nexus.resolve() 拿到本对象，再访问 .memory/.mcp/...，
+    工作流永远只调 resolve() 拿到本对象，再访问 .memory/.mcp/...，
     不直接 import 任何 adapter（Facade 模式）。
     """
 
@@ -202,8 +200,8 @@ def _resolve_notify(host: str):
 
 
 def _resolve_present(host: str):
-    """L2 富展示 —— QoderWork 调 qoder_show_widget 嵌入对话; 其余 NoOp 降级表格。"""
-    if host in ("qoder-work", "qoder-ide"):
+    """L2 富展示 —— Qoder Desktop/Work 调 qoder_show_widget 嵌入对话; 其余 NoOp 降级表格。"""
+    if host in ("qoder-desktop", "qoder-work"):
         try:
             from .adapters.qw import QwPresentCap
             return QwPresentCap()
@@ -227,7 +225,7 @@ def _resolve_mcp(host: str):
 def resolve() -> Nexus:
     """解析当前环境，返回 Nexus Facade。
 
-    一行入口: cap = nexus.resolve()
+    一行入口: cap = resolve()
     内部: detect_host → 按宿主装配各 Cap → 注入 NoOp 兜底。
     工作流代码零宿主感知。
     """

package/templates/qoder/scripts/capability/registry_mcp.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-nexus.registry_mcp —— MCP 工具路由（tool → server → transport）。
+capability.registry_mcp —— MCP 工具路由（tool → server → transport）。
 
 设计模式: Registry + Strategy（配合 transports 层）
 
@@ -34,11 +34,25 @@ from protocol.transports import get_transport, Transport, NoOpTransport, ToolRes
 # 未来改这里即可切换部署形态，工作流零改动。
 # =============================================================================
 
+# =============================================================================
+# mcp_config.json 消费 —— 让配置文件真正生效（单一事实源）
+# -----------------------------------------------------------------------------
+# 历史 bug: mcp_config.json / registry_mcp_config.json 是"死配置"（全仓 0 读取），
+# registry 用硬编码 SERVERS。改配置文件不生效。
+# 现在: 优先读 wlinkj-workflow/mcp_config.json 的 mcpServers，读不到才 fallback。
+# =============================================================================
+# 配置文件中知识层 server 的别名映射（统一命名，两边都支持）：
+#   mcp_config.json 里叫 "wlinkj-knowledge"，本地硬编码叫 "qoder-knowledge-graph"。
+#   让 _load_servers 把 config 的 server 也注册成 "qoder-knowledge-graph" 别名，
+#   这样反向索引 / 显式 server 调用两边名字都能命中。
+_KNOWLEDGE_SERVER_ALIASES = ["wlinkj-knowledge", "qoder-knowledge-graph"]
+
+# 硬编码 fallback（配置文件读不到时兜底，保证引擎不崩）
 SERVERS: dict[str, dict] = {
     "qoder-knowledge-graph": {
-        "kind": "stdio",
-        "launcher_arg": "kg",
-        "note": "知识图谱。本地分发；未来可上服务器 → 改 kind=http + url",
+        "kind": "http",
+        "url": "http://127.0.0.1:10010/mcp",
+        "note": "知识图谱。已改为 http 模式，指向资产平台 MCP 服务（POST /mcp JSON-RPC）",
     },
     "qoder-zentao": {
         "kind": "stdio",
@@ -58,6 +72,55 @@ SERVERS: dict[str, dict] = {
 }
 
 
+def _mcp_config_path() -> Path:
+    """定位 wlinkj-workflow/mcp_config.json（在仓库根下）。"""
+    repo = _get_repo_root()
+    # registry_mcp.py 在 .../scripts/capability/, mcp_config.json 在 wlinkj-workflow/
+    # 仓库根可能就是 wlinkj-workflow/, 或是其上层。两级查找。
+    for cand in [
+        repo / "mcp_config.json",
+        repo / "wlinkj-workflow" / "mcp_config.json",
+        repo / "registry_mcp_config.json",
+    ]:
+        if cand.is_file():
+            return cand
+    return repo / "mcp_config.json"
+
+
+def _load_servers() -> dict[str, dict]:
+    """从 mcp_config.json 加载 mcpServers，合并到硬编码 SERVERS 上。
+
+    配置文件优先（改配置真生效），硬编码兜底（配置缺失也不崩）。
+    同时把知识层 server 注册多个别名（wlinkj-knowledge / qoder-knowledge-graph），
+    让引擎用任一名字都能调到。
+    """
+    import json as _json
+
+    merged: dict[str, dict] = {k: dict(v) for k, v in SERVERS.items()}
+    try:
+        cfg_path = _mcp_config_path()
+        if not cfg_path.is_file():
+            return merged
+        with open(cfg_path, encoding="utf-8") as f:
+            cfg = _json.load(f)
+        mcp_servers = cfg.get("mcpServers") or {}
+        for name, spec in mcp_servers.items():
+            if not isinstance(spec, dict):
+                continue
+            # 剥离 _comment / _usage 等说明字段，只留 kind/url/token/env/launcher_arg/note
+            clean = {k: v for k, v in spec.items() if not k.startswith("_")}
+            # 知识层 server: 注册全部别名，都指向同一份配置
+            if name in _KNOWLEDGE_SERVER_ALIASES:
+                for alias in _KNOWLEDGE_SERVER_ALIASES:
+                    merged[alias] = clean
+            else:
+                merged[name] = clean
+    except Exception:
+        # 读配置失败绝不能让引擎崩 —— 退回硬编码
+        pass
+    return merged
+
+
 def _get_repo_root() -> Path:
     """从 common.paths 获取仓库根（复用既有工具，不重复造轮子）。"""
     try:
@@ -76,7 +139,8 @@ class McpRegistry:
 
     def __init__(self, repo_root: Optional[Path] = None, servers: Optional[dict] = None):
         self._repo = repo_root or _get_repo_root()
-        self._servers = servers if servers is not None else SERVERS
+        # 默认从 mcp_config.json 加载（改配置真生效），显式传 servers 时覆盖
+        self._servers = servers if servers is not None else _load_servers()
         self._pool: dict[str, Transport] = {}
         self._tool_to_server: Optional[dict[str, str]] = None  # 懒构建
         self._index_lock_built = False

package/templates/qoder/scripts/capability/smoke_test_report.json

@@ -1,24 +1,24 @@
 {
-  "timestamp": "2026-06-29 11:20:28",
+  "timestamp": "2026-07-02 11:13:44",
   "servers": {
     "qoder-knowledge-graph": {
       "available": true,
-      "tools_indexed": 17,
-      "latency_ms": 484.0,
+      "tools_indexed": 35,
+      "latency_ms": 16.0,
       "sample_tools": [
         "search_code",
         "search_api",
-        "search_prd",
-        "get_impact",
+        "search_field",
+        "search_style",
         "context_360"
       ],
-      "spawn_pid": 66880,
+      "spawn_pid": null,
       "status": "PASS"
     },
     "qoder-zentao": {
       "available": true,
       "tools_indexed": 68,
-      "latency_ms": 766.0,
+      "latency_ms": 1625.0,
       "sample_tools": [
         "check_zentao_status",
         "get_zentao_url",
@@ -26,13 +26,13 @@
         "get_product",
         "create_product"
       ],
-      "spawn_pid": 48620,
+      "spawn_pid": 76064,
       "status": "PASS"
     },
     "qoder-mysql": {
       "available": true,
       "tools_indexed": 6,
-      "latency_ms": 609.0,
+      "latency_ms": 500.0,
       "sample_tools": [
         "list_envs",
         "query_schema",
@@ -40,13 +40,13 @@
         "query_distinct",
         "list_databases"
       ],
-      "spawn_pid": 67572,
+      "spawn_pid": 26784,
       "status": "PASS"
     },
     "lanhu": {
       "available": true,
       "tools_indexed": 13,
-      "latency_ms": 3313.0,
+      "latency_ms": 4906.0,
       "sample_tools": [
         "lanhu_resolve_invite_link",
         "lanhu_list_product_documents",
@@ -54,14 +54,28 @@
         "lanhu_get_ai_analyze_page_result",
         "lanhu_get_designs"
       ],
-      "spawn_pid": 32460,
+      "spawn_pid": 14148,
+      "status": "PASS"
+    },
+    "wlinkj-knowledge": {
+      "available": true,
+      "tools_indexed": 35,
+      "latency_ms": 32.0,
+      "sample_tools": [
+        "search_code",
+        "search_api",
+        "search_field",
+        "search_style",
+        "context_360"
+      ],
+      "spawn_pid": null,
       "status": "PASS"
     }
   },
   "call_tool": {
     "status": "PASS",
-    "latency_ms": 3547.0,
-    "text_preview": "Chinese: 保险 -> English: ins insurance vehlife/insurance\n\n[Carmg-H5] 12 files\n  Carmg-H5/src/.../main/List.vue  ->  data/code/Carmg-H5/src/modules/icsAbnormalCenter/module/main/List.vue\n  Carmg-H5/src/",
+    "latency_ms": 7281.0,
+    "text_preview": "{\"query\": \"保险\", \"platform\": null, \"module\": null, \"total\": 1, \"items\": [{\"type\": \"BUTTON\", \"name\": \"history\", \"label\": \"保险记录\"}]}",
     "is_error": false
   },
   "memory": {
@@ -69,13 +83,13 @@
     "providers": [
       {
         "provider": "McpMemoryProvider",
-        "available": true,
-        "hit": true
+        "available": false,
+        "hit": false
       },
       {
         "provider": "FileMemoryCap",
         "available": true,
-        "hit": false
+        "hit": true
       },
       {
         "provider": "NoOpMemoryCap",
@@ -87,8 +101,8 @@
   },
   "summary": {
     "all_pass": true,
-    "active_servers": 4,
-    "total_servers": 4,
-    "total_tools": 104
+    "active_servers": 5,
+    "total_servers": 5,
+    "total_tools": 157
   }
 }

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

@@ -3,7 +3,9 @@
 """carriers.py - 四载体一致性 (Facade 外观模式)
 
 v3.0 合并自: check_carriers + check_qoderwork_consistency + sync_carriers。
-四载体: Qoder IDE / Quest / CLI / QoderWork。三者都是"四载体"这一个领域,
+四载体 = 命令/技能的 4 个部署面: Qoder Desktop(含 Quest 模式) / CLI / QoderWork / npm 镜像。
+注意: 这是"部署面"轴，与 capability/registry.py:HOST_TABLE 的"宿主产品"轴正交
+(HOST_TABLE 现列 desktop/work；cli/cloud 后续按需)。
 对外应是 1 个 carriers 命令的子操作 (Facade: 多个细粒度检查统一入口)。
 
 用法:

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

@@ -485,7 +485,11 @@ def check_index(fix):
     print('\n--- 5. 知识图谱 (data/index/) ---')
     age = index_age_days()
     if age is None:
-        # 完全缺失 → 先尝试 team_sync pull 拉管理员建好的 kg.duckdb
+        # 全迁 PG 后 kg.duckdb 废弃：环境配了 PG → 知识层在平台，不报缺失
+        if os.environ.get('KNOWLEDGE_BACKEND', '').lower() == 'pg' or 'postgresql' in os.environ.get('DATABASE_URL', ''):
+            say(OK, '知识层在平台 PostgreSQL（KNOWLEDGE_BACKEND=pg / DATABASE_URL=pg，不依赖本地 kg.duckdb）')
+            return
+        # 完全缺失（非 PG 环境）→ 先尝试 team_sync pull 拉管理员建好的 kg.duckdb
         if fix:
             print('       索引缺失, 先从团队仓库拉取 (team_sync pull)...')
             if run_script('team_sync.py', 'pull', timeout=120):
@@ -549,7 +553,8 @@ def check_style(fix):
         else:
             problem(fname + ' 缺失', '该文件提交在 git 中, 先解决团队同步 (team_sync pull)')
 
-    # kg.duckdb 知识图谱 (统一存储)
+    # kg.duckdb 知识图谱 (统一存储) — 全迁 PG 后知识层在平台，本地 duckdb 废弃
+    _pg_mode = os.environ.get('KNOWLEDGE_BACKEND', '').lower() == 'pg' or 'postgresql' in os.environ.get('DATABASE_URL', '')
     kg_path = os.path.join(INDEX_DIR, 'kg.duckdb')
     role = ''
     try:
@@ -561,7 +566,9 @@ def check_style(fix):
     except Exception:
         pass
 
-    if os.path.isfile(kg_path):
+    if _pg_mode:
+        say(OK, '知识层在平台 PostgreSQL（不依赖本地 kg.duckdb）')
+    elif os.path.isfile(kg_path):
         say(OK, 'kg.duckdb 知识图谱 (%d KB)' % (os.path.getsize(kg_path) // 1024))
         # 过期检测
         import time as _t

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/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())
+