CtxRun Development Documentation

This document records the complete development history of the CtxRun project, compiled based on git commit history and code change analysis.

Project Overview

CtxRun is an AI-powered productivity tool for developers, built on the Tauri framework.

Tech Stack

Core Framework: Tauri 2 (Rust 1.91 + WebView2)
Frontend: React 19 + TypeScript + Vite 7
State Management: Zustand 5
Styling: Tailwind CSS + tailwindcss-animate
Editor: Monaco Editor
Internationalization: i18next + react-i18next (JSON locale)
Testing: Vitest + Testing Library

Version History

v2.3.0 (2026-04-04) Transfer + Guard + Multi-window Architecture

Commit Hash	Change	Description
`525264d`	Release	Version 2.3.0
`7acfa5d`	Translation Optimization	i18n translation quality optimization
`12206f8`	Add Transfer	Transfer LAN transfer module
`7dab26d`	Release	Version 2.2.9
`fb792a0`	Add Network	Network interface discovery and tool integration
`739867d`	Optimize Battery	Battery info monitoring
`5c18c51`	Add Module	process-utils and env-probe enhancements

v2.3.0 Transfer File Transfer Module File Changes:

src-tauri/crates/transfer/Cargo.toml               | +28   New transfer crate
src-tauri/crates/transfer/src/lib.rs               | +34   Plugin entry
src-tauri/crates/transfer/src/commands.rs          | +332  Tauri commands (start/stop/send)
src-tauri/crates/transfer/src/models.rs            | +246  Data models
src-tauri/crates/transfer/src/server.rs            | +408  Axum HTTP server
src-tauri/crates/transfer/src/network.rs           | +403  Network interface discovery
src-tauri/crates/transfer/src/ws.rs                | +321  WebSocket real-time communication
src-tauri/crates/transfer/src/device.rs            | +222  Device management
src-tauri/crates/transfer/src/transfer.rs          | +138  File transfer logic
src-tauri/crates/transfer/src/qr.rs                | +30   QR code generation
src-tauri/crates/transfer/src/mobile.rs            | +11   Mobile support
src-tauri/crates/transfer/src/mobile_template.html | +706  Mobile HTML template
src/components/features/transfer/TransferView.tsx   | +120  Main view
src/components/features/transfer/ChatPanel.tsx      | +233  Chat panel
src/components/features/transfer/DeviceSidebar.tsx  | +59   Device sidebar
src/components/features/transfer/ServiceControls.tsx| +69   Service controls
src/components/features/transfer/QrCodeSVG.tsx      | +30   QR code SVG
src/store/useTransferStore.ts                      | +414  State management
src/types/transfer.ts                              | +89   Type definitions

v2.3.0 Guard Module File Changes:

src-tauri/src/guard.rs                              | +638  Idle lock screen guard core
src/windows/guard/GuardWindowApp.tsx                | +203  Lock screen window frontend
src-tauri/capabilities/guard.json                   | +21   Guard permissions config
src-tauri/src/tray_support.rs                       | +19   Tray support

v2.3.0 Multi-window Architecture Refactor File Changes:

src/App.tsx              -> src/windows/main/MainWindowApp.tsx          Rename migration
src/SpotlightApp.tsx     -> src/windows/spotlight/SpotlightWindowApp.tsx Refactor (157 lines)
src/PeekApp.tsx          -> src/windows/peek/PeekWindowApp.tsx           Refactor migration
src/windows/spotlight/resizeMode.ts                  | +97  Window resize mode

v2.3.0 i18n Refactor File Changes:

src/lib/i18n.ts           | -1597  Remove old inline translations
src/i18n/locales/zh.json  | +879   Chinese translation JSON
src/i18n/locales/en.json  | +879   English translation JSON

v2.3.0 Monitoring Enhancement File Changes:

src-tauri/crates/env-probe/src/commands/monitoring.rs  | +1182  Major monitoring probe enhancement
src-tauri/crates/env-probe/src/commands/system_info.rs | +61   System info
src/components/features/monitor/tabs/MonitorDashboard.tsx | +989  Dashboard refactor
src/types/monitor.ts                                   | +61   Monitoring types

Major Updates:

Transfer LAN Transfer: All-new LAN file transfer and instant chat module
- Based on Axum HTTP server + WebSocket real-time communication
- Auto device discovery (network interface scanning, virtual NIC filtering)
- QR Code sharing connection URL, mobile scan-to-use
- File transfer progress tracking, approval/rejection
- Built-in mobile HTML chat interface
Guard Idle Guard: Idle timeout auto lock screen
- Windows low-level keyboard/mouse hooks for global interception
- Background thread per-second idle time detection
- Full-screen overlay lock screen, long-press 1.5s circular progress bar to unlock
- Support preventing system sleep, keeping screen on
Multi-window Architecture: Migrated from single entry to multi-window
- MainWindowApp / SpotlightWindowApp / PeekWindowApp / GuardWindowApp
- Cross-window state sync (useCrossWindowAppStoreSync)
i18n Migration: From single-file i18n.ts to JSON locale (879 lines/language)
System Monitoring Major Enhancement: Battery, disk details, network traffic, port processes, network speed test

v2.2.9 (2026-04-01) System Monitor Enhancement

Major Updates:

Battery Info: Charge level, health, power, temperature, charge/discharge time
Network Interface Details: MAC, MTU, gateway, traffic statistics
Process List: CPU/memory usage, system process identification
Guard Basics: Idle lock screen module initial implementation

v2.2.8 (2026-03-28) Exec Runtime + Peek Window

v2.2.8 Exec Runtime File Changes:

src-tauri/crates/exec-runtime/Cargo.toml            | +New  New crate
src-tauri/crates/exec-runtime/src/lib.rs            | +29   Plugin entry
src-tauri/crates/exec-runtime/src/commands.rs       | +XX   request/approve/write/resize/terminate
src-tauri/crates/exec-runtime/src/manager.rs        | +XX   Process manager
src-tauri/crates/exec-runtime/src/models.rs         | +XX   Data models
src-tauri/crates/exec-runtime/src/safety.rs         | +XX   Safety policy (sandbox)
src-tauri/crates/exec-runtime/src/powershell_parser.ps1 | +XX  PowerShell parser
src-tauri/crates/process-utils/Cargo.toml            | +New  Process utils crate

v2.2.8 Peek Preview Window File Changes:

src-tauri/src/peek.rs                               | +XX   Peek window backend
src-tauri/capabilities/peek.json                    | +XX   Peek permissions
src/PeekApp.tsx                                     | +XX   Frontend entry
src/components/features/hyperview/renderers/DocxRenderer.tsx   | +132  DOCX renderer
src/components/features/hyperview/renderers/HtmlRenderer.tsx    | +XX   HTML renderer
src/components/features/hyperview/renderers/MarkupRenderer.tsx  | +XX   Markdown renderer
src/components/features/hyperview/renderers/PdfRenderer.tsx     | +XX   PDF renderer
src/components/features/hyperview/renderers/StructuredTextRenderer.tsx | +XX  Structured text

v2.2.8 Spotlight Execution Enhancement File Changes:

src/components/features/spotlight/exec/ExecApprovalSheet.tsx    | +XX   Execution approval panel
src/components/features/spotlight/exec/ExecSessionCard.tsx      | +XX   Execution session card
src/components/features/spotlight/trace/AssistantTraceTimeline.tsx | +XX  AI Trace timeline
src/components/features/spotlight/trace/ToolCallInlineBlock.tsx  | +XX  Tool call inline block
src/lib/exec/client.ts                              | +XX   Execution client
src/store/useExecStore.ts                           | +XX   Execution state management
src/types/exec.ts                                   | +XX   Execution types

v2.2.8 Network Speed Test File Changes:

src/components/features/monitor/network/mlabSpeedTest.ts | +XX  M-Lab NDT7 speed test
src/types/m-lab-ndt7.d.ts                                | +XX  Type declarations

Major Updates:

Exec Runtime: Command execution runtime
- Sandbox safety policy: command whitelist, path restrictions
- Execution approval mechanism (request_exec -> approve_exec / terminate_exec)
- Terminal resize and input write
Peek Standalone Preview Window: Pop-up file preview
- Multi-format renderers: HTML, PDF, DOCX, Markdown, structured text
- Independent Tauri window
AI Trace Visualization: Tool call process display
- Timeline view + inline tool call blocks
- Running/success/failure states
Network Speed Test: M-Lab NDT7 integration
DOCX Preview: Word document rendering

