astrion-website/demo/content/09-settings.md

个人空间设置全解

个人空间（输入栏 + 菜单 →「个人设置」）共分 12 个标签页（管理员多 1 个）。本章逐页逐项说明每个设置的作用、默认值与使用场景——设置页面里一句话说不清的，都在这里讲透。

约定：「默认」指代码出厂默认值；如果你用过 setup.sh 向导，个别默认值可能被向导的选择覆盖。

---

1. 常规

设置项	默认	说明
自动生成标题	开	首轮对话后自动生成对话标题。关闭后新对话保持「新对话」占位名，需手动重命名

2. 个性化

这一页决定「AI 用什么人格与你相处」。

设置项	默认	作用与场景
启用个性化	关	本页总开关。关闭时下列配置不注入提示词
AI 自称	空	AI 如何称呼自己（≤20 字），如「小A」
称呼你	空	AI 如何称呼你（≤20 字）
职业	空	你的职业（≤20 字）。填了 AI 会按你的背景调整表达深浅——开发者给技术细节，业务人员讲人话
语气	空	8 个预设：健谈 / 幽默 / 直言不讳 / 鼓励性 / 诗意 / 企业商务 / 打破常规 / 同理心
注意事项	空	最强大的一项：最多 10 条、每条 2000 字的长期指令，每轮对话都注入。适合写「回答必须用中文」「代码注释用英文」「我是色弱，图表避免红绿配色」这类长期偏好
交流风格	标准	标准 AI 风格 / 拟人聊天风格 / 自动（按场景切换）
对话连续性	中	高：主动回顾历史对话与记忆；中：平衡；低：每轮对话尽量独立。开了「最近对话提示」却觉得 AI 总是答非所问地提旧事，就把这里调低

3. 模型与思考

设置项	默认	说明
默认模型	模型库第一个可见项	新对话默认使用的模型，可选库中任意已注册模型
默认思考模式	思考	fast / thinking。思考模式质量更高，快速模式响应更快
默认推理强度	默认（不传参）	默认 / 低 / 中 / 高；需模型开启 reasoning_effort 才生效

这里的「默认」都只影响新建对话；已有对话用输入栏的切换器单独调。

4. 外观与显示

设置项	默认	说明
主题配色	经典	经典（暖奶油+暖橙）/ 明亮（冷白+近黑）/ 夜间（中性灰阶）
消息流显示模式	极简模式	传统列表 / 堆叠动画 / 极简模式；极简模式另有「展开时限制最大高度」开关（默认开）
简略消息显示	完整信息	完整原始内容 / 一行概要
堆叠块隐藏边线	关	堆叠模式下隐藏块间边线，更素净
显示助手状态形象	开	对话区的状态头像（可以戳，有彩蛋）
显示 Git 状态栏	开	输入栏上方的 Git 状态条
显示自定义称呼	开	在界面中显示你设置的自称/称呼
增强工具显示	开	工具结果结构化渲染；关掉则更接近原始输出
自动打开终端面板	—	终端任务时自动展开实时终端面板
快捷窗口自动展开	开	Quick Dock 有内容时自动展开；关闭则只能手动点开
隐藏快捷窗口	关	整体关闭 Quick Dock
编辑摘要实时显示	关	开：AI 边改边显示编辑摘要卡片；关：一轮工作完成后统一显示
文件预览自动换行	关	开：预览面板按宽度换行；关：长行横向滚动
侧边栏按工作区分组	关	对话列表按工作区/项目分组；分组模式支持工作区置顶与排序
新建对话按钮行为	跳转空白页	route：跳到空白新对话页 / blank：立即创建空对话

5. 工作区与权限

设置项	默认	说明
默认权限模式	批准	新终端的初始权限模式，四档行为见《核心概念》
默认运行模式	计划	新终端的初始运行模式：计划 / 询问 / 执行
默认隐藏工作区	关	界面中默认收起工作区信息
AGENTS.md 自动注入	关	开：每轮对话自动携带项目根 AGENTS.md，AI 始终带着项目规范干活。长期项目建议开
修改留痕	开	每轮任务结束后把净修改 diff 落盘到 .astrion/modify_history/。关闭后既不落盘也不注入提示
新对话默认开启版本控制	开	建议保持开启，这是文件安全网
版本控制备份方式	浅备份	浅备份：只备份 AI 编辑的文件；完全备份：整工作区快照（大项目慎用）
目标审核模式	仅读对话	目标模式的审核方式：readonly 只读对话判断 / active 允许审核智能体跑只读命令取证
目标最大轮数	有默认值	目标模式自动续轮上限
目标 token 上限	不启用	累计输入+输出 token 达到即停（1k–100M）。注意是工作区级近似统计

