chore: sync local latest state and repository cleanup

docs/DEVELOPMENT_GUIDE.md

@@ -109,7 +109,33 @@ java -jar target/mosquito-1.0.0.jar --spring.profiles.active=dev
 
 访问 `http://localhost:8080/actuator/health` 验证启动成功。
 
-### 7. IDE配置
+### 7. 工作区定期清理
+
+为避免构建产物和测试产物污染仓库，建议在本地定期执行以下命令：
+
+```bash
+# 只检查（发现 target/frontend/*/dist 或测试产物即返回非零）
+npm run clean:workspace:check
+
+# 归档清理（将产物移动到 /tmp/mosquito-archives/<tag>）
+npm run clean:workspace:apply
+
+# 历史日志归档（保留最近 1 天）
+npm run logs:health:check
+npm run logs:archive:check
+npm run logs:archive:apply
+npm run logs:archive:index
+```
+
+说明：
+- `clean:workspace:check` 对应 `scripts/ci/clean-artifacts.sh --include-build-outputs --fail-on-found`。
+- `clean:workspace:apply` 默认使用归档模式，不直接删除文件，便于回溯。
+- `logs:health:check` 对应 `scripts/ci/logs-health-check.sh`，用于输出日志体积和历史候选文件数量（仅告警，不阻断）。
+- `logs:archive:*` 对应 `scripts/ci/archive-logs.sh`，将按时间戳命名的历史运行日志移动到 `logs/archive/<tag>/`。
+- `logs:archive:index` 对应 `scripts/ci/update-log-archive-index.sh`，用于刷新 `logs/archive/README.md` 索引。
+- 若本地正在运行 `spring-boot:run`、`vite` 或 `scripts/e2e_continuous_runner.sh`，`target` 与 `frontend/e2e/*` 可能被立即重建。建议先停止后台进程再执行清理。
+
+### 8. IDE配置
 
 **IntelliJ IDEA：**