LocalHub — Time Machine for Code

Preview release: this Marketplace build is marked as Preview while the lightweight Control Center auto-download flow is being finalized.

Automatic local file versioning. No Git commands, no commits — everything in the background.

LocalHub is a complete "Time Machine" for your code. Every significant action automatically creates a file snapshot. Branches, groups, diff navigator, AI analytics, plugins, cloud sync, global file monitoring — all out of the box.

🌐 Website: standaloneaistorm.com

Preview Build

Preview means the Marketplace package is intentionally lightweight and ships without the heavy bundled Control Center runtime.
All core LocalHub functionality stays inside the extension: snapshots, file history, TM groups, branches, diff tools, AI features, Global Watcher bridge, MCP, CLI, plugins, and UI panels.
LocalHub Control Center / tray runtime is downloaded automatically on first launch from the public release repository.

Control Center Auto-Download

The extension checks for the Control Center runtime on first launch.
If it is missing, LocalHub downloads localhub-tray-runtime-win32-x64.zip automatically and unpacks it into the LocalHub runtime cache.
You do not need to install the tray runtime manually for normal use of the Marketplace build.

Storm Code Companion

For the full AI workflow, voice control, and companion IDE integration, install Storm Code separately: Storm_Code.-PUBLIC
LocalHub works on its own, but Storm Code unlocks the broader AI-driven workflow around LocalHub.

Screenshots

LocalHub Sidebar — File History, TM Groups, Branches
LocalHub Sidebar: File History, TM Groups, Branches — all inside VS Code

LocalHub Global Watcher
Global Watcher: 18,439 snapshots across 10 monitored folders, 235MB stored

All Screenshots Gallery

Preview Build
Control Center Auto-Download
Storm Code Companion
Features
Shadow Sandboxes
Universal MCP
Installation
Quick Start
LocalHub — Functionality
Smart Features — AI Analytics
Visualizations
Global Watcher — Global Monitoring
Panels and Interface
Settings
Hotkeys
CLI
Technologies
Author

Features

Core

Automatic Snapshots — 7 smart triggers (save, tab switch, editing, focus loss, idle, external changes, deletion)
Deduplication — identical content stored once (SHA-256 hashing)
Branches — parallel versioning lines with merge, cherry-pick, export/import
Zombie Branches — full control over deleted branches and commits with recovery capability
Change Groups — commit analogue with auto-tagging and AI description generation
Group Tag Search — manual assignment of custom text tags with quick search
Diff Navigator — interactive change review with Accept/Reject for each block
Rejected Blocks Trash — saving all rejected code pieces for later recovery
Blame — who and when changed each line (like git blame)
Bisect — binary search for bug version (like git bisect)
Surgical Management — remove any file from branch or commit via UI

Monitoring

Global Watcher — background OS-level file monitoring, works even without IDE
Seamless Symbiosis — automatic data transfer between global watcher and local hub
Cloud Synchronization — Google Drive, OneDrive, Dropbox, Yandex Disk or custom API
Backup — centralized backup with rotation

AI and Analytics

8 Smart Analyzers — predictions, heatmap, refactoring, change velocity, dependencies, clusters, analytics
Agent Diary — automatic logging of AI agent actions
Storm Code Integration — automatic commits based on AI agent responses
Trash Protection — AI cannot delete files from trash

Visualizations

3D Grid — three-dimensional project visualization
Time Machine — time travel through project states
Code Replay — coding session playback as video
Branch Tree — visual branch tree
Group Change Trees — change visualization for entire file groups (accordion and classic modes)
Dependency Graph — interactive file relationship graph (Nexus Vision)
Symbol Timeline — function and class timeline

Extensibility

Plugin System — install, enable/disable, configure, marketplace
CLI — command line for terminal work
Built-in LH Console — full terminal inside the program
150+ API Endpoints — full programmatic access to all functionality
Shadow Sandboxes — isolated working copies for AI and human review: create/status/diff/checkout/return/merge/destroy
Universal MCP — standard project-level .vscode/mcp.json bootstrap for MCP clients

Installation

Requirements

VS Code 1.85+ or any VS Code-based IDE
Python 3.9+ with pip

From VSIX

# Download .vsix file
code --install-extension localhub-time-machine-3.0.3-win32-x64-IslamChomaev-autotray.vsix --force

From Source (Development)

git clone <repo>
cd localhub-vscode
npm install
npm run compile
# F5 to run in debug mode

Python dependencies are installed automatically on first run.

Quick Start

Open project in VS Code
On first launch, LocalHub auto-downloads the Control Center runtime if it is not bundled locally
Start working — snapshots are created automatically
LocalHub sidebar shows history, files, groups, branches
Ctrl+Alt+S — manual snapshot
Ctrl+Alt+H — show all features
Ctrl+Alt+L — open built-in LH console

LocalHub — Functionality

Automatic Snapshots

7 smart triggers automatically create file snapshots:

Trigger	Description
File Save	Ctrl+S or autosave → snapshot `auto:save`
Tab Switch	Snapshot of old file (`tab_switch`) and new (`tab_focus`)
File Open	Explorer click → `explorer_click`
Text Editing	After 2 sec pause → detailed reason: `added:"code"`, `deleted:15chars`, `replaced:"text"`
Focus Loss	IDE minimize → snapshot of open file
Idle	Configurable idle interval (default 5 min)
External Changes	AI agents, terminal, other editors → `external:change`

Each snapshot records detailed reason — shows not just "file changed", but what exactly happened.

File History

Complete history of all versions in sidebar
History search with filters (file, date, reason, branch)
Starred Files — version fixation with star for complete deletion protection
Context Jump — jump from starred version directly to corresponding TM group
Stars show TM group binding — can see entire project state at that moment
Version description editing
Delete unnecessary versions

Recovery

Full Recovery — rollback file to any version in one click
Partial Recovery — select specific blocks for recovery
Diff — compare any version with current file
Safety snapshot automatically created before recovery

Change Groups (TM Groups)

Groups are commit analogues. Set of related changes confirmed together.

Group Confirmation — collect accumulated changes into group
Smart Confirm — smart confirmation with automatic analysis
AI Description Generation — automatic summary creation via AI
Auto-tagging — 15+ tag types: new-function, bugfix, refactor, api-change, ui-change, ai-generated etc.
Manual Tags — assign custom text tags for each group
Tag Search — quick search by automatic and manual tags
Tag Filtering — find groups by change type
Re-tagging — recalculate tags for all groups

LHL Mode — Auto-grouping

Automatic group creation without manual confirmation:

By Timeout — group created after N minutes of inactivity (default 10 min)
By Count — group created after N saves (default 10)
Name Template — {count}, {time}, {date}, {files} for name generation

Branches

Parallel versioning lines, like in Git:

Branch Creation — fork from current state
Switching — instant switch between branches
Merge — branch merging with conflict detection
Selective Merge — choose which files to merge
Smart Merge — smart merge with preview
Cherry-Pick — select individual changes from another branch
Export/Import — export branch to ZIP and import back
Stash — postpone current changes and return later

Zombie Branches and Zombie Commits

Full control over deleted data:

Zombie Branches — deleted branches don't disappear, but become "zombies"
Branch Recovery — restore any deleted branch in one click
Zombie Commits — deleted commit groups saved in special trash
Group Recovery — restore entire commit group with all files
Commit Deletion — ability to delete commits with content preservation or complete destruction
Deletion History — complete log of all deletions with rollback capability

Tree Diff — Change Visualization

Advanced diff visualization with semantic analysis:

Version Chain — v1 → v2 → v3 → ... → vN in one view
Group Change Trees — unique change visualization for entire file group
Accordion Mode — compact view with click expansion
Classic View — traditional change tree with beautiful design
Semantic Analysis — shows "function getUser() added", not just "lines 15-20"
Language Support — Python, JavaScript, TypeScript, Go, Rust, Java, C#, PHP, Ruby
10 Icon Themes — Vivid, Minimal, Neon, Pastel, Earth, Aurora, Sunset, Ocean, Candy, Matrix
Configurable Context — number of lines around changes (0-20)
Modes — Collapsed, Step-by-step Chain, Summary

Diff Navigator — Interactive Review

Navigator for step-by-step change review (like code review in Git):

Navigation — ◀ Previous / ▶ Next block
Accept/Reject — accept or reject each change block
Apply Decisions — surgical application of selected blocks only
Rejected Trash — all rejected blocks saved for later recovery
Hotkeys in editor panel

Rejected Blocks Trash

Unique system for saving rejected code:

Auto-save — all rejected blocks automatically go to trash
Categorization — blocks grouped by files and review sessions
Recovery — any rejected block can be restored
Search — quick search by rejected block content
Rejection History — full log with date, time and context
Retention Period — configurable period (default 30 days)

Blame and Bisect

Git-like analysis tools:

Blame — for each file line: which version appeared, when, why
Bisect — binary search for bug version:
1. Specify "version X is good, version Y is bad"
2. System shows middle version
3. You check — repeat until finding exact version

Surgical File Management

Direct file management via visual interface:

Remove from Branch — kick any file from branch via context menu
Remove from Commit — remove file from already created commit
Instant Exclusion Transfer — send file to .localhubignore directly from UI
Stop Tracking — file stops being tracked, but history preserved
Mass Operations — select multiple files for group actions
Visual Mode — all operations available via drag & drop

Deleted Files (Trash)

All deleted files saved to trash
View deleted file history
Restore one file or all at once
Configurable retention period (default 30 days)
Trash cleanup

Backup

Centralized Backup — copy snapshots to separate folder (external drive, NAS, cloud)
Rotation — automatic deletion of backups older than N days
Restore from Backup — complete project restoration

GitHub Synchronization

Upload project to GitHub via Personal Access Token
Clone from GitHub
Auto-sync on group confirmation
SSH Push for advanced users
Sync branch configuration

Universal Git Remote

Add named project-local git remotes without changing GitHub sync
Supports HTTPS, SSH, scp-style URLs, file://, local paths, and UNC paths
Separate push command and separate UI button
Stores remotes only in .localhub/config.json

