wtfai 1.7.3 → 1.8.1

package/README.md

@@ -680,6 +680,50 @@ Content-Type: application/json
 
 ---
 
+---
+
+### RealtimeService
+
+提供跨端的实时消息总线功能（通过 `client.realtime` 访问）。
+
+##### `subscribe(topic: string, onEvent: (event: RealtimeEvent) => void)`
+
+订阅实时消息流。适合大屏端监听由其他端发送的指令或通知。
+
+- **自动管理**：方法内部会自动计算并附加当前浏览器的设备指纹（deviceId），激活在线状态追踪。
+- **返回值**：返回一个对象，包含 `unsubscribe()` 方法用于断开连接。
+
+```typescript
+const sub = await client.realtime.subscribe('class:101', (event) => {
+  console.log('收到实时更新:', event.data);
+  // event.event 为事件名称，event.data 为业务数据
+});
+
+// 当页面销毁或不需要监听时，请务必手动释放：
+// sub.unsubscribe();
+```
+
+##### `push(topic: string, event: string, data: any)`
+
+推送实时消息。适合手机端（或其他客户端）发送指令。
+
+```typescript
+await client.realtime.push('class:101', 'msgA', {
+  foo: 'bar'
+});
+```
+
+##### `getPresence(topic: string)`
+
+获取指定主题下的在线状态详情（如当前有多少个大屏在线）。
+
+```typescript
+const { onlineCount, clients } = await client.realtime.getPresence('class:101');
+console.log(`当前在线设备数: ${onlineCount}`);
+```
+
+---
+
 ### UploadService
 
 文件上传服务（通过 `client.upload` 访问）。

package/dist/client.d.ts

@@ -1,7 +1,8 @@
-import type { Workflow, WorkflowListResponse } from '@our-llm/shared/types';
+import type { Workflow, WorkflowListResponse, DeviceInfo } from '@our-llm/shared/types';
 import type { ClientConfig, SessionOptions } from './types';
 import { WorkflowSession } from './session';
 import { UploadService } from './upload';
+import { RealtimeService } from './realtime';
 /**
  * Wtfai 客户端
  *
@@ -33,6 +34,10 @@ export declare class Wtfai {
      * 文件上传服务
      */
     readonly upload: UploadService;
+    /**
+     * 实时同步服务
+     */
+    readonly realtime: RealtimeService;
     private readonly headers;
     constructor(config: ClientConfig);
     /**
@@ -47,4 +52,8 @@ export declare class Wtfai {
      * 创建工作流会话
      */
     createSession(workflowId: string, options?: SessionOptions): WorkflowSession;
+    /**
+     * 获取当前详细的设备信息（本地计算）
+     */
+    getDeviceInfo(): Promise<DeviceInfo>;
 }

package/dist/client.js

@@ -1,5 +1,7 @@
+import { getDeviceInfo } from "@our-llm/shared/fingerprint";
 import { WorkflowSession } from "./session.js";
 import { UploadService } from "./upload.js";
