readshell 0.3.2 → 1.0.0

package/dist/index.js

@@ -6,7 +6,7 @@ import { hideBin } from "yargs/helpers";
 
 // src/services/BookService.ts
 import { resolve } from "path";
-import { existsSync as existsSync2, statSync } from "fs";
+import { existsSync as existsSync3, statSync } from "fs";
 import { nanoid } from "nanoid";
 
 // src/db/client.ts
@@ -17,19 +17,24 @@ import { join } from "path";
 import { homedir } from "os";
 import { mkdirSync, existsSync } from "fs";
 function getAppDataDir() {
-  const platform = process.platform;
-  let configDir;
-  if (platform === "darwin") {
-    configDir = join(homedir(), "Library", "Application Support", "readshell");
-  } else if (platform === "win32") {
-    configDir = join(process.env["APPDATA"] || join(homedir(), "AppData", "Roaming"), "readshell");
+  const override = process.env["READSHELL_HOME"];
+  let configDir2;
+  if (override) {
+    configDir2 = override;
   } else {
-    configDir = join(process.env["XDG_CONFIG_HOME"] || join(homedir(), ".config"), "readshell");
+    const platform = process.platform;
+    if (platform === "darwin") {
+      configDir2 = join(homedir(), "Library", "Application Support", "readshell");
+    } else if (platform === "win32") {
+      configDir2 = join(process.env["APPDATA"] || join(homedir(), "AppData", "Roaming"), "readshell");
+    } else {
+      configDir2 = join(process.env["XDG_CONFIG_HOME"] || join(homedir(), ".config"), "readshell");
+    }
   }
-  if (!existsSync(configDir)) {
-    mkdirSync(configDir, { recursive: true });
+  if (!existsSync(configDir2)) {
+    mkdirSync(configDir2, { recursive: true });
   }
-  return configDir;
+  return configDir2;
 }
 function getDbPath() {
   return join(getAppDataDir(), "readshell.db");
@@ -123,6 +128,13 @@ var BookModel = class {
     const db2 = getDb();
     return db2.prepare("SELECT * FROM books ORDER BY created_at DESC").all();
   }
+  /**
+   * 更新书名/作者（文件夹同步导入后恢复远端元数据用）
+   */
+  updateMeta(id, title, author) {
+    const db2 = getDb();
+    db2.prepare("UPDATE books SET title = ?, author = ? WHERE id = ?").run(title, author, id);
+  }
   /**
    * 删除书籍
    */
@@ -253,6 +265,152 @@ var ProgressModel = class {
   }
 };
 
+// src/db/models/Bookmark.ts
+var BookmarkModel = class {
+  /**
+   * 插入书签
+   */
+  insert(bookmark) {
+    const db2 = getDb();
+    db2.prepare(`
+      INSERT INTO bookmarks (book_id, title, byte_offset, created_at, updated_at, deleted)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `).run(
+      bookmark.book_id,
+      bookmark.title,
+      bookmark.byte_offset,
+      bookmark.created_at,
+      bookmark.updated_at,
+      bookmark.deleted
+    );
+  }
+  /**
+   * 获取指定书籍的所有有效书签（不含墓碑）
+   */
+  findByBookId(bookId) {
+    const db2 = getDb();
+    return db2.prepare("SELECT * FROM bookmarks WHERE book_id = ? AND deleted = 0 ORDER BY created_at DESC").all(bookId);
+  }
+  /**
+   * 获取指定书籍的全部书签记录（含墓碑，同步导出用）
+   */
+  findAllByBookId(bookId) {
+    const db2 = getDb();
+    return db2.prepare("SELECT * FROM bookmarks WHERE book_id = ? ORDER BY created_at DESC").all(bookId);
+  }
+  /**
+   * 按 (book_id, byte_offset) 查找有效书签
+   */
+  findByOffset(bookId, byteOffset) {
+    const db2 = getDb();
+    return db2.prepare("SELECT * FROM bookmarks WHERE book_id = ? AND byte_offset = ? AND deleted = 0").get(bookId, byteOffset);
+  }
+  /**
+   * 按 (book_id, byte_offset) 查找书签记录（含墓碑，同步合并用）
+   */
+  findByOffsetAny(bookId, byteOffset) {
+    const db2 = getDb();
+    return db2.prepare("SELECT * FROM bookmarks WHERE book_id = ? AND byte_offset = ?").get(bookId, byteOffset);
+  }
+  /**
+   * 按 (book_id, byte_offset) 软删除书签（写墓碑，同步传播删除用）
+   */
+  deleteByOffset(bookId, byteOffset) {
+    const db2 = getDb();
+    db2.prepare("UPDATE bookmarks SET deleted = 1, updated_at = ? WHERE book_id = ? AND byte_offset = ? AND deleted = 0").run(Date.now(), bookId, byteOffset);
+  }
+  /**
+   * 同步合并：按 (book_id, byte_offset) 覆盖写入一条书签记录（可为墓碑）
+   */
+  saveByOffset(record) {
+    const db2 = getDb();
+    const existing = this.findByOffsetAny(record.book_id, record.byte_offset);
+    if (existing?.id !== void 0) {
+      db2.prepare(`
+        UPDATE bookmarks SET title = ?, created_at = ?, updated_at = ?, deleted = ?
+        WHERE id = ?
+      `).run(record.title, record.created_at, record.updated_at, record.deleted, existing.id);
+    } else {
+      this.insert(record);
+    }
+  }
+  /**
+   * 获取指定书签
+   */
+  findById(id) {
+    const db2 = getDb();
+    return db2.prepare("SELECT * FROM bookmarks WHERE id = ?").get(id);
+  }
+  /**
+   * 获取书籍有效书签总数
+   */
+  getCount(bookId) {
+    const db2 = getDb();
+    const result = db2.prepare("SELECT COUNT(*) as count FROM bookmarks WHERE book_id = ? AND deleted = 0").get(bookId);
+    return result.count;
+  }
+  /**
+   * 删除书签（写墓碑）
+   */
+  delete(id) {
+    const db2 = getDb();
+    db2.prepare("UPDATE bookmarks SET deleted = 1, updated_at = ? WHERE id = ? AND deleted = 0").run(Date.now(), id);
+  }
+  /**
+   * 移除整本书的书签 (配合彻底清理书籍使用，物理删除含墓碑)
+   */
+  deleteByBookId(bookId) {
+    const db2 = getDb();
+    db2.prepare("DELETE FROM bookmarks WHERE book_id = ?").run(bookId);
+  }
+};
+
+// src/db/models/ReadingSession.ts
+var ReadingSessionModel = class {
+  /**
+   * 记录一次阅读会话
+   */
+  insert(session) {
+    const db2 = getDb();
+    db2.prepare(`
+      INSERT INTO reading_sessions (id, book_id, started_at, ended_at, bytes_read)
+      VALUES (?, ?, ?, ?, ?)
+    `).run(session.id, session.book_id, session.started_at, session.ended_at, session.bytes_read);
+  }
+  /**
+   * 按 id 合并远端会话（已存在则跳过）
+   */
+  insertIfAbsent(session) {
+    const db2 = getDb();
+    const result = db2.prepare(`
+      INSERT OR IGNORE INTO reading_sessions (id, book_id, started_at, ended_at, bytes_read)
+      VALUES (?, ?, ?, ?, ?)
+    `).run(session.id, session.book_id, session.started_at, session.ended_at, session.bytes_read);
+    return result.changes > 0;
+  }
+  /**
+   * 获取指定书籍的全部会话
+   */
+  findByBookId(bookId) {
+    const db2 = getDb();
+    return db2.prepare("SELECT * FROM reading_sessions WHERE book_id = ? ORDER BY started_at ASC").all(bookId);
+  }
+  /**
+   * 获取全部会话（统计与同步导出用）
+   */
+  findAll() {
+    const db2 = getDb();
+    return db2.prepare("SELECT * FROM reading_sessions ORDER BY started_at ASC").all();
+  }
+  /**
+   * 删除指定书籍的全部会话（配合彻底清理书籍使用）
+   */
+  deleteByBookId(bookId) {
+    const db2 = getDb();
+    db2.prepare("DELETE FROM reading_sessions WHERE book_id = ?").run(bookId);
+  }
+};
+
 // src/parsers/TxtParser.ts
 import { readFileSync } from "fs";
 import { detect } from "chardet";
@@ -279,7 +437,7 @@ async function parseTxt(filePath) {
 }
 function extractTitle(filePath) {
   const basename = filePath.split("/").pop() || filePath;
-  return basename.replace(/\.txt$/i, "").trim() || "\u672A\u547D\u540D";
+  return basename.replace(/\.(txt|md)$/i, "").trim() || "\u672A\u547D\u540D";
 }
 function extractChapters(content) {
   const chapters = [];
@@ -353,10 +511,10 @@ ${plainText}
   };
 }
 function openEpub(filePath) {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve5, reject) => {
     const epub = new EPub(filePath);
     epub.on("error", (err) => reject(err));
-    epub.on("end", () => resolve3(epub));
+    epub.on("end", () => resolve5(epub));
     epub.parse();
   });
 }
@@ -372,13 +530,13 @@ function detectHtmlEncoding(buffer) {
   return chardetResult || "utf-8";
 }
 function getChapterHtml(epub, chapterId) {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve5, reject) => {
     epub.getFile(chapterId, (err, data) => {
       if (err) return reject(err);
       const buffer = data;
       const encoding = detectHtmlEncoding(buffer);
       const htmlText = encoding.toLowerCase().replace("-", "") === "utf8" || encoding.toLowerCase() === "utf-8" ? buffer.toString("utf-8") : iconv2.decode(buffer, encoding);
-      resolve3(htmlText);
+      resolve5(htmlText);
     });
   });
 }
