Dev

.env.example

@@ -1,11 +1,11 @@
 # ==========================================
 # PaperMind 环境配置示例
 # ==========================================
-# 
+#
 # 使用说明：
 # - 本地开发：复制为 .env（根目录）
 # - Docker部署：复制为 .env（根目录）
-# 
+#
 # 必须配置项：至少填写一个 LLM API Key
 # ==========================================
 

.github/workflows/opencode.yml

@@ -30,4 +30,4 @@ jobs:
         env:
           ALIBABA_CODING_PLAN_API_KEY: ${{ secrets.ALIBABA_CODING_PLAN_API_KEY }}
         with:
-          model: alibaba-coding-plan-cn/qwen3.5-plus
+          model: alibaba-coding-plan-cn/qwen3.5-plus

.github/workflows/pr-review-gate.yml

@@ -35,7 +35,7 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           PR_NUM="${{ steps.pr.outputs.pr_number }}"
-          
+
           BODY='## 🔍 OpenCode PR Review Required
 
           这是一个受保护的分支，merge 前需要进行 code review。
@@ -50,7 +50,7 @@ jobs:
           ---
 
           *This is an automated reminder from PR Review Gate.*'
-          
+
           gh pr comment $PR_NUM --body "$BODY"
 
       - name: Set status check to success

.pre-commit-config.yaml

@@ -11,13 +11,8 @@ repos:
         args: [--fix, --exit-non-zero-on-fix]
       - id: ruff-format
 
-  # TypeScript/JavaScript - Prettier
-  - repo: https://github.com/pre-commit/mirrors-prettier
-    rev: v3.4.2
-    hooks:
-      - id: prettier
-        files: \.(ts|tsx|js|jsx|json|css|md)$
-        exclude: ^frontend/node_modules/
+  # TypeScript/JavaScript - 通过 npm scripts 格式化 (prettier 在 node_modules 中)
+  # 运行 npm run format 格式化前端代码
 
   # 通用检查
   - repo: https://github.com/pre-commit/pre-commit-hooks

README.md

