开始使用

先走完一轮

打开首页，保留 FPGA × 城市规划，点击“开始碰撞”。结果明确显示本地规则演示。选择任意碎片，查看关系与边界，再点击“带着它继续碰撞”。切换到结构映射和实验草案查看不同层次的输出。

能量只控制“换个碰撞对象”时的抽样区间；手动指定目标不受其限制。示例词包向量为人工特征，只用于起始定位与交互验证。

接自己的模型

右上角 → 生成模型 → 选择协议、API Base URL、模型 ID、API key → 应用配置 → 开启“使用我的模型”。Chat/Responses 可流式输出；通用 JSON 接口在完整返回后显示结构化结果。

DeepSeek 示例：协议 openai-chat，地址 https://api.deepseek.com，模型 deepseek-flash，填写自己的 key。模型 ID 以自己账户为准，可获取列表，也可手填。公网必须使用 HTTPS 入口。

模型 key 刷新即清除，不会从别的项目自动读取 key。关闭网页后重要结果请先导出。

选择性增加能力

判断：在设置中填 Jev 或聊天模型，勾选“换碰撞对象时启用判断重排”。当前档位内最多 12 个候选得到重排；高置信度不代表高质量。

Embedding：先导入或编辑词包，再配置兼容 Embedding 的模型。点击“生成 Embedding”，确认发送范围与费用。成功后导出词包；后续可以直接导入，无需每次重算。

搜索：搜索默认关闭。设置 Exa、启用 JSON 输出的 SearXNG 或通用只读工具。也可直接粘贴文本。提取模型给出待确认概念，点击合并后来源与词条进入本机词包。合并后清除旧向量，避免空间混用。

做自己的质量实验

切换到“实验与记录”。离线机制报告已经生成。在线配对实验使用当前概念对和自己的生成 key；每轮三个模型请求。完成后先对匿名草案的“新颖、可用、连贯”打分，再揭盲并导出。完整组两次调用、直接组一次调用，不应忽略成本差异。

故障排查

出现“无有效结构”或格式错误：查看流式记录，检查模型是否按提示输出逐行 JSON；不要把格式错误当成无创意。服务不会自动改用模板。

模型列表不可用：手填官方模型 ID。部分服务没有 /models。

维度不一致：确认同一模型与文本配方，重新生成整包向量。导入上限同时受概念数量和 16MB 文件大小约束。

429：并发或频率达到演示服务限制。当前为轻量共享实例，应减少批量任务或自行部署。

Docker 后的 HTTPS 检测：反向代理连接来源可能是 bridge 网关 IP，需由管理员在 IC_TRUST_PROXY_IPS 填入该精确 IP。不要设置任意来源可信。

快速部署

npm ci
npm test
npm run ablate
HOST=127.0.0.1 PORT=8792 npm start

浏览器打开 http://localhost:8792。生产操作详见 DEPLOYMENT.md，接口详见 CONTRACTS.md。