v0.21.6

windoze · windoze · commit 5120af0dd348 · 2025-12-12T21:52:42.000+08:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,6 +4,19 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.21.6]
+
+### Improved
+
+- Streaming file download/upload to reduce memory consumption
+- Polish auth error page
+
+### Fixed
+
+- Login button invisible under light theme in server web UI
+- Images not displaying correctly when server uses self-signed certificate
+- Adding host tag to search box now replaces existing host tag instead of appending
+
 ## [0.21.5]
 
 ### Fixed
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -187,7 +187,7 @@ Both the CLI and desktop app support connecting to HTTPS servers with self-signe
 - Server tests must run sequentially: `-- --test-threads=1`
 - Client tests must run sequentially: `-- --test-threads=1`
 - Each test creates isolated temporary database
-- **Total test coverage**: clipper-indexer (all core operations), clipper-server (18 tests), clipper-client (18 tests)
+- **Total test coverage**: clipper-indexer (all core operations), clipper-server (81 tests), clipper-client (20 tests)
 
 ## Project Status
 
@@ -212,6 +212,11 @@ Both the CLI and desktop app support connecting to HTTPS servers with self-signe
 - Global hotkey support
 - Advanced search operators
 - Export/import functionality (tar.gz archive with clips and attachments, deduplication on import)
