Feature/kimi local integration

CONTRIBUTING.md

@@ -185,6 +185,28 @@ uv run pytest
 uv run pytest tests/test_leader_event_runtime.py tests/test_leader_query_set.py
 ```
 
+- 若改动涉及真实 Docker Worker / Kimi 集成链路，优先补充并执行本地集成验证：
+
+```bash
+uv run --python python3.12 python scripts/run_kimi_local_integration.py
+```
+
+- 若需要把真实 Kimi 集成用例纳入 pytest，请显式打开：
+
+```bash
+RUN_KIMI_LOCAL_INTEGRATION=1 \
+OPENAI_BASE_URL="https://your-openai-compatible-endpoint" \
+OPENAI_API_KEY="your-api-key" \
+uv run --python python3.12 pytest -q tests/test_kimi_local_integration.py
+```
+
+- 提交前建议同步检查：
+
+```text
+docs/kimi-local-integration-checklist.md
+docs/kimi-local-integration-troubleshooting.md
+```
+
 - 涉及 Web 或联调改动时，至少确认开发环境可以正常启动：
 
 ```bash

README.en.md

@@ -137,6 +137,60 @@ Leader-specific regression suites:
 uv run pytest tests/test_leader_event_runtime.py tests/test_leader_query_set.py
 ```
 
+## Kimi Local Integration
+
+This repository now includes a real local-only Kimi Docker integration case.
+
+It verifies:
+
+- the real async `call_code_worker` path
+- Kimi execution inside Docker
+- local file creation inside the isolated worker workspace
+- structured JSON parsing from the Kimi response
+- no GitHub usage and no remote repository usage
+
+Config template:
+
+```bash
+configs/kimi-local-integration.env.example
+```
+
+Manual run:
+
+```bash
+set -a
+source configs/kimi-local-integration.env.example
+export OPENAI_BASE_URL="https://your-openai-compatible-endpoint"
+export OPENAI_API_KEY="your-api-key"
+set +a
+
+uv run --python python3.12 python scripts/run_kimi_local_integration.py
+```
+
+Optional pytest entrypoint:
+
+```bash
+RUN_KIMI_LOCAL_INTEGRATION=1 \
+OPENAI_BASE_URL="https://your-openai-compatible-endpoint" \
+OPENAI_API_KEY="your-api-key" \
+uv run --python python3.12 pytest -q tests/test_kimi_local_integration.py
+```
+
+Detailed guide:
+
+```text
+docs/kimi-local-integration.md
+```
+
+Supporting files:
+
+```text
+docs/kimi-local-integration-checklist.md
+docs/kimi-local-integration-troubleshooting.md
+scripts/run_kimi_local_integration.sh
+configs/kimi-local-integration.dashscope.env.example
+```
+
 ## Memory Storage
 
 Memory files are stored in a local `.memory/` directory (created lazily by runtime code):

README.md

@@ -142,7 +142,7 @@ npm run dev
 
 ## Real Docker Worker
 
-如果你希望 `leader` 真正把任务发给 Docker 中的 Codex Worker，建议先准备一个稳定的 Worker 镜像：
+如果你希望 `leader` 真正把任务发给 Docker 中的 CLI Worker，建议先准备一个稳定的 Worker 镜像：
 
 ```bash
 docker build -t code-terminator/worker-codex -f docker/worker-codex/Dockerfile .
@@ -163,6 +163,58 @@ Worker 执行时会：
 3. 启动 Docker 容器
 4. 把结果、stdout、stderr、内部日志都落盘
 
