recap-setup

用途

recap-setup 是 Recap Studio 的配置初始化技能。当用户输入 /recap setup、/recap config，或要求 Recap Studio 进行“配置”“初始化”“设置默认值”时触发。它负责生成并校验 Recap Studio 的配置文件 recap-studio.config.ts，并确保副作用（部署、邮件、网络）在用户主动选择前保持关闭。

主要能力

生成配置文件：若 recap-studio.config.ts 不存在，则从仓库根目录复制 recap-studio.config.example.ts，或调用 @recap-studio/content-pipeline/config 中的 renderConfigSource(DEFAULT_CONFIG)，写入仓库根目录。该文件被 gitignore，因此本地选择不会随仓库发布。
校验配置：使用 RecapStudioConfig（zod schema）校验文件。
检查环境变量：列出哪些可选键已存在，但不打印其值，也绝不记录密钥。
输出“已启用项”摘要，包括：
- deploymentMode：disabled / preview / production-with-confirmation
- emailMode：disabled / draft / send-with-confirmation
- costMode：economy / balanced / premium
- researchIntensity：fast / balanced / deep
缺失密钥处理：若某个标志被设置为需要密钥的模式但密钥缺失，不修改文件，而是打印所需的具体键名。

使用方式

用户通过输入 /recap setup 或 /recap config 触发，或直接要求 Recap Studio 配置、初始化、设置默认值。技能会按上述流程生成或校验配置文件，并输出摘要。

安全默认值（模板）

import type { RecapStudioConfig } from "@recap-studio/content-pipeline";

export const config: RecapStudioConfig = {
  contentLength: "medium",
  explanationDepth: "beginner",
  researchIntensity: "balanced",
  theme: "dark",
  animationIntensity: "low",
  visualDensity: "medium",
  deploymentMode: "disabled",
  emailMode: "disabled",
  citationStrictness: "strict",
  costMode: "balanced",
  modelRouting: "auto",
  sourceFreshnessRequired: true,
};

export default config;

硬性规则

绝不写入 .env 文件，而是打印用户可以设置哪些环境变量键。
绝不自动启用 deploymentMode: production-with-confirmation。
绝不自动启用 emailMode: send-with-confirmation。
始终保留任何已存在的 recap-studio.config.ts；如需更改，写入 .next 差异文件并请用户合并。

适用场景

适用于首次为 Recap Studio 建立配置、检查当前配置启用了哪些模式、确认环境变量准备情况，以及在需要修改配置时安全地生成差异文件供用户合并。

限制

该技能不会写入 .env 文件，不会自动开启生产部署或邮件发送模式，也不会覆盖已有的配置文件。关于具体环境变量键名、各模式的详细行为、依赖包版本等信息，资料中暂未提供。