docs: document remote workspace

Author: arch3rPro

README.md

@@ -38,6 +38,7 @@ Skills-Manager-Plus addresses this with a central library, preset-based switchin
 - **Skills Store** — Install from marketplace sources, Git repositories, local scans, ClawHub, and plugin markets.
 - **Presets** — Keep separate skill sets for different workflows, clients, or projects, then switch between them quickly without implicitly applying changes to disk.
 - **Global Workspace** — Inspect each installed agent's global local skills, compare them with the Skills Center, and run preset-driven bulk sync actions.
+- **Remote Workspace** — Connect to SSH hosts, discover remote agent global Skills, and safely install, update, or delete remote Skills with backups.
 - **Project Workspaces** — Compare project-local skills against the central library and move changes in either direction.
 - **Per-agent sync** — Sync with symlink or copy mode, including independent sync mode for custom agents.
 - **Git backup** — Create snapshot-based history for backup, recovery, and multi-machine sync.
@@ -85,6 +86,7 @@ The current app is organized around these modules:
 - `Skills Store`
 - `Presets`
 - `Global Workspace`
+- `Remote Workspace`
 - `Project Workspaces`
 - `Settings`
 
@@ -97,6 +99,7 @@ Detailed usage guides for each module live in [docs/usage/README.md](./docs/usag
 - [Skills Store](./docs/usage/skills-store.md)
 - [Skills Management](./docs/usage/skills-management.md)
 - [Presets](./docs/usage/presets.md)
+- [Remote Workspace](./docs/usage/remote-workspace.md)
 - [Project Workspaces](./docs/usage/project-workspaces.md)
 - [Settings](./docs/usage/settings.md)
 - [Git Backup](./docs/usage/git-backup.md)
@@ -114,9 +117,10 @@ You can also add custom tools in `Settings`.
 2. Open `Skills Store` to import skills from marketplace, Git, local folders, ClawHub, or plugins.
 3. Open `Skills Management` to decide which skills belong to the current preset.
 4. Open `Global Workspace` when you want to inspect agent-global local skills or apply a preset to a specific agent in bulk.
-5. Use `Project Workspaces` if you need to compare or exchange project-local skills.
-6. Configure `Git Backup` if you want history, restore points, or multi-machine sync.
-7. Use `skills-manager-plus-cli` for automation or recovery tasks that should share the desktop app's repository and preset state.
+5. Use `Remote Workspace` when you need to manage agent-global Skills on SSH hosts without local/remote sync.
+6. Use `Project Workspaces` if you need to compare or exchange project-local skills.
+7. Configure `Git Backup` if you want history, restore points, or multi-machine sync.
+8. Use `skills-manager-plus-cli` for automation or recovery tasks that should share the desktop app's repository and preset state.
 
 The repository also includes `skills/manage-skills/SKILL.md`, an optional Agent Skill that teaches compatible agents to call `skills-manager-plus-cli` instead of writing directly into one agent-specific skills directory.
 

README.zh-CN.md

@@ -38,6 +38,7 @@ Skills-Manager-Plus 通过中央库、预设切换、全局工作区、项目工
 - **技能商店** — 从市场、Git、本地扫描、ClawHub 和插件市场安装 Skills。
 - **预设管理** — 为不同工作流、客户或项目维护不同的技能组合，并把“浏览预设”和“应用到磁盘”分离。
 - **全局工作区** — 查看每个已安装 Agent 的全局本地技能、对比 Skills 中心，并按 Agent 执行基于预设的批量同步。
+- **远程工作区** — 连接 SSH 主机，发现远程 Agent 全局 Skills，并在备份保护下安装、更新或删除远程 Skills。
 - **项目工作区** — 将项目本地 Skills 与中央库进行对比，并支持双向导入导出。
 - **按 Agent 同步** — 支持软链接或复制模式，并允许自定义 Agent 使用独立同步策略。
 - **Git 备份** — 提供快照式版本历史，用于备份、恢复和多机同步。
@@ -85,6 +86,7 @@ Skills-Manager-Plus 通过中央库、预设切换、全局工作区、项目工
 - `技能商店`
 - `预设`
 - `全局工作区`
+- `远程工作区`
 - `项目工作区`
 - `设置`
 
@@ -97,6 +99,7 @@ Skills-Manager-Plus 通过中央库、预设切换、全局工作区、项目工
 - [技能商店](./docs/usage/zh-CN/skills-store.md)
 - [技能管理](./docs/usage/zh-CN/skills-management.md)
 - [预设](./docs/usage/zh-CN/presets.md)
+- [远程工作区](./docs/usage/zh-CN/remote-workspace.md)
 - [项目工作区](./docs/usage/zh-CN/project-workspaces.md)
 - [设置](./docs/usage/zh-CN/settings.md)
 - [Git 备份](./docs/usage/zh-CN/git-backup.md)
@@ -114,9 +117,10 @@ Cursor · Claude Code · Codex · OpenCode · Amp · Kilo Code · Roo Code · Go
 2. 打开 `技能商店`，从市场、Git、本地、ClawHub 或插件市场导入 Skills。
 3. 打开 `技能管理`，决定当前预设需要启用哪些 Skills。
 4. 打开 `全局工作区`，查看各 Agent 的全局本地技能，或把某个预设批量同步到指定 Agent。
-5. 如果需要处理项目本地 Skills，使用 `项目工作区`。
-6. 如果需要历史记录、恢复点或多机同步，配置 `Git 备份`。
-7. 如果需要自动化或恢复操作，使用 `skills-manager-plus-cli` 复用桌面端的仓库和预设状态。
+5. 如果需要管理 SSH 主机上的 Agent 全局 Skills，使用 `远程工作区`，它不是本地/远程双向同步。
+6. 如果需要处理项目本地 Skills，使用 `项目工作区`。
+7. 如果需要历史记录、恢复点或多机同步，配置 `Git 备份`。
+8. 如果需要自动化或恢复操作，使用 `skills-manager-plus-cli` 复用桌面端的仓库和预设状态。
 
 仓库同时提供 `skills/manage-skills/SKILL.md`，这是一个可选 Agent Skill，用于让兼容的 Agent 优先调用 `skills-manager-plus-cli`，而不是直接写入某个单独 Agent 的 skills 目录。
 

docs/usage/README.md

@@ -9,6 +9,7 @@ This directory contains the complete usage documentation for Skills-Manager-Plus
 - [Skills Store](./skills-store.md)
 - [Skills Management](./skills-management.md)
 - [Presets](./presets.md)
+- [Remote Workspace](./remote-workspace.md)
 - [Project Workspaces](./project-workspaces.md)
 - [Settings](./settings.md)
 - [Git Backup](./git-backup.md)
@@ -18,6 +19,6 @@ This directory contains the complete usage documentation for Skills-Manager-Plus
 
 1. Read `overview.md` to understand the central-library workflow.
 2. Read `skills-store.md` and `skills-management.md` to understand the main daily workflow.
-3. Read `presets.md`, `project-workspaces.md`, and `Global Workspace` in the app if you manage multiple workflows or project-local skills.
+3. Read `presets.md`, `remote-workspace.md`, `project-workspaces.md`, and `Global Workspace` in the app if you manage multiple workflows, SSH hosts, or project-local skills.
 4. Read `settings.md` and `git-backup.md` when configuring environments, custom agents, or backup.
-5. Read `cli.md` when scripting repository checks, preset sync, Global Workspace operations, or Git recovery.
+5. Read `cli.md` when scripting repository checks, preset sync, Global Workspace operations, Remote Workspace read-only checks, or Git recovery.

docs/usage/overview.md

@@ -9,6 +9,7 @@ The main concepts are:
 - `Central library`: the main repository where imported skills are stored.
 - `Preset`: a named workflow configuration with its own enabled skill set.
 - `Global workspace`: the per-agent surface for browsing real agent-global local skills and comparing them with the Skills Center.
+- `Remote workspace`: the SSH-host surface for managing remote agent-global Skills without local/remote sync.
 - `Installed tool`: a supported AI coding tool that can receive synced skills.
 - `Project workspace`: a project-local skills area that can be compared with the central library.
 - `Custom agent`: a user-defined tool path with its own sync configuration.
@@ -19,8 +20,9 @@ The main concepts are:
 2. Install skills through `Skills Store`.
 3. Open `Skills Management` and choose which skills are enabled in the current preset.
 4. Open `Global Workspace` when you want to inspect agent-global local skills or apply a preset to a specific agent.
-5. Use `Project Workspaces` when a repository has its own local skills that need to be reviewed or exchanged.
-6. Use `Git Backup` when you want restore points or multi-machine sync.
+5. Use `Remote Workspace` when you need to manage agent-global Skills on an SSH host.
+6. Use `Project Workspaces` when a repository has its own local skills that need to be reviewed or exchanged.
+7. Use `Git Backup` when you want restore points or multi-machine sync.
 
 ## Main Navigation
 
@@ -29,5 +31,6 @@ The main concepts are:
 - `Skills Store`: import new skills from external sources.
 - `Presets`: switch between different workflow setups.
 - `Global Workspace`: inspect and manage each installed agent's global local skills.
+- `Remote Workspace`: connect to SSH hosts and manage remote agent-global Skills with backup-first writes.
 - `Project Workspaces`: inspect and synchronize repository-local skills.
 - `Settings`: configure paths, tools, sync, search keys, and environment behavior.

docs/usage/remote-workspace.md

@@ -0,0 +1,69 @@
+# Remote Workspace
+
+`Remote Workspace` manages agent-global Skills on SSH hosts. It is a remote management surface, not a local/remote synchronization system.
+
+## Host Setup
+
+Add a host from `Remote Workspace` with:
+
+- Host name or IP address.
+- SSH port.
+- Username.
+- Password or private key authentication.
+- Optional SSH config import for hosts already defined in your local SSH config.
+
+Connection tests verify the SSH login and detect the remote home directory before scanning Skills.
+
+## Credentials
+
+Remote credentials are stored through the operating system credential store. Saving a password is optional. When you edit a host, saved secrets are not shown back in the form; enter a new secret only when you want to replace the stored one.
+
+## Scan
+
+Scanning checks the remote agent global Skills directories for supported tools, such as Codex or Claude Code. It does not scan remote project workspaces, arbitrary folders, Git repositories, plugin markets, or ClawHub sources.
+
+The scan result records each detected remote Skill, agent, path, and last scan time.
+
+## Install From Skills Center
+
+Use `Install` to copy a local Skills Center Skill to a selected remote agent global Skills directory. If the target Skill already exists, Remote Workspace creates a remote backup before replacing it.
+
+## Update From Skills Center
+
+V1 remote update is conservative: it updates a remote Skill only when there is exactly one enabled local Skills Center Skill with the same name. The existing remote directory is backed up before replacement.
+
+Remote update does not fetch directly from the remote Skill's original Git, plugin, or ClawHub source.
+
+## Delete With Backup
+
+Delete removes a selected remote Skill only after creating a backup on the remote host. Backups are stored under:
+
+```text
+~/.skills-manager-plus/backups/remote/<host-id>/<agent-id>/<skill-name>/<timestamp>
+```
+
+The operation log records the backup path so you can locate the saved copy later.
+
+## Operation Logs
+
+Remote Workspace records install, update, delete, and failure events with operation type, status, timestamp, error message when present, and backup path when a backup was created.
+
+## CLI Read-Only Commands
+
+The CLI supports read-only Remote Workspace checks:
+
+```bash
+skills-manager-plus-cli remote hosts list
+skills-manager-plus-cli remote hosts test <host-id-or-name>
+skills-manager-plus-cli remote scan <host-id-or-name>
+skills-manager-plus-cli remote skills list <host-id-or-name>
+```
+
+These commands use saved host profiles and saved credentials. They do not install, update, or delete remote Skills.
+
+## V1 Non-Goals
+
+- No bidirectional local/remote sync.
+- No remote Project Workspace support.
+- No batch operations across multiple hosts.
+- No direct remote update from Git, plugin markets, or ClawHub.

docs/usage/zh-CN/README.md

@@ -9,6 +9,7 @@
 - [技能商店](./skills-store.md)
 - [技能管理](./skills-management.md)
 - [预设](./presets.md)
+- [远程工作区](./remote-workspace.md)
 - [项目工作区](./project-workspaces.md)
 - [设置](./settings.md)
 - [Git 备份](./git-backup.md)
@@ -18,6 +19,6 @@
 
 1. 先看 `overview.md`，理解中央库工作流。
 2. 再看 `skills-store.md` 和 `skills-management.md`，理解日常主流程。
-3. 如果你管理多个工作流或项目本地技能，再看 `presets.md`、`project-workspaces.md`，并结合应用里的「全局工作区」一起使用。
+3. 如果你管理多个工作流、SSH 主机或项目本地技能，再看 `presets.md`、`remote-workspace.md`、`project-workspaces.md`，并结合应用里的「全局工作区」一起使用。
 4. 当你需要配置环境、自定义 Agent 或备份时，再看 `settings.md` 和 `git-backup.md`。
-5. 当你需要脚本化仓库检查、预设同步、全局工作区操作或 Git 恢复时，再看 `cli.md`。
+5. 当你需要脚本化仓库检查、预设同步、全局工作区操作、远程工作区只读检查或 Git 恢复时，再看 `cli.md`。

docs/usage/zh-CN/overview.md

@@ -9,6 +9,7 @@ Skills-Manager-Plus 的核心思路是：先维护一个中央技能库，再决
 - `中央库`：所有导入技能的主存储位置。
 - `预设`：一个具名工作流配置，拥有自己独立的启用技能集合。
 - `全局工作区`：按 Agent 查看真实的全局本地技能，并与 Skills 中心进行对比和管理的入口。
+- `远程工作区`：通过 SSH 管理远程主机上的 Agent 全局 Skills，不提供本地/远程双向同步。
 - `已安装工具`：可以接收同步技能的支持工具。
 - `项目工作区`：可以与中央库对比的项目本地技能区域。
 - `自定义 Agent`：由用户定义路径和同步配置的额外工具目标。
@@ -19,8 +20,9 @@ Skills-Manager-Plus 的核心思路是：先维护一个中央技能库，再决
 2. 通过 `技能商店` 导入 Skills。
 3. 打开 `技能管理`，决定当前预设启用哪些 Skills。
 4. 打开 `全局工作区`，查看各 Agent 的全局本地技能，或将某个预设批量同步到指定 Agent。
-5. 如果仓库中存在本地 Skills，则使用 `项目工作区` 进行对比和流转。
-6. 如果需要恢复点或多机同步，则使用 `Git 备份`。
+5. 如果需要管理 SSH 主机上的 Agent 全局 Skills，则使用 `远程工作区`。
+6. 如果仓库中存在本地 Skills，则使用 `项目工作区` 进行对比和流转。
+7. 如果需要恢复点或多机同步，则使用 `Git 备份`。
 
 ## 主导航
 
@@ -29,5 +31,6 @@ Skills-Manager-Plus 的核心思路是：先维护一个中央技能库，再决
 - `技能商店`：从外部来源导入新 Skills。
 - `预设`：切换不同工作流配置。
 - `全局工作区`：查看并管理每个已安装 Agent 的全局本地技能。
+- `远程工作区`：连接 SSH 主机，并以先备份后写入的方式管理远程 Agent 全局 Skills。
 - `项目工作区`：检查和同步仓库本地 Skills。
 - `设置`：配置路径、工具、同步、搜索 Key 和环境行为。

docs/usage/zh-CN/remote-workspace.md

@@ -0,0 +1,69 @@
+# 远程工作区
+
+`远程工作区` 用来管理 SSH 主机上的 Agent 全局 Skills。它是远程管理入口，不是本地/远程双向同步系统。
+
+## 主机设置
+
+在 `远程工作区` 中添加主机时，需要填写：
+
+- 主机名或 IP 地址。
+- SSH 端口。
+- 用户名。
+- 密码或私钥认证信息。
+- 可选的 SSH config 导入，用于复用本机 SSH config 中已有的主机配置。
+
+连接测试会验证 SSH 登录，并在扫描 Skills 前识别远程用户主目录。
+
+## 凭据行为
+
+远程凭据通过操作系统凭据存储保存。密码是否保存由你选择。编辑主机时，已保存的密钥或密码不会回显到表单中；只有在需要替换凭据时才需要重新输入。
+
+## 扫描
+
+扫描只检查支持工具的远程 Agent 全局 Skills 目录，例如 Codex 或 Claude Code。它不会扫描远程项目工作区、任意目录、Git 仓库、插件市场或 ClawHub 来源。
+
+扫描结果会记录每个发现的远程 Skill、所属 Agent、路径和最近扫描时间。
+
+## 从 Skills 中心安装
+
+使用 `安装` 可以把本地 Skills 中心里的某个 Skill 复制到选中的远程 Agent 全局 Skills 目录。如果目标 Skill 已存在，远程工作区会先创建远程备份，再替换目录。
+
+## 从 Skills 中心更新
+
+V1 的远程更新是保守策略：只有当本地 Skills 中心里存在唯一一个同名且已启用的 Skill 时，才允许更新远程 Skill。替换前会先备份现有远程目录。
+
+远程更新不会直接从远程 Skill 的原始 Git、插件或 ClawHub 来源拉取内容。
+
+## 带备份删除
+
+删除远程 Skill 时，会先在远程主机上创建备份，然后再删除选中的远程目录。备份位置为：
+
+```text
+~/.skills-manager-plus/backups/remote/<host-id>/<agent-id>/<skill-name>/<timestamp>
+```
+
+操作日志会记录备份路径，便于之后定位保留的副本。
+
+## 操作日志
+
+远程工作区会记录安装、更新、删除和失败事件，包括操作类型、状态、时间戳、错误信息以及已创建的备份路径。
+
+## CLI 只读命令
+
+CLI 支持远程工作区的只读检查：
+
+```bash
+skills-manager-plus-cli remote hosts list
+skills-manager-plus-cli remote hosts test <host-id-or-name>
+skills-manager-plus-cli remote scan <host-id-or-name>
+skills-manager-plus-cli remote skills list <host-id-or-name>
+```
+
+这些命令使用已保存的主机配置和凭据，不会安装、更新或删除远程 Skills。
+
+## V1 非目标
+
+- 不提供本地/远程双向同步。
+- 不支持远程项目工作区。
+- 不支持跨多主机批量操作。
+- 不支持直接从远程 Git、插件市场或 ClawHub 更新。