Settings Storage and Sync zh CN

设置、存储与同步

English · 返回首页

设置页标题栏支持关键词搜索，可以直接过滤并跳转到设置项。

设置索引

区块	用途
渠道	模型、API、工具模式、重试和自定义请求字段
工具	启用工具、工具参数和单回合调用限制
自动执行	决定哪些工具直接执行或需要确认
MCP	添加和管理 MCP Server
存档点	自动 checkpoint、排除规则、恢复点预览与清理
总结	自动总结阈值、模型和提示词
图像生成 / 依赖	图像服务和可选工具依赖
上下文	文件树、标签页、诊断和固定文件
提示词	模式、模板、预设条目、变量和工具策略
Token 计数	各渠道计数方式
Sub-Agents	专用代理、工具范围、运行和模型策略
声音 / 外观	通知音、语言、动画、TPS 与流式效果
用量统计	Token、成本估算和 IDE 使用时间
记忆	OptMem 提示词、原始条目和运行参数
通用	代理、更新、存储路径与设置导入导出

VS Code Settings Sync

大部分设置位于 graycode.* 命名空间，可以随 VS Code Settings Sync 同步，包括工具开关、自动执行策略、提示词、UI 偏好、Token 计数和图像工具配置。

以下机器级设置不参与同步：

• graycode.proxy
• graycode.storagePath
• graycode.activeChannelId

这可以避免不同设备的代理端口、数据目录和当前渠道互相覆盖。

本地数据与存储路径

对话历史、存档点、永久记忆和部分运行数据保存在本地。在 设置 → 通用 中可以更改数据存储路径并迁移数据；迁移后通常需要重新加载窗口。

更改路径或清理数据前建议先做文件系统级备份。不要在同步盘仍在写入时并发移动同一数据目录。

设置导入与导出

可以从 设置 → 通用 或命令面板执行 GrayCode: 导出设置 / GrayCode: 导入设置。导出内容包括渠道、MCP、Skills 和 VS Code 设置，并支持跳过已有项或覆盖导入。

设置导出不包含：

• 对话历史
• 存档点
• 永久记忆原始数据
• 工作区文件

这些数据需要通过存储路径迁移或单独备份。

存档点

存档点用于恢复工具执行或关键消息前后的工作区状态。可以配置自动创建时机、包含的工具和排除规则，也可以从输入区手动创建。恢复前应保存或处理编辑器中的未保存文件。

存档点不是完整的版本控制替代品。重要代码仍应使用 Git 提交和远端备份。

旧版本迁移

升级旧版本时，GrayCode 会尝试把旧的 globalStorage/settings/settings.json 迁移到 VS Code Settings，并将旧文件备份为 settings.json.bak。迁移后若设置异常，先检查工作区级设置是否覆盖全局设置，再考虑导入备份。