+import { RealtimeService } from "./realtime.js";
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -32,12 +34,16 @@ class Wtfai {
     createSession(workflowId, options) {
         return new WorkflowSession(workflowId, this.baseUrl, this.uploadService, this.headers, options);
     }
+    async getDeviceInfo() {
+        return getDeviceInfo();
+    }
     constructor(config){
         _define_property(this, "baseUrl", void 0);
         _define_property(this, "uploadService", void 0);
         _define_property(this, "upload", void 0);
+        _define_property(this, "realtime", void 0);
         _define_property(this, "headers", void 0);
-        this.baseUrl = config.baseUrl.replace(/\/$/, '');
+        this.baseUrl = (config.baseUrl || 'https://llm-api.ourschool.cc').replace(/\/$/, '');
         const headers = {
             ...config.headers
         };
@@ -48,6 +54,7 @@ class Wtfai {
         this.headers = headers;
         this.uploadService = new UploadService(this.baseUrl, this.headers);
         this.upload = this.uploadService;
+        this.realtime = new RealtimeService(this.baseUrl, this.headers);
     }
 }
 export { Wtfai };

package/dist/index.d.ts

@@ -2,7 +2,8 @@ import { Wtfai } from './client';
 export default Wtfai;
 export { WorkflowSession } from './session';
 export { UploadService } from './upload';
+export { RealtimeService } from './realtime';
 export type { ClientConfig, SessionOptions, SessionState, SessionEventListeners, SendInput, UploadParams, UploadImageParams, CompressOptions, WorkflowInfo, ContentPart, ContentAction, } from './types';
-export type { SimpleMessage, Workflow, WorkflowConfig, } from '@our-llm/shared/types';
+export type { SimpleMessage, Workflow, WorkflowConfig, RealtimeEvent, RealtimePresence, RealtimePushDto, } from '@our-llm/shared/types';
 export { Markdown, type MarkdownProps, WorkflowRegistry } from './ui/markdown';
 export type { WorkflowInfoMapping } from './ui/context';

package/dist/index.js

@@ -2,5 +2,6 @@ import { Wtfai } from "./client.js";
 const src = Wtfai;
 export { WorkflowSession } from "./session.js";
 export { UploadService } from "./upload.js";
+export { RealtimeService } from "./realtime.js";
 export { Markdown, WorkflowRegistry } from "./ui/markdown.js";
 export default src;

package/dist/realtime.d.ts

@@ -0,0 +1,23 @@
+import type { RealtimeEvent, RealtimePresence } from '@our-llm/shared/types';
+export declare class RealtimeService {
+    private readonly baseUrl;
+    private readonly headers;
+    constructor(baseUrl: string, headers: Record<string, string>);
+    /**
+     * 订阅实时消息流 (适合大屏端)
+     * @param topic 主题名称
+     * @param onEvent 事件回调
+     * @returns 返回一个包含 unsubscribe 方法的对象
+     */
+    subscribe(topic: string, onEvent: (event: RealtimeEvent) => void): Promise<{
+        unsubscribe: () => void;
+    }>;
+    /**
+     * 推送实时消息 (适合手机端)
+     */
+    push(topic: string, event: string, data: any): Promise<void>;
+    /**
+     * 获取当前主题的在线状态
+     */
+    getPresence(topic: string): Promise<RealtimePresence>;
+}

package/dist/realtime.js

@@ -0,0 +1,76 @@
+import { fetchEventSource } from "@microsoft/fetch-event-source";
+import { getFingerprint } from "@our-llm/shared/fingerprint";
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+class RealtimeService {
+    async subscribe(topic, onEvent) {
+        const deviceId = await getFingerprint();
+        const controller = new AbortController();
+        const query = `?deviceId=${encodeURIComponent(deviceId)}`;
+        const url = `${this.baseUrl}/workflows/realtime/streams/${topic}${query}`;
+        fetchEventSource(url, {
+            method: 'GET',
+            headers: {
+                Accept: 'text/event-stream',
+                ...this.headers
+            },
+            signal: controller.signal,
+            onmessage (msg) {
+                if (!msg.data) return;
+                if ('message' === msg.event || !msg.event) try {
+                    const event = JSON.parse(msg.data);
+                    onEvent(event);
+                } catch (e) {
+                    console.error('[SDK Realtime] Failed to parse message', e);
+                }
+            },
+            onerror (err) {
+                console.error('[SDK Realtime] Connection error', err);
+            }
+        });
+        return {
+            unsubscribe: ()=>{
+                controller.abort();
+            }
+        };
+    }
+    async push(topic, event, data) {
+        const dto = {
+            topic,
+            event,
+            data
+        };
+        const response = await fetch(`${this.baseUrl}/workflows/realtime/push`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...this.headers
+            },
+            body: JSON.stringify(dto)
+        });
+        if (!response.ok) throw new Error(`推送实时消息失败: ${response.statusText}`);
+    }
+    async getPresence(topic) {
+        const response = await fetch(`${this.baseUrl}/workflows/realtime/presence/${topic}`, {
+            method: 'GET',
+            headers: this.headers
+        });
+        if (!response.ok) throw new Error(`获取在线状态失败: ${response.statusText}`);
+        return response.json();
+    }
+    constructor(baseUrl, headers){
+        _define_property(this, "baseUrl", void 0);
+        _define_property(this, "headers", void 0);
+        this.baseUrl = baseUrl;
+        this.headers = headers;
+    }
+}
+export { RealtimeService };