@@ -387,6 +545,7 @@ function getChapterHtml(epub, chapterId) {
 async function parseFile(filePath, format) {
   switch (format) {
     case "txt":
+    case "md":
       return parseTxt(filePath);
     case "epub":
       return parseEpub(filePath);
@@ -405,97 +564,6 @@ async function computeFileHash(filePath) {
   return hash.digest("hex");
 }
 
-// src/services/BookService.ts
-var BookService = class {
-  bookModel = new BookModel();
-  chapterModel = new ChapterModel();
-  recentModel = new RecentModel();
-  progressModel = new ProgressModel();
-  /**
-   * 导入书籍文件
-   */
-  async importBook(filePath) {
-    const absPath = resolve(filePath);
-    if (!existsSync2(absPath)) {
-      throw new Error(`\u6587\u4EF6\u4E0D\u5B58\u5728: ${absPath}`);
-    }
-    const format = this.detectFormat(absPath);
-    if (!format) {
-      throw new Error("\u4E0D\u652F\u6301\u7684\u6587\u4EF6\u683C\u5F0F\u3002\u76EE\u524D\u652F\u6301: .txt, .epub");
-    }
-    const fileHash = await computeFileHash(absPath);
-    const existing = this.bookModel.findByHash(fileHash);
-    if (existing) {
-      logger.debug(`\u6587\u4EF6\u5DF2\u5B58\u5728: ${existing.title} (${existing.id})`);
-      return existing;
-    }
-    const parsed = await parseFile(absPath, format);
-    const stats = statSync(absPath);
-    const book = {
-      id: nanoid(),
-      title: parsed.title,
-      author: parsed.author || null,
-      file_path: absPath,
-      format,
-      file_hash: fileHash,
-      file_size: stats.size,
-      created_at: Date.now()
-    };
-    this.bookModel.insert(book);
-    if (parsed.chapters.length > 0) {
-      this.chapterModel.insertMany(
-        parsed.chapters.map((ch, idx) => ({
-          book_id: book.id,
-          chapter_no: idx,
-          title: ch.title,
-          byte_offset: ch.byteOffset
-        }))
-      );
-    }
-    logger.debug(`\u5BFC\u5165\u6210\u529F: ${book.title}`);
-    return book;
-  }
-  /**
-   * 查找书籍（ID 或模糊匹配书名）
-   */
-  findBook(target) {
-    const byId = this.bookModel.findById(target);
-    if (byId) return byId;
-    const results = this.bookModel.searchByTitle(target);
-    return results[0];
-  }
-  /**
-   * 搜索书籍
-   */
-  searchBooks(keyword) {
-    return this.bookModel.searchByTitle(keyword);
-  }
-  /**
-   * 获取所有书籍
-   */
-  getAllBooks() {
-    return this.bookModel.findAll();
-  }
-  /**
-   * 删除书籍及相关数据
-   */
-  deleteBook(id) {
-    this.chapterModel.deleteByBookId(id);
-    this.progressModel.delete(id);
-    this.recentModel.delete(id);
-    this.bookModel.delete(id);
-  }
-  /**
-   * 检测文件格式
-   */
-  detectFormat(filePath) {
-    const ext = filePath.toLowerCase().split(".").pop();
-    if (ext === "txt") return "txt";
-    if (ext === "epub") return "epub";
-    return null;
-  }
-};
-
 // src/locales/zh.ts
 var zh_default = {
   // Common
@@ -506,11 +574,11 @@ var zh_default = {
   "common.quit": "\u6309 q \u9000\u51FA",
   // CLI
   "cli.import.desc": "\u5BFC\u5165\u672C\u5730\u6587\u4EF6\u6216\u76EE\u5F55\u5230\u4E66\u67B6",
-  "cli.import.help": "\u6587\u4EF6\u6216\u76EE\u5F55\u8DEF\u5F84\uFF08\u652F\u6301 .txt / .epub\uFF09",
+  "cli.import.help": "\u6587\u4EF6\u6216\u76EE\u5F55\u8DEF\u5F84\uFF08\u652F\u6301 .txt / .epub / .md\uFF09",
   "cli.import.success": "\u2713 \u5DF2\u5BFC\u5165:",
   "cli.import.fail": "\u5BFC\u5165\u5931\u8D25:",
   "cli.import.not_found": "\u8DEF\u5F84\u4E0D\u5B58\u5728:",
-  "cli.import.unsupported": "\u4E0D\u652F\u6301\u7684\u6587\u4EF6\u683C\u5F0F\u3002\u76EE\u524D\u652F\u6301: .txt, .epub",
+  "cli.import.unsupported": "\u4E0D\u652F\u6301\u7684\u6587\u4EF6\u683C\u5F0F\u3002\u76EE\u524D\u652F\u6301: .txt, .epub, .md",
   "cli.import.scan_dir": "\u626B\u63CF\u76EE\u5F55",
   "cli.import.found_files": "\u627E\u5230\u4EE5\u4E0B\u4E66\u7C4D\uFF1A",
   "cli.import.confirm_batch": "\u662F\u5426\u786E\u8BA4\u5BFC\u5165\u4E0A\u8FF0 {0} \u672C\u4E66\uFF1F(y/N)",
@@ -530,6 +598,8 @@ var zh_default = {
   "cli.remove.not_found": "\u2717 \u672A\u627E\u5230\u5339\u914D\u4E66\u7C4D:",
   "cli.remove.success": "\u2713 \u5DF2\u79FB\u9664\u4E66\u7C4D:",
   "cli.remove.fail": "\u79FB\u9664\u4E66\u7C4D\u5931\u8D25:",
+  "cli.lang.desc": "\u5207\u6362\u754C\u9762\u8BED\u8A00",
+  "cli.lang.help": "\u76EE\u6807\u8BED\u8A00\uFF08zh \u4E2D\u6587 | en \u82F1\u6587\uFF09",
   "cli.lang.success": "\u2713 \u8BED\u8A00\u5DF2\u5207\u6362\u4E3A: {0}",
   "cli.lang.unsupported": "\u2717 \u4E0D\u652F\u6301\u7684\u8BED\u8A00: {0}",
   "cli.config.desc": "\u4FEE\u6539\u5E94\u7528\u914D\u7F6E",
@@ -557,7 +627,37 @@ var zh_default = {
   "tui.nav.tips": "Enter \u8DF3\u8F6C \xB7 Tab \u5207\u6362 \xB7 Esc/q \u5173\u95ED",
   "tui.nav.hint": "\u6309 C \u952E\u5F39\u51FA\u6B64\u6E05\u5355\uFF0C\u6309 Tab \u5207\u6362\u4E66\u7B7E",
   "tui.nav.empty": "\u6CA1\u6709\u8BB0\u5F55",
-  "tui.nav.page": "\u7B2C {0} / {1} \u9875"
+  "tui.nav.page": "\u7B2C {0} / {1} \u9875",
+  // TUI - Help
+  "tui.help.title": "\u5FEB\u6377\u952E",
+  "tui.help.next": "  Space / j / \u2193 / f  \u4E0B\u4E00\u9875",
+  "tui.help.prev": "  k / \u2191  \u4E0A\u4E00\u9875 \xB7 g \u9996\u9875 \xB7 G \u672B\u9875",
+  "tui.help.nav": "  c \u7AE0\u8282\u4E0E\u4E66\u7B7E \xB7 Tab \u5207\u6362 \xB7 m \u52A0\u4E66\u7B7E",
+  "tui.help.boss": "  b / Esc \u8001\u677F\u952E \xB7 q \u9000\u51FA \xB7 ? \u5E2E\u52A9",
+  // Sync / Stats / Bookmarks
+  "cli.sync.desc": "\u901A\u8FC7\u540C\u6B65\u6587\u4EF6\u5939\u5728\u591A\u8BBE\u5907\u95F4\u540C\u6B65\u8FDB\u5EA6\u3001\u4E66\u7B7E\u4E0E\u9605\u8BFB\u7EDF\u8BA1",
+  "cli.sync.dir": "\u540C\u6B65\u76EE\u5F55\u8DEF\u5F84\uFF08\u5982 iCloud Drive / Dropbox / \u575A\u679C\u4E91 \u5185\u7684\u6587\u4EF6\u5939\uFF09",
+  "cli.sync.with_books": "\u540C\u65F6\u540C\u6B65\u4E66\u6E90\u6587\u4EF6\uFF08\u5176\u4ED6\u8BBE\u5907\u53EF\u81EA\u52A8\u5BFC\u5165\u7F3A\u5931\u7684\u4E66\uFF09",
+  "cli.sync.off": "\u5173\u95ED\u6587\u4EF6\u5939\u540C\u6B65",
+  "cli.sync.disabled": "\u2713 \u5DF2\u5173\u95ED\u6587\u4EF6\u5939\u540C\u6B65",
+  "cli.sync.dir_set": "\u2713 \u540C\u6B65\u76EE\u5F55\u5DF2\u8BBE\u7F6E: {0}",
+  "cli.sync.dir_invalid": "\u2717 \u76EE\u5F55\u4E0D\u5B58\u5728\u6216\u4E0D\u662F\u6587\u4EF6\u5939: {0}",
+  "cli.sync.no_dir": "\u5C1A\u672A\u8BBE\u7F6E\u540C\u6B65\u76EE\u5F55\u3002\u8BF7\u5148\u8FD0\u884C: novel sync --dir <\u8DEF\u5F84>",
+  "cli.sync.running": "\u540C\u6B65\u4E2D...",
+  "cli.sync.success": "\u2713 \u540C\u6B65\u5B8C\u6210\uFF08\u5408\u5E76 {0} \u6761\uFF0C\u6765\u81EA {1} \u53F0\u8BBE\u5907\uFF09",
+  "cli.sync.failed": "\u540C\u6B65\u5931\u8D25\uFF1A{0}",
+  "cli.stats.desc": "\u9605\u8BFB\u7EDF\u8BA1\uFF1A\u70ED\u529B\u56FE\u4E0E\u8FDE\u7EED\u5929\u6570",
+  "cli.stats.title": "\u{1F4CA} \u9605\u8BFB\u7EDF\u8BA1",
+  "cli.stats.less": "\u5C11",
+  "cli.stats.more": "\u591A",
+  "cli.stats.summary": "\u9605\u8BFB\u5929\u6570 {0} \xB7 \u603B\u65F6\u957F {1} \u5206\u949F \xB7 \u8BFB\u8FC7 {2} \u672C \xB7 \u5F53\u524D\u8FDE\u7EED {3} \u5929 \xB7 \u6700\u957F\u8FDE\u7EED {4} \u5929",
+  "cli.bookmarks.desc": "\u4E66\u7B7E\u7BA1\u7406",
+  "cli.bookmarks.export.desc": "\u5BFC\u51FA\u5168\u90E8\u4E66\u7B7E",
+  "cli.bookmarks.export.format": "\u8F93\u51FA\u683C\u5F0F: json | md",
+  "cli.bookmarks.export.out": "\u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84\uFF08\u9ED8\u8BA4\u6253\u5370\u5230\u7EC8\u7AEF\uFF09",
+  "cli.bookmarks.export.empty": "\u6CA1\u6709\u4E66\u7B7E\u53EF\u5BFC\u51FA",
+  "cli.bookmarks.export.success": "\u2713 \u5DF2\u5BFC\u51FA {0} \u6761\u4E66\u7B7E\u5230 {1}",
+  "cli.bookmarks.export.fail": "\u5BFC\u51FA\u4E66\u7B7E\u5931\u8D25: {0}"
 };
 
 // src/locales/en.ts
@@ -570,11 +670,11 @@ var en = {
   "common.quit": "Press q to quit",
   // CLI
   "cli.import.desc": "Import local file or directory to library",
-  "cli.import.help": "File or directory path (supports .txt / .epub)",
+  "cli.import.help": "File or directory path (supports .txt / .epub / .md)",
   "cli.import.success": "\u2713 Imported:",
   "cli.import.fail": "Import failed:",
   "cli.import.not_found": "Path not found:",
-  "cli.import.unsupported": "Unsupported file format. Currently supports: .txt, .epub",
+  "cli.import.unsupported": "Unsupported file format. Currently supports: .txt, .epub, .md",
   "cli.import.scan_dir": "Scanning directory",
   "cli.import.found_files": "Found following books:",
   "cli.import.confirm_batch": "Confirm importing these {0} books? (y/N)",
@@ -594,6 +694,8 @@ var en = {
   "cli.remove.not_found": "\u2717 Book not found:",
   "cli.remove.success": "\u2713 Book removed:",
   "cli.remove.fail": "Failed to remove book:",
+  "cli.lang.desc": "Switch interface language",
+  "cli.lang.help": "Target language (zh Chinese | en English)",
   "cli.lang.success": "\u2713 Language switched to: {0}",
   "cli.lang.unsupported": "\u2717 Unsupported language: {0}",
   "cli.config.desc": "Modify application configuration",
@@ -622,35 +724,123 @@ var en = {
   "tui.nav.tips": "Enter jump \xB7 Tab switch \xB7 Esc/q close",
   "tui.nav.hint": "Press C to open this list, press Tab to switch to bookmarks",
   "tui.nav.empty": "No records",
-  "tui.nav.page": "Page {0} / {1}"
+  "tui.nav.page": "Page {0} / {1}",
+  // TUI - Help
+  "tui.help.title": "Keyboard shortcuts",
+  "tui.help.next": "  Space / j / \u2193 / f  next page",
+  "tui.help.prev": "  k / \u2191  prev page \xB7 g first \xB7 G last",
+  "tui.help.nav": "  c chapters & bookmarks \xB7 Tab switch \xB7 m bookmark",
+  "tui.help.boss": "  b / Esc boss key \xB7 q quit \xB7 ? help",
+  // Sync / Stats / Bookmarks
+  "cli.sync.desc": "Sync progress, bookmarks and reading stats across devices via a synced folder",
+  "cli.sync.dir": "Sync folder path (e.g. a folder inside iCloud Drive / Dropbox / Syncthing)",
+  "cli.sync.with_books": "Also sync book files (other devices auto-import missing books)",
+  "cli.sync.off": "Disable folder sync",
+  "cli.sync.disabled": "\u2713 Folder sync disabled",
+  "cli.sync.dir_set": "\u2713 Sync folder set: {0}",
+  "cli.sync.dir_invalid": "\u2717 Path does not exist or is not a directory: {0}",
+  "cli.sync.no_dir": "No sync folder configured. Run: novel sync --dir <path>",
+  "cli.sync.running": "Syncing...",
+  "cli.sync.success": "\u2713 Sync complete (merged {0} items from {1} devices)",
+  "cli.sync.failed": "Sync failed: {0}",
+  "cli.stats.desc": "Reading stats: heatmap and streaks",
+  "cli.stats.title": "\u{1F4CA} Reading Stats",
+  "cli.stats.less": "Less",
+  "cli.stats.more": "More",
+  "cli.stats.summary": "{0} reading days \xB7 {1} minutes total \xB7 {2} books \xB7 current streak {3}d \xB7 longest {4}d",
+  "cli.bookmarks.desc": "Manage bookmarks",
+  "cli.bookmarks.export.desc": "Export all bookmarks",
+  "cli.bookmarks.export.format": "Output format: json | md",
+  "cli.bookmarks.export.out": "Output file path (defaults to stdout)",
+  "cli.bookmarks.export.empty": "No bookmarks to export",
+  "cli.bookmarks.export.success": "\u2713 Exported {0} bookmarks to {1}",
+  "cli.bookmarks.export.fail": "Failed to export bookmarks: {0}"
 };
 var en_default = en;
 
 // src/config/AppConfig.ts
 import Conf from "conf";
+import { randomUUID } from "crypto";
+import { existsSync as existsSync2, copyFileSync } from "fs";
+import { join as join2 } from "path";
+import { homedir as homedir2 } from "os";
 var defaults = {
   linesPerPage: 0,
   showStatusBar: true,
   readingMode: "page",
   language: "zh",
-  lineSpacing: 0
+  lineSpacing: 0,
+  bossKeyLang: "nodejs"
 };
+var configDir = getAppDataDir();
+function legacyConfigPath() {
+  const name = "readshell-nodejs";
+  if (process.platform === "darwin") {
+    return join2(homedir2(), "Library", "Preferences", name, "config.json");
+  }
+  if (process.platform === "win32") {
+    const appData = process.env["APPDATA"] || join2(homedir2(), "AppData", "Roaming");
+    return join2(appData, name, "Config", "config.json");
+  }
+  const xdgConfig = process.env["XDG_CONFIG_HOME"] || join2(homedir2(), ".config");
+  return join2(xdgConfig, name, "config.json");
+}
+var newConfigPath = join2(configDir, "config.json");
+if (!process.env["READSHELL_HOME"] && !existsSync2(newConfigPath)) {
+  const legacyPath = legacyConfigPath();
+  if (existsSync2(legacyPath)) {
+    try {
+      copyFileSync(legacyPath, newConfigPath);
+    } catch {
+    }
+  }
+}
 var config = new Conf({
-  projectName: "readshell",
+  cwd: configDir,
   defaults
 });
+for (const legacyKey of [
+  "authToken",
+  "authUserId",
+  "authDeviceId",
+  "authTier",
+  "authExpiresAt",
+  "lastSyncAt"
+]) {
+  config.delete(legacyKey);
+}
 function getConfig() {
   return {
     linesPerPage: config.get("linesPerPage"),
     showStatusBar: config.get("showStatusBar"),
     readingMode: config.get("readingMode"),
     language: config.get("language"),
-    lineSpacing: config.get("lineSpacing")
+    lineSpacing: config.get("lineSpacing"),
+    bossKeyLang: config.get("bossKeyLang"),
+    deviceId: config.get("deviceId"),
+    syncDir: config.get("syncDir")
   };
 }
 function setConfig(key, value) {
   config.set(key, value);
 }
+function getDeviceId() {
+  let id = config.get("deviceId");
+  if (!id) {
+    id = randomUUID();
+    config.set("deviceId", id);
+  }
+  return id;
+}
+function getSyncDir() {
+  return config.get("syncDir") ?? null;
+}
+function setSyncDir(dir) {
+  config.set("syncDir", dir);
+}
+function clearSyncDir() {
+  config.delete("syncDir");
+}
 
 // src/locales/index.ts
 var dictionaries = {
@@ -678,25 +868,119 @@ function t(key, ...args) {
       template = template.replace(`{${index}}`, String(arg));
     });
   }
-  return template;
-}
+  return template;
+}
+
+// src/services/BookService.ts
+var BookService = class {
+  bookModel = new BookModel();
+  chapterModel = new ChapterModel();
+  recentModel = new RecentModel();
+  progressModel = new ProgressModel();
+  /**
+   * 导入书籍文件
+   */
+  async importBook(filePath) {
+    const absPath = resolve(filePath);
+    if (!existsSync3(absPath)) {
+      throw new Error(`\u6587\u4EF6\u4E0D\u5B58\u5728: ${absPath}`);
+    }
+    const format = this.detectFormat(absPath);
+    if (!format) {
+      throw new Error(t("cli.import.unsupported"));
+    }
+    const fileHash = await computeFileHash(absPath);
+    const existing = this.bookModel.findByHash(fileHash);
+    if (existing) {
+      logger.debug(`\u6587\u4EF6\u5DF2\u5B58\u5728: ${existing.title} (${existing.id})`);
+      return existing;
+    }
+    const parsed = await parseFile(absPath, format);
+    const stats = statSync(absPath);
+    const book = {
+      id: nanoid(),
+      title: parsed.title,
+      author: parsed.author || null,
+      file_path: absPath,
+      format,
+      file_hash: fileHash,
+      file_size: stats.size,
+      created_at: Date.now()
+    };
+    this.bookModel.insert(book);
+    if (parsed.chapters.length > 0) {
+      this.chapterModel.insertMany(
+        parsed.chapters.map((ch, idx) => ({
+          book_id: book.id,
+          chapter_no: idx,
+          title: ch.title,
+          byte_offset: ch.byteOffset
+        }))
+      );
+    }
+    logger.debug(`\u5BFC\u5165\u6210\u529F: ${book.title}`);
+    return book;
+  }
+  /**
+   * 查找书籍（ID 或模糊匹配书名）
+   */
+  findBook(target) {
+    const byId = this.bookModel.findById(target);
+    if (byId) return byId;
+    const results = this.bookModel.searchByTitle(target);
+    return results[0];
+  }
+  /**
+   * 搜索书籍
+   */
+  searchBooks(keyword) {
+    return this.bookModel.searchByTitle(keyword);
+  }
+  /**
+   * 获取所有书籍
+   */
+  getAllBooks() {
+    return this.bookModel.findAll();
+  }
+  /**
+   * 删除书籍及相关数据
+   */
+  deleteBook(id) {
+    this.chapterModel.deleteByBookId(id);
+    this.progressModel.delete(id);
+    this.recentModel.delete(id);
+    new BookmarkModel().deleteByBookId(id);
+    new ReadingSessionModel().deleteByBookId(id);
+    this.bookModel.delete(id);
+  }
+  /**
+   * 检测文件格式
+   */
+  detectFormat(filePath) {
+    const ext = filePath.toLowerCase().split(".").pop();
+    if (ext === "txt") return "txt";
+    if (ext === "epub") return "epub";
+    if (ext === "md") return "md";
+    return null;
+  }
+};
 
 // src/cli/commands/import.ts
 import { statSync as statSync2, readdirSync } from "fs";
-import { resolve as resolve2, join as join2, extname } from "path";
+import { resolve as resolve2, join as join3, extname } from "path";
 import * as readline from "readline/promises";
 function scanDirectory(dir) {
   let results = [];
   try {
     const list = readdirSync(dir);
     for (const file of list) {
-      const fullPath = join2(dir, file);
+      const fullPath = join3(dir, file);
       const stat = statSync2(fullPath);
       if (stat.isDirectory()) {
         results = results.concat(scanDirectory(fullPath));
       } else {
         const ext = extname(fullPath).toLowerCase();
-        if (ext === ".txt" || ext === ".epub") {
+        if (ext === ".txt" || ext === ".epub" || ext === ".md") {
           results.push(fullPath);
         }
       }
@@ -810,24 +1094,332 @@ import { Box as Box7, Text as Text7 } from "ink";
 // src/ui/pages/ResumePage.tsx
 import { useEffect, useState } from "react";
 import { Box, Text, useApp } from "ink";
+
+// src/services/SyncFolderService.ts
+import { existsSync as existsSync4, mkdirSync as mkdirSync2, readdirSync as readdirSync2, readFileSync as readFileSync3, writeFileSync, renameSync, copyFileSync as copyFileSync2 } from "fs";
+import { join as join4 } from "path";
+import { hostname } from "os";
+var SYNC_ROOT = "readshell-sync";
+var SCHEMA_VERSION = 1;
+function isValidDeviceFile(data) {
+  if (typeof data !== "object" || data === null) return false;
+  const d = data;
+  return typeof d["deviceId"] === "string" && Array.isArray(d["books"]) && Array.isArray(d["progress"]) && Array.isArray(d["bookmarks"]) && Array.isArray(d["sessions"]);
+}
+function toMillis(iso) {
+  if (typeof iso !== "string") return null;
+  const ms = new Date(iso).getTime();
+  return Number.isNaN(ms) ? null : ms;
+}
+function mergeRemoteDevice(remote, deps) {
+  let count = 0;
+  for (const p of remote.progress) {
+    if (typeof p?.bookId !== "string") continue;
+    const book = deps.findBookByHash(p.bookId);
+    if (!book) continue;
+    const remoteTs = toMillis(p.clientUpdatedAt);
+    if (remoteTs === null) continue;
+    const local = deps.findProgress(book.id);
+    if (local && remoteTs <= local.updated_at) continue;
+    deps.upsertProgress({
+      book_id: book.id,
+      chapter_no: local?.chapter_no ?? 0,
+      byte_offset: p.byteOffset,
+      percent: p.percentage,
+      updated_at: remoteTs,
+      // opened_at 只在远端更新时才前移
+      opened_at: Math.max(local?.opened_at ?? 0, remoteTs)
+    });
+    count++;
+  }
+  for (const b of remote.bookmarks) {
+    if (typeof b?.bookId !== "string" || typeof b?.byteOffset !== "number") continue;
+    const book = deps.findBookByHash(b.bookId);
+    if (!book) continue;
+    const remoteTs = toMillis(b.updatedAt) ?? toMillis(b.createdAt);
+    if (remoteTs === null) continue;
+    const local = deps.findBookmarkByOffset(book.id, b.byteOffset);
+    if (local && remoteTs <= local.updated_at) continue;
+    const createdAt = toMillis(b.createdAt) ?? remoteTs;
+    deps.saveBookmark({
+      book_id: book.id,
+      title: b.label ?? "",
+      byte_offset: b.byteOffset,
+      created_at: createdAt,
+      updated_at: remoteTs,
+      deleted: b.deleted ? 1 : 0
+    });
+    count++;
+  }
+  for (const s of remote.sessions) {
+    if (typeof s?.id !== "string" || typeof s?.bookId !== "string") continue;
+    const book = deps.findBookByHash(s.bookId);
+    if (!book) continue;
+    const startedAt = toMillis(s.startedAt);
+    const endedAt = toMillis(s.endedAt);
+    if (startedAt === null || endedAt === null) continue;
+    if (deps.insertSession({
+      id: s.id,
+      book_id: book.id,
+      started_at: startedAt,
+      ended_at: endedAt,
+      bytes_read: typeof s.bytesRead === "number" ? s.bytesRead : 0
+    })) {
+      count++;
+    }
+  }
+  return count;
+}
+var SyncFolderService = class {
+  constructor(syncDir) {
+    this.syncDir = syncDir;
+  }
+  deviceId = getDeviceId();
+  get rootDir() {
+    return join4(this.syncDir, SYNC_ROOT);
+  }
+  get devicesDir() {
+    return join4(this.rootDir, "devices");
+  }
+  get booksDir() {
+    return join4(this.rootDir, "books");
+  }
+  get ownFile() {
+    return join4(this.devicesDir, `${this.deviceId}.json`);
+  }
+  /**
+   * 收集本机快照
+   */
+  collectLocal() {
+    const bookModel = new BookModel();
+    const progressModel = new ProgressModel();
+    const bookmarkModel = new BookmarkModel();
+    const sessionModel = new ReadingSessionModel();
+    const books = [];
+    const progress = [];
+    const bookmarks = [];
+    for (const book of bookModel.findAll()) {
+      books.push({
+        hash: book.file_hash,
+        title: book.title,
+        author: book.author,
+        format: book.format,
+        size: book.file_size
+      });
+      const p = progressModel.findByBookId(book.id);
+      if (p) {
+        progress.push({
+          bookId: book.file_hash,
+          byteOffset: p.byte_offset,
+          percentage: p.percent,
+          clientUpdatedAt: new Date(p.updated_at).toISOString()
+        });
+      }
+      for (const b of bookmarkModel.findAllByBookId(book.id)) {
+        bookmarks.push({
+          id: `${book.file_hash}:${b.byte_offset}`,
+          bookId: book.file_hash,
+          byteOffset: b.byte_offset,
+          label: b.title,
+          deleted: b.deleted === 1,
+          updatedAt: new Date(b.updated_at || b.created_at).toISOString(),
+          createdAt: new Date(b.created_at).toISOString()
+        });
+      }
+    }
+    const sessions = [];
+    for (const s of sessionModel.findAll()) {
+      const book = bookModel.findById(s.book_id);
+      if (!book) continue;
+      sessions.push({
+        id: s.id,
+        bookId: book.file_hash,
+        startedAt: new Date(s.started_at).toISOString(),
+        endedAt: new Date(s.ended_at).toISOString(),
+        bytesRead: s.bytes_read
+      });
+    }
+    return {
+      schemaVersion: SCHEMA_VERSION,
+      deviceId: this.deviceId,
+      deviceName: hostname(),
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      books,
+      progress,
+      bookmarks,
+      sessions
+    };
+  }
+  /**
+   * 原子写入本机设备文件（tmp + rename，避免同步盘读到半截文件）
+   */
+  writeOwnFile() {
+    mkdirSync2(this.devicesDir, { recursive: true });
+    const data = this.collectLocal();
+    const tmp = `${this.ownFile}.tmp`;
+    writeFileSync(tmp, JSON.stringify(data, null, 2), "utf-8");
+    renameSync(tmp, this.ownFile);
+  }
+  /**
+   * 读取所有其他设备文件；损坏/半截 JSON 跳过并记 debug 日志
+   */
+  readRemoteFiles() {
+    const files = [];
+    let skipped = 0;
+    let names = [];
+    try {
+      names = readdirSync2(this.devicesDir);
+    } catch {
+      return { files, skipped };
+    }
+    for (const name of names) {
+      if (!name.endsWith(".json") || name === `${this.deviceId}.json`) continue;
+      try {
+        const parsed = JSON.parse(readFileSync3(join4(this.devicesDir, name), "utf-8"));
+        if (!isValidDeviceFile(parsed)) {
+          skipped++;
+          logger.debug(`\u540C\u6B65\uFF1A\u8DF3\u8FC7\u683C\u5F0F\u975E\u6CD5\u7684\u8BBE\u5907\u6587\u4EF6 ${name}`);
+          continue;
+        }
+        files.push(parsed);
+      } catch (err) {
+        skipped++;
+        logger.debug(`\u540C\u6B65\uFF1A\u8DF3\u8FC7\u635F\u574F\u7684\u8BBE\u5907\u6587\u4EF6 ${name}: ${err instanceof Error ? err.message : String(err)}`);
+      }
+    }
+    return { files, skipped };
+  }
+  mergeDeps() {
+    const progressModel = new ProgressModel();
+    const bookmarkModel = new BookmarkModel();
+    const bookModel = new BookModel();
+    const sessionModel = new ReadingSessionModel();
+    return {
+      findBookByHash: (hash) => bookModel.findByHash(hash),
+      findProgress: (bookId) => progressModel.findByBookId(bookId),
+      upsertProgress: (p) => progressModel.upsert(p),
+      findBookmarkByOffset: (bookId, offset) => bookmarkModel.findByOffsetAny(bookId, offset),
+      saveBookmark: (b) => bookmarkModel.saveByOffset(b),
+      insertSession: (s) => sessionModel.insertIfAbsent(s)
+    };
+  }
+  /**
+   * 把本地书源文件拷进 books/（--with-books），已存在则跳过
+   */
+  pushBookFiles() {
+    const bookModel = new BookModel();
+    mkdirSync2(this.booksDir, { recursive: true });
+    for (const book of bookModel.findAll()) {
+      const target = join4(this.booksDir, `${book.file_hash}.${book.format}`);
+      if (existsSync4(target)) continue;
+      try {
+        if (existsSync4(book.file_path)) {
+          copyFileSync2(book.file_path, target);
+        }
+      } catch (err) {
+        logger.debug(`\u540C\u6B65\uFF1A\u62F7\u8D1D\u4E66\u6E90\u6587\u4EF6\u5931\u8D25 ${book.title}: ${err instanceof Error ? err.message : String(err)}`);
+      }
+    }
+  }
+  /**
+   * 远端有记录但本地没有的书，从 books/ 目录自动导入（--with-books）
+   * 返回导入数量
+   */
+  async pullBookFiles(remoteFiles) {
+    const bookModel = new BookModel();
+    const bookService = new BookService();
+    let imported = 0;
+    const wanted = /* @__PURE__ */ new Map();
+    for (const remote of remoteFiles) {
+      for (const b of remote.books) {
+        if (typeof b?.hash === "string" && !wanted.has(b.hash)) {
+          wanted.set(b.hash, b);
+        }
+      }
+    }
+    for (const [hash, entry] of wanted) {
+      if (bookModel.findByHash(hash)) continue;
+      const ext = entry.format || "txt";
+      const candidate = join4(this.booksDir, `${hash}.${ext}`);
+      if (!existsSync4(candidate)) continue;
+      try {
+        const actual = await computeFileHash(candidate);
+        if (actual !== hash) {
+          logger.debug(`\u540C\u6B65\uFF1Abooks/${hash}.${ext} hash \u4E0D\u5339\u914D\uFF0C\u8DF3\u8FC7`);
+          continue;
+        }
+        const book = await bookService.importBook(candidate);
+        bookModel.updateMeta(book.id, entry.title, entry.author);
+        imported++;
+      } catch (err) {
+        logger.debug(`\u540C\u6B65\uFF1A\u5BFC\u5165 ${candidate} \u5931\u8D25: ${err instanceof Error ? err.message : String(err)}`);
+      }
+    }
+    return imported;
+  }
+  /**
+   * 只拉取：读取其他设备文件并合并（阅读器打开时调用）
+   */
+  async pull(options = {}) {
+    const { files, skipped } = this.readRemoteFiles();
+    let pulled = 0;
+    if (options.withBooks) {
+      pulled += await this.pullBookFiles(files);
+    }
+    const deps = this.mergeDeps();
+    for (const remote of files) {
+      pulled += mergeRemoteDevice(remote, deps);
+    }
+    return { pulled, devices: files.length, skipped };
+  }
+  /**
+   * 完整同步：先写本机快照（push），再合并其他设备（pull）
+   */
+  async sync(options = {}) {
+    mkdirSync2(this.devicesDir, { recursive: true });
+    this.writeOwnFile();
+    if (options.withBooks) {
+      this.pushBookFiles();
+    }
+    return this.pull(options);
+  }
+};
+function createFolderSyncService() {
+  const dir = getSyncDir();
+  if (!dir) return null;
+  return new SyncFolderService(dir);
+}
+async function syncOnOpen(timeoutMs = 2e3) {
+  const service = createFolderSyncService();
+  if (!service) return;
+  await Promise.race([
+    service.pull().catch(() => {
+    }),
+    new Promise((resolve5) => setTimeout(resolve5, timeoutMs))
+  ]);
+}
+
+// src/ui/pages/ResumePage.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
 function ResumePage({ onNavigate }) {
   const { exit } = useApp();
   const [checking, setChecking] = useState(true);
   useEffect(() => {
-    const progressService = new ProgressService();
-    const lastProgress = progressService.getLastOpenedBook();
-    if (!lastProgress) {
-      setChecking(false);
-      return;
-    }
-    const bookModel = new BookModel();
-    const book = bookModel.findById(lastProgress.book_id);
-    if (!book) {
-      setChecking(false);
-      return;
-    }
-    onNavigate("reader", book.id, lastProgress.byte_offset);
+    void syncOnOpen().finally(() => {
+      const progressService = new ProgressService();
+      const lastProgress = progressService.getLastOpenedBook();
+      if (!lastProgress) {
+        setChecking(false);
+        return;
+      }
+      const bookModel = new BookModel();
+      const book = bookModel.findById(lastProgress.book_id);
+      if (!book) {
+        setChecking(false);
+        return;
+      }
+      onNavigate("reader", book.id, lastProgress.byte_offset);
+    });
   }, [onNavigate]);
   if (checking) {
     return /* @__PURE__ */ jsx(Box, { padding: 1, children: /* @__PURE__ */ jsx(Text, { color: "cyan", children: "\u{1F4D6} \u68C0\u67E5\u9605\u8BFB\u8BB0\u5F55..." }) });
@@ -887,9 +1479,11 @@ function LibraryPage({ onNavigate }) {
     if (key.return) {
       const selected = books[selectedIndex];
       if (selected) {
-        const progressService = new ProgressService();
-        const progress = progressService.getProgress(selected.id);
-        onNavigate("reader", selected.id, progress?.byte_offset ?? 0);
+        void syncOnOpen().finally(() => {
+          const progressService = new ProgressService();
+          const progress = progressService.getProgress(selected.id);
+          onNavigate("reader", selected.id, progress?.byte_offset ?? 0);
+        });
       }
     }
   }, { isActive: isRawModeSupported });
@@ -934,6 +1528,7 @@ function LibraryPage({ onNavigate }) {
 
 // src/ui/pages/ReaderPage.tsx
 import { useState as useState5, useEffect as useEffect4, useRef } from "react";
+import { randomUUID as randomUUID2 } from "crypto";
 import { Box as Box6, Text as Text6, useApp as useApp3, useStdout } from "ink";
 
 // src/ui/components/TextRenderer.tsx
@@ -1148,6 +1743,12 @@ function useReader(pages, initialByteOffset) {
       currentPage: targetPage
     }));
   }, [pages]);
+  const goToFirst = useCallback(() => {
+    setState((prev) => ({ ...prev, currentPage: 0 }));
+  }, []);
+  const goToLast = useCallback(() => {
+    setState((prev) => ({ ...prev, currentPage: Math.max(0, prev.totalPages - 1) }));
+  }, []);
   const getCurrentPage = useCallback(() => {
     return pages[state.currentPage];
   }, [state.currentPage, pages]);
@@ -1166,6 +1767,8 @@ function useReader(pages, initialByteOffset) {
     prevPage,
     goToPage,
     goToOffset,
+    goToFirst,
+    goToLast,
     getCurrentPage,
     getCurrentOffset,
     getPercent,
@@ -1183,9 +1786,15 @@ function useKeyboard(handlers, isActive = true) {
     if (input === " " || input === "j" || key.downArrow || input === "f") {
       handlers.onNext?.();
     }
-    if (input === "k" || key.upArrow || input === "b") {
+    if (input === "k" || key.upArrow) {
       handlers.onPrev?.();
     }
+    if (input === "g") {
+      handlers.onGoToStart?.();
+    }
+    if (input === "G") {
+      handlers.onGoToEnd?.();
+    }
     if (input === "q") {
       handlers.onQuit?.();
     }
@@ -1339,56 +1948,6 @@ var RecentService = class {
   }
 };
 
-// src/db/models/Bookmark.ts
-var BookmarkModel = class {
-  /**
-   * 插入书签
-   */
-  insert(bookmark) {
-    const db2 = getDb();
-    db2.prepare(`
-      INSERT INTO bookmarks (book_id, title, byte_offset, created_at)
-      VALUES (?, ?, ?, ?)
-    `).run(bookmark.book_id, bookmark.title, bookmark.byte_offset, bookmark.created_at);
-  }
-  /**
-   * 获取指定书籍的所有书签
-   */
-  findByBookId(bookId) {
-    const db2 = getDb();
-    return db2.prepare("SELECT * FROM bookmarks WHERE book_id = ? ORDER BY created_at DESC").all(bookId);
-  }
-  /**
-   * 获取指定书签
-   */
-  findById(id) {
-    const db2 = getDb();
-    return db2.prepare("SELECT * FROM bookmarks WHERE id = ?").get(id);
-  }
-  /**
-   * 获取书籍书签总数
-   */
-  getCount(bookId) {
-    const db2 = getDb();
-    const result = db2.prepare("SELECT COUNT(*) as count FROM bookmarks WHERE book_id = ?").get(bookId);
-    return result.count;
-  }
-  /**
-   * 删除书签
-   */
-  delete(id) {
-    const db2 = getDb();
-    db2.prepare("DELETE FROM bookmarks WHERE id = ?").run(id);
-  }
-  /**
-   * 移除整本书的书签 (配合彻底清理书籍使用)
-   */
-  deleteByBookId(bookId) {
-    const db2 = getDb();
-    db2.prepare("DELETE FROM bookmarks WHERE book_id = ?").run(bookId);
-  }
-};
-
 // src/services/BookmarkService.ts
 var BookmarkService = class {
   bookmarkModel;
@@ -1400,11 +1959,14 @@ var BookmarkService = class {
    * @param title 该书签展现给用户的文案（一句话大纲）
    */
   addBookmark(bookId, title, byteOffset) {
+    const now = Date.now();
     this.bookmarkModel.insert({
       book_id: bookId,
       title,
       byte_offset: byteOffset,
-      created_at: Date.now()
+      created_at: now,
+      updated_at: now,
+      deleted: 0
     });
   }
   /**
@@ -1429,23 +1991,75 @@ function triggerBossKey() {
 function isBossKeyActive() {
   return isBossKeyEnabled;
 }
-function performBossKeyAction() {
-  process.stdout.write("\x1B[3J\x1B[2J\x1B[1;1H");
-  const fakeLog = `
-file:///Users/yindawei/project/node_modules/vite/dist/node/chunks/dep-BbV93i69.js:43916
+var fakeLogs = {
+  nodejs: `
+file:///home/user/project/node_modules/vite/dist/node/chunks/dep-BbV93i69.js:43916
       throw new Error(\`[vite] Failed to resolve module import "./App.vue". Check if the file exists.\`);
             ^
 
 Error: [vite] Failed to resolve module import "./App.vue". Check if the file exists.
-    at Object.run (file:///Users/yindawei/project/node_modules/vite/dist/node/chunks/dep-BbV93i69.js:43916:13)
-    at async file:///Users/yindawei/project/node_modules/vite/dist/node/cli.js:722:7
-    at async startVite (file:///Users/yindawei/project/node_modules/vite/dist/node/cli.js:700:5)
-    at async Object.handler (file:///Users/yindawei/project/node_modules/vite/dist/node/cli.js:650:1)
+    at Object.run (file:///home/user/project/node_modules/vite/dist/node/chunks/dep-BbV93i69.js:43916:13)
+    at async file:///home/user/project/node_modules/vite/dist/node/cli.js:722:7
+    at async startVite (file:///home/user/project/node_modules/vite/dist/node/cli.js:700:5)
+    at async Object.handler (file:///home/user/project/node_modules/vite/dist/node/cli.js:650:1)
 
 Node.js v20.11.0
-`;
+`,
+  python: `
+Traceback (most recent call last):
+  File "/home/user/project/main.py", line 42, in <module>
+    result = process_data(df)
+  File "/home/user/project/utils/pipeline.py", line 118, in process_data
+    return df.groupby("user_id").apply(transform)
+  File "/home/user/project/utils/pipeline.py", line 97, in transform
+    raise ValueError(f"Missing required column: '{col}'")
+ValueError: Missing required column: 'timestamp'
+
+During handling of the above exception, another exception occurred:
+
+Traceback (most recent call last):
+  File "/home/user/project/main.py", line 47, in <module>
+    raise RuntimeError("Pipeline failed. Check logs for details.")
+RuntimeError: Pipeline failed. Check logs for details.
+`,
+  java: `
+Exception in thread "main" java.lang.NullPointerException: Cannot invoke "String.length()" because "str" is null
+	at com.example.app.StringUtils.process(StringUtils.java:34)
+	at com.example.app.DataProcessor.run(DataProcessor.java:112)
+	at com.example.app.Main.main(Main.java:21)
+
+BUILD FAILURE
+[ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.11.0:compile
+[ERROR] -> [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoFailureException
+`,
+  c: `
+make[2]: *** [CMakeFiles/app.dir/src/main.c.o] Error 1
+make[1]: *** [CMakeFiles/app.dir/all] Error 2
+make: *** [all] Error 2
+
+/home/user/project/src/main.c:87:5: error: use of undeclared identifier 'ctx'
+    ctx->buffer = malloc(sizeof(Buffer));
+    ^
+/home/user/project/src/main.c:102:12: warning: implicit declaration of function 'init_buffer' [-Wimplicit-function-declaration]
+    result = init_buffer(ctx, DEFAULT_SIZE);
+             ^
+2 errors, 1 warning generated.
+`,
+  go: `
+# command-line-arguments
+./main.go:58:13: undefined: parseConfig
+./main.go:74:9: cannot use result (variable of type *Response) as type Handler
+./main.go:91:2: declared and not used: errCh
+
+go: github.com/example/app@v1.3.2: reading github.com/example/app/go.mod at revision v1.3.2: unknown revision v1.3.2
+exit status 1
+`
+};
+function performBossKeyAction() {
+  process.stdout.write("\x1B[3J\x1B[2J\x1B[1;1H");
+  const lang = getConfig().bossKeyLang ?? "nodejs";
+  const fakeLog = fakeLogs[lang];
   process.stdout.write(fakeLog + "\n");
-  process.exit(0);
 }
 
 // src/utils/time.ts
@@ -1462,6 +2076,20 @@ function formatReadingTime(minutes) {
   return mins > 0 ? `${hours} \u5C0F\u65F6 ${mins} \u5206\u949F` : `${hours} \u5C0F\u65F6`;
 }
 
+// src/utils/pendingSync.ts
+var pendingSync = null;
+function registerPendingSync(promise) {
+  pendingSync = promise;
+}
+async function drainPendingSync(timeoutMs = 2e3) {
+  if (!pendingSync) return;
+  await Promise.race([
+    pendingSync.catch(() => {
+    }),
+    new Promise((resolve5) => setTimeout(resolve5, timeoutMs))
+  ]);
+}
+
 // src/ui/pages/ReaderPage.tsx
 import { Fragment, jsx as jsx6, jsxs as jsxs5 } from "react/jsx-runtime";
 function ReaderContent({
@@ -1471,12 +2099,14 @@ function ReaderContent({
   initialByteOffset,
   termHeight,
   contentHeight,
-  lineSpacing
+  lineSpacing,
+  totalChars
 }) {
   const { exit } = useApp3();
   const [chapterTitle, setChapterTitle] = useState5();
   const [currentChapter, setCurrentChapter] = useState5();
   const [showChapterNav, setShowChapterNav] = useState5(false);
+  const [showHelp, setShowHelp] = useState5(false);
   const [allChapters, setAllChapters] = useState5([]);
   const [allBookmarks, setAllBookmarks] = useState5([]);
   const [toastMessage, setToastMessage] = useState5(null);
@@ -1521,6 +2151,34 @@ function ReaderContent({
     setToastMessage(t("tui.reader.bookmark_add", markTitle));
     setTimeout(() => setToastMessage(null), 2e3);
   };
+  const readerRef = useRef(reader);
+  readerRef.current = reader;
+  useEffect4(() => {
+    const startedAt = Date.now();
+    const startOffset = readerRef.current.getCurrentOffset();
+    return () => {
+      const endedAt = Date.now();
+      const endOffset = readerRef.current.getCurrentOffset();
+      if (endedAt - startedAt >= 5e3) {
+        new ReadingSessionModel().insert({
+          id: randomUUID2(),
+          book_id: bookId,
+          started_at: startedAt,
+          ended_at: endedAt,
+          bytes_read: Math.max(0, endOffset - startOffset)
+        });
+      }
+      registerPendingSync(
+        (async () => {
+          const syncService = createFolderSyncService();
+          if (syncService) {
+            await syncService.sync();
+          }
+        })().catch(() => {
+        })
+      );
+    };
+  }, [bookId, book]);
   useEffect4(() => {
     return () => {
       saveReadingProgress();
@@ -1537,19 +2195,27 @@ function ReaderContent({
         triggerBossKey();
         exit();
       },
-      onBookmarkAdd: handleAddBookmark
+      onBookmarkAdd: handleAddBookmark,
+      onGoToStart: () => reader.goToFirst(),
+      onGoToEnd: () => reader.goToLast(),
+      onHelp: () => setShowHelp((v) => !v)
     },
-    !showChapterNav
-    // 如果浮层显示，则停止普通的阅读快捷键
+    !showChapterNav && !showHelp
+    // 浮层显示时停止普通的阅读快捷键
   );
   const currentPage = reader.getCurrentPage();
   const currentLines = currentPage?.lines ?? [];
   const calculatedContentHeight = Math.max(1, termHeight - 2);
-  const totalChars = (book.file_size ?? 0) / 3;
   const remainingChars = Math.max(0, totalChars * (1 - reader.getPercent()));
   const remainingMinutes = estimateReadingTime(remainingChars, true);
   const remainingTimeStr = formatReadingTime(remainingMinutes);
-  return /* @__PURE__ */ jsx6(Box6, { flexDirection: "column", height: termHeight, children: !showChapterNav ? /* @__PURE__ */ jsxs5(Fragment, { children: [
+  return /* @__PURE__ */ jsx6(Box6, { flexDirection: "column", height: termHeight, children: showHelp ? /* @__PURE__ */ jsxs5(Box6, { flexDirection: "column", padding: 1, children: [
+    /* @__PURE__ */ jsx6(Text6, { bold: true, color: "cyan", children: t("tui.help.title") }),
+    /* @__PURE__ */ jsx6(Text6, { children: t("tui.help.next") }),
+    /* @__PURE__ */ jsx6(Text6, { children: t("tui.help.prev") }),
+    /* @__PURE__ */ jsx6(Text6, { children: t("tui.help.nav") }),
+    /* @__PURE__ */ jsx6(Text6, { children: t("tui.help.boss") })
+  ] }) : !showChapterNav ? /* @__PURE__ */ jsxs5(Fragment, { children: [
     /* @__PURE__ */ jsx6(Box6, { flexDirection: "column", flexGrow: 1, paddingX: 1, children: /* @__PURE__ */ jsx6(TextRenderer, { lines: currentLines, height: calculatedContentHeight, lineSpacing }) }),
     /* @__PURE__ */ jsx6(
       StatusBar,
@@ -1583,6 +2249,7 @@ function ReaderPage({ bookId, initialByteOffset, onNavigate: _onNavigate }) {
   const { stdout } = useStdout();
   const [book, setBook] = useState5(null);
   const [pages, setPages] = useState5(null);
+  const [totalChars, setTotalChars] = useState5(0);
   const [error, setError] = useState5(null);
   const termWidth = stdout?.columns ?? 80;
   const termHeight = stdout?.rows ?? 24;
@@ -1604,6 +2271,7 @@ function ReaderPage({ bookId, initialByteOffset, onNavigate: _onNavigate }) {
         const stepSize = appConfig.readingMode === "scroll" ? Math.max(1, Math.floor(contentHeight / 2)) : contentHeight;
         const paginatedPages = paginate(parsed.content, termWidth - 2, contentHeight, stepSize);
         setPages(paginatedPages);
+        setTotalChars(parsed.content.length);
         logger.debug(`\u52A0\u8F7D\u5B8C\u6210: ${bookRecord.title}, ${paginatedPages.length} \u9875, \u6A21\u5F0F: ${appConfig.readingMode}`);
       }).catch((err) => {
         setError(`\u5185\u5BB9\u89E3\u6790\u5931\u8D25: ${err instanceof Error ? err.message : String(err)}`);
@@ -1639,7 +2307,8 @@ function ReaderPage({ bookId, initialByteOffset, onNavigate: _onNavigate }) {
       initialByteOffset,
       termHeight,
       contentHeight,
-      lineSpacing
+      lineSpacing,
+      totalChars
     }
   );
 }
@@ -1680,10 +2349,11 @@ function renderApp(options = {}) {
       initialByteOffset
     })
   );
-  waitUntilExit().then(() => {
+  waitUntilExit().then(async () => {
     if (isBossKeyActive()) {
       performBossKeyAction();
     }
+    await drainPendingSync(2e3);
     process.exit(0);
   }).catch(() => {
     process.exit(1);
@@ -1696,6 +2366,7 @@ var resumeCommand = {
   describe: t("cli.resume.desc"),
   handler: async () => {
     try {
+      await syncOnOpen();
       const progressService = new ProgressService();
       const lastProgress = progressService.getLastOpenedBook();
       if (!lastProgress) {
@@ -1740,6 +2411,7 @@ var openCommand = {
         console.log(`${t("cli.open.not_found")} ${argv.target}`);
         process.exit(1);
       }
+      await syncOnOpen();
       const progressService = new ProgressService();
       const progress = progressService.getProgress(book.id);
       const byteOffset = progress?.byte_offset ?? 0;
@@ -1852,7 +2524,7 @@ var updateCommand = {
   handler: async () => {
     try {
       console.log(t("cli.update.checking"));
-      const localVersion = true ? "0.3.1" : "0.2.2";
+      const localVersion = true ? "1.0.0" : "0.2.2";
       const npmOutput = execSync("npm view readshell version", { encoding: "utf-8" });
       const latestVersion = npmOutput.trim();
       if (!latestVersion) {
@@ -1874,14 +2546,327 @@ var updateCommand = {
   }
 };
 
+// src/cli/commands/config.ts
+var BOSS_KEY_LANGS = ["nodejs", "python", "java", "c", "go"];
+var configCommand = {
+  command: "config <key> <value>",
+  describe: t("cli.config.desc"),
+  builder: (yargs2) => {
+    return yargs2.positional("key", {
+      describe: "\u914D\u7F6E\u9879\u540D\u79F0 (language|line-spacing|reading-mode|boss-key-lang)",
+      type: "string",
+      choices: ["language", "line-spacing", "reading-mode", "boss-key-lang"],
+      demandOption: true
+    }).positional("value", {
+      describe: "\u914D\u7F6E\u9879\u5185\u5BB9",
+      type: "string",
+      demandOption: true
+    });
+  },
+  handler: (argv) => {
+    const { key, value } = argv;
+    try {
+      if (key === "language") {
+        if (value === "zh" || value === "en") {
+          setConfig("language", value);
+          console.log(t("cli.lang.success", value));
+        } else {
+          console.log(t("cli.lang.unsupported", value));
+        }
+      } else if (key === "line-spacing") {
+        const spacing = parseInt(value, 10);
+        if (!isNaN(spacing) && spacing >= 0 && spacing <= 2) {
+          setConfig("lineSpacing", spacing);
+          console.log(t("cli.config.line_spacing.success", spacing));
+        } else {
+          console.log(t("cli.config.line_spacing.desc"));
+        }
+      } else if (key === "reading-mode") {
+        if (value === "page" || value === "scroll") {
+          setConfig("readingMode", value);
+          console.log(`\u2713 Reading mode set to: ${value}`);
+        } else {
+          console.log(t("cli.config.reading_mode.desc"));
+        }
+      } else if (key === "boss-key-lang") {
+        if (BOSS_KEY_LANGS.includes(value)) {
+          setConfig("bossKeyLang", value);
+          console.log(`\u2713 Boss key language set to: ${value}`);
+        } else {
+          console.log(`\u2717 Unsupported language. Choose from: ${BOSS_KEY_LANGS.join(", ")}`);
+        }
+      }
+    } catch (err) {
+      console.error("\u2717 Failed to update config:", err);
+      process.exit(1);
+    }
+  }
+};
+
+// src/cli/commands/sync.ts
+import { existsSync as existsSync5, statSync as statSync3 } from "fs";
+import { resolve as resolve3 } from "path";
+var syncCommand = {
+  command: "sync",
+  describe: t("cli.sync.desc"),
+  builder: (yargs2) => yargs2.option("dir", {
+    describe: t("cli.sync.dir"),
+    type: "string"
+  }).option("with-books", {
+    describe: t("cli.sync.with_books"),
+    type: "boolean",
+    default: false
+  }).option("off", {
+    describe: t("cli.sync.off"),
+    type: "boolean",
+    default: false
+  }),
+  handler: async (argv) => {
+    const args = argv;
+    if (args.off) {
+      clearSyncDir();
+      console.log(t("cli.sync.disabled"));
+      return;
+    }
+    if (args.dir) {
+      const dir = resolve3(args.dir);
+      if (!existsSync5(dir) || !statSync3(dir).isDirectory()) {
+        console.log(t("cli.sync.dir_invalid", dir));
+        process.exit(1);
+      }
+      setSyncDir(dir);
+      console.log(t("cli.sync.dir_set", dir));
+    }
+    const syncDir = getSyncDir();
+    if (!syncDir) {
+      console.log(t("cli.sync.no_dir"));
+      process.exit(1);
+    }
+    console.log(t("cli.sync.running"));
+    try {
+      const result = await new SyncFolderService(syncDir).sync({ withBooks: args["with-books"] });
+      console.log(t("cli.sync.success", String(result.pulled), String(result.devices)));
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.log(t("cli.sync.failed", msg));
+      process.exit(1);
+    }
+  }
+};
+
+// src/cli/commands/bookmarks.ts
+import { writeFileSync as writeFileSync2 } from "fs";
+import { resolve as resolve4 } from "path";
+function bookmarkPercent(book, b) {
+  if (!book.file_size || book.file_size <= 0) return null;
+  return Math.min(1, Math.max(0, b.byte_offset / book.file_size));
+}
+function collectGroups() {
+  const bookModel = new BookModel();
+  const bookmarkModel = new BookmarkModel();
+  const groups = [];
+  for (const book of bookModel.findAll()) {
+    const bookmarks = bookmarkModel.findByBookId(book.id);
+    if (bookmarks.length === 0) continue;
+    groups.push({
+      title: book.title,
+      author: book.author,
+      format: book.format,
+      bookmarks: bookmarks.map((b) => ({
+        label: b.title,
+        byteOffset: b.byte_offset,
+        percent: bookmarkPercent(book, b),
+        createdAt: new Date(b.created_at).toISOString()
+      }))
+    });
+  }
+  return groups;
+}
+function toMarkdown(groups) {
+  const lines = ["# ReadShell Bookmarks", ""];
+  for (const g of groups) {
+    lines.push(`## ${g.title}${g.author ? ` \u2014 ${g.author}` : ""}`, "");
+    for (const b of g.bookmarks) {
+      const pct = b.percent !== null ? ` (${(b.percent * 100).toFixed(1)}%)` : "";
+      lines.push(`- ${b.label} \u2014 offset ${b.byteOffset}${pct} \u2014 ${b.createdAt}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+var bookmarksCommand = {
+  command: "bookmarks",
+  describe: t("cli.bookmarks.desc"),
+  builder: (yargs2) => yargs2.command({
+    command: "export",
+    describe: t("cli.bookmarks.export.desc"),
+    builder: (yy) => yy.option("format", {
+      describe: t("cli.bookmarks.export.format"),
+      type: "string",
+      choices: ["json", "md"],
+      default: "md"
+    }).option("out", {
+      describe: t("cli.bookmarks.export.out"),
+      type: "string"
+    }),
+    handler: async (argv) => {
+      const args = argv;
+      try {
+        const groups = collectGroups();
+        const total = groups.reduce((n, g) => n + g.bookmarks.length, 0);
+        if (total === 0) {
+          console.log(t("cli.bookmarks.export.empty"));
+          return;
+        }
+        const output = args.format === "json" ? JSON.stringify(groups, null, 2) : toMarkdown(groups);
+        if (args.out) {
+          const outPath = resolve4(args.out);
+          writeFileSync2(outPath, output + "\n", "utf-8");
+          console.log(t("cli.bookmarks.export.success", String(total), outPath));
+        } else {
+          console.log(output);
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.log(t("cli.bookmarks.export.fail", msg));
+        process.exit(1);
+      }
+    }
+  }).demandCommand(1),
+  handler: () => {
+  }
+};
+
+// src/services/StatsService.ts
+function dayKey(d) {
+  const m = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  return `${d.getFullYear()}-${m}-${day}`;
+}
+function dayDiff(a, b) {
+  const [ay, am, ad] = a.split("-").map(Number);
+  const [by, bm, bd] = b.split("-").map(Number);
+  return Math.round((Date.UTC(by, bm - 1, bd) - Date.UTC(ay, am - 1, ad)) / 864e5);
+}
+function aggregateSessions(sessions, now = /* @__PURE__ */ new Date()) {
+  const minutesByDay = /* @__PURE__ */ new Map();
+  const books = /* @__PURE__ */ new Set();
+  let totalMinutes = 0;
+  for (const s of sessions) {
+    const minutes = Math.max(0, (s.ended_at - s.started_at) / 6e4);
+    if (minutes <= 0) continue;
+    const key = dayKey(new Date(s.started_at));
+    minutesByDay.set(key, (minutesByDay.get(key) ?? 0) + minutes);
+    books.add(s.book_id);
+    totalMinutes += minutes;
+  }
+  const days = [...minutesByDay.keys()].sort();
+  let longestStreak = 0;
+  let run = 0;
+  for (let i = 0; i < days.length; i++) {
+    run = i > 0 && dayDiff(days[i - 1], days[i]) === 1 ? run + 1 : 1;
+    longestStreak = Math.max(longestStreak, run);
+  }
+  let currentStreak = 0;
+  if (days.length > 0) {
+    const today = dayKey(now);
+    const yesterday = dayKey(new Date(now.getTime() - 864e5));
+    const last = days[days.length - 1];
+    if (last === today || last === yesterday) {
+      currentStreak = 1;
+      for (let i = days.length - 2; i >= 0; i--) {
+        if (dayDiff(days[i], days[i + 1]) === 1) currentStreak++;
+        else break;
+      }
+    }
+  }
+  return {
+    minutesByDay,
+    readingDays: days.length,
+    totalMinutes: Math.round(totalMinutes),
+    booksRead: books.size,
+    currentStreak,
+    longestStreak
+  };
+}
+var LEVEL_CHARS = ["\xB7", "\u2591", "\u2592", "\u2593", "\u2588"];
+var LEVEL_COLORS = ["38;5;238", "38;5;22", "38;5;28", "38;5;34", "38;5;40"];
+function levelOf(minutes) {
+  if (minutes <= 0) return 0;
+  if (minutes < 15) return 1;
+  if (minutes < 30) return 2;
+  if (minutes < 60) return 3;
+  return 4;
+}
+function renderHeatmap(minutesByDay, opts) {
+  const now = opts.now ?? /* @__PURE__ */ new Date();
+  const labelWidth = Math.max(...opts.dayLabels.map((l) => getStringWidth(l))) + 1;
+  const weeks = Math.max(4, Math.min(53, Math.floor((opts.width - labelWidth) / 2)));
+  const dow = (now.getDay() + 6) % 7;
+  const endMonday = new Date(now.getFullYear(), now.getMonth(), now.getDate() - dow);
+  const start = new Date(endMonday.getTime() - (weeks - 1) * 7 * 864e5);
+  const todayKey = dayKey(now);
+  const cell = (date) => {
+    const key = dayKey(date);
+    if (key > todayKey) return "  ";
+    const level = levelOf(minutesByDay.get(key) ?? 0);
+    if (!opts.color) return `${LEVEL_CHARS[level]} `;
+    return `\x1B[${LEVEL_COLORS[level]}m\u2588\x1B[0m `;
+  };
+  const lines = [];
+  for (let row = 0; row < 7; row++) {
+    const label = row === 0 ? opts.dayLabels[0] : row === 2 ? opts.dayLabels[1] : row === 4 ? opts.dayLabels[2] : "";
+    let line = label + " ".repeat(Math.max(0, labelWidth - getStringWidth(label)));
+    for (let w = 0; w < weeks; w++) {
+      line += cell(new Date(start.getTime() + (w * 7 + row) * 864e5));
+    }
+    lines.push(line.trimEnd());
+  }
+  return lines.join("\n");
+}
+function renderLegend(less, more, color) {
+  const cells = LEVEL_CHARS.map(
+    (ch, i) => color ? `\x1B[${LEVEL_COLORS[i]}m\u2588\x1B[0m` : ch
+  ).join(" ");
+  return `${less} ${cells} ${more}`;
+}
+
+// src/cli/commands/stats.ts
+var statsCommand = {
+  command: "stats",
+  describe: t("cli.stats.desc"),
+  handler: () => {
+    const sessions = new ReadingSessionModel().findAll();
+    const stats = aggregateSessions(sessions);
+    const lang = getConfig().language;
+    const width = process.stdout.columns ?? 80;
+    const color = Boolean(process.stdout.isTTY);
+    const dayLabels = lang === "en" ? ["Mon", "Wed", "Fri"] : ["\u4E00", "\u4E09", "\u4E94"];
+    console.log(t("cli.stats.title"));
+    console.log("");
+    console.log(renderHeatmap(stats.minutesByDay, { width, dayLabels, color }));
+    console.log("");
+    console.log(renderLegend(t("cli.stats.less"), t("cli.stats.more"), color));
+    console.log("");
+    console.log(t(
+      "cli.stats.summary",
+      String(stats.readingDays),
+      String(stats.totalMinutes),
+      String(stats.booksRead),
+      String(stats.currentStreak),
+      String(stats.longestStreak)
+    ));
+  }
+};
+
 // src/cli/parser.ts
 function createParser() {
-  const version = true ? "0.3.1" : "dev";
-  return yargs(hideBin(process.argv)).scriptName("novel").usage("$0 <command> [options]").command(importCommand).command(resumeCommand).command(openCommand).command(libraryCommand).command(removeCommand).command(langCommand).command(updateCommand).demandCommand(1, "\u8BF7\u6307\u5B9A\u4E00\u4E2A\u547D\u4EE4\u3002\u4F7F\u7528 --help \u67E5\u770B\u53EF\u7528\u547D\u4EE4\u3002").strict().alias("h", "help").alias("v", "version").version(version).epilogue("ReadShell \u2014 \u7EC8\u7AEF\u5185\u4F4E\u6253\u65AD\u8F7B\u9605\u8BFB\u5DE5\u5177");
+  const version = true ? "1.0.0" : "dev";
+  return yargs(hideBin(process.argv)).scriptName("novel").usage("$0 <command> [options]").command(importCommand).command(resumeCommand).command(openCommand).command(libraryCommand).command(removeCommand).command(langCommand).command(updateCommand).command(configCommand).command(syncCommand).command(bookmarksCommand).command(statsCommand).demandCommand(1, "\u8BF7\u6307\u5B9A\u4E00\u4E2A\u547D\u4EE4\u3002\u4F7F\u7528 --help \u67E5\u770B\u53EF\u7528\u547D\u4EE4\u3002").strict().alias("h", "help").alias("v", "version").version(version).epilogue("ReadShell \u2014 \u7EC8\u7AEF\u5185\u4F4E\u6253\u65AD\u8F7B\u9605\u8BFB\u5DE5\u5177");
 }
 
 // src/db/migrate.ts
-var SCHEMA_VERSION = 2;
+var SCHEMA_VERSION2 = 4;
 function initDatabase() {
   const db2 = getDb();
   db2.exec(`
@@ -1891,8 +2876,8 @@ function initDatabase() {
   `);
   const row = db2.prepare("SELECT version FROM schema_version LIMIT 1").get();
   const currentVersion = row?.version ?? 0;
-  if (currentVersion < SCHEMA_VERSION) {
-    logger.debug(`\u6570\u636E\u5E93\u8FC1\u79FB: v${currentVersion} \u2192 v${SCHEMA_VERSION}`);
+  if (currentVersion < SCHEMA_VERSION2) {
+    logger.debug(`\u6570\u636E\u5E93\u8FC1\u79FB: v${currentVersion} \u2192 v${SCHEMA_VERSION2}`);
     migrate(db2, currentVersion);
   }
 }
@@ -1953,10 +2938,32 @@ function migrate(db2, fromVersion) {
       );
 
       CREATE INDEX IF NOT EXISTS idx_bookmarks_book ON bookmarks(book_id);
+    `,
+    3: `
+      -- \u9605\u8BFB\u4F1A\u8BDD\uFF08\u7528\u4E8E\u7EDF\u8BA1\u4E0E\u8DE8\u8BBE\u5907\u540C\u6B65\uFF09
+      CREATE TABLE IF NOT EXISTS reading_sessions (
+        id         TEXT PRIMARY KEY,
+        book_id    TEXT NOT NULL REFERENCES books(id),
+        started_at INTEGER NOT NULL,
+        ended_at   INTEGER NOT NULL,
+        bytes_read INTEGER NOT NULL DEFAULT 0,
+        synced     INTEGER NOT NULL DEFAULT 0
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_sessions_book ON reading_sessions(book_id);
+    `,
+    4: `
+      -- \u4E66\u7B7E\u5893\u7891\uFF1A\u6587\u4EF6\u5939\u540C\u6B65\u9700\u8981\u4F20\u64AD\u5220\u9664\u4E8B\u4EF6
+      ALTER TABLE bookmarks ADD COLUMN updated_at INTEGER NOT NULL DEFAULT 0;
+      ALTER TABLE bookmarks ADD COLUMN deleted INTEGER NOT NULL DEFAULT 0;
+      UPDATE bookmarks SET updated_at = created_at;
+
+      -- \u6587\u4EF6\u5939\u540C\u6B65\u6309 id \u53BB\u91CD\u5408\u5E76\u4F1A\u8BDD\uFF0C\u4E0D\u518D\u9700\u8981 synced \u6807\u8BB0
+      ALTER TABLE reading_sessions DROP COLUMN synced;
     `
   };
   db2.transaction(() => {
-    for (let v = fromVersion + 1; v <= SCHEMA_VERSION; v++) {
+    for (let v = fromVersion + 1; v <= SCHEMA_VERSION2; v++) {
       const sql = migrations[v];
       if (sql) {
         db2.exec(sql);
@@ -1964,7 +2971,7 @@ function migrate(db2, fromVersion) {
       }
     }
     db2.prepare("DELETE FROM schema_version").run();
-    db2.prepare("INSERT INTO schema_version (version) VALUES (?)").run(SCHEMA_VERSION);
+    db2.prepare("INSERT INTO schema_version (version) VALUES (?)").run(SCHEMA_VERSION2);
   })();
 }