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。