Winter喵的 AI 编程课程官网与个人 AI 求职助手。
从学习 AI 编程，到用 AI 整理适合自己的工作机会。MiniCode 将课程展示、作品介绍和求职工作台放在同一个项目里，使用 Astro + TypeScript 构建页面，通过 Cloudflare Workers、D1 和 Workflows 提供求职 API、数据存储与后台任务。
访问 MiniCode 官网 · 体验 AI 求职助手 · Kimi Code 课程 · Winter喵的 B 站主页
源码公开供学习使用，商业用途须事先联系 Winter喵取得书面授权。详见 LICENSE。
MiniCode 由 Winter喵维护，粉丝勋章为「喵code」。项目于 2026-09-13 从课程仓库拆出，在本仓库独立维护。
这里包含两个主要部分：
- AI 编程课程官网：展示 Vibe Coding App 实战与 Kimi Code 课程、学习路线和项目作品。Kimi 课程页区分已发布目录与后续规划，课程购买和观看通过各自的 B 站链接完成。
- 个人 AI 求职助手：聚合招聘信息，结合预设技能画像分析匹配点与能力缺口，提供简历调整建议和面试学习计划，帮助整理值得进一步了解的岗位。
视觉上保留眼镜猫咪品牌形象。课程页面采用柔和的马卡龙配色；求职页面使用浅紫粉、奶油白与薄荷色，搭配多色 3D 图标，并适配桌面和手机。
在线入口：minicode.uk/jobs
| 功能 | 说明 |
|---|---|
| 招聘信息聚合 | 已实现腾讯、字节跳动、小红书、阿里巴巴控股集团招聘站适配器，展示官方岗位描述与原始链接 |
| 岗位筛选 | 支持关键词、企业、城市、方向筛选，以及匹配度／时间排序 |
| AI 匹配分析 | 使用 deepseek-v4-flash，从方向、核心技能和工作内容评估匹配情况，并关联 JD 原文证据 |
| 求职准备 | 展示能力缺口、待确认条件、简历调整建议、学习任务与模拟面试题 |
| 收藏与分享 | 在当前浏览器收藏岗位，通过独立详情链接分享 |
| 后台更新 | 支持手动刷新和定时任务入口，展示批次及各招聘源进度 |
| 缓存与保留 | 复用已分析结果，全站刷新间隔至少 5 分钟，岗位自首次发现保留 90 天 |
当前是针对 Winter喵预设技能画像的单画像版本。页面公开访问，没有登录、在线简历上传或公开设置页；不同访问者看到的是同一套画像分析结果。自行部署时可在 worker/settings.ts 中修改画像。
- AI 匹配分用于辅助筛选，不代表录用概率；未知学历、年限和项目经历不会补写为已知事实。
- 收藏仅保存在当前浏览器，最多 100 个，不跨设备同步；项目不自动投递简历。
- 招聘适配器已接入，不等于四家岗位已全量、稳定抓取。部分失败会保留已取得的岗位，分析未完成时不生成替代分数。
- 仓库配置默认关闭邮件提醒，可选 FC 抓取转发也未默认启用。配置存在不代表真实邮件送达或完整定时链路已验证。
线上核验快照、待办和发布记录统一维护在 JOBS.md。
| 层级 | 技术与职责 |
|---|---|
| 页面 | Astro、TypeScript、CSS，保持静态输出 |
| 服务端 | Cloudflare Workers，提供静态资源、求职 API 和动态详情入口 |
| 数据 | Cloudflare D1，存储岗位、分析结果与任务状态 |
| 后台任务 | Cloudflare Workflows，执行分页抓取、分析及批次汇总 |
| AI | 服务端调用 DeepSeek API |
| 可选扩展 | 阿里云 FC 抓取转发服务 |
src/
pages/ 首页、课程页、求职列表与详情页
components/ 共享页面组件
layouts/ 共享布局与主题入口
data/ 课程内容与发布目录
scripts/ 求职筛选、收藏、分享等交互
styles/ 全站与求职专属样式
assets/ 页面图片与品牌素材
worker/ API、画像配置、抓取、AI 分析与后台任务
migrations/ D1 数据库迁移
scripts/ API 检查、招聘源探测与 FC 构建工具
tests/ 求职业务与 SQLite 测试
public/ 直接发布的静态资源
fc/ 可选 FC 抓取服务
design/ 设计参考与素材记录
/jobs/{id} 由 Worker 映射到静态详情页面并补充标题和 canonical，正文通过 API 加载。完整求职功能需要 Worker 运行环境。
使用 Node.js 22.12+ 和 npm，依赖版本以 package-lock.json 为准。在仓库根目录安装依赖：
npm cinpm run dev使用终端输出的本地地址访问。此命令运行 Astro，适合课程内容、页面与样式开发。
先初始化本地 D1，再启动 Worker：
npm run db:local
npm run dev:jobs默认访问 本地求职助手。首次运行本地岗位池为空，可在页面点击「刷新岗位」启动抓取。
如需 AI 分析，在仓库根目录新建 .dev.vars，参考 .env.example 填入：
DEEPSEEK_API_KEY=填写你自己的密钥.dev.vars 已被 Git 忽略。缺少模型密钥时仍可浏览已入池岗位和执行基础抓取，AI 分析保持待完成；配置真实密钥后，刷新任务可能产生模型调用费用。普通页面浏览读取已有分析结果。
邮件和 FC 的可选配置见 JOBS.md 与 fc/README.md。
| 命令 | 作用 |
|---|---|
npm run dev |
启动 Astro 开发服务 |
npm run db:local |
应用本地 D1 迁移 |
npm run dev:jobs |
构建页面并启动本地 Worker |
npm run check |
Astro 与 Worker 类型检查 |
npm run build |
类型检查与静态构建 |
npm test |
求职业务与 SQLite 测试，不发送真实邮件 |
npm run deploy:dry |
构建与部署预检查，不发布 |
npm run types:worker |
变更绑定后重新生成 Worker 类型 |
npm run probe:sources |
只读探测真实招聘站的分页和详情 |
npm run build:fc |
构建可选 FC 包，不部署 |
scripts/check-jobs-api.ts 仅允许本地地址，但包含刷新请求，会启动本地抓取。npm run db:remote 会修改所配置的远端数据库，仅在确认目标并有待应用迁移时执行。
仓库中的 wrangler.jsonc 对应 MiniCode 作者的部署配置。部署到自己的账户前，需要完成以下调整：
以下流程适用于许可范围内的学习演示或已获授权的用途；商业部署须先取得授权。
- 在自己的 Cloudflare 账户创建 D1 数据库，替换
wrangler.jsonc中的数据库名称与 ID，保留代码使用的JOBS_DB绑定名。若数据库改名，同步修改package.json中的迁移脚本。 - 调整 Worker 名称、Workflow 名称和域名路由。保留
ASSETS、JOBS_WORKFLOW等代码依赖的绑定名；使用自己的域名，或移除作者的自定义域名路由后使用 Workers 默认地址。 - 更新
astro.config.mjs和worker/settings.ts中的站点地址，并核对页面、静态资源中的品牌信息与固定链接。 - 在自己的环境配置
DEEPSEEK_API_KEY等所需 Secrets，为新数据库应用初始迁移，并核对定时任务、邮件和可选 FC 设置。邮件需要单独配置发信能力，不能只打开提醒变量。 - 运行类型检查、测试和部署预检查，通过后发布。
npx wrangler login
npm test
npm run deploy:dry
npx wrangler deploy --keep-vars --strict更新已有部署时，先记录实际线上版本并核对远端配置，保留 Secrets、普通变量、域名、D1 绑定和定时任务。--keep-vars 与 --strict 不能替代配置核对。已初始化的数据库不需要重复建库或重复应用迁移。
发布后验证首页、课程页、求职列表与详情、静态资源和 404。作者实例的资源信息、更新与回退流程见 JOBS.md。
欢迎通过 Issue 反馈问题、通过 Pull Request 提交改进。提交前请阅读 AGENTS.md，并说明修改目的、影响范围和验证方式。
- 首页内容维护于
src/data/site.ts，Kimi 目录与发布状态维护于src/data/kimi.ts。 - 技能画像与模型配置维护于
worker/settings.ts，分析规则维护于worker/analysis.ts。 - 求职主题通过共享布局的
theme="jobs-clay"启用，修改时保持官网与课程页的视觉独立。 - 业务修改运行相关测试与构建；UI 修改检查真实浏览器中的桌面和手机布局、图片、筛选、键盘焦点与弹窗。
- 密钥、私人配置、
node_modules、缓存和构建产物不提交到仓库；项目使用的生成素材保存在仓库内。
| 文档 | 内容 |
|---|---|
| AGENTS.md | 开发约定与发布要求 |
| JOBS.md | 求职功能、API、配置、运行快照与发布记录 |
| DESIGN.md | 求职页面视觉规范 |
| ASSETS.md | 图片与 3D 图标清单 |
| PROMPTS.md | 素材生成提示词与索引 |
| fc/README.md | 可选阿里云 FC 抓取服务 |
本项目采用自定义的 MiniCode 学习用途许可协议 1.0，以源码可用形式发布。
- 允许：个人学习、非商业技术研究与教学演示，以及为这些目的进行的运行、修改、Fork 和分享；须保留版权与许可声明，标注修改。
- 须另行授权：商业网站、收费服务、客户项目、企业内部业务使用、付费课程或培训，以及广告、推广等商业用途。免费提供服务不自动代表非商业用途。
- 个人学习成果：通过学习提升职业技能、在求职中展示练习成果，本身不视为商业使用。
- 第三方与品牌：第三方依赖和素材遵循各自许可；不得冒充官方或将 MiniCode、Winter喵及眼镜猫形象作为自身产品品牌。
商业授权请通过 Winter喵的 B 站主页 联系，说明用途与使用范围，以双方书面授权为准。