@hupan56/wlkj 3.2.0 → 3.3.1

package/templates/qoder/scripts/capability/caps/notify.py

@@ -11,6 +11,9 @@ NotifyCap —— IM 通知能力契约。
 """
 from __future__ import annotations
 
+import json
+import os
+import urllib.request
 from typing import Protocol, runtime_checkable
 
 
@@ -39,3 +42,64 @@ class NoOpNotifyCap:
 
     def list_channels(self) -> list[dict]:
         return []
+
+
+class WebhookNotifyCap:
+    """真实通知 adapter（#17）：POST 消息到配置的 IM webhook（飞书/企业微信/钉钉）。
+
+    webhook 从 env WLKJ_NOTIFY_WEBHOOKS 解析：
+      "default=https://open.feishu.cn/...,review=https://..." 或 JSON '{"default":"..."}'
+    用 stdlib urllib（宿主脚本可能无 httpx/requests），POST 通用 text payload。
+    available 仅当至少配了一个 webhook，否则 False（优雅降级 NoOp，不谎报）。
+    """
+
+    def __init__(self) -> None:
+        self._channels: dict[str, str] = self._load()
+
+    def _load(self) -> dict[str, str]:
+        raw = os.environ.get("WLKJ_NOTIFY_WEBHOOKS", "").strip()
+        if not raw:
+            return {}
+        if raw.startswith("{"):  # JSON 形式
+            try:
+                d = json.loads(raw)
+                return {str(k): str(v) for k, v in d.items() if v}
+            except Exception:
+                return {}
+        out: dict[str, str] = {}
+        for pair in raw.split(","):
+            if "=" in pair:
+                k, v = pair.split("=", 1)
+                k, v = k.strip(), v.strip()
+                if v:
+                    out[k] = v
+        return out
+
+    @property
+    def available(self) -> bool:
+        return len(self._channels) > 0
+
+    def send(self, channel: str, message: str) -> bool:
+        url = self._channels.get(channel) or self._channels.get("default")
+        if not url:
+            return False
+        try:
+            # 通用 text payload（飞书 msg_type/content；钉钉/企微也兼容 text 字段）
+            payload = json.dumps({"msg_type": "text", "content": {"text": message}}).encode("utf-8")
+            req = urllib.request.Request(url, data=payload,
+                                         headers={"Content-Type": "application/json"})
+            with urllib.request.urlopen(req, timeout=5) as r:
+                return getattr(r, "status", 200) == 200
+        except Exception:
+            return False  # IM 不可达不阻塞工作流
+
+    def list_channels(self) -> list[dict]:
+        return [{"channel": k, "configured": bool(v)} for k, v in self._channels.items()]
+
+
+def default_notify() -> NotifyCap:
+    """工厂：配了 webhook→WebhookNotifyCap；否则 NoOpNotifyCap。"""
+    cap = WebhookNotifyCap()
+    if cap.available:
+        return cap  # type: ignore[return-value]
+    return NoOpNotifyCap()  # type: ignore[return-value]

package/templates/qoder/scripts/capability/caps/sandbox.py

@@ -13,6 +13,8 @@ SandboxCap —— 安全执行能力契约。
 """
 from __future__ import annotations
 
+import os
+import subprocess
 from typing import Protocol, runtime_checkable
 
 
@@ -41,3 +43,39 @@ class NoOpSandboxCap:
 
     def approval_mode(self) -> str:
         return "suggest"
+
+
+class SubprocessSandboxCap:
+    """真实沙箱 adapter（#17）：子进程执行 + 超时强杀 + stdout/stderr/returncode 捕获。
+
+    无 docker 时的进程级隔离（超时强杀 + 输出捕获 + cwd 隔离），全平台可用。
+    docker 容器级隔离（FS/网络限制）后续可加 DockerSandboxCap，工厂按 env 切换。
+    available=True（subprocess 全平台可用）。
+    """
+
+    available = True
+
+    def run(self, command: str, cwd: str | None = None, timeout: int = 60) -> dict:
+        try:
+            # errors='replace' 健壮化：Windows 命令常输出 GBK 中文，UTF-8 解码会崩；
+            # replace 不崩（个别字符显示?），比 exec_error 丢全部输出好。
+            p = subprocess.run(command, shell=True, cwd=cwd, timeout=timeout,
+                               capture_output=True, text=True, errors="replace")
+            return {"ok": p.returncode == 0, "stdout": p.stdout,
+                    "stderr": p.stderr, "returncode": p.returncode}
+        except subprocess.TimeoutExpired:
+            return {"ok": False, "reason": "timeout(%ds)" % timeout, "returncode": -1}
+        except Exception as e:  # 命令不存在 / 权限 等
+            return {"ok": False, "reason": "exec_error: %s" % str(e)[:200], "returncode": -1}
+
+    def approval_mode(self) -> str:
+        return os.environ.get("WLKJ_APPROVAL_MODE", "suggest")
+
+
+def default_sandbox() -> SandboxCap:
+    """工厂：env WLKJ_SANDBOX=off→NoOp；docker(占位)→Subprocess 兜底；默认 Subprocess。"""
+    mode = os.environ.get("WLKJ_SANDBOX", "subprocess").lower()
+    if mode == "off":
+        return NoOpSandboxCap()  # type: ignore[return-value]
+    # docker 模式暂未实现容器隔离，先兜底 Subprocess（避免谎报容器级安全）
+    return SubprocessSandboxCap()  # type: ignore[return-value]

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

