154 lines
12 KiB
Markdown
154 lines
12 KiB
Markdown
# 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.sh` wizard, 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.json` in 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. |