Git Integration

Auto Git Commit — automatic git commit on TM Group confirmation
Auto Push — automatic git push after commit
Configurable Prefix for commit messages

Storm Code Integration

Automatic commits based on AI agent work:

Response Tracking — system monitors agent responses in Storm Code
Trigger Words — "Done", "Completed", "Finished", "Ready"
Auto-commit — automatically creates commit when trigger detected
AI Description — agent response used as official commit description
Task Linking — commit automatically linked to task in Storm Code
Agent History — all agent commits available in separate panel

Built-in LH Console

Full terminal inside the program:

Quick Access — Ctrl+Alt+L to open console
All LH Commands — available without lh prefix
Auto-completion — intelligent hints for commands and files
Command History — navigation with up/down arrows
Color Highlighting — syntax highlighting for output
UI Integration — command results displayed in panels
Macros — create custom command aliases

Plugins

Extensible plugin system:

Install plugins from folder or marketplace
Enable/disable without deletion
Configure each plugin via UI
Update checking
Plugins react to events (file save, group confirmation, etc.)

Agent Diary — AI Log

Automatic logging of AI agent actions:

Record all saves, commits, branch operations
Terminal command logging
Diary files in .localhub/agent/ — readable Markdown
Next AI agent can use diary as "memory"
Configurable log rotation

AI Deletion Protection

AI agents cannot clear trash, delete files from trash or erase history
Only user via UI can perform destructive operations
Log of all deletion attempts

Smart Features — AI Analytics

8 smart analyzers based on change history:

Analyzer	Description
Predictive Suggestions	Predict files you'll likely change
Timeline View	Visual project change timeline
Activity Heatmap	Heatmap — which files change most often
Refactoring Hints	Refactoring recommendations based on change patterns
Change Velocity	Change speed over time — when project develops faster
Dependency Overlay	Dependency analysis — static imports vs. co-changes
Smart Clusters	Automatic detection of logical file groups
Analytics Dashboard	Overall project health statistics

Show All Features Command Center

Ctrl+Alt+H opens the fullscreen feature hub. The current command center exposes 13 connected tools:

Tool	Surface
Predictive Suggestions	Features panel
Timeline View	Features panel
Activity Heatmap	Features panel
Refactoring Hints	Features panel
Change Velocity	Features panel
Dependency Overlay	Features panel
Smart Clusters	Features panel
Analytics Dashboard	Features panel
Relationships	Full graph workspace
3D Grid	3D workspace
Time Machine	Time Travel suite
Code Replay	Time Travel suite
Branch Tree	Time Travel suite

Visualizations

Visualization	Description
3D Grid	Three-dimensional project structure visualization
Time Machine	Time travel — view project state at any moment
Code Replay	Coding session playback as accelerated video
Branch Tree	Visual branch tree with hierarchy and history
Dependency Graph	Interactive file relationship graph (co-changes)
Nexus Vision	Advanced graph with clusters, filters and animation
Symbol Timeline	Function and class timeline
Group Trees	Change visualization for entire file group

Global Watcher — Global Monitoring

Global Watcher — separate system for OS-level file monitoring. Works independently of VS Code — files tracked while daemon runs.

Features

Monitor Any Folders — not just open project, but any computer folders
IDE Independence — works while daemon process runs
Global and Local Folders — global visible from any project, local only from current
150+ Default Exclusions — node_modules, .git, pycache, etc.
Support .localhubignore — own file ignore system in each folder
Seamless Symbiosis — automatic transfer of current picture to local hub when editor opens

History and Recovery

Complete version history for each tracked file
View, diff, restore any version
Track deleted files
Configurable storage (days, max versions)

Cloud Synchronization

Folder Mode — sync via Google Drive, OneDrive, Dropbox, Yandex Disk (auto-detect)
API Mode — sync via HTTP API
Instant or Periodic synchronization
Status and progress in panel

Project Export

Export folder to ZIP with latest file versions
Optional — with complete history (all versions)

Management

Three daemon process management levels:

Level	Description	Buttons
Main Daemon	Entire Python process	Start, Stop, Restart
LocalHub Daemon	Project server	Start, Stop, Restart
Global Watcher	Monitoring module	Start, Stop, Restart

Settings Panel

5 tabs in full panel:

Overview — statistics, daemon status
Folders — manage watched folders (global + local)
History — files, versions, recovery, deleted files
Cloud Sync — cloud synchronization (service setup, sync now)
Settings — debounce, exclusions, rotation, backup

Panels and Interface

Panel	Description
File History	All versions of selected file with star marks
Tracked Files	All files with history in project
Pending Changes	Ungrouped changes
TM Groups	Confirmed groups with tags and search
Branches	Versioning branches
Zombie Branches	Deleted branches trash
Zombie Commits	Deleted commits trash
Rejected Blocks	Rejected code blocks trash
Deleted Files	Trash — deleted files
Dashboard	Project statistics and metrics
Relationships	File relationship graph
Smart Features	AI analyzers

Panel	Description
Overview	Status, statistics, daemon management
Watch Folders	List of monitored folders

Built-in Console

Element	Description
Command Line	Input field with auto-completion
Output	Colored result output
History	Executed command history
Macros	List of saved macros

Settings Panel (11 tabs)

Tab	Content
General	Main settings, LHL mode, ignore, daemon management
Global Watcher	Enable GW, folders, storage parameters, symbiosis
Backup	Centralized backup, trash
Git Sync	Automatic git commit/push
GitHub	Token, repo, auto-sync
Storm Code	AI agent integration, trigger words
Console	Built-in console settings, macros
Advanced	Python path, port, marketplace, Agent Diary
Tree Diff	Icon theme, semantic analysis, context, modes
Plugins	Plugin management
About	About, statistics

Settings

General

Setting	Default	Description
`localhub.enabled`	`true`	Enable LocalHub
`localhub.autoSave`	`true`	Automatic snapshots
`localhub.debounceMs`	`2000`	Delay before snapshot (ms)
`localhub.maxVersionsPerFile`	`100`	Max versions per file
`localhub.idleCheckpointMinutes`	`5`	Idle snapshot (0 = off)

LHL Mode

Setting	Default	Description
`localhub.lhlMode`	`false`	Auto-grouping
`localhub.lhl.timeoutMinutes`	`10`	Inactivity timeout
`localhub.lhl.threshold`	`10`	Count threshold
`localhub.lhl.namePattern`	—	Group name template

Global Watcher

Setting	Default	Description
`localhub.enableGlobalWatcher`	`true`	Enable global monitoring
`localhub.globalWatchPaths`	`[]`	Global folders
`localhub.localWatchPaths`	`[]`	Local folders
`localhub.excludePatterns`	150+ items	Exclusion patterns
`localhub.seamlessSync`	`true`	Seamless symbiosis with local hub

Backup and Trash

Setting	Default	Description
`localhub.backup.enabled`	`true`	Central backup
`localhub.backup.centralPath`	—	Backup folder
`localhub.backup.retentionDays`	`30`	Backup rotation (0 = forever)
`localhub.trash.retentionDays`	`30`	Deleted files retention
`localhub.zombies.retentionDays`	`90`	Zombie branches and commits retention
`localhub.rejected.retentionDays`	`30`	Rejected blocks retention

Storm Code Integration

Setting	Default	Description
`localhub.stormCode.enabled`	`false`	Enable integration
`localhub.stormCode.triggers`	`["Done", "Completed", "Ready"]`	Trigger words
`localhub.stormCode.autoCommit`	`true`	Automatic commits
`localhub.stormCode.useAgentResponse`	`true`	Use response as description

Built-in Console

Setting	Default	Description
`localhub.console.enabled`	`true`	Enable console
`localhub.console.historySize`	`1000`	Command history size
`localhub.console.autoComplete`	`true`	Auto-completion
`localhub.console.colorOutput`	`true`	Colored output

GitHub

Setting	Default	Description
`localhub.github.enabled`	`false`	Enable GitHub sync
`localhub.github.token`	—	Personal Access Token
`localhub.github.owner`	—	Username
`localhub.github.repo`	—	Repository
`localhub.github.branch`	`main`	Branch
`localhub.github.syncOnConfirm`	`false`	Auto-sync on confirmation

Git

Setting	Default	Description
`localhub.git.syncOnConfirm`	`false`	Auto git commit
`localhub.git.autoPush`	`false`	Auto git push
`localhub.git.commitPrefix`	—	Commit prefix

Tree Diff

Setting	Default	Description
`localhub.treeDiff.semanticAnalysis`	`true`	Semantic code analysis
`localhub.treeDiff.contextLines`	`3`	Context lines (0-20)
`localhub.treeDiff.reviewMode`	`true`	Accept/Reject buttons
`localhub.treeDiff.groupMode`	`accordion`	Group mode (accordion/classic)
`localhub.icons.theme`	`vivid`	Icon theme (10 options)

Advanced

Setting	Default	Description
`localhub.pythonPath`	`python`	Python path
`localhub.serverPort`	`19876`	Server port
`localhub.agentDiary.enabled`	`true`	AI agent diary
`localhub.marketplaceUrl`	—	Plugin marketplace URL
`localhub.customTags`	`[]`	List of custom tags

Hotkeys

Combination	Action
`Ctrl+Alt+H`	Show all features
`Ctrl+Alt+S`	Create snapshot
`Ctrl+Alt+B`	Create branch
`Ctrl+Alt+T`	Show trash
`Ctrl+Alt+Shift+T`	Show branch trash
`Ctrl+Alt+Shift+G`	Show TM group trash
`Ctrl+Alt+Shift+R`	Show rejected blocks trash
`Ctrl+Alt+R`	Show backups
`Ctrl+Alt+Shift+R`	Restore from backup
`Ctrl+Alt+L`	Open built-in console
`Ctrl+Alt+X`	Surgical file removal
`Ctrl+Alt+I`	Add file to exclusions

CLI