+- Self-signed certificate trust (SSH-like fingerprint verification)
+- Streaming file upload/download for reduced memory consumption
+- Tags management with dedicated tags table
+- Search result highlighting
+- PII detection before sharing
 
 ### Future Work
 - Clipboard monitoring daemon (standalone)
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -11,7 +11,7 @@ members = [
 resolver = "2"
 
 [workspace.package]
-version = "0.21.5"
+version = "0.21.6"
 edition = "2024"
 rust-version = "1.91"
 repository = "https://github.com/windoze/clipper"
diff --git a/Dockerfile b/Dockerfile
@@ -52,7 +52,7 @@ COPY clipper-server ./clipper-server
 COPY --from=web-builder /app/clipper-server/web/dist ./clipper-server/web/dist
 
 # Create a minimal workspace Cargo.toml for the server build
-RUN echo '[workspace]\nmembers = ["clipper-security", "clipper-server", "clipper-indexer"]\nresolver = "2"\n[workspace.package]\nversion = "0.21.5"\nedition = "2024"' > Cargo.toml
+RUN echo '[workspace]\nmembers = ["clipper-security", "clipper-server", "clipper-indexer"]\nresolver = "2"\n[workspace.package]\nversion = "0.21.6"\nedition = "2024"' > Cargo.toml
 
 # Build release binary with embedded web UI and TLS support
 RUN cargo build --release -p clipper-server --features embed-web,full-tls
diff --git a/Dockerfile.backup b/Dockerfile.backup
@@ -65,7 +65,7 @@ COPY clipper-server ./clipper-server
 COPY --from=web-builder /app/clipper-server/web/dist ./clipper-server/web/dist
 
 # Create a minimal workspace Cargo.toml for the server build
-RUN echo '[workspace]\nmembers = ["clipper-security", "clipper-server", "clipper-indexer"]\nresolver = "2"\n[workspace.package]\nversion = "0.21.5"\nedition = "2024"' > Cargo.toml
+RUN echo '[workspace]\nmembers = ["clipper-security", "clipper-server", "clipper-indexer"]\nresolver = "2"\n[workspace.package]\nversion = "0.21.6"\nedition = "2024"' > Cargo.toml
 
 # Build release binary with embedded web UI and TLS support
 RUN cargo build --release -p clipper-server --features embed-web,full-tls
diff --git a/README.md b/README.md
@@ -3,7 +3,7 @@
 A modern, cross-platform clipboard manager with full-text search, real-time sync, and a beautiful desktop interface.
 
 [![Homepage](https://img.shields.io/badge/homepage-clipper.unwritten.codes-blue)](https://clipper.unwritten.codes)
-![Version](https://img.shields.io/badge/version-0.21.5-blue)
+![Version](https://img.shields.io/badge/version-0.21.6-blue)
 ![License](https://img.shields.io/badge/license-MIT-green)
 ![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey)
 
diff --git a/README.zh-CN.md b/README.zh-CN.md
@@ -3,7 +3,7 @@
 一款现代化、跨平台的剪贴板管理器，支持全文搜索、实时同步，拥有精美的桌面界面。
 
 [![Homepage](https://img.shields.io/badge/homepage-clipper.unwritten.codes-blue)](https://clipper.unwritten.codes)
-![Version](https://img.shields.io/badge/version-0.21.5-blue)
+![Version](https://img.shields.io/badge/version-0.21.6-blue)
 ![License](https://img.shields.io/badge/license-MIT-green)
 ![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey)
 
diff --git a/clipper-cli/CLAUDE.md b/clipper-cli/CLAUDE.md
@@ -24,20 +24,40 @@ cargo run --bin clipper-cli -- watch
 ## Commands
 
 ```bash
-clipper-cli create <content> [--tags tag1,tag2] [--notes "notes"]
-clipper-cli get <id> [--format json|text]
-clipper-cli update <id> [--tags tag1,tag2] [--notes "notes"]
-clipper-cli search <query> [--tags tag1,tag2] [--start-date ISO8601] [--end-date ISO8601] [--page 1] [--page-size 20] [--format json|text]
-clipper-cli delete <id>
-clipper-cli watch  # Real-time notifications as NDJSON
-clipper-cli share <id> [--expires <hours>]  # Create a short URL for sharing (requires server with CLIPPER_SHORT_URL_BASE)
+clipper-cli create <content> [--tags tag1,tag2] [--notes "notes"]     # Alias: c
+clipper-cli get <id> [--format json|text]                             # Alias: g
+clipper-cli update <id> [--tags tag1,tag2] [--notes "notes"]          # Alias: u
+clipper-cli search <query> [--tags tag1,tag2] [--start-date ISO8601] [--end-date ISO8601] [--page 1] [--page-size 20] [--format json|text]  # Alias: s
+clipper-cli list [--tags tag1,tag2] [--start-date ISO8601] [--end-date ISO8601] [--page 1] [--page-size 100] [--format json|text]           # Alias: l
+clipper-cli delete <id>                                               # Alias: d
+clipper-cli watch                                                     # Alias: w - Real-time notifications as NDJSON
+clipper-cli upload <file> [--tags tag1,tag2] [--notes "notes"] [--content "override"]
+clipper-cli share <id> [--expires <hours>] [--format url|json]        # Create a short URL for sharing
+clipper-cli export [--output <path>]                                  # Alias: e - Export clips to tar.gz
+clipper-cli import <file> [--format text|json]                        # Alias: i - Import clips from tar.gz
+clipper-cli search-tag [<query>] [--page 1] [--page-size 100] [--format text|json]  # Alias: st - Search/list tags
 ```
 
-## Environment Configuration
+## Configuration
 
+Configuration priority: CLI arg > env var > config file > Clipper desktop app config > default
+
+### CLI Options
+
+- `-c, --config <path>` - Path to config file
+- `-u, --url <url>` - Server URL
+- `-t, --token <token>` - Bearer token for authentication
+
+### Environment Variables
+
+- `CLIPPER_CONFIG` - Path to config file
 - `CLIPPER_URL` - Server URL (default: `http://localhost:3000`)
 - `CLIPPER_TOKEN` - Bearer token for authentication (optional)
 
+### Config File
+
+Shares the same format as Clipper desktop app's `settings.json`. If no config is specified, CLI will try to use the desktop app's config.
+
 ## Self-Signed Certificate Support
 
 When connecting to an HTTPS server with a self-signed certificate, clipper-cli will:
diff --git a/clipper-client/CLAUDE.md b/clipper-client/CLAUDE.md
@@ -59,4 +59,4 @@ while let Some(notification) = rx.recv().await {
 
 - Client tests must run sequentially: `-- --test-threads=1`
 - Tests require running server (tests start temporary server instances)
-- **Test coverage**: 18 tests
+- **Test coverage**: 20 tests (2 unit tests + 18 integration tests)
diff --git a/clipper-server/CLAUDE.md b/clipper-server/CLAUDE.md
@@ -156,18 +156,24 @@ When connecting to a server with a self-signed certificate, the Clipper app will
 ## REST API Endpoints
 
 - `GET /health` - Health check
+- `GET /auth/check` - Check authentication status
 - `GET /version` - Server version and status (version, uptime, active connections, config)
 - `POST /clips` - Create clip from text
-- `POST /clips/upload` - Upload file as clip
+- `POST /clips/upload` - Upload file as clip (streaming, multipart)
 - `GET /clips` - List clips with pagination (query params: start_date, end_date, tags, page, page_size)
-- `GET /clips/search` - Search clips with pagination (query params: q, start_date, end_date, tags, page, page_size)
+- `GET /clips/search` - Search clips with pagination (query params: q, start_date, end_date, tags, page, page_size, highlight_begin, highlight_end)
 - `GET /clips/:id` - Get clip by ID
 - `PUT /clips/:id` - Update clip metadata
 - `DELETE /clips/:id` - Delete clip
-- `GET /clips/:id/file` - Download file attachment
+- `GET /clips/:id/file` - Download file attachment (streaming)
+- `GET /tags` - List all tags
+- `GET /tags/search` - Search tags with autocomplete
 - `POST /clips/:id/short-url` - Create a short URL for sharing a clip (requires `CLIPPER_SHORT_URL_BASE`)
+- `GET /short/:code` - Redirect short URL to full clip URL
 - `GET /s/:code` - Public endpoint to resolve short URL (returns HTML page, JSON, or file based on Accept header)
 - `GET /shared-assets/:filename` - Static assets for shared clip page (CSS/JS)
+- `GET /export` - Export all clips as tar.gz archive (streaming)
+- `POST /import` - Import clips from tar.gz archive (streaming, multipart)
 
 ## WebSocket Endpoint
 
@@ -205,4 +211,4 @@ Server broadcasts four types of notifications:
 - Each test creates isolated temporary database
 - Server tests use raw HTTP requests via tower::ServiceExt
 - Multipart file upload tests construct raw HTTP multipart bodies
-- **Test coverage**: 18 tests
+- **Test coverage**: 81 tests (23 unit tests + 58 API tests)
diff --git a/clipper-server/web/CLAUDE.md b/clipper-server/web/CLAUDE.md
@@ -42,9 +42,9 @@ npm run build
 
 Located in `src/`:
 
-- `hooks/useWebSocket.ts`: WebSocket connection for real-time updates
-- `hooks/useCleanupConfig.ts`: Fetches cleanup config from `/version` API for fade-out effect
-- `components/`: Reusable UI components (shared via @unwritten-codes/clipper-ui package)
+- `App.tsx`: Main application component with clip list, search, filters
+- `components/LoginScreen.tsx`: Authentication login page (self-contained styling for theme support)
+- Uses shared components from `@unwritten-codes/clipper-ui` package
 
 ## Architecture
 
diff --git a/clipper-server/web/package-lock.json b/clipper-server/web/package-lock.json
diff --git a/clipper-server/web/package.json b/clipper-server/web/package.json
@@ -1,7 +1,7 @@
 {
   "name": "clipper-web",
   "private": true,
-  "version": "0.21.5",
+  "version": "0.21.6",
   "type": "module",
   "scripts": {
     "dev": "vite",
diff --git a/clipper/package-lock.json b/clipper/package-lock.json
diff --git a/clipper/package.json b/clipper/package.json
@@ -1,7 +1,7 @@
 {
   "name": "clipper",
   "private": true,
-  "version": "0.21.5",
+  "version": "0.21.6",
   "type": "module",
   "scripts": {
     "dev": "vite",
diff --git a/clipper/src-tauri/tauri.conf.json b/clipper/src-tauri/tauri.conf.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
   "productName": "Clipper",
-  "version": "0.21.5",
+  "version": "0.21.6",
   "identifier": "codes.unwritten.clipper",
   "build": {
     "beforeDevCommand": "npm run dev",
diff --git a/packages/clipper-ui/CLAUDE.md b/packages/clipper-ui/CLAUDE.md
@@ -29,16 +29,29 @@ import "@unwritten-codes/clipper-ui/styles/dark.css";
 - `src/api/` - API client utilities
 - `src/components/` - Reusable React components
   - `ClipEntry.tsx` - Individual clip display with copy, edit, delete, share buttons
+  - `ClipList.tsx` - Virtualized clip list with infinite scroll
+  - `ConnectionError.tsx` - Connection error display with retry
+  - `DateFilter.tsx` - Date range filter picker
+  - `DateTag.tsx` - Date display tag component
+  - `FavoriteToggle.tsx` - Favorite star toggle button
+  - `ImagePopup.tsx` - Image preview popup
+  - `LanguageSelector.tsx` - Language selection dropdown
+  - `SearchBox.tsx` - Search input with tag suggestions and autocomplete
   - `ShareDialog.tsx` - Dialog for generating and copying share URLs
   - `Toast.tsx` - Toast notification system
-  - `ImagePopup.tsx` - Image preview popup
-  - `EditClipDialog.tsx` - Edit clip tags and notes
+  - `Tooltip.tsx` - Tooltip component
 - `src/hooks/` - React hooks
-  - `useServerConfig.ts` - Fetches server config (checks if sharing is enabled via `shortUrlEnabled`)
   - `useCleanupConfig.ts` - Fetches cleanup config for fade-out effect
+  - `useClips.ts` - Clip data fetching and caching
+  - `useKeyboardNavigation.ts` - Keyboard navigation for clip list (arrow keys, Enter, etc.)
+  - `useScrollAnchor.ts` - Scroll position preservation
+  - `useServerConfig.ts` - Fetches server config (checks if sharing is enabled via `shortUrlEnabled`)
+  - `useSyntaxTheme.ts` - Syntax highlighting theme management
+  - `useTheme.ts` - Theme (light/dark/auto) management
 - `src/i18n/` - Internationalization (English, Chinese)
 - `src/styles/` - CSS styles (base, dark theme)
 - `src/types.ts` - TypeScript type definitions (includes `ServerConfig` with `shortUrlEnabled`)
+- `src/utils/` - Utility functions
 - `src/index.ts` - Main export file
 
 ## Usage
@@ -52,6 +65,7 @@ Both apps share the same components for consistent look and feel.
 ## Dependencies
 
 - `highlight.js` - Syntax highlighting for code clips
+- `validator` - Input validation utilities
 
 ## Sharing Feature
 
diff --git a/packages/clipper-ui/package-lock.json b/packages/clipper-ui/package-lock.json
diff --git a/packages/clipper-ui/package.json b/packages/clipper-ui/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@unwritten-codes/clipper-ui",
-  "version": "0.21.5",
+  "version": "0.21.6",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
