# CS0502 · PeerDrop / 同学快传

## 中文

### 如何使用项目资料

1. 下载并解压 `CS0502-peer-drop-starter.zip`。
2. 阅读 `STUDENT_TASKS.md`，自行规划与 AI coding agent 的协作方式；本项目没有完整提示词。
3. 双击 `web/index.html` 可查看项目网页界面。它不包含任何真实传输、加密、认证或校验功能。
4. `app.py` 只是空的项目入口；可使用 Python + Web 页面，也可与 agent 选择其他技术路线。
5. 阅读 `LAN_SETUP.md`，选择路由器 Wi-Fi、手机热点或 Windows 电脑热点创建测试局域网。
6. 保持所有测试在自己控制的设备和可信局域网中进行。不要暴露到公网，不要传输敏感文件。

### 交付前检查

- 两台独立设备完成了一次真实文件传输；
- 文件密钥、RSA 密钥保护、RSA 签名验证和 SHA-256 比对均可运行；
- 录屏展示签名验证、解密、校验与文件保存；
- README 说明启动方式、依赖、测试网络与已知限制；
- 图文报告记录 AI agent 迭代过程，并解释保密性、认证与完整性。

## English

### Using the project materials

1. Download and unzip `CS0502-peer-drop-starter.zip`.
2. Read `STUDENT_TASKS.md` and plan your own AI-coding-agent collaboration; this project has no complete starter prompt.
3. Double-click `web/index.html` to view the project interface. It contains no real transfer, encryption, authentication, or verification functionality.
4. `app.py` is only an empty project entry point. You may use Python plus a web page or choose another technical route with your agent.
5. Read `LAN_SETUP.md` and choose router Wi-Fi, a phone hotspot, or a Windows PC hotspot for your test LAN.
6. Keep all testing on devices and trusted local networks you control. Do not expose the project to the public internet or transfer sensitive files.

### Before submitting

- Two independent devices have completed one real transfer;
- file-key encryption, RSA key protection, RSA signature verification, and SHA-256 comparison work;
- the recording shows signature verification, decryption, verification, and saving;
- the README explains launch steps, dependencies, the test network, and known limitations;
- the illustrated report records AI-agent iteration and explains confidentiality, authentication, and integrity.