Settings Reference

设置项参考

🚀 入门 · 🏠 首页 › Settings-Reference

---

📑 本页目录

• 1. LLM
• 2. Agent
• 3. 上下文与工具输出
• 4. 终端
• 5. 权限相关
• 6. 记忆（cs-mem）
• 7. GitHub
• 8. 相关页面

设置屏（ui/screen/settings/ + SettingsRepository.kt）里每一项的含义与边界值。

1. LLM

项	说明	边界 / 默认
预设 Provider	OpenAI / DeepSeek / OpenRouter / Ollama / 自定义	见 LLM 适配层
Base URL	以 /v1 结尾的兼容端点	局域网 Ollama：http://<pc-ip>:11434/v1
API Key	存应用私有目录	建议用限流子 Key；不要用主 Key
模型名	例如 deepseek-chat、qwen2.5:72b	由端点决定
温度	temperature	默认 0.7
连接测试	发送 Say 'OK' in one word. 验证	未配置时注入 NoOpLlmClient

2. Agent

项	说明	默认
模式	Build / Plan / Spec / Reflect / Assist / Custom	BUILD
提示词思考	ThinkingLevel NONE→MAXIMUM	STANDARD
原生思考	ReasoningEffort NONE/LOW/MEDIUM/HIGH/MAX	NONE
自定义指令	Custom 模式的附加指令，持久化键 custom_mode_instruction	空
工具白名单	AgentConfig.enabledToolIds 过滤	全部

3. 上下文与工具输出

项	说明	边界值
Max Tool Output Length	工具输出单次截断上限	200 .. 100_000，默认 maxToolOutputLength = 2000
上下文窗口	maxContextTokens / LlmConfig.contextWindow	128000
压缩水位	compressionThreshold	0.8（×128k）
免压缩轮数	preserveRecentTurns	5

Caution

把 Max Tool Output Length 调到很小（如 200）曾触发截断器反向膨胀 （head+tail 大于 maxChars，省略计数为负）。已在混沌审计中修复，但仍建议用默认值。 见 混沌工程。

4. 终端

项	说明	默认
vibrateOnBell	收到 BEL（0x07）时振动 30ms	开
keepScreenOn	终端屏保持常亮（FLAG_KEEP_SCREEN_ON，离屏必还原）	关
终端缓冲行数	可配到 10000 行（渲染层需注意虚拟化）	—
桌面模式 / UA	Chrome 层桌面模式（UA 切换 + reload）	首次 bind 捕获原始 UA
网页权限	三档：拒绝 / 仅此一次 / 总是允许（按 origin 持久化）	安全拒绝

5. 权限相关

项	说明
Shizuku	三态卡片（已授权 / 可获取 / 不可用），未安装时跳转 ACTION_VIEW（有 ActivityNotFoundException 防护）
无障碍	开启后启用 ui_* 工具与 cs-mem 屏幕感知
悬浮窗	悬浮球与浮窗 UI 所需
通知	Android 13+ 需 POST_NOTIFICATIONS，否则前台服务通知不可见

6. 记忆（cs-mem）

项	说明
记忆屏	Episode 统计 / 宏技能数 / 近期情景 / 删除（删除有确认弹窗）
梦境渲染	受 WorkManager 约束（息屏 + 充电 + WiFi + 电量），无用户开关

7. GitHub

项	说明
PAT	经 EncryptedSharedPreferences（AES-256-GCM）；输入对话框会做 ghp_ / github_pat_ 预检 + suspend 校验
7 个工具	github_get_user / list_repos / read_file / write_file / create_issue / list_issues / search_code（配置后注册）

8. 相关页面

• 快速开始 · LLM 适配层 · 上下文压缩
• 安全与隐私 · 故障排查

---

🏠 返回首页 · 📚 文档索引 · ❓ FAQ · 🔧 故障排查 · 🗺️ 路线图 · 🐛 提 Issue

_{Android Guru Agent · v1.4.4 · Kotlin 2.0.21 · Compose · PRoot · Room}