test: make Steam fixture interpreter explicit

.github/workflows/plugin-api-v3.yml

@@ -55,6 +55,7 @@ jobs:
       - name: Verify Steam v3 composition and migration
         env:
           AKASHIC_AGENT_ROOT: .akashic-core
+          AKASHIC_PLUGIN_FIXTURE_PYTHON: ${{ github.workspace }}/mcp/.venv/bin/python
           PYTHONPATH: .akashic-core:mcp:mcp/.venv/lib/python3.13/site-packages
         run: mcp/.venv/bin/python -m pytest -q mcp/tests tests
       - name: Check changed v3 sources

context_source.py

@@ -12,7 +12,7 @@
 from agent.lifecycle.types import BeforeTurnCtx
 from agent.plugin_composition import HealthHandle, PluginTimers
 
-from steam_runtime import backend
+from .steam_runtime import backend
 
 
 class SteamContextRuntime:

plugin.py

@@ -12,7 +12,7 @@
     McpServerDefinition,
 )
 
-from context_source import SteamContextRuntime
+from .context_source import SteamContextRuntime
 
 
 class SteamConfig(BaseModel):

steam_runtime/backend.py

@@ -12,7 +12,7 @@
 from urllib.parse import urlencode
 from urllib.request import urlopen
 
-from steam_runtime.config import SteamRuntimeConfig, load_runtime_config
+from .config import SteamRuntimeConfig, load_runtime_config
 
 
 _DB_NAME = "steam_proactive.sqlite3"

tests/conftest.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+from types import ModuleType
+
+
+repo_root = Path(__file__).resolve().parents[1]
+package = ModuleType("steam_test_plugin")
+package.__path__ = [str(repo_root)]
+package.__package__ = "steam_test_plugin"
+sys.modules["steam_test_plugin"] = package

tests/test_context_source.py

@@ -11,8 +11,8 @@
 from agent.control.timer import TimerReceipt, TimerStatus
 from agent.lifecycle.types import BeforeTurnCtx
 from agent.plugin_composition import PluginTimers
-from context_source import SteamContextRuntime
-from steam_runtime import backend
+from steam_test_plugin.context_source import SteamContextRuntime  # pyright: ignore[reportMissingImports]
+from steam_test_plugin.steam_runtime import backend  # pyright: ignore[reportMissingImports]
 
 
 class _TimerHandle:

tests/test_manager_integration.py

@@ -3,9 +3,9 @@
 import asyncio
 import hashlib
 import json
+import os
 import shutil
 import sqlite3
-import sys
 from datetime import UTC, datetime
 from pathlib import Path
 
@@ -71,8 +71,9 @@ async def _eventually(predicate) -> None:
 
 
 def _stage_plugin(tmp_path: Path) -> Path:
-    """复制真实 Steam 插件并复用当前测试解释器。"""
+    """复制真实 Steam 插件并链接调用方声明的 artifact 运行时。"""
 
+    runtime = Path(os.environ["AKASHIC_PLUGIN_FIXTURE_PYTHON"]).parent.parent
     source = tmp_path / "plugins" / "steam"
     shutil.copytree(
         ROOT,
@@ -87,11 +88,38 @@ def _stage_plugin(tmp_path: Path) -> Path:
             "tests",
         ),
     )
-    runtime = Path(sys.executable).parent.parent
     (source / "mcp" / ".venv").symlink_to(runtime, target_is_directory=True)
     return source
 
 
+def test_stage_plugin_links_declared_fixture_runtime(
+    tmp_path: Path,
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    runtime = tmp_path / "artifact" / ".venv"
+    fixture_python = runtime / "bin" / "python"
+    fixture_python.parent.mkdir(parents=True)
+    fixture_python.touch()
+    monkeypatch.setenv("AKASHIC_PLUGIN_FIXTURE_PYTHON", str(fixture_python))
+
+    source = _stage_plugin(tmp_path)
+
+    assert (source / "mcp" / ".venv").readlink() == runtime
+
+
+def test_stage_plugin_requires_fixture_python(
+    tmp_path: Path,
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    monkeypatch.delenv("AKASHIC_PLUGIN_FIXTURE_PYTHON", raising=False)
+
+    with pytest.raises(KeyError) as error:
+        _stage_plugin(tmp_path)
+
+    assert error.value.args == ("AKASHIC_PLUGIN_FIXTURE_PYTHON",)
+    assert not (tmp_path / "plugins").exists()
+
+
 def _config(data_root: Path) -> Path:
     data_root.mkdir(parents=True, exist_ok=True)
     path = data_root / "steam_mcp_config.json"

tests/test_plugin.py

@@ -4,8 +4,8 @@
 from pathlib import Path
 from typing import cast
 
-import plugin
 import pytest
+from steam_test_plugin import plugin  # pyright: ignore[reportMissingImports]
 from agent.control.timer import OneShotTimer
 from agent.plugin_composition import (
     MCP_SERVERS,