halo-theme-cosolar v1.1.11

更新速览

类型	内容
✨ 新功能	知识库阅读页适配目录模式（docMode=catalog）：目录仅展开 / 折叠，首次进入自动打开第一个文档
✨ 新功能	知识库列表页加载方式可配置（分页 / 滚动加载），每页条数可配置；分页组件改胶囊样式
🎨 样式	知识库列表页统计卡按色系着色（浅色渐变底 + 同色描边 + 角落装饰圆）
🎨 样式	阅读页顶栏重排：知识库标识居左，点赞 / 访问量 / 返回 / 书签 / 分享居右；分享可直跳分享页
🎨 样式	阅读页底栏新增「共 N 篇」统计与「创建 / 更新」时间标签
🔧 调整	知识库页设置重排：开关在前、加载方式与条数在后；页脚开关拆分为「列表页 / 阅读页」独立控制
✨ 新功能	移动端（≤768px）自动隐藏 Live2D 看板娘，避免遮挡内容
🐛 修复	修复源模板文件 UTF-8 BOM 导致页面进入怪异模式（首页顶部出现空隙）

1、知识库阅读页目录模式（src/doc.html · src/js/doc.ts · src/css/doc.css）

适配 MiniDocs 1.0.8 新增的知识库属性 docMode（catalog 目录模式 / hierarchy 父子文档模式，默认 hierarchy）：

• 目录模式约定：凡有子文档的父文档都视为「目录」而非文档——树中目录节点带主题色文件夹图标、文字灰化；点击目录仅展开 / 折叠当前目录（不影响其他目录）；点击子文档（带文档图标）才打开阅读；右侧正文永不显示目录内容（服务端不渲染父文档内容，等待 JS 打开其下第一个文档时显示加载态）。
• 首次打开知识库：自动展开第一个目录并打开其下第一个可阅读文档（URL 无 docSlug 时生效）；直链访问目录父文档时自动改打开其下第一个文档。
• 父子文档模式行为完全不变（维持圆点标识、父文档可阅读）。

2、知识库列表页加载方式与分页胶囊（src/docs.html · src/js/docs.ts · src/css/docs.css）

• 「知识库页设置」新增列表加载方式（分页模式 / 滚动加载模式）与每页条数（3–50，默认 9）。
• 分页模式：底部改为胶囊式分页（‹ 当前页/总页数 › + N 条/页 徽标），箭头用 SVG 不受手写字体影响，组件锁定中性系统字体。
• 滚动加载模式：释放固定高度视窗，列表随页面自然增长；底部显示「已加载 x / y」与「加载更多」胶囊按钮，点击追加下一页，加载完自动隐藏；卡片网格列宽改 minmax(286px, 1fr) 均摊，两侧对齐。

3、列表页统计卡与阅读页布局美化（src/css/docs.css · src/doc.html · src/css/doc.css）

• 列表页五张统计卡按各自图标色系整体着色（浅色渐变底 + 同色描边 + 右上角装饰圆），明暗双模自适应；排序下拉去掉含混的小图标，改胶囊样式。
• 阅读页顶栏重排：左侧为知识库图标 + 名称（原「返回」位置），右侧依次点赞 / 访问量 / 返回 / 书签 / 分享；知识库开启外链分享时点击分享按钮直接跳转分享页（未开启则复制链接）。
• 阅读页底栏左侧新增「共 N 篇」统计；创建 / 更新时间增加中文标签；左侧文档树移除原知识库信息块，搜索框上移。

4、知识库页设置重排与页脚开关拆分（settings.yaml · src/doc.html · src/docs.html）

• 「知识库页设置」开关排到前部（显示统计栏 / 页脚 / 侧边栏），加载方式与条数随后。
• 「显示页脚」拆分为显示列表页页脚（show_footer_list，控制 /docs）与显示阅读页页脚（show_footer，控制 /docs/view/{kbSlug}），各自独立。
• 文档树默认仅展开第一个父目录，其余折叠；点击折叠态父目录同时展开（父子文档模式）。

5、移动端隐藏看板娘（src/css/main.css）

• 小屏（≤768px）自动隐藏 Live2D 看板娘（live2d-context { display:none }），避免遮挡内容；桌面端不受影响；文章页悬浮工具条不再与模型重叠。

6、修复：模板 BOM 导致的怪异模式（src/index.html）

• 编辑器为 src/index.html 写入 UTF-8 BOM，Vite <include> 拼接时带入产物，<!doctype html> 前出现 BOM 使浏览器进入怪异模式（head 内容被丢进 body、sticky header 被顶下），表现为首页顶部出现约 26px 空隙。已清除 BOM，产物恢复以 <!doctype html> 开头。