v2.2.7 (2026-03-17) Radial Menu Navigation

v2.2.7 New File Changes:

src/components/layout/ViewSwitcher.tsx   | +XX   View switcher radial menu
src/components/ui/MarkdownContent.tsx    | +XX   Unified Markdown rendering

Major Updates:

ViewSwitcher Radial Navigation: Radial-style view switching replacing sidebar (@spaceymonk/react-radial-menu)
MarkdownContent: Unified Markdown content rendering component

v2.2.6 (2026-03-12) Crate Modularization + Settings Refactor

v2.2.6 Crate Modularization Refactor File Changes:

src-tauri/crates/env-probe/Cargo.toml              | +13  Environment probe crate (migrated from src/)
src-tauri/crates/env-probe/src/lib.rs              | +New Module entry
src-tauri/crates/hyperview/Cargo.toml              | +12  File preview crate (migrated from src/)
src-tauri/crates/hyperview/src/lib.rs              | +New Module entry
src-tauri/crates/workspace-tests/Cargo.toml        | +New Integration test crate
src-tauri/crates/workspace-tests/tests/*.rs        | +XX  15+ test files

v2.2.6 Settings Page Refactor File Changes:

src/components/settings/sections/AISection.tsx               | +New AI config page
src/components/settings/sections/DataMaintenanceSection.tsx  | +New Data maintenance page
src/components/settings/sections/GeneralSection.tsx          | +New General settings page
src/components/settings/sections/SearchWorkspaceSection.tsx  | +New Search/workspace page
src/components/settings/sections/SecuritySection.tsx         | +New Security settings page
src/components/settings/SettingsView.tsx                     | +New New settings view
src/components/settings/SettingsNav.tsx                      | +New Navigation bar
src/components/settings/SettingsUi.tsx                       | +New UI container
src/components/layout/WorkspaceSwitcher.tsx                  | +New Workspace switcher
src/lib/theme.ts                                             | +New Theme utilities

Major Updates:

Crate Modularization: env-probe / hyperview migrated from src/ to independent crates
Settings Page Refactor: Split from SettingsModal into 5 independent pages
workspace-tests: Added 15+ integration test files

v2.2.5 (2026-03-05) Agent Tool Runtime

v2.2.5 Tool Runtime File Changes:

src-tauri/crates/tool-runtime/Cargo.toml            | +New  New crate
src-tauri/crates/tool-runtime/src/lib.rs            | +New Plugin entry
src-tauri/crates/tool-runtime/src/runtime.rs        | +New Runtime core
src-tauri/crates/tool-runtime/src/models.rs         | +New ToolSpec/ToolCall models
src-tauri/crates/tool-runtime/src/sandbox.rs        | +New Sandbox policy engine
src-tauri/crates/tool-runtime/src/fs_tools.rs       | +New File system tools
src-tauri/crates/tool-runtime/src/miner_tools.rs    | +New Miner tool integration
src-tauri/crates/tool-runtime/src/agent_fs.rs       | +New Agent file operations
src-tauri/crates/tool-runtime/src/patch_tools.rs    | +New Patch apply tools

v2.2.5 Frontend Agent System File Changes:

src/lib/agent/index.ts       | +New Agent entry
src/lib/agent/types.ts       | +New Agent types (ToolRiskLevel/AgentToolDefinition/AgentRuntimeCallbacks)
src/lib/agent/policy.ts      | +New Tool policy (allowAll/allowList/denyList)
src/lib/agent/registry.ts    | +New Tool registry
src/lib/agent/runtime.ts     | +New Agent runtime
src/lib/agent/tools/fs.ts    | +New File system tools
src/lib/agent/tools/web.ts   | +New Web tools
src/lib/chat_attachment.ts   | +New Chat attachment support

Major Updates:

Agent Tool Runtime: All-new AI tool runtime
- ToolSpec specification, ToolCallRequest/ToolCallResponse models
- Three policy modes (allowAll/allowList/denyList), risk-level classification
- Sandbox safety engine, approval interception
- Built-in tools: file system, web search/extract, Miner, patch
- Architecture inspired by OpenAI Codex CLI (codex-rs)
Chat Attachments: Spotlight AI conversation supports file attachments
Miner Enhancement: Single-page extraction, web search, post-processing pipeline
Underlying Replacement: AI model invocation underlying library replacement

v2.2.4 (2026-02-25)

Bug fixes and performance optimization

v2.2.3 (2026-02-24)

Performance optimization and bug fixes

v2.2.2 (2026-02-21) ⛏️ Model Miner

Intelligent web content mining module

Reuses local Chrome/Edge via headless_chrome
Readability.js extraction → turndown.js Markdown conversion
Multi-threaded concurrent crawling (1-10), depth/page limits, URL prefix filtering
Hierarchical {domain}/path/index.md storage with YAML front matter

v2.2.1 (2026-02-17)

Commit Hash	Change	Description
`d1367c8`	Release	Version 2.2.2
`87a620f`	Fix Bugs	Fix issues
`1d687c4`	Fix Bugs	Fix bugs
`4697d95`	Fix Bugs	Fix issues
`fecf870`	Add Model Miner	Add content mining module
`e02b449`	Data Update	Auto-sync prompts library

v2.2.2 Model Miner Feature File Changes:

src-tauri/crates/miner/Cargo.toml            | +XX   New miner crate
src-tauri/crates/miner/assets/Readability.js | +XXX  Readability library (Mozilla)
src-tauri/crates/miner/assets/extract.js     | +XX   Content extraction script
src-tauri/crates/miner/assets/turndown.js    | +XXX  HTML to Markdown library
src-tauri/crates/miner/assets/turndown-plugin-gfm.js | +XX  GFM support
src-tauri/crates/miner/src/lib.rs            | +XX   Plugin entry
src-tauri/crates/miner/src/commands.rs       | +XX   Tauri commands (start_mining, stop_mining)
src-tauri/crates/miner/src/core/driver.rs    | +XX   Browser driver (headless_chrome)
src-tauri/crates/miner/src/core/extractor.rs | +XX   Page extractor
src-tauri/crates/miner/src/core/queue.rs     | +XX   Task queue (multi-threaded Workers)
src-tauri/crates/miner/src/core/scope.rs     | +XX   URL scope control
src-tauri/crates/miner/src/core/storage.rs   | +XX   Hierarchical file storage
src-tauri/crates/miner/src/models.rs         | +XX   MinerConfig, MinerEvent, PageResult
src/components/features/miner/MinerView.tsx  | +XXX  UI component
src/store/useMinerStore.ts                  | +XXX  Zustand state management
src/types/miner.ts                          | +XX   TypeScript type definitions
src/lib/i18n.ts                             | +XX  i18n entries

Major Updates:

⛏️ Model Miner: Intelligent web content mining module
- Browser Driver: Uses headless_chrome crate, auto-detects and reuses local Chrome/Edge browser
- Content Extraction: Injects Readability.js (Mozilla) to extract main content, strips ads/nav noise
- Markdown Conversion: Uses turndown.js + GFM plugin to convert HTML to Markdown
- Concurrent Crawling: Multi-threaded Worker pool based on crossbeam-channel, 1-10 concurrency, default 5
- Depth Control: Supports max crawl depth (max_depth) and page count limit (max_pages)
- Scope Filtering: Strict URL prefix filtering via match_prefix to prevent crawling off-site
- Progress Push: Real-time progress via Tauri events (miner:progress, miner:error, miner:finished)
- Hierarchical Storage: Stores as domain/path/index.md structure for easy reading
- File Format: Markdown files with YAML front matter (title, source_url, crawled_at)

v2.2.1 (2026-02-17)

Color theme options

v2.2.0 (2026-02-16) 🌍 i18n + 🖱️ UI Auto Tree

i18n refactor: Migrate to i18next + react-i18next, syntax $var → {var}
UI Auto Tree: Automator supports Windows UIAutomation API semantic element targeting

v2.1.1 (2026-02-14)

Commit Hash	Change	Description
`0b2a41f`	Release	Version 2.2.0
`afe3736`	Merge Branch	Merge RE1 branch
`3964786`	Fix Bugs	Fix issues
`cfe7c6d`	Fix Bugs	Fix bugs
`70ec2a5`	Fix Bugs	Fix issues
`26a7297`	Fix Bugs	Fix and optimize
`92a3362`	i18n	English-Chinese translation
`c7ef8e`	Fix Bugs	Fix issues
`f26234`	Optimize	Feature optimization
`f95f76`	Optimize	UX improvements
`feaf0a`	Fix Bugs	Fix bugs
`099cef`	Optimize	Feature optimization
`37e57d`	Optimize	UX improvements
`a31a09`	Auto	Automation improvement
`db4946`	Fix Bugs	Fix bugs
`d22d2e`	Data Update	Auto-sync prompts library

v2.2.0 i18n Refactor File Changes:

src/i18n/config.ts                         | +XX  New i18next config
src/i18n/resources.ts                      | +XX  Resource placeholder
package.json                               | +2   Add i18next、react-i18next dependencies
src/main.tsx                               | ~    Import i18n config
src/components/features/automator/*.tsx    | +~   Replace getText() with useTranslation()
src/components/features/context/*.tsx      | +~   Replace getText() with useTranslation()
src/components/features/patch/*.tsx        | +~   Replace getText() with useTranslation()
src/components/features/prompts/*.tsx      | +~   Replace getText() with useTranslation()
src/components/features/refinery/*.tsx     | +~   Replace getText() with useTranslation()
src/components/settings/*.tsx              | +~   Replace getText() with useTranslation()
src/components/ui/*.tsx                    | +~   Replace getText() with useTranslation()

v2.2.0 UI Auto Tree File Changes:

src-tauri/crates/automator/src/inspector.rs              | +XXX  New UI inspector module
src-tauri/crates/automator/src/models.rs                  | +~    Add ActionTarget::Semantic、UIElementNode
src-tauri/crates/automator/src/engine.rs                  | +-XXX Adapt resolve_target_to_coords
src-tauri/commands/get_element_under_cursor.toml          | +XX   New Tauri command
src-tauri/Cargo.toml                                     | +XX   Add uiautomation (Windows)、enago dependencies
src/components/features/automator/nodes/ActionNode.tsx    | +-XXX Add semantic target selection
src/types/automator.ts                                    | +~    Add SemanticTarget type

Major Updates:

🌍 i18n Refactor: Migrate to i18next standard solution
- Replace custom solution with i18next + react-i18next
- Translation resources remain in src/lib/i18n.ts, injected via i18next config
- Interpolation syntax changed from $variable to {variable} (more standard)
- All components changed from getText(key, params) to useTranslation() hook
🖱️ UI Auto Tree: Automator supports semantic UI element targeting
- get_element_under_cursor: Uses Windows UIAutomation API to get element under cursor
- Element Recognition: Returns name, role (ControlType), window_title, process_name, path, etc.
- Path Tracking: Traverses from element up to window root, building complete UI tree path
- resolve_target_to_coords: Supports three targeting modes
  - Coordinate: Absolute coordinate click
  - WebSelector: Browser element selector (with fallback coordinates)
  - Semantic: Semantic target (name + role + window_title + path, with fallback coordinates)
- Element Finding:
  - First locate target window by window title
  - Then match element by name + role precisely
  - If not found, fuzzy match (contains)
  - Max 4 retries with 800ms interval
  - Max traverse 2500 nodes to prevent timeout

v2.1.1 (2026-02-14)

Commit Hash	Change	Description
`89d36c0`	Release	Version 2.1.1
`f2b23b5`	Fix Bugs	Fix multiple issues
`16efab0`	Fix Bugs	Fix issues

Major Updates:

🐛 Bug Fixes: Fix known issues

v2.1.0 (2026-02-14)

Commit Hash	Change	Description
`7159fbb`	Release	Version 2.1.0
`ac07a3f`	Merge Branch	Merge RE1 branch
`10fd343`	Update Models	Update models.json with new models
`2d1b163`	Data Update	Auto-sync prompts library

v2.1.0 Model Update File Changes:

models/models.json | Update AI model list

Major Updates:

🤖 AI Model Update: Support latest GPT-5.2, GPT-5.1, Gemini 3 Pro, Gemini 2.5 Pro, Claude Opus 4.5, Grok 4.1
📊 Context Window: Grok 4.1 supports 2M tokens context

v2.0.4 (2026-02-12)

Commit Hash	Change	Description
`05c4246`	Release	Version rc5
`d2de29b`	Release	Upload resources
`706540c`	Fix	Fix issues
`5e1bad4`	Update Models	Update AI model config
`73adf54`	Fix Bugs	Fix bugs
`84eaa67`	Fix	Fix issues
`4eddf36`	Release	Version 2.0.0+

Major Updates:

🔧 Optimization: Performance tuning and bug fixes

v2.0.0 (2026-02-11)

Commit Hash	Change	Description
`f4e778f`	Release	Version 2.0.0

v2.0.0 Architecture Refactor File Changes:

src-tauri/crates/automator/    | +XXX  Auto-clicker module
src-tauri/crates/context/      | Refactor Context module
src-tauri/crates/db/           | Refactor DB module
src-tauri/crates/git/          | Refactor Git module
src-tauri/crates/refinery/     | Refactor Refinery module
src/components/features/automator/ | +XXX  Auto-clicker UI
src/store/useAutomatorStore.ts | +XXX  State management
src/types/automator.ts         | +XXX  Type definitions

Major Updates:

🏗️ Architecture Refactor: Split monolithic src-tauri/src into multi-crates architecture
🖱️ Automator Auto-Clicker: Support left/right/middle click with configurable interval and count
🔧 Modularization: Each function independent crate, improving maintainability

v1.5.5 (2026-02-07)

Commit Hash	Change	Description
`71e09d9`	Release	Version 1.5.5
`70f2bda`	Fix Bugs	Fix bugs
`b434755`	Optimize	Feature optimization
`0162c53`	Optimize	UX improvements
`1a9e1b9`	Fix Bugs	Fix issues

Major Updates:

🐛 Bug Fixes: Fix known issues
⚡ Performance: Overall performance improvement

v1.5.4 (2026-02-06)

Commit Hash	Change	Description
`9dfd712`	Release	Version 1.5.4

v1.5.3 (2026-02-05)

Commit Hash	Change	Description
`31c8706`	Release	Version 1.5.3
`af5cd47`	Optimize	Feature optimization

v1.5.2 (2026-02-04)

Commit Hash	Change	Description
`8f9cddc`	Release	Version 1.5.2
`1fd5006`	Fix Bugs	Fix bugs
`0151d03`	Fix Bugs	Resolve issues
`9ddf7d1`	Fix Bugs	Fix self-copy issue

v1.5.1 (2026-02-02)

Commit Hash	Change	Description
`24753b4`	Release	Version 1.5.1
`6215b42`	Optimize	Feature optimization
`3064a42`	Fix Bugs	Fix bugs
`6859a96`	Add	Add features
`0c4a956`	Add	Add features
`17edca5`	Add	Add content
`c3751ce`	Update	Update config
`aa04326`	Add	Add images
`5398b63`	Optimize	UX improvements
`105f853`	Optimize	Optimize auto-cleanup
`5640a0f`	Optimize	Color tuning
`da4d3e4`	Optimize	Color scheme optimization

Major Updates:

🎨 Style Optimization: UI color scheme improvements
🧹 Auto Cleanup: Optimize cleanup logic

v1.5.0 (2026-01-30)

Commit Hash	Change	Description
`346782c`	Release	Version 1.5.0
`a07717a`	Fix Bugs	1.5.0-beta.1-fix
`a42628b`	Test Version	1.5.0-beta.1
`dabde8d`	Update Version	Version number update
`a774027`	Cleanup	Code cleanup
`b32fd4c`	Optimize Display	Optimize display, color tuning
`8389414`	Optimize URL	Optimize URL display
`6ba6da5`	Optimize Color	Color scheme optimization
`df3ba50`	Optimize Code	Code optimization
`6db79fd`	Optimize	Feature optimization
`238412d`	Optimize Animation	Animation effect optimization
`f964f67`	Optimize Rendering	Rendering performance optimization
`d51c823`	Optimize	Comprehensive optimization
`fb5e010`	Optimize	Feature optimization
`55d62ca`	Optimize	UX optimization
`cbc9a5c`	Data Update	Auto-sync prompts library
`2f03879`	Fix Bugs	Fix bugs
`c58f490`	Optimize Ignore	Optimize self-copy ignore
`f43cce6`	Optimize	Performance optimization
`db3b0f3`	Optimize	Feature optimization
`204e028`	Optimize	Code optimization
`4e4d7d5`	Optimize	Config optimization
`70eb9e3`	Optimize	UI optimization
`7dfa7a2`	Add Feature	Add notes field support
`d8a47ec`	Add Window Info	Add window info function
`fd127b8`	Add Clipboard	Refinery clipboard history
`db7d3dd`	Update Year	update 2024
`f8944e0`	Optimize Rules	Optimize .gitignore rule support
`2726ea4`	Optimize	Code optimization
`342013e`	Optimize	Performance optimization
`14e6a13`	Optimize	UX optimization
`c311757`	Update Docs	update dev.md
`91eeb19`	Fix Bugs	Fix bugs

v1.5.0 Refinery Feature File Changes:

src-tauri/migrations/V3__create_refinery_table.sql | +XXX  Create refinery table
src-tauri/migrations/V4__refinery_notes.sql   | +XX   Add notes field
src-tauri/src/refinery/mod.rs                | +XXX  Refinery module
src-tauri/src/refinery/commands.rs           | +XXX  Command interface
src-tauri/src/refinery/model.rs              | +XX   Data model
src-tauri/src/refinery/storage.rs             | +XXX  Storage layer
src-tauri/src/refinery/worker.rs             | +XXX  Worker thread
src/components/features/refinery/RefineryView.tsx       | +XXX  Main view
src/components/features/refinery/RefineryDrawer.tsx     | +XXX  Sidebar
src/components/features/refinery/RefineryFeed.tsx       | +XXX  History list
src/components/features/refinery/RefinerySidebar.tsx    | +XXX  Sidebar
src/components/features/refinery/ContentWorkbench.tsx    | +XXX  Content workbench
src/components/features/refinery/HistoryItem.tsx        | +XXX  History item
src/components/features/refinery/HistorySidebar.tsx     | +XXX  History sidebar
src/store/useRefineryStore.ts                          | +XXX  State management
src/types/refinery.ts                                  | +XX   Type definitions
src/lib/refinery_utils.ts                             | +XX   Utility functions

v1.5.0 .gitignore Optimization File Changes:

.gitignore              | +X   Add self-copy ignore rules
src-tauri/src/main.rs  | +-X  Add .gitignore file reading

Major Updates:

📋 Refinery Clipboard History:
- Support text and image clipboard history recording
- Searchable, filterable (text/image)
- Support pinning important entries
- Support adding notes
- Auto cleanup configuration
- Calendar view for date filtering
- Spotlight quick paste integration
🔒 .gitignore Rules: Support reading project .gitignore to filter files
🎨 UI Optimization: Overall color scheme and animation optimization
⚡ Performance Optimization: Rendering and animation performance improvements

v1.4.1 (2026-01-29)

Commit Hash	Change	Description
`f176194`	Optimize Reminder	Rest reminder logic migrated to Rust backend
`6ecf718`	Optimize Memory Usage	Window lifecycle management, auto-destroy hidden windows
`7108081`	Data Update	Auto-sync prompts library

v1.4.1 Reminder System Optimization File Changes:

src-tauri/src/scheduler.rs               | +98  new scheduler module
src-tauri/src/main.rs                    | +6   state management integration
src/App.tsx                              | -56 +3 frontend logic simplification
src/components/settings/AboutSection.tsx | +-2  version update

v1.4.1 Memory Optimization File Changes:

src-tauri/src/main.rs                     | +118 -48 window lifecycle refactor
src/App.tsx                               | -33    remove shortcut registration
src/SpotlightApp.tsx                      | +35    shortcut registration migration
src/components/layout/TitleBar.tsx        | +-9    close button optimization
src/components/settings/SettingsModal.tsx | +65    add auto-destroy settings
src/lib/i18n.ts                           | +8     new i18n entries
src/store/useAppStore.ts                  | +7     new state fields

Key Updates:

⏰ Backend Scheduler: New scheduler.rs module, rest reminder logic migrated from frontend to Rust backend
🔔 System-level Notifications: Use tauri-plugin-notification for native system notifications
💾 Memory Optimization: Hidden windows auto-destroy after delay, freeing memory resources
⚙️ Configurable Delay: Support configurable window auto-destroy delay in settings (30s-30min)
🎯 Architecture Optimization: Spotlight shortcut registration migrated from App.tsx to SpotlightApp.tsx
🔒 Exit Handling: Improved app exit flow, prevent tray residue

v1.4.0 (2026-01-28)

Commit Hash	Change	Description
`7cb60e5`	Search Engine Icon Optimization	Add SearchEngineIcon component for unified brand icon management
`124cede`	Backspace BUG Fix	Fix backspace deletion logic when switching search scopes
`4193cc1`	Code Cleanup	Remove unnecessary comments and debug code

v1.4.0 Detailed File Changes:

New Files:
  src/components/ui/SearchEngineIcon.tsx                 | +46  new search engine icon component

Modified Files:
  src/components/features/spotlight/hooks/useSpotlightSearch.ts | -6 +2  remove icon imports, icon field changed to string
  src/components/features/spotlight/core/SearchBar.tsx  | -7 +14  remove buggy reset logic, web tag uses SearchEngineIcon
  src/components/features/spotlight/modes/search/SearchMode.tsx | +9   web_search uses SearchEngineIcon with colorize support
  src/components/settings/SettingsModal.tsx              | ~8   search engine cards use SearchEngineIcon
  src/App.tsx                                           | -1   remove shortcut registration debug log
  src/components/features/context/ContextView.tsx        | -2   remove token count log

Key Updates:

🎨 Search Engine Brand Icons: New SearchEngineIcon component with official Google, Bing, Baidu icons and brand colors
🔧 Architecture Optimization: Hook layer no longer handles icon rendering, only passes engine type string - separation of concerns
🎯 Interaction Enhancement: Search results show white icons when selected for better dark background contrast
🐛 BUG Fix: Fixed backspace deletion logic - only exits search scope when pressing backspace on empty query
🧹 Code Cleanup: Removed unnecessary debug logs and comments

v1.3.9 (2026-01-28)

Commit Hash	Change	Description
`5b053ac`	Add HyperView Preview	New file preview feature supporting multiple formats
`d134c7c`	Database Structure Optimization	Split db.rs into modular structure
`4c5575d`	Style Optimization	Markdown renderer style improvements
`abb77f6`	Code Cleanup	Remove ContextView redundant code
`3190d8c`	Editor Optimization	Prompt editor interaction improvements
`5b71c4f`	Animation Optimization	Editor dialog animation smoothness enhancement
`d500168`	Release 1.3.9	Version release

v1.3.9 HyperView Preview Feature File Changes:

src-tauri/src/hyperview/mod.rs                    | +12  module entry
src-tauri/src/hyperview/protocol.rs               | +75  protocol handling
src-tauri/src/hyperview/sniffer.rs                | +99  file sniffer
src/components/features/hyperview/PreviewModal.tsx | +91  preview modal
src/components/features/hyperview/renderers/*.tsx | +196 multi-format renderers
src/components/features/context/ContextView.tsx   | +63  context view integration
src/components/features/context/FileTreeNode.tsx  | +33  file tree node
src/store/usePreviewStore.ts                      | +37  preview state management
src/types/hyperview.ts                            | +18  type definitions

v1.3.9 Database Structure Optimization File Changes:

src-tauri/src/db.rs              | -1338 split refactor
src-tauri/src/db/mod.rs          | +17   module export
src-tauri/src/db/init.rs         | +139  initialization logic
src-tauri/src/db/models.rs       | +110  data models
src-tauri/src/db/apps.rs         | +98   apps related
src-tauri/src/db/prompts.rs      | +555  prompts related
src-tauri/src/db/project_config.rs | +132 project config
src-tauri/src/db/secrets.rs      | +78   secrets related
src-tauri/src/db/shell_history.rs | +124  shell history
src-tauri/src/db/url_history.rs  | +155  URL history

Key Updates:

🖼️ HyperView File Preview: New file preview system supporting Markdown, code, images, binary, and more
🔍 Smart File Sniffing: Auto-detect file types and select appropriate renderers
📂 Context Integration: File tree nodes now have preview button for quick content viewing
🗄️ Database Modularization: Split single-file db.rs into 9 module files, improving code maintainability
🎨 Style Optimization: Markdown renderer improvements with better syntax highlighting and typography
⚡ Editor Enhancement: Prompt editor animation and interaction experience optimization

v1.3.8 (2026-01-26)

Commit Hash	Change	Description
`22036bb`	Shell Command History	Add shell history database and autocomplete UI
`f3ed5a4`	Optimize Query	Refine fuzzy search and pagination logic
`e0fb4be`	Code Optimization	Simplify search flow and remove redundant code
`727c8ea`	UX Enhancement	Improve Spotlight search experience
`00922e4`	Auto-sync Prompts	Daily prompts library update (GitHub Actions)
`bdad9c1`	Release 1.3.8	Version release

v1.3.8 Shell History File Changes:

src-tauri/migrations/V2__shell_history.sql              | +12  new migration
src-tauri/src/db.rs                                      | +234 database refactoring
src-tauri/src/main.rs                                    | +3   history API
src/components/features/spotlight/hooks/useSpotlightSearch.ts | +75 history search
src/components/features/spotlight/modes/search/SearchMode.tsx | +74 UI interaction
src/types/spotlight.ts                                   | +6  type definitions

Key Updates:

📜 Shell History Database: New shell_history table with command, timestamp, execution_count
🔍 Smart Autocomplete: Fuzzy search shell history with real-time suggestions
⚡ Quick Execution: Tab/Enter to autocomplete, immediate execution on confirm
🎨 Visual Distinction: Orange for execute, Indigo for history items
📊 Usage Tracking: Automatic command execution count tracking
🚀 Performance: Parallel search with query debouncing (100ms)

v1.3.7 (2026-01-25)

Commit Hash	Change	Description
`4964586`	Optimize Mirror Download	Adjust mirror priority, use Promise.any parallel requests
`560171d`	Auto-sync Prompts Library	Add daily auto-update prompts library workflow
`4964586`	Optimize Save Filename	Context save uses project_name_date format as default
`ef6267d`	Release 1.3.7	Version release

v1.3.7 Mirror Download Optimization File Changes:

src/store/usePromptStore.ts | -15 +15 mirror priority adjustment, Promise.any parallel requests

v1.3.7 Save Filename Optimization File Changes:

src/components/features/context/ContextView.tsx | +25 default filename generation logic

v1.3.7 Prompts Auto-Sync File Changes:

.github/workflows/update-prompts.yml | +105 daily auto-sync workflow
build/dist/packs/                   | renamed to commands/
build/dist/packs/commands/*.json    | restructured prompt data pack

Key Updates:

🚀 Promise.any Parallel Requests: Store download and Manifest fetch use parallel requests, first success returns
🌍 Mirror Priority Optimization: Gitee (China) -> GitHub Raw -> jsDelivr CDN
📁 Smart Default Filename: Context save auto-uses {project_name}_{date}.txt format
🔄 Prompts Auto-Sync: GitHub Actions daily auto-update awesome-chatgpt-prompts and tldr-pages
📦 Data Pack Restructure: packs directory renamed to commands, clearer classification
📄 License Update: Added NOTICES.md license declaration

v1.3.6 (2026-01-22)

Commit Hash	Change	Description
`dd1871f`	Optimize Database Migration	Introduced Refinery migration framework with legacy database patch support
`a888718`	Release 1.3.6	Version release

v1.3.6 Database Migration Optimization File Changes:

src-tauri/migrations/V1__baseline.sql | +114 baseline migration script
src-tauri/Cargo.toml                   | +3   add refinery
src-tauri/src/db.rs                    | +277 database refactoring
src/components/features/patch/PatchView.tsx | +2 adapter adjustment

Key Updates:

🗄️ Refinery Migration Framework: Introduced professional database migration management tool
🔧 Legacy Database Patches: Auto-detect and patch legacy database structures
📊 Baseline Migration V1: Unified database schema definition
🛡️ Robustness Improvement: Column existence checks, transaction protection

v1.3.5 (2026-01-21)

Commit Hash	Change	Description
`a4ca88e`	Fix BUG	Fixed issues related to 1.3.5
`dc0be15`	Add Template AI	Prompts support chat template feature
`f71510b`	Release 1.3.5	Version release

v1.3.5 Template AI Feature File Changes:

src-tauri/src/db.rs                                | +97  database field extension
src-tauri/src/main.rs                              | +2   command registration
src/SpotlightApp.tsx                               | +5   click handling
src/components/features/prompts/dialogs/PromptEditorDialog.tsx | +92  editor enhancement
src/components/features/spotlight/core/ChatCommandMenu.tsx    | +113 command menu
src/components/features/spotlight/core/SearchBar.tsx          | +257 search bar refactor
src/components/features/spotlight/core/SpotlightContext.tsx   | +31  context
src/components/features/spotlight/hooks/useSpotlightChat.ts   | +54  chat logic
src/lib/template.ts                                | +29  template engine
src/store/usePromptStore.ts                        | +15  state management
src/types/prompt.ts                                | +3   type definition

Key Updates:

🤖 Template AI: Prompts can be configured as chat templates for auto-application
💬 Command Menu: Spotlight added slash command menu (/)
🔍 Search Enhancement: Search bar refactor with more complex filtering and sorting
🎨 Editor Enhancement: Prompt editor UI optimization

v1.3.4 (2026-01-18)

Commit Hash	Change	Description
`834a1d0`	Fix BUG	Fixed multiple issues
`8f28fa8`	Release 1.3.4	Version release

Key Updates:

🐛 Bug Fixes: Fixed Spotlight chat mode issues

v1.3.3 (2026-01-18)

Commit Hash	Change	Description
`d45ae11`	Release 1.3.3	Version release
`34c32a0`	Release 1.3.2	Version release
`0476720`	Spotlight Enhancement	Added calculator, shell commands, scope search
`828d088`	i18n Improvement	Unified all hardcoded strings to getText calls
`967da22`	Performance Optimization	Static regex, loading short-circuit optimization

v1.3.3 Spotlight Enhancement File Changes:

src/types/spotlight.ts              | +12 new SearchScope and math/shell types
src/lib/calculator.ts               | +45 math expression calculator
src/components/features/spotlight/core/SpotlightContext.tsx | +8 searchScope state
src/components/features/spotlight/core/SearchBar.tsx        | +120 prefix recognition and Tag UI
src/components/features/spotlight/hooks/useSpotlightSearch.ts | +85 search logic refactor
src/components/features/spotlight/modes/search/SearchMode.tsx | +45 UI adaptation
src/lib/i18n.ts                     | +24 new i18n entries
src/SpotlightApp.tsx                | +12 click handling logic

v1.3.3 i18n Optimization File Changes:

src/App.tsx                          | +2 getText import
src/components/settings/SettingsModal.tsx | +6 getText calls
src/components/features/monitor/tabs/EnvFingerprint.tsx | +2 getText calls

v1.3.3 Performance Optimization:

src/lib/calculator.ts                | static regex, long float limit
src/components/features/spotlight/hooks/useSpotlightSearch.ts | calc/shell mode short-circuit

Key Updates:

🧮 Calculator Mode: Type =1+1, =sin(pi) for quick calculations
💻 Shell Commands: Type >ls, >dir to execute commands
📂 Scope Search: /app for apps, /cmd for commands, /pmt for prompts
🏷️ Tag Interaction: VSCode-like search scope tag UI
🌍 i18n Unification: All hardcoded strings migrated to i18n system
⚡ Performance Optimization: Regex reuse, loading state short-circuit

v1.3.1 (2026-01-18)

Commit Hash	Change	Description
`8353dfa`	Release 1.3.1	Version release
`04fff71`	Optimize Git Diff	Working Directory comparison, Rayon parallel processing, CRLF optimization
`2546dab`	Optimize Performance	Overall performance optimization

v1.3.1 Git Diff Optimization File Changes:

src-tauri/src/git.rs                           | +118 Rayon parallel processing
src/components/features/patch/PatchSidebar.tsx | +14  workspace options
src/components/features/patch/PatchView.tsx    | +11  default diff logic

Key Updates:

⚡ Parallel Processing: Rayon parallel file reading, significantly faster for large projects
🔄 Working Directory Support: Added "WORK_DIR" virtual version for unsaved changes
🪟 CRLF Optimization: Fixed Windows line ending issues
🛡️ Memory Optimization: Large file pre-checks to prevent OOM

v1.3.0 (2026-01-16)

Commit Hash	Change	Description
`aae7ac5`	Release 1.3.0	Version release
`547308a`	Add Config Memory	Context assembly configuration auto-saves to database
`1cff1eb`	Add Whitelist	Security scan supports ignoring specific secrets
`9e6a3e4`	Optimize Performance	Performance tuning
`528cf9c`	Optimize Performance	Performance optimization

v1.3.0 Config Memory File Changes:

src-tauri/src/db.rs                       | +148 database table extension
src-tauri/src/main.rs                     | +4
src/components/settings/SettingsModal.tsx | +88 settings UI enhancement
src/store/useContextStore.ts              | +39 state persistence
src/lib/i18n.ts                           | +18 i18n

v1.3.0 Whitelist Management File Changes:

src-tauri/src/db.rs                                | +93
src-tauri/src/main.rs                              | +34
src/components/features/context/ScanResultDialog.tsx | +145
src/components/settings/IgnoredSecretsManager.tsx  | +124 whitelist management UI
src/components/settings/SettingsModal.tsx          | +14
src/lib/i18n.ts                                    | +28

Key Updates:

💾 Configuration Persistence: Context assembly filters, settings auto-save
🔓 Whitelist Management: Security scan supports false positive whitelisting
📝 UI Optimization: Settings UI refactor, whitelist management as separate Tab

v1.2.5 (2026-01-14)

Commit Hash	Change	Description
`a96a00b`	Release 1.2.5	Version release
`ecafbf3`	Add Python Support	Command executor supports Python scripts
`1a33162`	Optimize Top Process	Process monitoring optimization

v1.2.5 Python Support File Changes:

src-tauri/capabilities/migrated.json               | 4 +-
src/lib/command_executor.ts                        | +145 command executor refactor
src/types/prompt.ts                                | +2

Key Updates:

🐍 Python Integration: Command executor supports Python script execution
⚙️ Command Execution Refactor: Enhanced cross-platform command execution

v1.2.4 (2026-01-12)

Commit Hash	Change	Description
`794cab3`	Release 1.2.4	Version release
`228472a`	i18n	i18n improvement
`76e346d`	Optimize UX	User experience optimization

Key Updates:

🌍 i18n Improvement: More language support
✨ UX Optimization: Interaction details refinement

v1.2.0 (2025-12-27)

Commit Hash	Change	Description
`7087b4a`	Release 1.2.0	Version release
`d9b47d9`	Optimize	Backend code optimization
`dd8045b`	Optimize	Frontend component optimization
`6fbf449`	Optimize	Performance tuning
`486466f`	Optimize	UI interaction optimization
`02cbcf9`	Optimize	State management optimization
`234e7da`	Optimize	Store optimization
`fe2002e`	Optimize	Code refactor
`9a50a93`	SQL Introduction	Refactor prompt storage, introduce SQLite database
`31fb4d5`	Optimize	SQL query optimization
`f8819bc`	Backend Optimize	Rust code optimization
`90ef62c`	Backend Optimize	Command handling optimization
`7329624`	Optimize Footprint	Reduced memory and CPU usage

v1.2.0 File Change Statistics:

src-tauri/Cargo.toml                    |   +4
src-tauri/src/db.rs                     | +307 ++++++++++++
src-tauri/src/main.rs                   |  36 +-
src/components/features/prompts/PromptView.tsx | -254 ++++++++---------
src/store/usePromptStore.ts             | -441 ++++++++++++-----------
5 files changed, 609 insertions(+), 433 deletions(-)

Key Updates:

🔄 Database Refactor: Prompt storage migrated from JSON to SQLite, improved big data performance
⚡ Performance Optimization: Overall resource usage reduced by ~20%

v1.1.7 (2025-12-26)

Commit Hash	Change	Description
`647db08`	Release 1.1.7	Version release
`cbf6f31`	Add	Feature component addition
`d0c7e6a`	Optimize	UI optimization
`b056212`	Optimize Selection Logic	Improved file tree and code block selection interaction
`8da8236`	Delete	Remove redundant code
`8ad5868`	Optimize	Code cleanup
`4f4d1b8`	Optimize	Style adjustment
`a256e8b`	Add	Scan result export feature
`379ab53`	Add	Context preview enhancement
`a4f0c5f`	Optimize	Performance optimization
`79b6556`	Add gitleaks Module	Integrated code security scanning ruleset
`06c1376`	Add Privacy Scan	Implemented sensitive information detection engine

v1.1.7 Privacy Scan Feature File Changes:

src-tauri/src/security/engine.rs      | +110 core scan engine
src-tauri/src/security/entropy.rs     | +36  entropy calculation
src-tauri/src/security/mod.rs         | +14  module export
src-tauri/src/security/rules.rs       | +70  scan rules
src-tauri/src/security/stopwords.rs   | +105 whitelist words
src/components/features/context/ContextView.tsx        | +141
src/components/features/context/ScanResultDialog.tsx   | +122
src/components/features/context/TokenDashboard.tsx     | +33
12 files changed, 619 insertions(+), 44 deletions(-)

v1.1.7 Gitleaks Security Scan Module File Changes:

src-tauri/src/gitleaks/allowlist.rs              | +55  whitelist
src-tauri/src/gitleaks/mod.rs                    | +129 module entry
src-tauri/src/gitleaks/rule.rs                   | +27  rule definition
src-tauri/src/gitleaks/rules_ai.rs               | +78  AI-related rules
src-tauri/src/gitleaks/rules_cloud.rs            | +160 cloud service rules
src-tauri/src/gitleaks/rules_communication.rs    | +147 communication rules
src-tauri/src/gitleaks/rules_package.rs          | +179 package manager rules
src-tauri/src/gitleaks/rules_payment.rs          | +125 payment rules
src-tauri/src/gitleaks/rules_remaining.rs        | +203 other rules
src-tauri/src/main.rs                            | +15
11 files changed, 1119 insertions(+), 4 deletions(-)

Key Updates:

🔒 Privacy Scan: Sensitive information detection via regex and entropy calculation
🛡️ Gitleaks Integration: Supports 8 major security rule categories:
- AI Keys (OpenAI, Anthropic, etc.)
- Cloud Service Credentials (AWS, Azure, GCP, etc.)
- Payment Gateways (Stripe, Square, PayPal, etc.)
- Communication App Keys (Slack, Discord, etc.)
- Package Manager Keys (NPM, PyPI, etc.)

v1.1.6 (2025-12-18)

Commit Hash	Change	Description
`ea31473`	Fix Build	Use vendored openssl, version bump to 1.1.6
`8c6a6da`	Fix Build	Fixed macOS universal build support

Key Updates:

Resolved OpenSSL dependency issues
Support Apple Silicon universal binary build

v1.1.5 (2025-12-18)

Commit Hash	Change	Description
`f7b51ea`	Release 1.1.5	Version release
`ce49a34`	Optimize	UI optimization
`a63ae70`	Optimize	Interaction optimization
`e4d66cb`	Optimize	Code optimization
`37049a7`	Log Optimize	Log system improvement
`cc2b8c5`	Optimize	Performance optimization
`8cc7763`	Optimize	Style adjustment
`93a8dff`	Optimize	Component optimization
`47c33ef`	Optimize	State management optimization
`431f085`	Add	Commit selector component
`ce8336f`	Optimize	Code cleanup
`747e459`	Optimize	Refactor optimization
`04dacca`	Add git diff	Integrated Git Diff visualization

v1.1.5 Git Diff Feature File Changes:

src-tauri/src/main.rs                  | +157 command registration
src/components/features/patch/CommitSelector.tsx | +128 commit selector
src/components/features/patch/DiffWorkspace.tsx  | +-28 workspace
src/components/features/patch/PatchSidebar.tsx   | +-284 sidebar
src/components/features/patch/PatchView.tsx      | +-416 main view
src/components/features/patch/patch_types.ts     | +-7  type definition
6 files changed, 686 insertions(+), 334 deletions(-)

Key Updates:

📊 Git Diff Visualization: View code differences between any two commits
🔀 Commit Selector: Dropdown to select historical commits for comparison
📦 Multiple Export Formats: Support HTML, JSON, Markdown exports

v1.1.4 (2025-12-16)

Commit Hash	Change	Description
`bddd26e`	Release 1.1.4	Version release
`8af3223`	Optimize	Code optimization
`010c2d6`	Add	Filter management feature
`9aa51b9`	Optimize	Filter logic optimization
`adb64fa`	Optimize	Context assembly optimization
`1c38713`	Optimize	Token calculation optimization
`50acca4`	Optimize	Tree structure optimization
`25dd382`	Optimize	File tree optimization
`e00dc4a`	Optimize	Interaction optimization
`d231b05`	Optimize	Search optimization
`f1fe6a3`	Optimize	Hotkey optimization
`9dabaab`	Optimize	Hotkey handling optimization
`94621d4`	Optimize	Notification system optimization

Key Updates:

🔍 File Filters: Filter by file type, size, path, etc.
📁 Context Assembly: Select specific files/directories for combination

v1.1.3 (2025-12-14)

Commit Hash	Change	Description
`696303e`	Release 1.1.3	Version release
`e8303dc`	Add	Export feature
`7303fcd`	Logo Replacement	Brand visual upgrade
`49d79cc`	Optimize Notification	Notification system refactor
`87a5ecd`	Optimize	UI optimization

v1.1.3 Logo Replacement File Changes (54 files):

images/logo.png                     | new Logo image (320KB)
src-tauri/icons/*                   | multi-size app icons
src-tauri/icons/android/*           | Android platform icons
src-tauri/icons/ios/*               | iOS platform icons

Key Updates:

🎨 Brand Upgrade: New logo design, multi-platform icon adaptation
🔔 Notification System: Support operation result notifications, error hints, progress hints

v1.1.2 (2025-12-04)

Commit Hash	Change	Description
`ba2b14a`	Release 1.1.2	Version release
`2c58cab`	Update	Version number update
`561b20a`	Update	Configuration update
`23b5bbb`	Optimize Custom Hotkey	Support custom hotkey and wake method configuration

Key Updates:

⌨️ Custom Hotkey: Support custom global wake hotkey
🎯 Wake Method: Support tray icon click, hotkey, and other wake methods

v1.1.1 (2025-12-04)

Commit Hash	Change	Description
`c92574f`	Release 1.1.1	Version release
`f61a5ff`	Optimize	Basic feature optimization
`baf2876`	Optimize	Code completion

v1.1.0 Early Version (2025-12 Early)

Commit Hash	Change	Description
`2df3e62`	Add Clock Feature	Title bar integrated real-time clock display

v1.1.0 Clock Feature File Changes:

src/components/ui/ClockPopover.tsx | +301 clock popover component
src/components/layout/TitleBar.tsx | +-24 title bar integration
src/components/settings/SettingsModal.tsx | +-68 clock config in settings
src/lib/i18n.ts                   | +-44 i18n support
14 files changed, 1177 insertions(+), 29 deletions(-)

Core Feature Evolution

1. Context Forge (File Assembly)

Version	Feature
v1.2.4	i18n improvement
v1.2.5	Python script support
v1.3.0	Configuration auto-save
v1.3.0	Whitelist management
v1.3.1	Rayon parallel processing

2. Spotlight (Global AI Terminal)

Version	Feature
Initial	Global hotkey wake (`Alt+S`)
v1.1.2	Custom hotkey configuration
v1.1.3	Notification system integration
v1.3.3	Calculator mode (`=`)
v1.3.3	Shell command execution (`>`)
v1.3.3	Scope search (`/app`, `/cmd`, `/pmt`)
v1.3.3	Tag interaction UI
v1.5.0	Refinery quick paste integration

3. Prompt Verse (Prompt Library)

Version	Feature
Initial	Basic prompt management
v1.2.0	SQLite database refactor, significant performance improvement

4. Patch Weaver (AI Completer & Git Diff)

Version	Feature
v1.1.5	Git Diff visualization
v1.1.5	Commit selector
v1.1.5	Multi-format export
v1.3.1	Working Directory comparison
v1.3.1	Rayon parallel processing
v1.3.1	CRLF line ending optimization

5. Refinery (Clipboard History)

Version	Feature
v1.5.0	Text/Image clipboard history
v1.5.0	Search, filter, pin functionality
v1.5.0	Notes support
v1.5.0	Calendar view, auto cleanup

6. Automator (Auto-Clicker)

Version	Feature
v2.0.0	Left/Right/Middle click support
v2.0.0	Configurable interval and count
v2.0.0	Fixed position or follow mouse
v2.2.0	UI Auto Tree element recognition
v2.2.0	`get_element_under_cursor` command

7. Model Miner (Content Extraction)

Version	Feature
v2.2.2	Web content extraction with Readability.js
v2.2.2	HTML to Markdown conversion
v2.2.2	Queue-based task processing
v2.2.2	Mining scope management
v2.2.5	Single-page extraction (`single_page`)
v2.2.5	Web search integration (`web_search`)
v2.2.5	Post-processing pipeline (`postprocess`)

8. Agent Tool Runtime (AI Tool Runtime)

Version	Feature
v2.2.5	ToolSpec specification + ToolCallRequest/Response models
v2.2.5	Sandbox policy engine (sandbox.rs)
v2.2.5	File system tools (list_directory/search_files/read_file)
v2.2.5	Web tools (search/extract_page)
v2.2.5	Miner tool integration
v2.2.5	Patch tools (patch_tools)
v2.2.5	Frontend Agent runtime (registry/policy/runtime)

9. Exec Runtime (Command Execution Runtime)

Version	Feature
v2.2.8	Process manager (manager.rs)
v2.2.8	Sandbox safety policy (safety.rs)
v2.2.8	Execution approval mechanism (request/approve/terminate)
v2.2.8	PowerShell argument parser
v2.2.8	Frontend ExecApprovalSheet approval UI

10. Transfer (LAN Transfer)

Version	Feature
v2.3.0	Axum HTTP server + WebSocket
v2.3.0	Auto device discovery (network interface scanning)
v2.3.0	QR code sharing (QR generation)
v2.3.0	File transfer + progress tracking
v2.3.0	Instant chat (text messages)
v2.3.0	Mobile HTML interface

11. Guard (Idle Guard)

Version	Feature
v2.2.9	Idle timeout detection (default 180s)
v2.3.0	Windows low-level keyboard/mouse hooks global interception
v2.3.0	Full-screen overlay lock screen + long-press 1.5s unlock
v2.3.0	Prevent system sleep
v2.3.0	Keep screen on

12. Peek (Standalone Preview Window)

Version	Feature
v2.2.8	Standalone Tauri preview window
v2.2.8	DOCX renderer (docx-preview)
v2.2.8	PDF renderer
v2.2.8	HTML renderer
v2.2.8	Markdown renderer (starry-night syntax highlighting)
v2.2.8	Structured text renderer

13. System Monitor (System Monitoring)

Version	Feature
v1.1.0	Title bar clock
v1.1.1	System info panel
v2.2.6	env-probe crate modularization
v2.2.8	Network speed test (M-Lab NDT7)
v2.2.9	Battery info (starship-battery)
v2.3.0	Major monitoring probe enhancement (1182 lines monitoring.rs)
v2.3.0	Disk details (HDD/SSD type, removability)
v2.3.0	Network traffic statistics (send/receive rate)
v2.3.0	Port occupancy process (Windows RestartManager)
v2.3.0	Process list (CPU/memory usage)
v2.3.0	Dashboard UI complete refactor

14. Spotlight AI Enhancement

Version	Feature
v2.2.5	Chat attachment support (chat_attachment)
v2.2.5	Agent tool calls (fs/web/miner)
v2.2.8	AI Trace timeline visualization
v2.2.8	ToolCallInlineBlock tool call inline display
v2.2.8	ExecApprovalSheet execution approval panel

Security Feature Evolution

Privacy Scan Engine (v1.1.7)

Core Components:

engine.rs: Scan engine main program
entropy.rs: Shannon entropy calculation (detect high-randomness keys)
rules.rs: Regex rule set
stopwords.rs: Whitelist words (filter false positives)
allowlist.rs: Value whitelist (UUID, Git SHA, URL, etc.)

Detection Flow:

File Content → Regex Matching → Entropy Calculation → Whitelist Filtering → Risk Level

Gitleaks Security Rules (v1.1.7)

Rule Categories:

Category	Examples
AI Keys	OpenAI API Key, Anthropic Key
Cloud Services	AWS Access Key, Azure SAS Token
Payment Gateways	Stripe, Square, PayPal
Communication Apps	Slack, Discord, Twilio
Package Managers	NPM, PyPI, RubyGems
Databases	MongoDB, PostgreSQL connection strings
Generic Keys	Generic API Key, Bearer Token

Whitelist Management (v1.3.0)

New Features:

UI-based whitelist management (IgnoredSecretsManager.tsx)
Whitelist persistence (SQLite)
Regex whitelist support

Automation

Prompt Library Auto-Sync

# GitHub Actions
Trigger: Daily or upstream update
Action: Sync awesome-chatgpt-prompts and tldr-pages
Commit: github-actions[bot]

Build & Release

Release Process

1. Feature development complete
2. Code review (GitHub PR)
3. Version update (package.json, Cargo.toml)
4. GitHub Actions auto-build
5. Generate installer

Current Build Status

Platform	Install Size	Memory
Windows	~10 MB	~30-50 MB

Directory Structure

ctxrun/
├── src/                          # React frontend source
│   ├── windows/                # Multi-window entry (v2.3.0+)
│   │   ├── main/              # Main window (MainWindowApp)
│   │   ├── spotlight/         # Spotlight window (SpotlightWindowApp)
│   │   ├── peek/              # Preview window (PeekWindowApp)
│   │   └── guard/             # Lock screen window (GuardWindowApp)
│   ├── components/                # UI components
│   │   ├── features/            # Feature components
│   │   │   ├── automator/       # Auto-clicker
│   │   │   ├── context/         # Context assembly
│   │   │   ├── miner/           # Content mining (v2.2.2+)
│   │   │   ├── monitor/         # System monitoring
│   │   │   ├── patch/           # Code diff
│   │   │   ├── prompts/         # Prompt management
│   │   │   ├── refinery/        # Clipboard history (v1.5.0+)
│   │   │   ├── spotlight/       # Spotlight global terminal
│   │   │   │   ├── exec/        # Execution management (v2.2.8+)
│   │   │   │   └── trace/       # AI Trace visualization (v2.2.8+)
│   │   │   └── transfer/        # LAN transfer (v2.3.0+)
│   │   ├── hyperview/           # File preview renderers (v1.3.9+)
│   │   │   └── renderers/       # DOCX/PDF/HTML/Markdown/Structured text
│   │   ├── layout/             # Layout components
│   │   │   └── ViewSwitcher.tsx # Radial navigation (v2.2.7+)
│   │   ├── settings/           # Settings UI (v2.2.6+ refactored to independent pages)
│   │   │   └── sections/       # AI/General/Security/Data maintenance/Search workspace
│   │   └── ui/                # Base UI
│   ├── i18n/                    # Internationalization (v2.3.0 migrated to JSON)
│   │   ├── config.ts           # i18n configuration
│   │   └── locales/            # JSON translation files
│   │       ├── zh.json         # Chinese (879 lines)
│   │       └── en.json         # English (879 lines)
│   ├── lib/                     # Utilities
│   │   ├── agent/              # Agent tool system (v2.2.5+)
│   │   │   ├── runtime.ts      # Agent runtime
│   │   │   ├── policy.ts       # Tool policy
│   │   │   ├── registry.ts     # Tool registry
│   │   │   └── tools/          # fs.ts / web.ts
│   │   ├── exec/               # Command execution client (v2.2.8+)
│   │   ├── markdown/           # Markdown enhancement (starry-night)
│   │   └── hooks/              # Cross-window state sync, etc.
│   ├── store/                   # Zustand state management
│   └── types/                   # TypeScript types
├── src-tauri/                    # Rust backend
│   ├── crates/                   # Multi-crates architecture (v2.0.0+)
│   │   ├── automator/           # Auto-clicker module
│   │   ├── browser-utils/       # Browser utilities (v2.2.5+)
│   │   ├── context/             # Context processing module
│   │   ├── db/                  # Database module
│   │   ├── env-probe/           # Environment probe (v2.2.6 migrated from src/)
│   │   ├── exec-runtime/        # Command execution runtime (v2.2.8+)
│   │   ├── git/                 # Git operations module
│   │   ├── hyperview/           # File preview (v2.2.6 migrated from src/)
│   │   ├── miner/               # Content mining module (v2.2.2+)
│   │   ├── process-utils/       # Process utilities (v2.2.8+)
│   │   ├── refinery/            # Refinery module
│   │   ├── tool-runtime/        # AI tool runtime (v2.2.5+)
│   │   ├── transfer/            # LAN transfer (v2.3.0+)
│   │   └── workspace-tests/     # Integration tests (v2.2.6+)
│   ├── src/                     # Main entry
│   │   ├── guard.rs             # Idle guard (v2.3.0+)
│   │   ├── peek.rs              # Preview window backend (v2.2.8+)
│   │   ├── fs_commands.rs       # File operation commands
│   │   ├── tray_support.rs      # Tray support (v2.3.0+)
│   │   ├── app_config.rs        # App configuration (v2.2.8+)
│   │   └── main.rs             # Entry point
│   └── Cargo.toml
├── build/dist/                   # Pre-built resources
│   └── commands/                 # Prompt/command data packs
└── models/                       # LLM model configurations

Document last updated: 2026-04-07 Compiled based on git commit history and code diff analysis

FilesExpand file tree

DEV_EN.md

Latest commit

History

DEV_EN.md

File metadata and controls

CtxRun Development Documentation

Project Overview

Tech Stack

Version History

v2.3.0 (2026-04-04) Transfer + Guard + Multi-window Architecture

v2.2.9 (2026-04-01) System Monitor Enhancement

v2.2.8 (2026-03-28) Exec Runtime + Peek Window

v2.2.7 (2026-03-17) Radial Menu Navigation

v2.2.6 (2026-03-12) Crate Modularization + Settings Refactor

v2.2.5 (2026-03-05) Agent Tool Runtime

v2.2.4 (2026-02-25)

v2.2.3 (2026-02-24)

v2.2.2 (2026-02-21) ⛏️ Model Miner

v2.2.1 (2026-02-17)

v2.2.1 (2026-02-17)

v2.2.0 (2026-02-16) 🌍 i18n + 🖱️ UI Auto Tree

v2.1.1 (2026-02-14)

v2.1.1 (2026-02-14)

v2.1.0 (2026-02-14)

v2.0.4 (2026-02-12)

v2.0.0 (2026-02-11)

v1.5.5 (2026-02-07)

v1.5.4 (2026-02-06)

v1.5.3 (2026-02-05)

v1.5.2 (2026-02-04)

v1.5.1 (2026-02-02)

v1.5.0 (2026-01-30)

v1.4.1 (2026-01-29)

v1.4.0 (2026-01-28)

v1.3.9 (2026-01-28)

v1.3.8 (2026-01-26)

v1.3.7 (2026-01-25)

v1.3.6 (2026-01-22)

v1.3.5 (2026-01-21)

v1.3.4 (2026-01-18)

v1.3.3 (2026-01-18)

v1.3.1 (2026-01-18)

v1.3.0 (2026-01-16)

v1.2.5 (2026-01-14)

v1.2.4 (2026-01-12)

v1.2.0 (2025-12-27)

v1.1.7 (2025-12-26)

v1.1.6 (2025-12-18)

v1.1.5 (2025-12-18)

v1.1.4 (2025-12-16)

v1.1.3 (2025-12-14)

v1.1.2 (2025-12-04)

v1.1.1 (2025-12-04)

v1.1.0 Early Version (2025-12 Early)

Core Feature Evolution

1. Context Forge (File Assembly)

2. Spotlight (Global AI Terminal)

3. Prompt Verse (Prompt Library)

4. Patch Weaver (AI Completer & Git Diff)

5. Refinery (Clipboard History)

6. Automator (Auto-Clicker)

7. Model Miner (Content Extraction)

8. Agent Tool Runtime (AI Tool Runtime)

9. Exec Runtime (Command Execution Runtime)

10. Transfer (LAN Transfer)

11. Guard (Idle Guard)

12. Peek (Standalone Preview Window)

13. System Monitor (System Monitoring)

14. Spotlight AI Enhancement

Security Feature Evolution

Privacy Scan Engine (v1.1.7)

Gitleaks Security Rules (v1.1.7)

Whitelist Management (v1.3.0)

Automation

Prompt Library Auto-Sync

Build & Release

Release Process

Current Build Status

Directory Structure