keepwork-sdk 1.0.0

package/dist-npm/types/src/core/RemoteLog.d.ts

@@ -0,0 +1,132 @@
+/** 单次点击事件（eventType=1）数据包 */
+export interface ClickEventPacket {
+    userId: string;
+    projectId: number | null;
+    traceId: string;
+    currentAt: number;
+    [key: string]: unknown;
+}
+/** 时长事件（eventType=2）数据包 */
+export interface DurationEventPacket {
+    userId: string;
+    projectId: number | null;
+    traceId: string;
+    beginAt: number;
+    endAt: number;
+    duration: number;
+    [key: string]: unknown;
+}
+export type EventPacket = ClickEventPacket | DurationEventPacket;
+/** sendEvent 的参数结构 */
+export interface EventData {
+    /** 事件分类（如 'new-behavior'） */
+    category: string;
+    /** 事件动作（如 'duration.world.stay'） */
+    action: string;
+    /** 事件数据负载 */
+    data: EventPacket;
+}
+/** send() 的 extra 参数 */
+export interface SendExtra {
+    /** 时长事件开始标志 */
+    started?: boolean;
+    /** 时长事件结束标志 */
+    ended?: boolean;
+    /** 是否使用匿名 ID */
+    useNoId?: boolean;
+    [key: string]: unknown;
+}
+/** SDK 实例的最小接口（避免循环引用） */
+interface SDKRef {
+    token: string | null;
+    getUsername(): Promise<string | null>;
+}
+declare class RemoteLog {
+    private apiEndpoint;
+    private sdk;
+    private maxRetries;
+    private retryDelay;
+    /** 进行中的时长事件缓存，key = `${userId}_${action}` */
+    private pendingEvents;
+    /** 缓存的请求头（含 User-Agent / Referer，首次调用后复用） */
+    private headers;
+    constructor(sdk: SDKRef);
+    /**
+     * 从 hostname 提取主域名（保持与重构前 RemoteLog.js 一致的原型方法表面）。
+     * 委托给 WxUtils.extractMainDomain，逻辑等价。
+     */
+    extractMainDomain(hostname: string): string;
+    /**
+     * 获取当前时间戳（毫秒），对应 Lua 的 `GetServerTime`。
+     */
+    getServerTime(): number;
+    /**
+     * 生成 UUID v4 格式的 traceId，用于追踪单条事件链路。
+     */
+    generateTraceId(): string;
+    /**
+     * 生成事件数据包（对应 Lua `GenerateDataPacket`）。
+     *
+     * - type=1（单次事件）：立即构建含 `currentAt` 的包
+     * - type=2（时长事件）：首次调用记录开始时间；再次调用计算 duration
+     *
+     * @param eventType - 1 单次事件，2 时长事件
+     * @param userId    - 用户 ID
+     * @param action    - 动作名称
+     * @param started   - 时长事件专用：true 表示事件已在计时中
+     * @param projectId - 项目 ID（可选）
+     */
+    generateDataPacket(eventType: 1 | 2, userId: string, action: string, started?: boolean, projectId?: number | null): EventPacket | null;
+    /**
+     * 发送事件（对应 Lua `EventTrackingService:Send`）。
+     *
+     * 自动从 SDK 实例获取用户 ID（若调用方未提供）。
+     * 时长事件未正确结束时会跳过发送，避免写入无效数据。
+     *
+     * @param eventType    - 1 单次事件，2 时长事件
+     * @param action       - 动作名称
+     * @param extra        - 附加数据（started/ended 标志 + 业务字段）
+     * @param offlineMode  - 是否离线模式（当前未实现，预留）
+     * @param useNewCatalog - 是否使用新分类（决定 category 前缀）
+     * @param userId       - 用户 ID（可选，为空时从 SDK 获取）
+     * @param projectId    - 项目 ID（可选）
+     * @returns 成功返回事件包，失败返回 false
+     */
+    send(eventType: 1 | 2, action: string, extra?: SendExtra, offlineMode?: boolean, useNewCatalog?: boolean, userId?: string | null, projectId?: number | null): Promise<EventPacket | false>;
+    /**
+     * 构建浏览器特征请求头（首次调用后缓存，避免重复构建）。
+     * @internal
+     */
+    getBrowserHeaders(): Record<string, string>;
+    /**
+     * 向远端发送事件日志，失败后按指数退避重试。
+     *
+     * @param eventData   - 事件数据对象
+     * @param retryCount  - 当前已重试次数（内部递归使用）
+     */
+    sendEvent(eventData: EventData, retryCount?: number): Promise<unknown>;
+    /**
+     * 获取当前登录用户的用户名（代理到 sdk.getUsername）。
+     */
+    getUserId(): Promise<string | null>;
+    /**
+     * 上报自由格式的行为事件（直接构建事件包，不经过 generateDataPacket）。
+     *
+     * @param action   - 动作名称
+     * @param data     - 事件数据（会附加 traceId 和 currentAt）
+     * @param category - 事件分类（默认 'new-behavior'）
+     */
+    logBehavior(action: string, data: Record<string, unknown>, category?: string): Promise<unknown>;
+    /**
+     * 上报单次点击事件（eventType=1 的便捷封装）。
+     *
+     * @param action       - 动作名称
+     * @param extra        - 附加业务数据
+     * @param useNewCatalog - 是否使用新分类
+     * @param userId       - 用户 ID（可选）
+     * @param projectId    - 项目 ID（可选）
+     */
+    logClick(action: string, extra?: SendExtra, useNewCatalog?: boolean, userId?: string | null, projectId?: number | null): Promise<EventPacket | false>;
+}
+export default RemoteLog;
+//# sourceMappingURL=RemoteLog.d.ts.map

