12 KiB
Personal Space Settings: The Complete Guide
Personal Space (input bar + menu → "Personal Settings") has 12 tabs in total (admins get 1 more). This chapter explains every page and every item — what each setting does, its default value, and when to use it. Anything that can't be explained in one sentence on the settings page is covered in full here.
Convention: "default" refers to the default value baked into the code. If you've used the
setup.shwizard, some defaults may have been overridden by your choices in the wizard.
1. General
| Setting | Default | Description |
|---|---|---|
| Auto-generate title | On | Automatically generates a conversation title after the first round. When off, new conversations keep the "New Conversation" placeholder name and need manual renaming |
2. Personalization
This page decides "what personality the AI adopts when interacting with you".
| Setting | Default | What It Does & When to Use |
|---|---|---|
| Enable personalization | Off | Master switch for this page. When off, none of the settings below are injected into prompts |
| AI's self-name | Empty | What the AI calls itself (≤20 characters), e.g. "Xiao A" |
| How it addresses you | Empty | What the AI calls you (≤20 characters) |
| Occupation | Empty | Your occupation (≤20 characters). When filled in, the AI adjusts the depth of its explanations to your background — developers get technical details, business folks get plain language |
| Tone | Empty | 8 presets: conversational / humorous / blunt / encouraging / poetic / corporate / unconventional / empathetic |
| Notes | Empty | The most powerful item: up to 10 long-term instructions, each up to 2000 characters, injected into every round of conversation. Good for persistent preferences like "always answer in Chinese", "write code comments in English", or "I'm colorblind — avoid red-green palettes in charts" |
| Communication style | Standard | Standard AI style / human-like chat style / auto (switches by scenario) |
| Conversation continuity | Medium | High: actively revisits past conversations and memories; medium: balanced; low: each round stands on its own as much as possible. If you've turned on "Recent conversation hints" but feel the AI keeps bringing up old topics irrelevantly, lower this setting |
3. Model & Thinking
| Setting | Default | Description |
|---|---|---|
| Default model | First visible item in the model library | The model used by default for new conversations; any registered model in the library can be chosen |
| Default thinking mode | Thinking | fast / thinking. Thinking mode gives higher quality; Fast mode responds faster |
| Default reasoning effort | Default (no parameter passed) | default / low / medium / high; only takes effect if the model supports reasoning_effort |
The "defaults" here only affect new conversations; for existing conversations, adjust individually with the switcher in the input bar.
4. Appearance & Display
| Setting | Default | Description |
|---|---|---|
| Theme | Classic | Classic (warm cream + warm orange) / Bright (cool white + near black) / Night (neutral grays) |
| Message flow display mode | Minimal mode | Traditional list / stacked animation / minimal mode; minimal mode has an extra "limit max height when expanded" toggle (on by default) |
| Condensed message display | Full info | Full original content / one-line summary |
| Hide stacked block dividers | Off | Hides the dividers between stacked blocks for a cleaner look |
| Show assistant status avatar | On | The status avatar in the conversation area (poke it — there's an easter egg) |
| Show Git status bar | On | The Git status bar above the input bar |
| Show custom names | On | Displays the self-name/address name you configured in the UI |
| Enhanced tool display | On | Structured rendering of tool results; turning it off makes output closer to raw |
| Auto-open terminal panel | — | Automatically expands the live terminal panel for terminal tasks |
| Auto-expand Quick Dock | On | Auto-expands Quick Dock when it has content; when off, it can only be opened manually |
| Hide Quick Dock | Off | Disables Quick Dock entirely |
| Real-time edit summary | Off | On: shows an edit summary card as the AI edits; off: shows a consolidated summary after each round of work |
| Wrap file preview | Off | On: the preview panel wraps lines to fit the width; off: long lines scroll horizontally |
| Group sidebar by workspace | Off | Groups the conversation list by workspace/project; grouping mode supports pinning and sorting workspaces |
| New conversation button behavior | Navigate to blank page | route: navigate to a blank new-conversation page / blank: immediately create an empty conversation |
5. Workspace & Permissions
| Setting | Default | Description |
|---|---|---|
| Default permission mode | Approval | The initial permission mode for new terminals; see "Core Concepts" for the behavior of all four levels |
| Default work mode | Plan | The initial work mode for new terminals: Plan / Ask / Execute |
| Hide workspace by default | Off | Collapses workspace info in the UI by default |
| Auto-inject AGENTS.md | Off | On: each round automatically carries the project-root AGENTS.md, so the AI always works with the project standards in mind. Recommended for long-running projects |
| Track modifications | On | Writes the net diff of changes to .astrion/modify_history/ after each round. When off, nothing is written and no prompt is injected |
| Version control on by default for new conversations | On | Keep this on — it's your file safety net |
| Version control backup method | Shallow backup | Shallow: only backs up files edited by the AI; full: snapshots the entire workspace (use with care on large projects) |
| Goal review mode | Read-only conversation | How goal mode is reviewed: readonly — judges from the conversation only / active — allows the review agent to run read-only commands for evidence |
| Goal max rounds | Has a default | The cap on auto-continuing rounds in goal mode |
| Goal token ceiling | Disabled | Stops when cumulative input + output tokens reach the limit (1k–100M). Note this is a workspace-level approximate count |
6. Context
This page is key to long-conversation quality; read Section 4 of "Input & Context" before changing anything.
| Setting | Default | Description |
|---|---|---|
| Recent conversation hints | Off | On: new conversations automatically receive summaries of the most recent N historical conversations |
| Number of recent conversations | 10 | The N in the item above; 1–30 |
| Project memory index limit | 20 entries | Max number of project memory index entries injected (≥5; can be set to unlimited) |
| Auto shallow compression | Off | ⚠️ breaks the context cache — see "Input & Context". Not recommended |
| Shallow compression trigger tokens | 80000 | When customizing, at least 80% of the model's actual usable context |
| Shallow compression: keep recent tool results | 15 | The most recent N tool results are not compressed |
| Shallow compression: keep post-user tools | 3 | Tools after the most recent N user inputs are not compressed |
| Shallow compression: max replacements per round | 10 | Max number of tool results replaced in a single compression |
| Shallow compression: tool call interval | 10 | Checks whether to trigger every N tool calls |
| Auto deep compression | On | Recommended to keep on |
| Deep compression trigger tokens | 150000 | Follows the same 80% rule |
| Deep compression output form | Generate file | file: writes the summary to a file for on-demand use (recommended) / inject: injects the full summary directly |
7. Tools & Skills
| Setting | Default | Description |
|---|---|---|
| Silently disable tools | On | When a tool is disabled, no prompt is injected into the model — cleaner context |
| Hide tool approval panel | On | Under the auto_approval mode, doesn't auto-pop the approval panel to bother you; off: any approval request pops up immediately |
| Tool intent description | On | Shows a brief "what it intends to do" note on tool call cards; turning it off makes the message flow more compact |
| Skill suggestions | Off | Dynamically suggests possibly relevant Skills based on the current task |
| Strict guard: terminal | Off | On: the AI must read the terminal-guide guidelines before using terminal tools |
| Strict guard: sub agents | Off | On: must read sub-agent-guide before dispatching sub agents |
| Strict guard: foreground commands | Off | On: must read the guidelines before run_command in foreground mode |
| Strict guard: background commands | Off | On: must read the guidelines before run_command in background mode |
| Enabled Skills list | All | Choose which Skills can be used |
| Disabled tool categories | None | Disables tools by category (e.g. disabling the web-search category) |
The four "strict guards" are guardrails for beginners: they force the AI to read usage guidelines before touching high-risk tools, significantly reducing the misoperation rate; once you're experienced, turning them off saves tokens.
8. Files & Images
| Setting | Default | Description |
|---|---|---|
| Image compression level | Original | Original / 1080p / 720p / 540p. For long conversations with many large images, consider lowering the level to save context |
9. Data Management
A read-only usage statistics page: cumulative input/output tokens, total number of conversations, user message count, and tool call count, with manual refresh. It answers questions like "how many tokens did I burn this month".
10. Speech Model
Download management for the on-device speech recognition model (SenseVoice int8): about 228MB, runs locally on the phone only — no network required, supports mixed Chinese-English speech and automatic punctuation. The page shows download status (not downloaded / downloading with percentage / downloaded / incomplete download), and supports re-download or deletion. This feature targets the Android client.
11. Sub Agents
The multi-agent role editor: role list, create role, edit role. See Section 2 of "Agent Capabilities" for role fields and format. The 5 preset roles serve as reference, and custom roles are ready to use as soon as you edit them.
12. Review Agents
A unified configuration page for the three review agents (auto-approval / goal review / workflow review), each configurable with:
| Field | Description |
|---|---|
| Model | An entry name from the sub agent model library; leave empty = use default_model from the library |
| Thinking mode | fast / thinking |
| Timeout | Max wait time for a single review |
| Max rounds | Cap on the review agent's own working rounds |
| Command timeout | Per-command timeout for verification commands run during a review |
Configuration advice: review tasks follow fixed patterns and are called frequently, so cheap, stable models are enough — no need for flagship ones.
13. Admin (Visible to Admins Only)
An admins-only page: user and policy management (the admin/-related interfaces). Regular users can't see this page.
Appendix: How Settings Take Effect
- All settings are stored in
personalization.jsonin the data directory, isolated per user; - "Default XX" settings only affect newly created objects (new conversations/new terminals), never existing ones;
- Display-related settings (theme, display mode, etc.) take effect immediately;
- Settings that involve prompt injection (personalization, notes, AGENTS.md injection, etc.) take effect from the next round of conversation.