kapsel-cli 0.5.2__tar.gz → 0.5.4__tar.gz

{kapsel_cli-0.5.2 → kapsel_cli-0.5.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kapsel-cli
-Version: 0.5.2
+Version: 0.5.4
 Summary: Next-generation cross-platform terminal capsule & ergonomic shell multiplexer with context-aware command translation and 1,000+ CLI completions.
 Author-email: MrEiu <k648888@vip.qq.com>
 License: MIT

{kapsel_cli-0.5.2 → kapsel_cli-0.5.4}/kapsel/__init__.py

@@ -3,4 +3,4 @@ Kapsel: Cross-platform adaptive smart terminal capsule.
 Wrap complexity, expose simplicity.
 """
 
-__version__ = "0.5.2"
+__version__ = "0.5.4"

{kapsel_cli-0.5.2 → kapsel_cli-0.5.4}/kapsel/completion/kps/builtins/__init__.py

@@ -153,7 +153,13 @@ def register_builtins(registry: "KpsCommandRegistry") -> None:
     # 9. upgrade & update (Kapsel Core & official plugins)
     from kapsel.completion.kps.builtins.upgrade import handle_upgrade
 
+    # Merge catalog entries with locally installed plugins so enable/disable/upgrade
+    # completions reflect the actual filesystem state (e.g. workspace dev plugins).
+    from kapsel.completion.kps.builtins.plugin_switch import get_all_installed_plugins
     plugin_subcommands = {k: v for k, v in add_subcommands.items() if k != "update"}
+    for p in get_all_installed_plugins():
+        if p not in plugin_subcommands and p not in ("update", "all"):
+            plugin_subcommands[p] = f"Plugin: {p}"
 
     registry.register(
         name="upgrade",

{kapsel_cli-0.5.2 → kapsel_cli-0.5.4}/kapsel/completion/kps/builtins/plugin_switch.py

@@ -36,17 +36,69 @@ def get_all_installed_plugins() -> List[str]:
     return sorted(installed)
 
 
+def _render_plugin_status_table(con: Console) -> None:
+    """Renders a full overview table of all installed plugins with enabled/disabled status."""
+    from rich.table import Table
+    from kapsel.core.plugin.catalog import _extract_plugin_version, _extract_plugin_description
+    from kapsel.storage.config import get_kapsel_dir
+    from pathlib import Path
+
+    cfg = load_config()
+    enabled_set = set(p.lower() for p in (cfg.enabled_plugins or []))
+    all_installed = get_all_installed_plugins()
+
+    table = Table(
+        title="[bold #00f0ff]🧩 Kapsel Plugin Status Overview[/]",
+        border_style="#0891b2",
+        header_style="bold #00f0ff",
+        show_header=True,
+        expand=False,
+    )
+    table.add_column("Plugin", style="bold #a855f7", width=16)
+    table.add_column("Version", style="dim #9ca3af", width=10)
+    table.add_column("Status", width=14)
+    table.add_column("Description", style="#e4e4e7")
+
+    for name in all_installed:
+        # Resolve version & description from actual plugin dir
+        ver, desc = "0.1.0", f"Plugin: {name}"
+        for base in (Path.cwd() / "plugins", get_kapsel_dir() / "plugins"):
+            p_dir = base / name
+            if p_dir.is_dir():
+                v = _extract_plugin_version(p_dir)
+                d = _extract_plugin_description(p_dir)
+                if v:
+                    ver = v
+                if d:
+                    desc = d
+                break
+
+        if not enabled_set or name in enabled_set:
+            status = "[bold #10b981]● Enabled[/]"
+        else:
+            status = "[dim #6b7280]○ Disabled[/]"
+
+        table.add_row(name, f"v{ver}", status, desc)
+
+    con.print()
+    con.print(table)
+    con.print(
+        f"[dim]Run [bold #00f0ff]kapsel enable <plugin>[/] or "
+        f"[bold #f43f5e]kapsel disable <plugin>[/] to toggle.[/]\n"
+    )
+
+
 def handle_enable_plugin(args: List[str], console: Optional[Console] = None) -> int:
     """
     Enables one or more installed Kapsel plugins.
     Usage:
       kapsel enable <plugin_name>
+      kapsel enable              (shows full plugin status table)
     """
     con = console or Console(legacy_windows=False)
     if not args:
-        con.print("[bold #f43f5e]Error:[/] Please specify a plugin name to enable.")
-        con.print("[dim]Usage: kapsel enable <plugin_name> (e.g. kapsel enable shore)[/]\n")
-        return 1
+        _render_plugin_status_table(con)
+        return 0
 
     target = args[0].strip().lower()
     cfg = load_config()
@@ -88,13 +140,63 @@ def handle_enable_plugin(args: List[str], console: Optional[Console] = None) ->
     except Exception:
         pass
 
-    rich_catalog = load_plugin_catalog_rich()
-    ver = rich_catalog.get(target, {}).get("version", "0.1.0")
-    con.print(f"[bold #10b981]✔ Successfully enabled plugin '[bold #00f0ff]{target}[/]' (v{ver}).[/]")
-    con.print(f"[dim]You can now run 'kps {target}' or explore its commands.[/]\n")
+    # Build status card
+    from rich.table import Table as _Table
+    from rich.panel import Panel as _Panel
+    from kapsel.core.plugin.catalog import _extract_plugin_version, _extract_plugin_description
+    from pathlib import Path as _Path
+    from kapsel.storage.config import get_kapsel_dir as _get_dir
+
+    # Resolve version & description from actual plugin files first
+    ver, desc = None, None
+    for base in (_Path.cwd() / "plugins", _get_dir() / "plugins"):
+        p_dir = base / target
+        if p_dir.is_dir():
+            ver = _extract_plugin_version(p_dir)
+            desc = _extract_plugin_description(p_dir)
+            break
+    if not ver:
+        ver = load_plugin_catalog_rich().get(target, {}).get("version", "0.1.0")
+    if not desc:
+        desc = load_plugin_catalog_rich().get(target, {}).get("description", f"Plugin: {target}")
+
+    # Collect subcommands from live registry if available
+    subcommands: dict = {}
+    try:
+        from kapsel.completion.kps.registry import get_kps_registry
+        cmd_entry = get_kps_registry().get(target)
+        if cmd_entry:
+            subcommands = cmd_entry.subcommands or {}
+    except Exception:
+        pass
+
+    grid = _Table.grid(padding=(0, 2))
+    grid.add_column(style="bold #a855f7", width=14)
+    grid.add_column(style="#e4e4e7")
+
+    grid.add_row("Plugin:", f"[bold #00f0ff]{target}[/]  [dim]v{ver}[/]")
+    grid.add_row("Description:", desc)
+    grid.add_row("Status:", "[bold #10b981]✔ Enabled[/]")
+    grid.add_row("Run:", f"[bold #38bdf8]kps {target} [dim][command][/][/]")
+
+    if subcommands:
+        grid.add_row("Commands:", "")
+        for sub, sub_desc in list(subcommands.items())[:8]:
+            grid.add_row("", f"  [bold #38bdf8]{sub:<16}[/] [dim]{sub_desc}[/]")
+        if len(subcommands) > 8:
+            grid.add_row("", f"  [dim]... and {len(subcommands) - 8} more[/]")
+
+    con.print(_Panel(
+        grid,
+        title=f"[bold #00f0ff]🔌 Plugin Enabled: {target}[/]",
+        border_style="#0891b2",
+        padding=(1, 2),
+        expand=False,
+    ))
     return 0
 
 
+
 def handle_disable_plugin(args: List[str], console: Optional[Console] = None) -> int:
     """
     Disables one or more active Kapsel plugins.

{kapsel_cli-0.5.2 → kapsel_cli-0.5.4}/kapsel/completion/kps/builtins/status.py

@@ -115,11 +115,26 @@ def handle_status(args: Optional[List[str]] = None, console: Optional[Console] =
         active_plugins = [p.lower() for p in enabled_plugins]
 
     if active_plugins:
+        from kapsel.core.plugin.catalog import _extract_plugin_version
+        from kapsel.storage.config import get_kapsel_dir as _get_dir
+
+        def _get_plugin_version(name: str) -> str:
+            # 1. Try actual plugin directory (workspace dev or global)
+            for base in (Path.cwd() / "plugins", _get_dir() / "plugins"):
+                p = base / name
+                if p.is_dir():
+                    v = _extract_plugin_version(p)
+                    if v and v != "0.1.0":
+                        return v
+            # 2. Fallback to catalog metadata
+            return rich_catalog.get(name, {}).get("version", "0.1.0")
+
         plugin_badges = [
-            f"[bold #00f0ff]{p}[/][dim]@{rich_catalog.get(p, {}).get('version', '0.1.0')}[/]"
+            f"[bold #00f0ff]{p}[/][dim]@{_get_plugin_version(p)}[/]"
             for p in active_plugins
         ]
         plugins_str = ", ".join(plugin_badges)
+
     else:
         plugins_str = f"[dim]{none_str}[/]"
 

{kapsel_cli-0.5.2 → kapsel_cli-0.5.4}/kapsel/core/plugin/catalog.py

@@ -108,7 +108,37 @@ def load_plugin_catalog_rich() -> Dict[str, Dict[str, Any]]:
             except Exception:
                 pass
 
-    # If file not present yet, return default catalog converted to rich format
+    # If file not present yet, try to fetch from remote repository before falling back to defaults
+    try:
+        from kapsel.core.plugin.fetcher import fetch_remote_catalog
+        remote_data = fetch_remote_catalog()
+        if remote_data and isinstance(remote_data, dict):
+            result = {}
+            for k, v in remote_data.items():
+                if k.startswith(("_", "$")):
+                    continue
+                if isinstance(v, dict):
+                    result[k] = {
+                        "version": v.get("version", "0.1.0"),
+                        "description": v.get("description", f"Plugin {k}"),
+                        "changelog": v.get("changelog", ""),
+                    }
+                else:
+                    result[k] = {
+                        "version": "0.1.0",
+                        "description": str(v),
+                        "changelog": "",
+                    }
+            result.setdefault("update", {
+                "version": "0.1.0",
+                "description": "Scan and update available plugin catalog and completion dictionary",
+                "changelog": "Catalog dictionary update scanner.",
+            })
+            return result
+    except Exception:
+        pass
+
+    # Final fallback: built-in DEFAULT_CATALOG (offline / import error)
     return {
         k: {
             "version": "0.2.0" if k in ("alias", "install") else "0.1.0",
@@ -119,6 +149,7 @@ def load_plugin_catalog_rich() -> Dict[str, Dict[str, Any]]:
     }
 
 
+
 def _extract_plugin_version(plugin_dir: Path) -> str:
     """Extracts version string from plugin manifest, pyproject.toml, or __init__.py."""
     # 1. Try reading manifest in plugin.py

{kapsel_cli-0.5.2 → kapsel_cli-0.5.4}/kapsel/core/plugin/fetcher.py

@@ -154,3 +154,50 @@ def fetch_plugin_from_remote(
         f"from official repository (https://github.com/MrEiu/plugins)."
     )
     return False
+
+
+OFFICIAL_CATALOG_URL = "https://raw.githubusercontent.com/MrEiu/plugins/master/catalog.json"
+OFFICIAL_CATALOG_MIRROR_URL = "https://ghproxy.net/https://raw.githubusercontent.com/MrEiu/plugins/master/catalog.json"
+
+
+def fetch_remote_catalog(console: Optional[Console] = None) -> Optional[dict]:
+    """
+    Fetches the latest catalog.json from the official remote repository.
+    Tries direct GitHub raw URL first, then mirror fallback.
+    On success, writes to the local global cache and returns the parsed dict.
+    Returns None if all attempts fail (offline / unreachable).
+    """
+    import json as _json
+    from kapsel.storage.config import get_kapsel_dir
+
+    con = console or Console(legacy_windows=False)
+    headers = {"User-Agent": "Kapsel-Plugin-Fetcher/1.0"}
+
+    for url, label in [
+        (OFFICIAL_CATALOG_URL, "GitHub"),
+        (OFFICIAL_CATALOG_MIRROR_URL, "Mirror"),
+    ]:
+        try:
+            req = urllib.request.Request(url, headers=headers)
+            with urllib.request.urlopen(req, timeout=8.0) as resp:
+                if resp.status == 200:
+                    raw = resp.read().decode("utf-8")
+                    data = _json.loads(raw)
+                    if isinstance(data, dict):
+                        # Write to local cache so subsequent calls skip network
+                        global_cache = get_kapsel_dir() / "plugins_catalog.json"
+                        try:
+                            global_cache.parent.mkdir(parents=True, exist_ok=True)
+                            global_cache.write_text(
+                                _json.dumps(data, indent=2, ensure_ascii=False) + "\n",
+                                encoding="utf-8",
+                            )
+                        except Exception as cache_err:
+                            logger.debug(f"Failed to write remote catalog cache: {cache_err}")
+                        logger.debug(f"Remote catalog fetched from {label} ({len(data)} entries).")
+                        return data
+        except Exception as ex:
+            logger.debug(f"Remote catalog fetch failed from {label} ({url}): {ex}")
+
+    con.print("[dim]Could not reach remote catalog; using built-in defaults.[/]")
+    return None

kapsel_cli-0.5.4/kapsel/locales/en/help.yaml

@@ -0,0 +1,181 @@
+# Kapsel System Manual & Cheatsheet (English)
+meta:
+  title: "KAPSEL"
+  subtitle: "User Manual & Fast Command Cheatsheet"
+  architecture: "Unified Command Pipeline: 'kapsel <cmd>' and 'kps <cmd>' share the exact same execution engine."
+  version_prefix: "v"
+
+modes:
+  title: "🚀 Core Interaction Dual Modes"
+  columns:
+    mode: "Mode"
+    trigger: "Trigger"
+    description: "Behavior & Capabilities"
+  rows:
+    - name: "Native Mode"
+      trigger: "Direct command input"
+      description: "100% native host execution (git, docker, npm, python, vim) with Carapace dynamic context-aware completion."
+    - name: "Kapsel Mode"
+      trigger: "Prefix 'kapsel ' or 'kps '"
+      description: "Unified capsule commands (help, status, config, language, add, enable, toggle, and plugin extensions); Tab opens candidates."
+
+quickstart:
+  title: "⚡ Quick Start Workflow"
+  items:
+    - step: "1. Launch Interactive Shell"
+      cmd: "kapsel toggle"
+      desc: "Opens the smart capsule shell with real-time autocompletion and command history."
+    - step: "2. Native Pass-Through"
+      cmd: "git checkout -b feature"
+      desc: "Run any native command without friction. Carapace provides live branch and flag completions."
+    - step: "3. Inspect Host Status"
+      cmd: "kapsel status"
+      desc: "Inspect OS platform, active shell, Git branch, completion engine, and active plugin roster."
+    - step: "4. Browse & Install Plugins"
+      cmd: "kapsel enable"
+      desc: "View all installed plugins with enabled/disabled status. Use 'kapsel enable <name>' to activate one."
+    - step: "5. Safely Exit"
+      cmd: "exit"
+      desc: "Returns cleanly to your host terminal without residual background processes."
+
+commands:
+  title: "⚙️ Capsule Core & Tool Command Suite (kapsel / kps)"
+  columns:
+    command: "Command"
+    description: "Description"
+    origin: "Origin"
+  builtin_rows:
+    - name: "kapsel help"
+      desc: "Display comprehensive manual, modes, keybindings, and cheatsheets"
+      origin: "Core"
+    - name: "kapsel status"
+      desc: "Inspect OS platform, active host shell, Git branch, completion engine, and active plugin roster"
+      origin: "Core"
+    - name: "kapsel config"
+      desc: "View, edit, get, set, or reload settings in ~/.kapsel/config.yaml"
+      origin: "Core"
+    - name: "kapsel search"
+      desc: "Fuzzy search across Kapsel repository plugins and metadata catalog"
+      origin: "Core"
+    - name: "kapsel language"
+      desc: "View and switch active UI language (en, zh_CN, ja, es, fr, de, ru)"
+      origin: "Core"
+    - name: "kapsel datadir"
+      desc: "View or migrate data sandbox storage directory with automatic data transfer"
+      origin: "Core"
+    - name: "kapsel add <plugin>"
+      desc: "Fetch, install dependencies and register a plugin into the Kapsel environment"
+      origin: "Core"
+    - name: "kapsel upgrade [name]"
+      desc: "Check and upgrade Kapsel Core and official plugins with release notes"
+      origin: "Core"
+    - name: "kapsel enable"
+      desc: "Show all installed plugins with enabled/disabled status overview table"
+      origin: "Core"
+    - name: "kapsel enable <plugin>"
+      desc: "Enable an installed Kapsel plugin and display its status card"
+      origin: "Core"
+    - name: "kapsel disable <plugin>"
+      desc: "Disable an active Kapsel plugin without removing its files"
+      origin: "Core"
+    - name: "kapsel completion"
+      desc: "Manage, inspect, and synchronize declarative Carapace completion specifications"
+      origin: "Core"
+    - name: "kapsel toggle"
+      desc: "Toggle interactive Kapsel terminal mode on or off"
+      origin: "Core"
+    - name: "kapsel dir"
+      desc: "Preview the current directory tree and display Ctrl+Arrow navigation shortcut hints"
+      origin: "Core"
+    - name: "kapsel rm <path>"
+      desc: "Safely and permanently delete a file or directory with explicit confirmation prompt"
+      origin: "Core"
+    - name: "exit / quit"
+      desc: "Safely exit Kapsel interactive capsule and return to host shell"
+      origin: "Core"
+
+shortcuts:
+  title: "⌨️ Interactive Keybindings & Ergonomics"
+  columns:
+    key: "Key"
+    description: "Action"
+  items:
+    - key: "Tab"
+      desc: "Trigger completion menu; accept selected candidate; cycle to next suggestion"
+    - key: "Shift + Tab"
+      desc: "Cycle backwards through the completion candidate menu"
+    - key: "Enter"
+      desc: "Accept selected completion candidate, or execute the current command"
+    - key: "Ctrl + Enter / Alt + Enter"
+      desc: "Execute input as a background Command Block (auto-prepends 'kp' if needed)"
+    - key: "↑ (Up Arrow)"
+      desc: "In completion: browse up; at top: cancel completion and go back in history"
+    - key: "↓ (Down Arrow)"
+      desc: "In history: go forward; at origin: open completion and select first candidate"
+    - key: "→ (Single Tap)"
+      desc: "Accept one word of ghost suggestion, or complete the only active candidate"
+    - key: "→ (Hold / Rapid)"
+      desc: "Accept the entire ghost suggestion line at once"
+    - key: "Ctrl + → (Right)"
+      desc: "In input: jump one word forward; on empty line: expand subfolders in-place"
+    - key: "Ctrl + ← (Left)"
+      desc: "In input: jump one word backward; on empty line: cd .. (double-tap to confirm)"
+    - key: "Ctrl + ↑ (Up)"
+      desc: "Create a new empty file interactively at the current path"
+    - key: "Ctrl + ↓ (Down)"
+      desc: "Permanently delete selected file or folder (double-tap to confirm)"
+    - key: "Alt + ↑ (Up)"
+      desc: "Launch the interactive file manager (runs 'fm')"
+    - key: "Alt + ↓ (Down)"
+      desc: "Copy current prompt text to clipboard; if empty, copies last command"
+    - key: "Alt + T"
+      desc: "Translate output of previous command (runs 'tr' shorthand)"
+    - key: "Alt + B"
+      desc: "Jump cursor backward one word (same as Ctrl+Left in input)"
+    - key: "Alt + F"
+      desc: "Jump cursor forward one word (same as Ctrl+Right in input)"
+    - key: "Alt + D"
+      desc: "Delete the word immediately after the cursor"
+    - key: "Alt + Backspace"
+      desc: "Delete the word immediately before the cursor"
+    - key: "Ctrl + W"
+      desc: "Delete the word immediately before the cursor (same as Alt+Backspace)"
+    - key: "Ctrl + U"
+      desc: "Delete all input before the cursor"
+    - key: "Ctrl + K"
+      desc: "Delete all input after the cursor"
+    - key: "Ctrl + A"
+      desc: "Jump cursor to the beginning of the line"
+    - key: "Ctrl + E"
+      desc: "Jump cursor to the end of the line"
+    - key: "Ctrl + B"
+      desc: "Open Block Roaming mode — browse session history blocks and live outputs"
+    - key: "Ctrl + C"
+      desc: "Silently ignore on empty prompt; running commands are terminated via OS signal"
+    - key: "Ctrl + D"
+      desc: "Exit the Kapsel interactive session cleanly (EOF)"
+    - key: "Ctrl + L"
+      desc: "Clear terminal screen and redraw the card interface"
+    - key: "Escape / q (Roaming)"
+      desc: "Exit Block Roaming mode and restore previous prompt input"
+    - key: "y / o (Roaming)"
+      desc: "Copy the output of the currently selected block to clipboard"
+    - key: "c (Roaming)"
+      desc: "Copy the command of the currently selected block to clipboard"
+    - key: "r (Roaming)"
+      desc: "Re-run the currently selected block's command"
+    - key: "x / Ctrl+C (Roaming)"
+      desc: "Terminate the currently running block"
+    - key: "v (Roaming)"
+      desc: "View the full log output of the currently selected block"
+
+tips:
+  title: "💡 Pro Tips & Best Practices"
+  items:
+    - "Press → (Right Arrow) once to accept the next word of a ghost suggestion; hold or tap rapidly to accept the entire line."
+    - "Press Ctrl+Enter (or Alt+Enter) to run any command as a background block — the prompt is immediately ready for the next command."
+    - "Press Ctrl+B to open Block Roaming and inspect, copy, or re-run any previous block output without leaving the prompt."
+    - "On an empty prompt, press Ctrl+→ to peek into subdirectories, or Ctrl+← to navigate up (cd ..) — no typing required."
+    - "Type 'kapsel help <command>' (e.g. 'kapsel help config') to get focused usage and subcommand details for any specific command."
+    - "Run 'kapsel add update' after cloning or modifying the plugins repo to refresh completions and the plugin catalog instantly."
+    - "Run 'kapsel enable' with no arguments to see which plugins are active and which are installed but disabled."

{kapsel_cli-0.5.2 → kapsel_cli-0.5.4}/kapsel/locales/en/tips.yaml

@@ -47,3 +47,22 @@ tips:
   - "Run [bold #38bdf8]kapsel upgrade[/] to automatically check and update Kapsel core and all installed official plugins."
   - "Add your personal notes or team commands to ~/.kapsel/tips.yaml; Kapsel will blend them into daily tips."
   - "Type [bold #f43f5e]exit[/] or press [bold #f43f5e]Ctrl+D[/] to safely exit Kapsel and return to your host shell without pollution."
+  - "Press [bold #f59e0b]Ctrl+→[/] while the prompt is empty to instantly expand and preview subdirectories without typing anything."
+  - "Press [bold #f59e0b]Ctrl+←[/] on an empty prompt to navigate up to the parent directory (cd ..); double-tap to confirm."
+  - "Press [bold #f59e0b]Ctrl+↑[/] to create a new empty file interactively at the current path — no command needed."
+  - "Press [bold #f59e0b]Ctrl+↓[/] to permanently delete the selected file or folder; double-tap to bypass the confirmation."
+  - "Press [bold #38bdf8]Alt+↑[/] to instantly launch the interactive file manager (fm) from any prompt state."
+  - "Press [bold #38bdf8]Alt+↓[/] to copy your current prompt text to the clipboard; if the prompt is empty, it copies your last command."
+  - "Press [bold #38bdf8]Alt+T[/] to immediately translate the output of your previous command via the trans plugin shorthand 'tr'."
+  - "Press [bold #38bdf8]Alt+B[/] or [bold #38bdf8]Alt+F[/] to jump backward or forward one word in your current input line."
+  - "Run [bold #10b981]bk[/] (or [bold #10b981]kps backup[/]) to instantly snapshot the current directory; run [bold #10b981]bk undo[/] to roll back immediately."
+  - "Run [bold #10b981]bk restore[/] with no arguments to open an interactive time-travel picker and restore any previous snapshot."
+  - "Run [bold #10b981]bk log[/] to view backup history with relative timestamps; [bold #10b981]bk diff[/] shows changes since the last snapshot."
+  - "Run [bold #10b981]kps trans <text>[/] to translate command output or arbitrary text across multiple languages directly in the terminal."
+  - "Run [bold #10b981]kps lang switch <locale>[/] to hot-swap the terminal locale and shell culture settings without restarting."
+  - "Run [bold #10b981]kps preview <file>[/] for smart, syntax-highlighted preview of code, markdown, images, and archives."
+  - "Run [bold #10b981]kps commit[/] to launch the interactive Conventional Commit wizard — it auto-deduces type and scope from your diff."
+  - "Run [bold #38bdf8]kapsel enable[/] (no args) to see a full table of all installed plugins with their enabled/disabled status."
+  - "Run [bold #38bdf8]kapsel dir[/] to preview the current directory tree and get a reminder of all Ctrl+Arrow navigation shortcuts."
+  - "Run [bold #38bdf8]kapsel rm <path>[/] to safely delete a file or folder — it always asks for explicit confirmation before removing."
+

{kapsel_cli-0.5.2 → kapsel_cli-0.5.4}/kapsel/locales/zh_CN/help.yaml

@@ -17,7 +17,7 @@ modes:
       description: "100% 原生宿主执行 (git, docker, npm, python, vim 等)，配备 Carapace 深度上下文动态补全。"
     - name: "胶囊模式 (Kapsel)"
       trigger: "输入 'kapsel ' 或 'kps '"
-      description: "统一胶囊指令 (help, status, config, language, add, toggle 及插件扩展)；Tab 展开候选。"
+      description: "统一胶囊指令 (help, status, config, language, add, enable, toggle 及插件扩展)；Tab 展开候选。"
 
 quickstart:
   title: "⚡ 极速上手工作流"
@@ -28,10 +28,13 @@ quickstart:
     - step: "2. 原生无缝执行"
       cmd: "git checkout -b feature"
       desc: "无感运行任意原生命令，Carapace 自动感知分支名、参数与文件路径。"
-    - step: "3. 单次宿主管理"
+    - step: "3. 检查系统状态"
       cmd: "kapsel status"
-      desc: "在外部 PowerShell、Bash 或 CMD 中直接检查胶囊运行看板。"
-    - step: "4. 安全无痕退出"
+      desc: "查看系统平台、宿主终端、Git 分支、补全引擎与已激活插件一览。"
+    - step: "4. 浏览与管理插件"
+      cmd: "kapsel enable"
+      desc: "查看所有已安装插件的启用/禁用状态总览表；运行 'kapsel enable <名称>' 激活指定插件。"
+    - step: "5. 安全无痕退出"
       cmd: "exit"
       desc: "安全退出胶囊环境并返回宿主终端，不残留后台进程与脏环境。"
 
@@ -46,7 +49,7 @@ commands:
       desc: "显示完整的系统使用指南、交互机制与命令速查手册"
       origin: "Core 核心"
     - name: "kapsel status"
-      desc: "查看操作系统平台、宿主终端、Git 分支及沙箱运行看板"
+      desc: "查看操作系统平台、宿主终端、Git 分支、补全引擎及已激活插件列表"
       origin: "Core 核心"
     - name: "kapsel config"
       desc: "查看、编辑、读取、设置或热重载 ~/.kapsel/config.yaml"
@@ -61,13 +64,16 @@ commands:
       desc: "查看或安全搬迁数据存储沙箱目录 (全量自动搬迁，旧位置彻底清除)"
       origin: "Core 核心"
     - name: "kapsel add <plugin>"
-      desc: "安装依赖并将外部插件启用注册至当前 Kapsel 运行环境"
+      desc: "从远程仓库拉取、安装依赖并将插件注册至 Kapsel 运行环境"
       origin: "Core 核心"
     - name: "kapsel upgrade [name]"
       desc: "检查并升级 Kapsel 自身及官方插件，展示更新说明"
       origin: "Core 核心"
+    - name: "kapsel enable"
+      desc: "显示所有已安装插件的启用/禁用状态总览表"
+      origin: "Core 核心"
     - name: "kapsel enable <plugin>"
-      desc: "启用已安装的 Kapsel 插件"
+      desc: "启用已安装的 Kapsel 插件并展示插件状态卡片"
       origin: "Core 核心"
     - name: "kapsel disable <plugin>"
       desc: "禁用已启用的 Kapsel 插件 (保留插件文件)"
@@ -78,6 +84,12 @@ commands:
     - name: "kapsel toggle"
       desc: "开启或关闭 Kapsel 终端默认交互会话"
       origin: "Core 核心"
+    - name: "kapsel dir"
+      desc: "预览当前目录树结构并展示 Ctrl+Arrow 方向键导航快捷键说明"
+      origin: "Core 核心"
+    - name: "kapsel rm <path>"
+      desc: "安全永久删除文件或目录，执行前需显式确认，防止误删"
+      origin: "Core 核心"
     - name: "exit / quit"
       desc: "安全退出 Kapsel 终端胶囊，无痕返回宿主原生 Shell"
       origin: "Core 核心"
@@ -106,6 +118,12 @@ shortcuts:
       desc: "取消当前输入行并重置输入提示符"
     - key: "Ctrl + D"
       desc: "正常退出终端胶囊交互会话 (EOF)"
+    - key: "Ctrl + L"
+      desc: "清空终端屏幕并重绘卡片界面"
+    - key: "Ctrl + Enter / Alt + Enter"
+      desc: "将多行粘贴内容作为 Command Block 整体执行"
+    - key: "Ctrl + B / Alt + B"
+      desc: "进入 Block Roaming 模式，浏览历史块、输出与状态"
 
 tips:
   title: "💡 进阶使用技巧"
@@ -115,4 +133,17 @@ tips:
     - "随时运行 'kapsel language <代码/缩写>' (如 'kapsel language en' 或 'kapsel language ja') 即刻切换语言。"
     - "跨盘迁移数据非常安全：运行 'kapsel datadir D:\\KapselData' 即可全自动搬迁数据库与配置。"
     - "调用外部扩展工具时使用 'kps <tool>'，例如 'kps shore set python tuna' 或 'kps init use node@22'。"
-
+    - "运行 'kapsel enable'（不带参数）即可查看所有已安装插件的启用/禁用状态总览表。"
+    - "运行 'kapsel enable <插件名>' 激活插件后，会弹出状态卡片展示版本、描述及可用子命令。"
+    - "运行 'kapsel dir' 预览当前目录树，并查看 Ctrl+方向键的导航快捷键说明。"
+    - "运行 'kapsel rm <路径>' 安全删除文件或目录——执行前始终要求显式确认，防止误删。"
+    - "运行 'bk'（或 'kps backup'）立即对当前目录打快照；运行 'bk undo' 即时回滚至上一版本。"
+    - "运行 'bk restore'（不带参数）启动交互式时间轴选择器，可视化还原任意历史快照。"
+    - "运行 'bk log' 查看带相对时间戳的备份历史；'bk diff' 展示自上次快照以来的变更内容。"
+    - "运行 'kps trans <文本>' 在终端内直接翻译命令输出或任意文本，支持多种目标语言。"
+    - "运行 'kps lang switch <locale>' 可热切换终端语言区域设置，无需重启 Shell。"
+    - "运行 'kps preview <文件>' 对代码、Markdown、图片和压缩包进行智能语法高亮预览。"
+    - "运行 'kps commit' 启动交互式 Conventional Commit 向导，自动从 diff 推断类型与作用域。"
+    - "运行 'kapsel search <关键词>' 模糊搜索官方插件、工具和生态包，用 'kapsel add <名称>' 安装。"
+    - "在 ~/.kapsel/tips.yaml 中添加个人笔记或团队命令；Kapsel 会将它们融入每日启动提示。"
+    - "输入 'exit' 或按 Ctrl+D 安全退出 Kapsel，无痕返回宿主 Shell。"

{kapsel_cli-0.5.2 → kapsel_cli-0.5.4}/kapsel_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kapsel-cli
-Version: 0.5.2
+Version: 0.5.4
 Summary: Next-generation cross-platform terminal capsule & ergonomic shell multiplexer with context-aware command translation and 1,000+ CLI completions.
 Author-email: MrEiu <k648888@vip.qq.com>
 License: MIT

{kapsel_cli-0.5.2 → kapsel_cli-0.5.4}/kapsel_cli.egg-info/SOURCES.txt

@@ -95,6 +95,7 @@ tests/test_i18n.py
 tests/test_plugin_ai.py
 tests/test_plugin_alias.py
 tests/test_plugin_autopilot.py
+tests/test_plugin_backup.py
 tests/test_plugin_commit.py
 tests/test_plugin_fetcher.py
 tests/test_plugin_init.py

{kapsel_cli-0.5.2 → kapsel_cli-0.5.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "kapsel-cli"
-version = "0.5.2"
+version = "0.5.4"
 description = "Next-generation cross-platform terminal capsule & ergonomic shell multiplexer with context-aware command translation and 1,000+ CLI completions."
 readme = "README.md"
 requires-python = ">=3.9"