Treehole - 北大树洞 CLI

A CLI client for PKU's anonymous discussion platform (PKU Helper Treehole).

Architecture

• Crate location: crates/treehole/
• Auth flow: IAAA SSO (app_id="PKU Helper") → JWT callback at /chapi/cas_iaaa_login → optional SMS verify
• API: JSON REST at /chapi/api/v3/ (modern) and /chapi/api/ (legacy)
• API docs: docs/treehole-api.md

Key Source Files

• src/main.rs — Clap CLI definition with all subcommands
• src/commands.rs — Command implementations (login, post, search, etc.)
• src/api.rs — HTTP API client, request builders, response types
• src/display.rs — Terminal output formatting with colored crate
• src/client.rs — reqwest client builders (build for auth, build_simple for IAAA)

CLI Commands

Auto-Login for AI Agents

# Check session status
info-auth check

# Auto-login (reads credentials from OS keyring, no password needed)
treehole login -p

# If SMS verification is needed (first login or periodic):
PKU_SMS_CODE=123456 treehole login -p

Treehole may require SMS verification on first login or periodically (~30 days). When PKU_SMS_CODE env var is set, it auto-confirms sending and submits the code without interactive prompts.

Development Conventions

• All user-facing strings are in Chinese (prompts, errors, output)
• Error handling: anyhow::Result with .context("中文描述")
• HTTP client uses redirect(Policy::none()) for manual redirect handling
• Session persisted to ~/.config/info/treehole/ via info_common::session::Store
• Credentials resolved via info_common::credential (keyring → env → interactive)
• Shared auth from info-common crate (see info-common skill for details)