PKU harness
User manual

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

GroupItemWhat it's for
(when there is a new version)Version X.Y.Z is availableDownload and install the new version; see Install and update
AccountCampus accountSign in to or out of your PKU account; see Campus account and authenticator
AI providerChoose a model provider and enter an API key; see AI provider
Voice inputChoose a speech-to-text service and enter its key; see Voice input
CloudChoose a cloud server; see below
UsageTokens, active hours and top tools; see below
PluginsPluginsServices, permissions and each plugin's own settings; see Plugins and permissions
NotificationsReminders and alertsNotification, exact alarm and background permissions; see Schedule and reminders
AppearanceSystem / Dark / LightThe app's colors
LanguageSystem / 简体中文 / EnglishThe app's language
Time zoneSee below
Haptic feedbackLight vibrations on taps, switches and confirmations
DataExport data, Erase all dataSee below
AboutDownload updates on Wi-Fi, check for updates, About PKU harnessSee 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:

  1. Open Settings → Cloud.
  2. 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.
  3. 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

  1. Tap Settings → Erase all data.
  2. 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.

On this page