@hupan56/wlkj 3.3.13 → 3.3.14

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

@@ -834,7 +834,6 @@ 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
@@ -849,11 +848,8 @@ def main():
     check_dependencies(fix)
     check_developer(fix, name, role)
     check_team_sync(fix)
-    if skip_code:
-        print('\n--- 4. 源码/索引: 云模式跳过（KG 在云平台，引擎调云 MCP）---')
-    else:
-        check_source_repos(fix, config)
-        check_index(fix)
+    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,6 +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（空）
+        if srv == "qoder-knowledge-graph":
+            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
+            except Exception:
+                pass  # config 无 platform_mcp → 回退 launcher
         entry = servers.get(srv)
         # 全新机器: kg/mysql/lanhu 条目可能不存在 → 创建它 (launcher 模式)
         if not entry:

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

@@ -1,16 +1,5 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
-# Windows 控制台 UTF-8 修复（ctypes 直调 Windows API，非子shell chcp）
-import sys as _s
-if _s.platform == 'win32':
-    import ctypes as _ct, io as _io
-    try:
-        _ct.windll.kernel32.SetConsoleOutputCP(65001)
-        _ct.windll.kernel32.SetConsoleCP(65001)
-        _s.stdout = _io.TextIOWrapper(_s.stdout.buffer, encoding='utf-8', errors='replace')
-        _s.stderr = _io.TextIOWrapper(_s.stderr.buffer, encoding='utf-8', errors='replace')
-    except Exception:
-        pass
 # v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
 import os as _o, sys as _s
 _f = _o.path.abspath(__file__)
@@ -253,11 +242,9 @@ def detect_name(explicit=None):
 # Step 2: 调 init_doctor --fix (主体)
 # ============================================================
 
-def run_doctor(name, role, skip_code=False):
+def run_doctor(name, role):
     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'
@@ -924,7 +911,6 @@ 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)
@@ -945,7 +931,7 @@ def main():
     configure_git_identity(name)
 
     # Step 2
-    if not run_doctor(name, args.role, args.skip_code):
+    if not run_doctor(name, args.role):
         warn('init_doctor 未完全成功, 继续 setup 后续步骤...')
 
     # Step 3

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/build/build_entity_registry.py

@@ -1,6 +1,17 @@
 # -*- 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 <功能名> 能返回功能画像。
 
@@ -23,18 +34,6 @@
 业务流程) 由 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
@@ -42,6 +41,7 @@ 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,6 +1,17 @@
 # -*- 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 多跳遍历有边可走。
 
@@ -21,24 +32,13 @@
   - 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/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}