Cline rules

1---
2description: "HoshimiNest project overview — tech stack, directory structure, package manager, dev commands, Rust dependencies. Always apply."
3globs: ""
4alwaysApply: true
5---
6 
7# Project Identity
8 
9<!-- HoshimiNest 项目身份与架构，AI 每次对话自动加载 -->
10 
11## Project Name & Purpose
12 
13HoshimiNest is a desktop anime tracking & download manager.
14 
15## Tech Stack
16 
17### Frontend
18 
19- **React 19 + TypeScript** — functional components + hooks, strict mode
20- **Vite 7** — bundler, dev port `1520`
21- **Zustand** — state management (`src/store/`)
22- **Plain CSS** — NO Tailwind, NO CSS-in-JS
23- **Yarn** — the ONLY package manager
24 
25### Backend
26 
27- **Tauri v2** — Rust desktop shell
28- **Key Rust crates:**
29  - `reqwest` (HTTP client, rustls-tls)
30  - `serde` + `serde_json` (serialization)
31  - `tokio` (async runtime: time, sync, macros, rt)
32  - `tauri-plugin-shell` / `tauri-plugin-opener` / `tauri-plugin-dialog`
33  - `log` + `env_logger`
34 
35### External Binaries
36 
37Bundled with the app via `externalBin`:
38 
39- `aria2c` — download engine
40- `mkvmerge` — media remuxing
41 
42## Development Environment
43 
44- **OS**: Windows only — NEVER assume macOS/Linux/WSL paths or tools
45- **Shell**: PowerShell (`.ps1` scripts) — NEVER write `.sh` or bash scripts
46- **Terminal commands**: always use PowerShell syntax; NEVER use Unix-only flags or pipes
47 
48## Directory Structure
49 
50```text
51src/                                       # React frontend source
52  ├── App.css                              # global layout & component styles (colors reference theme.css vars)
53  ├── App.tsx                              # root component (topbar + sidebar nav + download settings modal)
54  ├── assets/
55  │   └── fonts/                           # bundled font files
56  ├── main.tsx                             # React entry point
57  ├── pages/                               # page-level components (one per nav item)
58  │   ├── BacklogPage.tsx                  # backlog / plan-to-watch
59  │   ├── DownloadPage.tsx                 # download manager
60  │   ├── FinishedPage.tsx                 # completed anime (main file, sub-logic in finished/)
61  │   ├── QueryPage.tsx                    # seasonal query (main page)
62  │   ├── QueryPage/                       # seasonal query sub-components
63  │   ├── SearchPage.tsx                   # resource search (main page)
64  │   ├── SearchPage/                      # resource search sub-components
65  │   ├── TracksPage.tsx                   # track workshop (main file, sub-logic in tracks/)
66  │   ├── WatchingPage.tsx                 # currently watching
67  │   ├── WatchListPage.tsx                # watchlist base (main file, sub-logic in watchlist/)
68  │   ├── finished/                        # completed anime sub-components
69  │   ├── tracks/                          # track workshop sub-components
70  │   └── watchlist/                       # watchlist sub-components
71  ├── store/                               # global state
72  │   ├── downloadStore.tsx                # download task context (state machine + aria2 events + localStorage)
73  │   └── watchStore.ts                    # watchlist localStorage helpers
74  ├── styles/
75  │   ├── fonts.css                        # @font-face declarations
76  │   └── theme.css                        # theme CSS variables
77  └── vite-env.d.ts                        # Vite type declarations
78src-tauri/                                 # Tauri/Rust backend
79  ├── app-config.json                      # compile-time config (BT trackers, ports, cache)
80  ├── build.rs                             # Tauri build script
81  ├── capabilities/
82  │   └── default.json                     # Tauri ACL capability config
83  ├── icons/                               # app icons
84  ├── src/
85  │   ├── lib.rs                           # Tauri commands + aria2 control + mkvmerge track merge
86  │   └── main.rs                          # Rust entry point
87  └── tauri.conf.json                      # Tauri app config (window/bundle/permissions)
88scripts/                                   # dev & setup scripts (.ps1)
89```
90 
91## Package Rules
92 
93NEVER run `npm install` or `pnpm add`. Always use `yarn`.
94 
95NEVER suggest re-installing these — already in `package.json`:
96 
97- `@tauri-apps/api`, `@tauri-apps/plugin-dialog`, `@tauri-apps/plugin-opener`
98- `animal-island-ui`, `bangumi-api-client`
99- `react`, `react-dom`, `zustand`
100 
101## Dev Commands
102 
103```bash
104yarn dev          # Vite dev server (frontend only, port 1520)
105yarn tauri dev    # full Tauri app in dev mode
106yarn build        # TypeScript check + Vite build
107yarn tauri build  # production Tauri bundle
108yarn rustcheck    # cargo check (Rust compilation check only)
109```
110 
111## Window Config
112 
113- Window: 1360×820, non-resizable, non-maximizable, frameless (custom titlebar)
114- App identifier: `HoshimiNest`
115