package/dist-npm/types/src/core/RemoteLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteLog.d.ts","sourceRoot":"","sources":["../../../../src/core/RemoteLog.ts"],"names":[],"mappings":"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"}

package/dist-npm/types/src/core/keepworkSDK.core.d.ts

@@ -0,0 +1,84 @@
+/**
+ * keepworkSDK.core.ts — KeepworkSDK 核心方法 mixin（TypeScript 版）
+ *
+ * 包含：
+ * - 构造辅助（_initCore）
+ * - Token / 认证管理（setToken / getAuthHeaders / setUserApiKey 等）
+ * - 用户档案缓存与 auth-state 事件通知
+ * - HTTP 请求帮助方法（request / get / post / put / delete）
+ * - 用户认证接口（login / logout / getUserProfile / VIP 检查等）
+ * - AIChat 懒加载（_patchAIChat / loadAIChat）
+ *
+ * 通过 `applyCoreMixin(KeepworkSDK)` 将所有方法注入到主类 prototype，
+ * 不单独导出类，避免循环引用。
+ */
+/** KeepworkSDK 构造选项 */
+export interface KeepworkSDKOptions {
+    /** 覆盖默认 API 基地址（调试用，生产保持空） */
+    baseURL?: string;
+    /** 初始认证 token */
+    token?: string;
+    /** 请求超时 ms（默认 30000） */
+    timeout?: number;
+    /** 失败重试次数（默认 1） */
+    retryCount?: number;
+    /** 首次重试延迟 ms（默认 1000，指数退避） */
+    retryDelay?: number;
+    /** LLM user-api-key */
+    userApiKey?: string;
+    /** 用户档案缓存时长 ms（默认 30000000 ≈ 500 分钟） */
+    userCacheTimeout?: number;
+    /** AudioEngine 初始化选项 */
+    audioEngine?: Record<string, unknown>;
+    /** WxAuth 初始化选项 */
+    wxAuth?: Record<string, unknown>;
+    /** LocalAPIKeySettings 初始化选项 */
+    localAPIKeySettings?: Record<string, unknown>;
+}
+/** 认证状态变更事件载荷 */
+export interface AuthStateChange {
+    /** 变更原因 */
+    reason: 'tokenChanged' | 'signedOut' | 'userChanged' | 'setCachedUser' | 'profileChanged' | string;
+    previousToken?: string | null;
+    token?: string | null;
+    previousUserKey?: string | null;
+    nextUserKey?: string | null;
+}
+/** 用户档案对象（Keepwork /users/profile 返回结构） */
+export interface KwUserProfile {
+    id?: number;
+    username?: string;
+    nickname?: string;
+    portrait?: string;
+    email?: string;
+    mobile?: string;
+    /** 普通 VIP 到期时间字符串 */
+    commonVipDeadline?: string;
+    /** 普通 VIP 标志 */
+    commonVip?: boolean | number;
+    /** 超级 VIP 到期时间字符串 */
+    vipDeadline?: string;
+    /** 超级 VIP 标志 */
+    vip?: boolean | number;
+    /** 实名认证姓名 */
+    realname?: string;
+    [key: string]: unknown;
+}
+/** HTTP 请求选项（扩展 RequestInit，支持直接传 body 对象） */
+export interface RequestOptions extends Omit<RequestInit, 'body'> {
+    body?: unknown;
+    headers?: Record<string, string>;
+}
+/** getUserProfile 选项 */
+export interface GetProfileOptions {
+    useCache?: boolean;
+    forceRefresh?: boolean;
+}
+/**
+ * 将核心方法注入到 KeepworkSDK 类的 prototype（及静态属性）。
+ * 调用方式：`applyCoreMixin(KeepworkSDK)`
+ *
+ * @param TargetClass - KeepworkSDK 主类（带 `_API_BASE_URL` 静态字段）
+ */
+export declare function applyCoreMixin(TargetClass: any): void;
+//# sourceMappingURL=keepworkSDK.core.d.ts.map

