返回 DeepSeek-Reasonix
REASONING_LANGUAGE.zh-CN.md
根目录 / docs / REASONING_LANGUAGE.zh-CN.md
1 # 思考语言
2
3 <a href="./GUIDE.zh-CN.md">使用指南</a>
4 &nbsp;·&nbsp;
5 <a href="./REASONING_LANGUAGE.md">English</a>
6
7 `agent.reasoning_language` 控制模型服务暴露“可见思考过程”时，Reasonix 希望它优先使用哪种语言。
8
9 它不设置最终回答语言，不翻译代码、标识符或文件路径，也不改变模型内部不可见推理。用户在单次提问里明确要求的最终回答语言，仍然优先。
10
11 ## 为什么需要它
12
13 有些用户希望可见思考过程更稳定地使用中文或英文，即使任务本身混合了多种语言。这个设置把这种偏好显式化，同时不改稳定 system prompt，也不改工具 schema。
14
15 取值只有三种：
16
17 - `auto`：用户原始提问明显为中文时锚定中文，并忽略 `@file` 等注入的引用内容；英文或不确定时不额外注入语言指令。
18 - `zh`：可见思考过程优先使用简体中文。
19 - `en`：可见思考过程优先使用英文。
20
21 ## 桌面端
22
23 入口：
24
25 ```text
26 设置 -> 模型 -> 使用 -> Agent 运行 -> 思考语言
27 ```
28
29 桌面端设置会写入用户级默认值。项目仍然可以通过 `./reasonix.toml` 覆盖。
30
31 ## CLI 与 TUI
32
33 在 shell 或脚本里修改：
34
35 ```bash
36 reasonix config reasoning-language auto
37 reasonix config reasoning-language zh
38 reasonix config reasoning-language en
39 ```
40
41 默认写入用户配置。要写入当前项目的覆盖配置：
42
43 ```bash
44 reasonix config reasoning-language --local zh
45 ```
46
47 在 `reasonix` 内可以用斜杠命令：
48
49 ```text
50 /reasoning-language auto
51 /reasoning-language zh
52 /reasoning-language en
53 ```
54
55 斜杠命令会写入用户级设置，并立即更新当前 chat controller，后续 turn 生效。它不会改写当前项目的 `reasonix.toml`；如果要写项目级覆盖，请使用带 `--local` 的 shell 命令。
56
57 单次 headless 运行也会读取同一设置：
58
59 ```bash
60 reasonix run "解释这个模块"
61 ```
62
63 ## 配置文件
64
65 用户级或项目级配置：
66
67 ```toml
68 [agent]
69 reasoning_language = "auto" # auto|zh|en
70 ```
71
72 这个设置的配置优先级是：
73
74 ```text
75 ./reasonix.toml > 用户 config.toml > 内置默认值
76 ```
77
78 目前没有为它提供命令行 flag。它更像用户偏好或项目偏好，不适合作为每次运行都传一次的任务参数。
79
80 ## 缓存影响
81
82 `auto` 仍然对缓存友好。用户原始提问明显是中文时，Reasonix 会为这一轮加入同样很小的 `<reasoning-language>` 临时 block；英文或信号不明确时不注入，只复用已有的稳定语言策略。`@file` 等注入的引用内容不会参与这个自动判断。
83
84 当设置为 `zh` 或 `en` 时，Reasonix 总是会把一个很小的 `<reasoning-language>` 临时 block 放进本次 user turn。所有模式下，它都不会改变：
85
86 - system prompt
87 - 工具 schema 的字节或顺序
88 - provider 可见的稳定前缀
89
90 因此它能在表达明确偏好的同时，尽量保持高 prompt-cache 命中率。
91
92 ## 边界
93
94 - 只有模型服务暴露可见思考文本时，这个设置才有意义。
95 - 它是偏好，不是强制翻译层。
96 - 代码、标识符、文件路径、shell 命令和未翻译技术术语应保留原样。
97 - 如果用户在某次提问中明确要求最终回答使用某种语言，最终回答仍以用户要求为准。
98 - 可见思考的语言主要由两个信号锚定：本轮第一段思考的语言，以及工具调用循环中回传给模型的既有思考段落的语言。注入的语言 block 的作用点是让第一段思考落在偏好语言上；第一段站稳后，后续段落通常会自我维持。
99 - 在被另一种语言主导的长回合里（例如大量英文构建日志、代码或工具输出），后续某一段思考仍可能漂移；一旦漂移，本轮剩余部分通常保持漂移后的语言，中途重申偏好也只能部分拉回。这是模型行为的边界，该设置保持尽力而为。
100
100 lines MARKDOWN