Oniums.github.io

Oniums 的个人博客，使用 Hexo 和 Butterfly 构建，通过 GitHub Pages 发布。

AI 协作与交付规则见 AGENTS.md，配套入口为 CLAUDE.md。自 2026-09-10 起，写博客默认完成脱敏、页面检查、提交、推送和线上验证，不重复询问发布；明确要求仅草稿、仅大纲、先审阅或不推送时，遵守更窄范围。

许可

本仓库采用混合许可，见根目录 LICENSE。七个工程工具及必要支持文件中的自有代码采用 MIT，仅限 逐文件清单；许可页 提供可读范围说明，第三方声明 记录依赖、公开测试资料与参考来源。网站入口为 /tools/licensing/。

博客文章继续采用 CC BY-NC-SA 4.0；主题、图片、字体、头像／天气工具及未列明内容不纳入此次授权。package.json 不声明全仓库 MIT。npm run prepare-pages 同步后自动检查许可链接、清单依赖及发布副本一致性。

本地使用

npm ci
npm run server

完整构建检查：

npm run check

准备 GitHub Pages 发布文件：

npm run prepare-pages

Hexo 首先把生成结果写入 public/，站点检查通过后，再由受控脚本同步到仓库根目录。public/ 本身不提交到 Git。

内容结构

