foxclaw 0.1.2 → 0.1.4

package/python/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "foxclaw"
-version = "0.1.2"
+version = "0.1.4"
 description = "Foxclaw - a personal agent with memory, built on the HMR memory runtime"
 requires-python = ">=3.11"
 
@@ -70,6 +70,13 @@ foxclaw = "foxclaw.cli:main"
 # 这里把它们真正打进 wheel,并让 package-data 一并带上 LICENSE/JSON 等非 .py 资源。
 include-package-data = true
 
+[tool.setuptools.package-data]
+# frontend/ 在仓库根、不属于任何包,packages.find 收不到;构建前由
+# tools/bundle_web.py 复制成 foxclaw/web/(已 gitignore),这里再把它带进 wheel/sdist。
+# 不复制的话 pip install 之后 foxclaw serve 首页 404(只有 API/CLI)。
+"foxclaw.web" = ["**/*"]
+
+
 [tool.setuptools.packages.find]
 # foxclaw 在仓库根;hmr 在 vendor/ 下;hkc_* 在 vendor/hkc/ 下 —— 三个搜索根都要给。
 where = [".", "vendor", "vendor/hkc"]
@@ -134,18 +141,22 @@ python_version = "3.11"
 ignore_missing_imports = true
 check_untyped_defs = true
 # 渐进式:mypy 存量错误用棘轮门管理(tools/mypy_ratchet.py + tools/mypy_baseline.txt)。
