Skip to content

remote-workspace.md

Latest commit

 

History

History
69 lines (42 loc) · 2.54 KB

remote-workspace.md

File metadata and controls

69 lines (42 loc) · 2.54 KB
Raw

远程工作区

远程工作区 用来管理 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 时，会先在远程主机上创建备份，然后再删除选中的远程目录。备份位置为：

~/.skills-manager-plus/backups/remote/<host-id>/<agent-id>/<skill-name>/<timestamp>

操作日志会记录备份路径，便于之后定位保留的副本。

操作日志

远程工作区会记录安装、更新、删除和失败事件，包括操作类型、状态、时间戳、错误信息以及已创建的备份路径。

CLI 只读命令

CLI 支持远程工作区的只读检查：

smp remote hosts list
smp remote hosts test <host-id-or-name>
smp remote scan <host-id-or-name>
smp remote skills list <host-id-or-name>

这些命令使用已保存的主机配置和凭据，不会安装、更新或删除远程 Skills。

V1 非目标

  • 不提供本地/远程双向同步。
  • 不支持远程项目工作区。
  • 不支持跨多主机批量操作。
  • 不支持直接从远程 Git、插件市场或 ClawHub 更新。