{
  "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": [
      "You forget a thousand things every day. Make sure this is one of 'em",
      "Connecting to 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` 设置进行配置。
     - 范围：允许为项目的特定组件、模块或子部分提供高度特定的指令。
- **连接和 UI 指示：** 所有找到的上下文文件的内容都会被连接（带有分隔符指示其来源和路径）并作为系统提示的一部分提供。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 命令和文件修改），以保护你的系统。

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

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

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

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

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

BUILD_SANDBOX=1 qwen -s

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