feat: 添加配置读取工具，支持从环境变量和 .env 文件加载 WEREAD_API_KEY

fix: 修复启动脚本中的 Python 解释器路径识别
style: 更新样式以支持按钮最小宽度和灵活布局
docs: 添加项目最终文档，整合各类信息与说明

static/css/style.css

@@ -748,6 +748,7 @@ body {
     display: flex;
     align-items: center;
     gap: 16px;
+    flex-wrap: wrap;
 }
 
 .shelf-search {
@@ -769,6 +770,7 @@ body {
 .shelf-refresh-btn {
     padding: 0 16px;
     height: 36px;
+    min-width: 112px;
     border: 1px solid var(--border);
     border-radius: var(--radius-sm);
     font-size: 13px;
@@ -781,7 +783,7 @@ body {
     align-items: center;
     justify-content: center;
     gap: 4px;
-    flex-shrink: 0;
+    flex: 0 0 112px;
     white-space: nowrap;
 }
 
@@ -789,6 +791,15 @@ body {
     display: inline-block;
     font-size: 14px;
     line-height: 1;
+    flex: 0 0 auto;
+}
+
+.shelf-refresh-btn .btn-text {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    min-width: 4.5em;
+    line-height: 1;
 }
 
 .shelf-refresh-btn:hover:not(:disabled) {
@@ -801,7 +812,7 @@ body {
     cursor: wait;
 }
 
-.shelf-refresh-btn.loading {
+.shelf-refresh-btn.is-loading {
     border-color: var(--accent);
     color: var(--accent);
 }
@@ -2022,6 +2033,9 @@ body {
     .shelf-search {
         width: 140px;
     }
+    .shelf-filters {
+        gap: 10px;
+    }
     .shelf-categories {
         gap: 6px;
     }

static/js/app.js

@@ -324,7 +324,7 @@ async function refreshShelf() {
     const btn = document.getElementById("shelfRefreshBtn");
     const textEl = btn.querySelector(".btn-text");
     btn.disabled = true;
-    btn.classList.add("loading");
+    btn.classList.add("is-loading");
     textEl.textContent = "同步中...";
 
     try {
@@ -344,7 +344,7 @@ async function refreshShelf() {
         alert("刷新失败: " + (e.message || "未知错误"));
     } finally {
         btn.disabled = false;
-        btn.classList.remove("loading");
+        btn.classList.remove("is-loading");
         textEl.textContent = "刷新";
     }
 }