个人博客与作品集的 Hugo 副本，使用 Hugo 和 PaperMod 构建。
unc1e.cn：跳转到语雀；语雀是日常写作的第一真相源。www.unc.la：Hugo canonical 站点，由 Vercel 构建。code.unc1e.com：同一份 Hugo 内容的 GitHub Pages 镜像。unc1e.com：预留为 Hugo 域名，绑定与跳转策略后续配置。
站内同步语雀公开文章，分为安全研究与工程实践、思考与生活记录两个栏目。Web Archive 提交暂未实现。
环境要求：Git，以及 Hugo 0.164.0 或兼容版本。
git clone --recurse-submodules git@github.com:hi-unc1e/cv.git
cd cv
hugo server -D原创静态小工具位于 static/funny/。工作状态趣味自检的公开路径是
/funny/work-checkin/，所有答案只在浏览器中计算，不会发送到服务端。
本地逻辑可单独验证：
node --test tests/*.test.*如果仓库已经克隆：
git submodule update --init --recursive
hugo server -D生产构建：
hugo --gc --minify
node scripts/verify-build.mjs public生成目录为 public/，它不进入 Git。
文章按来源栏目放在 content/posts/penetration/ 和 content/posts/thoughts/。新建原创文章仍可直接放在 content/posts/：
hugo new content posts/my-post.mdFront matter 约定：
title、date、lastmod：标题与时间。slug：强制英文 URL 安全，^[a-z0-9][a-z0-9._-]*$（小写、数字、._-）。中文标题可以，但slug与新建文章文件名应使用英文。示例：agents-next-problem-is-action-boundary。description：用于列表摘要和 SEO。tags、categories：站内分类。source_url：原文来自语雀时记录原文 URL；本站原创可留空。source：批量导出的语雀来源标识，例如yuque/penetration；迁移内容保留该字段。draft：发布前保持true，确认后改为false。
Git hook 会在 commit 时校验 staged 文章的 slug（含中文 / 大写 / 空格会直接失败）。克隆后执行一次：
git config core.hooksPath .githooks手动全量检查：
node scripts/check-content-slugs.mjs语雀同步的最低原则是：语雀正文为内容真相源，Git 保留公开 Markdown 副本；同步器不会删除博客中已有但本次导出未包含的文章。
导入新导出的语雀文章：
# 只检查，不写文件
node scripts/import-yuque.mjs --dry-run
# 执行增量导入；默认读取 ../knowledge/yuque-export
node scripts/import-yuque.mjs
# 指定其他导出目录
node scripts/import-yuque.mjs --source /absolute/path/to/yuque-export导入器会核对 index.json、公开状态、文件、日期和 slug，修复 front matter 引号与不可见 NUL 字节，并拒绝空 slug、非 URL 安全 slug 和重复 slug。已经发布的 slug 默认保持不变；如果同一文件的 slug 被主动修改，旧地址会自动写入 Hugo aliases。仅修改标题造成导出文件名变化时，导入器会按稳定 slug 找回原内容文件，避免重复页面。
已经从文章迁为独立页面的语雀内容记录在 data/yuque-relocations.json。目标页面必须为原文章地址提供 alias；导入器会验证迁移关系，不会把它重新加入文章列表。
语雀 CDN 图片继续使用原始外链。项目级 Markdown 图片 render hook 会为 cdn.nlark.com 设置 referrerpolicy="no-referrer"，避免外站 Referer 触发防盗链 403。
站点启用 Hugo 的 CJK 语言检测，文章元信息按中文字符统计，并以约 500 字/分钟估算阅读时间；不要移除 hasCJKLanguage: true，否则无空格的中文段落会被严重低估。
- 推送或合并到
main后，GitHub Actions 构建并发布到 GitHub Pages。 - Vercel 的 Git 集成使用
vercel.json构建public/，并继续提供分支预览。 - PaperMod 作为公开 Git submodule 固定到主仓库记录的提交；升级主题时单独提交 submodule 指针变更并执行完整构建检查。
layouts/包含 PaperMod issue #1856 的 Hugo 0.158+ 兼容覆盖、表格可访问性和语雀 CDN 图片加载适配；升级主题时应逐项复核并重新严格构建。
devdocs/、.claude/ 和 .open.sh 仅供本机使用，已从公开仓库的跟踪边界排除。