@qzhuli/qzhuli-cli 0.3.0-rc.1 → 0.3.0

package/dist/cmd.js

@@ -14183,14 +14183,41 @@ var SqliteConversationRepository = class {
       "INSERT INTO conversation_profiles (conversation_id, data, user_ids, cached_at) VALUES (?, ?, ?, ?) ON CONFLICT(conversation_id) DO UPDATE SET data=?, user_ids=?, cached_at=?"
     ).run(conversationId, data, user_ids, cached_at, data, user_ids, cached_at);
   }
+  // MARK: Conversation Index (for incremental sync)
+  upsertIndex(conv) {
+    const members = JSON.stringify(conv.cids);
+    const nicks = conv.nicks ? JSON.stringify(conv.nicks) : null;
+    const im_version = conv.version;
+    const cached_at = Date.now();
+    this.db.prepare(
+      "INSERT INTO conversations_index (conversation_id, im_version, members, nicks, cached_at) VALUES (?, ?, ?, ?, ?) ON CONFLICT(conversation_id) DO UPDATE SET im_version=?, members=?, nicks=?, cached_at=?"
+    ).run(conv.id, im_version, members, nicks, cached_at, im_version, members, nicks, cached_at);
+  }
+  getIndexById(conversationId) {
+    return this.db.prepare(
+      "SELECT conversation_id, im_version, members, nicks, cached_at FROM conversations_index WHERE conversation_id = ?"
+    ).get(conversationId);
+  }
+  getAllIds() {
+    const rows = this.db.prepare("SELECT conversation_id FROM conversations_index").all();
+    return rows.map((r) => r.conversation_id);
+  }
+  deleteStale(conversationIds) {
+    if (conversationIds.length === 0) return;
+    const placeholders = conversationIds.map(() => "?").join(",");
+    this.db.prepare(`DELETE FROM conversation_profiles WHERE conversation_id NOT IN (${placeholders})`).run(...conversationIds);
+    this.db.prepare(`DELETE FROM conversations_index WHERE conversation_id NOT IN (${placeholders})`).run(...conversationIds);
+  }
   invalidate(conversationId) {
     this.db.prepare("DELETE FROM conversation_profiles WHERE conversation_id = ?").run(conversationId);
+    this.db.prepare("DELETE FROM conversations_index WHERE conversation_id = ?").run(conversationId);
   }
   sync() {
     return Promise.resolve();
   }
   clear() {
     this.db.exec("DELETE FROM conversation_profiles");
+    this.db.exec("DELETE FROM conversations_index");
     this.db.exec("DELETE FROM cache_metadata WHERE key = 'last_sync_conversations'");
   }
   getStatus() {
@@ -14203,6 +14230,7 @@ var SqliteConversationRepository = class {
   }
 };
 var CachedConversationRepository = class {
+  // 30 minutes
   constructor(local, remote) {
     this.local = local;
     this.remote = remote;
@@ -14210,6 +14238,7 @@ var CachedConversationRepository = class {
   local;
   remote;
   syncInProgress = false;
+  TTL_MS = 30 * 60 * 1e3;
   async queryAll(options3) {
     return this.remote.queryAll(options3);
   }
@@ -14232,7 +14261,7 @@ var CachedConversationRepository = class {
   async ensureSynced() {
     if (this.syncInProgress) return;
     const status = await this.local.getStatus();
-    const isFresh = status.lastSyncAt !== null && Date.now() - status.lastSyncAt < 5 * 60 * 1e3;
+    const isFresh = status.lastSyncAt !== null && Date.now() - status.lastSyncAt < this.TTL_MS;
     if (isFresh) return;
     this.syncInProgress = true;
     try {
@@ -14244,12 +14273,22 @@ var CachedConversationRepository = class {
   async sync() {
     const convResult = await this.remote.queryAll({ limit: 0, offset: 0 });
     if (!convResult.ok || !convResult.data) return;
-    for (const conv of convResult.data) {
-      const profileResult = await this.remote.getProfile(conv.id);
-      if (profileResult.ok) {
-        this.local.upsertProfile(conv.id, profileResult.data);
+    const remoteConversations = convResult.data;
+    const remoteIds = new Set(remoteConversations.map((c) => c.id));
+    const cachedIds = new Set(this.local.getAllIds());
+    const newIds = remoteConversations.filter((c) => !cachedIds.has(c.id)).map((c) => c.id);
+    for (const conv of remoteConversations) {
+      if (newIds.includes(conv.id)) {
+        const profileResult = await this.remote.getProfile(conv.id);
+        if (profileResult.ok) {
+          this.local.upsertProfile(conv.id, profileResult.data);
+        }
       }
     }
+    for (const conv of remoteConversations) {
+      this.local.upsertIndex(conv);
+    }
+    this.local.deleteStale([...remoteIds]);
     this.local.db.prepare("INSERT OR REPLACE INTO cache_metadata (key, value) VALUES (?, ?)").run("last_sync_conversations", String(Date.now()));
   }
   invalidate(conversationId) {
@@ -14495,6 +14534,14 @@ CREATE TABLE IF NOT EXISTS messages_cache (
 );
 CREATE INDEX IF NOT EXISTS idx_msg_conv ON messages_cache(conversation_id);
 
+CREATE TABLE IF NOT EXISTS conversations_index (
+  conversation_id TEXT PRIMARY KEY,
+  im_version INTEGER NOT NULL,
+  members TEXT NOT NULL,
+  nicks TEXT,
+  cached_at INTEGER NOT NULL
+);
+
 CREATE TABLE IF NOT EXISTS cache_metadata (
   key TEXT PRIMARY KEY,
   value TEXT
@@ -14760,7 +14807,7 @@ async function main() {
 ${t("cli.banner")}` : t("cli.banner");
   program.addHelpText("beforeAll", `${banner}
 `);
-  program.name("qz").version(`v${"0.3.0-rc.1"}`, "-v, --version", t("options.version")).helpOption("-h, --help", t("options.help")).option("-q, --jq <expr>", t("options.jq")).option("--dry-run", t("options.dryRun"));
+  program.name("qz").version(`v${"0.3.0"}`, "-v, --version", t("options.version")).helpOption("-h, --help", t("options.help")).option("-q, --jq <expr>", t("options.jq")).option("--dry-run", t("options.dryRun"));
   program.usage("<command> [subcommand] [options]");
   program.hook("preAction", () => {
     const opts = program.opts();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qzhuli/qzhuli-cli",
-  "version": "0.3.0-rc.1",
+  "version": "0.3.0",
   "description": "CLI tool for Q助理 (QZhuli)",
   "main": "dist/cmd.js",
   "bin": {

package/skills/qzhuli-cli/SKILL.md

@@ -60,13 +60,15 @@ actions, auth login/logout, and preference writes.
 All read operations use a **Repository Pattern** with SQLite-backed caching:
 
 - **Local-first**: reads hit a local SQLite database (`~/.qzhuli-cli/cache.db`) before the remote API
-- **TTL-based expiration**: contacts/relations expire after 5 minutes, user profiles after 1 hour
-- **Auto-sync on miss**: cache miss triggers a remote fetch + automatic cache write-back
-- **Manual sync**: use `qz cache sync` to pre-fetch all data
+- **TTL-based expiration**: conversations expire after 30 minutes, contacts/relations after 5 minutes, user profiles after 1 hour
+- **Incremental sync**: sync compares the IM conversation list against a local index, only fetching profiles for *new* conversations
+- **Auto-sync on miss**: cache miss triggers an incremental sync (not full refetch)
+- **Manual sync**: use `qz cache sync` to sync only new data
 
 Cache database tables:
 
-- `conversation_profiles` — conversation metadata with user_ids index
+- `conversations_index` — lightweight IM metadata (id, version, members, nicks) for incremental sync
+- `conversation_profiles` — full conversation profile data with user_ids index
 - `contacts_cache` — full contacts list per owner UID
 - `user_profiles` — individual user profiles
 - `relations_cache` — friend relations (remark, type)
@@ -214,5 +216,5 @@ qz conversation search 10000  # now instant from cache
 | Too much JSON          | Use `--jq ".data"` or another simple dot path.                           |
 | Need a no-op preview   | Use `--dry-run`.                                                         |
 | Message send cid error | Re-check `auth status` and choose `target-cid` from `conversation list`. |
-| Slow queries           | Run `qz cache sync` first, then retry — results come from local SQLite.  |
+| Slow queries           | Run `qz cache sync` first (incremental, fast), then retry — results come from local SQLite. |
 | Cache corrupted        | Run `qz cache clear` to reset, then retry (falls back to API).           |