- 独立 MiniCode 项目，主理人 Winter喵，粉丝勋章「喵code」。官网 https://minicode.uk ，Worker 名称
minicode-web。 - 2026-09-13 从课程仓库拆出，后续在本项目维护，原副本仅作历史参考。
- Astro + TypeScript 保持静态输出；
worker/index.ts提供求职 API 和动态详情入口，D1 存储数据，Workflows 执行后台任务。不要把项目当成仅有静态资源的官网。 - Node.js 22.12+，依赖版本以 package-lock.json 为准。
- 保留眼镜猫咪品牌形象。首页与课程页沿用原课程设计，首页课程顺序为 Vibe Coding 在前、Kimi Code 在后。
src/data/site.ts维护首页内容；src/data/kimi.ts维护 Kimi 目录、发布状态和规划。已发布课时由真实目录求和，规划不计入已交付。- 课程更新须核对 B 站并更新核对日期、sitemap；两门课各用自己的购买地址，不编造价格、优惠、作品或完成状态。
- Kimi 路由为
/courses/kimi-code/，共享导航须兼容子页面返回首页锚点。 /jobs、岗位详情及弹窗遵循DESIGN.md中 2026-09-13 用户确认的薄荷工坊参考版：浅紫粉到奶油背景、奶油白面板、局部薄荷柔光，粉／薄荷按钮与多色 3D 图标。后续沿用该设计基准，不回退为厚重硬底边、大面积饱和紫色面板、玻璃拟态、深色科技风或营销 hero。- 求职主题通过共享布局的
theme="jobs-clay"显式启用，默认关闭，不污染首页与课程页。 - 使用已有 3D 图标，不换成普通线性图标或 emoji。素材路径与生成记录见
ASSETS.md、PROMPTS.md。
- 范围、配置和当前状态以
JOBS.md为入口，运行事实以代码和最新线上结果为准。 - 当前为单一技能画像，公开访问，无登录和公开设置页；个人画像、来源和提醒收件人由代码或服务端配置维护。
- 保留 DOM 标识、事件绑定、收藏存储键、分享链接、5 分钟全站刷新限制和 90 天首次发现保留规则；视觉任务不顺带改业务逻辑。
- 不把配置存在、样本抓取成功、局部分析成功写成全量抓取或完整提醒链路完成。失败原因未确认时不归因为某个云平台配额或反爬机制。
- 收件地址维护于
JOBS_NOTIFY_EMAILSecret。用户已确认 QQ 邮箱验证完成，并明确不需要测试邮件；没有后续新指令时，不发送测试邮件。 - 邮箱已验证不等于发信域或提醒开关已启用。UI／文档任务不得顺带修改邮件 DNS 或提醒开关；域级邮件/DNS变更须有明确授权。
- 不增加未要求的登录、评论、打卡或站内支付。
- 修改前阅读相关代码、保护已有改动，保持页面、数据、样式和后台职责清晰。不依赖旧仓库绝对路径，不软链接外部 node_modules。
npm ci安装；npm run dev运行 Astro；求职完整本地预览用npm run db:local后npm run dev:jobs。npm run build执行类型检查与构建，npm run deploy:dry部署预检查；业务变化运行相关npm test，UI 变化检查真实浏览器桌面与手机。- 检查图片、溢出、键盘焦点、筛选折叠和弹窗关闭。尊重快速迭代偏好，完成必要验证后交付，不追加无关重构或重复抠细节。
- 上线更新现有
minicode-web。先记录实际线上版本，审阅并合并配置差异，再使用npx wrangler deploy --keep-vars --strict；这些参数不能替代配置核对。 - 保留线上 Secrets、普通变量、域名／预览标记、D1 绑定和定时任务。生产 D1 已存在；无新迁移时不重复建库或应用远端迁移。
- 发布后验证首页、课程页、岗位页面、资源和 404。代码回退不删除数据库。发布记录维护在
JOBS.md，不要在多份文档重复追加过时版本结论。 - 不提交 Cloudflare 凭证、API Key、.env、.dev.vars、缓存或构建产物；项目所用生成素材须保存在仓库内。
- 完成后简洁说明改动、必要验证和是否部署。仅更新文档时不重新部署网站。