astrion-website/content/09-settings.md

155 lines
9.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 个人空间设置全解
个人空间(输入栏 `+` 菜单 →「个人设置」)共分 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 注入等)从下一轮对话开始生效。