模板有bug和需要优化的地方可以留言
模板名称
KernelInk
模板介绍
KernelInk 更新记录
1.0.0 - 2026-07-20
正式首发
设计与基础体验
- 建立面向程序员写作的 IDE、终端与克制毛玻璃视觉系统，提供清晰的内容层级和响应式布局。
- 支持深色、浅色和跟随系统的初始模式；访客选择可在浏览器本地保存。
- 支持自定义文字/图片 LOGO、Favicon、终端强调色、首页身份标签与站点简介。
- 提供简体中文与 English 完整主题词典；后台设置站点默认语言，访客可在页脚独立切换。
- 动态文案、ARIA、Tooltip、占位符和状态反馈接入同一翻译层。
- 支持 prefers-reduced-motion、键盘操作、焦点管理、移动抽屉和响应式二级菜单。
- 关键二维码、图标、代码高亮样式和 UI 资源本地提供，不依赖公共前端 CDN。
首页 Code Workbench
- 使用全宽首屏工作台，包含 whoami 身份区、置顶文章 Explorer、真实文章提交时间线和 DATA BUS。
- Activity Rail 可打开资源管理器、站内搜索、站点状态和快捷终端，并提供键盘与无障碍状态。
- 纯 Canvas DEV_BOT 支持高分屏、离屏/后台暂停和减少动态效果。
- DEV_BOT 按“字符雨启动 → 配置代码逐字输入并随内容上卷 → 停留 → 淡出重播”播放，不限制代码行数。
- 机器人下方工作台代码支持多行配置及 {blogname}、{role}、{articles} 动态占位符。
- 可选 FPS HUD 直接绘制在 CRT 屏幕；关闭时不创建检测组件。
- 首页右侧 IDE 工作台自适应可用宽度和视口高度，减少首屏空白与无意义滚动。
- Ctrl/Cmd + K 站内搜索使用轻量合成动画，兼顾 Chrome 与移动设备性能。
文章列表与内容发现
- 首页文章流提供“全部 / 有封面 / 置顶”当前页筛选。
- 文章卡统一封面尺寸；无显式封面时从公开正文提取最多 4 张图片并保持单行自适应，加密文章不扫描正文。
- 首页文章支持点赞与取消点赞，对接 Emlog 核心 Like_Model，并在翻页加载后保持完整交互。
- 文章卡加入程序员编译状态微动效、悬停反馈与合理卡片间距。
- 置顶 Explorer 只在标题悬停或聚焦时高亮，避免整块区域产生误导。
- 最新文章可优先显示封面，无封面时回退到正文图片。
文章阅读器
- 文章详情采用与顶部导航同宽的“左侧独立吸顶目录 + 右侧正文”布局，无目录时自动单列居中。
- 面包屑位于标题卡与正文阅读区之间，保持连续阅读路径。
- 提供阅读进度、正文真实字数、预计阅读时间、浏览/评论信息和上一篇/下一篇。
- 文章顶部支持最近 90 秒匿名在线阅读人数估算，并自动排除已识别爬虫。
- 浏览器本地语音朗读支持播放、暂停、继续和停止，长文章自动分段，兼容移动端语音队列。
- 支持系统原生分享、微博、QQ 空间、复制链接和完全本地 Canvas 二维码。
- 预设 KernelInk、Midnight、Nord、Ember、Matrix、Paper 六套本地代码高亮配色，兼容常见 Markdown、highlight.js、Prism 和旧式行号结构。
- 提供文章标签、相关文章、评论、广告和邻接文章的完整内容流程。
评论体验
- 评论输入区采用 comments.cmd 终端工作台视觉，同时保留 Emlog 登录评论、游客字段、回复和验证码流程。
- 支持文字与最多 4 张图片一起评论，包含上传预览、移除、类型/体积校验及 Emlog 原评论审核流程。
- 提供不加载外部资源的快捷系统 Emoji 面板。
- 评论列表兼容新版 Emlog 数据结构和嵌套回复，修复只有评论数量却不显示正文的问题。
- 可显示评论者脱敏 IP 及本地识别的操作系统图标，也可完全隐藏 IP；不提供公开完整 IP 的选项。
侧边栏与导航
- 标签固定四列，长名称省略显示，并按名称稳定分配到四套可配置颜色。
- 分类与存档使用两列卡片布局，存档全部展开，不再使用下拉框。
- 最新文章支持独立封面或最多 4 张正文图片的单行回退布局。
- 侧栏友情链接支持后台图片/图标、四列自适应和一致的卡片尺寸。
- 列表页侧边栏具有合理最低高度并使用整页滚动，与文章流自然对齐，取消嵌套滚动条。
- 移动端使用完整抽屉导航、优化二级菜单，并避免 390px 视口横向溢出。
友情链接与联系
- 页脚对接 Emlog 友情链接缓存，展示链接图标，并以自定义 Tooltip 显示后台描述。
- 可在外链跳转前展示主题化确认弹窗，提示内容由站长配置。
- 提供“友情链接申请”自定义页面：访客提交站名、网址、简介、邮箱和图标后，通过 Emlog 邮件接口通知站长。
- 友链申请包含表单令牌、蜜罐、输入校验和匿名频率限制。
- 返回顶部工具区可分别配置 QQ、微信和微信公众号二维码；桌面与移动设备均支持安全打开/关闭。
流式照片墙
- 提供“流式照片墙”自定义页面和后台可排序图片内容块，无需文章自定义字段。
- 使用响应式 Contact Sheet 瀑布布局、照片展签、懒加载和低成本动态信号丝带，强化真实照片墙氛围。
- 本地灯箱支持键盘方向键、Esc、触屏滑动和图片失败降级。
- 每张照片拥有稳定深链接、独立点赞/取消、复制地址和本地二维码分享。
- 使用一张 kernelink_gallery_like 幂等关系表保存页面、照片和匿名 HMAC 点赞关系；启用/升级可自动建表，缺表可自愈，后台删除主题时尝试清理。
天气与音乐
- 首页可显示 Open-Meteo 实时天气，支持默认坐标、位置名称和访客授权定位。
- 根据天气码展示晴、云、雨、雪、雷、雾等动态效果；离屏、后台标签页和减少动态效果模式会暂停动画。
- 天气请求提供本地缓存和失败降级，不需要 API Key。
- 提供符合主题风格的全站音乐控制台、播放列表、进度、音量和折叠状态。
- 后台可视化曲目编辑器支持平台、网易云歌曲 ID、QQ 音乐 MID、歌名、歌手、专辑、封面、授权音频和歌词字段。
- 曲目支持添加、克隆、删除、拖动排序，并可兼容导入旧式链接、iframe、key=value、紧凑格式和 JSON 配置。
- 网易云歌曲 ID 支持同源签名 HTTPS 媒体跳转及官方嵌入回退，降低混合内容和浏览器 CORS 影响。
- QQ 音乐 MID 提供官方页面通道；站长可为有权使用的曲目配置长期 HTTPS 音频。
- 支持内嵌 LRC 和受限同源外部歌词读取；可在站点底部同步展示当前歌词，无歌词时自动隐藏。
广告、备案与页脚
- 提供文章列表顶部、文章详情顶部、文章详情底部和侧边栏顶部四个结构化广告位。
- 广告位支持图片、标题、纯文本说明和 HTTP(S) 链接；不执行自定义 HTML/脚本，外链标记 sponsored。
- 页脚可显示带本地官方图标的 ICP 备案和公安备案，并自动生成公安备案查询链接。
- 运行监测可选显示页面加载、服务端生成、数据库延迟探针、查询次数、在线人数和站点运行天数。
- 支持设置建站起始日期，并按当前日期计算运行天数。
- 提供 /sitemap.xml 公开文章/页面兜底和可配置页脚入口；已有静态文件或插件 Sitemap 优先。
- 页脚监测使用紧凑布局，各指标和总开关均可配置。
统计、隐私与安全降级
- 全站在线和文章阅读使用时间窗口内的 HMAC 指纹估算，不在主题状态中保存原始 IP/User-Agent。
- 可选爬虫检测按天聚合最近 7 日 Bot 名称与请求次数；关闭后停止统计和组件输出。
- 照片点赞只保存匿名 HMAC 关系；文章点赞使用 Emlog 核心数据模型。
- 评论图片、友链申请、歌词代理、照片点赞等接口包含同源/令牌、白名单、大小、超时及频率限制。
- 外部歌词仅允许后台配置曲目和受限公网 HTTPS 目标，避免将主题变为开放代理。
- PHP、数据库、邮件、cURL 或第三方服务不可用时，相关增值功能安全降级，不阻断普通文章页面。
- 提供独立 LICENSE、PRIVACY、CHANGELOG 和完整安装说明，明确第三方服务、数据保留、权限及卸载行为。
发布说明
- 首个正式公开版本为 1.0.0。
- 作者信息统一为“小诸葛”，作者主页为 https://www.v6g.cn。
- 发布包采用单一 kernelink 根目录，可从 Emlog 后台直接上传安装。
- 主题无需文章自定义字段；照片点赞关系表由主题回调自动创建。
- 代码以 PHP 7.4+ 和 Emlog Pro 当前稳定版本为兼容目标；建议部署前在目标环境完成备份与验证。
安装说明
一、安装前说明
- KernelInk 是 Emlog Pro 模板，发布包的根目录应为 kernelink。
- 代码以 PHP 7.4+ 和 Emlog Pro 当前稳定版本为目标。
- 正式站点安装前，请备份数据库和 content 目录，并优先在相同 PHP/Emlog 环境的测试站验证。
- 不需要安装配套业务插件，不需要新增文章自定义字段，不需要手工添加数据库字段或执行 SQL。
- 照片点赞需要主题自动创建一张 kernelink_gallery_like 关系表；只有使用该功能时才依赖数据库建表权限。
二、直接上传 ZIP 安装
- 登录 Emlog 后台。
- 进入“外观 → 模板”，点击“上传模板”或“上传安装”。不同 Emlog Pro 版本的按钮名称可能略有差异。
- 选择正式发布的 ZIP 文件并上传。ZIP 解压后的第一层必须是 kernelink 文件夹，不能把所有 PHP 文件直接放在压缩包根目录，也不能形成 kernelink/kernelink 双层目录。
- 安装完成后，在模板列表中找到 KernelInk 并点击“启用”。
- 打开 KernelInk 的“模板设置”，保存一次基础配置，然后清理网站/CDN/浏览器缓存。
- 分别检查首页、文章详情、评论、搜索、手机导航和 404 页面。
如果后台限制 ZIP 上传，可将整个 kernelink 文件夹通过文件管理器或 SFTP 上传到：
content/templates/kernelink
上传后回到“外观 → 模板”启用即可。
结论：正常情况下，直接上传正式 ZIP、启用并配置即可。无需额外添加文章字段或数据库字段。
三、首次配置建议
进入“外观 → 模板 → KernelInk → 模板设置”，建议按以下顺序配置：
-
基础外观
- 选择文字或图片 LOGO，上传 Favicon。
- 设置网站默认语言、默认深浅模式和终端强调色。
- 默认语言只决定访客首次访问时的界面；访客仍可在页脚切换中文或 English。
-
首页内容
- 填写身份标签、站点简介、DEV_BOT 屏幕代码和工作台代码。
- 工作台代码支持 {blogname}、{role}、{articles} 占位符。
- 按需开启首页文章点赞、FPS HUD 和动态天气。
-
阅读与侧栏
- 选择代码高亮配色。
- 设置四种标签颜色。
- 按需开启评论图片、Emoji、评论客户端信息和 Bot 流量统计。
- 评论 IP 可选择“脱敏展示”或“隐藏”；主题不提供公开完整 IP 的选项。
-
页脚与联系
- 配置友情链接、运行监测、运行起始日期、Sitemap 入口、ICP 和公安备案。
- 上传 QQ、微信、公众号二维码，并分别开启需要的入口。
- 四个广告位只接受主题提供的图片、标题、纯文本说明和 HTTP(S) 链接，不执行广告 HTML 或脚本。
四、需要额外配置的功能
- 评论图片
- 在模板设置中开启“评论图片上传”，并设置单图大小上限。
- 每条评论最多 4 张图片；实际大小仍受 PHP、Web 服务器和 Emlog 附件上限约束。
- 确保 Emlog 的 content/uploadfile 可写，并在系统附件类型中允许 jpg、jpeg、png、gif、webp。
- 图片先进入 Emlog 附件库，再随文字进入原有评论提交和审核流程。
- 友情链接跳转与自助申请
- 跳转确认：在模板设置中开启“友情链接跳转提示”，填写纯文本提示内容。
- 自助申请页面：
- 后台进入“页面 → 新建页面”。
- 页面标题可填写“友情链接申请”。
- 在页面模板中选择“友情链接申请”，然后发布。
- 回到模板设置，开启“开放自助申请友链”，并在“友链申请页面”选择刚创建的页面。
- 填写接收通知的邮箱（支持 QQ 邮箱）及申请说明。
- 邮件通知依赖 Emlog 系统邮件服务。请先确认 Emlog 可以正常发送测试邮件；主题本身不提供 SMTP 账号。
- 如需导航入口，请在 Emlog 导航管理中添加该页面。
-
流式照片墙
-
后台进入“页面 → 新建页面”。
-
页面标题可填写“照片墙”。
-
在页面模板中选择“流式照片墙”，然后发布。
-
回到模板设置，开启照片墙，并在“照片墙页面”选择刚创建的页面。
-
在“照片墙图片”内容块上传图片；内容块标题会作为照片说明，可拖动调整顺序。
-
如需导航入口，请在 Emlog 导航管理中添加该页面。
照片墙无需文章自定义字段。启用主题时，callback.php 会自动创建 DB_PREFIX + kernelink_gallery_like 表，用于保存照片点赞关系。数据库账号应具备 CREATE TABLE 权限；若希望在后台删除主题时自动绿色清理，还需具备 DROP TABLE 权限。建表失败不会阻止普通文章访问，但照片点赞会不可用。
- 首页实时天气
- 开启天气组件后，填写默认纬度、经度和位置名称；例如北京 39.9042、116.4074。
- 天气数据来自 Open-Meteo，不需要 API Key，但服务器或访客网络必须能访问该服务。
- 自动定位通常要求 HTTPS。访客拒绝或浏览器不支持定位时，会继续使用默认位置。
- 音乐播放器与页底歌词
- 开启播放器后，点击“添加曲目”，分别填写平台、网易云歌曲 ID 或 QQ 音乐 MID、歌名和歌手。
- 可在高级设置中填写专辑、封面、你有权使用的 HTTPS 音频地址、LRC 地址或直接粘贴 LRC。
- 网易云 ID 可使用官方嵌入播放器或主题解析流程；QQ MID 默认提供官方页面入口。平台版权、地区和防盗链策略可能影响站内播放。
- 跨域歌词读取和网易云媒体解析在服务器启用 PHP cURL 时体验最佳；没有 cURL 时，站内填写的 LRC 和可被浏览器直接访问的授权资源仍可使用。
- 不要长期保存带过期签名的 m*.music.126.net 临时地址，也不要使用未经授权的音频资源。
- 浏览器通常禁止未交互的有声自动播放，访客需要主动点击播放。
- 运行监测、在线人数与爬虫统计
- 这些功能均可在模板设置中关闭。
- 页脚页面加载指标主要来自浏览器 Navigation Timing；服务端生成、数据库探针和查询数来自当前请求环境。
- 全站在线和文章阅读人数是匿名时间窗口估算，不等同于精确实时人数。
- Bot 统计仅保存按日期和爬虫名称聚合的数据，不保存完整 IP 或 User-Agent。
- 开启前请阅读 PRIVACY.txt，并按站点所在地法规补充自己的隐私政策。
- Sitemap、备案与友情链接
- Sitemap 兜底与页脚入口默认关闭。需要时先确认已有 Sitemap 插件/静态文件，或开启主题兜底，再开启页脚入口。
- ICP 与公安备案号可在主题中填写；ICP 留空时可回退到 Emlog 系统备案设置。
- 友情链接读取 Emlog 后台已有链接数据，可展示后台配置的图标和描述；无需重复录入。
五、服务器与权限清单
基础运行：
- content/templates/kernelink 目录中的模板文件可被 PHP 读取。
- content/uploadfile 对 Emlog 上传功能可写。
- 网站可正常加载本地 CSS、JavaScript、SVG、ICO、PNG 和 JPG 文件。
按功能可选：
- PHP cURL：外部 LRC 同源读取和网易云媒体解析。
- Emlog 邮件服务：友情链接申请邮件通知。
- CREATE TABLE：首次创建/自愈照片点赞关系表。
- DROP TABLE：从后台删除主题时绿色清理照片点赞关系表。
- HTTPS：浏览器定位、剪贴板、系统分享和媒体资源兼容性更佳。
CDN 或全页缓存不要缓存带 kernelink-action 的接口请求；页面缓存应按 kernelink_lang / kernelink_lang_ui Cookie 或 kernelink-lang 查询参数区分语言。更新后请同步清理 PHP OPcache、CDN 和浏览器缓存。
六、文章发布说明
- 直接使用 Emlog 标题、正文、摘要、分类、标签、封面和置顶功能即可。
- 无需创建任何文章自定义字段；发布包中也不包含 custom_fields.php。
- 未设置封面时，主题可从公开正文提取最多 4 张图片用于列表展示；加密文章不会扫描正文图片。
- Markdown 或编辑器生成的 pre/code 代码块会使用模板设置中选择的本地高亮配色。
- 文章目录由正文标题自动生成，无标题时自动使用单列阅读布局。
七、更新、停用与删除
- 更新前备份数据库、content/templates/kernelink 和重要主题设置。
- 使用正式完整 ZIP 覆盖更新，避免新旧文件混用；更新后重新保存设置并清理所有缓存。
- 仅停用主题不会删除主题数据。
- 从 Emlog 后台执行“删除主题”并成功触发 callback_rm 时，会尝试删除照片点赞关系表及 KernelInk Storage 数据。
- 评论、文章、自定义页面、Emlog 友情链接和已上传到附件库的图片属于 Emlog 内容，不会随主题删除；请在 Emlog 后台按需清理。
- 直接通过文件管理器删除目录可能不会触发清理回调。
八、安装后检查
- 首页 DEV_BOT、搜索和文章筛选可正常交互。
- 文章详情目录、语音、分享、二维码和评论可正常使用。
- 中文 / English 能从页脚切换并在刷新后保留。
- 手机端导航、二级菜单、播放器和分享弹窗没有横向溢出。
- 开启的天气、邮件、歌词、照片点赞等外部或权限依赖功能可正常降级。
- 浏览器控制台没有 404、混合内容或 CORS 错误。
- 站点隐私政策已覆盖启用的统计、评论、天气、音乐和外部资源。
九、发布目录
kernelink/
404.php
callback.php
echo_log.php
footer.php
header.php
log_list.php
module.php
module_music.php
module_weather.php
options.php
page.php
page_friend_apply.php
page_gallery.php
plugins.php
pw.php
side.php
preview.jpg
README.txt
安装说明.txt
LICENSE.txt
PRIVACY.txt
CHANGELOG.txt
css/
features.css
markdown.css
music-admin.css
music-player.css
style.css
weather-widget.css
images/
logo.svg
miit-official.ico
mps-beian.png
weather-sprite.svg
js/
gallery.js
main.js
music-admin.js
music-player.js
qr-local.js
weather-widget.js
languages/
en_US/
main.php
zh_CN/
main.php
十、故障排查
- 样式或脚本仍是旧版：清理 OPcache、CDN、页面缓存和浏览器缓存，确认没有 kernelink/kernelink 双层目录。
- 前台语言无法保存：检查 Cookie 策略；主题会使用 Cookie、localStorage 和查询参数降级，但缓存仍需按语言区分。
- 网易云或 QQ 音乐无法播放：先检查平台版权/地区限制，再确认使用 HTTPS、合法长期音频地址及 cURL；临时 CDN 签名地址会失效。
- 外部 LRC 报 CORS：不要让浏览器直接请求不允许跨域的歌词地址；启用 PHP cURL，让主题受限接口同源读取，或直接粘贴 LRC。
- 友链申请没有邮件：先在 Emlog 中验证系统邮件服务，并检查垃圾邮件箱和收件邮箱配置。
- 照片点赞不可用：检查数据库用户的 CREATE TABLE 权限，以及 DB_PREFIX + kernelink_gallery_like 表是否成功创建。
- 评论图片失败：检查附件类型、上传目录权限、PHP upload_max_filesize/post_max_size 和 Emlog 附件限制。
安全建议：生产环境关闭 PHP display_errors，通过服务器日志排查错误；所有外部音频、图片和广告素材均应确认授权与长期可用性。