package/dist/session.d.ts

@@ -1,4 +1,4 @@
-import type { SimpleMessage } from '@our-llm/shared/types';
+import type { SimpleMessage, DeviceInfo } from '@our-llm/shared/types';
 import type { SessionOptions, SessionState, SessionEventListeners, SendInput, ListRecordsOptions, ListRecordsResult } from './types';
 import { UploadService } from './upload';
 /**
@@ -137,6 +137,16 @@ export declare class WorkflowSession {
      * @param options 请求配置
      */
     fetch(url: string, options?: RequestInit): Promise<any>;
+    /**
+     * 上报设备信息相关（用于日志监控）
+     */
+    reportDeviceInfo(): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * 获取当前详细的设备信息（本地计算）
+     */
+    getDeviceInfo(): Promise<DeviceInfo>;
     /**
      * 发送消息执行工作流
      */

package/dist/session.js

@@ -1,3 +1,4 @@
+import { getDeviceInfo, getFingerprint } from "@our-llm/shared/fingerprint";
 import { executeWorkflowSSE } from "./sse.js";
 import { v7 } from "uuid";
 function _define_property(obj, key, value) {
@@ -371,6 +372,32 @@ class WorkflowSession {
         }
         return response.json();
     }
+    async reportDeviceInfo() {
+        this.assertNotDisposed();
+        const deviceId = await getFingerprint();
+        const userAgent = navigator.userAgent;
+        const sessionId = this.state.threadId;
+        if (!sessionId) throw new Error('No active session (missing threadId)');
+        const payload = {
+            deviceId,
+            userAgent,
+            sessionId
+        };
+        const response = await fetch(`${this.baseUrl}/workflows/device-info`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...this.headers
+            },
+            body: JSON.stringify(payload)
+        });
+        if (!response.ok) throw new Error('Failed to report device info');
+        return response.json();
+    }
+    async getDeviceInfo() {
+        this.assertNotDisposed();
+        return getDeviceInfo();
+    }
     async send({ parts: inputParts, ...rest }) {
         this.assertNotDisposed();
         if (this.state.isExecuting) throw new Error('工作流正在执行中');

package/dist/types.d.ts

@@ -2,8 +2,8 @@
  * SDK 配置类型
  */
 export interface ClientConfig {
-    /** API 服务器地址 */
-    baseUrl: string;
+    /** API 服务器地址，默认为 https://llm-api.ourschool.cc */
+    baseUrl?: string;
     /** 请求超时时间（毫秒） */
     timeout?: number;
     /** 自定义请求头 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wtfai",
-  "version": "1.7.3",
+  "version": "1.8.1",
   "type": "module",
   "exports": {
     ".": {
@@ -15,16 +15,16 @@
   "devDependencies": {
     "@eslint/js": "^9.39.4",
     "@rsbuild/plugin-react": "^1.4.6",
-    "@rslib/core": "^0.21.0",
+    "@rslib/core": "^0.21.2",
     "@types/react": "^19.2.14",
     "eslint": "^9.39.4",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.5",
-    "globals": "^17.4.0",
-    "prettier": "^3.8.2",
+    "globals": "^17.5.0",
+    "prettier": "^3.8.3",
     "react": "^19.2.5",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.58.1"
+    "typescript-eslint": "^8.58.2"
   },
   "peerDependencies": {
     "react": ">=16.9.0",
@@ -38,7 +38,7 @@
     "clsx": "^2.1.1",
     "compressorjs": "^1.3.0",
     "cos-js-sdk-v5": "^1.10.1",
-    "jsonrepair": "^3.13.3",
+    "jsonrepair": "^3.14.0",
     "uuid": "^13.0.0",
     "@our-llm/shared": "3.0.1"
   },