package/dist-npm/types/src/core/keepworkSDK.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keepworkSDK.core.d.ts","sourceRoot":"","sources":["../../../../src/core/keepworkSDK.core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,uBAAuB;AACvB,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,mBAAmB;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,gCAAgC;IAChC,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/C;AAED,iBAAiB;AACjB,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,MAAM,EAAE,cAAc,GAAG,WAAW,GAAG,aAAa,GAAG,eAAe,GAAG,gBAAgB,GAAG,MAAM,CAAC;IACnG,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB;IAChB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,qBAAqB;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,GAAG,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,aAAa;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,8CAA8C;AAC9C,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;IAC/D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,wBAAwB;AACxB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAeD;;;;;GAKG;AAEH,wBAAgB,cAAc,CAAC,WAAW,EAAE,GAAG,GAAG,IAAI,CA6xBrD"}

package/dist-npm/types/src/core/keepworkSDK.d.ts

@@ -0,0 +1,129 @@
+/**
+ * keepworkSDK.ts — KeepworkSDK 主类（TypeScript 版，组合层）
+ *
+ * 本文件只保留：
+ * 1. 依赖服务的 import
+ * 2. 类骨架：静态 getSharedAudioEngine + constructor
+ * 3. aiChat / speechRTC 懒加载 getter/setter
+ * 4. 三个 mixin 注入（applyCoreMixin / applyPagesMixin / applyUtilsMixin）
+ * 5. 静态属性（API_KEYS / source / sourceIsModule / _API_BASE_URL）
+ * 6. 浏览器环境自动初始化 + export
+ *
+ * 具体方法全部由 mixin 文件注入，避免单文件过大。
+ */
+import PersonalPageStore from '../store/PersonalPageStore';
+import SDKLogger from '../utils/SDKLogger';
+import RemoteLog from './RemoteLog';
+import Speech from '../audio/Speech';
+import CopilotTools from '../ai-chat/CopilotTools';
+import WxLaunchApp from '../wechat/WxLaunchApp';
+import WxAuth from '../wechat/WxAuth';
+import LoginWindow from '../ui/LoginWindow';
+import ProfileWindow from '../ui/ProfileWindow';
+import CloudDrive from '../store/CloudDrive';
+import LocalAPIKeySettings from '../ui/LocalAPIKeySettings';
+import AIGenerators from '../ai-chat/AIGenerators';
+import UserWorks from '../user/UserWorks';
+import SocialFriends from '../user/SocialFriends';
+import { type KeepworkSDKOptions } from './keepworkSDK.core';
+declare class KeepworkSDK {
+    /**
+     * 内置 API key 常量。
+     *
+     * 真实 key 不在源码中硬编码，而是由 Vite `define` 在构建期注入 `__MAISI_API_KEY__`：
+     * - CDN/IIFE 构建：从本地 `.env` 的 `MAISI_API_KEY` 注入真实值（自用，不进 npm 包）。
+     * - npm 构建：注入空字符串 `''`，确保发布产物不含 key。
+     *
+     * 因此 npm 包中 `API_KEYS.maisi` 为 `''`；如需鉴权请通过 `setUserApiKey()` 自行提供。
+     */
+    static API_KEYS: Record<string, string>;
+    /** bundle 自身 URL（由 index.ts 在加载时写入，供 DigitalHumanFrame 等推导 CDN 路径）。 */
+    static source: string;
+    static sourceIsModule: boolean;
+    /** 调试用 API 基地址（供 core mixin 的 _initCore 读取）。 */
+    static _API_BASE_URL: string;
+    baseURL: string;
+    token: string | null;
+    timeout: number;
+    retryCount: number;
+    retryDelay: number;
+    userApiKey: string | null;
+    user: unknown;
+    userCacheTimestamp: number | null;
+    userCacheTimeout: number;
+    logger: typeof SDKLogger;
+    personalPageStore: InstanceType<typeof PersonalPageStore>;
+    remoteLog: InstanceType<typeof RemoteLog>;
+    speech: InstanceType<typeof Speech>;
+    copilotTools: InstanceType<typeof CopilotTools>;
+    wxLaunchApp: InstanceType<typeof WxLaunchApp>;
+    wxAuth: InstanceType<typeof WxAuth>;
+    loginWindow: InstanceType<typeof LoginWindow>;
+    profileWindow: InstanceType<typeof ProfileWindow>;
+    cloudDrive: InstanceType<typeof CloudDrive>;
+    localAPIKeySettings: InstanceType<typeof LocalAPIKeySettings>;
+    aiGenerators: InstanceType<typeof AIGenerators>;
+    userWorks: InstanceType<typeof UserWorks>;
+    socialFriends: InstanceType<typeof SocialFriends>;
+    /** @deprecated 向后兼容大写别名，请使用 socialFriends */
+    SocialFriends: InstanceType<typeof SocialFriends>;
+    audioEngine: unknown;
+    minigame: {
+        openSkill: (opts?: unknown) => boolean;
+        close: (opts?: unknown) => boolean;
+    };
+    /** 私有字段（由 _initCore / _patchAIChat 注入） */
+    _aiChat: unknown;
+    _speechRTC: unknown;
+    _authStateChangeListeners: Set<unknown>;
+    _userProfilePromise: unknown;
+    _lastKnownUserKey: string | null;
+    _loadAIChatPromise: Promise<void> | null;
+    _siteTreeCache: Record<string, {
+        data: unknown;
+        time: number;
+    }>;
+    static initializeGlobals: () => void;
+    static getSystem: () => string;
+    static getQueryString: (name: string) => string;
+    static isWeChatBrowser: () => unknown;
+    static getWeChatInfo: () => unknown;
+    static isMobileDevice: () => boolean;
+    static isMobilePortrait: () => boolean;
+    static checkFullscreen: () => boolean;
+    /**
+     * 获取（或创建）全局共享的 AudioEngine 实例。
+     * 多个 SDK 实例共用同一音频引擎，避免重复初始化开销。
+     *
+     * @param options - AudioEngine 初始化选项
+     */
+    static getSharedAudioEngine(options?: Record<string, unknown>): unknown;
+    /**
+     * 创建 KeepworkSDK 实例，初始化所有子服务。
+     *
+     * 构造顺序：
+     * 1. `_initCore(options)` — 初始化 token / baseURL / 缓存等基础字段（由 core mixin 注入）
+     * 2. 按依赖顺序实例化各子服务
+     * 3. `_patchAIChat()` — 若 AIChat chunk 已加载则立即绑定（由 core mixin 注入）
+     *
+     * @param options - 初始化选项
+     */
+    constructor(options?: KeepworkSDKOptions);
+    /**
+     * AIChat 实例（来自 AIChat chunk）。
+     * 首次访问时自动触发懒加载（调用 `_patchAIChat()`）。
+     */
+    get aiChat(): unknown;
+    set aiChat(v: unknown);
+    /**
+     * SpeechRTC 实例（来自 AIChat chunk）。
+     * 首次访问时自动触发懒加载（调用 `_patchAIChat()`）。
+     */
+    get speechRTC(): unknown;
+    set speechRTC(v: unknown);
+}
+export default KeepworkSDK;
+export type { KeepworkSDKOptions } from './keepworkSDK.core';
+export type { SavePageData, LoadPageInfo, DeletePageInfo, PageResult, PageMetadata, CreateSiteData } from './keepworkSDK.pages';
+export type { ParsedPagePath, WeChatInfo } from './keepworkSDK.utils';
+//# sourceMappingURL=keepworkSDK.d.ts.map

