skill-vision-control

🚀 技能视觉控制 (SVC)

安全的MCP技能版本管理工具，可检测更新、进行并行测试、智能合并，并在替换前确认

🚀 快速开始

以下是一些基本操作的示例，帮助你快速上手SVC：

# 添加一个技能进行管理
svc add weather --source github:username/weather-mcp

# 检查更新
svc check

# 下载新版本（保留旧版本）
svc download weather

# 测试并切换版本
svc switch weather --version v1.1.0

# 如果你有自定义更改，可以进行合并
svc merge weather

✨ 主要特性

• 🔍 更新检测 - 自动从GitHub/npm检测新版本。
• 🛡️ 安全扫描 - 下载前自动扫描（集成Sentinel）。
• 📦 版本管理 - 保留多个版本，可随时切换。
• 🔀 智能合并 - 将官方更新与你的自定义更改合并。
• 🧪 A/B测试 - 在切换前测试新版本。
• ⏰ 定时检查 - 自动进行每周/每月更新检查。
• 🔔 通知功能 - 桌面通知更新信息。
• 🤖 MCP服务器 - 让AI管理你的技能。

📦 安装指南

你可以使用npm或yarn进行全局安装：

npm install -g skill-vision-control

或者使用yarn：

yarn global add skill-vision-control

💻 使用示例

基础用法

基本更新流程

# 1. 检查更新
svc check
# 输出: weather: v1.0.0 → v1.1.0 可用

# 2. 下载（保留旧版本）
svc download weather

# 3. 测试新版本
svc switch weather -v v1.1.0 -t official

# 4. 如果没问题，确认；如果有问题，回滚
svc confirm weather
# 或者
svc rollback weather

安装前安全审计

# 在安装前扫描技能
svc scan ~/Downloads/some-mcp-skill

# 输出:
# 🛡️  Sentinel安全扫描报告
# ══════════════════════════════════════════════════
# 风险等级: 中等
# 建议: 审查
# 
# ⚠️  可疑项: 发现3项
#    - src/api.ts:15 - 网络请求 (axios)
#    - src/config.ts:8 - 环境变量访问

# 审计所有已安装的技能
svc audit

# 详细审计特定技能
svc audit weather -v

自定义更改与更新

# 1. 创建自定义分支
svc fork weather

# 2. 进行你的修改...
# 3. 保存更改
svc save weather -c "添加中文语言支持"

# 4. 之后，当有更新可用时
svc check
# 输出: ⚠️ 你有自定义更改。使用 "svc merge"

# 5. 下载并合并
svc download weather
svc merge weather

# 6. 如果存在冲突
svc conflicts weather
svc resolve weather -f src/config.ts -u custom

# 7. 测试合并后的版本
svc switch weather -v v1.1.0-merged -t merged

# 8. 确认
svc confirm weather

高级用法

作为MCP服务器使用

将以下内容添加到你的MCP配置中：

{
  "mcpServers": {
    "skill-vision-control": {
      "command": "svc",
      "args": ["serve"]
    }
  }
}

可用的MCP工具：

• svc_list_skills - 列出所有管理的技能
• svc_get_skill_info - 获取技能详细信息
• svc_check_updates - 检查更新
• svc_get_versions - 获取本地版本
• svc_switch_version - 切换版本
• svc_rollback - 回滚到上一个版本
• svc_download_update - 下载新版本
• svc_merge - 与自定义更改合并
• svc_get_conflicts - 查看合并冲突

📚 详细文档

命令说明

技能管理

| 命令 | 描述 | |---------|-------------| | svc add <name> --source <url> | 注册一个技能 (github:user/repo 或 npm:package) | | svc list | 列出所有管理的技能 | | svc info <name> | 显示详细信息 | | svc remove <name> | 删除一个技能 |

版本控制

| 命令 | 描述 | |---------|-------------| | svc check [name] | 检查更新 | | svc download <name> | 下载新版本（保留旧版本） | | svc versions <name> | 列出所有本地版本 | | svc switch <name> -v <version> | 切换到特定版本 | | svc rollback <name> | 回滚到上一个版本 | | svc confirm <name> | 确认当前版本 | | svc cleanup <name> --keep <n> | 清理旧版本 |

自定义修改

| 命令 | 描述 | |---------|-------------| | svc fork <name> | 创建自定义分支进行修改 | | svc save <name> -c "comment" | 保存你的修改 | | svc diff <name> | 查看与官方版本的差异 | | svc merge <name> | 将官方更新与你的更改合并 | | svc conflicts <name> | 查看合并冲突 | | svc resolve <name> -f <file> -u <choice> | 解决冲突 |

定时任务

| 命令 | 描述 | |---------|-------------| | svc schedule set -i <days> | 设置检查间隔 (1/7/14/30 天) | | svc schedule show | 显示当前定时设置 | | svc schedule enable | 启用定时检查 | | svc schedule disable | 禁用定时检查 | | svc schedule run | 手动触发检查 |

安全扫描

| 命令 | 描述 | |---------|-------------| | svc scan <path> | 扫描任何技能目录的安全问题 | | svc audit [name] | 审计已安装的技能 | | svc download <name> --skip-security | 不进行安全扫描下载（不推荐） |

数据存储

所有数据存储在 ~/.svc/ 目录下：

~/.svc/
├── skills.json      # 技能注册表
├── schedule.json    # 定时设置
├── config.json      # 全局配置
└── versions/        # 版本存储
    └── <skill>/
        ├── official/
        ├── custom/
        ├── merged/
        └── active -> ...

安全扫描

SVC集成了 Sentinel 安全模式进行自动代码扫描。

检测能力

| 级别 | 描述 | 示例 | |-------|-------------|----------| | CRITICAL | 高风险模式 | eval(), exec(), rm -rf, 注册表访问 | | SUSPICIOUS | 需要审查 | 网络请求、环境变量、文件操作 | | WARNING | 潜在问题 | 长行代码、高熵文件 |

风险等级

| 级别 | 操作建议 | |-------|--------| | SAFE | 可以安全安装 | | LOW | 有轻微问题，建议审查 | | MEDIUM | 安装前需要审查 | | HIGH | 检测到重大风险 | | CRITICAL | 未经仔细审查请勿安装 |

下载时自动扫描

当你运行 svc download 时，会自动进行安全扫描：

svc download weather
# 🛡️  正在运行安全扫描...
# ✅ 安全扫描通过
# ✓ 下载完成

如果发现问题：

svc download untrusted-skill
# 🛡️  正在运行安全扫描...
# 🛑 安全扫描发现严重问题！
# ? 你是否仍要继续？（不推荐） (y/N)

若要跳过扫描（不推荐）：

svc download weather --skip-security

配置说明

支持的源

• GitHub: github:username/repo 或 username/repo
• npm: npm:package-name

定时选项

• 1d - 每日检查
• 7d - 每周检查（默认）
• 14d - 每两周检查
• 30d - 每月检查

📄 许可证

本项目采用MIT许可证，详情请见 LICENSE 文件。

贡献说明

欢迎贡献代码！请随时提交Pull Request。