6. 上下文

这一页是长对话质量的关键，改动前建议先读《输入与上下文》第 4 节。

设置项	默认	说明
最近对话提示	关	开：新对话自动注入最近 N 条历史对话摘要
最近对话数量	10	上面那项的 N，1–30
项目记忆索引上限	20 条	项目记忆索引最多注入条数（≥5，可设无上限）
自动浅压缩	关	⚠️ 会破坏上下文缓存，见《输入与上下文》。不推荐开
浅压缩触发 token	80000	自定义时至少为模型实际可用上下文的 80%
浅压缩保留最近工具数	15	最近 N 个工具结果不压
浅压缩保留用户轮次工具	3	最近 N 次用户输入之后的工具不压
浅压缩每轮最多替换	10	单次压缩最多替换多少个工具结果
浅压缩工具调用间隔	10	每 N 次工具调用检查一次是否触发
自动深压缩	开	推荐保持开启
深压缩触发 token	150000	同样遵守 80% 规则
深压缩产物形式	生成文件	file：总结写入文件随取随用（推荐）/ inject：直接注入总结全文

7. 工具与 Skills

设置项	默认	说明
静默禁用工具	开	禁用某工具时不向模型插入提示，上下文更干净
隐藏工具审批面板	开	auto_approval 模式下不自动弹出审批面板打扰你；关则有审批即弹
工具意图说明	开	工具调用卡片上显示「要做什么」的简述；关掉可让消息流更紧凑
Skill 提示	关	根据当前任务动态提示可能相关的 Skill
强约束：终端	关	开：AI 使用终端工具前必须先读 terminal-guide 规范
强约束：子智能体	关	开：派子智能体前必须先读 sub-agent-guide
强约束：前台命令	关	开：run_command 前台模式前必须先读规范
强约束：后台命令	关	开：run_command 后台模式前必须先读规范
启用 Skills 列表	全部	勾选哪些 Skill 可被使用
禁用工具类别	无	按类别整体禁用工具（如禁用网页搜索类）

四个「强约束」是新手护栏：强迫 AI 在用高危工具前先读使用规范，显著降低误操作率；熟练后关掉可省 token。

8. 文件与图片

设置项	默认	说明
图片压缩档位	原图	原图 / 1080p / 720p / 540p。长对话多发大图建议降档省上下文

9. 数据管理

只读的用量统计页：累计输入/输出 token、总对话数、用户消息数、工具调用次数，支持手动刷新。用来回答「我这个月烧了多少 token」。

10. 语音模型

端侧语音识别模型（SenseVoice int8）的下载管理：约 228MB，仅在手机本地运行、无需网络，支持中英混说与自动标点。页面显示下载状态（未下载/下载中百分比/已下载/下载不完整），可重新下载或删除。此功能面向 Android 客户端。

11. 子智能体

多智能体角色编辑器：角色列表、新建角色、编辑角色。角色的字段与写法见《智能体能力》第 2 节。预置 5 个角色可查看参考，自定义角色随改随用。

12. 审核智能体

三个审核智能体（自动审批 / 目标审核 / 工作流审核）的统一配置页，各自可配：

字段	说明
模型	子智能体模型库中的条目名；留空 = 用模型库 default_model
思考模式	fast / thinking
超时时间	单次审核的最长等待
最大轮数	审核智能体自身的工作轮数上限
命令超时	审核中执行核查命令的单条超时

配置建议：审核任务模式固定、调用频繁，选便宜稳定的模型即可，不必用旗舰。

13. 管理员（仅管理员可见）

管理员专属页：用户与策略管理（admin/ 相关界面）。普通用户看不到此页。

---

附：设置生效机制

• 所有设置存储在数据目录的 personalization.json，按用户隔离；
• 「默认 XX」类设置只影响新建对象（新对话/新终端），不改已有的；
• 显示类设置（主题、显示模式等）即时生效；
• 涉及提示词注入的设置（个性化、注意事项、AGENTS.md 注入等）从下一轮对话开始生效。