Skip to content

README_zh.md

Latest commit

 

History

History
94 lines (65 loc) · 4.43 KB

README_zh.md

File metadata and controls

94 lines (65 loc) · 4.43 KB
Raw

RimMind-Extension-ModelService 🌐

专为 RimWorld 1.6 打造的扩展模型网关、OpenCode Go 订阅直连与 Anthropic 缓存协议适配

English | 简体中文

RimWorld 1.6 依赖: RimMind-Core 单元测试 License: MIT

工业级多模型接入中枢：OpenCode Go 订阅直连、Anthropic 临时缓存标记、本地回环安全网关与无感容灾负载均衡。

📖 模块概览

RimMind-Extension-ModelService 是 RimMind-Core 的高级模型服务扩展模组。它引入了极速云端订阅直连、本地订阅代理回环安全防护、尖端大模型缓存协议以及零停机的多节点容灾负载均衡机制。

核心特性

  • OpenCode Go 订阅直连：通过 OpenCodeGoClientFactory 一键切换 OpenCode Go 专属端点（https://opencode.ai/zen/go/v1），自动注入会话隔离请求头（x-opencode-session），畅享超低延迟。
  • Anthropic 原生协议适配器：支持 Anthropic messages 原生协议，在 L0/L1 静态上下文层精准注入 cache_control: {"type": "ephemeral"} 临时缓存标记，将硬件级 KV 缓存复用发挥到极致。
  • 本地订阅代理回环安全校验：通过 LocalLoopbackValidator 强制校验本地订阅网关（Codex、Sub2API、NewAPI）仅绑定本机回环地址（127.0.0.1、localhost、::1），严防本地代理凭据向公网泄露。
  • 多端点毫秒级测速与容灾负载均衡：支持主备故障转移（PriorityFailover）与轮询（RoundRobin）调度、60 秒熔断隔离（LoadBalancer）、异步 RTT 延迟探针（EndpointHealthProbe）以及 F8 调试中心诊断面板（ModelServiceF8Diagnostics）。

🎮 实机特性展示

RimMind-Extension-ModelService 实机展示 扩展模型网关设置实机：配置 Priority Failover / Round Robin 负载均衡策略、一键添加 Codex Preset 与 OpenCode Go Preset 预设节点，并通过 Local Loopback Secured（127.0.0.1:8000）本机回环安全校验。

🏛️ 网关与协议架构

flowchart TD
    Core["RimMind-Core 请求分发器"] --> Factory["IAIClientFactory 注册表"]
    Factory --> OpenCode["OpenCodeGoClientFactory (x-opencode-session)"]
    Factory --> Extended["ModelServiceClientFactory (enableService 门控)"]
    Extended --> Balancer["LoadBalancer (主备优先 / 轮询调度)"]
    Balancer --> OpenAI["OpenAIProtocolAdapter"]
    Balancer --> Anthropic["AnthropicProtocolAdapter (ephemeral 临时缓存)"]
    Balancer --> Loopback["LocalLoopbackValidator (本机回环守卫)"]
    Balancer --> Health["EndpointHealthProbe & F8 诊断面板"]
Loading

🛠️ 安装与加载顺序

1. Harmony
2. Core (RimWorld 原版)
3. RimMind-Core
4. RimMind-Extension-ModelService

⚙️ 核心设置项

位于 选项 -> Mod 设置 -> RimMind - 扩展模型服务：

设置项 默认值 说明
启用扩展模型服务 开启 控制 extended_service 多端点路由网关的总开关
负载均衡策略 PriorityFailover 支持按优先级主备故障转移（PriorityFailover）或均匀轮询（RoundRobin）
协议提供商类型 OpenAICompatible 支持 OpenAICompatible、AnthropicClaude、LocalSubscriptionGateway、OpenCodeGo
端点优先级与启用状态 1 / 开启 独立配置每个端点的故障转移优先级权重与参与状态
一键延迟 Ping 测速 — 异步发送 HTTP 健康探针测量毫秒级 RTT 延迟并更新端点健康度

🧪 开发者测试指南

在仓库根目录下编译并运行单元测试：

dotnet build RimMind-Extension-ModelService/Source/RimMindModelService.csproj -c Release
dotnet test RimMind-Extension-ModelService/Tests/RimMindModelService.Tests.csproj -c Release

📜 开源协议

本项目采用 MIT License 开源许可证。