+### Kimi Local Integration Case
+
+仓库现在附带一个真实的本地集成用例，专门验证：
+
+- `call_code_worker` 真实异步链路
+- Docker 内启动 Kimi
+- 在隔离工作区写本地文件
+- hook 回传 `structured_output`
+- 全程不触发 GitHub 或远端仓库操作
+
+样例配置文件：
+
+```bash
+configs/kimi-local-integration.env.example
+```
+
+手动运行：
+
+```bash
+set -a
+source configs/kimi-local-integration.env.example
+export OPENAI_BASE_URL="https://your-openai-compatible-endpoint"
+export OPENAI_API_KEY="your-api-key"
+set +a
+
+uv run --python python3.12 python scripts/run_kimi_local_integration.py
+```
+
+如果你要把它作为真实 pytest 用例运行，需要显式打开：
+
+```bash
+RUN_KIMI_LOCAL_INTEGRATION=1 \
+OPENAI_BASE_URL="https://your-openai-compatible-endpoint" \
+OPENAI_API_KEY="your-api-key" \
+uv run --python python3.12 pytest -q tests/test_kimi_local_integration.py
+```
+
+详细说明见：
+
+```text
+docs/kimi-local-integration.md
+```
+
+辅助文件：
+
+```text
+docs/kimi-local-integration-checklist.md
+docs/kimi-local-integration-troubleshooting.md
+scripts/run_kimi_local_integration.sh
+configs/kimi-local-integration.dashscope.env.example
+```
+
 ## Configuration
 
 ### Core Runtime
@@ -222,6 +274,13 @@ Worker 执行时会：
 | `CODEX_WORKER_CONTAINER_NODE_ROOT` | `/opt/host-node` | 容器内挂载 Node 根目录 |
 | `CODEX_WORKER_DOCKER_ARGS` | 空 | 额外透传给 `docker run` 的参数 |
 
+Kimi 兼容别名：
+
+| 变量 | 默认值 | 说明 |
+| --- | --- | --- |
+| `KIMI_WORKER_DOCKER_IMAGE` | 空 | 优先于 `CODEX_WORKER_DOCKER_IMAGE` |
+| `KIMI_WORKER_BIN` | `kimi` | 优先于 `CODEX_WORKER_CODEX_BIN` |
+
 代理与网络相关的高级项：
 
 - `CODEX_WORKER_PASSTHROUGH_PROXY`

README.zh-CN.md

@@ -163,6 +163,64 @@ Worker 执行时会：
 3. 启动 Docker 容器
 4. 把结果、stdout、stderr、内部日志都落盘
 
+### Kimi 本地集成用例
+
+仓库现在附带了一个真实的本地 Kimi Docker 集成用例，专门验证：
+
+- `call_code_worker` 的真实异步链路
+- Docker 内部能正常拉起 Kimi
+- Worker 只在隔离工作区里写本地文件
+- hook 回传的 `structured_output` 可以被主流程正确解析
+- 全程不触发 GitHub 或远端仓库操作
+
+配置样例：
+
+```bash
+configs/kimi-local-integration.env.example
+```
+
+手动运行：
+
+```bash
+uv run --python python3.12 python scripts/run_kimi_local_integration.py
+```
+
+如果你希望显式指定 API 参数：
+
+```bash
+set -a
+source configs/kimi-local-integration.env.example
+export OPENAI_BASE_URL="https://your-openai-compatible-endpoint"
+export OPENAI_API_KEY="your-api-key"
+set +a
+
+uv run --python python3.12 python scripts/run_kimi_local_integration.py
+```
+
+如果你要把它作为真实 pytest 用例运行，需要显式开启：
+
+```bash
+RUN_KIMI_LOCAL_INTEGRATION=1 \
+OPENAI_BASE_URL="https://your-openai-compatible-endpoint" \
+OPENAI_API_KEY="your-api-key" \
+uv run --python python3.12 pytest -q tests/test_kimi_local_integration.py
+```
+
+详细说明见：
+
+```text
+docs/kimi-local-integration.md
+```
+
+辅助文件：
+
+```text
+docs/kimi-local-integration-checklist.md
+docs/kimi-local-integration-troubleshooting.md
+scripts/run_kimi_local_integration.sh
+configs/kimi-local-integration.dashscope.env.example
+```
+
 ## Configuration
 
 ### Core Runtime

configs/kimi-local-integration.dashscope.env.example

@@ -0,0 +1,8 @@
+# Example configuration for DashScope-compatible Kimi local integration runs.
+# Fill in your real API key before use.
+
+OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
+OPENAI_API_KEY="your-dashscope-api-key"
+KIMI_WORKER_DOCKER_IMAGE="kimi-cliagent-benchmark:latest"
+CODEX_WORKER_MODEL="qwen3.5-plus"
+RUN_KIMI_LOCAL_INTEGRATION="0"

