配置

所有部署参数都在 Config Schema 里，且都有可用默认值。改配置的两种方式：

profile 自己的 $DSH_HOME/profiles/ /cordis.patch.yml（在 bundle 层之后应用，覆盖单行配置）；
环境变量注入密钥（推荐，密钥不落盘）： STARBRIDGE_GATEWAY_URL、STARBRIDGE_GATEWAY_API_KEY、 STARBRIDGE_OIDC_ISSUER_URL、STARBRIDGE_OIDC_CLIENT_ID、 STARBRIDGE_OIDC_CLIENT_SECRET、STARBRIDGE_USER_ID、STARBRIDGE_DEPARTMENT。

主要字段：

字段	默认值	说明
`gateway.gatewayUrl`	`''`（空）	网关基址。出厂为空是刻意的：插件对所有人发布，不写死任何一家的地址；空地址不是加载错误，只是还没配置，工具会回 `[GATEWAY_NOT_CONFIGURED]`。被设置页填写的地址覆盖，也可用 `STARBRIDGE_GATEWAY_URL` 注入
`gateway.apiKey`	`''`	机器凭据；优先用环境变量，也会被设置页填写的密钥覆盖
`gateway.timeoutMs`	`30000`	单次请求超时
`gateway.maxRetries`	`2`	仅对传输错误与 5xx 重试
`gateway.modelProvider`	`starbridge`	模型路由开关管理的 provider 路由名（必须与组合声明一致）
`oidc.issuerUrl` / `oidc.clientId`	`''`	为空则不启用 SSO；SSO 仍然可用，与两种新登录方式并存
`identity.userId` / `department` / `scenario`	`''` / `''` / `chat`	随每个请求上送的身份与场景；设置页填写的身份优先
`behavior.useKnowledgeBase`	`false`	是否默认请求知识库增强
`behavior.forwardFeedback`	`true`	`false` 则反馈只留在本机
`storage.directory`	`''`	加密会话保险库目录；空则用 DSH home

OIDC 客户端：网关侧需要注册一个 Public client + Authorization Code + PKCE，回调地址为 http(s):///starbridge/api/login/complete（可用 STARBRIDGE_REDIRECT_URI 显式指定）。刷新令牌以 AES-256-GCM 加密存放于 /starbridge-session.enc，密钥为同目录下 0600 的 starbridge-session.key； host 重启后仍是登录态。

HTTP 路由（浏览器面使用）

方法	路径	说明
GET	`/starbridge/api/status`	生效配置 + 登录状态 + 模型路由状态
POST	`/starbridge/api/connectivity`	连通性测试（可传候选 `gatewayUrl`）
POST	`/starbridge/api/chat`	NDJSON 帧流：`delta` / `done` / `error`
POST	`/starbridge/api/feedback`	写入反馈
POST	`/starbridge/api/gateway/settings`	保存地址与身份
POST	`/starbridge/api/gateway/access-key`	用访问密钥接通（返回逐步清单）
POST	`/starbridge/api/gateway/login`	平台账号登录（返回逐步清单）
POST	`/starbridge/api/gateway/model-route`	开关模型路由
POST	`/starbridge/api/gateway/forget`	清除本机保存的凭据
POST	`/starbridge/api/login`	返回 OIDC 授权 URL
GET/POST	`/starbridge/api/login/complete`	OIDC 回调
POST	`/starbridge/api/logout`	退出 OIDC 登录

dsh-starbridge-client

설치

문서

配置

HTTP 路由（浏览器面使用）