Seedo v2

Seedo is a local-first Windows desktop time-tracking app with AI review. The desktop app records active app and window activity, the browser extension reports page context over http://127.0.0.1:16123/activity, and the primary dataset stays in a local SQLite database.

Current Repo Status

• Current repo version: 4.3.4
• Stable in the current tree:
  • desktop activity tracking and time aggregation
  • browser extension sidecar for url, title, favicon, pageType, timestamp
  • category management, offline tags, daily intent, AI summary
  • export center, category template import/export, SQLite backup
• Explicitly not available in the current desktop build:
  • full history import
  • built-in auto updater
  • Excel/XLSX data export or import

Actual Capability Matrix

• Raw export event: csv, json
• Raw export segment: json
• Report export doc: markdown
• Category template import/export: available
• SQLite backup: available
• History import: unavailable and should fail clearly

Repository Layout

• apps/desktop: Tauri + Rust desktop backend
• apps/webui: React dashboard and settings UI
• apps/landing-page: marketing site
• apps/extension: Chrome/Edge extension for browser-side activity
• docs/: current source-of-truth docs
• docs/research/: archived research snapshots and diagram source files
• artifacts/: audit outputs and generated reports
• Release_v4.3.4/: packaged desktop release artifacts

Data and Runtime Notes

• Desktop database path: %APPDATA%/com.seedo.desktop/seedo.db
• Backup output path: %APPDATA%/com.seedo.desktop/backups/*.sqlite3
• Extension endpoint: POST http://127.0.0.1:16123/activity
• AI mode is BYOK only; the project does not ship hosted user API keys

Development

npm run dev:web
npm run dev:landing
npm run dev:desktop
npm run build --workspace=seedo-webui
npm run build --workspace=seedo-landing-page
cargo check --manifest-path apps/desktop/src-tauri/Cargo.toml

Documentation Guide

• docs/PRD.md: current scope, target users, and hard feature boundaries
• docs/db_schema.md: current SQLite schema and table roles
• docs/AUTO_UPDATER_FLOW.md: updater status and future enablement requirements
• docs/产品设计白皮书.md: product worldview and design rationale

docs/research/ contains dated research material and archived analysis. It should not be treated as the current release contract.