@hupan56/wlkj 2.7.12 → 3.1.2

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

@@ -0,0 +1,72 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+nexus CLI 入口 —— 诊断当前宿主能力。
+
+用法:
+    python .qoder/scripts/capability               # 打印宿主 + 各能力 available
+    python -m nexus                           # 等价（需 scripts 在 sys.path）
+
+输出 JSON，便于人或脚本消费。
+"""
+import json
+import os
+import sys
+
+
+def _ensure_scripts_on_path():
+    """确保父目录 scripts/ 在 sys.path，使 nexus 包可被 import。"""
+    here = os.path.dirname(os.path.abspath(__file__))
+    scripts_dir = os.path.dirname(here)
+    if scripts_dir not in sys.path:
+        sys.path.insert(0, scripts_dir)
+
+
+def main() -> int:
+    _ensure_scripts_on_path()
+    from capability.registry import resolve
+
+    cap = resolve()
+    desc = cap.describe()
+
+    # MCP server 详情
+    mcp_desc = cap.mcp.describe() if hasattr(cap.mcp, "describe") else {}
+
+    # memory 职责链详情
+    memory_chain = []
+    if hasattr(cap.memory, "providers_status"):
+        memory_chain = cap.memory.providers_status()
+        desc["memory_chain"] = memory_chain
+
+    # 格式化输出
+    print("宿主: %s" % desc.get("host", "?"))
+    print()
+    print("能力:")
+    for name, avail in desc.get("capabilities", {}).items():
+        icon = "✅" if avail else "❌"
+        print("  %s %s" % (icon, name))
+
+    if mcp_desc.get("servers"):
+        print()
+        print("MCP servers (tools=%d):" % mcp_desc.get("total_tools", 0))
+        for name, info in mcp_desc["servers"].items():
+            icon = "✅" if info.get("available") else "❌"
+            pid = " pid=%s" % info["spawn_pid"] if info.get("spawn_pid") else ""
+            latency = " latency=%sms" % info["latency_ms"] if info.get("latency_ms") is not None else ""
+            print("  %s %s: tools=%d%s%s" % (
+                icon, name, info.get("tools_indexed", 0), latency, pid))
+
+    if memory_chain:
+        print()
+        print("Memory 职责链:")
+        for p in memory_chain:
+            hit = " ← ACTIVE" if p.get("hit") else ""
+            print("  %s: available=%s%s" % (p["provider"], p["available"], hit))
+
+    print()
+    print(json.dumps(desc, ensure_ascii=False, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/templates/qoder/scripts/capability/adapters/__init__.py

@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+"""
+nexus.adapters —— 各宿主/降级路径的 Cap 实现。
+
+设计模式: Adapter + Bridge（Cap 抽象 × 宿主实现 正交）
+
+新增宿主（扩展场景 D）= 新建一个文件（如 devin.py）实现其提供的 Cap，
+                         在 registry 的 _resolve_xxx 里按宿主名装配。
+                         核心 Facade、工作流代码零改动。
+
+文件:
+    mcp.py  —— L1 MCP 统一入口（复用禅道/知识图谱等已有 MCP）+ McpMemoryProvider（未来）
+    qw.py   —— QoderWork 原生能力
+    cli.py  —— 纯文件降级（核心能力兜底，无宿主依赖）
+"""
+from .mcp import McpCap, McpMemoryProvider
+from .qw import QwMemoryCap, is_qoderwork
+from .cli import (
+    FileRepoCap,
+    FileIdentityCap,
+    FileContextCap,
+    FileMemoryCap,
+)
+
+__all__ = [
+    "McpCap", "McpMemoryProvider",
+    "QwMemoryCap", "is_qoderwork",
+    "FileRepoCap", "FileIdentityCap", "FileContextCap", "FileMemoryCap",
+]

package/templates/qoder/scripts/capability/adapters/cli.py

@@ -0,0 +1,316 @@
+# -*- coding: utf-8 -*-
+"""
+adapters.cli —— 纯文件降级 Adapter。
+
+设计模式: Adapter（纯 Python 文件实现，无任何宿主依赖）
+
+核心能力的兜底实现，保证纯 CLI / 任意宿主环境也能跑。
+这是"外挂式"的底牌：即便宿主什么能力都不给，工作流仍可用。
+
+实现:
+    - FileRepoCap:     向上找含 .qoder/scripts/ 的目录（复用 common.paths）
+    - FileIdentityCap: 读 .developer（复用 common.paths.get_developer）
+    - FileContextCap:  读配置/偏好文件
+    - FileMemoryCap:   journal 文件记忆（纯文本追加，无语义检索）
+"""
+from __future__ import annotations
+
+from datetime import datetime
+from pathlib import Path
+from typing import Any
+
+
+def _import_paths():
+    """延迟导入 common.paths，避免循环依赖与硬失败。
+
+    Returns:
+        (get_repo_root, get_developer, get_developer_journal_dir) 元组，
+        任一不可用则对应位为 None。
+    """
+    try:
+        from foundation.core.paths import (
+            get_repo_root,
+            get_developer,
+            get_developer_journal_dir,
+        )
+        return get_repo_root, get_developer, get_developer_journal_dir
+    except ImportError:
+        return None, None, None
+
+
+class FileRepoCap:
+    """仓库根发现 —— 向上找含 .qoder/scripts/ 的目录。无 ~/.qoderwork/ 依赖。"""
+
+    available = True  # 核心能力，永远可用
+
+    def root(self) -> Path:
+        get_repo_root, _, _ = _import_paths()
+        if get_repo_root:
+            try:
+                return get_repo_root()
+            except Exception:
+                pass
+        # 兜底：__file__ 向上找
+        current = Path(__file__).resolve()
+        for _ in range(10):
+            if (current / ".qoder" / "scripts").is_dir():
+                return current
+            parent = current.parent
+            if parent == current:
+                break
+            current = parent
+        return Path.cwd()
+
+
+class FileIdentityCap:
+    """身份 —— 读 .developer 文件。"""
+
+    available = True
+
+    def who(self) -> str | None:
+        _, get_developer, _ = _import_paths()
+        if get_developer:
+            try:
+                dev = get_developer()
+                if dev:
+                    return dev
+            except Exception:
+                pass
+        # 兜底：直接读 .developer
+        dev_file = FileRepoCap().root() / ".developer"
+        if dev_file.is_file():
+            return dev_file.read_text(encoding="utf-8").strip() or None
+        return None
+
+    def role(self) -> str | None:
+        """从 member.json 读取角色（pm/dev/qa/test/admin）。"""
+        try:
+            from foundation.identity.identity import get_role
+            return get_role(self.who())
+        except Exception:
+            return None
+
+    def zentao_account(self) -> str | None:
+        """从 member.json 读取禅道账号映射。"""
+        try:
+            from foundation.identity.identity import get_member
+            member = get_member(self.who() or "")
+            if member:
+                return member.get("zentao_account") or None
+        except Exception:
+            pass
+        return None
+
+
+class FileContextCap:
+    """上下文 —— 读配置/偏好文件。"""
+
+    available = True
+
+    def preferences(self) -> dict:
+        """读 .qoder/settings.json 或 .qoder/config.yaml 中的偏好。"""
+        try:
+            repo = FileRepoCap().root()
+            import json as _json
+            # settings.json 优先
+            sf = repo / ".qoder" / "settings.json"
+            if sf.is_file():
+                with open(sf, encoding="utf-8") as f:
+                    return _json.load(f)
+            # config.yaml 降级
+            import yaml
+            cf = repo / ".qoder" / "config.yaml"
+            if cf.is_file():
+                with open(cf, encoding="utf-8") as f:
+                    return yaml.safe_load(f) or {}
+        except Exception:
+            pass
+        return {}
+
+    def recent_learnings(self, limit: int = 5) -> list[dict]:
+        """读当前开发者的 feedback.jsonl 最近 N 条学习事件。"""
+        try:
+            _, get_developer, get_journal = _import_paths()
+            if not (get_developer and get_journal):
+                return []
+            dev = get_developer()
+            if not dev:
+                return []
+            fb = get_journal(dev) / "feedback.jsonl"
+            if not fb.is_file():
+                return []
+            import json as _json
+            with open(fb, encoding="utf-8") as f:
+                lines = [l.strip() for l in f if l.strip()]
+            results = []
+            for line in reversed(lines[-limit:]):
+                try:
+                    results.append(_json.loads(line))
+                except _json.JSONDecodeError:
+                    continue
+            return results
+        except Exception:
+            return []
+
+
+class FileMemoryCap:
+    """记忆 —— journal 文件降级（feedback.jsonl + memory.md）。
+
+    存储位置: workspace/members/{dev}/journal/（复用 common.paths）。
+    available 探测到 journal 目录可写时为 True。
+
+    实现:
+        - remember: 追加到 memory.md（带 key 标题）
+        - recall:   扫 memory.md + feedback.jsonl 关键词匹配（非语义，纯子串）
+        - get_fact: 精确匹配 memory.md 的 key 标题块
+        - list_recent: 返回最近 N 条（memory.md 最新 + feedback.jsonl 最新）
+    """
+
+    def __init__(self):
+        self._available = self._probe()
+
+    def _probe(self) -> bool:
+        try:
+            _, get_developer, get_journal = _import_paths()
+            if not (get_developer and get_journal):
+                return False
+            dev = get_developer()
+            if not dev:
+                return False
+            journal_dir = get_journal(dev)
+            journal_dir.mkdir(parents=True, exist_ok=True)
+            return journal_dir.is_dir()
+        except Exception:
+            return False
+
+    def _journal_dir(self):
+        _, get_developer, get_journal = _import_paths()
+        if not (get_developer and get_journal):
+            return None
+        try:
+            dev = get_developer()
+            if not dev:
+                return None
+            return get_journal(dev)
+        except Exception:
+            return None
+
+    @property
+    def available(self) -> bool:
+        return self._available
+
+    def recall(self, query: str) -> list[dict]:
+        """关键词检索：扫 memory.md + feedback.jsonl，返回含 query 的条目。"""
+        if not self._available or not query:
+            return []
+        jdir = self._journal_dir()
+        if jdir is None:
+            return []
+        results = []
+
+        # 1) memory.md 关键词匹配
+        mem_file = jdir / "memory.md"
+        if mem_file.is_file():
+            try:
+                content = mem_file.read_text(encoding="utf-8")
+                for block in content.split("\n## "):
+                    if query.lower() in block.lower():
+                        results.append({"source": "memory.md", "text": block.strip()})
+            except Exception:
+                pass
+
+        # 2) feedback.jsonl 关键词匹配
+        fb_file = jdir / "feedback.jsonl"
+        if fb_file.is_file():
+            import json as _json
+            try:
+                with open(fb_file, encoding="utf-8") as f:
+                    for line in f:
+                        line = line.strip()
+                        if not line:
+                            continue
+                        try:
+                            entry = _json.loads(line)
+                            text = _json.dumps(entry, ensure_ascii=False)
+                            if query.lower() in text.lower():
+                                results.append({"source": "feedback.jsonl", "data": entry})
+                        except _json.JSONDecodeError:
+                            continue
+            except Exception:
+                pass
+
+        return results[:20]  # 限制返回数
+
+    def remember(self, key: str, content: str) -> None:
+        if not self._available:
+            return
+        _, get_developer, get_journal = _import_paths()
+        if not (get_developer and get_journal):
+            return
+        try:
+            dev = get_developer()
+            journal_dir = get_journal(dev)
+            ts = datetime.now().strftime("%Y-%m-%d %H:%M")
+            entry = f"\n## [{ts}] {key}\n{content}\n"
+            with open(journal_dir / "memory.md", "a", encoding="utf-8") as f:
+                f.write(entry)
+        except Exception:
+            pass
+
+    def get_fact(self, key: str) -> str | None:
+        """精确匹配 memory.md 中以 key 为标题的块。"""
+        if not self._available or not key:
+            return None
+        jdir = self._journal_dir()
+        if jdir is None:
+            return None
+        mem_file = jdir / "memory.md"
+        if not mem_file.is_file():
+            return None
+        try:
+            content = mem_file.read_text(encoding="utf-8")
+            for block in content.split("\n## "):
+                # 块标题形如 "[2026-06-18 12:30] 某key"
+                if "] " + key in block or block.strip().endswith(key):
+                    return block.strip()
+        except Exception:
+            pass
+        return None
+
+    def list_recent(self, limit: int = 10) -> list[dict]:
+        """返回最近 N 条记忆（memory.md 倒序 + feedback.jsonl 倒序）。"""
+        if not self._available:
+            return []
+        jdir = self._journal_dir()
+        if jdir is None:
+            return []
+        results = []
+
+        # memory.md 块倒序
+        mem_file = jdir / "memory.md"
+        if mem_file.is_file():
+            try:
+                content = mem_file.read_text(encoding="utf-8")
+                blocks = [b.strip() for b in content.split("\n## ") if b.strip()]
+                for b in reversed(blocks[-limit:]):
+                    results.append({"source": "memory.md", "text": b})
+            except Exception:
+                pass
+
+        # feedback.jsonl 最后 N 条
+        fb_file = jdir / "feedback.jsonl"
+        if fb_file.is_file():
+            import json as _json
+            try:
+                with open(fb_file, encoding="utf-8") as f:
+                    lines = [l.strip() for l in f if l.strip()]
+                for line in reversed(lines[-limit:]):
+                    try:
+                        entry = _json.loads(line)
+                        results.append({"source": "feedback.jsonl", "data": entry})
+                    except _json.JSONDecodeError:
+                        continue
+            except Exception:
+                pass
+
+        return results[:limit]