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/ 目录下：

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

安全扫描

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

检测能力

风险等级

下载时自动扫描

当你运行 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。