package/dist-npm/types/src/core/keepworkSDK.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keepworkSDK.d.ts","sourceRoot":"","sources":["../../../../src/core/keepworkSDK.ts"],"names":[],"mappings":"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"}

package/dist-npm/types/src/core/keepworkSDK.pages.d.ts

@@ -0,0 +1,101 @@
+/**
+ * keepworkSDK.pages.ts — KeepworkSDK 页面与站点管理 mixin（TypeScript 版）
+ *
+ * 包含：
+ * - 页面 CRUD（savePage / loadPage / deletePage / getRawPage / copyPage / pageExists）
+ * - 页面服务端缓存操作（savePageCache / loadPageCache）
+ * - 站点文件树（getSiteTree）
+ * - 站点管理（createSite / getAllSites / getSitesByUsername / getSiteDetail）
+ * - 路径编码工具（getRepoPath / encodeRepoPath / safeEncodeURIComponent）
+ *
+ * 依赖 keepworkSDK.core.ts 注入的 request / get / post / put / delete 方法。
+ */
+/** savePage 参数 */
+export interface SavePageData {
+    /** 格式 "username/sitename" */
+    sitePath: string;
+    /** 页面相对路径（含 .md 扩展名） */
+    pagePath: string;
+    /** 页面内容 */
+    content: string;
+    /** git commit 信息（默认自动生成） */
+    commitMessage?: string;
+    /** 内容编码方式（默认 'utf8'） */
+    encoding?: 'utf8' | 'base64';
+    /** 404 时自动建站（默认 false） */
+    autoCreateSite?: boolean;
+    /** 是否写入服务端缓存而非 git（默认 false） */
+    useCache?: boolean;
+}
+/** savePage / loadPage 结果 */
+export interface PageResult {
+    success: boolean;
+    path: string;
+    sitePath: string;
+    repoPath: string;
+    content?: string;
+    operation?: 'create' | 'update';
+    message?: string;
+    autoCreatedSite?: boolean;
+    cached?: boolean;
+    commitId?: string;
+    fromServerCache?: boolean;
+    metadata?: PageMetadata;
+    error?: string;
+    [key: string]: unknown;
+}
+/** 页面元数据（includeMetadata=true 时返回） */
+export interface PageMetadata {
+    commitId?: string;
+    lastModified?: string;
+    size?: number;
+    encoding?: string;
+    type?: string;
+    downloadUrl?: string;
+    htmlUrl?: string;
+}
+/** loadPage 参数 */
+export interface LoadPageInfo {
+    sitePath: string;
+    pagePath: string;
+    useCache?: boolean;
+    commitId?: string;
+    includeMetadata?: boolean;
+    cdnState?: boolean;
+    useServerCache?: boolean;
+}
+/** deletePage 参数 */
+export interface DeletePageInfo {
+    sitePath: string;
+    pagePath: string;
+    commitMessage?: string;
+    /** 跳过存在性检查（默认 false） */
+    force?: boolean;
+    /** 是否验证文件存在（默认 true） */
+    validateExists?: boolean;
+    /** 同时清理服务端缓存（默认 false） */
+    useCache?: boolean;
+}
+/** copyPage 参数 */
+export interface CopyPageInfo {
+    sourceSitePath: string;
+    sourcePagePath: string;
+    targetSitePath: string;
+    targetPagePath: string;
+    commitMessage?: string;
+}
+/** createSite 参数 */
+export interface CreateSiteData {
+    name: string;
+    username: string;
+    visibility?: 'public' | 'private' | 'protected' | number;
+    sitename?: string;
+    description?: string;
+    [key: string]: unknown;
+}
+/**
+ * 将页面/站点管理方法注入到 KeepworkSDK 类的 prototype。
+ * 调用方式：`applyPagesMixin(KeepworkSDK)`
+ */
+export declare function applyPagesMixin(TargetClass: any): void;
+//# sourceMappingURL=keepworkSDK.pages.d.ts.map