Command line for terminal work (installed in ~/bin/lh.py):

lh status          # Project status
lh log [file]      # Project/file history
lh diff <file>     # Diff with last version
lh restore <file>  # Restore file
lh branch          # Branch list
lh branch trash    # Deleted branch trash
lh group           # TM group list
lh group trash     # Deleted TM group trash
lh rejected        # Rejected blocks trash
lh surgery <file>  # Surgical file removal
lh ignore <file>   # Add file to exclusions
lh tag <group>     # Add tag to group
lh search <tag>    # Search by tags
lh push            # Push to GitHub
lh remote add origin https://host/user/repo.git
lh remote list
lh remote push [name] [branch]

Built-in Console

All commands also available in built-in console without lh prefix:

status             # Project status
log [file]         # History
diff <file>        # Compare
restore <file>     # Recovery
# ... and all other commands

Technologies

Component	Technology
IDE Extension	TypeScript, VS Code Extension API
Server	Python, FastAPI, Uvicorn
Database	SQLite
File Storage	Content-addressable storage (SHA-256)
File Monitoring	watchdog (Python) + VS Code FileSystemWatcher
Graph Visualization	Cytoscape.js
3D Visualization	Three.js
Built-in Console	xterm.js + node-pty
IDE Support	VS Code and any VS Code-based IDE

Author

Islam Dev

"Every change is a save point. Never lose your code."




# LocalHub — Time Machine for Code

**Автоматическое локальное версионирование файлов. Без Git команд, без коммитов — всё в фоне.**

LocalHub — это полноценная "Машина Времени" для вашего кода. Каждое значимое действие автоматически создаёт снимок файла. Ветки, группы, diff-навигатор, AI-аналитика, плагины, облачный синк, глобальный мониторинг файлов — всё из коробки.

