mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-04-26 12:22:43 +08:00
0fcb1b01e2
* docs: add user manual documentation Add comprehensive user manual covering getting started, provider management, extensions (MCP/prompts/skills), proxy configuration, and FAQ sections. Includes screenshots and a README index. * fix(docs): align user manual with v3.10.3 codebase - Add OpenCode as 4th supported app throughout all docs - Fix proxy default port 15762 → 15721 - Update Claude presets (9 → 26), Codex (3 → 10), Gemini (3 → 7) - Add OpenCode presets (25 entries) - Fix timeout defaults and ranges (stream first byte 60s/90s, etc.) - Fix circuit breaker defaults with per-app values (Claude vs general) - Fix Skills support: all 4 apps, not just Claude/Codex - Remove non-existent Gemini authMode field - Fix prompt deletion behavior: enabled prompts cannot be deleted - Remove non-existent Legacy deeplink protocol, use V1 only - Fix DB table names (usage_logs → proxy_request_logs) and add missing tables - Fix migration version v3.8.0 → v3.7.0 - Add missing V1 deeplink parameters (config, configFormat, etc.) - Update doc version v3.9.1 → v3.10.3 - Add claude-opus-4-1 to pricing table - Fix recovery wait time range 10-300 → 0-300 --------- Co-authored-by: Jason <farion1231@gmail.com>
200 lines
3.7 KiB
Markdown
200 lines
3.7 KiB
Markdown
# 3.3 Skills 技能管理
|
||
|
||
## 功能说明
|
||
|
||
Skills 是可复用的能力扩展，让 AI 工具获得特定领域的专业能力。
|
||
|
||
技能以文件夹形式存在，包含：
|
||
- 提示词模板
|
||
- 工具定义
|
||
- 示例代码
|
||
|
||
## 支持的应用
|
||
|
||
Skills 功能支持所有四种应用：
|
||
- **Claude Code**
|
||
- **Codex**
|
||
- **Gemini CLI**
|
||
- **OpenCode**
|
||
|
||
## 打开 Skills 页面
|
||
|
||
点击顶部导航栏的 **Skills** 按钮。
|
||
|
||
> 注意：Skills 按钮在所有应用模式下均可见。
|
||
|
||
## 页面概览
|
||
|
||
|
||
|
||
## 发现技能
|
||
|
||
### 预配置仓库
|
||
|
||
CC Switch 预配置了以下 GitHub 仓库：
|
||
|
||
| 仓库 | 说明 |
|
||
|------|------|
|
||
| Anthropic 官方 | Anthropic 提供的官方技能 |
|
||
| ComposioHQ | 社区维护的技能集合 |
|
||
| 社区精选 | 精选的高质量技能 |
|
||
|
||
|
||
|
||
### 搜索过滤
|
||
|
||
CC Switch 提供强大的搜索和过滤功能：
|
||
|
||
#### 搜索框
|
||
|
||
- 支持按技能名称搜索
|
||
- 支持按技能描述搜索
|
||
- 支持按目录名称搜索
|
||
- 实时过滤，输入即搜索
|
||
|
||
#### 状态过滤
|
||
|
||
使用下拉菜单按安装状态过滤：
|
||
|
||
| 选项 | 说明 |
|
||
|------|------|
|
||
| 全部 | 显示所有技能 |
|
||
| 已安装 | 仅显示已安装的技能 |
|
||
| 未安装 | 仅显示未安装的技能 |
|
||
|
||
|
||
|
||
#### 组合使用
|
||
|
||
搜索和过滤可以组合使用：
|
||
- 先选择「已安装」过滤
|
||
- 再输入关键词搜索
|
||
- 结果显示匹配数量
|
||
|
||
### 刷新列表
|
||
|
||
点击「刷新」按钮重新扫描仓库，获取最新技能。
|
||
|
||
## 安装技能
|
||
|
||
### 操作步骤
|
||
|
||
1. 找到要安装的技能卡片
|
||
2. 点击「安装」按钮
|
||
3. 等待安装完成
|
||
|
||
### 安装位置
|
||
|
||
| 应用 | 安装目录 |
|
||
|------|----------|
|
||
| Claude | `~/.claude/skills/` |
|
||
| Codex | `~/.codex/skills/` |
|
||
| Gemini | `~/.gemini/skills/` |
|
||
| OpenCode | `~/.opencode/skills/` |
|
||
|
||
### 安装内容
|
||
|
||
安装会将技能文件夹复制到本地：
|
||
|
||
```
|
||
~/.claude/skills/
|
||
└── skill-name/
|
||
├── README.md
|
||
├── prompt.md
|
||
└── tools/
|
||
└── ...
|
||
```
|
||
|
||
## 卸载技能
|
||
|
||
### 操作步骤
|
||
|
||
1. 找到已安装的技能卡片
|
||
2. 点击「卸载」按钮
|
||
3. 确认卸载
|
||
|
||
### 卸载效果
|
||
|
||
- 删除本地技能文件夹
|
||
- 更新安装状态
|
||
|
||
## 仓库管理
|
||
|
||
### 打开仓库管理
|
||
|
||
点击页面顶部的「仓库管理」按钮。
|
||
|
||
### 添加自定义仓库
|
||
|
||
1. 点击「添加仓库」
|
||
2. 填写仓库信息：
|
||
- Owner：GitHub 用户名或组织名
|
||
- Name：仓库名称
|
||
- Branch：分支名（默认 main）
|
||
- Subdirectory：技能所在子目录（可选）
|
||
3. 点击「添加」
|
||
|
||
### 仓库格式
|
||
|
||
```
|
||
https://github.com/{owner}/{name}/tree/{branch}/{subdirectory}
|
||
```
|
||
|
||
示例：
|
||
```
|
||
Owner: anthropics
|
||
Name: claude-skills
|
||
Branch: main
|
||
Subdirectory: skills
|
||
```
|
||
|
||
### 删除仓库
|
||
|
||
1. 在仓库列表中找到要删除的仓库
|
||
2. 点击「删除」按钮
|
||
3. 确认删除
|
||
|
||
删除仓库后，该仓库的技能不会从列表中消失，但无法再更新。
|
||
|
||
## 技能卡片信息
|
||
|
||
每个技能卡片显示：
|
||
|
||
| 信息 | 说明 |
|
||
|------|------|
|
||
| 名称 | 技能名称 |
|
||
| 描述 | 功能说明 |
|
||
| 来源 | 所属仓库 |
|
||
| 状态 | 已安装 / 未安装 |
|
||
|
||
## 技能更新
|
||
|
||
目前不支持自动更新。如需更新技能：
|
||
|
||
1. 卸载现有技能
|
||
2. 刷新列表
|
||
3. 重新安装
|
||
|
||
### 技能列表为空
|
||
|
||
可能原因：
|
||
- 网络问题，无法访问 GitHub
|
||
- 仓库配置错误
|
||
|
||
解决方法：
|
||
- 检查网络连接
|
||
- 点击「刷新」重试
|
||
- 检查仓库配置
|
||
|
||
### 安装失败
|
||
|
||
可能原因：
|
||
- 网络问题
|
||
- 磁盘空间不足
|
||
- 权限问题
|
||
|
||
解决方法：
|
||
- 检查网络连接
|
||
- 检查磁盘空间
|
||
- 检查目录权限
|