@blade-hq/agent-react 2608.0.3-beta.1 → 2608.0.4-beta.1

package/README.md

@@ -174,8 +174,27 @@ Blade。这时把 `ChatView` 切到 `mode="llm"`，或者直接用下层的 `Llm
 
 **密钥默认不进浏览器**：把 `baseURL` 指向自己后端的一个路径，后端补上 `Authorization` 再原样
 转发即可（协议是标准的，这个代理就是纯转发）。确实要前端直连时才传 `apiKey`——只适合受控内网、
-演示，或密钥本身就属于当前用户的场景。模型服务地址和可选模型别写死，用
-`client.models.list()` 的 `baseUrl` 与 `models` 拿，各部署端口不一样。
+演示，或密钥本身就属于当前用户的场景。
+
+**模型服务地址和模型名别写死**，用 `client.models.list()` 拿，各部署端口不一样：
+
+```tsx
+const { baseUrl, defaultServiceModel, models } = await client.models.list()
+
+// 后端透传（推荐）：baseURL 指向自己的路径，模型名仍然要用 defaultServiceModel
+<ChatView mode="llm" llm={{ baseURL: "/api/llm", model: defaultServiceModel }} />
+
+// 浏览器直连：仅当 baseUrl 对浏览器也可达时
+<ChatView mode="llm" llm={{ baseURL: baseUrl, model: defaultServiceModel, apiKey }} />
+
+// 让用户选模型时，过滤掉不在这个服务上的
+models.filter((m) => m.serviceModelId)
+```
+
+**模型名要用 `defaultServiceModel` / `serviceModelId`，不是 `default` / `id`。** 后者是平台内部
+标识，平台接了多个模型服务时形如 `provider-xxx::deepseek-v4-flash`，发给模型服务只会得到
+「模型不存在」。`baseUrl` 同理是服务端视角的地址，平台常配成 `http://127.0.0.1:30000/v1`，
+那是给自己后端转发用的，不能直接丢给浏览器。
 
 **工具调用走 OpenAI 标准的多轮流程**，不需要任何私有扩展：声明 `tools`，在 `onToolCall`
 （收到 `LlmToolCall`）里执行——通常就是调你自己应用的同源接口——返回值会作为

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blade-hq/agent-react",
-  "version": "2608.0.3-beta.1",
+  "version": "2608.0.4-beta.1",
   "description": "Blade Agent React 绑定：BladeProvider、useAgentSession、开箱即用的 ChatView 聊天界面。",
   "repository": {
     "type": "git",
@@ -29,7 +29,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@blade-hq/agent-client": "2608.0.3-beta.1"
+    "@blade-hq/agent-client": "2608.0.4-beta.1"
   },
   "bundledDependencies": [],
   "peerDependencies": {

package/public-api.md

@@ -783,6 +783,7 @@ export type ModeId = "planning" | "executing"
 ```ts
 baseUrl: string | undefined
 default: string
+defaultServiceModel: string | undefined
 models: ModelOption[]
 ```
 
@@ -791,6 +792,7 @@ models: ModelOption[]
 ```ts
 id: string
 label: string
+serviceModelId: string | undefined
 ```
 
 ## `ModelsResource` (class)