@blueking/chat-helper 0.0.12-beta.2 → 0.0.12-beta.20

package/README.md

@@ -324,6 +324,17 @@ http.message; // Message API
 
 一般情况下，您不需要直接使用 `http` 模块，因为 `agent`、`session` 和 `message` 模块已经封装了常用的业务逻辑。
 
+**`http.message.getMessages`（可单独使用）**：
+
+```typescript
+// (sessionCode: string, limit?: number, config?: IRequestConfig, fuzzy?: string) => Promise<IMessage[]>
+// GET session_content/content/ — 支持可选 fuzzy 模糊检索
+const messages = await http.message.getMessages(sessionCode);
+const filtered = await http.message.getMessages(sessionCode, undefined, undefined, '关键词');
+```
+
+> 业务层 `message.getMessages(sessionCode)` 未透传 `fuzzy`。需要模糊检索时请直接调用 `http.message.getMessages`。`fuzzy` 位于参数末尾，不影响既有 `limit` / `config` 调用。
+
 ## 配置选项
 
 ### requestData（必需）
@@ -416,7 +427,6 @@ useChatHelper({
 **拦截器使用场景**：
 
 1. **请求拦截器**：
-
    - 添加认证 token
    - 添加请求时间戳
    - 添加请求 ID
@@ -994,8 +1004,8 @@ class SafeProtocol extends AGUIProtocol {
       mode.value === 'creative'
         ? 'chat_completion_creative/'
         : mode.value === 'precise'
-        ? 'chat_completion_precise/'
-        : undefined;
+          ? 'chat_completion_precise/'
+          : undefined;
 
     // 自定义请求参数
     agent.chat(userInput.value, session.current.sessionCode, endpoint, {
@@ -1555,13 +1565,11 @@ interface IToolMessage {
 **参数：**
 
 - `options.requestData` (必需)
-
   - `urlPrefix: string` - API 基础路径
   - `data?: Record<string, unknown> | (() => Record<string, unknown>)` - 额外的请求数据
   - `headers?: Record<string, string> | (() => Record<string, string>)` - 额外的请求头
 
 - `options.interceptors` (可选)
-
   - `request?: (config: IRequestConfig) => IRequestConfig` - 请求拦截器
   - `response?: (response: IResponse) => IResponse` - 响应拦截器
 
@@ -1885,13 +1893,19 @@ A: 使用 `agent.chat` 的 `url` 和 `config` 参数：
 // 使用不同的端点
 agent.chat(userInput, sessionCode, 'custom_chat/');
 
-// 添加自定义参数
+// 添加自定义请求参数（如 temperature）
 agent.chat(userInput, sessionCode, undefined, {
   data: {
     temperature: 0.8,
-    model: 'gpt-4',
   },
 });
+
+// 模型热切换：传入第 6 个参数 model（值为 llm_code，需在 GET llms/ 列表内）
+agent.chat(userInput, sessionCode, undefined, undefined, property, 'hy3-preview');
+
+// 拉取可用模型列表
+const llmList = await agent.getLlms({ llm_type: 'chat.completion' });
+// agent.models 同步更新
 ```
 
 ### Q: 消息列表如何实现自动滚动到底部？

package/dist/agent/type.d.ts

@@ -126,3 +126,72 @@ export interface IAgentResources {
     mcp?: IAgentResourceItem[];
     tool?: IAgentResourceItem[];
 }
+/** 模型能力属性（后端 property 字段） */
+export interface ILlmProperty {
+    agent_type?: string;
+    default?: boolean;
+    is_self_host?: boolean;
+    max_model_len?: number;
+    support_summary?: boolean;
+    support_thinking?: boolean;
+    support_thinking_quick?: boolean;
+    support_tools?: boolean;
+    support_vision?: boolean;
+    support_window?: boolean;
+}
+/** 可用模型列表查询参数 */
+export interface ILlmListQuery {
+    /** 模糊搜索关键词，按 llm_name / description / base_model 匹配 */
+    fuzzy?: string;
+    /** 模型类型，不传时默认 chat.completion */
+    llm_type?: string;
+    /** 按模型支持的功能过滤，逗号分隔，如 tool_call,vision */
+    supports?: string;
+}
+/**
+ * 可用模型项（对齐 plugin_api/llms/ 与 chat-x IModelOption）
+ * 字段以 snake_case 与后端保持一致，便于直接透传给 ModelSelector
+ */
+export interface ILlmItem {
+    /** 基础模型标识，如 hunyuan */
+    base_model?: string;
+    /** 模型描述 */
+    description?: string;
+    /** 是否禁用（前端扩展字段） */
+    disabled?: boolean;
+    /** 模型图标地址 */
+    icon?: string;
+    /** 模型主键 id */
+    id: number;
+    /** 模型编码（chat_completion 热切换传此值） */
+    llm_code: string;
+    /** 模型展示名（ModelSelector v-model 选中值） */
+    llm_name: string;
+    /** 模型类型，如 chat.completion */
+    llm_type: string;
+    /** 最大 token 数 */
+    max_token_size: number;
+    /** 模型能力属性 */
+    property: ILlmProperty;
+    /** 空间维度鉴权模式 */
+    space_auth_mode: string;
+    /** 标签名列表 */
+    tag_names?: string[];
+    /** 用户维度鉴权模式 */
+    user_auth_mode: string;
+}
+/** 后端 llms/ 原始响应项（字段可能缺省） */
+export interface ILlmItemApi {
+    base_model?: string;
+    description?: string;
+    icon?: string;
+    id?: number;
+    llm_code: string;
+    llm_name: string;
+    llm_type?: string;
+    max_token_size?: number;
+    property?: ILlmProperty | null;
+    space_auth_mode?: string;
+    tag_names?: string[];
+    user_auth_mode?: string;
+}

package/dist/agent/type.ts.js

@@ -22,4 +22,4 @@
  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
  * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
  * IN THE SOFTWARE.
- */ /** @deprecated 后端已改为扁平列表 IAgentResourceItem[]，不再使用分组结构 */ export { };
+ */ /** 后端 llms/ 原始响应项（字段可能缺省） */ export { };