dsh-starbridge-client

配置

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

1. profile 自己的 $DSH_HOME/profiles/ /cordis.patch.yml（在 bundle 层之后应用，覆盖单行配置）；
2. 环境变量注入密钥（推荐，密钥不落盘）： 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 登录