package/dist-npm/types/src/core/keepworkSDK.pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keepworkSDK.pages.d.ts","sourceRoot":"","sources":["../../../../src/core/keepworkSDK.pages.ts"],"names":[],"mappings":"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"}

package/dist-npm/types/src/core/keepworkSDK.utils.d.ts

@@ -0,0 +1,40 @@
+/**
+ * keepworkSDK.utils.ts — KeepworkSDK 工具方法 mixin（TypeScript 版）
+ *
+ * 包含：
+ * - Minigame postMessage 桥接（_createMinigameBridge）
+ * - SandboxToolEnv Paracraft 快捷入口（createParacraftSandbox）
+ * - AgentRouter 全局单例 getter
+ * - 通用编码工具（encodeUserData / parsePagePath）
+ * - 浏览器/设备检测静态方法（isWeChatBrowser / getSystem 等）
+ * - 全局初始化（initializeGlobals）
+ * - 全路径快捷方法（autoCreateSiteAndSavePage / getMarkdownByFullPath 等）
+ *
+ * 依赖：keepworkSDK.core.ts（request/get/post/delete）、
+ *       keepworkSDK.pages.ts（savePage/loadPage/deletePage/pageExists）
+ */
+/** 微信浏览器检测结果 */
+export interface WeChatInfo {
+    isWeChat: boolean;
+    isMiniProgram: boolean;
+    isWorkWeChat: boolean;
+    isAnyWeChat: boolean;
+    userAgent?: string;
+    version?: string | null;
+    platform?: string | null;
+}
+/** parsePagePath 结果 */
+export interface ParsedPagePath {
+    username: string;
+    sitename: string;
+    pagename: string;
+    sitePath: string;
+    fullPath: string;
+    barePath: string;
+}
+/**
+ * 将工具方法注入到 KeepworkSDK 类的 prototype / 静态属性。
+ * 调用方式：`applyUtilsMixin(KeepworkSDK)`
+ */
+export declare function applyUtilsMixin(TargetClass: any): void;
+//# sourceMappingURL=keepworkSDK.utils.d.ts.map

package/dist-npm/types/src/core/keepworkSDK.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keepworkSDK.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/keepworkSDK.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,gBAAgB;AAChB,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,uBAAuB;AACvB,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID;;;GAGG;AAEH,wBAAgB,eAAe,CAAC,WAAW,EAAE,GAAG,GAAG,IAAI,CAyZtD"}