configs/kimi-local-integration.env.example

@@ -0,0 +1,19 @@
+# Real local-only Kimi Docker integration smoke test.
+# This file is safe to commit because it contains placeholders only.
+
+# Optional: OpenAI-compatible endpoint used by Kimi inside Docker.
+# Leave empty if ~/.kimi/config.toml already contains the provider config.
+OPENAI_BASE_URL="https://your-openai-compatible-endpoint"
+
+# Optional: API key used by Kimi inside Docker.
+# Leave empty if ~/.kimi/config.toml already contains the provider config.
+OPENAI_API_KEY="your-api-key"
+
+# Optional: real worker image. Defaults to kimi-cliagent-benchmark:latest.
+KIMI_WORKER_DOCKER_IMAGE="kimi-cliagent-benchmark:latest"
+
+# Optional: model passed to the Kimi CLI.
+CODEX_WORKER_MODEL="qwen3.5-plus"
+
+# Optional: enables the real pytest wrapper.
+RUN_KIMI_LOCAL_INTEGRATION="0"

configs/kimi-local-integration.host-config.env.example

@@ -0,0 +1,6 @@
+# Minimal configuration for running the local-only Kimi integration
+# entirely from the host ~/.kimi/config.toml setup.
+
+KIMI_WORKER_DOCKER_IMAGE="kimi-cliagent-benchmark:latest"
+CODEX_WORKER_MODEL="qwen3.5-plus"
+RUN_KIMI_LOCAL_INTEGRATION="0"

docs/kimi-local-integration-artifacts.md

@@ -0,0 +1,18 @@
+# Kimi Local Integration Artifacts
+
+The local-only integration case writes its artifacts into the isolated worker job directory.
+
+Expected files:
+
+- `leader-task.md`
+- `leader-task.json`
+- `leader-task.result.txt`
+- `codex.stdout.log`
+- `codex.stderr.log`
+- `codex.internal.log`
+- `docker.stdout.log`
+- `docker.stderr.log`
+- `artifacts/local-case/report.txt`
+- `artifacts/local-case/summary.json`
+
+The script also prints the resolved job directory in its JSON output so the artifacts can be inspected after a run with `--keep-artifacts`.

docs/kimi-local-integration-checklist.md

@@ -0,0 +1,17 @@
+# Kimi Local Integration Checklist
+
+Before running the real local-only Kimi integration case, confirm:
+
+- Docker daemon is reachable
+- image `kimi-cliagent-benchmark:latest` exists locally or an equivalent image is configured
+- host Kimi config exists at `~/.kimi/config.toml`, or `OPENAI_BASE_URL` and `OPENAI_API_KEY` are exported
+- the repository is on the intended branch
+- no GitHub token is required for this test
+
+Recommended commands:
+
+```bash
+docker images | grep kimi-cliagent-benchmark
+test -f ~/.kimi/config.toml && echo KIMI_CONFIG=OK || echo KIMI_CONFIG=MISSING
+uv run --python python3.12 python scripts/run_kimi_local_integration.py
+```

docs/kimi-local-integration-troubleshooting.md

@@ -0,0 +1,31 @@
+# Kimi Local Integration Troubleshooting
+
+## `ModuleNotFoundError: No module named 'src'`
+
+Run the integration from repository root, or use:
+
+```bash
+uv run --python python3.12 python scripts/run_kimi_local_integration.py
+```
+
+The committed script already prepends the project root to `sys.path`.
+
+## `Missing Kimi config at /host-kimi/config.toml`
+
+Either:
+
+- create and validate `~/.kimi/config.toml`
+- or export `OPENAI_BASE_URL` and `OPENAI_API_KEY`
+
+## Worker returns `completed` but `structured_output` is empty
+
+The worker expects JSON. Kimi may wrap JSON in fenced code blocks. This repository now strips fenced markers before parsing, so update to the latest branch state if you still see this.
+
+## Unexpected GitHub side effects
+
+This local integration flow intentionally clears:
+
+- `GH_TOKEN`
+- `GITHUB_TOKEN`
+
+If you still see GitHub activity, check for local script modifications or a different worker task payload.