ssh-licco 2.0.2__tar.gz → 2.1.2__tar.gz

{ssh_licco-2.0.2/ssh_licco.egg-info → ssh_licco-2.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssh-licco
-Version: 2.0.2
+Version: 2.1.2
 Summary: SSH Model Context Protocol Server - Enable SSH functionality for AI models
 Author-email: SSH LICCO Team <contact@ssh-licco.dev>
 License: MIT
@@ -217,15 +217,29 @@ export SSH_EXTRA_ALLOWED_COMMANDS="git,pip,npm"
 
 - **[MCP_CONFIG_GUIDE.md](MCP_CONFIG_GUIDE.md)** - 完整配置指南，包含 5 种使用场景示例
 - **[SECURITY_CONFIG_GUIDE.md](SECURITY_CONFIG_GUIDE.md)** - 安全配置详解
+- **[docs/SECURITY_HARDENING.md](docs/SECURITY_HARDENING.md)** - 生产加固四项方案（v2.1.0 新增）
+
+### 🏛️ 生产加固四项（v2.1.0 新增）
+
+SSH 跳板模式部署的生产必做加固，补齐跳板机单点风险：
+
+| 加固点 | 开关 | 说明 |
+|--------|------|------|
+| 1. 运行账号最小权限 | `SSH_RUNTIME_GUARD=true` | 专用普通账号运行，拒绝 root/sudo 启动 |
+| 2. 密钥不落地磁盘 | `SSH_SECRET_PROVIDER_ENABLED=true` | 私钥从 KMS 临时拉取到内存，用完清零，不落盘 |
+| 3. 双层命令拦截 | `SSH_REMOTE_GUARD=true` + 远端 ForceCommand | 跳板机侧禁元字符 + 远端二次白名单校验 |
+| 4. 高危操作审批 | `SSH_APPROVAL_GATE=true` | rm/reboot/iptables 等高危命令需人工审批，AI 不能直接下发 |
+
+完整方案见 [docs/SECURITY_HARDENING.md](docs/SECURITY_HARDENING.md)。
 
 ---
 
-## 🛠️ 可用工具（v2.0.2 扩充至 9 个）
+## 🛠️ 可用工具（v2.1.0 扩充至 12 个）
 
 | 工具 | 描述 | 核心能力 |
 |------|------|---------|
 | `ssh_connect` | 连接管理 | 自动读取环境变量/配置，支持密码+密钥认证，可保存配置，登录后自动执行命令 |
-| `ssh_execute` | 命令执行 | 自动连接、智能后台检测、长任务等待、超时控制，支持 nohup/screen/tmux 三种后台模式 |
+| `ssh_execute` | 命令执行 | 自动连接、智能后台检测、长任务等待、超时控制，支持 nohup/screen/tmux 三种后台模式；v2.1.0 新增 `approval_id`（高危审批）与 `remote_guard`（双层拦截）参数 |
 | `ssh_disconnect` | 会话管理 | 断开指定会话 OR 列出所有活跃会话 |
 | `ssh_file_transfer` | 文件传输 | 上传/下载/列表/写入/追加/删除/创建目录/查看元信息（8 种操作） |
 | `ssh_host` | 主机管理 | `action=list/add/remove` 增删查主机配置 |
@@ -233,6 +247,9 @@ export SSH_EXTRA_ALLOWED_COMMANDS="git,pip,npm"
 | `ssh_generate_key` | 密钥生成 | RSA / Ed25519 密钥对 |
 | `ssh_session` | screen/tmux 会话 | 持久化远程会话管理（create/send/capture/list/kill），SSH 断开后进程依然存活 |
 | `ssh_process` | 进程管理 | 启动/停止/查询远程进程，SSH 端口转发（tunnel_open/tunnel_close/tunnel_list） |
+| `ssh_request_approval` | 高危审批申请（v2.1.0 新增） | AI 提交高危命令审批申请，返回 approval_id 等待人工审批 |
+| `ssh_approve_command` | 高危审批决定（v2.1.0 新增） | 运维人员人工审批 AI 申请，approved/rejected |
+| `ssh_list_approvals` | 审批记录查询（v2.1.0 新增） | 列出待审批队列或全部历史记录 |
 
 ### 📖 详细文档
 
@@ -558,7 +575,7 @@ ssh-licco 的核心依赖是：
 
 | 指标 | 状态 |
 |------|------|
-| **测试用例** | 344 passed, 0 skipped |
+| **测试用例** | 348 passed, 0 skipped |
 | **覆盖率** | 16 个源模块全覆盖 |
 | **测试框架** | pytest + pytest-asyncio |
 

{ssh_licco-2.0.2 → ssh_licco-2.1.2}/README.md

@@ -184,15 +184,29 @@ export SSH_EXTRA_ALLOWED_COMMANDS="git,pip,npm"
 
 - **[MCP_CONFIG_GUIDE.md](MCP_CONFIG_GUIDE.md)** - 完整配置指南，包含 5 种使用场景示例
 - **[SECURITY_CONFIG_GUIDE.md](SECURITY_CONFIG_GUIDE.md)** - 安全配置详解
+- **[docs/SECURITY_HARDENING.md](docs/SECURITY_HARDENING.md)** - 生产加固四项方案（v2.1.0 新增）
+
+### 🏛️ 生产加固四项（v2.1.0 新增）
+
+SSH 跳板模式部署的生产必做加固，补齐跳板机单点风险：
+
+| 加固点 | 开关 | 说明 |
+|--------|------|------|
+| 1. 运行账号最小权限 | `SSH_RUNTIME_GUARD=true` | 专用普通账号运行，拒绝 root/sudo 启动 |
+| 2. 密钥不落地磁盘 | `SSH_SECRET_PROVIDER_ENABLED=true` | 私钥从 KMS 临时拉取到内存，用完清零，不落盘 |
+| 3. 双层命令拦截 | `SSH_REMOTE_GUARD=true` + 远端 ForceCommand | 跳板机侧禁元字符 + 远端二次白名单校验 |
+| 4. 高危操作审批 | `SSH_APPROVAL_GATE=true` | rm/reboot/iptables 等高危命令需人工审批，AI 不能直接下发 |
+
+完整方案见 [docs/SECURITY_HARDENING.md](docs/SECURITY_HARDENING.md)。
 
 ---
 
-## 🛠️ 可用工具（v2.0.2 扩充至 9 个）
+## 🛠️ 可用工具（v2.1.0 扩充至 12 个）
 
 | 工具 | 描述 | 核心能力 |
 |------|------|---------|
 | `ssh_connect` | 连接管理 | 自动读取环境变量/配置，支持密码+密钥认证，可保存配置，登录后自动执行命令 |
-| `ssh_execute` | 命令执行 | 自动连接、智能后台检测、长任务等待、超时控制，支持 nohup/screen/tmux 三种后台模式 |
+| `ssh_execute` | 命令执行 | 自动连接、智能后台检测、长任务等待、超时控制，支持 nohup/screen/tmux 三种后台模式；v2.1.0 新增 `approval_id`（高危审批）与 `remote_guard`（双层拦截）参数 |
 | `ssh_disconnect` | 会话管理 | 断开指定会话 OR 列出所有活跃会话 |
 | `ssh_file_transfer` | 文件传输 | 上传/下载/列表/写入/追加/删除/创建目录/查看元信息（8 种操作） |
 | `ssh_host` | 主机管理 | `action=list/add/remove` 增删查主机配置 |
@@ -200,6 +214,9 @@ export SSH_EXTRA_ALLOWED_COMMANDS="git,pip,npm"
 | `ssh_generate_key` | 密钥生成 | RSA / Ed25519 密钥对 |
 | `ssh_session` | screen/tmux 会话 | 持久化远程会话管理（create/send/capture/list/kill），SSH 断开后进程依然存活 |
 | `ssh_process` | 进程管理 | 启动/停止/查询远程进程，SSH 端口转发（tunnel_open/tunnel_close/tunnel_list） |
+| `ssh_request_approval` | 高危审批申请（v2.1.0 新增） | AI 提交高危命令审批申请，返回 approval_id 等待人工审批 |
+| `ssh_approve_command` | 高危审批决定（v2.1.0 新增） | 运维人员人工审批 AI 申请，approved/rejected |
+| `ssh_list_approvals` | 审批记录查询（v2.1.0 新增） | 列出待审批队列或全部历史记录 |
 
 ### 📖 详细文档
 
@@ -525,7 +542,7 @@ ssh-licco 的核心依赖是：
 
 | 指标 | 状态 |
 |------|------|
-| **测试用例** | 344 passed, 0 skipped |
+| **测试用例** | 348 passed, 0 skipped |
 | **覆盖率** | 16 个源模块全覆盖 |
 | **测试框架** | pytest + pytest-asyncio |
 

{ssh_licco-2.0.2 → ssh_licco-2.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ssh-licco"
-version = "2.0.2"
+version = "2.1.2"
 description = "SSH Model Context Protocol Server - Enable SSH functionality for AI models"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -26,6 +26,8 @@ dependencies = [
     "pydantic>=2.0.0",
     "pydantic-settings>=2.0.0",
 ]
+[project.scripts]
+ssh-licco = "ssh_mcp.server:run_server"
 [project.urls]
 Homepage = "https://github.com/Echoqili/ssh-licco"
 Repository = "https://github.com/Echoqili/ssh-licco"
@@ -48,6 +50,8 @@ target-version = "py310"
 [tool.ruff.lint]
 select = ["E", "F", "W", "I", "N", "UP", "B", "C4"]
 ignore = []
+[tool.ruff.lint.per-file-ignores]
+"ssh_mcp/handlers/schemas.py" = ["E501"]
 [tool.mypy]
 python_version = "3.10"
 warn_return_any = true

{ssh_licco-2.0.2 → ssh_licco-2.1.2/ssh_licco.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssh-licco
-Version: 2.0.2
+Version: 2.1.2
 Summary: SSH Model Context Protocol Server - Enable SSH functionality for AI models
 Author-email: SSH LICCO Team <contact@ssh-licco.dev>
 License: MIT
@@ -217,15 +217,29 @@ export SSH_EXTRA_ALLOWED_COMMANDS="git,pip,npm"
 
 - **[MCP_CONFIG_GUIDE.md](MCP_CONFIG_GUIDE.md)** - 完整配置指南，包含 5 种使用场景示例
 - **[SECURITY_CONFIG_GUIDE.md](SECURITY_CONFIG_GUIDE.md)** - 安全配置详解
+- **[docs/SECURITY_HARDENING.md](docs/SECURITY_HARDENING.md)** - 生产加固四项方案（v2.1.0 新增）
+
+### 🏛️ 生产加固四项（v2.1.0 新增）
+
+SSH 跳板模式部署的生产必做加固，补齐跳板机单点风险：
+
+| 加固点 | 开关 | 说明 |
+|--------|------|------|
+| 1. 运行账号最小权限 | `SSH_RUNTIME_GUARD=true` | 专用普通账号运行，拒绝 root/sudo 启动 |
+| 2. 密钥不落地磁盘 | `SSH_SECRET_PROVIDER_ENABLED=true` | 私钥从 KMS 临时拉取到内存，用完清零，不落盘 |
+| 3. 双层命令拦截 | `SSH_REMOTE_GUARD=true` + 远端 ForceCommand | 跳板机侧禁元字符 + 远端二次白名单校验 |
+| 4. 高危操作审批 | `SSH_APPROVAL_GATE=true` | rm/reboot/iptables 等高危命令需人工审批，AI 不能直接下发 |
+
+完整方案见 [docs/SECURITY_HARDENING.md](docs/SECURITY_HARDENING.md)。
 
 ---
 
-## 🛠️ 可用工具（v2.0.2 扩充至 9 个）
+## 🛠️ 可用工具（v2.1.0 扩充至 12 个）
 
 | 工具 | 描述 | 核心能力 |
 |------|------|---------|
 | `ssh_connect` | 连接管理 | 自动读取环境变量/配置，支持密码+密钥认证，可保存配置，登录后自动执行命令 |
-| `ssh_execute` | 命令执行 | 自动连接、智能后台检测、长任务等待、超时控制，支持 nohup/screen/tmux 三种后台模式 |
+| `ssh_execute` | 命令执行 | 自动连接、智能后台检测、长任务等待、超时控制，支持 nohup/screen/tmux 三种后台模式；v2.1.0 新增 `approval_id`（高危审批）与 `remote_guard`（双层拦截）参数 |
 | `ssh_disconnect` | 会话管理 | 断开指定会话 OR 列出所有活跃会话 |
 | `ssh_file_transfer` | 文件传输 | 上传/下载/列表/写入/追加/删除/创建目录/查看元信息（8 种操作） |
 | `ssh_host` | 主机管理 | `action=list/add/remove` 增删查主机配置 |
@@ -233,6 +247,9 @@ export SSH_EXTRA_ALLOWED_COMMANDS="git,pip,npm"
 | `ssh_generate_key` | 密钥生成 | RSA / Ed25519 密钥对 |
 | `ssh_session` | screen/tmux 会话 | 持久化远程会话管理（create/send/capture/list/kill），SSH 断开后进程依然存活 |
 | `ssh_process` | 进程管理 | 启动/停止/查询远程进程，SSH 端口转发（tunnel_open/tunnel_close/tunnel_list） |
+| `ssh_request_approval` | 高危审批申请（v2.1.0 新增） | AI 提交高危命令审批申请，返回 approval_id 等待人工审批 |
+| `ssh_approve_command` | 高危审批决定（v2.1.0 新增） | 运维人员人工审批 AI 申请，approved/rejected |
+| `ssh_list_approvals` | 审批记录查询（v2.1.0 新增） | 列出待审批队列或全部历史记录 |
 
 ### 📖 详细文档
 
@@ -558,7 +575,7 @@ ssh-licco 的核心依赖是：
 
 | 指标 | 状态 |
 |------|------|
-| **测试用例** | 344 passed, 0 skipped |
+| **测试用例** | 348 passed, 0 skipped |
 | **覆盖率** | 16 个源模块全覆盖 |
 | **测试框架** | pytest + pytest-asyncio |
 

{ssh_licco-2.0.2 → ssh_licco-2.1.2}/ssh_licco.egg-info/SOURCES.txt

@@ -4,12 +4,15 @@ pyproject.toml
 ssh_licco.egg-info/PKG-INFO
 ssh_licco.egg-info/SOURCES.txt
 ssh_licco.egg-info/dependency_links.txt
+ssh_licco.egg-info/entry_points.txt
 ssh_licco.egg-info/requires.txt
 ssh_licco.egg-info/top_level.txt
 ssh_mcp/__init__.py
 ssh_mcp/__main__.py
+ssh_mcp/approval.py
 ssh_mcp/audit_logger.py
 ssh_mcp/batch_executor.py
+ssh_mcp/cli.py
 ssh_mcp/config_manager.py
 ssh_mcp/connection_config.py
 ssh_mcp/connection_pool.py
@@ -17,16 +20,34 @@ ssh_mcp/exceptions.py
 ssh_mcp/executor.py
 ssh_mcp/key_manager.py
 ssh_mcp/logging_config.py
+ssh_mcp/runtime_guard.py
+ssh_mcp/secret_provider.py
 ssh_mcp/security.py
 ssh_mcp/server.py
 ssh_mcp/service.py
 ssh_mcp/session_manager.py
+ssh_mcp/tunnel.py
 ssh_mcp/watchdog.py
 ssh_mcp/clients/__init__.py
 ssh_mcp/clients/additional_clients.py
 ssh_mcp/clients/factory.py
 ssh_mcp/clients/interface.py
 ssh_mcp/clients/paramiko_client.py
+ssh_mcp/handlers/__init__.py
+ssh_mcp/handlers/approval.py
+ssh_mcp/handlers/connect.py
+ssh_mcp/handlers/context.py
+ssh_mcp/handlers/docker.py
+ssh_mcp/handlers/execute.py
+ssh_mcp/handlers/file_transfer.py
+ssh_mcp/handlers/host.py
+ssh_mcp/handlers/key.py
+ssh_mcp/handlers/process.py
+ssh_mcp/handlers/schemas.py
+ssh_mcp/handlers/session.py
+ssh_mcp/handlers/utils.py
+tests/test_config_manager.py
 tests/test_key_manager.py
 tests/test_security.py
+tests/test_server.py
 tests/test_session_manager.py

ssh_licco-2.1.2/ssh_licco.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ssh-licco = ssh_mcp.server:run_server

{ssh_licco-2.0.2 → ssh_licco-2.1.2}/ssh_mcp/__init__.py

@@ -1,8 +1,8 @@
 # SSH-LICCO 版本信息
 # 所有代码中的版本信息都从这里读取
-# 版本号：2.0.2
+# 版本号：2.1.2
 
-__version__ = "2.0.2"
+__version__ = "2.1.2"
 __author__ = "Li Qi"
 __email__ = "1985694657@qq.com"
 __license__ = "MIT"
@@ -11,17 +11,17 @@ __url__ = "https://github.com/Echoqili/ssh-licco"
 
 from ssh_mcp.connection_config import ConnectionConfig
 from ssh_mcp.exceptions import (
-    SSHException,
-    ConnectionException,
     AuthenticationException,
+    ClientNotAvailableException,
     CommandExecutionException,
-    FileTransferException,
-    SessionException,
-    TimeoutException,
     ConfigurationException,
-    ClientNotAvailableException,
+    ConnectionException,
+    FileTransferException,
     PoolExhaustedException,
     RetryExhaustedException,
+    SessionException,
+    SSHException,
+    TimeoutException,
 )
 from ssh_mcp.service import get_ssh_service
 
@@ -45,4 +45,4 @@ __all__ = [
     "PoolExhaustedException",
     "RetryExhaustedException",
     "get_ssh_service",
-]
+]

{ssh_licco-2.0.2 → ssh_licco-2.1.2}/ssh_mcp/__main__.py

@@ -1,4 +1,9 @@
 """SSH-LICCO MCP Server entry point for `python -m ssh_mcp`."""
+
+from ssh_mcp.logging_config import suppress_known_warnings
+
+suppress_known_warnings()
+
 from ssh_mcp.server import run_server
 
-run_server()
+run_server()

ssh_licco-2.1.2/ssh_mcp/approval.py

@@ -0,0 +1,220 @@
+"""SSH-LICCO 高危操作审批门禁 — 加固点 4
+
+生产跳板机场景下，AI 不能直接一键下发高危运维命令（rm、重启服务、修改防火墙等）。
+本模块实现审批工作流：
+
+    AI 调用 ssh_execute(高危命令)
+        │
+        │  被审批门禁拦截（_check_approval_gate）
+        ▼
+    AI 调用 ssh_request_approval(command, reason)
+        │  → 生成 approval_id，写入待审批队列（持久化 JSON）
+        │  → 返回 approval_id 与提示「等待人工审批」
+        ▼
+    运维人员人工审批
+        │  调用 ssh_approve_command(approval_id, decision, reviewer)
+        │  → approval 状态变更为 approved / rejected
+        ▼
+    AI 再次调用 ssh_execute(command, approval_id)
+        │  → 审批门禁校验 approval_id 有效且 approved、命令匹配
+        ▼
+    执行命令（一次性，用后即焚）
+
+设计要点：
+  - 审批记录持久化到 JSON 文件（SSH_APPROVAL_STORE，默认 ~/.ssh_licco/approvals.json），
+    进程重启后审批状态不丢失。
+  - approval_id 是 UUID，不可猜测。
+  - 一次性消费：approved 的 approval_id 校验通过后立即标记为 consumed，防止复用。
+  - 命令必须严格匹配（shlex 规范化后比对），防止「申请 rm -rf /tmp/a，执行 rm -rf /」。
+  - 审批有 TTL（默认 1 小时），超时自动失效。
+  - 文件读写加锁，支持并发请求。
+
+启用方式：
+    SSH_APPROVAL_GATE=true                  # 开启审批门禁
+    SSH_APPROVAL_STORE=/path/to/approvals.json  # 审批记录存储路径
+    SSH_APPROVAL_TTL=3600                    # 审批有效期（秒），默认 3600
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import shlex
+import threading
+import time
+import uuid
+from dataclasses import asdict, dataclass
+from pathlib import Path
+
+
+@dataclass
+class ApprovalRecord:
+    approval_id: str
+    command: str  # 原始命令
+    command_norm: str  # shlex 规范化后的命令（用于比对）
+    reason: str  # 申请理由
+    status: str  # pending | approved | rejected | consumed | expired
+    requested_at: float  # 申请时间戳
+    decided_at: float | None = None  # 审批决定时间
+    reviewer: str | None = None  # 审批人
+    consumed_at: float | None = None  # 消费（执行）时间
+    ttl: int = 3600  # 有效期（秒）
+
+
+class ApprovalGate:
+    """审批门禁单例。"""
+
+    _instance: ApprovalGate | None = None
+    _lock = threading.Lock()
+
+    def __init__(self):
+        store_path = os.getenv(
+            "SSH_APPROVAL_STORE",
+            str(Path.home() / ".ssh_licco" / "approvals.json"),
+        )
+        self._store_path = Path(store_path)
+        self._store_path.parent.mkdir(parents=True, exist_ok=True)
+        self._ttl = int(os.getenv("SSH_APPROVAL_TTL", "3600"))
+        self._file_lock = threading.Lock()
+        self._records: dict[str, ApprovalRecord] = {}
+        self._load()
+
+    @classmethod
+    def instance(cls) -> ApprovalGate:
+        with cls._lock:
+            if cls._instance is None:
+                cls._instance = cls()
+            return cls._instance
+
+    # ── 持久化 ──
+    def _load(self) -> None:
+        if not self._store_path.exists():
+            self._records = {}
+            return
+        try:
+            with open(self._store_path, encoding="utf-8") as f:
+                data = json.load(f)
+            self._records = {k: ApprovalRecord(**v) for k, v in data.items()}
+        except Exception:
+            self._records = {}
+
+    def _save(self) -> None:
+        data = {k: asdict(v) for k, v in self._records.items()}
+        tmp = self._store_path.with_suffix(".tmp")
+        with open(tmp, "w", encoding="utf-8") as f:
+            json.dump(data, f, ensure_ascii=False, indent=2)
+        tmp.replace(self._store_path)  # 原子替换
+
+    @staticmethod
+    def _normalize(command: str) -> str:
+        """shlex 规范化命令，用于申请与执行时的命令比对。"""
+        try:
+            parts = shlex.split(command)
+            return " ".join(parts)
+        except ValueError:
+            return command.strip()
+
+    # ── 公开 API ──
+    def request(self, command: str, reason: str = "") -> ApprovalRecord:
+        """AI 提交审批申请。返回 ApprovalRecord（status=pending）。"""
+        with self._file_lock:
+            self._purge_expired_locked()
+            rec = ApprovalRecord(
+                approval_id=uuid.uuid4().hex,
+                command=command,
+                command_norm=self._normalize(command),
+                reason=reason,
+                status="pending",
+                requested_at=time.time(),
+                ttl=self._ttl,
+            )
+            self._records[rec.approval_id] = rec
+            self._save()
+            return rec
+
+    def approve(
+        self, approval_id: str, reviewer: str, decision: str = "approved"
+    ) -> ApprovalRecord:
+        """运维人员审批。decision = approved | rejected。"""
+        with self._file_lock:
+            self._purge_expired_locked()
+            rec = self._records.get(approval_id)
+            if rec is None:
+                raise KeyError(f"approval_id 不存在：{approval_id}")
+            if rec.status == "expired":
+                raise ValueError("审批已过期，请重新申请")
+            if rec.status in ("approved", "rejected", "consumed"):
+                raise ValueError(f"审批已处理（status={rec.status}），不可重复操作")
+            if decision not in ("approved", "rejected"):
+                raise ValueError("decision 必须是 approved 或 rejected")
+            rec.status = decision
+            rec.decided_at = time.time()
+            rec.reviewer = reviewer
+            self._save()
+            return rec
+
+    def verify(self, approval_id: str, command: str) -> tuple[bool, str]:
+        """执行前校验 approval_id。返回 (是否通过, 原因)。"""
+        with self._file_lock:
+            self._purge_expired_locked()
+            rec = self._records.get(approval_id)
+            if rec is None:
+                return False, f"approval_id 不存在：{approval_id}"
+            if rec.status == "expired":
+                return False, "审批已过期，请重新申请"
+            if rec.status == "pending":
+                return False, "审批仍在 pending，尚未被人工审批"
+            if rec.status == "rejected":
+                return False, f"审批已被拒绝（reviewer={rec.reviewer}）"
+            if rec.status == "consumed":
+                return False, "此 approval_id 已被使用过（一次性消费），请重新申请"
+            if rec.status != "approved":
+                return False, f"审批状态异常：{rec.status}"
+
+            # 命令必须严格匹配（规范化后比对）
+            cmd_norm = self._normalize(command)
+            if cmd_norm != rec.command_norm:
+                return False, (
+                    f"命令与审批申请不匹配。\n"
+                    f"  申请命令：{rec.command}\n"
+                    f"  执行命令：{command}\n"
+                    f"拒绝执行，防止「申请 A 命令、执行 B 命令」绕过审批。"
+                )
+
+            # 校验通过，标记为已消费（一次性）
+            rec.status = "consumed"
+            rec.consumed_at = time.time()
+            self._save()
+            return True, f"审批校验通过（reviewer={rec.reviewer}），已消费。"
+
+    def list_pending(self) -> list[ApprovalRecord]:
+        """列出所有 pending 审批（供运维人员查看待处理队列）。"""
+        with self._file_lock:
+            self._purge_expired_locked()
+            return [r for r in self._records.values() if r.status == "pending"]
+
+    def list_all(self, limit: int = 100) -> list[ApprovalRecord]:
+        """列出所有审批记录（最近的在前）。"""
+        with self._file_lock:
+            self._purge_expired_locked()
+            recs = sorted(
+                self._records.values(),
+                key=lambda r: r.requested_at,
+                reverse=True,
+            )
+            return recs[:limit]
+
+    def _purge_expired_locked(self) -> None:
+        """清理过期审批（pending 超过 TTL 标记为 expired）。"""
+        now = time.time()
+        changed = False
+        for rec in self._records.values():
+            if rec.status == "pending" and (now - rec.requested_at) > rec.ttl:
+                rec.status = "expired"
+                changed = True
+            # approved 但未消费的也按 TTL 失效（从 decided_at 起算）
+            if rec.status == "approved" and rec.decided_at and (now - rec.decided_at) > rec.ttl:
+                rec.status = "expired"
+                changed = True
+        if changed:
+            self._save()