模型中心

English | 中文

@gestaltrun/dsh-model-center 提供模型设置页和逐模型默认思考档位。bundle 选择产品提供方和编辑器，继续使用官方 LLM 服务、pi-ai 实现、Settings 与 Credentials 服务。Desktop 携带此包并为新 profile 默认启用；停用后恢复官方提供方和模型页面，保留已保存配置。

配置

模型页面在同一模型行编辑输入类型、支持的思考档位、请求值和默认档位。新建与编辑提供方时也可以设置 defaultInput。提供方配置是当前 profile 的 cordis.patch.yml 中 gestaltrun-model-center 条目的 providers 字段，API 密钥仍由 Credentials 服务管理。profile 尚未保存自己的提供方时，首次启动会从已移除的 settings.yaml 导入一次 llm-pi-ai 分区的提供方，因为 Settings 只把该分区导入本 bundle 停用的 llm-pi-ai 条目。页面不列出官方 DeepSeek 适配器（llm-deepseek 命名空间）的路由，首次使用时也不提示填写 DeepSeek API 密钥；已保存的配置继续生效。

模型中心启用时，内联控件接管 pi-ai 提供方卡片的扩展槽位，已安装的旧模型能力插件不会重复显示面板。其他提供方扩展和已禁用提供方的存档仍可使用。关闭模型中心后恢复旧扩展，不卸载旧插件或删除其数据。

- id: gestaltrun-model-center
  config:
    providers:
      gateway:
        api: openai-completions
        baseURL: https://gateway.example/v1
        apiKeyEnv: GATEWAY_API_KEY
        models:
          - id: vision-model
            input: [text, image]
            reasoningEfforts: {off: null, low: low, high: high}
            defaultReasoningLevel: high

本次请求显式选择优先于模型默认值，模型默认值优先于提供方的 reasoning。移除 defaultReasoningLevel 即恢复继承。声明档位必须包含默认档位；继承模型目录时，在发送前依据解析后的模型能力验证。off: null 表示提供关闭选项，但不发送思考参数。能力由用户声明，不是自动探测端点。

设置写入携带页面读取的表单版本，写入 profile 前先校验，并原子保存模型数组。已提交的修改无需重新挂载条目即可生效。请求准备后，其默认档位不受后续设置变更影响。提供方错误、取消、重试、图片与重放状态继续由官方实现处理。

产品 bundle 可以在 pi-ai 读取初始设置前，通过 managedProviders 预约提供方路由。运行时所有者通过 ctx.modelCenter 发布来源模型字段；发布写入本条目 profile 配置的 providers.<id>.models，并保留其他提供方和非来源字段。通用 pi-ai 适配器不占用或校验预约路由。运行时所有者继续负责其适配器、凭据、发现与生命周期。重复发布相同来源目录不会写入 Settings；后续来源刷新会替换来源拥有的模型字段手动编辑。

设置 configurable: false 的预约不会在模型配置表单中显示该路由，并拒绝持久化 Provider profile 和 syncCatalog 写入。运行时 owner 仍可注册发现接口并直接提供当前目录。店铺云模型使用此模式，因为模型列表和成员凭据由 server 管理。模型中心 bundle 预约只读商家路由。商家 bundle 也可以不依赖模型中心运行。

构建与装配

独立工作区位于 product/。按 产品工作区 的打包归档安装，再执行 pnpm --dir product run build、test 或 typecheck。typecheck 会发出本包的公开声明。pnpm --dir product run pack 将 npm 归档写入 product/dist。Desktop 打包读取此目录和 apps/desktop/src/product-profile.ts 中的产品 bundle 清单。

bundle 停用标准 pi-ai 和模型 UI 行，并以固定 id gestaltrun-model-center 插入产品行；使用其他 id 的行在加载时失败。使用组合层 pi-ai 默认值时，将其配置在产品行。bundle 预约商家路由而不添加配置表单；其他受管运行时在模型中心行中添加各自预约。嵌套的官方 pi-ai 插件继承本条目并以其命名空间注册。其隔离注册视图通过每次挂载各自的所有者 fiber 转发官方三个 LLM 注册方法；Loader 只把已提交的 providers 变化交给本条目，因此嵌套插件所服务的路由变化时会重新挂载。组合测试约束与固定 DSH 版本的兼容性。产品包不替换应用 LLM 服务，不在中间件中修改冻结请求。

模型页面与输入标签控件由产品包维护适配，源码身份记录在 UPSTREAM.json。新增公共接口需要明确适配，不从未发布的内部路径导入实现。