@@ -452,4 +452,4 @@ alembic upgrade head
 
 [![Star](https://img.shields.io/github/stars/Color2333/PaperMind?style=social)](https://github.com/Color2333/PaperMind/stargazers)
 
-</div>
+</div>

apps/api/routers/pipelines.py

@@ -24,7 +24,6 @@
 
 @router.post("/pipelines/skim/{paper_id}")
 def run_skim(paper_id: UUID) -> dict:
-
     tid = f"skim_{paper_id.hex[:8]}"
     title = get_paper_title(paper_id) or str(paper_id)[:8]
     global_tracker.start(tid, "skim", f"粗读: {title[:30]}", total=1)
@@ -39,7 +38,6 @@ def run_skim(paper_id: UUID) -> dict:
 
 @router.post("/pipelines/deep/{paper_id}")
 def run_deep(paper_id: UUID) -> dict:
-
     tid = f"deep_{paper_id.hex[:8]}"
     title = get_paper_title(paper_id) or str(paper_id)[:8]
     global_tracker.start(tid, "deep_read", f"精读: {title[:30]}", total=1)
@@ -54,7 +52,6 @@ def run_deep(paper_id: UUID) -> dict:
 
 @router.post("/pipelines/embed/{paper_id}")
 def run_embed(paper_id: UUID) -> dict:
-
     tid = f"embed_{paper_id.hex[:8]}"
     title = get_paper_title(paper_id) or str(paper_id)[:8]
     global_tracker.start(tid, "embed", f"嵌入: {title[:30]}", total=1)

apps/desktop/__init__.py

@@ -1 +0,0 @@
-

docker-compose.yml

@@ -120,4 +120,3 @@ volumes:
   pm_logs:
     name: papermind_logs
   pm_pip_cache:
-

docs/PaperMind.md

@@ -1,8 +1,8 @@
 # PaperMind - AI 研究工作流平台
 
-**版本:** 2.8  
-**日期:** 2026-02-19  
-**作者:** color2333  
+**版本:** 2.8
+**日期:** 2026-02-19
+**作者:** color2333
 **核心愿景:** 从"搜索论文"进化为"理解领域"。通过自动化 Agent 和 LLM，将海量文献转化为结构化的知识图谱，辅助研究者完成从"每日追踪"到"深度调研"的全过程。
 
 ---

docs/deployment/DOCKER_DEPLOYMENT.md

@@ -1,7 +1,7 @@
 # PaperMind Docker 部署指南 - 端口预留版
 
 > 适用于已有项目占用 3001 和 8001 端口的场景
-> 
+>
 > **端口规划**:
 > - 现有项目：3001(前端) + 8001(后端)
 > - PaperMind：**3002(前端) + 8002(后端)**
@@ -346,14 +346,14 @@ ufw allow from 192.168.1.0/24 to any port 8002
 server {
     listen 443 ssl;
     server_name your-domain.com;
-    
+
     ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
     ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;
-    
+
     location / {
         proxy_pass http://localhost:3002;
     }
-    
+
     location /api/ {
         proxy_pass http://localhost:8002;
     }
@@ -414,7 +414,7 @@ services:
     image: prom/prometheus
     ports:
       - "9090:9090"
-  
+
   grafana:
     image: grafana/grafana
     ports:

docs/deployment/DOCKER_FIXES.md

@@ -1,7 +1,7 @@
 # PaperMind Docker 部署问题修复报告
 
 > 修复日期：2026-02-26
-> 
+>
 > 修复目标：确保 Docker 部署顺利，解决前后端配置问题
 
 ---
@@ -23,11 +23,11 @@
 export function resolveApiBase(): string {
   if (!isTauri()) {
     if (import.meta.env.VITE_API_BASE) return import.meta.env.VITE_API_BASE;
-    
+
     if (import.meta.env.DEV) {
       return "http://localhost:8000";
     }
-    
+
     // Docker 生产环境使用相对路径
     return "/api";
   }
@@ -66,19 +66,19 @@ cors_allow_origins: str = (
 location /api/ {
     # 去掉 /api 前缀，转发到后端
     rewrite ^/api/(.*) /$1 break;
-    
+
     # 后端服务地址（Docker 内部网络）
     proxy_pass http://backend:8000;
-    
+
     # WebSocket/SSE 支持
     proxy_http_version 1.1;
     proxy_set_header Upgrade $http_upgrade;
     proxy_set_header Connection "upgrade";
-    
+
     # 关闭缓冲（SSE 需要）
     proxy_buffering off;
     proxy_cache off;
-    
+
     # 超时设置
     proxy_read_timeout 120s;
 }
@@ -197,7 +197,7 @@ src/pages/Agent.tsx(346,42): error TS2552
 ...
 ```
 
-**影响**: 
+**影响**:
 - ❌ 不影响 Docker 构建（Dockerfile 使用 `npm run build` 会跳过类型检查）
 - ⚠️ 建议后续修复这些类型错误
 
@@ -221,7 +221,7 @@ result.get("saved_path", "N/A")  # Pylance 报错，但运行时正确
 
 **原因**: `result` 可能为 `None`，但实际逻辑中不会为 `None`
 
-**影响**: 
+**影响**:
 - ✅ 不影响运行
 - ✅ 不影响 Docker 构建
 

docs/deployment/WIKI_DEPLOYMENT.md

@@ -1,6 +1,6 @@
 # PaperMind 部署 Wiki
 
-> 📚 **完整的部署指南** - 从本地开发到生产环境，一站式搞定！  
+> 📚 **完整的部署指南** - 从本地开发到生产环境，一站式搞定！
 > 📅 最后更新：2026-03-02 | 版本：v3.1
 
 ---
@@ -216,7 +216,7 @@ docker compose ps
 # 预期输出：
 # NAME                  STATUS              PORTS
 # papermind-backend     Up (healthy)        0.0.0.0:8002->8000/tcp
-# papermind-worker      Up (healthy)        
+# papermind-worker      Up (healthy)
 # papermind-frontend    Up (healthy)        0.0.0.0:3002->80/tcp
 
 # 检查服务健康状态
@@ -255,14 +255,14 @@ services:
         reservations:
           cpus: '0.5'    # 预留 0.5 核
           memory: 512M   # 预留 512MB
-  
+
   worker:
     deploy:
       resources:
         limits:
           cpus: '2.0'
           memory: 2G
-  
+
   frontend:
     deploy:
       resources:
@@ -819,14 +819,14 @@ ufw allow from 192.168.1.0/24 to any port 8002
 server {
     listen 443 ssl;
     server_name your-domain.com;
-    
+
     ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
     ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;
-    
+
     location / {
         proxy_pass http://localhost:3002;
     }
-    
+
     location /api/ {
         proxy_pass http://localhost:8002;
     }
@@ -893,7 +893,7 @@ services:
       - "9090:9090"
     volumes:
       - ./monitoring/prometheus.yml:/etc/prometheus/prometheus.yml
-  
+
   grafana:
     image: grafana/grafana
     ports:

frontend/index.html

@@ -5,20 +5,20 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="description" content="PaperMind - AI 驱动的学术论文研究平台，从搜索论文进化为理解领域" />
     <meta name="theme-color" content="#C4663C" />
-    
+
     <!-- Favicon -->
     <link rel="icon" type="image/svg+xml" href="/papermind-icon.svg" />
     <link rel="apple-touch-icon" href="/papermind-icon.svg" />
-    
+
     <!-- Open Graph -->
     <meta property="og:title" content="PaperMind - AI 论文研究平台" />
     <meta property="og:description" content="AI 驱动的学术论文研究平台，从搜索论文进化为理解领域" />
     <meta property="og:type" content="website" />
     <meta property="og:image" content="/papermind-icon.svg" />
-    
+
     <!-- PWA Manifest -->
     <link rel="manifest" href="/manifest.json" />
-    
+
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet" />

frontend/package.json

@@ -13,6 +13,7 @@
     "lint:fix": "eslint \"src/**/*.{ts,tsx}\" --fix"
   },
   "dependencies": {
+    "@tanstack/react-virtual": "^3.13.23",
     "@tauri-apps/api": "^2.10.1",
     "@tauri-apps/plugin-dialog": "^2.6.0",
     "@tauri-apps/plugin-fs": "^2.4.5",

frontend/public/manifest.json

@@ -14,4 +14,4 @@
       "purpose": "any maskable"
     }
   ]
-}
+}