ProgressRadar v2.1

本地优先的个人进度雷达桌面应用：把零散记录交给 AI 归类为项目进展，同时保留阶段演化、周期复盘、成就、任务、灵感和个人主页更新。

核心能力

• 快速粘贴：托盘窗口与 Ctrl + Shift + P 全局热键随时收集文本。
• AI 归类：把输入更新到现有维度，或创建新维度、提出阶段结构演化。
• 非线性阶段：每条记录独立标注阶段，允许跳跃、回退和开启新周期。
• 成就系统：按里程碑、连续活跃和 AI 洞察生成可视化成就。
• 锦囊任务板：记录待办，完成时自动把成果送入进度归类与成就检查。
• 灵犀阁：把学习心得按“卷”收藏，可命名、复制与整理。
• 主页扫描：嵌入个人主页，比较页面快照并把实质更新沉淀为进度。
• 私有备份：定时把代码、数据和 Git 历史推送到私人仓库，并在本机状态页和双色悬浮球显示结果。

首次配置

1. 安装 Python 3.10+，然后安装依赖：

pip install -r requirements.txt

2. 配置 DeepSeek API key（二选一）：

# 方式 A：环境变量
setx DEEPSEEK_API_KEY "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# 方式 B：本机私用文件
copy secrets.example.py secrets.local.py
notepad secrets.local.py

secrets.local.py 已被 Git 忽略。不要把真实密钥写进 README、示例文件或公开提交。

3. 生成启动脚本和桌面快捷方式：

python install_shortcut.py

启动与使用

python main.py

启动后程序常驻系统托盘：

• 托盘图标左键：打开 Dashboard。
• 托盘图标右键：Dashboard、快速粘贴、退出。
• Ctrl + Shift + P：唤出快速粘贴窗口。
• 关闭窗口或按 Esc：隐藏而不退出。

生成周报：

python weekly_report.py

管理开机自启：

python autostart.py register
python autostart.py status
python autostart.py unregister

私有完整备份

private_backup 目录是一套可复制到任意项目的通用流程。它默认备份项目中的所有普通文件，把配置的秘密文件以 Windows DPAPI CurrentUser 密文保存，并附带 source-history.bundle 以恢复 Git 历史。50 MiB 及以上的文件自动使用 Git LFS；只有用户显式配置的路径才会排除，且只有内容变化时才新增提交。

创建好空的 GitHub 私有仓库后运行：

powershell -ExecutionPolicy Bypass -File private_backup\Install-PrivateBackup.ps1 -RepositoryUrl https://github.com/USER/PRIVATE-REPO.git -IntervalHours 2

安装器使用 Git Credential Manager 的现有登录状态，不把 GitHub token 写入配置。项目名、运行目录、任务名和监控端口都根据目标项目动态生成，并注册两个 Windows 计划任务：

• Private Git Backup - <项目名>：按配置间隔运行，错过后在可用时补跑。
• Private Git Backup Monitor - <项目名>：登录后启动该项目的本机状态页。

端口会从 8788–8899 自动选择。同一台电脑可登记多个备份项目；悬浮球汇总最需要关注的状态。机器人与备份颜色相同时显示完整纯色球，状态不同时才显示左右分栏和中线。

运行隔离自检：

powershell -ExecutionPolicy Bypass -File private_backup\Test-PrivateBackup.ps1

PDF 与发布

本地构建项目说明 PDF：

powershell -ExecutionPolicy Bypass -File scripts\build-local.ps1

正文位于 paper/main.typ，输出为 paper/main.pdf。GitHub Actions 会在论文源文件变化时重新构建并上传 PDF artifact；publish.json 与 CITATION.cff 用于个人主页和引用元数据。

数据边界

公开仓库包含源代码、示例配置、PDF 和通用备份脚本。以下内容只留在本机或私人备份中：

• data/progress.json 之外的个人任务、观点和主页扫描记录；
• data/webview 浏览器运行缓存；
• secrets.local.py 的明文；
• 标记为“本机私用”的 ZIP。

私有仓库不是唯一备份。重要资料仍建议至少保留一个离线或异地副本。

目录

main.py                 桌面入口、双窗口、托盘与热键
api.py                  Python 与前端之间的 JS Bridge
ai_processor.py         AI 动作解析、归类、演化与成就联动
data_store.py           进度数据与 schema 迁移
task_store.py           锦囊任务板
viewpoint_store.py      灵犀阁分卷收藏
homepage_scanner.py     个人主页快照与增量检测
ui/                     Dashboard 与快速粘贴界面
private_backup/         私有备份、计划任务与状态中心
paper/                  Typst 源文档与 PDF