feat: add postgres backend and rescan controls

Author: yumenaka

assets/dist/main.js

@@ -1,5 +1,5 @@
 /**
- * 全局 SSE：接收 ui_suggest_reload（整页刷新建议）并转发 log 到设置页日志面板。
+ * 全局 SSE：接收 ui_suggest_reload（整页刷新通知）并转发 log 到设置页日志面板。
  */
 function shouldEnableComigoSSE() {
     if (typeof window === 'undefined' || typeof EventSource === 'undefined') {
@@ -10,7 +10,13 @@ function shouldEnableComigoSSE() {
     return pathname !== '/login'
 }
 
-// 仅在书架与设置页弹出「建议刷新」；阅读页（flip/scroll 等）不打断
+const libraryRescanReloadReasons = new Set([
+    'library_rescan_done',
+    'auto_library_rescan_done',
+    'single_store_rescan_done',
+])
+
+// 仅在书架与设置页处理整页刷新；阅读页（flip/scroll 等）不打断
 function shouldShowUISuggestReloadPrompt() {
     const p = window.ComiGoRelativePath ? window.ComiGoRelativePath(window.location.pathname) : window.location.pathname
     if (p === '/settings') {
@@ -25,6 +31,10 @@ function shouldShowUISuggestReloadPrompt() {
     return false
 }
 
+function isLibraryRescanReloadReason(reason) {
+    return libraryRescanReloadReasons.has(reason)
+}
+
 function getReloadPromptMessage(reason) {
     const key = 'ui_suggest_reload_reason_' + reason
     const translated =
@@ -58,6 +68,14 @@ function showReloadPrompt(reason) {
     })
 }
 
+function autoReloadAfterLibraryRescan() {
+    if (!shouldShowUISuggestReloadPrompt() || window.__comigoAutoReloadQueued) {
+        return
+    }
+    window.__comigoAutoReloadQueued = true
+    window.location.reload()
+}
+
 function appendSharedLog(line) {
     if (typeof window.__comigoLogAppend === 'function') {
         window.__comigoLogAppend(line)
@@ -91,6 +109,10 @@ function comigoAttachSSEListeners(es) {
                 reason = data.reason
             }
         } catch (_) {}
+        if (isLibraryRescanReloadReason(reason)) {
+            autoReloadAfterLibraryRescan()
+            return
+        }
         showReloadPrompt(reason)
     })
 

assets/dist/styles.css

@@ -139,6 +139,8 @@
   "enable_database": "Enable a local database to store scanned book data",
   "enable_database_description": "Enable local database to save scanned book data. ",
   "enable_database_label": "Enable database",
+  "db_type": "Database type: sqlite or postgres",
+  "db_dsn": "PostgreSQL connection string",
   "enable_file_upload": "Enable file upload",
   "enable_funnel": "Enable Funnel",
   "enable_plugin": "Enable plugin system",
@@ -639,7 +641,7 @@
   "next": "Next",
   "next_book": "Next book",
   "no_available_stores": "No available stores, please add store paths in settings first",
-  "no_books_library_path_notice": "No readable books were found. Please configure a library path. When scanning finishes, you will be prompted to refresh the page.",
+  "no_books_library_path_notice": "No readable books were found. Please configure a library path. The page will reload automatically after scanning finishes.",
   "no_config_file_to_delete_in_path": "There is no configuration file to delete in the selected path.",
   "no_pages_in_pdf": "No pages in PDF.",
   "no_pattern": "Solid Color",
@@ -724,6 +726,7 @@
   "register_file_association": "Register archive file association (as a candidate)",
   "register_folder_context_menu": "Register folder context menu: Open with Comigo",
   "remote_access": "Remote Access",
+  "rescan_all_stores": "Rescan",
   "rescan_store": "Scan",
   "rescan_store_in_progress": "Scanning store, please wait...",
   "rescan_store_success": "Store scan completed, {0} new books added",
@@ -931,13 +934,13 @@
   "tui_url_copied": "URL copied: %s",
   "type_or_paste_content": "Type or paste content",
   "ui_suggest_reload_default": "Server data has changed. Reload the page to see the latest UI?",
-  "ui_suggest_reload_reason_auto_library_rescan_done": "Scheduled library scan finished. Reload the page to refresh the shelf and related views?",
+  "ui_suggest_reload_reason_auto_library_rescan_done": "Scheduled library scan finished. The page will reload automatically.",
   "ui_suggest_reload_reason_debug_toggle": "Debug mode changed. Reload the page to show the related settings?",
-  "ui_suggest_reload_reason_library_rescan_done": "Library scan finished. Reload the page to refresh the shelf and related views?",
+  "ui_suggest_reload_reason_library_rescan_done": "Library scan finished. The page will reload automatically.",
   "ui_suggest_reload_reason_login_settings_changed": "Login settings updated. Reload the page?",
   "ui_suggest_reload_reason_plugins_changed": "Plugins changed. Reload the page to apply?",
   "ui_suggest_reload_reason_server_config_changed": "Network or server settings changed. Reload the page?",
-  "ui_suggest_reload_reason_single_store_rescan_done": "This library has been rescanned. Reload the page?",
+  "ui_suggest_reload_reason_single_store_rescan_done": "This library has been rescanned. The page will reload automatically.",
   "unable_to_extract_images_from_pdf": "Unable to extract images from PDF.",
   "unknown": "Unknown",
   "unregister_context_menu": "Unregister context menu: Open with Comigo",

assets/frontend/plugins/comigo_sse.js

@@ -139,6 +139,8 @@
   "enable_database": "スキャンした本をローカルデータベースに保存する",
   "enable_database_description": "ローカルデータベースにスキャンした書籍データを保存できるようにします。",
   "enable_database_label": "データベースを有効にする",
+  "db_type": "データベース種別: sqlite または postgres",
+  "db_dsn": "PostgreSQL 接続文字列",
   "enable_file_upload": "ファイルのアップロードを有効にする",
   "enable_funnel": "Funnel有効",
   "enable_plugin": "プラグインシステムを有効にする",
@@ -639,7 +641,7 @@
   "next": "次へ",
   "next_book": "次の本",
   "no_available_stores": "利用可能な書庫がありません。設定で書庫パスを追加してください",
-  "no_books_library_path_notice": "閲覧可能な書籍が見つかりません。ライブラリパスを設定してください。スキャン完了後、ページを再読み込みするか確認するダイアログが表示されます。",
+  "no_books_library_path_notice": "閲覧可能な書籍が見つかりません。ライブラリパスを設定してください。スキャン完了後、ページは自動的に再読み込みされます。",
   "no_config_file_to_delete_in_path": "選択したパスには削除できる設定ファイルがありません。",
   "no_pages_in_pdf": "PDF内にページがありません",
   "no_pattern": "無地",
@@ -724,6 +726,7 @@
   "register_file_association": "圧縮ファイルの関連付けを登録（候補として追加）",
   "register_folder_context_menu": "フォルダー右クリックメニューを登録（Comigoで開く）",
   "remote_access": "リモートアクセス",
+  "rescan_all_stores": "再スキャン",
   "rescan_store": "書庫スキャン",
   "rescan_store_in_progress": "書庫をスキャンしています。お待ちください...",
   "rescan_store_success": "書庫のスキャンが完了しました。{0} 冊の新しい書籍が追加されました",
@@ -931,13 +934,13 @@
   "tui_url_copied": "URL をコピーしました: %s",
   "type_or_paste_content": "入力または貼り付け",
   "ui_suggest_reload_default": "サーバー側のデータが更新されました。最新の画面を見るためにページを再読み込みしますか？",
-  "ui_suggest_reload_reason_auto_library_rescan_done": "定期スキャンが完了しました。本棚などを更新するためにページを再読み込みしますか？",
+  "ui_suggest_reload_reason_auto_library_rescan_done": "定期スキャンが完了しました。ページは自動的に再読み込みされます。",
   "ui_suggest_reload_reason_debug_toggle": "デバッグモードが切り替わりました。関連設定を表示するためにページを再読み込みしますか？",
-  "ui_suggest_reload_reason_library_rescan_done": "ライブラリのスキャンが完了しました。本棚などを更新するためにページを再読み込みしますか？",
+  "ui_suggest_reload_reason_library_rescan_done": "ライブラリのスキャンが完了しました。ページは自動的に再読み込みされます。",
   "ui_suggest_reload_reason_login_settings_changed": "ログイン設定が更新されました。ページを再読み込みしますか？",
   "ui_suggest_reload_reason_plugins_changed": "プラグインの状態が変わりました。反映のためにページを再読み込みしますか？",
   "ui_suggest_reload_reason_server_config_changed": "ネットワークまたはサーバー設定が変更されました。ページを再読み込みしますか？",
-  "ui_suggest_reload_reason_single_store_rescan_done": "このライブラリの再スキャンが完了しました。ページを再読み込みしますか？",
+  "ui_suggest_reload_reason_single_store_rescan_done": "このライブラリの再スキャンが完了しました。ページは自動的に再読み込みされます。",
   "unable_to_extract_images_from_pdf": "PDFから画像を抽出できませんでした。",
   "unknown": "不明",
   "unregister_context_menu": "右クリックメニューを削除（Comigoで開く）",

assets/locale/en_US.json

@@ -139,6 +139,8 @@
   "enable_database": "启用本地数据库保存已扫描的书籍数据",
   "enable_database_description": "启用本地数据库，保存扫描到的书籍数据。",
   "enable_database_label": "启用数据库",
+  "db_type": "数据库类型：sqlite 或 postgres",
+  "db_dsn": "PostgreSQL 连接字符串",
   "enable_file_upload": "启用文件上传功能",
   "enable_funnel": "Funnel模式",
   "enable_plugin": "启用插件系统",
@@ -639,7 +641,7 @@
   "next": "下一曲",
   "next_book": "下一本",
   "no_available_stores": "没有可用的书库，请先在设置中添加书库路径",
-  "no_books_library_path_notice": "未检测到可阅读的书籍，请先配置书库路径。书库扫描完成后，界面会提示您是否刷新页面。",
+  "no_books_library_path_notice": "未检测到可阅读的书籍，请先配置书库路径。书库扫描完成后，页面会自动刷新。",
   "no_config_file_to_delete_in_path": "当前选择的路径下，没有可删除的配置文件",
   "no_pages_in_pdf": "PDF中无页面",
   "no_pattern": "纯色",
@@ -724,6 +726,7 @@
   "register_file_association": "注册压缩文件类型关联（作为候选打开方式）",
   "register_folder_context_menu": "注册文件夹右键菜单（“使用Comigo打开”）",
   "remote_access": "远程访问",
+  "rescan_all_stores": "重新扫描",
   "rescan_store": "扫描书库",
   "rescan_store_in_progress": "正在扫描书库，请稍候...",
   "rescan_store_success": "书库扫描完成，新增 {0} 本书",
@@ -931,13 +934,13 @@
   "tui_url_copied": "已复制URL: %s",
   "type_or_paste_content": "键入或粘贴内容",
   "ui_suggest_reload_default": "服务器端数据已更新，是否刷新页面以查看最新界面？",
-  "ui_suggest_reload_reason_auto_library_rescan_done": "定时书库扫描已完成，是否刷新页面以更新书架等内容？",
+  "ui_suggest_reload_reason_auto_library_rescan_done": "定时书库扫描已完成，页面将自动刷新。",
   "ui_suggest_reload_reason_debug_toggle": "调试模式已切换，是否刷新页面以加载相关设置项？",
-  "ui_suggest_reload_reason_library_rescan_done": "书库扫描已完成，是否刷新页面以更新书架等内容？",
+  "ui_suggest_reload_reason_library_rescan_done": "书库扫描已完成，页面将自动刷新。",
   "ui_suggest_reload_reason_login_settings_changed": "登录设置已更新，是否刷新页面？",
   "ui_suggest_reload_reason_plugins_changed": "插件状态已变更，是否刷新页面以生效？",
   "ui_suggest_reload_reason_server_config_changed": "网络或服务相关设置已变更，是否刷新页面？",
-  "ui_suggest_reload_reason_single_store_rescan_done": "该书库已重新扫描完成，是否刷新页面？",
+  "ui_suggest_reload_reason_single_store_rescan_done": "该书库已重新扫描完成，页面将自动刷新。",
   "unable_to_extract_images_from_pdf": "无法从PDF中提取图片",
   "unknown": "未知",
   "unregister_context_menu": "清理右键菜单（“使用Comigo打开”）",

assets/locale/ja_JP.json

@@ -55,6 +55,14 @@ func InitFlags() {
 	RootCmd.PersistentFlags().BoolVar(&cfg.EnableDatabase, "database", false, locale.GetString("enable_database"))
 	runtimeViper.BindPFlag("EnableDatabase", RootCmd.PersistentFlags().Lookup("database"))
 
+	// 数据库类型。未启用数据库时该配置会被忽略。
+	RootCmd.PersistentFlags().StringVar(&cfg.DBType, "db-type", "sqlite", locale.GetString("db_type"))
+	runtimeViper.BindPFlag("DBType", RootCmd.PersistentFlags().Lookup("db-type"))
+
+	// PostgreSQL 连接字符串。SQLite 模式不使用。
+	RootCmd.PersistentFlags().StringVar(&cfg.DBDSN, "db-dsn", "", locale.GetString("db_dsn"))
+	runtimeViper.BindPFlag("DBDSN", RootCmd.PersistentFlags().Lookup("db-dsn"))
+
 	// 服务端口
 	RootCmd.PersistentFlags().IntVarP(&cfg.Port, "port", "p", 1234, locale.GetString("port"))
 	runtimeViper.BindPFlag("Port", RootCmd.PersistentFlags().Lookup("port"))

assets/locale/zh_CN.json

@@ -21,9 +21,14 @@ func LoadMetadata() {
 			model.IStore = store.RamStore
 			return
 		}
-		if err := sqlc.OpenDatabase(configDir); err != nil {
+		if err := sqlc.OpenDatabase(sqlc.DBOptions{
+			Type:      config.GetCfg().DBType,
+			DSN:       config.GetCfg().DBDSN,
+			ConfigDir: configDir,
+		}); err != nil {
 			logger.Infof(locale.GetString("log_open_database_error"), err)
 			model.IStore = store.RamStore
+			config.GetCfg().EnableDatabase = false
 		} else {
 			model.IStore = sqlc.DbStore
 		}
@@ -50,7 +55,7 @@ func SaveMetadata() {
 		}
 	}
 	// 启用数据库的时候，同步书籍元数据到RamStore
-	if config.GetCfg().EnableDatabase {
+	if config.GetCfg().EnableDatabase && sqlc.DbStore != nil {
 		allBooks, err := sqlc.DbStore.ListBooks()
 		if err != nil {
 			logger.Infof(locale.GetString("log_error_listing_books_from_database"), err)
@@ -63,7 +68,7 @@ func SaveMetadata() {
 		}
 	}
 	// 启用数据库的时候，保存书籍元数据到到数据库
-	if config.GetCfg().EnableDatabase {
+	if config.GetCfg().EnableDatabase && sqlc.DbStore != nil {
 		err := scan.SaveBooksToDatabase(config.GetCfg())
 		if err != nil {
 			logger.Infof(locale.GetString("log_failed_savebookstodatabase"), err)

cmd/init_flags.go

@@ -35,6 +35,8 @@ type Config struct {
 	CustomPlugins             []CustomPlugin `json:"-" toml:"-"  comment:"用户自定义插件内容列表"`
 	DisableLAN                bool           `json:"DisableLAN" comment:"只在本机提供阅读服务，不对外共享"`
 	EnableDatabase            bool           `json:"EnableDatabase" comment:"启用本地数据库，保存扫描到的书籍数据。"`
+	DBType                    string         `json:"DBType" comment:"数据库类型：sqlite 或 postgres。仅启用数据库时生效。"`
+	DBDSN                     string         `json:"DBDSN" comment:"PostgreSQL 连接字符串。仅 DBType=postgres 时生效。"`
 	EnableTLS                 bool           `json:"EnableTLS" comment:"是否启用HTTPS协议。需要设置证书于key文件。"`
 	AutoTLSCertificate        bool           `json:"AutoTLSCertificate" comment:"自动申请、签发 HTTPS 证书（Let's Encrypt）"`
 	BasePath                  string         `json:"BasePath" comment:"反向代理基础路径，例如 /some/path。留空表示服务挂载在根路径 /"`

cmd/set_metadata.go

@@ -10,10 +10,14 @@ import (
 	"github.com/yumenaka/comigo/tools/logger"
 )
 
+// GetCfg 返回当前进程的全局配置指针。
+// 调用方可以通过返回值读取或修改配置；并发写入时需要遵守 config.Mutex 的保护约定。
 func GetCfg() *Config {
 	return &cfg
 }
 
+// CopyCfg 返回当前全局配置的值拷贝。
+// 返回值用于变更前后对比，不会随全局配置后续修改而自动更新。
 func CopyCfg() Config {
 	return cfg
 }