@hupan56/wlkj 3.3.15 → 3.3.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hupan56/wlkj",
-  "version": "3.3.15",
+  "version": "3.3.17",
   "description": "AI Product R&D Workflow - PRD/Prototype/Search/Task/Report",
   "bin": {
     "wlkj": "bin/cli.js"

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

@@ -51,7 +51,7 @@ _KNOWLEDGE_SERVER_ALIASES = ["wlinkj-knowledge", "qoder-knowledge-graph"]
 SERVERS: dict[str, dict] = {
     "qoder-knowledge-graph": {
         "kind": "http",
-        "url": os.environ.get("WLKJ_BASE_URL", "http://10.89.7.120") + "/mcp",
+        "url": "http://127.0.0.1:10010/mcp",
         "note": "知识图谱。已改为 http 模式，指向资产平台 MCP 服务（POST /mcp JSON-RPC）",
     },
     "qoder-zentao": {
@@ -73,22 +73,16 @@ SERVERS: dict[str, dict] = {
 
 
 def _mcp_config_path() -> Path:
-    """定位 mcp_config.json（在仓库根/宿主下）。
-
-    ★ switch_project.py 实际写入位置是 {repo}/.qoder/mcp_config.json（云模式连云 bind 后），
-    必须优先查这里——否则读不到 token，transport 用空 token 调云 MCP 鉴权失败（历史 bug：
-    引擎 search 全返回"MCP返回非JSON"+递归降级套娃）。老形态 repo/mcp_config.json 兼容。
-    """
+    """定位 mcp_config.json（在仓库根/宿主下）。"""
     repo = _get_repo_root()
     # registry_mcp.py 在 .../scripts/capability/, mcp_config.json 在宿主根（.qoder）。
     for cand in [
-        repo / ".qoder" / "mcp_config.json",     # ★ 云模式实际写入位置（switch_project）
-        repo / "mcp_config.json",                 # 老形态：仓库根
+        repo / "mcp_config.json",
         repo / "registry_mcp_config.json",
     ]:
         if cand.is_file():
             return cand
-    return repo / ".qoder" / "mcp_config.json"
+    return repo / "mcp_config.json"
 
 
 def _load_servers() -> dict[str, dict]:

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

@@ -0,0 +1,94 @@
+{
+  "timestamp": "2026-06-26 21:25:55",
+  "servers": {
+    "qoder-knowledge-graph": {
+      "available": true,
+      "tools_indexed": 17,
+      "latency_ms": 437.0,
+      "sample_tools": [
+        "search_code",
+        "search_api",
+        "search_prd",
+        "get_impact",
+        "context_360"
+      ],
+      "spawn_pid": 38616,
+      "status": "PASS"
+    },
+    "qoder-zentao": {
+      "available": true,
+      "tools_indexed": 66,
+      "latency_ms": 3657.0,
+      "sample_tools": [
+        "check_zentao_status",
+        "get_zentao_url",
+        "list_products",
+        "get_product",
+        "create_product"
+      ],
+      "spawn_pid": 11224,
+      "status": "PASS"
+    },
+    "qoder-mysql": {
+      "available": true,
+      "tools_indexed": 6,
+      "latency_ms": 3484.0,
+      "sample_tools": [
+        "list_envs",
+        "query_schema",
+        "query_data",
+        "query_distinct",
+        "list_databases"
+      ],
+      "spawn_pid": 37868,
+      "status": "PASS"
+    },
+    "lanhu": {
+      "available": true,
+      "tools_indexed": 13,
+      "latency_ms": 3156.0,
+      "sample_tools": [
+        "lanhu_resolve_invite_link",
+        "lanhu_list_product_documents",
+        "lanhu_get_pages",
+        "lanhu_get_ai_analyze_page_result",
+        "lanhu_get_designs"
+      ],
+      "spawn_pid": 36836,
+      "status": "PASS"
+    }
+  },
+  "call_tool": {
+    "status": "PASS",
+    "latency_ms": 3953.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/",
+    "is_error": false
+  },
+  "memory": {
+    "available": true,
+    "providers": [
+      {
+        "provider": "McpMemoryProvider",
+        "available": true,
+        "hit": true
+      },
+      {
+        "provider": "FileMemoryCap",
+        "available": true,
+        "hit": false
+      },
+      {
+        "provider": "NoOpMemoryCap",
+        "available": false,
+        "hit": false
+      }
+    ],
+    "status": "PASS"
+  },
+  "summary": {
+    "all_pass": true,
+    "active_servers": 4,
+    "total_servers": 4,
+    "total_tools": 102
+  }
+}

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

@@ -396,6 +396,9 @@ def find_python_with_core_deps():
 def rewrite_mcp_json_for_launcher():
     """把 mcp.json 里所有 python MCP (kg/mysql/lanhu) 改成 launcher 模式。
 
+    ★ kg 走云平台 SSE url（共识），不走 launcher——在 for srv 循环已配 SSE，
+      这里跳过 kg（不改 launcher），保住 SSE 配置。
+
     旧 (写死路径): {"command": "E:\\...\\python.exe", "args": ["E:\\...\\server.py"]}
     新 (launcher): {"command": "<py cmd>", "args": ["<home>/.qoderwork/mcp_launcher.py", "<name>"]}
 
@@ -438,7 +441,7 @@ def rewrite_mcp_json_for_launcher():
     }
     changed = False
     for srv, sub in name_map.items():
-        # 共识：kg 走云平台（默认 10.89.7.120:10010/mcp，config platform_mcp.url 可覆盖）
+        # 共识：kg 走云平台（默认 http://10.89.7.120:10010/mcp，config platform_mcp.url 可覆盖）
         if srv == "qoder-knowledge-graph":
             _pm = "http://10.89.7.120:10010/mcp"
             try:

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

@@ -20,7 +20,6 @@ integration.return_to_platform —— 引擎产出回流平台的统一通道。
 """
 from __future__ import annotations
 
-import os
 from typing import Optional
 
 
@@ -35,7 +34,6 @@ 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:
@@ -123,7 +121,7 @@ def _via_http(payload: dict) -> tuple[bool, str]:
 
 
 def _platform_base() -> str:
-    """平台 base url（默认 http://10.89.7.120 云），从 mcp_config server url 推导。"""
+    """平台 base url（http://127.0.0.1:10010），从 mcp_config server url 推导。"""
     from urllib.parse import urlparse
     cfg = _load_mcp_config()
     for srv in (cfg.get("mcpServers") or {}).values():
@@ -135,7 +133,7 @@ def _platform_base() -> str:
     if ep:
         p = urlparse(ep)
         return "%s://%s" % (p.scheme, p.netloc)
-    return os.environ.get("WLKJ_BASE_URL", "http://10.89.7.120")
+    return "http://127.0.0.1:10010"
 
 
 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 头
+传输: POST /mcp direct JSON-RPC + X-MCP-Token（同 engine/poller.py:_mcp_call）
 """
 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 / ".qoder" / "mcp_config.json",  # ★ switch_project 写这里，优先（同 return_to_platform，否则可能读到 repo/ 旧文件）
-                 repo / "mcp_config.json"]:
+    for cand in [repo / "mcp_config.json",
+                 repo / ".qoder" / "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 os.environ.get("WLKJ_BASE_URL", "http://10.89.7.120")).rstrip("/")
+    base = (base or "http://127.0.0.1:10010").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/extract/asset/__init__.py

@@ -0,0 +1,10 @@
+# -*- coding: utf-8 -*-
+"""资产中心 25 表吸收 (GOAL 4)。
+
+子模块:
+  prd_importer         prds + prd_versions → 业务知识 (调 LLM)
+  prototype_importer   prototypes + annotations → 意图知识
+  discussion_importer  discussions → 决策知识 (LLM)
+  asset_tree           assets → 模块结构
+  returns_importer     asset_returns → 实践知识
+"""

package/templates/qoder/scripts/domain/kg/extract/asset/asset_tree.py

@@ -0,0 +1,57 @@
+# -*- coding: utf-8 -*-
+"""资产树 → 模块结构知识。
+
+assets 表 (飞书式文件树, 330节点) → MODULE 实体。
+"01_PRD/02_设计/03_交付" 这种结构本身就是项目知识。
+parent_id 递归 → 模块层级。
+"""
+from __future__ import annotations
+import os, sys
+
+_THIS = os.path.dirname(os.path.abspath(__file__))
+for _i in range(8):
+    _p = os.path.dirname(_THIS)
+    if os.path.isfile(os.path.join(_p, 'foundation', 'bootstrap.py')):
+        sys.path.insert(0, _p); break
+    _THIS = _p
+
+
+def import_asset_tree(project_id: str = None, logger=print):
+    """assets 表 → MODULE 实体 + 层级边。"""
+    try:
+        from dotenv import load_dotenv
+        for p in ['wlinkj-workspace/backend/.env', '.env']:
+            if os.path.isfile(p): load_dotenv(p); break
+    except: pass
+    sys.path.insert(0, os.path.join(os.getcwd(), 'wlinkj-workspace', 'backend'))
+    from app.db import SessionLocal
+    from app.models import Asset
+    from domain.kg.extract.java import pg_upsert
+
+    db = SessionLocal()
+    q = db.query(Asset)
+    if project_id: q = q.filter(Asset.project_id == project_id)
+    assets = q.all()
+    logger('  [asset-tree] %d 个资产节点' % len(assets))
+
+    entities, edges = [], []
+    for a in assets:
+        repo_id = 'asset-%s' % (a.project_id or 'global')[:8]
+        entities.append({
+            'id': 'asset:%s' % a.id, 'repo_id': repo_id,
+            'type': 'MODULE' if a.is_folder else 'ASSET',
+            'canonical': a.name, 'cn': a.type or '',
+            'props': {'project_id': a.project_id, 'kind': 'folder' if a.is_folder else 'file',
+                      'mime': a.mime_type, 'source': 'asset_center'},
+        })
+        # parent_id → 层级边
+        if a.parent_id:
+            edges.append({
+                'from_id': 'asset:%s' % a.id, 'to_id': 'asset:%s' % a.parent_id,
+                'edge_type': 'child_of', 'from_repo': repo_id, 'to_repo': repo_id,
+                'confidence': 1.0, 'source': 'explicit',
+            })
+    db.close()
+
+    upsert_r = pg_upsert.upsert_batch(entities, edges) if (entities or edges) else {'ok': False}
+    return {'assets': len(assets), 'entities': len(entities), 'edges': len(edges), 'upsert': upsert_r}

package/templates/qoder/scripts/domain/kg/extract/asset/discussion_importer.py

@@ -0,0 +1,62 @@
+# -*- coding: utf-8 -*-
+"""讨论 → 决策知识。
+
+discussion_messages → DECISION 实体 (LLM 抽取决策点)。
+当前 0 数据, 管线先建好, 等团队用起来立刻生效。
+"""
+from __future__ import annotations
+import os, sys
+
+_THIS = os.path.dirname(os.path.abspath(__file__))
+for _i in range(8):
+    _p = os.path.dirname(_THIS)
+    if os.path.isfile(os.path.join(_p, 'foundation', 'bootstrap.py')):
+        sys.path.insert(0, _p); break
+    _THIS = _p
+
+
+def import_discussions(project_id: str = None, logger=print):
+    """讨论 → KG。"""
+    try:
+        from dotenv import load_dotenv
+        for p in ['wlinkj-workspace/backend/.env', '.env']:
+            if os.path.isfile(p): load_dotenv(p); break
+    except: pass
+    sys.path.insert(0, os.path.join(os.getcwd(), 'wlinkj-workspace', 'backend'))
+    from app.db import SessionLocal
+    from app.models import Discussion, DiscussionMessage
+    from domain.kg.extract.java import pg_upsert
+
+    db = SessionLocal()
+    q = db.query(Discussion)
+    if project_id: q = q.filter(Discussion.project_id == project_id)
+    discussions = q.all()
+    logger('  [asset-disc] %d 个讨论' % len(discussions))
+
+    entities, edges = [], []
+    for d in discussions:
+        repo_id = 'asset-%s' % (d.project_id or 'global')[:8]
+        # 讨论 → DECISION 实体
+        entities.append({
+            'id': 'disc:%s' % d.id, 'repo_id': repo_id, 'type': 'DECISION',
+            'canonical': d.title[:80], 'cn': '',
+            'props': {'kind': 'discussion', 'project_id': d.project_id, 'source': 'asset_center'},
+        })
+        # 消息 → 关联到讨论
+        msgs = db.query(DiscussionMessage).filter(DiscussionMessage.discussion_id == d.id).all()
+        for m in msgs:
+            if not m.content: continue
+            entities.append({
+                'id': 'discmsg:%s' % m.id, 'repo_id': repo_id, 'type': 'DECISION',
+                'canonical': m.content[:60], 'cn': m.author_name or '',
+                'props': {'discussion_id': d.id, 'author': m.author_name, 'source': 'discussion_msg'},
+            })
+            edges.append({
+                'from_id': 'discmsg:%s' % m.id, 'to_id': 'disc:%s' % d.id,
+                'edge_type': 'decided_in', 'from_repo': repo_id, 'to_repo': repo_id,
+                'confidence': 1.0, 'source': 'explicit',
+            })
+    db.close()
+
+    upsert_r = pg_upsert.upsert_batch(entities, edges) if (entities or edges) else {'ok': False}
+    return {'discussions': len(discussions), 'entities': len(entities), 'edges': len(edges), 'upsert': upsert_r}

package/templates/qoder/scripts/domain/kg/extract/asset/prd_importer.py

@@ -0,0 +1,146 @@
+# -*- coding: utf-8 -*-
+"""资产中心 prds + prd_versions → KG 业务知识吸收。
+
+把工作台 SQLite/PG 的 prds 表灌进 KG (当前0吸收)。
+对每个有正文的 PRD:
+  1. 调 prd_llm_extract 抽功能点/字段/规则/端点/权限
+  2. 调 prd_chunk_embed 做向量 (LightRAG vector 路)
+  3. 调 req_anchor 锚到 REQ-ID
+"""
+from __future__ import annotations
+import os
+import sys
+
+_THIS = os.path.dirname(os.path.abspath(__file__))
+for _i in range(8):
+    _p = os.path.dirname(_THIS)
+    if os.path.isfile(os.path.join(_p, 'foundation', 'bootstrap.py')):
+        sys.path.insert(0, _p); break
+    _THIS = _p
+
+
+def import_all_prds(project_id: str = None, do_embed: bool = False, llm_limit: int = 10, logger=print):
+    """扫资产中心所有 PRD → LLM 抽取 + 锚定。
+
+    Args:
+        project_id: 限定某项目 (None=全部)
+        do_embed: 是否做 embedding (慢, 默认False)
+        llm_limit: LLM 抽取上限 (避免154个PRD全调qwen超时; 0=不调LLM只锚定)
+    Returns: {stats}
+    """
+    from domain.kg.extract.prd import prd_llm_extract, prd_chunk_embed, req_anchor
+
+    # 连工作台 DB 读 PRD
+    try:
+        from dotenv import load_dotenv
+        for p in ['wlinkj-workspace/backend/.env', '.env']:
+            if os.path.isfile(p):
+                load_dotenv(p); break
+    except Exception:
+        pass
+    sys.path.insert(0, os.path.join(os.getcwd(), 'wlinkj-workspace', 'backend'))
+    from app.db import SessionLocal
+    from app.models import PRD, PRDVersion
+    from sqlalchemy import text
+
+    db = SessionLocal()
+    q = db.query(PRD)
+    if project_id:
+        q = q.filter(PRD.project_id == project_id)
+    prds = q.all()
+    logger('  [asset-prd] %d 个 PRD 待吸收' % len(prds))
+
+    all_entities, all_edges = [], []
+    embedded = 0
+    llm_done = 0
+    for prd in prds:
+        # 取最新版本正文
+        ver = db.query(PRDVersion).filter(PRDVersion.prd_id == prd.id).order_by(PRDVersion.version.desc()).first()
+        content_md = ver.content_md if ver else ''
+        repo_id = 'asset-%s' % (prd.project_id or 'global')[:8]
+
+        # ① PRD 实体本身 (写 entities, group=prd)
+        all_entities.append({
+            'id': 'prd:%s' % prd.id, 'repo_id': repo_id, 'type': 'PRD',
+            'canonical': prd.title[:80], 'cn': prd.category or '',
+            'props': {'project_id': prd.project_id, 'status': prd.status,
+                      'version': prd.current_version, 'source': 'asset_center'},
+        })
+
+        # ② REQ-ID 锚定 (PRD 标题 → anchors)
+        a_ent, a_edg = req_anchor.anchor_prd(prd.id, prd.title, prd.project_id, repo_id)
+        all_entities += a_ent
+        all_edges += a_edg
+
+        # ③ 有正文且未超 LLM 上限 → LLM 抽取
+        if content_md and len(content_md) > 100 and llm_done < llm_limit:
+            extracted = prd_llm_extract.extract_prd_knowledge(content_md)
+            e_ent, e_edg = prd_llm_extract.to_entities_edges(
+                extracted, prd.id, prd.project_id, repo_id)
+            all_entities += e_ent
+            all_edges += e_edg
+            llm_done += 1
+
+            # ④ embedding (可选, 慢)
+            if do_embed and len(content_md) > 500:
+                try:
+                    r = prd_chunk_embed.embed_prd(prd.id, content_md, repo_id)
+                    embedded += r.get('embedded', 0)
+                except Exception:
+                    pass
+
+    db.close()
+
+    # 写 PG
+    from domain.kg.extract.java import pg_upsert
+    upsert_r = pg_upsert.upsert_batch(all_entities, all_edges) if (all_entities or all_edges) else {'ok': False}
+
+    # ★ 同时把锚点写进 anchors 专用表 (GOAL 1 建的)
+    anchor_records = []
+    seen_anchor = set()
+    for e in all_entities:
+        if e.get('type') == 'ANCHOR':
+            aid = e['id']
+            if aid in seen_anchor:
+                continue
+            seen_anchor.add(aid)
+            anchor_records.append({
+                'id': aid,
+                'project_id': e['props'].get('project_id'),
+                'title': e.get('cn', ''),
+                'kind': e['props'].get('kind', 'feature'),
+                'prd_id': e['props'].get('prd_id'),
+            })
+    anchor_ok = _upsert_anchors(anchor_records) if anchor_records else 0
+
+    return {
+        'prds_total': len(prds),
+        'entities': len(all_entities),
+        'edges': len(all_edges),
+        'embedded': embedded,
+        'anchors': anchor_ok,
+        'upsert': upsert_r,
+    }
+
+
+def _upsert_anchors(records):
+    """写 anchors 专用表。"""
+    from domain.kg.extract.java import pg_upsert as _pg
+    engine, _ = _pg._get_pg_engine()
+    if engine is None or not records:
+        return 0
+    from sqlalchemy import text
+    ok = 0
+    with engine.begin() as conn:
+        for r in records:
+            try:
+                conn.execute(text("""
+                    INSERT INTO anchors (id, project_id, title, kind, prd_id)
+                    VALUES (:id, :pid, :title, :kind, :prd)
+                    ON CONFLICT (id) DO UPDATE SET title=EXCLUDED.title, updated_at=now()
+                """), {'id': r['id'], 'pid': r.get('project_id'), 'title': r.get('title', ''),
+                       'kind': r.get('kind', 'feature'), 'prd': r.get('prd_id')})
+                ok += 1
+            except Exception:
+                pass
+    return ok

package/templates/qoder/scripts/domain/kg/extract/asset/prototype_importer.py

@@ -0,0 +1,64 @@
+# -*- coding: utf-8 -*-
+"""原型 + 标注 → 意图知识。
+
+把 prototypes 表灌进 KG (当前10个原型, 0标注 - 管线先建好)。
+prototype → PAGE 实体; annotation → CONSTRAINT 实体。
+"""
+from __future__ import annotations
+import os, sys
+
+_THIS = os.path.dirname(os.path.abspath(__file__))
+for _i in range(8):
+    _p = os.path.dirname(_THIS)
+    if os.path.isfile(os.path.join(_p, 'foundation', 'bootstrap.py')):
+        sys.path.insert(0, _p); break
+    _THIS = _p
+
+
+def import_prototypes(project_id: str = None, logger=print):
+    """原型 + 标注 → KG。"""
+    try:
+        from dotenv import load_dotenv
+        for p in ['wlinkj-workspace/backend/.env', '.env']:
+            if os.path.isfile(p): load_dotenv(p); break
+    except: pass
+    sys.path.insert(0, os.path.join(os.getcwd(), 'wlinkj-workspace', 'backend'))
+    from app.db import SessionLocal
+    from app.models import Prototype, PrototypeAnnotation
+    from domain.kg.extract.java import pg_upsert
+
+    db = SessionLocal()
+    q = db.query(Prototype)
+    if project_id: q = q.filter(Prototype.project_id == project_id)
+    protos = q.all()
+    logger('  [asset-proto] %d 个原型' % len(protos))
+
+    entities, edges = [], []
+    for p in protos:
+        repo_id = 'asset-%s' % (p.project_id or 'global')[:8]
+        # 原型 → PAGE 实体
+        entities.append({
+            'id': 'proto:%s' % p.id, 'repo_id': repo_id, 'type': 'PAGE',
+            'canonical': p.feature or p.id[:8], 'cn': p.platform or '',
+            'props': {'kind': 'prototype', 'project_id': p.project_id,
+                      'status': p.status, 'source': 'asset_center'},
+        })
+        # 该原型的标注 → CONSTRAINT
+        anns = db.query(PrototypeAnnotation).filter(PrototypeAnnotation.prototype_id == p.id).all()
+        for a in anns:
+            if not a.comment: continue
+            entities.append({
+                'id': 'ANNO:%s' % a.id, 'repo_id': repo_id, 'type': 'CONSTRAINT',
+                'canonical': a.comment[:60], 'cn': a.type or '',
+                'props': {'prototype_id': p.id, 'status': a.status,
+                          'coords': {'x': a.x, 'y': a.y}, 'source': 'annotation'},
+            })
+            edges.append({
+                'from_id': 'ANNO:%s' % a.id, 'to_id': 'proto:%s' % p.id,
+                'edge_type': 'annotates', 'from_repo': repo_id, 'to_repo': repo_id,
+                'confidence': 1.0, 'source': 'explicit',
+            })
+    db.close()
+
+    upsert_r = pg_upsert.upsert_batch(entities, edges) if (entities or edges) else {'ok': False}
+    return {'prototypes': len(protos), 'entities': len(entities), 'edges': len(edges), 'upsert': upsert_r}

package/templates/qoder/scripts/domain/kg/extract/asset/returns_importer.py

@@ -0,0 +1,52 @@
+# -*- coding: utf-8 -*-
+"""回流历史 → 实践知识。
+
+asset_returns (引擎→平台产出) → embedding (能搜"之前怎么做的")。
+当前3条, 是引擎回流的PRD/原型/资产。
+"""
+from __future__ import annotations
+import os, sys
+
+_THIS = os.path.dirname(os.path.abspath(__file__))
+for _i in range(8):
+    _p = os.path.dirname(_THIS)
+    if os.path.isfile(os.path.join(_p, 'foundation', 'bootstrap.py')):
+        sys.path.insert(0, _p); break
+    _THIS = _p
+
+
+def import_returns(project_id: str = None, logger=print):
+    """asset_returns → KG 实践知识。"""
+    try:
+        from dotenv import load_dotenv
+        for p in ['wlinkj-workspace/backend/.env', '.env']:
+            if os.path.isfile(p): load_dotenv(p); break
+    except: pass
+    sys.path.insert(0, os.path.join(os.getcwd(), 'wlinkj-workspace', 'backend'))
+    from app.db import SessionLocal
+    from app.models import AssetReturn
+    from domain.kg.extract.java import pg_upsert
+
+    db = SessionLocal()
+    q = db.query(AssetReturn)
+    if project_id: q = q.filter(AssetReturn.project_id == project_id)
+    returns = q.all()
+    logger('  [asset-ret] %d 条回流' % len(returns))
+
+    entities, edges = [], []
+    for r in returns:
+        repo_id = 'asset-%s' % (r.project_id or 'global')[:8]
+        # 回流产出 → 实体 (按 return_type 分类)
+        etype = {'prd': 'PRD', 'prototype': 'PAGE', 'asset': 'ASSET'}.get(r.return_type, 'ASSET')
+        entities.append({
+            'id': 'return:%s' % r.id, 'repo_id': repo_id, 'type': etype,
+            'canonical': r.title[:80], 'cn': r.return_type or '',
+            'props': {'project_id': r.project_id, 'return_type': r.return_type,
+                      'source': r.source, 'status': r.status,
+                      'preview': (r.content_preview or '')[:200],
+                      'source': 'asset_return'},
+        })
+
+    db.close()
+    upsert_r = pg_upsert.upsert_batch(entities, edges) if (entities or edges) else {'ok': False}
+    return {'returns': len(returns), 'entities': len(entities), 'edges': len(edges), 'upsert': upsert_r}