@solazah/solazah-runtime 0.1.77 → 0.1.83

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solazah/solazah-runtime",
-  "version": "0.1.77",
+  "version": "0.1.83",
   "main": "index.cjs",
   "module": "index.js",
   "types": "types/index.d.ts",

package/types/Sync.d.ts

@@ -8,7 +8,15 @@ export interface SyncStatusDto {
     lastSyncAt: number | null;
     lastError: string | null;
     pushedSeq: number;
-    peers: number;
+    /** 文件侧游标(与 pushedSeq 是两条独立的线:后者是 cloud.db 的水位)。 */
+    fileChangeId: number;
+    /** 空间占用。界面不单独展示,只用于排障与超额提示。 */
+    usage: {
+        usedBytes: number;
+        quotaBytes: number;
+        perFileBytes: number;
+        tier: string;
+    } | null;
     /** 当前同步命名空间 = 账号 ID(消毒为路径安全),即 COS 分区目录名。用于核对多设备是否同一账号。 */
     namespace: string | null;
     /** 是否为付费会员。跨设备同步是会员功能。 */
@@ -33,17 +41,26 @@ export interface SyncAppliedPayload {
     db?: boolean;
     files?: boolean;
 }
-/** 一条同步变更日志(仅记"有活动/出错"的同步),给账号-同步页排障。 */
+/**
+ * 一条**真实发生的同步操作**。设置页直接展示,一行就是一件事。
+ *
+ * 不再是每轮的聚合计数:新模型里一条变更可能完全不传输任何字节(移动只改路径、删除不下载),
+ * 「文件下载 12」那种数字会让人以为花了 12 个文件的流量。
+ */
 export interface SyncLogEntry {
     at: number;
+    /** DOWN=拉到本机, UP=推出去, BOTH=与方向无关(如设置与插件那条线)。 */
+    direction: string;
+    /** CREATE / UPDATE / MOVE / DELETE / CONFLICT / DB / FAILED */
+    action: string;
+    path: string;
+    /** MOVE 的旧路径、CONFLICT 的副本落点。 */
+    fromPath: string | null;
+    size: number;
+    /** 服务端日志游标,排查时能直接对上。 */
+    changeId: number | null;
+    error: string | null;
     reason: string;
-    ns: string;
-    dbPulled: number;
-    dbPushed: number;
-    filesPulled: number;
-    filesPushed: number;
-    ok: boolean;
-    error?: string;
 }
 /**
  * window.sync —— 数据库/工作空间同步的公共 API(sync.* IPC)。
@@ -66,7 +83,7 @@ export default class Sync {
     /** 立即同步一次,返回最新状态。 */
     now: () => Promise<SyncStatusDto>;
     /** 读同步变更日志(最新在前),给账号-同步页排障。 */
-    getLog: (limit?: number) => Promise<SyncLogEntry[]>;
+    getLog: (limit?: number, offset?: number) => Promise<SyncLogEntry[]>;
     /**
      * 订阅"同步已应用"(主进程拉到远端 DB/文件变更后广播)→ 据此重拉刷新。返回退订闭包。
      * 多订阅者共用单条 ipcRenderer 通道(宿主 on 会 removeAllListeners,故在本实例内自行分发)。

package/types/System.d.ts

@@ -5,6 +5,9 @@ export default class System {
     /** 返回当前运行平台标识("win32" / "darwin" / "linux" 等,同 Node process.platform)。
      * @returns 平台标识字符串 */
     getPlatform: () => Promise<any>;
+    /** Solazah 在用户家目录下的根目录绝对路径(双库、日志、插件、skill 都在这下面)。
+     * @returns 形如 `C:\Users\<用户>\.solazah` 的绝对路径 */
+    getSolazahHome: () => Promise<string>;
     /** 显示并聚焦 Solazah 主窗口(搜索框);主窗口不存在时不做任何事。
      * @returns 无返回 */
     openMainApp: () => Promise<any>;

package/types/SystemSetting.d.ts

@@ -3,7 +3,7 @@ export default class SystemSetting {
     private transport;
     constructor(transport?: IpcRenderer);
     /**
-     * 获取合并后的全部系统设置键值表。合并顺序:打包默认(DEFAULT_SETTINGS) → 文件(开发环境 settings.local.json,生产环境 ~/.solazah/settings.json) → 数据库;
+     * 获取合并后的全部系统设置键值表。合并顺序:打包默认(DEFAULT_SETTINGS) → 文件(~/.solazah/solazah.settings.json) → 数据库;
      * 开发环境中文件覆盖数据库,生产环境中数据库覆盖文件,保证用户运行时的改动优先。
      *
      * @returns 合并后的设置键值表,键为设置 key、值为对应值。