astrion-website/content/09-settings.md

9.3 KiB
Raw Blame History

个人空间设置全解

个人空间(输入栏 + 菜单 →「个人设置」)共分 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.mdAI 始终带着项目规范干活。长期项目建议开
修改留痕 每轮任务结束后把净修改 diff 落盘到 .astrion/modify_history/。关闭后既不落盘也不注入提示
新对话默认开启版本控制 建议保持开启,这是文件安全网
版本控制备份方式 浅备份 浅备份:只备份 AI 编辑的文件;完全备份:整工作区快照(大项目慎用)
目标审核模式 仅读对话 目标模式的审核方式readonly 只读对话判断 / active 允许审核智能体跑只读命令取证
目标最大轮数 有默认值 目标模式自动续轮上限
目标 token 上限 不启用 累计输入+输出 token 达到即停1k100M。注意是工作区级近似统计

6. 上下文

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

设置项 默认 说明
最近对话提示 开:新对话自动注入最近 N 条历史对话摘要
最近对话数量 10 上面那项的 N130
项目记忆索引上限 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 注入等)从下一轮对话开始生效。