统一本项目（dsh-koboldcpp-hands）及与 DeepSeek Harness（dsh）、KoboldCpp 协作时的术语。
与本机 KoboldCpp 项目库的术语表兼容（kcpps、GGUF、nocuda、Vulkan 定义一致），本表补充 harness 侧术语。
模型与启动
| 术语 | 含义 |
|---|
| kcpps 配置文件 | KoboldCpp 启动配置（JSON，.kcpps），内含 model_param（GGUF 路径）、后端字段、port_param、mmproj。勿称"模型文件" |
| GGUF 模型 | 实际模型文件（.gguf），由 kcpps model_param 指向 |
| mmproj | 多模态投影器（.gguf），视觉能力前提；在 kcpps mmproj 字段配置 |
| backend | GPU 加速方式（CUDA/Vulkan/OpenCL/CPU）；由 kcpps 决定，插件不探测不注入 |
| exePath / kcppsPath | 插件配置项：可执行文件 / kcpps 绝对路径（用户自配；环境变量 KOBOOLDCPP_EXE / KOBOOLDCPP_KCPPS 兜底） |
| owned（归属） | 服务器是否由本插件 spawn；只有 owned 才可能被插件停止 |
| 进程树终止 | Windows taskkill /PID <pid> /T /F；KoboldCpp 自我派生子进程，必须杀树 |
| stopBehavior | exit（harness 退出停服）/ idle（空闲超时停服）/ never（不停） |
| 术语 | 含义 |
|---|
| 工具（tool） | ctx.tools 注册的模型可调用函数；本插件注册 koboldcpp_run / koboldcpp_vision。勿称"API 接口" |
| canonical value | 工具 execute 返回的结构化 JSON 值（经 output.schema 验证） |
| render | canonical value → 模型可见文本的纯函数投影 |
| presentCall / presentResult | UI 卡片渲染意图（纯函数，可回放） |
| exec.signal | 工具执行取消信号；execute 必须 forward 给异步操作 |
| fiber / effect / disposer | Cordis 生命周期单元 / 副作用注册 / 清理函数；disposer 幂等（调两次 no-op） |
| async disposer | 返回 Promise 的清理函数；fiber teardown 会等待它 |
| settings 段 | 用户设置文档中 llm-koboldcpp: 节，热更新覆盖插件配置 |
| Loader / cordis.yml / cordis.patch.yml | 插件加载器 / 组合文件（条目列表）/ 部署补丁（insert/update） |
| REAL-composition 测试 | 经真实 app boot → Loader → cordis.yml 的组合测试（testing.md 硬性要求） |
| LlmError | harness LLM 错误类（稳定 code，如 TRANSPORT/TIMEOUT） |
| isError | 工具结果失败标记（消息模型可见） |
| provider route | harness LLM 提供方注册名；本插件不注册 provider，只注册工具 |
行为与约定
| 术语 | 含义 |
|---|
| KV cache 单序列 | KoboldCpp 默认单序列缓存，并发请求有连接错误风险；工具默认 exclusive（串行）调度 |
| type-stripping | Node ≥ 23.6 直接运行 TS 源码（去类型注解）；不支持 parameter properties |
| rewriteRelativeImportExtensions | TS 5.7+ 编译选项：源码 .ts 导入构建时重写为 .js |
| fidelity 规则 | 视觉输出转发规则：不得润色/编造，保留不确定性 |