ai-goofish-monitor-QB: Instructions file for Codex

---

1. 目标与边界

本仓库是 闲鱼监控与 AI 推荐项目（ai-goofish-monitor-QB）。 核心链路：监控抓取 → 条件筛选 → AI / 贝叶斯分析 → 结果存储与展示 → 通知推送。

关键原则：

1. 新增 Windows x64 便携版，内置 PostgreSQL 和独立 Launcher；保留现有 Docker 构建与部署路线，便携版不依赖 Docker。
2. 公开发行、持续迭代，欢迎社区贡献；不擅自改变抓取频率、用户数据隔离、AI 调用和通知行为。
3. 最小改动优先（避免无关重构）。
4. 启动器、基础配置、状态和更新规划以 docs/PORTABLE_LAUNCHER_PLAN.md 为交接基线；规划不等于已实现。
5. 用户已暂停许可证调整，继续保留当前 License 的 MIT 许可。此前 GPL 切换讨论不再是执行指令；未经用户重新提出，不推进换证、非商用限制或贡献重授权，也不将其作为启动器开发阻塞项。
6. Launcher 技术路线已确认为 C# / Avalonia UI / 自包含 .NET；首期只交付 Windows x64。编排核心与平台适配隔离，不提前实现或承诺 macOS/Linux 桌面包；Docker 路线继续维护。
7. 本项目普通开发、构建及交付产物必须允许项目所有者和现有 agent 开发账号正常访问。新建普通暂存目录应继承项目权限，禁止把私有临时目录的仅创建者 ACL 随移动带入长期目录或发行包；不得为修复此问题放开整块磁盘或 Everyone 权限。数据库口令、控制令牌等明确的凭据保护仍单独保留，不能与普通产物权限混为一谈。

生成代码必须遵守：

1. 所有文件编码 UTF-8（无 BOM）
2. 禁止 UTF-16 / GBK
3. 中文直接输出，不允许 \uXXXX
4. 文件写入必须使用 UTF-8

---

2. 工具与实施规则

1. 默认使用 apply_patch 编辑文件。
2. Shell 仅用于：
   • 测试/构建/静态检查
   • 读取运行态信息
   • 无专用工具可替代的命令
3. 禁止提交调试残留、临时脚本、敏感信息。
4. 未经确认禁止新增依赖。
5. 所有外部调用与 I/O 必须有错误处理（后端日志 / 前端 console.error）。

3. 仓库卫生与临时空间

1. 开发、测试和清理任务必须遵守根目录 REPOSITORY_HYGIENE.md。原因：统一入口能让各类任务按同一套数据保护和清理边界执行。
2. 新临时产物统一放在 .tmp/<用途>/<任务标识>/，任务结束清理自有可重建文件；保留项说明用途、大小与到期日。原因：按任务归档便于确认归属、追踪占用并安全收尾。
3. 通用任务新增的任务专属可重建临时产物默认预算为 2 GiB；共享依赖缓存及登记批准留存的验收夹具另账，不计入该预算，但须盘点并报告 .tmp 全部实际占用。轻量失败诊断最多保留 7 天且每用途最近 3 次，带业务状态的失败验收夹具到期只触发复核，不按此期限自动删除。磁盘剩余不足 10 GiB 或 5% 时暂停新增重型产物并报告；预算超额本身不授权删除。原因：预算限制任务新增成本，单独记录共享资产和验收证据可避免因物理占用超额而误删；低磁盘阈值保护实际可用空间。
   • 本任务特例（2026-09-12 用户明确授权）：便携 Launcher 自动落地任务取消单任务 512 MiB、.tmp 2 GiB 等容量上限，不再因容量预算重复请求确认。仍须盘点/复用/收尾，保留低磁盘暂停、期限、在用文件和真实数据保护；不改变其他任务的默认卫生规则。原因：特批仅放开容量限制，不能扩大到删除授权或数据风险。
4. 查看、分析不代表授权删除。清理历史文件前列出准确路径、用途和预计释放空间并取得确认；禁止整仓库通配清理，禁止删除业务数据、任务与通知记录、登录态和在用文件。原因：盘点不能代替删除许可，精确范围可避免误删用户数据和运行状态。
5. 交付时检查临时产物残留和 Git 差异；文档中的限额不等于已经实现自动清理，不得虚报已启用的保护能力。原因：检查可发现遗留和意外改动，也能区分纸面要求与真实保护行为。

---