remote-cmd-manager 1.2.0__tar.gz → 1.2.2__tar.gz

{remote_cmd_manager-1.2.0/remote_cmd_manager.egg-info → remote_cmd_manager-1.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: remote_cmd_manager
-Version: 1.2.0
+Version: 1.2.2
 Summary: SSH 远程服务器管理工具 / Python SSH remote server management tool
 Author-email: Vae-Scrooge <vaescrooge@gmail.com>
 License: MIT
@@ -52,18 +52,23 @@ Dynamic: license-file
   <img src="https://img.shields.io/badge/python-3.9%2B-blue?style=for-the-badge&logo=python" alt="Python">
   <img src="https://img.shields.io/github/license/Vae-Scrooge/remote-cmd?style=for-the-badge" alt="License">
   <img src="https://img.shields.io/github/actions/workflow/status/Vae-Scrooge/remote-cmd/ci.yml?style=for-the-badge&logo=githubactions&label=CI" alt="CI">
-  <img src="https://img.shields.io/badge/code%20style-black-black?style=for-the-badge" alt="Code Style">
 </p>
 
 <h1 align="center">Remote CMD — SSH Server Management<br><small>Without the Overhead</small></h1>
 
+<p align="center">
+  <img src="https://img.shields.io/badge/English-blue?style=flat-square" alt="English"> ·
+  <a href="./README.zh-CN.md"><img src="https://img.shields.io/badge/中文-gray?style=flat-square" alt="中文"></a>
+</p>
+
 <p align="center">
   <b><code>pip install remote_cmd_manager</code></b> &nbsp;·&nbsp;
   <a href="#quick-start">Quick Start</a> &nbsp;·&nbsp;
   <a href="#use-cases">Use Cases</a> &nbsp;·&nbsp;
+  <a href="#cli-reference">CLI Reference</a> &nbsp;·&nbsp;
   <a href="#python-api">Python API</a> &nbsp;·&nbsp;
-  <a href="./docs">Docs</a> &nbsp;·&nbsp;
-  <a href="./CONTRIBUTING.md">Contributing</a>
+  <a href="#documentation">Documentation</a> &nbsp;·&nbsp;
+  <a href="#contributing">Contributing</a>
 </p>
 
 <p align="center">
@@ -83,6 +88,23 @@ pip install remote_cmd_manager && remote-cmd host add web-01 192.168.1.10 ubuntu
 
 ---
 
+## Table of Contents
+
+- [Why Remote CMD?](#why-remote-cmd)
+- [Quick Start](#quick-start)
+- [Use Cases](#use-cases)
+- [CLI Reference](#cli-reference)
+- [Python API](#python-api)
+- [Features](#features)
+- [Installation](#installation)
+- [Documentation](#documentation)
+- [Project Status](#project-status)
+- [Maintainership](#maintainership)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
 ## Why Remote CMD?
 
 | Feature | `remote-cmd` | `ssh` + shell | Ansible | Fabric |
@@ -91,7 +113,7 @@ pip install remote_cmd_manager && remote-cmd host add web-01 192.168.1.10 ubuntu
 | Batch commands across hosts | ✅ `batch-run` | ❌ Write a loop | ✅ Playbook | ✅ |
 | File transfer (upload/download) | ✅ Built-in | ✅ scp | ✅ copy module | ✅ |
 | Python API | ✅ `from remote_cmd import ...` | ❌ | ❌ YAML-only | ✅ |
-| Zero setup | ✅ `pip install → go` | ❌ Config SSH | ❌ `ansible.cfg` | ❌ |
+| Zero setup | ✅ `pip install → go` | ❌ Configure SSH | ❌ `ansible.cfg` | ❌ |
 | Learning curve | **Low** | Low | **High** | Medium |
 
 **Use `remote-cmd` when** you need a CLI that works immediately for ad-hoc SSH tasks. **Use Ansible when** you need full configuration management and idempotent playbooks.
@@ -118,7 +140,8 @@ remote-cmd batch-run -t production "df -h /"
 
 ## Use Cases
 
-### 🖥️ System Admin — Check disk across 20 servers in one command
+### 🖥️ System Administrators — Check disk across 20 servers in one command
+
 ```bash
 remote-cmd batch-run -t production "df -h / | tail -1"
 # Output:
@@ -127,10 +150,11 @@ remote-cmd batch-run -t production "df -h / | tail -1"
 #   ✗ db-01   → Connection refused
 ```
 
-### 🚀 Deploy — Pull code and restart service
+### 🚀 Deploy — Pull code and restart a service
+
 ```python
 from remote_cmd.service.host_service import HostService
-from remote_cmd.repository.json_host_repository import JsonHostRepository
+from remote_cmd.repository import JsonHostRepository
 
 service = HostService(repository=JsonHostRepository("hosts.json"))
 for host in service.list_hosts(tag="staging"):
@@ -141,19 +165,38 @@ for host in service.list_hosts(tag="staging"):
 ```
 
 ### 🔥 Incident Response — Check logs across all servers
+
 ```bash
 remote-cmd batch-run -t web "journalctl -xe -n 50 | grep -i error"
 ```
 
 ### 🔧 Config Update — Upload and reload nginx across tagged hosts
+
 ```bash
-# Upload new config
-scp nginx.conf user@server:/tmp/nginx.conf  # or use the upload command
+# Upload new config, reload across web servers
 remote-cmd run web-01 "sudo cp /tmp/nginx.conf /etc/nginx/nginx.conf && sudo nginx -t && sudo systemctl reload nginx"
 ```
 
 ---
 
+## CLI Reference
+
+All operations are available from the terminal:
+
+| Command | Description |
+|---|---|
+| `remote-cmd host add <name> <host> <user>` | Register a server (`-k/--key`, `-p/--port`, `-t/--tag`, repeatable) |
+| `remote-cmd host list [-t TAG]` | List hosts, optionally filtered by tag |
+| `remote-cmd host show <name>` | Show one host's details |
+| `remote-cmd host test <name>` | Test connectivity to a host |
+| `remote-cmd host remove <name>` | Remove a host |
+| `remote-cmd run <name> "<cmd>"` | Run a command on one host |
+| `remote-cmd upload <name> <local> <remote>` | Upload a file via SFTP |
+| `remote-cmd download <name> <remote> <local>` | Download a file via SFTP |
+| `remote-cmd batch-run -t <tag> "<cmd>"` | Run across all hosts in a tag (`-C` concurrency, `-T` timeout, `--async`, `--show-failures`) |
+
+---
+
 ## Python API
 
 Use Remote CMD inside your own scripts and automation:
@@ -187,13 +230,18 @@ with SSHClient(config) as client:
 
 | Category | Details |
 |---|---|
-| **SSH Auth** | Password + key file + ssh-agent |
+| **SSH Auth** | Password + key file + ssh-agent, with pluggable credential providers |
+| **Credential Chain** | Source passwords from environment, keyring, or arbitrary providers, in priority order |
+| **Credential Encryption** | AES-encrypt secrets at rest (`CredentialEncryption`) |
 | **Commands** | Single, multi-line, sudo with password |
-| **File Transfer** | Upload/download via SFTP |
-| **Host Management** | CRUD with JSON/YAML persistence |
+| **File Transfer** | Upload/download via SFTP (`remote-cmd upload/download`) |
+| **Host Management** | CRUD with pluggable JSON or **SQLite** persistence |
 | **Tag System** | Filter hosts by tag (e.g., `production`, `web`, `db`) |
-| **Batch Ops** | Run commands across any host group |
+| **Batch Ops** | Run commands across any host group, synchronously or asynchronously |
+| **Async Kernel** | `AsyncSSHClient` / `AsyncConnectionPool` / `AsyncBatchExecutor` via the `[async]` extra |
+| **Task Runner** | Track and schedule long-running remote tasks with statuses (`TaskRunner`) |
 | **Connection Test** | Ping all hosts and report status |
+| **Secure Logging** | Structured logging that filters sensitive data (`SensitiveDataFilter`) |
 | **Type Safety** | Full type annotations + mypy strict |
 
 ---
@@ -201,10 +249,10 @@ with SSHClient(config) as client:
 ## Installation
 
 ```bash
-# From PyPI (recommended) — 同步 API 与 CLI
+# From PyPI (recommended) — keeps API and CLI in sync
 pip install remote_cmd_manager
 
-# With async native support (AsyncSSHClient / AsyncConnectionPool / AsyncBatchExecutor)
+# With native async support (AsyncSSHClient / AsyncConnectionPool / AsyncBatchExecutor)
 pip install "remote_cmd_manager[async]"
 
 # From source
@@ -216,13 +264,13 @@ pip install -e ".[dev]"
 The `[async]` extra installs `asyncssh` and enables the native async execution
 kernel: `AsyncSSHClient`, `AsyncConnectionPool` and `AsyncBatchExecutor`
 (also available via `BatchExecutor(use_async=True)`). Without it, `import remote_cmd`
-still works — async symbols are simply not exported.
+still works — the async symbols are simply not exported.
 
 ---
 
 ## Documentation
 
-📚 **[完整文档中心](./docs/README.md)** — 教程、API 参考、架构设计、故障排查
+📚 **[Full Documentation Center](./docs/README.md)** — tutorials, API reference, architecture, and troubleshooting
 
 | Document | Contents |
 |---|---|
@@ -230,11 +278,15 @@ still works — async symbols are simply not exported.
 | [API Docs (auto-generated)](./docs/api/remote_cmd.html) | Complete API reference generated by pdoc |
 | [Quickstart Tutorial](./docs/tutorial-quickstart.md) | Step-by-step walkthrough |
 | [Advanced Tutorial](./docs/tutorial-advanced.md) | Batch ops, error handling, production patterns |
-| [Development Guide](./docs/DEVELOPMENT.md) | Setup dev environment, contributing |
+| [Architecture](./docs/architecture.md) | System architecture and design decisions |
+| [Development Guide](./docs/DEVELOPMENT.md) | Set up the dev environment, contributing |
 | [Troubleshooting](./docs/TROUBLESHOOTING.md) | Common issues and solutions |
 | [Changelog](./CHANGELOG.md) | Release history |
 | [Mobile Remote Guide](./MOBILE-REMOTE-GUIDE.md) | Manage servers from your phone |
 
+> **Note:** The documentation center and tutorials are maintained in **Chinese**. See
+> [README.zh-CN.md](./README.zh-CN.md) for the Chinese version of this page.
+
 ---
 
 ## Project Status
@@ -243,8 +295,30 @@ still works — async symbols are simply not exported.
 
 **Roadmap:**
 - [x] Async SSH operations (parallel execution) — v1.1.0
+- [x] Pluggable storage backends (JSON + SQLite) — v1.2.x
+- [x] Chainable credential providers + at-rest encryption — v1.2.x
 - [ ] Configuration profiles (AWS, GCP, custom)
 - [ ] Output formatting (JSON, table)
+- [ ] Templated command recipes
+
+Good first issues are labelled `good first issue` in the
+[issue tracker](https://github.com/Vae-Scrooge/remote-cmd/issues) — contributions welcome.
+
+---
+
+## Maintainership
+
+**Remote CMD is an actively maintained open-source project.** It is designed and
+developed independently as a focused alternative to heavyweight tools for the
+ad-hoc SSH tasks that come up in day-to-day server work.
+
+- **Project health:** CI runs on every PR, Python 3.9+ is supported, and the
+  public API is versioned under [semantic versioning](https://semver.org/).
+- **Your code, your servers:** usage stays open under the MIT license — nothing
+  is telemetry-driven or locked behind a service.
+- **Why open source?** The tooling around ad-hoc SSH administration was either
+  too heavy (Ansible) or too bare (raw shell loops). Remote CMD exists so that
+  a single command can cover the common 90% of remote admin.
 
 ---
 
@@ -258,7 +332,7 @@ Before contributing, please read our [Code of Conduct](./CODE_OF_CONDUCT.md).
 
 ## License
 
-MIT © [Vae-Scrooge](https://github.com/Vae-Scrooge)
+MIT © [Vae-Scrooge](https://github.com/Vae-Scrooge/remote-cmd)
 
 ---
 

{remote_cmd_manager-1.2.0 → remote_cmd_manager-1.2.2}/README.md

@@ -5,18 +5,23 @@
   <img src="https://img.shields.io/badge/python-3.9%2B-blue?style=for-the-badge&logo=python" alt="Python">
   <img src="https://img.shields.io/github/license/Vae-Scrooge/remote-cmd?style=for-the-badge" alt="License">
   <img src="https://img.shields.io/github/actions/workflow/status/Vae-Scrooge/remote-cmd/ci.yml?style=for-the-badge&logo=githubactions&label=CI" alt="CI">
-  <img src="https://img.shields.io/badge/code%20style-black-black?style=for-the-badge" alt="Code Style">
 </p>
 
 <h1 align="center">Remote CMD — SSH Server Management<br><small>Without the Overhead</small></h1>
 
+<p align="center">
+  <img src="https://img.shields.io/badge/English-blue?style=flat-square" alt="English"> ·
+  <a href="./README.zh-CN.md"><img src="https://img.shields.io/badge/中文-gray?style=flat-square" alt="中文"></a>
+</p>
+
 <p align="center">
   <b><code>pip install remote_cmd_manager</code></b> &nbsp;·&nbsp;
   <a href="#quick-start">Quick Start</a> &nbsp;·&nbsp;
   <a href="#use-cases">Use Cases</a> &nbsp;·&nbsp;
+  <a href="#cli-reference">CLI Reference</a> &nbsp;·&nbsp;
   <a href="#python-api">Python API</a> &nbsp;·&nbsp;
-  <a href="./docs">Docs</a> &nbsp;·&nbsp;
-  <a href="./CONTRIBUTING.md">Contributing</a>
+  <a href="#documentation">Documentation</a> &nbsp;·&nbsp;
+  <a href="#contributing">Contributing</a>
 </p>
 
 <p align="center">
@@ -36,6 +41,23 @@ pip install remote_cmd_manager && remote-cmd host add web-01 192.168.1.10 ubuntu
 
 ---
 
+## Table of Contents
+
+- [Why Remote CMD?](#why-remote-cmd)
+- [Quick Start](#quick-start)
+- [Use Cases](#use-cases)
+- [CLI Reference](#cli-reference)
+- [Python API](#python-api)
+- [Features](#features)
+- [Installation](#installation)
+- [Documentation](#documentation)
+- [Project Status](#project-status)
+- [Maintainership](#maintainership)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
 ## Why Remote CMD?
 
 | Feature | `remote-cmd` | `ssh` + shell | Ansible | Fabric |
@@ -44,7 +66,7 @@ pip install remote_cmd_manager && remote-cmd host add web-01 192.168.1.10 ubuntu
 | Batch commands across hosts | ✅ `batch-run` | ❌ Write a loop | ✅ Playbook | ✅ |
 | File transfer (upload/download) | ✅ Built-in | ✅ scp | ✅ copy module | ✅ |
 | Python API | ✅ `from remote_cmd import ...` | ❌ | ❌ YAML-only | ✅ |
-| Zero setup | ✅ `pip install → go` | ❌ Config SSH | ❌ `ansible.cfg` | ❌ |
+| Zero setup | ✅ `pip install → go` | ❌ Configure SSH | ❌ `ansible.cfg` | ❌ |
 | Learning curve | **Low** | Low | **High** | Medium |
 
 **Use `remote-cmd` when** you need a CLI that works immediately for ad-hoc SSH tasks. **Use Ansible when** you need full configuration management and idempotent playbooks.
@@ -71,7 +93,8 @@ remote-cmd batch-run -t production "df -h /"
 
 ## Use Cases
 
-### 🖥️ System Admin — Check disk across 20 servers in one command
+### 🖥️ System Administrators — Check disk across 20 servers in one command
+
 ```bash
 remote-cmd batch-run -t production "df -h / | tail -1"
 # Output:
@@ -80,10 +103,11 @@ remote-cmd batch-run -t production "df -h / | tail -1"
 #   ✗ db-01   → Connection refused
 ```
 
-### 🚀 Deploy — Pull code and restart service
+### 🚀 Deploy — Pull code and restart a service
+
 ```python
 from remote_cmd.service.host_service import HostService
-from remote_cmd.repository.json_host_repository import JsonHostRepository
+from remote_cmd.repository import JsonHostRepository
 
 service = HostService(repository=JsonHostRepository("hosts.json"))
 for host in service.list_hosts(tag="staging"):
@@ -94,19 +118,38 @@ for host in service.list_hosts(tag="staging"):
 ```
 
 ### 🔥 Incident Response — Check logs across all servers
+
 ```bash
 remote-cmd batch-run -t web "journalctl -xe -n 50 | grep -i error"
 ```
 
 ### 🔧 Config Update — Upload and reload nginx across tagged hosts
+
 ```bash
-# Upload new config
-scp nginx.conf user@server:/tmp/nginx.conf  # or use the upload command
+# Upload new config, reload across web servers
 remote-cmd run web-01 "sudo cp /tmp/nginx.conf /etc/nginx/nginx.conf && sudo nginx -t && sudo systemctl reload nginx"
 ```
 
 ---
 
+## CLI Reference
+
+All operations are available from the terminal:
+
+| Command | Description |
+|---|---|
+| `remote-cmd host add <name> <host> <user>` | Register a server (`-k/--key`, `-p/--port`, `-t/--tag`, repeatable) |
+| `remote-cmd host list [-t TAG]` | List hosts, optionally filtered by tag |
+| `remote-cmd host show <name>` | Show one host's details |
+| `remote-cmd host test <name>` | Test connectivity to a host |
+| `remote-cmd host remove <name>` | Remove a host |
+| `remote-cmd run <name> "<cmd>"` | Run a command on one host |
+| `remote-cmd upload <name> <local> <remote>` | Upload a file via SFTP |
+| `remote-cmd download <name> <remote> <local>` | Download a file via SFTP |
+| `remote-cmd batch-run -t <tag> "<cmd>"` | Run across all hosts in a tag (`-C` concurrency, `-T` timeout, `--async`, `--show-failures`) |
+
+---
+
 ## Python API
 
 Use Remote CMD inside your own scripts and automation:
@@ -140,13 +183,18 @@ with SSHClient(config) as client:
 
 | Category | Details |
 |---|---|
-| **SSH Auth** | Password + key file + ssh-agent |
+| **SSH Auth** | Password + key file + ssh-agent, with pluggable credential providers |
+| **Credential Chain** | Source passwords from environment, keyring, or arbitrary providers, in priority order |
+| **Credential Encryption** | AES-encrypt secrets at rest (`CredentialEncryption`) |
 | **Commands** | Single, multi-line, sudo with password |
-| **File Transfer** | Upload/download via SFTP |
-| **Host Management** | CRUD with JSON/YAML persistence |
+| **File Transfer** | Upload/download via SFTP (`remote-cmd upload/download`) |
+| **Host Management** | CRUD with pluggable JSON or **SQLite** persistence |
 | **Tag System** | Filter hosts by tag (e.g., `production`, `web`, `db`) |
-| **Batch Ops** | Run commands across any host group |
+| **Batch Ops** | Run commands across any host group, synchronously or asynchronously |
+| **Async Kernel** | `AsyncSSHClient` / `AsyncConnectionPool` / `AsyncBatchExecutor` via the `[async]` extra |
+| **Task Runner** | Track and schedule long-running remote tasks with statuses (`TaskRunner`) |
 | **Connection Test** | Ping all hosts and report status |
+| **Secure Logging** | Structured logging that filters sensitive data (`SensitiveDataFilter`) |
 | **Type Safety** | Full type annotations + mypy strict |
 
 ---
@@ -154,10 +202,10 @@ with SSHClient(config) as client:
 ## Installation
 
 ```bash
-# From PyPI (recommended) — 同步 API 与 CLI
+# From PyPI (recommended) — keeps API and CLI in sync
 pip install remote_cmd_manager
 
-# With async native support (AsyncSSHClient / AsyncConnectionPool / AsyncBatchExecutor)
+# With native async support (AsyncSSHClient / AsyncConnectionPool / AsyncBatchExecutor)
 pip install "remote_cmd_manager[async]"
 
 # From source
@@ -169,13 +217,13 @@ pip install -e ".[dev]"
 The `[async]` extra installs `asyncssh` and enables the native async execution
 kernel: `AsyncSSHClient`, `AsyncConnectionPool` and `AsyncBatchExecutor`
 (also available via `BatchExecutor(use_async=True)`). Without it, `import remote_cmd`
-still works — async symbols are simply not exported.
+still works — the async symbols are simply not exported.
 
 ---
 
 ## Documentation
 
-📚 **[完整文档中心](./docs/README.md)** — 教程、API 参考、架构设计、故障排查
+📚 **[Full Documentation Center](./docs/README.md)** — tutorials, API reference, architecture, and troubleshooting
 
 | Document | Contents |
 |---|---|
@@ -183,11 +231,15 @@ still works — async symbols are simply not exported.
 | [API Docs (auto-generated)](./docs/api/remote_cmd.html) | Complete API reference generated by pdoc |
 | [Quickstart Tutorial](./docs/tutorial-quickstart.md) | Step-by-step walkthrough |
 | [Advanced Tutorial](./docs/tutorial-advanced.md) | Batch ops, error handling, production patterns |
-| [Development Guide](./docs/DEVELOPMENT.md) | Setup dev environment, contributing |
+| [Architecture](./docs/architecture.md) | System architecture and design decisions |
+| [Development Guide](./docs/DEVELOPMENT.md) | Set up the dev environment, contributing |
 | [Troubleshooting](./docs/TROUBLESHOOTING.md) | Common issues and solutions |
 | [Changelog](./CHANGELOG.md) | Release history |
 | [Mobile Remote Guide](./MOBILE-REMOTE-GUIDE.md) | Manage servers from your phone |
 
+> **Note:** The documentation center and tutorials are maintained in **Chinese**. See
+> [README.zh-CN.md](./README.zh-CN.md) for the Chinese version of this page.
+
 ---
 
 ## Project Status
@@ -196,8 +248,30 @@ still works — async symbols are simply not exported.
 
 **Roadmap:**
 - [x] Async SSH operations (parallel execution) — v1.1.0
+- [x] Pluggable storage backends (JSON + SQLite) — v1.2.x
+- [x] Chainable credential providers + at-rest encryption — v1.2.x
 - [ ] Configuration profiles (AWS, GCP, custom)
 - [ ] Output formatting (JSON, table)
+- [ ] Templated command recipes
+
+Good first issues are labelled `good first issue` in the
+[issue tracker](https://github.com/Vae-Scrooge/remote-cmd/issues) — contributions welcome.
+
+---
+
+## Maintainership
+
+**Remote CMD is an actively maintained open-source project.** It is designed and
+developed independently as a focused alternative to heavyweight tools for the
+ad-hoc SSH tasks that come up in day-to-day server work.
+
+- **Project health:** CI runs on every PR, Python 3.9+ is supported, and the
+  public API is versioned under [semantic versioning](https://semver.org/).
+- **Your code, your servers:** usage stays open under the MIT license — nothing
+  is telemetry-driven or locked behind a service.
+- **Why open source?** The tooling around ad-hoc SSH administration was either
+  too heavy (Ansible) or too bare (raw shell loops). Remote CMD exists so that
+  a single command can cover the common 90% of remote admin.
 
 ---
 
@@ -211,7 +285,7 @@ Before contributing, please read our [Code of Conduct](./CODE_OF_CONDUCT.md).
 
 ## License
 
-MIT © [Vae-Scrooge](https://github.com/Vae-Scrooge)
+MIT © [Vae-Scrooge](https://github.com/Vae-Scrooge/remote-cmd)
 
 ---
 

{remote_cmd_manager-1.2.0 → remote_cmd_manager-1.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "remote_cmd_manager"
-version = "1.2.0"
+version = "1.2.2"
 description = "SSH 远程服务器管理工具 / Python SSH remote server management tool"
 readme = "README.md"
 requires-python = ">=3.9"

{remote_cmd_manager-1.2.0 → remote_cmd_manager-1.2.2}/remote_cmd/__init__.py

@@ -48,11 +48,11 @@ Remote CMD - SSH 远程服务器管理工具
     - 文档: 参见 docs/ 目录
 
 Author: Vae-Scrooge
-Version: 1.0.0
+Version: 1.2.2
 License: MIT
 """
 
-__version__ = "1.2.0"
+__version__ = "1.2.2"
 __author__ = "Vae-Scrooge"
 __email__ = "vae-scrooge@example.com"
 __license__ = "MIT"
@@ -73,6 +73,7 @@ except ImportError:  # pragma: no cover - 依赖 asyncssh，未安装时不导
     _HAS_ASYNC = False
 
 from remote_cmd.core.host import Host
+from remote_cmd.core.host_manager import HostManager
 from remote_cmd.core.ssh_client import SSHClient
 from remote_cmd.core.sync_connection_pool import SyncConnectionPool
 
@@ -113,6 +114,7 @@ if _HAS_ASYNC:
         "AsyncConnectionPool",
         "AsyncBatchExecutor",
         "Host",
+        "HostManager",
         # 新架构导出
         "HostRepository",
         "JsonHostRepository",
@@ -145,6 +147,7 @@ else:
         # 原有导出（向后兼容，不含异步符号）
         "SSHClient",
         "Host",
+        "HostManager",
         # 新架构导出
         "HostRepository",
         "JsonHostRepository",

{remote_cmd_manager-1.2.0 → remote_cmd_manager-1.2.2}/remote_cmd/cli/main.py

@@ -62,9 +62,17 @@ def _build_service(config_file: str, storage_backend: Optional[str] = None) -> H
 @click.group()
 @click.version_option(version=__version__, prog_name="remote-cmd")
 @click.option("--config", "-c", type=click.Path(), help="Path to config file")
+@click.option(
+    "--hosts-file",
+    "hosts_file_override",
+    type=click.Path(),
+    help="Override hosts storage file (e.g. hosts.db for SQLite). "
+    "Takes precedence over the config's hosts_file; backend is inferred "
+    "from the extension (.json/.db/.sqlite) unless storage_backend is set.",
+)
 @click.option("--verbose", "-v", is_flag=True, help="Enable verbose output mode")
 @click.pass_context
-def cli(ctx, config: Optional[str], verbose: bool):
+def cli(ctx, config: Optional[str], hosts_file_override: Optional[str], verbose: bool):
     """
     Remote CMD - SSH remote server management tool
 
@@ -90,12 +98,15 @@ def cli(ctx, config: Optional[str], verbose: bool):
     ctx.obj["config"] = load_config(config_path)
     ctx.obj["verbose"] = verbose
 
-    hosts_file = ctx.obj["config"].get("hosts_file", "hosts.json")
+    # CLI --hosts-file 优先于配置文件中的 hosts_file；storage_backend 仍由配置提供
+    # （扩展名推断覆盖 .json/.db/.sqlite 常见场景）
+    hosts_file = hosts_file_override or ctx.obj["config"].get("hosts_file", "hosts.json")
     storage_backend = ctx.obj["config"].get("storage_backend")
     ctx.obj["service"] = _build_service(hosts_file, storage_backend)
 
     if verbose:
         click.echo(f"Using config file: {config_path}")
+        click.echo(f"Using hosts file: {hosts_file}")
 
 
 @cli.group()
@@ -120,16 +131,6 @@ def host():
 @click.argument("hostname", required=True)
 @click.argument("username", required=True)
 @click.option("--port", "-p", default=22, help="SSH port (default: 22)")
-@click.option(
-    "--password",
-    "-P",
-    default=None,
-    help=(
-        "Login password (INSECURE: visible in shell history and process list). "
-        "Prefer the REMOTE_CMD_PASSWORD environment variable, or omit this "
-        "option to be prompted interactively."
-    ),
-)
 @click.option("--key", "-k", help="Path to SSH private key file")
 @click.option("--tag", "-t", multiple=True, help="Host tag (may be repeated)")
 @click.option("--description", "-d", default="", help="Host description")
@@ -140,7 +141,6 @@ def host_add(
     hostname: str,
     username: str,
     port: int,
-    password: Optional[str],
     key: Optional[str],
     tag: tuple,
     description: str,
@@ -151,15 +151,20 @@ def host_add(
     NAME: host name (unique identifier)
     HOSTNAME: host address (IP or domain)
     USERNAME: SSH login username
+
+    Password input (in order of security):
+
+      1. REMOTE_CMD_PASSWORD environment variable (safest: not in shell
+         history or process list).
+      2. Interactive prompt via getpass (no echo, not recorded).
+
+    The insecure ``--password`` option has been removed to prevent passwords
+    from leaking via shell history and ``ps``/``/proc``. Use one of the above.
     """
     service: HostService = ctx.obj["service"]
 
     # Resolve password: priority REMOTE_CMD_PASSWORD env var > interactive
-    # getpass > --password argument.
-    # Security order: env var is safest (not in command line/history); getpass
-    # is interactive without echo and is not recorded.
-    # --password appears in shell history and process list, so it is the lowest
-    # priority and triggers a warning.
+    # getpass. Both are secure (not visible in command line/history).
     env_password = os.environ.get("REMOTE_CMD_PASSWORD")
     resolved_password: Optional[str] = None
 
@@ -173,22 +178,6 @@ def host_add(
             click.echo(click.style("\n✗ cancelled", fg="red"), err=True)
             ctx.exit(1)
 
-    if password and not env_password:
-        # Only warn when the user explicitly used --password (not env var)
-        click.echo(
-            click.style(
-                "⚠ Warning: passing the password via --password is insecure "
-                "(visible in shell history and process list). "
-                "Use the REMOTE_CMD_PASSWORD environment variable or "
-                "interactive input instead.",
-                fg="yellow",
-            ),
-            err=True,
-        )
-        # --password as the last-resort fallback
-        if not resolved_password:
-            resolved_password = password
-
     host = Host(
         name=name,
         hostname=hostname,
@@ -279,6 +268,7 @@ def host_show(ctx, name: str):
         if host.key_filename:
             # Sanitize key path: show only the filename, not full path
             from pathlib import Path
+
             key_name = Path(host.key_filename).name
             click.echo(f"  Key file:   {key_name}")
         tags_str = ", ".join(host.tags) if host.tags else "-"
@@ -435,7 +425,9 @@ def batch_run(
         use_async=use_async,
     )
 
-    click.echo(f"Batch running on {len(host_names)} hosts, command='{command}', concurrency={concurrency}")
+    click.echo(
+        f"Batch running on {len(host_names)} hosts, command='{command}', concurrency={concurrency}"
+    )
     click.echo()
 
     bar: Any