control-harness

LLM（KIMI K3 / Claude）驱动的 agent loop harness：自然语言 → 校验通过的 craft.js-vue「选择本地组件」可导入的本地组件 JSON 文件。

自然语言描述 → LLM 生成 → schema 校验(失败回喂自修复) → 写盘 .json
→ craft.js-vue「选择本地组件」导入 → 画布可用

快速开始

# 安装（全局，注册命令 control-harness 和 cch）
npm install -g control-harness

# 配置 API key（一次配置，全局生效；也可直接用环境变量 OPENAI_API_KEY）
cch config init
cch config set apiKey sk-kimi-...

# 交互模式（Claude Code 风格，保留会话历史）
cch

# 单次模式
cch "一个深色主题的返回按钮组件"

要求 Node 18+（使用原生 fetch）。KIMI 默认端点 https://api.kimi.com/coding/v1， 配置优先级：CLI 参数 > 环境变量 > ~/.control-harness/config.json > 内置默认值。

交互模式斜杠命令：/help /model /provider /out /clear /exit。

完整手册：docs/使用指南.md

从源码开发

npm install
npm run build && npm link

验证

npx tsc --noEmit                    # 类型检查（strict）
npx tsx scripts/smoke-contract.ts   # 契约：craft.js-vue 官方 20 个示例 100% 通过
npx tsx scripts/smoke-loop.ts       # 闭环：MockProvider 端到端（非法写被拦截 / 合法写落盘）
npx tsx scripts/smoke-config.ts     # 配置：flag > env > 全局配置文件 > 默认值

架构

| 模块 | 职责 | |------|------| | src/providers/ | Anthropic Messages API + OpenAI 兼容（KIMI），统一 Provider 接口 | | src/loop/agentLoop.ts | agent loop：tool_use → 执行 → tool_result 回喂，≤20 turns | | src/tools/ | 4 个工具：list_component_types / read_example_component / validate_component_json / write_component_file（校验不过绝不写盘） | | src/contract/ | 单一事实源：Zod schema（镜像 craft.js-vue 类型）、34 项 type 白名单（取自 componentTypes.ts）、few-shot 示例、系统 prompt |

设计基准

实施计划与验收清单：docs/component-harness-plan.md