@@ -0,0 +1,68 @@
+# -*- coding: utf-8 -*-
+"""present_html.py — 富展示 HTML 统一入口（cap.present 双轨）。
+
+模式（抄 usability_score.py --html）：
+  1. QoderWork（cap.present.available）→ cap.present.widget(html) 嵌入对话流
+  2. 降级 → 落盘 workspace/members/{dev}/journal/{name}-{ts}.html
+  3. 最终兜底 → stdout
+
+所有命令的富展示（impact/coverage/feature/report 看板）统一调 present(html, name)，
+不在各自脚本重复 widget+落盘逻辑。复用点：caps/present.py PresentCap + adapters/qw.py QwPresentCap。
+"""
+import os
+import sys
+from pathlib import Path
+
+
+def _resolve_repo(repo_root=None):
+    if repo_root:
+        return Path(repo_root)
+    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 _read_dev(repo):
+    f = repo / ".qoder" / ".developer"
+    if f.is_file():
+        for line in f.read_text(encoding="utf-8").splitlines():
+            if "name=" in line:
+                return line.split("name=", 1)[1].strip().split()[0]
+    return os.environ.get("QODER_DEV", "") or "shared"
+
+
+def present(html, name="dashboard", repo_root=None, dev=None):
+    """展示 HTML：QoderWork 嵌入对话；降级落盘 journal；兜底 stdout。返回 (sinked, path)。"""
+    repo = _resolve_repo(repo_root)
+    # 1. QoderWork widget（富宿主嵌入对话流）
+    try:
+        scripts_dir = str(repo / ".qoder" / "scripts")
+        if scripts_dir not in sys.path:
+            sys.path.insert(0, scripts_dir)
+        from capability.registry import resolve
+        cap = resolve()
+        if getattr(cap.present, "available", False):
+            if cap.present.widget(html):
+                return True, None
+    except Exception:
+        pass
+    # 2. 降级落盘
+    try:
+        out_dev = dev or _read_dev(repo)
+        out = repo / "workspace" / "members" / out_dev / "journal"
+        out.mkdir(parents=True, exist_ok=True)
+        from datetime import datetime
+        import re
+        safe_name = re.sub(r'[\\/:*?"<>|]', "_", name)  # Windows 非法字符清洗
+        fp = out / ("%s-%s.html" % (safe_name, datetime.now().strftime("%Y%m%d-%H%M%S")))
+        fp.write_text(html, encoding="utf-8")
+        print("[HTML] 已落盘: %s" % fp)
+        return False, str(fp)
+    except Exception:
+        print(html)
+        return False, None

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 模式）。
     """
 
@@ -198,12 +196,14 @@ def _resolve_cron(host: str):
 
 
 def _resolve_notify(host: str):
-    return NoOpNotifyCap()
+    """L2 通知 —— 配了 WLKJ_NOTIFY_WEBHOOKS→WebhookNotifyCap(飞书/企微/钉钉);否则 NoOp 降级。"""
+    from .caps.notify import default_notify
+    return default_notify()
 
 
 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()
@@ -213,7 +213,9 @@ def _resolve_present(host: str):
 
 
 def _resolve_sandbox(host: str):
-    return NoOpSandboxCap()
+    """L2 安全执行 —— env WLKJ_SANDBOX≠off→SubprocessSandboxCap(进程级隔离+超时);off→NoOp。"""
+    from .caps.sandbox import default_sandbox
+    return default_sandbox()
 
 
 def _resolve_mcp(host: str):
@@ -227,7 +229,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。改配置文件不生效。
+# 现在: 优先读 .qoder/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": os.environ.get("WLKJ_BASE_URL", "http://10.89.7.120") + "/mcp",
+        "note": "知识图谱。已改为 http 模式，指向资产平台 MCP 服务（POST /mcp JSON-RPC）",
     },
     "qoder-zentao": {
         "kind": "stdio",
@@ -58,6 +72,53 @@ SERVERS: dict[str, dict] = {
 }
 
 
+def _mcp_config_path() -> Path:
+    """定位 mcp_config.json（在仓库根/宿主下）。"""
+    repo = _get_repo_root()
+    # registry_mcp.py 在 .../scripts/capability/, mcp_config.json 在宿主根（.qoder）。
+    for cand in [
+        repo / "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 +137,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