跳转到主要内容

自动启动配置

自动启动配置允许您在打开工作区时自动启动 YouCode 任务，支持特定的配置文件和模式。这最初是作为一个内部测试功能开发的，但我们决定将其开放给用户使用，以防有人觉得它有用！

自动启动配置对于针对多个模型或项目目录测试相同的提示特别有用。

工作原理​

当您在 VS Code 中打开工作区时，YouCode 会自动检查启动配置 JSON 文件。如果找到，它会：

  • 切换到指定的提供程序配置文件（如果提供）
  • 更改为指定的模式（如果提供）
  • 使用您预定义的提示启动任务

这一切都在后台无缝发生，无需手动干预。

创建启动配置​

基本设置​

  1. 在您的工作区根目录中创建 .youcode 目录（如果尚不存在）
  2. 在 .youcode 目录内创建 launchConfig.json 文件
  3. 使用下面的 JSON 格式配置您的启动设置

配置格式​

{
	"prompt": "您的任务描述在这里",
	"profile": "配置文件名称（可选）",
	"mode": "模式名称（可选）"
}

必填字段​

  • prompt (字符串)：工作区打开时将发送给 AI 的任务消息

可选字段​

  • profile (字符串)：要用于此任务的现有 YouCode API 配置配置文件的名称。必须与设置中的配置文件名称完全匹配。

  • mode (字符串)：要用于此任务的 YouCode 模式。可用模式：

    • "code" - 通用编码任务
    • "architect" - 规划和技术设计
    • "ask" - 问题和解释
    • "debug" - 问题诊断和故障排除
    • "test" - 以测试为中心的工作流程
    • 自定义模式（如果您有自定义模式）

配置示例​

基本任务启动​

{
	"prompt": "审查此代码库并建议性能和可维护性的改进"
}

特定配置文件任务启动​

{
	"prompt": "为 src/ 目录中的所有组件创建全面的单元测试",
	"profile": "kimi-k2",
	"mode": "code"
}

模型比较设置​

{
	"prompt": "优化此算法以获得更好的时间复杂度并解释您的方法",
	"profile": "qwen-3.5",
	"mode": "code"
}

使用场景​

开发工作流程​

  • 项目模板：在项目模板中包含启动配置，以立即获得适当的 AI 协助
  • 代码审查：在打开拉取请求分支时自动触发代码审查任务
  • 文档：为新项目启动文档生成任务

测试和比较​

  • 模型测试：创建不同的配置来测试各种 AI 模型如何处理相同的提示
  • A/B 测试：通过在不同的配置文件和模式之间切换来比较方法
  • 基准测试：系统地测试不同场景下的 AI 性能

团队协作​

  • 一致设置：确保所有团队成员在特定项目中使用相同的 AI 配置
  • 入职：帮助新团队成员自动以最佳 AI 设置开始
  • 标准：通过使用特定的配置文件和模式启动来强制执行编码标准

文件位置​

配置文件必须位于：

your-workspace/
└── .youcode/
    └── launchConfig.json

此文件应位于您的工作区根目录（与主项目文件同级）。

行为和时序​

  • 自动启动在 YouCode 扩展激活后大约 500ms 触发
  • 侧边栏在任务启动前自动接收焦点
  • 配置文件切换发生在模式切换之前（如果两者都指定）
  • 任务在所有配置更改应用后启动
  • 如果配置文件或模式切换失败，任务将继续使用当前设置

故障排除​

配置未加载​

  1. 验证文件位置：在工作区根目录 .youcode/launchConfig.json
  2. 使用 JSON 验证器检查 JSON 语法
  3. 确保字段存在且不为空 prompt
  4. 检查 VS Code 开发者控制台中的错误消息

配置文件未切换​

  1. 验证配置文件名称与设置中的名称完全匹配
  2. 配置文件名称区分大小写，必须完全匹配（包括表情符号）

模式未切换​

  1. 验证模式名称是否有效（code、architect、ask、debug、test）
  2. 对于自定义模式，请使用配置中的确切模式别名
  3. 模式名称区分大小写，应为小写