{
  "model": {
    "generationConfig": {
      "timeout": 60000,
      "disableCacheControl": false,
      "samplingParams": {
        "temperature": 0.2,
        "top_p": 0.8,
        "max_tokens": 1024
      }
    }
  }
}

{
  "general": {
    "vimMode": true,
    "preferredEditor": "code"
  },
  "ui": {
    "theme": "GitHub",
    "hideBanner": true,
    "hideTips": false,
    "customWittyPhrases": [
      "你每天都会忘记一千件事。确保这件事是其中之一",
      "正在连接到 AGI"
    ]
  },
  "tools": {
    "approvalMode": "yolo",
    "sandbox": "docker",
    "discoveryCommand": "bin/get_tools",
    "callCommand": "bin/call_tool",
    "exclude": ["write_file"]
  },
  "mcpServers": {
    "mainServer": {
      "command": "bin/mcp_server.py"
    },
    "anotherServer": {
      "command": "node",
      "args": ["mcp_server.js", "--verbose"]
    }
  },
  "telemetry": {
    "enabled": true,
    "target": "local",
    "otlpEndpoint": "http://localhost:4317",
    "logPrompts": true
  },
  "privacy": {
    "usageStatisticsEnabled": true
  },
  "model": {
    "name": "qwen3-coder-plus",
    "maxSessionTurns": 10,
    "enableOpenAILogging": false,
    "openAILoggingDir": "~/qwen-logs",
    "summarizeToolOutput": {
      "run_shell_command": {
        "tokenBudget": 100
      }
    }
  },
  "context": {
    "fileName": ["CONTEXT.md", "QWEN.md"],
    "includeDirectories": ["path/to/dir1", "~/path/to/dir2", "../path/to/dir3"],
    "loadFromIncludeDirectories": true,
    "fileFiltering": {
      "respectGitIgnore": false
    }
  },
  "advanced": {
    "excludedEnvVars": ["DEBUG", "DEBUG_MODE", "NODE_ENV"]
  }
}

# 项目：我超棒的 TypeScript 库

## 通用说明：
- 在生成新的 TypeScript 代码时，请遵循现有的编码风格。
- 确保所有新增的函数和类都具有 JSDoc 注释。
- 在适当的情况下优先使用函数式编程范式。
- 所有代码应与 TypeScript 5.0 和 Node.js 20+ 兼容。

## 编码风格：
- 使用 2 个空格进行缩进。
- 接口名称应以 `I` 为前缀（例如，`IUserService`）。
- 私有类成员应以下划线（`_`）为前缀。
- 始终使用严格相等（`===` 和 `!==`）。

## 特定组件：`src/api/client.ts`
- 此文件处理所有出站 API 请求。
- 添加新 API 调用函数时，请确保其包含健壮的错误处理和日志记录。
- 对于所有 GET 请求，请使用现有的 `fetchWithRetry` 工具函数。

此示例展示了如何提供通用项目背景、特定编码规范，甚至关于特定文件或组件的说明。上下文文件越相关且精确，AI 越能更好地协助你。强烈建议创建项目特定的上下文文件以建立约定和背景。

- **分层加载与优先级：** CLI 通过从多个位置加载上下文文件（例如 `QWEN.md`）实现了一套复杂的分层内存系统。列表中靠后（更具体）的文件内容通常会覆盖或补充靠前（更通用）的文件内容。可以通过 `/memory show` 命令检查确切的拼接顺序和最终上下文。典型的加载顺序如下：
  1. **全局上下文文件：**
     - 位置：`~/.qwen/<configured-context-filename>`（例如在用户主目录下的 `~/.qwen/QWEN.md`）。
     - 作用范围：为所有项目提供默认指令。
  2. **项目根目录及祖先目录的上下文文件：**
     - 位置：CLI 会在当前工作目录及其上级目录中查找已配置的上下文文件，直到遇到项目根目录（由 `.git` 文件夹标识）或用户的主目录为止。
     - 作用范围：提供整个项目或其重要部分相关的上下文信息。
  3. **子目录上下文文件（局部/上下文相关）：**
     - 位置：CLI 还会在当前工作目录之下的子目录中搜索已配置的上下文文件（遵循如 `node_modules`、`.git` 等常见忽略模式）。默认情况下该搜索限制为最多扫描 200 个目录，但可通过修改 `settings.json` 中的 `context.discoveryMaxDirs` 设置进行调整。
     - 作用范围：允许针对项目的某个特定组件、模块或子部分提供高度具体的指令。
- **拼接与界面提示：** 所有找到的上下文文件的内容会被依次拼接起来（使用分隔符标明来源路径），并作为系统提示的一部分提供给模型。CLI 的底部状态栏会显示已加载的上下文文件数量，让你快速了解当前激活的指令上下文。
- **导入内容：** 可通过 `@path/to/file.md` 语法将其他 Markdown 文件导入到上下文文件中，从而实现模块化管理。更多详情请参阅 [Memory Import Processor 文档](../configuration/memory)。
- **内存管理命令：**
  - 使用 `/memory refresh` 强制重新扫描并从所有配置的位置重新加载上下文文件。这将更新 AI 的指令上下文。
     - 使用 `/memory show` 显示当前加载的所有指令上下文组合结果，方便验证 AI 正在使用的层级结构和具体内容。
     - 更多关于 `/memory` 命令及其子命令（`show` 和 `refresh`）的信息，请参见 [Commands 文档](../features/commands)。

通过理解并利用这些配置层级以及上下文文件的层次特性，你可以有效地管理 AI 的记忆，并根据你的具体需求和项目定制 Qwen Code 的响应行为。

## 沙盒

Qwen Code 可以在沙盒环境中执行潜在的不安全操作（如 shell 命令和文件修改），以保护您的系统。

[Sandbox](../features/sandbox) 默认是禁用的，但您可以通过以下几种方式启用它：

- 使用 `--sandbox` 或 `-s` 标志。
- 设置 `GEMINI_SANDBOX` 环境变量。
- 当使用 `--yolo` 或 `--approval-mode=yolo` 时，默认会启用沙盒。

默认情况下，它使用预构建的 `qwen-code-sandbox` Docker 镜像。

对于项目特定的沙盒需求，您可以在项目的根目录下创建一个自定义的 Dockerfile，路径为 `.qwen/sandbox.Dockerfile`。这个 Dockerfile 可以基于基础沙盒镜像：

# COPY ./my-config /app/my-config

BUILD_SANDBOX=1 qwen -s

{
  "privacy": {
    "usageStatisticsEnabled": false
  }
}