• source/_posts/：公开技术文章
• source/about/：个人介绍
• source/experience/：匿名化工作经历
• source/projects/：项目与实践方向
• source/tools/：公开工具箱，含七个工程工具、头像生成器与天气站，以及空间站入口；页面为静态文件；assets/calculations.mjs 为纯计算核心。工程工具输入仅在浏览器内处理，配网内容不持久化；天气与空间站连接各自注明的公开服务。二维码依赖为本地固定版本副本，来源与许可见 source/tools/assets/vendor/README.md。
• 第二批工具：firmware-diff/ 对比本地 BIN（最多 64 MiB / 文件，模块 Worker 计算 SHA-256 和差异）；log-timeline/ 整理时间戳、事件与 CSV，通过公开步骤 ID 跳转配网播放器；thread-dataset/ 查看 TLV、隐藏凭据和网络标识。核心逻辑分别在 assets/binary-core.mjs、timeline-core.mjs、dataset-core.mjs，边界测试在 tools/test-analysis-tools.mjs。
• source/tools/serial/：Web Serial 串口调试台，桌面兼容浏览器访问本机串口。assets/serial-core.mjs 负责严格发送编码、流式解码、跨块换行和有界日志缓存；serial-port.mjs 管理串口读写与关闭；serial.mjs 管理勾选显示、筛选高亮、信号线、定时发送、快捷命令和本地导出。网页、文件名、文本自动保存及 JSON 导出统一使用浏览器本地时间，显式保留时区偏移（内容如 +08:00，文件名如 +0800），由 localTimestamp 按记录时刻计算；串口入口及模块依赖携带版本参数，相关资源更新时同步更新以避免旧缓存混用。接收区默认独占整行、660 px 高，可选高度、拖动调整或展开至窗口（Esc 还原）。可恢复读流异常按计数与 5 秒摘要记录；默认勾选“隐藏接收告警日志”，从视图、复制和筛选文本导出中过滤该类 SYS 摘要，可取消勾选恢复。顶部提示、告警计数、文本自动保存中的摘要与中断标记、停止接收等错误不受影响；仅在读流重建时重试，连续 5 次无新数据失败停止接收。NUL 是合法数据，不会触发网页读取错误。默认勾选“隐藏纯 NUL 接收行（文本）”，仅过滤全为 NUL 的 RX 文本行，复制及筛选文本导出同步过滤；可取消勾选恢复查看，不影响混合文本、TX、HEX 视图、告警计数、原始导出或自动保存。串口数据与命令不上传、不写浏览器存储；serial-save.mjs 提供可选本地文件自动保存，按周期关闭流提交，支持 UTF-8 日志（可含时间戳和 TX）或原始 RX 字节。单文件模式追加已有内容；按时间模式选择一次目录，默认每 60 分钟创建带本地时间、时区偏移、会话标识及序号的新文件（可设 1–1440 分钟），与 2/5/10 秒提交周期独立。按启用时刻起算，用单调时钟判定轮换，后台恢复不补造空文件；分段交接保留流式解码状态和待提交数据，新文件创建失败也保留待保存副本。写入失败停止记录并提供待保存副本；强制关闭不能保证未提交数据。自动保存独立于显示缓存，原始数据最多保留 8 MiB / 4,096 块、文本 5,000 行，淘汰量明确显示。tools/test-serial.mjs 覆盖编码、缓存及模拟串口生命周期；tools/test-serial-browser.mjs 可用外部 Playwright 运行浏览器交互验证，见文件头。自动化模拟不代表真实硬件验证。
• 串口测试会话：assets/serial-experiment.mjs 独立管理完整 RX 行、命名会话、手动/设备标记、!p 数值曲线及纯文本日志条件；灵感来源为 MCUscope，独立实现，不包含上游源码。会话最多 2,000 行/1 Mi 字符、100 标记、8 通道各 600 点；JSON 导出含规则/缺口/淘汰数，CSV 为保留曲线。开始新会话替换旧记录，结束后判定；后台切换、断线、读流错误、半行、解码错误和 RX 淘汰阻止通过；显示筛选、清屏和终端暂停不影响输入。仅支持说明中的 !p/!m 子集，无后台守护进程、CLI、monitor 命令或 typed streams。来源和使用边界见文章，核心测试 tools/test-serial-experiment.mjs 纳入完整检查，浏览器测试扩展在 tools/test-serial-browser.mjs。
• tools/test-toolbox.mjs：公开测试向量、数值边界和发布同步保护测试，运行 npm run test:tools，也包含在完整检查中。/tools/ 的生成页面与仓库构建脚本共用目录，同步脚本只清理列明的页面和资源子目录，禁止整体删除 tools/。
• source/playground/commissioning/：配网过程播放器，独立静态页面；scenarios.js 定义教学场景，player.js 控制播放与状态回看，player.css 定义界面。skip_render 保留原始模块文件。
• 工具箱与配网播放器均可通过顶部一级导航、首页首屏快捷卡片或 Lab 总览进入。scripts/home-shortcuts.js 在构建时插入首页卡片，样式位于 source/css/custom.css；手机菜单沿用同一份主题导航配置。
• source/playground/radar/：雷达交互课堂基础篇，4 章 16 小节。course.mjs 管理逐节讲解、预测题和实验任务；physics.mjs 实现理想静止 FMCW、采样、量化与实际 FFT；plots.mjs 绘制曲线，app.mjs 管理场景拖动和章节导航。输入与进度仅在页面内存中保留，公开参考与模型边界列在课程页。首页首屏、一级导航、工具箱和 Lab 总览均有入口。
• tools/test-radar.mjs：模型数值、FFT 与直接 DFT 对照、混叠、窗函数、补零和课程完整性测试，运行 npm run test:radar，已纳入完整构建检查。
• source/playground/presence/：人存实验室，构造点云经过区间过滤、时间确认与无人延时，演示人物移动/静坐、风扇干扰、空帧/断流/旧帧、点云背景门限与芯片分工。检测距离覆盖 [0, 8) m，按 0.5 m 分为 16 个区间；场景纵深 10 m，可观察范围外的过滤效果。engine.mjs 是确定性纯计算模型，app.mjs 管理场景和模拟时钟；不读取人物标签做分类，不连接设备、不上传或持久化数据。公开页只用通用规则，不带内部产品型号、参数或源码。
• tools/test-presence.mjs：区域边界、时间确认、存在样本去重、空帧与失联、恢复、背景门限及真值隔离测试，纳入 npm run test:radar。人存实验室从首页第四张快捷卡、实验室菜单与总览、雷达基础课和工具箱均可进入。
• _config.yml：Hexo 配置
• _config.butterfly.yml：当前 Butterfly 主题覆盖配置
• _config.fluid.yml：旧 Fluid 主题配置，仅保留为回退参考

发布边界

