mirror of https://github.com/farion1231/cc-switch.git synced 2026-04-22 17:11:04 +08:00

Files

Dex Miller 0fcb1b01e2 docs: add user manual documentation (#979 )

* 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>

2026-02-09 15:01:15 +08:00

3.4 KiB

Raw Blame History

3.2 Prompts 提示词管理

功能说明

Prompts 功能用于管理系统提示词预设。系统提示词会影响 AI 的行为和回复风格。

通过 CC Switch，你可以：

创建多个提示词预设
快速切换不同场景的提示词
跨设备同步提示词配置

打开 Prompts 面板

点击顶部导航栏的 Prompts 按钮。

面板概览

创建预设

操作步骤

点击右上角 + 按钮
输入预设名称
在 Markdown 编辑器中编写提示词
点击「保存」

Markdown 编辑器

编辑器提供：

语法高亮
实时预览
常用格式快捷键

提示词编写建议

结构化格式：

# 角色定义

你是一个专业的代码审查专家。

## 核心能力

- 代码质量分析
- 性能优化建议
- 安全漏洞检测

## 回复风格

- 简洁明了
- 提供具体示例
- 给出改进建议

## 注意事项

- 不要修改业务逻辑
- 保持代码风格一致

激活预设

操作方式

点击预设项的开关按钮，切换启用状态。

单一激活

同一时间只能激活一个预设。激活新预设时，之前的预设会自动停用。

同步目标

激活后，提示词会写入对应应用的文件：

应用	文件路径
Claude	`~/.claude/CLAUDE.md`
Codex	`~/.codex/AGENTS.md`
Gemini	`~/.gemini/GEMINI.md`
OpenCode	`~/.opencode/AGENTS.md`

编辑预设

点击预设项的「编辑」按钮
修改名称或内容
点击「保存」

如果编辑的是当前激活的预设，保存后会立即同步到配置文件。

删除预设

点击预设项的「删除」按钮
确认删除

已启用的预设不允许删除，需先停用后再删除。

智能回填

CC Switch 提供智能回填保护机制，确保你的手动修改不会丢失。

工作原理

切换预设前，自动读取当前配置文件内容
比较文件内容与数据库中的预设
如果内容不同，说明用户手动修改过
将手动修改的内容保存到当前预设
然后再切换到新预设

保护场景

场景	处理方式
CLI 中直接编辑 `CLAUDE.md`	修改自动保存到当前预设
外部编辑器修改配置文件	修改自动保存到当前预设
切换到其他预设	先保存当前修改，再切换

技术细节

回填机制在以下时机触发：

切换预设时：保存当前 live 文件内容到当前预设
编辑当前预设时：从 live 文件读取最新内容
首次启动时：自动导入现有 live 文件内容

注意事项

回填仅在切换到不同预设时触发
如果当前没有激活的预设，不会触发回填
回填失败不会影响切换流程

跨应用使用

Prompts 是按应用分开管理的：

切换到 Claude 时，显示 Claude 的预设
切换到 Codex 时，显示 Codex 的预设
切换到 Gemini 时，显示 Gemini 的预设
切换到 OpenCode 时，显示 OpenCode 的预设

如需在多个应用使用相同的提示词，需要分别创建。

导入导出

通过深度链接分享

可以生成深度链接分享预设：

ccswitch://import/prompt?data=<base64编码的预设>

通过配置导出

导出配置时会包含所有预设，导入后可恢复。

3.4 KiB Raw Blame History Unescape Escape