Settings and your data
Everything on the Settings tab — account, AI provider, voice input, cloud, usage, plugins, reminders and alerts, appearance, language, time zone, haptics, exporting and erasing data, updates and the About page — and how the assistant changes settings for you in chat.
This page goes through the Settings tab from top to bottom and explains each item. You can also ask the assistant to change most settings for you; see Changing settings in chat.
The Settings tab
| Group | Item | What it's for |
|---|---|---|
| (when there is a new version) | Version X.Y.Z is available | Download and install the new version; see Install and update |
| Account | Campus account | Sign in to or out of your PKU account; see Campus account and authenticator |
| AI provider | Choose a model provider and enter an API key; see AI provider | |
| Voice input | Choose a speech-to-text service and enter its key; see Voice input | |
| Cloud | Choose a cloud server; see below | |
| Usage | Tokens, active hours and top tools; see below | |
| Plugins | Plugins | Services, permissions and each plugin's own settings; see Plugins and permissions |
| Notifications | Reminders and alerts | Notification, exact alarm and background permissions; see Schedule and reminders |
| Appearance | System / Dark / Light | The app's colors |
| Language | System / 简体中文 / English | The app's language |
| Time zone | See below | |
| Haptic feedback | Light vibrations on taps, switches and confirmations | |
| Data | Export data, Erase all data | See below |
| About | Download updates on Wi-Fi, check for updates, About PKU harness | See below |
Changing settings in chat
Everything you can change on these screens, the assistant can change too. Ask in chat, for example "Switch to dark mode", "Use English", "Set my time zone to Asia/Shanghai", "Turn off haptics", "Switch to DeepSeek-V4-Pro", "Turn off the Treehole plugin", "Ask me before Copilot changes anything" or "Let Copilot use the browser". The assistant changes the setting and tells you what it was before and what it is now. The screens and the assistant change the same stored settings, so a change made in either place shows in both.
This covers:
- the app's appearance, language, time zone and haptic feedback;
- the AI provider, model and voice input service;
- each plugin's switch and its permissions;
- each plugin's own settings, for example Copilot's on/off switch, its allowed apps and Let the AI see screenshots.
Some things only you can do. The assistant can't read or enter API keys, sign you in to your campus account, or grant system permissions such as notifications. When you ask for one of these, it opens the right screen for you.
These changes are made by the core Settings plugin, and its permissions work like any other plugin's. By default the assistant changes settings without asking. To confirm each change, set Change to Ask first under Settings → Plugins → Settings → What the AI may do.
Cloud
The cloud is an optional server that only relays and stores encrypted data for plugins. The feature that uses it today is payment-code sharing. Your campus account and password never leave the phone; the server only knows an anonymous key for this device.
The cloud is off by default. To turn it on:
- Open Settings → Cloud.
- Choose a server:
- Off: no server at all; features that need the cloud are unavailable.
- Official: the instance run by the PKU harness community.
- Self-hosted: an open-source server run by you or someone you trust. Enter an address that
starts with
https://in Server URL.
- Tap Save and test. When it connects, the screen shows the operator, the services it supports and its limits.
Each plugin also needs your permission to use the cloud. The first time a plugin needs it, the app asks "“Plugin name” wants to use the cloud" and lists what would leave the phone; tap Allow or Not now. You can change this later under Cloud in Settings → Plugins → plugin name, or tap Clear this plugin's cloud data there.
This device shows the device fingerprint. It belongs to a key pair made on this phone and has nothing to do with your campus account.
- Reset identity deletes this device's data on the server first, then makes new keys. Ongoing shares end.
- Delete cloud data deletes everything this device stored on the current server. Ongoing shares end, and this can't be undone.
Usage
Settings → Usage shows statistics on your use of the AI provider, for 7 days, 30 days or All time. It includes:
- Token usage today and this month, and the estimated cost this month.
- The prompt cache hit rate. Cached input is billed at a lower price.
- Tokens per day, active hours, and chat activity over the last 20 weeks.
- The plugins and tools used, with call counts and success rates.
- The models used.
Costs are estimated from the providers' public prices. Your provider's bill is what counts.
Time zone
Reminders, Schedule, the ledger and the assistant all keep time in this zone. The subtitle shows the zone in use and its current offset from UTC.
The default is System: the zone follows your phone's system setting, so it changes when you travel. To use a fixed zone, open Settings → Time zone, search for a city, country or zone name, and tap it.
Export data
Tap Settings → Export data. The app makes a JSON file and opens Android's share sheet, where you can save it or send it somewhere. The file holds your reminders, to-dos, timetable, dashboard and settings. It never includes passwords or API keys.
Erase all data
- Tap Settings → Erase all data.
- Tap Erase in the confirmation dialog.
Your reminders, to-dos, timetable, dashboard, chats and saved keys (including your campus password and API keys) are deleted from the phone. This can't be undone. The app then returns to the first-run intro.
About
- Download updates on Wi-Fi: on by default. New versions download in the background over Wi-Fi; you tap to install. The assistant can change this setting for you too.
- Check for updates: shows the installed version below it. Tap it to check GitHub for a new APK; see Install and update.
- About PKU harness: the app version and any over-the-air update in use, links to the website and the source code, the author and contributors, our promise to keep the app open source and free, and the Terms of Service and Privacy Policy. The website versions are at Terms of Service and Privacy Policy. The privacy policy explains what is sent to your AI provider, your voice input service, the university's systems and the cloud.
Copilot
Copilot lets the assistant operate other apps on your phone on a separate screen. A step-by-step setup guide for non-technical users — Developer options, Wireless debugging and the pairing code, accessibility, allowed apps and screenshots — with notes for each phone brand, and how to pause, stop and turn it all off again.
Troubleshooting
Common problems with PKU harness and how to solve them — the campus network, verification codes at sign-in, AI provider and voice input errors, attached files, late reminders, app updates, the payment code and Copilot setup.