• 只发布可公开、经过整理的内容。
• 不发布公司内部信息、未公开产品细节、密钥、证书、设备标识或原始工作日志。
• 不发布姓名、照片、手机号、薪资、公司名称或具体产品型号。
• 私人知识库只作为选题来源，不与本站自动同步。
• 当前 GitHub Pages 从 main 根目录直接发布，提交前必须运行 npm run prepare-pages。

趣味探索与评论

• /tools/avatar/：两种机器人风格、外壳/背景色、圆角、透明与翻转选项，512 px PNG / SVG 下载。DiceBear 9.4.3 固定在本地 bundle，同名同设置可重现；昵称不上传。来源、许可与校验见 本地依赖说明。
• /playground/iss/：Where the ISS at? 公开位置接口，每 10 秒轮询、失败退避最多 60 秒、手动刷新至少间隔 5 秒、后台暂停；超过 45 秒的采样标为过期，不外推位置。轨迹只保留本次访问最多 180 点/30 分钟，跨日期变更线断开。太阳照射状态不等于地面可见。
• ISS 陆地轮廓来源：Natural Earth v5.1.2 的 ne_110m_land.geojson，公共领域；原始 SHA-256 9e0729ee253ca7d7a5c4ae9395fb1902264c5377c52e224d13dd85010e2835d9。world.svg 按 x=(lon+180)/360*1000、y=(90-lat)/180*500 转换多边形，保留两位小数与环，不含国家边界。
• /tools/weather/：Open-Meteo 城市搜索与天气预报。手动选城市，不请求定位；请求发送城市名/坐标。使用 Unix 时间与城市时区，展示模型当前天气、未来 24 小时与五天预报；缺失数据保持为空。内存缓存 10 分钟，手动刷新间隔 60 秒；切换城市会取消旧请求，失败时明确标出保留数据所属城市。
• 首页和博客主题页面顶部提供“本地天气”，已有定位授权时自动显示左下角浮窗。未授权不自动弹窗，可点击主动授权；拒绝、定位失败、天气失败或数据超过两小时则隐藏。位置取两位小数后请求 Open-Meteo，不使用 IP 定位，不持久化坐标；关闭状态仅记在当前标签页会话中。静态工具页仍按各自 CSP 工作，不注入定位功能。
• 新页面使用独立 CSP，只开放其需要的服务；头像页禁止网络 API 请求。既有工程工具的本地数据边界不变。
• giscus 原生评论配置位于 _config.butterfly.yml，连接公开仓库 Oniums/Oniums.github.io 的 Announcements 分类。按 pathname 严格匹配，中文、懒加载、随主题切换颜色；评论保存在 GitHub Discussions。仓库须开启 Discussions，并安装 giscus App。giscus.json 将可用来源限制为正式站点。
• 评论继续使用 GitHub 头像。在评论区提供头像工具入口，用户下载 PNG 后可自行设置 GitHub 头像；本站不替换 iframe 内头像，也不处理 GitHub 登录令牌。scripts/comment-avatar-link.js 在生成时插入说明和讨论区备用入口；source/js/comment-support.js 核对 giscus 消息来源后，将服务错误转为中文提示与重试入口，不将正常的“暂无讨论”当故障。
• 删除评论：giscus 当前没有内嵌编辑/删除控件。评论区提供“管理 / 删除评论（GitHub）”和刷新按钮；开启元数据后，验证 iframe 来源及讨论 URL，再将入口定位到当前文章的 GitHub Discussion。没有讨论时使用当前文章路径搜索；权限由 GitHub 判断，不在博客保存管理令牌或执行删除。
• 核心测试 tools/test-explore.mjs 已纳入 npm run prepare-pages。浏览器测试 tools/test-explore-browser.mjs 使用 Playwright，覆盖头像导出、地图与天气成功/失败、城市请求竞态和移动布局；使用模拟 API 的结果不代表线上服务可用性。
• tools/test-site-widgets-browser.mjs 验证天气授权/拒绝/撤销/超时/缓存/关闭与移动布局，以及评论管理元数据来源校验和刷新；定位和服务响应使用测试替身，线上另测静态资源与已存在讨论的真实元数据。