-# 2026-11 实测 673 errors in 90 files,已冻结:CI 中错误数一旦增加即失败,
+# 2026-11 实测 152 errors in 45 files,已冻结:CI 中错误数一旦增加即失败,
 # 下降后用 `python tools/mypy_ratchet.py --update` 调低基线。只降不升。
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
-# S2 迁移完成:全部 76 个测试文件均已迁移为 pytest(无顶层 import 副作用,可安全收集)。
+# S2 迁移完成:全部测试文件均已迁移为 pytest(无顶层 import 副作用,可安全收集)。
 # 注意:网关/内置MCP/流式限流等少数测试依赖模块级单例(FOXCLAW_GATEWAY、FOXCLAW_MCP_SERVER、
 # _STREAM_LIMITER 均在 import 时按 env 固化),单进程 `pytest tests/` 会让这些单例被首个
 # import 定死、相互污染。故全量执行统一走 tests/run_all.py(每个文件独立子进程
 # `python -m pytest <file> -q` 隔离)。本白名单确保任意单文件可被 pytest 收集/运行。
 python_files = [
     "test_agent_lifecycle.py",
+    "test_sensitive_write.py",
+    "test_content_guard.py",
+    "test_behavior_spec.py",
+    "test_agent_rules.py",
     "test_ahs_p2.py",
     "test_anthropic_tools.py",
     "test_api.py",
@@ -214,6 +225,7 @@ python_files = [
     "test_plan_visible.py",
     "test_planner.py",
     "test_policy_gate.py",
+    "test_profile.py",
     "test_reasoner.py",
     "test_release_check.py",
     "test_resume_checkpoint.py",
@@ -229,6 +241,7 @@ python_files = [
     "test_secrets.py",
     "test_skill_taint_gate.py",
     "test_skills.py",
+    "test_skills_fetch.py",
     "test_stats_and_events.py",
     "test_streaming.py",
     "test_supervisor_pipeline.py",
@@ -246,6 +259,7 @@ python_files = [
     "test_tracing.py",
     "test_truth_crystallizer.py",
     "test_truth_flow.py",
+    "test_update_check.py",
     "test_url_policy.py",
     "test_version_sync.py",
     "test_web_trigger.py",

package/python/requirements.txt

@@ -0,0 +1,311 @@
+# This file was autogenerated by uv via the following command:
+#    uv pip compile pyproject.toml --universal -o requirements.txt
+annotated-doc==0.0.5
+    # via
+    #   fastapi
+    #   typer
+annotated-types==0.8.0
+    # via pydantic
+anthropic==2.6.0
+    # via foxclaw (pyproject.toml)
+anyio==4.16.0
+    # via
+    #   anthropic
+    #   httpx
+    #   httpx2
+    #   mcp
+    #   openai
+    #   sse-starlette
+    #   starlette
+attrs==26.1.0
+    # via
+    #   jsonschema
+    #   referencing
+certifi==2026.10.23
+    # via
+    #   httpcore
+    #   httpx
+cffi==2.1.1 ; platform_python_implementation != 'PyPy'
+    # via cryptography
+click==8.5.1
+    # via
+    #   huggingface-hub
+    #   uvicorn
+cloudpickle==3.1.2
+    # via joblib
+colorama==0.4.6 ; sys_platform == 'win32'
+    # via
+    #   tqdm
+    #   typer
+cryptography==50.0.2
+    # via
+    #   foxclaw (pyproject.toml)
+    #   pyjwt
+cuda-bindings==13.5.0 ; python_full_version < '3.15' and sys_platform == 'linux'
+    # via torch
+cuda-pathfinder==1.8.6 ; python_full_version < '3.15' and sys_platform == 'linux'
+    # via cuda-bindings
+cuda-toolkit==13.2.2 ; sys_platform == 'linux'
+    # via torch
+docstring-parser==0.18.0
+    # via anthropic
+faiss-cpu==1.15.1
+    # via foxclaw (pyproject.toml)
+fastapi==0.162.2
+    # via foxclaw (pyproject.toml)
+filelock==4.2.9
+    # via
+    #   huggingface-hub
+    #   torch
+fsspec==2026.9.0
+    # via
+    #   huggingface-hub
+    #   torch
+h11==0.16.0
+    # via
+    #   httpcore
+    #   httpcore2
+    #   uvicorn
+hf-xet==1.8.0 ; platform_machine == 'AMD64' or platform_machine == 'ARM64' or platform_machine == 'aarch64' or platform_machine == 'amd64' or platform_machine == 'arm64' or platform_machine == 'x86_64'
+    # via huggingface-hub
+httpcore==1.0.9
+    # via httpx
+httpcore2==2.16.0 ; sys_platform != 'emscripten'
+    # via httpx2
+httpx==0.27.2
+    # via
+    #   foxclaw (pyproject.toml)
+    #   mcp
+httpx-sse==0.4.3
+    # via mcp
+httpx2==2.16.0
+    # via
+    #   anthropic
+    #   huggingface-hub
+    #   openai
+httpx2-jsfetch==1.0 ; sys_platform == 'emscripten'
+    # via httpx2
+huggingface-hub==2.4.0
+    # via
+    #   sentence-transformers
+    #   tokenizers
+    #   transformers
+idna==3.20
+    # via
+    #   anyio
+    #   httpx
+    #   httpx2
+jinja2==3.1.6
+    # via torch
+jiter==0.19.0
+    # via
+    #   anthropic
+    #   openai
+joblib==1.6.0
+    # via scikit-learn
+jsonschema==4.26.0
+    # via mcp
+jsonschema-specifications==2025.9.1
+    # via jsonschema
+markdown-it-py==4.2.0
+    # via rich
+markupsafe==3.0.4
+    # via jinja2
+mcp==1.30.0
+    # via foxclaw (pyproject.toml)
+mdurl==0.1.2
+    # via markdown-it-py
+mpmath==1.3.0
+    # via sympy
+narwhals==2.28.0
+    # via scikit-learn
+networkx==3.7
+    # via torch
+numpy==2.5.4
+    # via
+    #   foxclaw (pyproject.toml)
+    #   faiss-cpu
+    #   scikit-learn
+    #   scipy
+    #   sentence-transformers
+    #   transformers
+nvidia-cublas==13.4.1.3 ; sys_platform == 'linux'
+    # via
+    #   cuda-toolkit
+    #   nvidia-cudnn-cu13
+    #   nvidia-cusolver
+nvidia-cuda-cccl==13.3.5.0.6 ; sys_platform == 'linux'
+    # via nvidia-nvshmem-cu13
+nvidia-cuda-cupti==13.2.86 ; (platform_machine == 'aarch64' and sys_platform == 'linux') or (platform_machine == 'x86_64' and sys_platform == 'linux')
+    # via cuda-toolkit
+nvidia-cuda-nvrtc==13.2.86 ; sys_platform == 'linux'
+    # via
+    #   cuda-toolkit
+    #   nvidia-cublas
+nvidia-cuda-runtime==13.2.86 ; (platform_machine == 'aarch64' and sys_platform == 'linux') or (platform_machine == 'x86_64' and sys_platform == 'linux')
+    # via cuda-toolkit
+nvidia-cudnn-cu13==9.26.0.51 ; sys_platform == 'linux'
+    # via torch
+nvidia-cufft==12.2.0.57 ; (platform_machine == 'aarch64' and sys_platform == 'linux') or (platform_machine == 'x86_64' and sys_platform == 'linux')
+    # via cuda-toolkit
+nvidia-cufile==1.17.1.22 ; (platform_machine == 'aarch64' and sys_platform == 'linux') or (platform_machine == 'x86_64' and sys_platform == 'linux')
+    # via cuda-toolkit
+nvidia-cusolver==12.2.0.11 ; (platform_machine == 'aarch64' and sys_platform == 'linux') or (platform_machine == 'x86_64' and sys_platform == 'linux')
+    # via cuda-toolkit
+nvidia-cusparse==12.7.10.12 ; (platform_machine == 'aarch64' and sys_platform == 'linux') or (platform_machine == 'x86_64' and sys_platform == 'linux')
+    # via
+    #   cuda-toolkit
+    #   nvidia-cusolver
+nvidia-cusparselt-cu13==0.8.1 ; sys_platform == 'linux'
+    # via torch
+nvidia-nccl-cu13==2.30.7 ; sys_platform == 'linux'
+    # via torch
+nvidia-nvjitlink==13.5.37 ; (platform_machine == 'aarch64' and sys_platform == 'linux') or (platform_machine == 'x86_64' and sys_platform == 'linux')
+    # via
+    #   cuda-toolkit
+    #   nvidia-cufft
+    #   nvidia-cusolver
+    #   nvidia-cusparse
+nvidia-nvshmem-cu13==3.7.2 ; sys_platform == 'linux'
+    # via torch
+nvidia-nvtx==13.2.86 ; (platform_machine == 'aarch64' and sys_platform == 'linux') or (platform_machine == 'x86_64' and sys_platform == 'linux')
+    # via cuda-toolkit
+openai==3.46.0
+    # via foxclaw (pyproject.toml)
+opentelemetry-api==1.45.2
+    # via
+    #   anthropic
+    #   fastapi
+packaging==26.3
+    # via
+    #   faiss-cpu
+    #   huggingface-hub
+    #   transformers
+pycparser==3.12 ; implementation_name != 'PyPy' and platform_python_implementation != 'PyPy'
+    # via cffi
+pydantic==2.14.3
+    # via
+    #   foxclaw (pyproject.toml)
+    #   anthropic
+    #   fastapi
+    #   mcp
+    #   openai
+    #   pydantic-settings
+pydantic-core==2.50.4
+    # via pydantic
+pydantic-settings==2.16.2
+    # via mcp
+pygments==2.21.0
+    # via rich
+pyjwt==2.15.1
+    # via mcp
+python-dotenv==1.2.4
+    # via
+    #   foxclaw (pyproject.toml)
+    #   pydantic-settings
+python-multipart==0.0.33
+    # via mcp
+pywin32==312 ; sys_platform == 'win32'
+    # via mcp
+pyyaml==6.0.3
+    # via
+    #   foxclaw (pyproject.toml)
+    #   huggingface-hub
+    #   transformers
+referencing==0.37.0
+    # via
+    #   jsonschema
+    #   jsonschema-specifications
+regex==2026.11.9
+    # via transformers
+rich==15.0.0
+    # via
+    #   foxclaw (pyproject.toml)
+    #   typer
+rpds-py==2026.9.1
+    # via
+    #   jsonschema
+    #   referencing
+safetensors==0.8.0
+    # via transformers
+scikit-learn==1.9.1
+    # via
+    #   foxclaw (pyproject.toml)
+    #   sentence-transformers
+scipy==1.18.1
+    # via
+    #   scikit-learn
+    #   sentence-transformers
+sentence-transformers==6.2.0
+    # via foxclaw (pyproject.toml)
+setuptools==84.2.1
+    # via torch
+shellingham==1.5.4
+    # via typer
+sniffio==1.3.1
+    # via
+    #   anthropic
+    #   httpx
+    #   openai
+sse-starlette==3.7.0
+    # via mcp
+starlette==1.10.0
+    # via
+    #   fastapi
+    #   mcp
+    #   sse-starlette
+sympy==1.14.0
+    # via torch
+threadpoolctl==3.8.0
+    # via scikit-learn
+tokenizers==0.23.3
+    # via
+    #   sentence-transformers
+    #   transformers
+torch==2.15.0
+    # via sentence-transformers
+tqdm==4.70.1
+    # via
+    #   huggingface-hub
+    #   sentence-transformers
+    #   transformers
+transformers==5.22.2
+    # via sentence-transformers
+triton==3.9.0 ; python_full_version < '3.16' and sys_platform == 'linux'
+    # via torch
+truststore==0.10.5 ; sys_platform != 'emscripten'
+    # via
+    #   httpcore2
+    #   httpx2
+typer==0.28.0
+    # via transformers
+typing-extensions==4.16.0
+    # via
+    #   anthropic
+    #   anyio
+    #   fastapi
+    #   httpx2
+    #   huggingface-hub
+    #   mcp
+    #   openai
+    #   opentelemetry-api
+    #   pydantic
+    #   pydantic-core
+    #   pydantic-settings
+    #   referencing
+    #   sentence-transformers
+    #   starlette
+    #   torch
+    #   typing-inspection
+typing-inspection==0.4.5
+    # via
+    #   fastapi
+    #   mcp
+    #   pydantic
+    #   pydantic-settings
+uvicorn==0.54.0
+    # via
+    #   foxclaw (pyproject.toml)
+    #   mcp
+websockets==17.4
+    # via foxclaw (pyproject.toml)

package/python/tests/conftest.py

@@ -16,26 +16,10 @@ _REPO_ROOT = Path(__file__).parent.parent
 if str(_REPO_ROOT) not in sys.path:
     sys.path.insert(0, str(_REPO_ROOT))
 
-# ── HKC vendor 隔离 ────────────────────────────────────────────────────────────
-# IDE/Cursor 等 shim 常把 `C:\GitHub\foxclaw-hkc\src` 注入到 sys.path 第一位,
-# 而那是上游低质量代码、跟本项目 vendor/hkc/ 是不同等级。**测试必须打 vendor 真代码**,
-# 否则会出现 tests/test_vendor_path_isolation.py 里那类「绿了但打错对象」的事故。
-# 把 vendor/hkc 强制插到 sys.path[0](即使 shim 在前也覆盖之),后续 `import hkc_*`
-# 全部解析到本仓库 vendor 副本。foxclaw.knowledge 自身也调 _ensure_hkc_importable()
-# 做同样事,但那只在 import foxclaw.knowledge 之后才生效;本测试文件顶层直接
-# import hkc_search 早于它,故在 conftest 阶段就注入更稳。
 _VENDOR_HKC = _REPO_ROOT / "vendor" / "hkc"
 if _VENDOR_HKC.exists() and str(_VENDOR_HKC) not in sys.path:
     sys.path.insert(0, str(_VENDOR_HKC))
 
-# ── 规避 pytest 在 Windows + Python 3.14 下的 junction 清理 bug ────────────────
-# pytest 用 Path.symlink_to() 创建 `pytest-current` / `test_*current` 目录 junction
-# 作为「指向最新临时目录」的便利链接。Windows 会把这类 junction 标记为
-# 「不受信任的装入点(untrusted mount point)」,Python 3.14 的 ntpath.realpath 在
-# pytest_sessionfinish 的 cleanup_dead_symlinks 里对它调用 Path.resolve() 时抛
-# WinError 448,并令 pytest 退出码变 1(测试本身全通过)。该 junction 仅作调试便利,
-# 不影响任何测试功能,故在 Windows 上禁用其创建(必须在 basetemp 建立前生效,
-# 而 conftest 的模块级代码早于 basetemp 创建执行,时序安全)。
 if sys.platform == "win32":
     import _pytest.pathlib as _ppl
 
@@ -44,10 +28,7 @@ if sys.platform == "win32":
 
     _ppl._force_symlink = _skip_force_symlink
 
-# ── 环境隔离(与 run_all.py 的 env 注入保持一致,强制覆盖继承环境)──────────────
-# FOXCLAW_SKIP_DOTENV=1:让 api.py 完全不读项目根 .env,防止真实 Key 灌回 / 写真实数据目录。
 os.environ["FOXCLAW_SKIP_DOTENV"] = "1"
-# 锁 shadow 轮数、stub 嵌入、关 MCP、清 provider/model:回归保持离线/免费/确定性。
 os.environ["FOXCLAW_SHADOW_ROUNDS"] = "50"
 os.environ["HF_HUB_OFFLINE"] = "1"
 os.environ["TRANSFORMERS_OFFLINE"] = "1"
@@ -55,13 +36,10 @@ os.environ["HKC_EMBEDDING"] = "stub"
 os.environ["FOXCLAW_MCP_SERVER"] = "0"
 os.environ["FOXCLAW_PROVIDER"] = ""
 os.environ["FOXCLAW_MODEL"] = ""
-# 清空外部 API key(第二道防线):鉴权/网关测试要自行控制 FOXCLAW_API_KEY。
 for _k in ("DEEPSEEK_API_KEY", "ANTHROPIC_API_KEY", "OPENAI_API_KEY",
            "GOOGLE_API_KEY", "DASHSCOPE_API_KEY", "FOXCLAW_API_KEY"):
     os.environ[_k] = ""
 
-# 兜底:为未自设 FOXCLAW_DATA_DIR 的测试提供一个临时目录,避免 KeyError。
-# (各测试文件顶层通常会自行 mkdtemp 覆盖此值,此处仅作安全网。)
 os.environ.setdefault("FOXCLAW_DATA_DIR", tempfile.mkdtemp(prefix="foxclaw_test_"))
 
 

package/python/tests/run_all.py

@@ -11,11 +11,6 @@ import tempfile
 import time
 from pathlib import Path
 
-# Windows GBK 控制台无法编码 ✓/✗(✓/✗)等字符 → 运行器自己把 stdout/stderr 切到
-# utf-8,不依赖调用者预先 set PYTHONUTF8。否则打印结果时 UnicodeEncodeError 直接崩掉汇总。
-# line_buffering=True:本文件由 run_all 汇总输出,单个测试跑满 300s 时整轮可达十余分钟;
-# 若不开行缓冲,`python tests/run_all.py > log.txt` 会因块缓冲而**全程看不到进度**,
-# 只能等结束。开启后每条结果即时落盘,可 tail -f 观察。
 for _s in (sys.stdout, sys.stderr):
     try:
         _s.reconfigure(encoding="utf-8", line_buffering=True)
@@ -32,11 +27,10 @@ TESTS = [
     ("test_itinerary.py",    "B · 行程内核"),
     ("test_orchestration.py","主管编排 + 跨 Agent"),
     ("test_skills.py",       "助手 Skill 接入层"),
+    ("test_skills_fetch.py", "技能安装(ClawHub/GitHub/URL/本地包)"),
     ("test_kernel.py",       "内核新模块回归"),
     ("test_governance.py",   "运行时治理(幂等/恢复/队列/压缩/循环/钩子)"),
-    # —— M5 新增:压缩器工具消息配对(防孤立 tool_call 致 provider 400)——
     ("test_compaction_toolpair.py", "M5·压缩器工具消息配对(原子组切分+畸形输入安全降级)"),
-    # —— M4 新增:工具入参校验 + permission Stage 1 真正生效 ——
     ("test_tool_params.py",  "M4·工具入参校验(执行侧 schema/Stage1/解析失败可见)"),
     ("test_shared_write.py", "P0-3 · 共享层写入策略(audit/warn/enforce)"),
     ("test_audit_sink.py",   "P0-3 · 审计落盘 sink(环形缓冲外的持久样本)"),
@@ -97,29 +91,24 @@ TESTS = [
     ("test_evidence_semantic.py", "证据融合语义化(否定词边界·幻影矛盾·语义支持边·降级)"),
     ("test_domain_evals.py", "领域推理评测(漏报/误报率+误报归因到规则+规则实例隔离)"),
     ("test_negotiation.py",  "智能体层·跨域协商闭环(被拒→让步→再裁决·有界·拒绝不降级)"),
-    # —— 以下 4 项此前遗漏于本运行器（P4-4 修复）——
     ("test_tool_use.py",        "P2·function-calling 工具化(多轮工具循环/注册表/降级)"),
     ("test_injection_guard.py", "提示词注入纵深防御(检出/wrap_untrusted/内核前缀/隔离)"),
+    ("test_agent_rules.py",     "Agent 规则文件启动注入(按 AGENT_ID 读盘/顺序/回退开关/包内路径)"),
     ("test_sessions.py",        "会话存储(增删改查/标题提炼/路径穿越/并发追加)"),
     ("test_stats_and_events.py","记忆统计 + 活动事件(hmr.stats 计数修复/chat.completed)"),
-    # —— 以下 4 项为近期新功能测试，此前遗漏于本运行器（接线）——
     ("test_llm_planner.py",            "P0-1·LLM 驱动规划器(llm_plan/replan·opt-in+fail-safe+sv_replan)"),
     ("test_anthropic_tools.py",        "P0-2·Anthropic tool_use 原生接入(格式转换/解析/回灌/降级)"),
     ("test_taint.py",                  "数据污点追踪+动态审批门槛(污点分级/传播/TAINT_CONFIRM)"),
     ("test_mcp_guardian_discovery.py", "MCP 发现进守门人(凭证不出主进程·代发现·序列化)"),
     ("test_verify_evidence.py",        "三个薄点·失败策略表/执行后核验/执行证据(重试只限只读)"),
     ("test_evidence_sse.py",           "执行凭据 SSE 命名事件(与正文分离·纯对话不发)"),
+    ("test_profile.py",                "称呼(user profile)存取:写入/替换/清空/不误删偏好"),
+    ("test_update_check.py",           "新版本检查:默认关/版本比较/24h 缓存/失败静默"),
 ]
 
-# S2 迁移完成:全部测试均已迁移为 pytest(见 pyproject [tool.pytest.ini_options] 白名单)。
-# 故下面所有文件统一用 `python -m pytest <file> -q` 跑,且**每个文件独立子进程**:
-# 网关/内置MCP/流式限流等测试依赖模块级单例,同一进程内会被首个 import 定死、相互污染。
 
 def main():
     here = Path(__file__).parent
-    # ── 命令行:支持 --list / --only <substr>(M7)──────────────────────
-    # 为什么需要:全量回归 6-7 分钟,改一行代码后只想验 1-2 个文件时成本过高。
-    # 此前只能整跑,拖慢了「改完立刻验」的内循环(这也是很多缺陷被放过的原因之一)。
     _argv = sys.argv[1:]
     global TESTS
     if "--list" in _argv:
@@ -137,41 +126,14 @@ def main():
         _before = len(TESTS)
         TESTS = [(f, d) for f, d in TESTS if _only in f or _only in d]
         print(f"[filter] '{_only}' 匹配 {len(TESTS)}/{_before} 项\n")
-    # HF_HUB_OFFLINE:装了 sentence-transformers 时,每个 Foxclaw() 会载入 all-MiniLM
-    # 模型 6 次(5 Harness + 1 HMR embedding),且每次都向 HF Hub 发未认证网络请求——
-    # 即便模型已缓存。实测让单次 init 从 ~44s 降到 ~7s,并去除网络抖动(否则被 HF 限流时
-    # 某个子测试会顶穿 300s 超时)。模型已本地缓存,离线读取即可;未缓存时 Harness 会自动
-    # 降级 n-gram 哈希嵌入,不影响测试判定。PYTHONUTF8:防 Windows GBK 控制台的 ✓/✗ 编码错。
-    # ── 测试环境隔离(必须放在最前,否则回归不可复现)────────────────────────
-    # FOXCLAW_SKIP_DOTENV=1:让 api.py 完全不读项目根目录的 .env。
-    #   为什么不能只靠下面那些空字符串:.env 的加载是 load_dotenv(override=False),
-    #   它只保护「当前进程里已存在的键」。但测试常常要 pop 掉某键来验证「未设时的行为」
-    #   (如 test_gateway.py / test_api_auth.py pop FOXCLAW_API_KEY),pop 完再 import api,
-    #   .env 就会把键灌回来 —— 空字符串挡不住这种路径。
-    #   实测证据:对照树(0 改动)+ 含 FOXCLAW_API_KEY 的 .env → test_gateway 报
-    #   KeyError: 'enabled';同树删掉 .env → 通过。故必须在源头关掉 .env。
-    #   另:开发者 .env 里有真实 Key 与 FOXCLAW_DATA_DIR=./foxclaw_data,不隔离会让测试
-    #   真的打外部 API(花钱)并写进真实数据目录。
-    # 下面显式置空的 key 作为**第二道防线**,覆盖那些会 import 本运行器 env dict
-    # 或直接读 os.environ 的路径(且便于单独运行单个测试文件时也保持确定性)。
     env = dict(os.environ, FOXCLAW_SHADOW_ROUNDS="50",
                HF_HUB_OFFLINE="1", TRANSFORMERS_OFFLINE="1",
                PYTHONUTF8="1", PYTHONIOENCODING="utf-8",
                FOXCLAW_SKIP_DOTENV="1",
-               # 强制 stub:回归保持离线/免费/确定性。鉴权与网关必须为「未设」态——
-               # test_api_auth / test_gateway 要自行控制 FOXCLAW_API_KEY,这里先兜底清空。
                DEEPSEEK_API_KEY="", ANTHROPIC_API_KEY="", OPENAI_API_KEY="",
                GOOGLE_API_KEY="", DASHSCOPE_API_KEY="", FOXCLAW_API_KEY="",
-               # .env 里 FOXCLAW_MCP_SERVER=1 会让 api.py 在 import 时构建 MCP 服务器,
-               # 而 test_tracing.py 有两处 `with TestClient(app)`(82/189 行),第二次进
-               # lifespan 会撞 StreamableHTTPSessionManager「.run() can only be called
-               # once per instance」。回归默认关;test_mcp_server.py 自己会置 1。
                FOXCLAW_MCP_SERVER="0",
-               # 锁 stub 模型路由:.env 里 FOXCLAW_PROVIDER=openai/FOXCLAW_MODEL=abab6.5s-chat
-               # 是开发者的真实配置,回归不继承(否则路由判定随机器变化)。
                FOXCLAW_PROVIDER="", FOXCLAW_MODEL="",
-               # 产品默认 HKC_EMBEDDING=auto(真语义),但回归锁 stub 保确定+快;
-               # 真语义单独由 test_semantic.py 显式验证。
                HKC_EMBEDDING="stub")
     print("=" * 64)
     print("Foxclaw · 全量回归测试")
@@ -194,34 +156,16 @@ def main():
         if not path.exists():
             results.append((desc, "缺失", 0)); continue
         t0 = time.time()
-        # 每个文件用**独立的 basetemp**,不共用 %TEMP%\pytest-of-<user> 根目录。
-        # 为什么:Windows 上该根目录一旦留下损坏的 reparse point(实测 pytest-current
-        # unlink 报 WinError 5),pytest 会在 sessionfinish 的 cleanup_numbered_dir 阶段
-        # 抛 PermissionError —— 断言全过也返回非 0,7 个文件同时假红,真回归被淹没。
-        # 显式 basetemp 后 pytest 不再遍历/清理共用根目录;目录必须预先存在(pytest 不会
-        # 为 --basetemp 建父目录,缺了直接 FileNotFoundError),故用 mkdtemp 建好再传。
         _bt = Path(tempfile.mkdtemp(prefix="foxclaw-pt-"))
         try:
-            # 统一走 pytest(每文件独立子进程,隔离模块级单例)。
             _cmd = [sys.executable, "-m", "pytest", str(path), "-q",
                     f"--basetemp={_bt}"]
-            # 显式 utf-8 解码子进程输出:子进程已被 PYTHONUTF8=1 强制输出 utf-8,
-            # 父进程若用 Windows 默认 GBK 解码会 UnicodeDecodeError(模型加载进度条等
-            # 含非 GBK 字节)→ r.stdout 变 None → 后续拼接 TypeError。errors=replace 兜底。
             r = subprocess.run(_cmd,
                                capture_output=True, text=True, timeout=300, env=env,
                                encoding="utf-8", errors="replace")
             ok = r.returncode == 0
-            # 简单判定:退出码 0 且输出里没有 Traceback
             if "Traceback" in (r.stdout + r.stderr):
                 ok = False
-            # 原生库偶发崩溃的精准重试:Windows 访问冲突 0xC0000005
-            # 是 torch/FAISS/ST 在模型重加载或解释器 teardown 阶段的进程级崩溃——
-            # 无 Python Traceback、与断言失败(exit=1)互不混淆,故只对它在同一干净
-            # 环境下重试一次(批次4/7 均实锤:基线对照同样崩溃,与业务改动无关;
-            # 手动小范围跑全绿,全量回归高内存压力下概率显著升高)。
-            # 注意:subprocess 在 Windows 返回无符号 DWORD(0xC0000005=3221225477),
-            # PowerShell $LASTEXITCODE 则按有符号显示(-1073741819),两种都表示同一崩溃。
             _ACCESS_VIOLATION = (3221225477, -1073741819)
             if not ok and r.returncode in _ACCESS_VIOLATION and \
                     "Traceback" not in (r.stdout + r.stderr):
@@ -233,20 +177,14 @@ def main():
                     print(f"  ↻ {desc} 首次 0xC0000005 原生崩溃,重试通过(已知环境性偶发)")
             results.append((desc, "通过" if ok else "失败", time.time() - t0))
             if not ok:
-                # 打印 15 行而非 3 行:pytest 的 collection error(如缺依赖)把原因
-                # 放在 traceback 中段,只截最后 3 行会只剩「ERROR xxx.py」+「Interrupted」,
-                # 在 CI 里完全无法定位(2026-10-17 实际踩过:CI 红但日志看不出缺 faiss)。
                 tail = (r.stdout + r.stderr).strip().splitlines()[-15:]
                 print(f"  ✗ {desc} 失败:")
                 for line in tail: print(f"      {line}")
-                # 失败时落盘完整输出,便于复现/定位偶发失败(尤其 teardown 期崩溃)。
                 (here / f"_fail_{fn}.txt").write_text(
                     r.stdout + r.stderr, encoding="utf-8")
         except subprocess.TimeoutExpired:
             results.append((desc, "超时", 300))
         finally:
-            # basetemp 是本文件专用的一次性目录:正常结束由 pytest 自己清,
-            # 子进程崩溃/超时会残留,这里统一回收。ignore_errors 兜 Windows 文件占用。
             shutil.rmtree(_bt, ignore_errors=True)
         print(f"  {'✓' if results[-1][1]=='通过' else '✗'} {desc:<28} [{results[-1][1]}] {results[-1][2]:.0f}s")