![Version](https://img.shields.io/badge/version-3.0.1-blue)
![VS Code](https://img.shields.io/badge/VS%20Code-1.85%2B-blue)
![Standalone IDE](https://img.shields.io/badge/Standalone%20IDE-supported-purple)
![Python](https://img.shields.io/badge/Python-3.9%2B-green)

---


## Скриншоты

<p align="center">
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/screenshot-sidebar.png" width="100%" alt="LocalHub Sidebar" />
  <br/><em>Сайдбар LocalHub: История файлов, TM Группы, Ветки — прямо внутри VS Code</em>
</p>

<p align="center">
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/screenshot-watcher.png" width="100%" alt="LocalHub Global Watcher" />
  <br/><em>Global Watcher: 18,439 снимков кода, 10 папок на мониторинге, 235MB</em>
</p>

### Галерея всех скриншотов

<div align="center">
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_214846.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_214918.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215006.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215015.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215041.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215100.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215137.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215157.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215209.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215215.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215220.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215226.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215233.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215238.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215248.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215304.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215310.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215317.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215347.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215358.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215406.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_215436.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_222318.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_222339.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_222349.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_222354.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_222444.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_222449.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_223436.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_223634.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_223657.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_223742.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_223819.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_223826.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_224056.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_224123.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_224146.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_224736.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_224758.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_225013.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_225034.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_225101.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_225209.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_225229.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_225242.png" width="80%" style="margin-bottom: 20px;" />
  <img src="https://github.com/adamgold1/local-hub-vscode-extansthion-public-/raw/HEAD/assets/WindowSnip_20260329_225453.png" width="80%" style="margin-bottom: 20px;" />
</div>

## Оглавление

- [Возможности](#возможности)
- [Shadow Sandboxes](https://github.com/adamgold1/local-hub-vscode-extansthion-public-/blob/HEAD/docs/SHADOW_SANDBOXES.md)
- [Universal MCP](https://github.com/adamgold1/local-hub-vscode-extansthion-public-/blob/HEAD/docs/UNIVERSAL_MCP.md)
- [Установка](#установка)
- [Быстрый старт](#быстрый-старт)
- [LocalHub — Функционал](#localhub--функционал)
  - [Автоматические снимки](#автоматические-снимки)
  - [История файлов](#история-файлов)
  - [Восстановление](#восстановление)
  - [Группы изменений (TM Groups)](#группы-изменений-tm-groups)
  - [LHL Mode — Автогруппировка](#lhl-mode--автогруппировка)
  - [Ветки](#ветки)
  - [Зомби-ветки и Зомби-коммиты](#зомби-ветки-и-зомби-коммиты)
  - [Tree Diff — Визуализация изменений](#tree-diff--визуализация-изменений)
  - [Diff Navigator — Интерактивный обзор](#diff-navigator--интерактивный-обзор)
  - [Корзина отклоненных блоков](#корзина-отклоненных-блоков)
  - [Blame и Bisect](#blame-и-bisect)
  - [Хирургическое управление файлами](#хирургическое-управление-файлами)
  - [Удалённые файлы (Корзина)](#удалённые-файлы-корзина)
  - [Резервное копирование](#резервное-копирование)
  - [GitHub синхронизация](#github-синхронизация)
  - [Git интеграция](#git-интеграция)
  - [Storm Code интеграция](#storm-code-интеграция)
  - [Встроенная консоль LH](#встроенная-консоль-lh)
  - [Плагины](#плагины)
  - [Agent Diary — Дневник AI](#agent-diary--дневник-ai)
  - [Защита от AI удаления](#защита-от-ai-удаления)
- [Smart Features — AI-аналитика](#smart-features--ai-аналитика)
- [Визуализации](#визуализации)
- [Global Watcher — Глобальный мониторинг](#global-watcher--глобальный-мониторинг)
- [Панели и интерфейс](#панели-и-интерфейс)
- [Настройки](#настройки)
- [Горячие клавиши](#горячие-клавиши)
- [CLI](#cli)
- [Технологии](#технологии)
- [Автор](#автор)

---

## Возможности

### Ядро
- **Автоматические снимки** — 7 умных триггеров (сохранение, переключение табов, редактирование, потеря фокуса, idle, внешние изменения, удаление)
- **Дедупликация** — одинаковый контент хранится один раз (SHA-256 хэширование)
- **Ветки** — параллельные линии версионирования с merge, cherry-pick, export/import
- **Зомби-ветки** — полный контроль над удалёнными ветками и коммитами с возможностью восстановления
- **Группы изменений** — аналог коммитов с автотегированием и AI-генерацией описаний
- **Поиск по тегам групп** — ручное присвоение собственных текстовых тегов с быстрым поиском
- **Diff-навигатор** — интерактивный обзор изменений с Accept/Reject на каждый блок
- **Корзина отклоненных блоков** — сохранение всех rejected кусков кода для последующего восстановления
- **Blame** — кто и когда изменил каждую строку (как `git blame`)
- **Bisect** — бинарный поиск версии с багом (как `git bisect`)
- **Хирургическое управление** — удаление любого файла из ветки или коммита через UI

### Мониторинг
- **Global Watcher** — фоновый мониторинг файлов на уровне ОС, работает даже без IDE
- **Бесшовный симбиоз** — автоматическая передача данных между глобальным наблюдателем и локальным хабом
- **Облачная синхронизация** — Google Drive, OneDrive, Dropbox, Yandex Disk или свой API
- **Резервное копирование** — централизованный бэкап с ротацией

### AI и аналитика
- **8 умных анализаторов** — предсказания, тепловая карта, рефакторинг, скорость изменений, зависимости, кластеры, аналитика
- **Agent Diary** — автологирование действий AI агентов
- **Storm Code интеграция** — автоматические коммиты на основе ответов AI агентов
- **Защита корзины** — AI не может удалить файлы из корзины

### Визуализации
- **3D Grid** — трёхмерная визуализация проекта
- **Time Machine** — путешествие во времени по состояниям проекта
- **Code Replay** — воспроизведение сессии кодирования как видео
- **Branch Tree** — визуальное дерево веток
- **Групповые деревья изменений** — визуализация правок для всей группы файлов (режимы "гармошка" и классический)
- **Граф зависимостей** — интерактивный граф связей файлов (Nexus Vision)
- **Symbol Timeline** — временная линия функций и классов

### Расширяемость
- **Система плагинов** — установка, включение/отключение, конфигурация, маркетплейс
- **CLI** — командная строка для работы из терминала
- **Встроенная консоль LH** — полноценный терминал внутри программы
- **150+ API эндпоинтов** — полный программный доступ ко всему функционалу
- **Shadow Sandboxes** — изолированные рабочие копии для AI и human review: create/status/diff/checkout/return/merge/destroy
- **Universal MCP** — стандартный project-level `.vscode/mcp.json` bootstrap для MCP-клиентов

---

## Установка

### Требования
- **VS Code** 1.85+ или любая IDE на базе VS Code
- **Python** 3.9+ с pip

### Из VSIX
```bash
# Скачать .vsix файл
code --install-extension localhub-3.0.1.vsix --force

Из исходников (разработка)

git clone <repo>
cd localhub-vscode
npm install
npm run compile
# F5 для запуска в debug режиме

Python зависимости устанавливаются автоматически при первом запуске.

Быстрый старт

Откройте проект в VS Code
LocalHub автоматически запустит daemon-сервер
Начните работать — снимки создаются автоматически
Боковая панель LocalHub показывает историю, файлы, группы, ветки
Ctrl+Alt+S — ручной снимок
Ctrl+Alt+H — показать все возможности
Ctrl+Alt+L — открыть встроенную консоль LH

LocalHub — Функционал

Автоматические снимки

7 умных триггеров автоматически создают снимки файлов:

Триггер	Описание
Сохранение файла	Ctrl+S или автосохранение → снимок `auto:save`
Переключение табов	Снимок старого файла (`tab_switch`) и нового (`tab_focus`)
Открытие файла	Клик в проводнике → `explorer_click`
Редактирование текста	Через 2 сек после паузы → детальная причина: `added:"код"`, `deleted:15chars`, `replaced:"текст"`
Потеря фокуса	Сворачивание IDE → снимок открытого файла
Idle	Настраиваемый интервал бездействия (по умолчанию 5 мин)
Внешние изменения	AI агенты, терминал, другие редакторы → `external:change`

Каждый снимок записывает детальную причину — видно не просто "файл изменился", а что именно произошло.

История файлов

Полная история всех версий в боковой панели
Поиск по истории с фильтрами (файл, дата, причина, ветка)
Звёздные файлы — фиксация версии звёздочкой с полной защитой от удаления
Контекстный прыжок — переход из звёздной версии напрямую в соответствующую TM группу
Звёздочки показывают привязку к TM группе — можно увидеть состояние всего проекта на тот момент
Редактирование описания версии
Удаление ненужных версий

Восстановление

Полное восстановление — откат файла на любую версию в один клик
Частичное восстановление (Partial Restore) — выбрать конкретные блоки для восстановления
Diff — сравнение любой версии с текущим файлом
Перед восстановлением автоматически создаётся страховочный снимок

Группы изменений (TM Groups)

Группы — это аналог коммитов. Набор связанных изменений, подтверждённых вместе.

Подтверждение группы — собрать накопленные изменения в группу
Smart Confirm — умное подтверждение с автоматическим анализом
AI-генерация описания — автоматическое создание summary через AI
Автотегирование — 15+ типов тегов: new-function, bugfix, refactor, api-change, ui-change, ai-generated и др.
Ручные теги — присвоение собственных текстовых тегов для каждой группы
Поиск по тегам — быстрый поиск групп по автоматическим и ручным тегам
Фильтрация по тегам — поиск групп по типу изменений
Перетегирование — пересчитать теги для всех групп

LHL Mode — Автогруппировка

Автоматическое создание групп без ручного подтверждения:

По таймауту — группа создаётся после N минут бездействия (по умолчанию 10 мин)
По количеству — группа создаётся после N сохранений (по умолчанию 10)
Шаблон имени — {count}, {time}, {date}, {files} для генерации имён

Ветки

Параллельные линии версионирования, как в Git:

Создание ветки — ответвление от текущего состояния
Переключение — мгновенный switch между ветками
Merge — слияние веток с обнаружением конфликтов
Selective Merge — выбрать какие файлы сливать
Smart Merge — умное слияние с предпросмотром
Cherry-Pick — выбрать отдельные изменения из другой ветки
Export/Import — экспорт ветки в ZIP и импорт обратно
Stash — отложить текущие изменения и вернуть позже

Зомби-ветки и Зомби-коммиты

Полный контроль над удалёнными данными:

Зомби-ветки — удалённые ветки не исчезают, а переходят в состояние "зомби"
Восстановление веток — возможность восстановить любую удалённую ветку в один клик
Зомби-коммиты — удалённые группы коммитов сохраняются в специальной корзине
Восстановление групп — восстановление целой группы коммитов со всеми файлами
Удаление коммитов — возможность удалять коммиты с сохранением содержимого или полным уничтожением
История удалений — полный лог всех удалений с возможностью отката

Tree Diff — Визуализация изменений

Продвинутая визуализация diff-ов с семантическим анализом:

Цепочка версий — v1 → v2 → v3 → ... → vN в одном виде
Групповые деревья изменений — уникальная визуализация правок для всей группы файлов
Режим "гармошка" — компактный вид с разворачиванием по клику
Классический вид — традиционное дерево изменений с красивым оформлением
Семантический анализ — показывает "добавлена функция getUser()", а не просто "строки 15-20"
Поддержка языков — Python, JavaScript, TypeScript, Go, Rust, Java, C#, PHP, Ruby
10 тем иконок — Vivid, Minimal, Neon, Pastel, Earth, Aurora, Sunset, Ocean, Candy, Matrix
Настраиваемый контекст — количество строк вокруг изменений (0-20)
Режимы — Collapsed, Step-by-step Chain, Summary

Diff Navigator — Интерактивный обзор

Навигатор для пошагового обзора изменений (как code review в Git):

Навигация — ◀ Предыдущий / ▶ Следующий блок
Accept/Reject — принять или отклонить каждый блок изменений
Применить решения — хирургическое применение только выбранных блоков
Корзина отклоненных — все rejected блоки сохраняются для последующего восстановления
Горячие клавиши в панели редактора

Корзина отклоненных блоков

Уникальная система сохранения отклонённого кода:

Автосохранение — все rejected блоки автоматически попадают в корзину
Категоризация — блоки группируются по файлам и сессиям review
Восстановление — любой отклонённый блок можно вернуть обратно
Поиск — быстрый поиск по содержимому отклонённых блоков
История отклонений — полный лог с датой, временем и контекстом
Срок хранения — настраиваемый период (по умолчанию 30 дней)

Blame и Bisect

Git-подобные инструменты для анализа:

Blame — для каждой строки файла: в какой версии появилась, когда, почему
Bisect — бинарный поиск версии с багом:
1. Указываете "версия X хорошая, версия Y плохая"
2. Система показывает версию посередине
3. Вы проверяете — повторяете до нахождения точной версии

Хирургическое управление файлами

Прямое управление файлами через визуальный интерфейс:

Удаление из ветки — выкинуть любой файл из ветки через контекстное меню
Удаление из коммита — убрать файл из уже созданного коммита
Мгновенный перенос в исключения — отправка файла в .localhubignore прямо из UI
Остановка отслеживания — файл перестаёт отслеживаться, но история сохраняется
Массовые операции — выбор нескольких файлов для групповых действий
Визуальный режим — все операции доступны через drag & drop

Удалённые файлы (Корзина)

Все удалённые файлы сохраняются в корзину
Просмотр истории удалённого файла
Восстановление одного файла или всех сразу
Настраиваемый срок хранения (по умолчанию 30 дней)
Очистка корзины

Резервное копирование

Централизованный бэкап — копирование снимков в отдельную папку (внешний диск, NAS, облако)
Ротация — автоматическое удаление бэкапов старше N дней
Восстановление из бэкапа — полное восстановление проекта

GitHub синхронизация

Загрузка проекта на GitHub через Personal Access Token
Клонирование из GitHub
Автосинк при подтверждении группы
SSH Push для продвинутых пользователей
Настройка ветки для синхронизации

Universal Git Remote

Именованные project-local git remote без изменения GitHub-синка
Поддержка HTTPS, SSH, scp-style URL, file://, локальных путей и UNC
Отдельная команда push и отдельная кнопка в UI
Хранение только в .localhub/config.json

Git интеграция

Auto Git Commit — автоматический git commit при подтверждении TM Group
Auto Push — автоматический git push после коммита
Настраиваемый префикс для commit-сообщений

Storm Code интеграция

Автоматические коммиты на основе работы AI агентов:

Отслеживание ответов — система мониторит ответы агентов в Storm Code
Триггерные слова — «Готово», «Сделал», «Выполнено», «Done», «Completed»
Автокоммит — при обнаружении триггера автоматически создаётся коммит
AI описание — ответ агента используется как официальное описание коммита
Связка с задачами — коммит автоматически привязывается к задаче в Storm Code
История агента — все коммиты агента доступны в отдельной панели

Встроенная консоль LH

Полноценный терминал внутри программы:

Быстрый доступ — Ctrl+Alt+L для открытия консоли
Все команды LH — доступны без префикса lh
Автодополнение — интеллектуальные подсказки для команд и файлов
История команд — навигация стрелками вверх/вниз
Цветовая подсветка — syntax highlighting для вывода
Интеграция с UI — результаты команд отображаются в панелях
Макросы — создание собственных команд-алиасов

Плагины

Расширяемая система плагинов:

Установка плагинов из папки или маркетплейса
Включение/отключение без удаления
Конфигурация каждого плагина через UI
Проверка обновлений
Плагины реагируют на события (сохранение файла, подтверждение группы и др.)

Agent Diary — Дневник AI

Автоматическое логирование действий AI агентов:

Запись всех сохранений, коммитов, операций с ветками
Логирование команд терминала
Файлы дневника в .localhub/agent/ — читаемый Markdown
Следующий AI агент может использовать дневник как "память"
Настраиваемая ротация логов

Защита от AI удаления

AI агенты не могут очистить корзину, удалить файлы из корзины или стереть историю
Только пользователь через UI может выполнять деструктивные операции
Лог всех попыток удаления

Smart Features — AI-аналитика

8 умных анализаторов на основе истории изменений:

Анализатор	Описание
Predictive Suggestions	Предсказание файлов, которые вы скорее всего будете менять
Timeline View	Визуальная временная линия изменений проекта
Activity Heatmap	Тепловая карта — какие файлы меняются чаще всего
Refactoring Hints	Рекомендации по рефакторингу на основе паттернов изменений
Change Velocity	Скорость изменений во времени — когда проект развивается быстрее
Dependency Overlay	Анализ зависимостей — статические импорты vs. co-changes
Smart Clusters	Автоматическое обнаружение логических групп файлов
Analytics Dashboard	Общая статистика здоровья проекта

Show All Features Command Center

Ctrl+Alt+H открывает полноэкранный центр возможностей. Сейчас в нём 13 связанных инструментов:

Инструмент	Где открывается
Predictive Suggestions	Панель Features
Timeline View	Панель Features
Activity Heatmap	Панель Features
Refactoring Hints	Панель Features
Change Velocity	Панель Features
Dependency Overlay	Панель Features
Smart Clusters	Панель Features
Analytics Dashboard	Панель Features
Relationships	Полноэкранный граф связей
3D Grid	3D workspace
Time Machine	Набор Time Travel
Code Replay	Набор Time Travel
Branch Tree	Набор Time Travel

Визуализации

Визуализация	Описание
3D Grid	Трёхмерная визуализация структуры проекта
Time Machine	Путешествие во времени — просмотр состояния проекта в любой момент
Code Replay	Воспроизведение сессии кодирования как ускоренное видео
Branch Tree	Визуальное дерево веток с иерархией и историей
Граф зависимостей	Интерактивный граф связей файлов (co-changes)
Nexus Vision	Продвинутый граф с кластерами, фильтрами и анимацией
Symbol Timeline	Временная линия функций и классов
Групповые деревья	Визуализация изменений для всей группы файлов

Nexus Vision 3D внутри 3D Grid

3D Grid теперь работает в двух ритмах:

Classic — старый космический режим: формы, физика, палитры, скорость, zoom, explode/implode.
Nexus 3D — режим смыслового слоя поверх той же сцены: файл перестаёт быть просто шаром и начинает показывать состояние LocalHub и живые сигналы редактора.

Что показывает Nexus 3D:

Синий цвет и контур — файл сейчас находится в Pending Changes.
Золотой halo — у файла есть звёздная, защищённая версия.
Жёлтый → оранжевый → красный heat — файл часто меняется в истории проекта.
Красная аура — у файла есть live error из диагностики редактора.
Warnings выводятся в правой панели и badge-ами, без отдельной тяжёлой ауры на сцене.

Что открывается по клику:

путь файла;
статус LocalHub;
краткая архитектура файла: symbols, classes, functions, methods;
список ошибок и предупреждений;
Open File, Rescan, прыжок на конкретную строку проблемы.

Источник данных здесь честный и локальный:

мир собирается из tracked files, pending, starred, heatmap и графа связей;
symbols берутся через DocumentSymbolProvider;
diagnostics идут из VS Code / LSP;
если live symbols молчат, используется последняя snapshot metadata из истории LocalHub.

Global Watcher — Глобальный мониторинг

Global Watcher — отдельная система для мониторинга файлов на уровне ОС. Работает независимо от VS Code — пока запущен daemon, файлы отслеживаются.

Возможности

Мониторинг любых папок — не только открытый проект, а любые папки на компьютере
Независимость от IDE — работает пока запущен daemon-процесс
Глобальные и локальные папки — глобальные видны из любого проекта, локальные — только из текущего
150+ исключений по умолчанию — node_modules, .git, pycache, и др.
Поддержка .localhubignore — своя система игнорирования файлов в каждой папке
Бесшовный симбиоз — автоматическая передача актуальной картины в локальный хаб при открытии редактора

История и восстановление

Полная история версий для каждого отслеживаемого файла
Просмотр, diff, восстановление любой версии
Отслеживание удалённых файлов
Настраиваемое хранение (дни, макс. версий)

Облачная синхронизация

Папочный режим — синхронизация через Google Drive, OneDrive, Dropbox, Yandex Disk (автоопределение)
API режим — синхронизация через HTTP API
Мгновенная или периодическая синхронизация
Статус и прогресс в панели

Экспорт проектов

Экспорт папки в ZIP с последними версиями файлов
Опционально — с полной историей (все версии)

Управление

Три уровня управления daemon-процессами:

Уровень	Описание	Кнопки
Main Daemon	Весь Python процесс	Start, Stop, Restart
LocalHub Daemon	Сервер проектов	Start, Stop, Restart
Global Watcher	Модуль мониторинга	Start, Stop, Restart

Панель настроек

5 вкладок в полной панели:

Overview — статистика, статус daemon-ов
Folders — управление наблюдаемыми папками (глобальные + локальные)
History — файлы, версии, восстановление, удалённые файлы
Cloud Sync — облачная синхронизация (настройка сервиса, sync now)
Settings — debounce, исключения, ротация, бэкап

Панели и интерфейс

Боковая панель LocalHub (11 секций)

Панель	Описание
File History	Все версии выбранного файла со звёздными отметками
Tracked Files	Все файлы с историей в проекте
Pending Changes	Несгруппированные изменения
TM Groups	Подтверждённые группы с тегами и поиском
Branches	Ветки версионирования
Zombie Branches	Корзина удалённых веток
Zombie Commits	Корзина удалённых коммитов
Rejected Blocks	Корзина отклонённых блоков кода
Deleted Files	Корзина — удалённые файлы
Dashboard	Статистика и метрики проекта
Relationships	Граф связей файлов
Smart Features	AI-анализаторы

Боковая панель Global Watcher

Панель	Описание
Overview	Статус, статистика, управление daemon-ами
Watch Folders	Список папок для мониторинга

Встроенная консоль

Элемент	Описание
Command Line	Поле ввода с автодополнением
Output	Цветной вывод результатов
History	История выполненных команд
Macros	Список сохранённых макросов

Панель настроек (11 вкладок)

Вкладка	Содержимое
General	Основные настройки, LHL mode, игнорирование, управление daemon
Global Watcher	Включение GW, папки, параметры хранения, симбиоз
Backup	Централизованный бэкап, корзина
Git Sync	Автоматический git commit/push
GitHub	Token, repo, auto-sync
Storm Code	Интеграция с AI агентами, триггерные слова
Console	Настройки встроенной консоли, макросы
Advanced	Python path, порт, маркетплейс, Agent Diary
Tree Diff	Тема иконок, семантический анализ, контекст, режимы
Plugins	Управление плагинами
About	О программе, статистика

Настройки

Основные

Настройка	По умолчанию	Описание
`localhub.enabled`	`true`	Включить LocalHub
`localhub.autoSave`	`true`	Автоматические снимки
`localhub.debounceMs`	`2000`	Задержка перед снимком (мс)
`localhub.maxVersionsPerFile`	`100`	Макс. версий на файл
`localhub.idleCheckpointMinutes`	`5`	Снимок при бездействии (0 = откл.)

LHL Mode

Настройка	По умолчанию	Описание
`localhub.lhlMode`	`false`	Автогруппировка
`localhub.lhl.timeoutMinutes`	`10`	Таймаут бездействия
`localhub.lhl.threshold`	`10`	Порог по количеству
`localhub.lhl.namePattern`	—	Шаблон имени группы

Global Watcher

Настройка	По умолчанию	Описание
`localhub.enableGlobalWatcher`	`true`	Включить глобальный мониторинг
`localhub.globalWatchPaths`	`[]`	Глобальные папки
`localhub.localWatchPaths`	`[]`	Локальные папки
`localhub.excludePatterns`	150+ шт.	Паттерны для исключения
`localhub.seamlessSync`	`true`	Бесшовный симбиоз с локальным хабом

Бэкап и корзины

Настройка	По умолчанию	Описание
`localhub.backup.enabled`	`true`	Центральный бэкап
`localhub.backup.centralPath`	—	Папка бэкапа
`localhub.backup.retentionDays`	`30`	Ротация бэкапов (0 = вечно)
`localhub.trash.retentionDays`	`30`	Хранение удалённых файлов
`localhub.zombies.retentionDays`	`90`	Хранение зомби-веток и коммитов
`localhub.rejected.retentionDays`	`30`	Хранение отклонённых блоков

Storm Code интеграция

Настройка	По умолчанию	Описание
`localhub.stormCode.enabled`	`false`	Включить интеграцию
`localhub.stormCode.triggers`	`["Готово", "Сделал", "Done"]`	Триггерные слова
`localhub.stormCode.autoCommit`	`true`	Автоматические коммиты
`localhub.stormCode.useAgentResponse`	`true`	Использовать ответ как описание

Встроенная консоль

Настройка	По умолчанию	Описание
`localhub.console.enabled`	`true`	Включить консоль
`localhub.console.historySize`	`1000`	Размер истории команд
`localhub.console.autoComplete`	`true`	Автодополнение
`localhub.console.colorOutput`	`true`	Цветной вывод

GitHub

Настройка	По умолчанию	Описание
`localhub.github.enabled`	`false`	Включить GitHub синк
`localhub.github.token`	—	Personal Access Token
`localhub.github.owner`	—	Username
`localhub.github.repo`	—	Repository
`localhub.github.branch`	`main`	Ветка
`localhub.github.syncOnConfirm`	`false`	Авто-синк при подтверждении

Git

Настройка	По умолчанию	Описание
`localhub.git.syncOnConfirm`	`false`	Auto git commit
`localhub.git.autoPush`	`false`	Auto git push
`localhub.git.commitPrefix`	—	Префикс для коммитов

Tree Diff

Настройка	По умолчанию	Описание
`localhub.treeDiff.semanticAnalysis`	`true`	Семантический анализ кода
`localhub.treeDiff.contextLines`	`3`	Строки контекста (0-20)
`localhub.treeDiff.reviewMode`	`true`	Accept/Reject кнопки
`localhub.treeDiff.groupMode`	`accordion`	Режим для групп (accordion/classic)
`localhub.icons.theme`	`vivid`	Тема иконок (10 вариантов)

Продвинутые

Настройка	По умолчанию	Описание
`localhub.pythonPath`	`python`	Путь до Python
`localhub.serverPort`	`19876`	Порт сервера
`localhub.agentDiary.enabled`	`true`	Дневник AI агента
`localhub.marketplaceUrl`	—	URL маркетплейса плагинов
`localhub.customTags`	`[]`	Список пользовательских тегов

Горячие клавиши

Комбинация	Действие
`Ctrl+Alt+H`	Показать все возможности
`Ctrl+Alt+S`	Создать снимок
`Ctrl+Alt+B`	Создать ветку
`Ctrl+Alt+T`	Показать корзину
`Ctrl+Alt+Shift+T`	Показать корзину веток
`Ctrl+Alt+Shift+G`	Показать корзину TM групп
`Ctrl+Alt+Shift+R`	Показать корзину отклонённых блоков
`Ctrl+Alt+R`	Показать бэкапы
`Ctrl+Alt+Shift+R`	Восстановить из бэкапа
`Ctrl+Alt+L`	Открыть встроенную консоль
`Ctrl+Alt+X`	Хирургическое удаление файла
`Ctrl+Alt+I`	Добавить файл в исключения

CLI

Командная строка для работы из терминала (устанавливается в ~/bin/lh.py):

lh status          # Статус проекта
lh log [file]      # История проекта/файла
lh diff <file>     # Diff с последней версией
lh restore <file>  # Восстановить файл
lh branch          # Список веток
lh branch trash    # Корзина удалённых веток
lh group           # Список TM групп
lh group trash     # Корзина удалённых TM групп
lh rejected        # Корзина отклонённых блоков
lh surgery <file>  # Хирургическое удаление файла
lh ignore <file>   # Добавить файл в исключения
lh tag <group>     # Добавить тег к группе
lh search <tag>    # Поиск по тегам
lh push            # Push на GitHub
lh remote add origin https://host/user/repo.git
lh remote list
lh remote push [name] [branch]

Встроенная консоль

Все команды доступны также во встроенной консоли без префикса lh:

status             # Статус проекта
log [file]         # История
diff <file>        # Сравнение
restore <file>     # Восстановление
# ... и все остальные команды

Технологии

Компонент	Технология
IDE расширение	TypeScript, VS Code Extension API
Сервер	Python, FastAPI, Uvicorn
База данных	SQLite
Хранилище файлов	Content-addressable storage (SHA-256)
Файловый мониторинг	watchdog (Python) + VS Code FileSystemWatcher
Граф визуализация	Cytoscape.js
3D визуализация	Three.js
Встроенная консоль	xterm.js + node-pty
Поддержка IDE	VS Code и любые IDE на базе VS Code

Автор

Islam Dev

"Каждое изменение — это точка сохранения. Никогда не теряй свой код."

# LocalHub — 代码时光机

**自动本地文件版本控制。无需Git命令，无需提交 — 一切都在后台运行。**

LocalHub 是您代码的完整"时光机"。每个重要操作都会自动创建文件快照。分支、组、差异导航器、AI分析、插件、云同步、全局文件监控 — 开箱即用。

![Version](https://img.shields.io/badge/version-3.0.1-blue)
![VS Code](https://img.shields.io/badge/VS%20Code-1.85%2B-blue)
![Standalone IDE](https://img.shields.io/badge/Standalone%20IDE-supported-purple)
![Python](https://img.shields.io/badge/Python-3.9%2B-green)

---

## 目录

- [功能特性](#功能特性)
- [Shadow Sandboxes](https://github.com/adamgold1/local-hub-vscode-extansthion-public-/blob/HEAD/docs/SHADOW_SANDBOXES.md)
- [Universal MCP](https://github.com/adamgold1/local-hub-vscode-extansthion-public-/blob/HEAD/docs/UNIVERSAL_MCP.md)
- [安装](#安装)
- [快速开始](#快速开始)
- [LocalHub — 功能](#localhub--功能)
  - [自动快照](#自动快照)
  - [文件历史](#文件历史)
  - [恢复](#恢复)
  - [更改组 (TM Groups)](#更改组-tm-groups)
  - [LHL模式 — 自动分组](#lhl模式--自动分组)
  - [分支](#分支)
  - [僵尸分支和僵尸提交](#僵尸分支和僵尸提交)
  - [树形差异 — 更改可视化](#树形差异--更改可视化)
  - [差异导航器 — 交互式审查](#差异导航器--交互式审查)
  - [拒绝块回收站](#拒绝块回收站)
  - [Blame和Bisect](#blame和bisect)
  - [文件精确管理](#文件精确管理)
  - [已删除文件（回收站）](#已删除文件回收站)
  - [备份](#备份)
  - [GitHub同步](#github同步)
  - [Git集成](#git集成)
  - [Storm Code集成](#storm-code集成)
  - [内置LH控制台](#内置lh控制台)
  - [插件](#插件)
  - [Agent Diary — AI日志](#agent-diary--ai日志)
  - [AI删除保护](#ai删除保护)
- [智能功能 — AI分析](#智能功能--ai分析)
- [可视化](#可视化)
- [Global Watcher — 全局监控](#global-watcher--全局监控)
- [面板和界面](#面板和界面)
- [设置](#设置)
- [快捷键](#快捷键)
- [CLI](#cli)
- [技术](#技术)
- [作者](#作者)

---

## 功能特性

### 核心
- **自动快照** — 7个智能触发器（保存、标签切换、编辑、失去焦点、空闲、外部更改、删除）
- **去重** — 相同内容只存储一次（SHA-256哈希）
- **分支** — 并行版本线，支持合并、cherry-pick、导出/导入
- **僵尸分支** — 完全控制已删除的分支和提交，可恢复
- **更改组** — 类似提交的概念，带自动标签和AI描述生成
- **组标签搜索** — 手动分配自定义文本标签，快速搜索
- **差异导航器** — 交互式更改审查，每个块都有接受/拒绝
- **拒绝块回收站** — 保存所有拒绝的代码片段以供后续恢复
- **Blame** — 谁在何时更改了每一行（类似`git blame`）
- **Bisect** — 二分搜索错误版本（类似`git bisect`）
- **精确管理** — 通过UI从分支或提交中删除任何文件

### 监控
- **Global Watcher** — 后台操作系统级文件监控，即使没有IDE也能工作
- **无缝共生** — 全局观察器和本地中心之间的自动数据传输
- **云同步** — Google Drive、OneDrive、Dropbox、Yandex Disk或自定义API
- **备份** — 带轮换的集中备份

### AI和分析
- **8个智能分析器** — 预测、热图、重构、更改速度、依赖关系、集群、分析
- **Agent Diary** — 自动记录AI代理操作
- **Storm Code集成** — 基于AI代理响应的自动提交
- **回收站保护** — AI无法从回收站删除文件

### 可视化
- **3D网格** — 三维项目可视化
- **时光机** — 穿越项目状态的时间旅行
- **代码回放** — 作为视频播放编码会话
- **分支树** — 可视化分支树
- **组更改树** — 整个文件组的更改可视化（手风琴和经典模式）
- **依赖图** — 交互式文件关系图（Nexus Vision）
- **符号时间线** — 函数和类的时间线

### 可扩展性
- **插件系统** — 安装、启用/禁用、配置、市场
- **CLI** — 终端工作的命令行
- **内置LH控制台** — 程序内的完整终端
- **150+ API端点** — 对所有功能的完全程序访问
- **Shadow Sandboxes** — 用于AI和人工审查的隔离工作副本：create/status/diff/checkout/return/merge/destroy
- **Universal MCP** — MCP客户端的标准项目级`.vscode/mcp.json`引导

[继续完整的中文文档...]

# LocalHub — कोड के लिए टाइम मशीन

**स्वचालित स्थानीय फ़ाइल संस्करण। कोई Git कमांड नहीं, कोई कमिट नहीं — सब कुछ बैकग्राउंड में।**

LocalHub आपके कोड के लिए एक पूर्ण "टाइम मशीन" है। हर महत्वपूर्ण क्रिया स्वचालित रूप से फ़ाइल स्नैपशॉट बनाती है। शाखाएं, समूह, डिफ नेविगेटर, AI एनालिटिक्स, प्लगइन्स, क्लाउड सिंक, वैश्विक फ़ाइल मॉनिटरिंग — सब कुछ बॉक्स से बाहर।

![Version](https://img.shields.io/badge/version-3.0.1-blue)
![VS Code](https://img.shields.io/badge/VS%20Code-1.85%2B-blue)
![Standalone IDE](https://img.shields.io/badge/Standalone%20IDE-supported-purple)
![Python](https://img.shields.io/badge/Python-3.9%2B-green)

---

## विषय-सूची

- [विशेषताएं](#विशेषताएं)
- [Shadow Sandboxes](https://github.com/adamgold1/local-hub-vscode-extansthion-public-/blob/HEAD/docs/SHADOW_SANDBOXES.md)
- [Universal MCP](https://github.com/adamgold1/local-hub-vscode-extansthion-public-/blob/HEAD/docs/UNIVERSAL_MCP.md)
- [स्थापना](#स्थापना)
- [त्वरित शुरुआत](#त्वरित-शुरुआत)
- [LocalHub — कार्यक्षमता](#localhub--कार्यक्षमता)
  - [स्वचालित स्नैपशॉट](#स्वचालित-स्नैपशॉट)
  - [फ़ाइल इतिहास](#फाइल-इतिहास)
  - [पुनर्प्राप्ति](#पुनर्प्राप्ति)
  - [परिवर्तन समूह (TM Groups)](#परिवर्तन-समूह-tm-groups)
  - [LHL मोड — ऑटो-समूहीकरण](#lhl-मोड--ऑटो-समूहीकरण)
  - [शाखाएं](#शाखाएं)
  - [ज़ोंबी शाखाएं और ज़ोंबी कमिट](#जोंबी-शाखाएं-और-जोंबी-कमिट)
  - [ट्री डिफ — परिवर्तन विज़ुअलाइज़ेशन](#ट्री-डिफ--परिवर्तन-विजुअलाइजेशन)
  - [डिफ नेविगेटर — इंटरैक्टिव समीक्षा](#डिफ-नेविगेटर--इंटरैक्टिव-समीक्षा)
  - [अस्वीकृत ब्लॉक ट्रैश](#अस्वीकृत-ब्लॉक-ट्रैश)
  - [Blame और Bisect](#blame-और-bisect)
  - [सर्जिकल फ़ाइल प्रबंधन](#सर्जिकल-फाइल-प्रबंधन)
  - [हटाई गई फ़ाइलें (ट्रैश)](#हटाई-गई-फाइलें-ट्रैश)
  - [बैकअप](#बैकअप)
  - [GitHub सिंक्रोनाइज़ेशन](#github-सिंक्रोनाइजेशन)
  - [Git एकीकरण](#git-एकीकरण)
  - [Storm Code एकीकरण](#storm-code-एकीकरण)
  - [बिल्ट-इन LH कंसोल](#बिल्ट-इन-lh-कंसोल)
  - [प्लगइन्स](#प्लगइन्स)
  - [Agent Diary — AI लॉग](#agent-diary--ai-लॉग)
  - [AI डिलीशन सुरक्षा](#ai-डिलीशन-सुरक्षा)
- [स्मार्ट फीचर्स — AI एनालिटिक्स](#स्मार्ट-फीचर्स--ai-एनालिटिक्स)
- [विज़ुअलाइज़ेशन](#विजुअलाइजेशन)
- [Global Watcher — वैश्विक मॉनिटरिंग](#global-watcher--वैश्विक-मॉनिटरिंग)
- [पैनल और इंटरफ़ेस](#पैनल-और-इंटरफेस)
- [सेटिंग्स](#सेटिंग्स)
- [हॉटकी](#हॉटकी)
- [CLI](#cli)
- [प्रौद्योगिकी](#प्रौद्योगिकी)
- [लेखक](#लेखक)

[पूर्ण हिंदी दस्तावेज़ जारी...]

# LocalHub — Máquina del Tiempo para Código

**Versionado automático local de archivos. Sin comandos Git, sin commits — todo en segundo plano.**

LocalHub es una "Máquina del Tiempo" completa para tu código. Cada acción significativa crea automáticamente una instantánea del archivo. Ramas, grupos, navegador de diferencias, análisis de IA, plugins, sincronización en la nube, monitoreo global de archivos — todo listo para usar.

![Version](https://img.shields.io/badge/version-3.0.1-blue)
![VS Code](https://img.shields.io/badge/VS%20Code-1.85%2B-blue)
![Standalone IDE](https://img.shields.io/badge/Standalone%20IDE-supported-purple)
![Python](https://img.shields.io/badge/Python-3.9%2B-green)

---

## Tabla de Contenidos

- [Características](#características)
- [Shadow Sandboxes](https://github.com/adamgold1/local-hub-vscode-extansthion-public-/blob/HEAD/docs/SHADOW_SANDBOXES.md)
- [Universal MCP](https://github.com/adamgold1/local-hub-vscode-extansthion-public-/blob/HEAD/docs/UNIVERSAL_MCP.md)
- [Instalación](#instalación)
- [Inicio Rápido](#inicio-rápido)
- [LocalHub — Funcionalidad](#localhub--funcionalidad)
  - [Instantáneas Automáticas](#instantáneas-automáticas)
  - [Historial de Archivos](#historial-de-archivos)
  - [Recuperación](#recuperación)
  - [Grupos de Cambios (TM Groups)](#grupos-de-cambios-tm-groups)
  - [Modo LHL — Auto-agrupación](#modo-lhl--auto-agrupación)
  - [Ramas](#ramas)
  - [Ramas Zombi y Commits Zombi](#ramas-zombi-y-commits-zombi)
  - [Tree Diff — Visualización de Cambios](#tree-diff--visualización-de-cambios)
  - [Navegador Diff — Revisión Interactiva](#navegador-diff--revisión-interactiva)
  - [Papelera de Bloques Rechazados](#papelera-de-bloques-rechazados)
  - [Blame y Bisect](#blame-y-bisect)
  - [Gestión Quirúrgica de Archivos](#gestión-quirúrgica-de-archivos)
  - [Archivos Eliminados (Papelera)](#archivos-eliminados-papelera)
  - [Copia de Seguridad](#copia-de-seguridad)
  - [Sincronización GitHub](#sincronización-github)
  - [Integración Git](#integración-git)
  - [Integración Storm Code](#integración-storm-code)
  - [Consola LH Integrada](#consola-lh-integrada)
  - [Plugins](#plugins)
  - [Agent Diary — Registro IA](#agent-diary--registro-ia)
  - [Protección contra Eliminación IA](#protección-contra-eliminación-ia)
- [Características Inteligentes — Análisis IA](#características-inteligentes--análisis-ia)
- [Visualizaciones](#visualizaciones)
- [Global Watcher — Monitoreo Global](#global-watcher--monitoreo-global)
- [Paneles e Interfaz](#paneles-e-interfaz)
- [Configuración](#configuración)
- [Teclas Rápidas](#teclas-rápidas)
- [CLI](#cli)
- [Tecnologías](#tecnologías)
- [Autor](#autor)

---

## Características

### Núcleo
- **Instantáneas Automáticas** — 7 disparadores inteligentes (guardar, cambio de pestaña, edición, pérdida de foco, inactividad, cambios externos, eliminación)
- **Deduplicación** — contenido idéntico almacenado una vez (hash SHA-256)
- **Ramas** — líneas de versionado paralelas con merge, cherry-pick, exportar/importar
- **Ramas Zombi** — control total sobre ramas y commits eliminados con capacidad de recuperación
- **Grupos de Cambios** — análogo a commits con auto-etiquetado y generación de descripción IA
- **Búsqueda por Etiquetas de Grupo** — asignación manual de etiquetas de texto personalizadas con búsqueda rápida
- **Navegador Diff** — revisión interactiva de cambios con Aceptar/Rechazar para cada bloque
- **Papelera de Bloques Rechazados** — guardado de todos los fragmentos de código rechazados para recuperación posterior
- **Blame** — quién y cuándo cambió cada línea (como `git blame`)
- **Bisect** — búsqueda binaria de versión con error (como `git bisect`)
- **Gestión Quirúrgica** — eliminar cualquier archivo de rama o commit vía UI

[Documentación completa en español continúa...]

# LocalHub — آلة الزمن للكود

**إصدارات الملفات المحلية التلقائية. بدون أوامر Git، بدون commits — كل شيء في الخلفية.**

LocalHub هو "آلة زمن" كاملة لكودك. كل إجراء مهم ينشئ تلقائياً لقطة للملف. الفروع، المجموعات، متصفح الفروقات، تحليلات الذكاء الاصطناعي، الإضافات، المزامنة السحابية، مراقبة الملفات العالمية — كل شيء جاهز للاستخدام.

![Version](https://img.shields.io/badge/version-3.0.1-blue)
![VS Code](https://img.shields.io/badge/VS%20Code-1.85%2B-blue)
![Standalone IDE](https://img.shields.io/badge/Standalone%20IDE-supported-purple)
![Python](https://img.shields.io/badge/Python-3.9%2B-green)

<div dir="rtl">

## جدول المحتويات

- [المميزات](#المميزات)
- [Shadow Sandboxes](https://github.com/adamgold1/local-hub-vscode-extansthion-public-/blob/HEAD/docs/SHADOW_SANDBOXES.md)
- [Universal MCP](https://github.com/adamgold1/local-hub-vscode-extansthion-public-/blob/HEAD/docs/UNIVERSAL_MCP.md)
- [التثبيت](#التثبيت)
- [البداية السريعة](#البداية-السريعة)
- [LocalHub — الوظائف](#localhub--الوظائف)
  - [اللقطات التلقائية](#اللقطات-التلقائية)
  - [تاريخ الملفات](#تاريخ-الملفات)
  - [الاستعادة](#الاستعادة)
  - [مجموعات التغييرات (TM Groups)](#مجموعات-التغييرات-tm-groups)
  - [وضع LHL — التجميع التلقائي](#وضع-lhl--التجميع-التلقائي)
  - [الفروع](#الفروع)
  - [الفروع الزومبي والـ Commits الزومبي](#الفروع-الزومبي-والـ-commits-الزومبي)
  - [Tree Diff — تصور التغييرات](#tree-diff--تصور-التغييرات)
  - [متصفح الفروقات — المراجعة التفاعلية](#متصفح-الفروقات--المراجعة-التفاعلية)
  - [سلة المهملات للكتل المرفوضة](#سلة-المهملات-للكتل-المرفوضة)
  - [Blame و Bisect](#blame-و-bisect)
  - [إدارة الملفات الجراحية](#إدارة-الملفات-الجراحية)
  - [الملفات المحذوفة (سلة المهملات)](#الملفات-المحذوفة-سلة-المهملات)
  - [النسخ الاحتياطي](#النسخ-الاحتياطي)
  - [مزامنة GitHub](#مزامنة-github)
  - [تكامل Git](#تكامل-git)
  - [تكامل Storm Code](#تكامل-storm-code)
  - [وحدة تحكم LH المدمجة](#وحدة-تحكم-lh-المدمجة)
  - [الإضافات](#الإضافات)
  - [Agent Diary — سجل الذكاء الاصطناعي](#agent-diary--سجل-الذكاء-الاصطناعي)
  - [حماية الحذف من الذكاء الاصطناعي](#حماية-الحذف-من-الذكاء-الاصطناعي)
- [الميزات الذكية — تحليلات الذكاء الاصطناعي](#الميزات-الذكية--تحليلات-الذكاء-الاصطناعي)
- [التصورات](#التصورات)
- [Global Watcher — المراقبة العالمية](#global-watcher--المراقبة-العالمية)
- [اللوحات والواجهة](#اللوحات-والواجهة)
- [الإعدادات](#الإعدادات)
- [مفاتيح الاختصار](#مفاتيح-الاختصار)
- [CLI](#cli)
- [التقنيات](#التقنيات)
- [المؤلف](#المؤلف)

---

## المميزات

### النواة
- **اللقطات التلقائية** — 7 محفزات ذكية (الحفظ، تبديل التبويبات، التحرير، فقدان التركيز، الخمول، التغييرات الخارجية، الحذف)
- **إلغاء التكرار** — المحتوى المتطابق يُخزن مرة واحدة (تجزئة SHA-256)
- **الفروع** — خطوط إصدارات متوازية مع دمج، cherry-pick، تصدير/استيراد
- **الفروع الزومبي** — تحكم كامل بالفروع والـ commits المحذوفة مع إمكانية الاستعادة
- **مجموعات التغييرات** — مماثل للـ commits مع وسم تلقائي وتوليد وصف بالذكاء الاصطناعي
- **البحث بوسوم المجموعات** — تعيين يدوي لوسوم نصية مخصصة مع بحث سريع
- **متصفح الفروقات** — مراجعة تفاعلية للتغييرات مع قبول/رفض لكل كتلة
- **سلة مهملات الكتل المرفوضة** — حفظ جميع أجزاء الكود المرفوضة للاستعادة اللاحقة
- **Blame** — من ومتى غيّر كل سطر (مثل `git blame`)
- **Bisect** — بحث ثنائي عن إصدار الخطأ (مثل `git bisect`)
- **الإدارة الجراحية** — إزالة أي ملف من الفرع أو الـ commit عبر الواجهة

</div>

[الوثائق الكاملة بالعربية تستمر...]


# LocalHub — 代码时光机

**自动本地文件版本控制。无需Git命令，无需提交 — 一切都在后台运行。**

LocalHub 是您代码的完整"时光机"。每个重要操作都会自动创建文件快照。分支、组、差异导航器、AI分析、插件、云同步、全局文件监控 — 开箱即用。

![Version](https://img.shields.io/badge/version-3.0.1-blue)
![VS Code](https://img.shields.io/badge/VS%20Code-1.85%2B-blue)
![Standalone IDE](https://img.shields.io/badge/Standalone%20IDE-supported-purple)
![Python](https://img.shields.io/badge/Python-3.9%2B-green)

## 目录
- [功能特性](#功能特性)
- [Shadow Sandboxes](https://github.com/adamgold1/local-hub-vscode-extansthion-public-/blob/HEAD/docs/SHADOW_SANDBOXES.md)
- [Universal MCP](https://github.com/adamgold1/local-hub-vscode-extansthion-public-/blob/HEAD/docs/UNIVERSAL_MCP.md)
- [安装](#安装)
- [快速开始](#快速开始)
- [LocalHub — 功能](#localhub--功能)
- [智能功能 — AI分析](#智能功能--ai分析)
- [可视化](#可视化)
- [Global Watcher — 全局监控](#global-watcher--全局监控)
- [面板和界面](#面板和界面)
- [设置](#设置)
- [快捷键](#快捷键)
- [CLI](#cli)
- [技术](#技术)
- [作者](#作者)

## 功能特性

### 核心
- **自动快照** — 7个智能触发器（保存、标签切换、编辑、失去焦点、空闲、外部更改、删除）
- **去重** — 相同内容只存储一次（SHA-256哈希）
- **分支** — 并行版本线，支持合并、cherry-pick、导出/导入
- **僵尸分支** — 完全控制已删除的分支和提交，可恢复
- **更改组** — 类似提交的概念，带自动标签和AI描述生成
- **组标签搜索** — 手动分配自定义文本标签，快速搜索
- **差异导航器** — 交互式更改审查，每个块都有接受/拒绝
- **拒绝块回收站** — 保存所有拒绝的代码片段以供后续恢复
- **Blame** — 谁在何时更改了每一行（类似`git blame`）
- **Bisect** — 二分搜索错误版本（类似`git bisect`）
- **精确管理** — 通过UI从分支或提交中删除任何文件

### 监控
- **Global Watcher** — 后台操作系统级文件监控，即使没有IDE也能工作
- **无缝共生** — 全局观察器和本地中心之间的自动数据传输
- **云同步** — Google Drive、OneDrive、Dropbox、Yandex Disk或自定义API
- **备份** — 带轮换的集中备份

### AI和分析
- **8个智能分析器** —预测、热图、重构、更改速度、依赖关系、集群、分析
- **Agent Diary** — 自动记录AI代理操作
- **Storm Code集成** — 基于AI代理响应的自动提交
- **回收站保护** — AI无法从回收站删除文件

### 可视化
- **3D网格** — 三维项目可视化
- **时光机** — 穿越项目状态的时间旅行
- **代码回放** — 作为视频播放编码会话
- **分支树** — 可视化分支树
- **组更改树** — 整个文件组的更改可视化（手风琴和经典模式）
- **依赖图** — 交互式文件关系图（Nexus Vision）
- **符号时间线** — 函数和类的时间线

### 可扩展性
- **插件系统** — 安装、启用/禁用、配置、市场
- **CLI** — 终端工作的命令行
- **内置LH控制台** — 程序内的完整终端
- **150+ API端点** — 对所有功能的完全程序访问
- **Shadow Sandboxes** — 用于AI和人工审查的隔离工作副本
- **Universal MCP** — MCP客户端的标准项目级引导


# LocalHub — कोड के लिए टाइम मशीन

**स्वचालित स्थानीय फ़ाइल संस्करण। कोई Git कमांड नहीं, कोई कमिट नहीं — सब कुछ बैकग्राउंड में।**

LocalHub आपके कोड के लिए एक पूर्ण "टाइम मशीन" है। हर महत्वपूर्ण क्रिया स्वचालित रूप से फ़ाइल स्नैपशॉट बनाती है।

![Version](https://img.shields.io/badge/version-3.0.1-blue)
![VS Code](https://img.shields.io/badge/VS%20Code-1.85%2B-blue)
![Standalone IDE](https://img.shields.io/badge/Standalone%20IDE-supported-purple)
![Python](https://img.shields.io/badge/Python-3.9%2B-green)

## विषय-सूची
- [विशेषताएं](#विशेषताएं)
- [Shadow Sandboxes](https://github.com/adamgold1/local-hub-vscode-extansthion-public-/blob/HEAD/docs/SHADOW_SANDBOXES.md)
- [Universal MCP](https://github.com/adamgold1/local-hub-vscode-extansthion-public-/blob/HEAD/docs/UNIVERSAL_MCP.md)
- [स्थापना](#स्थापना)
- [त्वरित शुरुआत](#त्वरित-शुरुआत)
- [LocalHub — कार्यक्षमता](#localhub--कार्यक्षमता)


# LocalHub — Máquina del Tiempo para Código

**Versionado automático local de archivos. Sin comandos Git, sin commits — todo en segundo plano.**

LocalHub es una "Máquina del Tiempo" completa para tu código. Cada acción significativa crea automáticamente una instantánea del archivo.

![Version](https://img.shields.io/badge/version-3.0.1-blue)
![VS Code](https://img.shields.io/badge/VS%20Code-1.85%2B-blue)
![Standalone IDE](https://img.shields.io/badge/Standalone%20IDE-supported-purple)
![Python](https://img.shields.io/badge/Python-3.9%2B-green)

## Tabla de Contenidos
- [Características](#características)
- [Shadow Sandboxes](https://github.com/adamgold1/local-hub-vscode-extansthion-public-/blob/HEAD/docs/SHADOW_SANDBOXES.md)
- [Universal MCP](https://github.com/adamgold1/local-hub-vscode-extansthion-public-/blob/HEAD/docs/UNIVERSAL_MCP.md)
- [Instalación](#instalación)
- [Inicio Rápido](#inicio-rápido)


# LocalHub — آلة الزمن للكود

**إصدارات الملفات المحلية التلقائية. بدون أوامر Git، بدون commits — كل شيء في الخلفية.**

LocalHub هو "آلة زمن" كاملة لكودك. كل إجراء مهم ينشئ تلقائياً لقطة للملف.

![Version](https://img.shields.io/badge/version-3.0.1-blue)
![VS Code](https://img.shields.io/badge/VS%20Code-1.85%2B-blue)
![Standalone IDE](https://img.shields.io/badge/Standalone%20IDE-supported-purple)
![Python](https://img.shields.io/badge/Python-3.9%2B-green)

<div dir="rtl">

## جدول المحتويات
- [المميزات](#المميزات)
- [Shadow Sandboxes](https://github.com/adamgold1/local-hub-vscode-extansthion-public-/blob/HEAD/docs/SHADOW_SANDBOXES.md)
- [Universal MCP](https://github.com/adamgold1/local-hub-vscode-extansthion-public-/blob/HEAD/docs/UNIVERSAL_MCP.md)
- [التثبيت](#التثبيت)
- [البداية السريعة](#البداية-السريعة)

## المميزات

### النواة
- **اللقطات التلقائية** — 7 محفزات ذكية (الحفظ، تبديل التبويبات، التحرير، فقدان التركيز، الخمول، التغييرات الخارجية، الحذف)
- **إلغاء التكرار** — المحتوى المتطابق يُخزن مرة واحدة (تجزئة SHA-256)
- **الفروع** — خطوط إصدارات متوازية مع دمج، cherry-pick، تصدير/استيراد
- **الفروع الزومبي** — تحكم كامل بالفروع والـ commits المحذوفة مع إمكانية الاستعادة
- **مجموعات التغييرات** — مماثل للـ commits مع وسم تلقائي وتوليد وصف بالذكاء الاصطناعي
- **البحث بوسوم المجموعات** — تعيين يدوي لوسوم نصية مخصصة مع بحث سريع
- **متصفح الفروقات** — مراجعة تفاعلية للتغييرات مع قبول/رفض لكل كتلة

</div>

LocalHub - Time Machine

Islam Chomaev

LocalHub — Time Machine for Code

Preview Build

Control Center Auto-Download

Storm Code Companion

Screenshots

All Screenshots Gallery

Table of Contents

Features

Core

Monitoring

AI and Analytics

Visualizations

Extensibility

Installation

Requirements

From VSIX

From Source (Development)

Quick Start

LocalHub — Functionality

Automatic Snapshots

File History

Recovery

Change Groups (TM Groups)

LHL Mode — Auto-grouping

Branches

Zombie Branches and Zombie Commits

Tree Diff — Change Visualization

Diff Navigator — Interactive Review

Rejected Blocks Trash

Blame and Bisect

Surgical File Management

Deleted Files (Trash)

Backup

GitHub Synchronization

Universal Git Remote

Git Integration

Storm Code Integration

Built-in LH Console

Plugins

Agent Diary — AI Log

AI Deletion Protection

Smart Features — AI Analytics

Show All Features Command Center

Visualizations

Global Watcher — Global Monitoring

Features

History and Recovery

Cloud Synchronization

Project Export

Management

Settings Panel

Panels and Interface

LocalHub Sidebar (11 sections)

Global Watcher Sidebar

Built-in Console

Settings Panel (11 tabs)

Settings

General

LHL Mode

Global Watcher

Backup and Trash

Storm Code Integration

Built-in Console

GitHub

Git

Tree Diff

Advanced

Hotkeys

CLI

Built-in Console

Technologies

Author

Из исходников (разработка)

Быстрый старт

LocalHub — Функционал

Автоматические снимки

История файлов

Восстановление