diff --git a/.ai_cache/008bdcfed0b0b9b589c54c03e8783d0d.json b/.ai_cache/008bdcfed0b0b9b589c54c03e8783d0d.json new file mode 100644 index 0000000..31aa189 --- /dev/null +++ b/.ai_cache/008bdcfed0b0b9b589c54c03e8783d0d.json @@ -0,0 +1,7 @@ +{ + "summary": "本文介绍了Git版本控制系统的核心操作与实用技巧，涵盖仓库创建、分支管理、冲突解决等基础功能，重点讲解了stash暂存、rebase/merge策略选择、cherry-pick等高效工作方法。通过具体代码示例和场景说明，帮助开发者掌握提交修改、撤销变更、生成补丁等关键操作，提升团队协作和代码管理效率。", + "service": "deepseek", + "page_title": "Git 实用技巧", + "timestamp": "2025-06-04T15:14:01.936057", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/0b6176fc36485a4b7648d96ffd6b7282.json b/.ai_cache/0b6176fc36485a4b7648d96ffd6b7282.json new file mode 100644 index 0000000..1d99efa --- /dev/null +++ b/.ai_cache/0b6176fc36485a4b7648d96ffd6b7282.json @@ -0,0 +1,7 @@ +{ + "summary": "MkDocs允许通过自定义HTML文件实现页脚个性化配置。用户需在docs/overrides/partials目录下创建或修改footer.html文件，插入特定代码片段即可完成页脚定制。该功能适用于需要品牌展示、版权声明或导航链接等场景，通过覆盖默认模板实现灵活布局。操作仅需基础HTML知识，无需编译过程。", + "service": "deepseek", + "page_title": "页脚设置", + "timestamp": "2025-06-04T15:12:53.237431", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/0d3e95ce9ad53d469c8aaae47719525f.json b/.ai_cache/0d3e95ce9ad53d469c8aaae47719525f.json new file mode 100644 index 0000000..45121b1 --- /dev/null +++ b/.ai_cache/0d3e95ce9ad53d469c8aaae47719525f.json @@ -0,0 +1,7 @@ +{ + "summary": "Tidio提供免费、无需梯子的在线聊天解决方案，适用于网站集成。用户只需注册账号，从设置中获取专属JavaScript代码，将其嵌入网站指定位置即可完成部署。该工具安装简便，仅需单行代码即可实现实时聊天功能，适合快速为网站添加客服系统。", + "service": "deepseek", + "page_title": "添加在线聊天", + "timestamp": "2025-06-04T15:13:43.957414", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/0dcbc37ab3e6963f1b3741d81c32b9c9.json b/.ai_cache/0dcbc37ab3e6963f1b3741d81c32b9c9.json new file mode 100644 index 0000000..e45b512 --- /dev/null +++ b/.ai_cache/0dcbc37ab3e6963f1b3741d81c32b9c9.json @@ -0,0 +1,7 @@ +{ + "summary": "本文介绍了网页圆角化设计的实现方法，重点讲解通过CSS样式文件实现图片和边框的圆角效果。具体包括在mkdocs.yml中引入CSS文件、编写圆角样式代码以及在Markdown文件中应用的方法，同时展示了按钮和卡片组件的圆角化实现示例。该技术可提升网页视觉美感，适用于文档网站和UI组件开发。", + "service": "deepseek", + "page_title": "网页圆角化设计", + "timestamp": "2025-06-04T15:13:52.101323", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/0ec4ff66c09bcbc1f189ff70391a7d5d.json b/.ai_cache/0ec4ff66c09bcbc1f189ff70391a7d5d.json new file mode 100644 index 0000000..a06863a --- /dev/null +++ b/.ai_cache/0ec4ff66c09bcbc1f189ff70391a7d5d.json @@ -0,0 +1,7 @@ +{ + "summary": "该技术方案通过git-revision-date-localized插件为MKdocs文档系统添加文章修订时间戳功能。核心实现包括在CI工作流中配置智能渲染策略，既避免了本地渲染时全量检查git历史导致的性能损耗，又能确保发布时准确显示最后更新时间。该方法显著提升了文档系统的维护性和用户体验，特别适合需要展示内容时效性的技术文档场景。", + "service": "deepseek", + "page_title": "为MKdocs添加文章修订时间戳", + "timestamp": "2025-06-04T15:13:36.305003", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/0eeeda15a44fd8926aaf5ff9812ea5ea.json b/.ai_cache/0eeeda15a44fd8926aaf5ff9812ea5ea.json new file mode 100644 index 0000000..c7a36f0 --- /dev/null +++ b/.ai_cache/0eeeda15a44fd8926aaf5ff9812ea5ea.json @@ -0,0 +1,7 @@ +{ + "summary": "MIT许可证授予用户自由使用、修改、分发软件的广泛权利，仅要求保留版权声明和许可条款。该许可证明确声明软件不提供任何担保，作者不对使用后果承担责任。作为宽松开源协议，MIT许可证允许商业用途和二次开发，适用于希望最大限度开放代码的开发者。", + "service": "deepseek", + "page_title": "许可声明", + "timestamp": "2025-06-04T15:10:35.586724", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/11703e885f66213ef55252aa0203d1f8.json b/.ai_cache/11703e885f66213ef55252aa0203d1f8.json new file mode 100644 index 0000000..fb77cd1 --- /dev/null +++ b/.ai_cache/11703e885f66213ef55252aa0203d1f8.json @@ -0,0 +1,7 @@ +{ + "summary": "在GitHub Pages部署mkdocs时，自定义域名失效的原因是本地缺少CNAME文件导致推送后被清除。解决方法是在/docs目录下创建无后缀的CNAME文件并填入域名，确保每次推送后配置信息得以保留。该方案有效解决了因文件缺失导致的域名绑定失效问题。", + "service": "deepseek", + "page_title": "3.解决Github Pages部署mkdocs自定义域名失效的问题", + "timestamp": "2025-06-04T15:11:04.997045", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/2159251c4cc57ddc1a2e5a4d6ce49b0f.json b/.ai_cache/2159251c4cc57ddc1a2e5a4d6ce49b0f.json new file mode 100644 index 0000000..ae4f40f --- /dev/null +++ b/.ai_cache/2159251c4cc57ddc1a2e5a4d6ce49b0f.json @@ -0,0 +1,7 @@ +{ + "summary": "本文总结了MkDocs文档系统中相对地址引用的常见问题与解决方案，重点阐述了图片、PDF、跨页面及静态资源的正确引用方式。核心要点包括：以docs目录为根路径进行相对定位，保持路径大小写一致，统一资源目录结构。针对本地与线上环境差异，提供了确保资源可访问性的实用技巧，如路径检查、文件压缩等，为MkDocs项目的资源管理提供了系统化指导。", + "service": "deepseek", + "page_title": "相对地址的一些问题", + "timestamp": "2025-06-04T15:12:22.532085", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/220350a8f8e51d3b7455257138a808af.json b/.ai_cache/220350a8f8e51d3b7455257138a808af.json new file mode 100644 index 0000000..6696e5f --- /dev/null +++ b/.ai_cache/220350a8f8e51d3b7455257138a808af.json @@ -0,0 +1,7 @@ +{ + "summary": "唐·诺曼提出的情感设计三层次理论包括本能层、行为层和反思层。本能层关注产品外观引发的即时情感反应；行为层强调使用过程中的功能性和效率体验；反思层涉及用户对产品的理性认知和自我形象关联。这三个层次相互影响，共同塑造用户对产品的整体体验。该理论为设计实践提供了系统框架，解释了为何某些产品即使存在功能缺陷仍能获得市场成功。", + "service": "deepseek", + "page_title": "唐·诺曼—情感设计的三个层次", + "timestamp": "2025-06-04T15:14:41.148887", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/2d86ca064a44a260d18cfb9cb515d7a0.json b/.ai_cache/2d86ca064a44a260d18cfb9cb515d7a0.json new file mode 100644 index 0000000..539b5c5 --- /dev/null +++ b/.ai_cache/2d86ca064a44a260d18cfb9cb515d7a0.json @@ -0,0 +1,7 @@ +{ + "summary": "Mkdocs内置博客插件可快速搭建技术博客，只需在mkdocs.yml中添加简单配置即可启用。支持通过docs/blog/.authors.yml文件管理作者信息，无需额外创建文件。该方案适合文档站点集成博客功能，具有配置简单、维护便捷的特点，适用于技术团队分享文章或项目动态。", + "service": "deepseek", + "page_title": "添加Mkdocs博客", + "timestamp": "2025-06-04T15:11:12.460937", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/2f0d26f2d010b74892d9144710852c11.json b/.ai_cache/2f0d26f2d010b74892d9144710852c11.json new file mode 100644 index 0000000..cb44556 --- /dev/null +++ b/.ai_cache/2f0d26f2d010b74892d9144710852c11.json @@ -0,0 +1,7 @@ +{ + "summary": "本次网站更新主要围绕性能优化和功能完善展开，包括持续优化网站流畅度、修复Markdown解析异常、改进友链统计准确性等核心改进。技术层面涉及代码重构、插件调整（如取消glightbox）及界面交互优化（留言板按钮切换）。同时更新了教程内容以适配官方最新版本，并解决了图片显示、评论区定位等具体问题。更新记录显示开发者兼顾性能提升与用户体验改善的双重目标。", + "service": "deepseek", + "page_title": "2025网站更新记录", + "timestamp": "2025-06-04T15:12:05.048968", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/30abfae7f16ecb7e41855d7ee59fe151.json b/.ai_cache/30abfae7f16ecb7e41855d7ee59fe151.json new file mode 100644 index 0000000..7c7b785 --- /dev/null +++ b/.ai_cache/30abfae7f16ecb7e41855d7ee59fe151.json @@ -0,0 +1,7 @@ +{ + "summary": "本文介绍了开源中文字体\"霞鹜文楷\"的技术特点与应用。该字体基于日本FONTWORKS公司的Klee One衍生开发，包含多个版本（屏幕阅读版、轻便版、GB/TC版等），支持简繁中文及谚文。文章详细说明了字体的开发背景、补字计划、获取方式及使用注意事项，特别强调了其开源特性（SIL授权）和针对不同场景的优化设计，适合网站嵌入和移动设备显示。", + "service": "deepseek", + "page_title": "修改网站字体", + "timestamp": "2025-06-04T15:13:20.429334", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/3309c39267871635526f6fed179bdcc7.json b/.ai_cache/3309c39267871635526f6fed179bdcc7.json new file mode 100644 index 0000000..4db3299 --- /dev/null +++ b/.ai_cache/3309c39267871635526f6fed179bdcc7.json @@ -0,0 +1,7 @@ +{ + "summary": "该技术文档介绍了三种网页背景特效的实现方法：雪花、樱花和粒子效果。核心是通过JavaScript动态加载特效脚本，并利用LocalStorage存储用户偏好设置来控制特效显示。代码示例展示了如何通过DOM操作插入外部脚本，实现可配置的动态背景效果，适用于增强网页视觉体验。", + "service": "deepseek", + "page_title": "背景特效", + "timestamp": "2025-06-04T15:12:42.871226", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/3b92e621cadfddb1f9d06e307c5f7ccf.json b/.ai_cache/3b92e621cadfddb1f9d06e307c5f7ccf.json new file mode 100644 index 0000000..4ed8397 --- /dev/null +++ b/.ai_cache/3b92e621cadfddb1f9d06e307c5f7ccf.json @@ -0,0 +1,7 @@ +{ + "summary": "本文详细介绍了使用MkDocs框架部署静态网页到GitHub Pages的完整流程。重点讲解了从创建GitHub仓库、本地环境配置、MkDocs初始化到最终部署的关键步骤，包括目录结构调整、workflow配置和页面发布设置。教程采用Material for MkDocs主题，提供了基础yml配置示例，并强调通过GitHub Desktop实现代码同步。该方法适合快速搭建技术文档网站或个人博客，具备版本控制优势。", + "service": "deepseek", + "page_title": "1.利用Mkdocs部署静态网页", + "timestamp": "2025-06-04T15:10:46.691272", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/3d3b50606857af8f7e5e972fcf31b31f.json b/.ai_cache/3d3b50606857af8f7e5e972fcf31b31f.json new file mode 100644 index 0000000..2a1ab8a --- /dev/null +++ b/.ai_cache/3d3b50606857af8f7e5e972fcf31b31f.json @@ -0,0 +1,7 @@ +{ + "summary": "MWeb Pro是一款专为macOS设计的专业Markdown写作与笔记应用，支持GFM语法扩展，包括表格、LaTeX、代码块及多种图表库。提供便捷的图片插入、表格编辑和文档导出功能，支持多种格式输出及主流博客平台发布。内置强大的笔记管理系统，支持分类树、标签管理和快速搜索，适合个人知识整理与静态网站生成。原生优化界面简洁高效，兼顾功能全面与易用性。", + "service": "deepseek", + "page_title": "MWeb Pro", + "timestamp": "2025-06-04T15:14:21.266829", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/42b524e7ffe869ec1cdd013899773fe9.json b/.ai_cache/42b524e7ffe869ec1cdd013899773fe9.json new file mode 100644 index 0000000..822708d --- /dev/null +++ b/.ai_cache/42b524e7ffe869ec1cdd013899773fe9.json @@ -0,0 +1,7 @@ +{ + "summary": "本文介绍如何在文档站点中添加顶部公告栏，通过修改`docs/overrides/main.html`文件实现自定义公告内容。操作步骤包括创建该HTML文件并编辑其代码结构，用户可根据需求灵活调整公告栏样式和内容。该方法适用于需要突出显示重要通知的技术文档网站，实现简单且无需改动核心框架。", + "service": "deepseek", + "page_title": "添加顶部公告栏", + "timestamp": "2025-06-04T15:13:00.936276", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/4d823b90bb4a370baba6d254759e8951.json b/.ai_cache/4d823b90bb4a370baba6d254759e8951.json new file mode 100644 index 0000000..a0046ec --- /dev/null +++ b/.ai_cache/4d823b90bb4a370baba6d254759e8951.json @@ -0,0 +1,7 @@ +{ + "summary": "本文介绍了MkDocs文档工具的学习资源和使用指南，包括官方教程、Material主题、插件列表以及作者提供的中文教程（语雀、CSDN、知乎）。内容涵盖快速部署静态网页到GitHub Pages、配置mkdocs.yml文件以及添加博客功能，并附有视频教程。最后请求使用者注明教程来源并支持友链申请。", + "service": "deepseek", + "page_title": "0.Mkdocs教程前言", + "timestamp": "2025-06-04T15:11:20.593701", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/5560f97450f87a5fc516715dca59124e.json b/.ai_cache/5560f97450f87a5fc516715dca59124e.json new file mode 100644 index 0000000..2ae5fb0 --- /dev/null +++ b/.ai_cache/5560f97450f87a5fc516715dca59124e.json @@ -0,0 +1,7 @@ +{ + "summary": "本文介绍了使用MkDocs构建网站时的性能优化方案，包括采用WebP等高效图片格式压缩资源、利用CDN加速静态文件分发，以及通过合理配置git插件提升本地渲染效率。重点阐述了开发环境与生产环境的差异化配置策略，并推荐使用Lighthouse工具进行性能测试验证优化效果。这些措施能有效降低页面加载延迟，提升用户体验。", + "service": "deepseek", + "page_title": "加速网站访问的一些心得", + "timestamp": "2025-06-04T15:12:34.767613", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/59c551361d3a6a9dc416cfcb9a16b6d0.json b/.ai_cache/59c551361d3a6a9dc416cfcb9a16b6d0.json new file mode 100644 index 0000000..d891a29 --- /dev/null +++ b/.ai_cache/59c551361d3a6a9dc416cfcb9a16b6d0.json @@ -0,0 +1,7 @@ +{ + "summary": "Markdown是一种轻量级标记语言，支持纯文本编写并转换为多种格式（如HTML/PDF）。本文介绍了其核心语法：标题分级、文本样式（斜体/粗体）、列表（有序/无序）、表格、链接/图片插入、代码块及特殊字符处理。同时推荐了各平台常用编辑工具（如MacDown、Dillinger），适用于快速创建结构化文档。语法简洁易学，适合技术文档编写与日常笔记整理。", + "service": "deepseek", + "page_title": "Markdown指南", + "timestamp": "2025-06-04T15:14:32.352182", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/9135036bb2cee912073c79448a507199.json b/.ai_cache/9135036bb2cee912073c79448a507199.json new file mode 100644 index 0000000..535b4df --- /dev/null +++ b/.ai_cache/9135036bb2cee912073c79448a507199.json @@ -0,0 +1,7 @@ +{ + "summary": "该文介绍了通过JavaScript和CSS自定义网页鼠标样式的实现方法，重点说明了关键参数配置，包括鼠标尺寸、颜色（支持RGB值和颜色名称）以及圆形跟随效果。提供了具体的代码示例和配置路径，并强调需在mkdocs.yml中引入相关文件。适用于需要个性化鼠标交互效果的网页开发场景。", + "service": "deepseek", + "page_title": "JS实现鼠标样式", + "timestamp": "2025-06-04T15:13:28.158803", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/941b898d6a2fb8331109e1dbec8a087c.json b/.ai_cache/941b898d6a2fb8331109e1dbec8a087c.json new file mode 100644 index 0000000..8a86098 --- /dev/null +++ b/.ai_cache/941b898d6a2fb8331109e1dbec8a087c.json @@ -0,0 +1,7 @@ +{ + "summary": "2024年网站持续优化，重点提升流畅度和访问速度，包括启用CDN加速、删除冗余代码、优化UI显示效果。技术改进涉及JS/CSS代码精简、MKdocs主题更新、图片迁移至SMMS平台，并引入自动新标签页打开功能。网站被百度/谷歌收录，友链扩展至16个，同时完善了文档版本管理插件。", + "service": "deepseek", + "page_title": "2024网站更新记录", + "timestamp": "2025-06-04T15:11:53.050478", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/b387ce5ca7493235052b340338689e8a.json b/.ai_cache/b387ce5ca7493235052b340338689e8a.json new file mode 100644 index 0000000..80efc7a --- /dev/null +++ b/.ai_cache/b387ce5ca7493235052b340338689e8a.json @@ -0,0 +1,7 @@ +{ + "summary": "本文阐述了设计的核心原则与实践要点，强调简洁性、美感和用户体验的重要性。作者提出优秀设计应去除冗余元素，注重视觉平衡与细节把控，同时以用户需求为中心构建直观交互。创新思维和情感共鸣被列为关键要素，通过故事性设计传递品牌价值。全文突出了设计在功能性与艺术性之间的平衡，以及细节处理对产品质感的提升作用。", + "service": "deepseek", + "page_title": "我对设计的一些观点", + "timestamp": "2025-06-04T15:14:49.241260", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/d3b41a11e5859b15b2707e47aae0c888.json b/.ai_cache/d3b41a11e5859b15b2707e47aae0c888.json new file mode 100644 index 0000000..bef8a9b --- /dev/null +++ b/.ai_cache/d3b41a11e5859b15b2707e47aae0c888.json @@ -0,0 +1,7 @@ +{ + "summary": "本文详细介绍了Mkdocs配置文件mkdocs.yml的核心配置项，包括站点基本信息、主题配色方案、导航功能设置和搜索优化等。重点讲解了如何通过palette配置实现明暗模式切换，以及通过features启用目录跟踪、标签页、代码复制等实用功能。此外还涉及多语言支持、图标自定义、标签系统实现方法，并提供了扩展Markdown语法和添加自定义CSS/JS的配置指导。该配置文件可帮助用户快速搭建功能完善、界面美观的文档网站。", + "service": "deepseek", + "page_title": "2.Mkdocs配置说明(mkdocs.yml)", + "timestamp": "2025-06-04T15:10:56.177242", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/d9cacc5ca0e343bad0c95d22720949e9.json b/.ai_cache/d9cacc5ca0e343bad0c95d22720949e9.json new file mode 100644 index 0000000..0997630 --- /dev/null +++ b/.ai_cache/d9cacc5ca0e343bad0c95d22720949e9.json @@ -0,0 +1,7 @@ +{ + "summary": "Lighthouse是谷歌开发的网站性能测试工具，可评估页面加载速度、可访问性等关键指标。通过浏览器开发者工具（F12）即可快速启动测试，适用于各类网站的性能优化。该工具提供直观的评分和详细改进建议，帮助开发者定位性能瓶颈，提升用户体验。测试过程简单，无需额外安装，支持主流Chromium内核浏览器。", + "service": "deepseek", + "page_title": "利用Lighthouse测试网站性能", + "timestamp": "2025-06-04T15:14:10.415296", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/e7267ce6a4cd1f5054768befa04b1173.json b/.ai_cache/e7267ce6a4cd1f5054768befa04b1173.json new file mode 100644 index 0000000..2a667e8 --- /dev/null +++ b/.ai_cache/e7267ce6a4cd1f5054768befa04b1173.json @@ -0,0 +1,7 @@ +{ + "summary": "2022年网站建设过程包括：10月建立Github仓库并正式建站，取消cookie确认简化访问流程，新增首页反馈功能；6月确定采用MKdocs框架搭建，10月完成独立域名wcowin.work的注册。主要优化了用户体验和隐私保护，技术方案选择轻量级文档框架。", + "service": "deepseek", + "page_title": "2022网站更新记录", + "timestamp": "2025-06-04T15:11:29.885224", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/eb9262abe9f1173610b1de79da25b5dd.json b/.ai_cache/eb9262abe9f1173610b1de79da25b5dd.json new file mode 100644 index 0000000..5da4b31 --- /dev/null +++ b/.ai_cache/eb9262abe9f1173610b1de79da25b5dd.json @@ -0,0 +1,7 @@ +{ + "summary": "giscus是一款基于GitHub Discussions的开源评论系统，无需数据库且完全免费。它支持多语言、自定义主题和高可配置性，数据自动同步GitHub Discussions。相比传统方案，giscus无需维护服务器，无跟踪和广告，适合技术博客和文档网站集成。通过简单配置即可实现评论功能，同时保留自建服务的灵活性。", + "service": "deepseek", + "page_title": "添加评论系统(giscus为例)", + "timestamp": "2025-06-04T15:13:09.054845", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/ee2f15a1a2f326e50b283acbba050ccf.json b/.ai_cache/ee2f15a1a2f326e50b283acbba050ccf.json new file mode 100644 index 0000000..74c2d0c --- /dev/null +++ b/.ai_cache/ee2f15a1a2f326e50b283acbba050ccf.json @@ -0,0 +1,7 @@ +{ + "summary": "2023年网站主要更新包括：引入AI问答机器人（25条/月限制）、多语言支持（含台湾地区）、国内镜像站点和Mkdocs-Wcowin主题。技术优化涉及图片懒加载、移动端适配、LaTeX渲染修复及网页流畅度提升。新增功能有留言板（集成giscus）、友链模块和博客板块，同时改进了搜索功能与界面设计。全年持续进行性能优化和用户体验改进。", + "service": "deepseek", + "page_title": "2023网站更新记录", + "timestamp": "2025-06-04T15:11:39.818678", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/ef4140da894c1462ea138ccbb859b9cb.json b/.ai_cache/ef4140da894c1462ea138ccbb859b9cb.json new file mode 100644 index 0000000..49ab71d --- /dev/null +++ b/.ai_cache/ef4140da894c1462ea138ccbb859b9cb.json @@ -0,0 +1,7 @@ +{ + "summary": "该插件为MkDocs文档系统提供AI驱动的智能摘要和阅读统计功能，支持OpenAI、DeepSeek等多API服务。核心特性包括自动生成80-120字多语言摘要、智能内容清理、高效缓存系统，以及精准的中文阅读时间估算。通过灵活的配置选项，用户可实现文件夹或页面级别的精确控制，并自定义API服务和提示词。安装简便，支持直接下载或Git克隆，适合技术文档和博客的自动化摘要需求。", + "service": "deepseek", + "page_title": "MkDocs文档AI摘要", + "timestamp": "2025-06-04T15:12:14.050558", + "language": "zh" +} \ No newline at end of file diff --git a/.ai_cache/service_config.json b/.ai_cache/service_config.json new file mode 100644 index 0000000..da0a85a --- /dev/null +++ b/.ai_cache/service_config.json @@ -0,0 +1,10 @@ +{ + "default_service": "deepseek", + "available_services": [ + "deepseek", + "openai", + "gemini" + ], + "summary_language": "zh", + "check_time": "2025-06-04T15:17:53.928819" +} \ No newline at end of file diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 7796310..66d76fd 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -4,6 +4,10 @@ on: branches: - master - main + # 禁止从 fork 仓库访问 secrets + pull_request: + types: [closed] + branches: [main, master] permissions: contents: write jobs: @@ -13,37 +17,60 @@ jobs: - uses: actions/checkout@v4 with: fetch-depth: 0 + sparse-checkout: | + docs + includes + .ai_cache - uses: actions/setup-python@v4 with: python-version: 3.x - - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV + - name: Set cache ID + run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV - uses: actions/cache@v3 with: - key: mkdocs-material-${ env.cache_id } + key: mkdocs-material-${{ github.run_number }} path: .cache restore-keys: | mkdocs-material- - run: pip install mkdocs-git-revision-date-localized-plugin - run: pip install mkdocs-git-authors-plugin - run: pip install mkdocs-git-committers-plugin-2 + - run: pip install markdown-callouts - run: pip install mkdocs-rss-plugin - # - run: pip install jieba - - run: pip install mkdocs-markdownextradata-plugin - # - run: pip install mkdocs-glightbox - # - run: pip install "mkdocs-material[imaging]" - # - run: pip install mkdocs-statistics-plugin - # - run: pip install mkdocs-rss-plugin + - run: pip install requests>=2.25.0 + - run: pip install python-dateutil>=2.8.0 + - run: pip install cachetools>=4.2.0 + - run: pip install python-dotenv>=0.19.0 + - run: pip install pymdown-extensions - run: pip install mkdocs-material - run: pip install --upgrade --force-reinstall mkdocs-material - - run: pip install requests - - run: mkdocs gh-deploy --force + - name: Deploy with AI Summary env: - # AI摘要配置 - AI_SUMMARY_CI_ENABLED: true # CI环境启用AI摘要 - AI_SUMMARY_LOCAL_ENABLED: false # 本地环境禁用AI摘要 - AI_SUMMARY_CI_ONLY_CACHE: false # CI环境允许生成新摘要 - AI_SUMMARY_CI_FALLBACK: true # CI环境启用备用摘要 - # API密钥（取消注释以启用真实AI服务） + # AI摘要开关控制 + AI_SUMMARY_CI_ENABLED: 'true' # CI部署环境启用AI摘要 (true=在CI中为文章生成AI摘要) + AI_SUMMARY_CI_ONLY_CACHE: 'true' # CI部署允许生成新摘要 (true=使用本地部署过的摘要缓存，不再重复调用API) + AI_SUMMARY_CI_FALLBACK: 'true' # CI部署启用备用摘要 (true=API失败时生成离线基础摘要) + AI_SUMMARY_LOCAL_ENABLED: 'false' # 本地部署环境禁用AI摘要 (true=本地开发时也生成摘要)（不需要管这条） + AI_SUMMARY_CACHE_ENABLED: 'true' # 本地启用缓存功能 (true=缓存摘要避免重复生成)（不需要管这条） + # API密钥配置 DEEPSEEK_API_KEY: ${{ secrets.DEEPSEEK_API_KEY }} OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }} - + run: mkdocs gh-deploy --force + + # 自动提交新生成的AI缓存文件 + - name: Auto-commit AI cache (if any new files) + run: | + if [ -d ".ai_cache" ] && [ "$(ls -A .ai_cache 2>/dev/null)" ]; then + git config --local user.email "action@github.com" + git config --local user.name "GitHub Action" + git add .ai_cache/ + if ! git diff --cached --quiet; then + git commit -m "🤖 Auto-update AI summary cache [skip ci]" + git push + echo "✅ 自动提交了新的 AI 缓存文件" + else + echo "ℹ️ 没有新的缓存文件需要提交" + fi + else + echo "ℹ️ 没有找到缓存目录或缓存为空" + fi diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..688912f --- /dev/null +++ b/.gitignore @@ -0,0 +1,11 @@ +# 环境变量文件（敏感信息） +.env +.env.local +.env.*.local +*.key + +# MkDocs 构建输出目录 +site/ + +# AI 摘要缓存目录（项目根目录）- 需要被提交 +!.ai_cache/ \ No newline at end of file diff --git a/docs/blog/websitebeauty/MkDocs-AI-Hooks.md b/docs/blog/websitebeauty/MkDocs-AI-Hooks.md index ce017c3..0998239 100644 --- a/docs/blog/websitebeauty/MkDocs-AI-Hooks.md +++ b/docs/blog/websitebeauty/MkDocs-AI-Hooks.md @@ -7,7 +7,9 @@ status: new # MkDocs AI Hooks -仓库地址：https://github.com/Wcowin/mkdocs-ai-hooks +仓库地址：https://github.com/Wcowin/mkdocs-ai-hooks +在线预览：https://wcowin.work/mkdocs-ai-hooks/ +

MkDocs Hooks diff --git a/docs/overrides/hooks/__pycache__/ai_summary.cpython-311.pyc b/docs/overrides/hooks/__pycache__/ai_summary.cpython-311.pyc index 700047c..576fc3c 100644 Binary files a/docs/overrides/hooks/__pycache__/ai_summary.cpython-311.pyc and b/docs/overrides/hooks/__pycache__/ai_summary.cpython-311.pyc differ diff --git a/docs/overrides/hooks/ai_summary.py b/docs/overrides/hooks/ai_summary.py index 78ebcf8..add6195 100644 --- a/docs/overrides/hooks/ai_summary.py +++ b/docs/overrides/hooks/ai_summary.py @@ -1,3 +1,6 @@ +from dotenv import load_dotenv +load_dotenv() # 自动加载 .env 文件 + import re import json import hashlib @@ -9,18 +12,33 @@ import shutil class AISummaryGenerator: def __init__(self): - self.cache_dir = Path("site/.ai_cache") + # 🗂️ 统一缓存路径策略 - 本地和CI环境都使用项目根目录 + # 这样避免了CI构建时被清理，也简化了路径管理 + self.cache_dir = Path(".ai_cache") self.cache_dir.mkdir(parents=True, exist_ok=True) # 🚀 CI 环境配置 - 默认只在 CI 环境中启用 + # AI摘要环境配置 self.ci_config = { - 'enabled_in_ci': os.getenv('AI_SUMMARY_CI_ENABLED', 'true').lower() == 'true', # 默认 CI 中启用 - 'enabled_in_local': os.getenv('AI_SUMMARY_LOCAL_ENABLED', 'false').lower() == 'true', # 默认本地禁用 - # 'enabled_in_local': os.getenv('AI_SUMMARY_LOCAL_ENABLED', 'true').lower() == 'true', # 默认本地启用 - 'ci_only_cache': os.getenv('AI_SUMMARY_CI_ONLY_CACHE', 'false').lower() == 'true', # CI 中也允许生成新摘要 - 'ci_fallback_enabled': os.getenv('AI_SUMMARY_CI_FALLBACK', 'true').lower() == 'true' + # CI部署环境开关 (true=CI中启用AI摘要生成) + 'enabled_in_ci': os.getenv('AI_SUMMARY_CI_ENABLED', 'true').lower() == 'true', + + # 本地部署环境开关 (true=本地开发时启用AI摘要) + 'enabled_in_local': os.getenv('AI_SUMMARY_LOCAL_ENABLED', 'false').lower() == 'true', + + # CI部署仅缓存模式 (true=仅使用缓存不调用API, false=允许生成新摘要) + 'ci_only_cache': os.getenv('AI_SUMMARY_CI_ONLY_CACHE', 'false').lower() == 'true', + + # 本地部署缓存功能开关 (true=启用缓存避免重复生成, false=总是生成新摘要) + 'cache_enabled': os.getenv('AI_SUMMARY_CACHE_ENABLED', 'true').lower() == 'true', + + # CI部署备用摘要开关 (true=API失败时生成基础摘要, false=失败时不显示摘要) + 'ci_fallback_enabled': os.getenv('AI_SUMMARY_CI_FALLBACK', 'true').lower() == 'true', } + # 🔄 自动缓存迁移逻辑（一次性迁移旧缓存） - 移到ci_config初始化之后 + self._auto_migrate_cache() + # 添加服务配置文件，用于跟踪当前使用的服务 self.service_config_file = self.cache_dir / "service_config.json" @@ -47,17 +65,17 @@ class AISummaryGenerator: # 'max_tokens': 150, # 'temperature': 0.3 # }, - # 'gemini': { - # 'url': 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent', - # 'model': 'gemini-pro', - # 'api_key': os.getenv('GOOGLE_API_KEY', 'your-claude-api-key'), - # 'max_tokens': 150, - # 'temperature': 0.3 - # } + 'gemini': { + 'url': 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent', + 'model': 'gemini-pro', + 'api_key': os.getenv('GOOGLE_API_KEY', 'AIzaSyDwWgffCCyVFZVsRasX3B3arWFaCT1PzNI'), + 'max_tokens': 150, + 'temperature': 0.3 + } } # 默认使用的AI服务 - self.default_service = 'deepseek' # 默认使用 DeepSeek + self.default_service = 'deepseek' # 服务优先级（按顺序尝试） self.service_fallback_order = ['openai', 'deepseek', 'claude', 'gemini'] @@ -66,44 +84,29 @@ class AISummaryGenerator: self.enabled_folders = [ 'blog/', # blog文件夹 'develop/', # develop文件夹 - # 'about/', # about文件夹 - # 在这里添加您想要启用AI摘要的文件夹 + # 'posts/', # posts文件夹 + # 'trip/', # trip文件夹 + # 'about/', # about文件夹 ] - # 📋 Excluded files and folders + # 📋 排除的文件和文件夹 self.exclude_patterns = [ - '404.md', 'tag.md', 'tags.md', + 'waline.md', 'link.md', '404.md', 'tag.md', 'tags.md', + '/about/', '/search/', '/sitemap', '/admin/', + 'index.md', # 根目录index.md ] - # 📋 Excluded specific files + # 📋 排除的特定文件 self.exclude_files = [ 'blog/index.md', + 'blog/indexblog.md', + 'docs/index.md', + 'develop/index.md', ] # 🌍 语言配置/Language Configuration self.summary_language = 'zh' # 默认中文，可选 'zh'、'en'、'both' - # 初始化阅读统计相关的正则表达式 - self.chinese_chars_pattern = re.compile(r'[\u4e00-\u9fff\u3400-\u4dbf]') - self.code_block_pattern = re.compile(r'```.*?```', re.DOTALL) - self.inline_code_pattern = re.compile(r'`[^`]+`') - self.yaml_front_pattern = re.compile(r'^---.*?---\s*', re.DOTALL) - self.html_tag_pattern = re.compile(r'<[^>]+>') - self.image_pattern = re.compile(r'!\[.*?\]\([^)]+\)') - self.link_pattern = re.compile(r'\[([^\]]+)\]\([^)]+\)') - - # 支持的编程语言 - self.programming_languages = frozenset({ - 'python', 'py', 'javascript', 'js', 'typescript', 'ts', 'java', 'cpp', 'c', - 'go', 'rust', 'php', 'ruby', 'swift', 'kotlin', 'csharp', 'cs', - 'bash', 'sh', 'powershell', 'ps1', 'zsh', 'fish', 'bat', 'cmd', - 'html', 'css', 'scss', 'sass', 'less', 'yaml', 'yml', 'json', 'xml', - 'toml', 'ini', 'conf', 'dockerfile', 'makefile', - 'sql', 'mysql', 'postgresql', 'sqlite', 'mongodb', - 'r', 'matlab', 'scala', 'perl', 'lua', 'dart', 'tex', 'latex', - 'csv', 'properties', '' - }) - # 在初始化时就进行环境检查 self._check_environment() @@ -133,6 +136,10 @@ class AISummaryGenerator: def _check_service_change(self): """检查AI服务是否发生变更，如有变更则自动清理缓存""" + # 如果禁用了缓存功能，跳过服务变更检查 + if not self.ci_config['cache_enabled']: + return + current_config = { 'default_service': self.default_service, 'available_services': list(self.ai_services.keys()), @@ -284,6 +291,10 @@ class AISummaryGenerator: def get_cached_summary(self, content_hash): """获取缓存的摘要""" + # 如果禁用了缓存功能，直接返回None + if not self.ci_config['cache_enabled']: + return None + cache_file = self.cache_dir / f"{content_hash}.json" if cache_file.exists(): try: @@ -299,6 +310,10 @@ class AISummaryGenerator: def save_summary_cache(self, content_hash, summary_data): """保存摘要到缓存""" + # 如果禁用了缓存功能，不保存缓存 + if not self.ci_config['cache_enabled']: + return + cache_file = self.cache_dir / f"{content_hash}.json" try: summary_data['timestamp'] = datetime.now().isoformat() @@ -573,7 +588,7 @@ Please generate bilingual summary:""" # 如果在 CI 环境中且配置为只使用缓存 if is_ci and self.ci_config['ci_only_cache']: - print(f"📦 CI 环境仅使用缓存模式") + print(f"📦 CI 环 environment仅使用缓存模式") return None, 'ci_cache_only' # 按优先级尝试不同服务 @@ -624,18 +639,18 @@ Please generate bilingual summary:""" priority_sentences.append(sentence) else: normal_sentences.append(sentence) - + # 组合摘要 selected_sentences = [] total_length = 0 - + # 优先使用关键句子 for sentence in priority_sentences: if total_length + len(sentence) > 100: break selected_sentences.append(sentence) total_length += len(sentence) - + # 如果还有空间，添加普通句子 if total_length < 80: for sentence in normal_sentences: @@ -643,7 +658,7 @@ Please generate bilingual summary:""" break selected_sentences.append(sentence) total_length += len(sentence) - + if selected_sentences: summary = '.'.join(selected_sentences) + '.' # 简化冗长的摘要 @@ -672,119 +687,34 @@ Please generate bilingual summary:""" def _generate_chinese_fallback(self, page_title=""): """生成中文备用摘要""" - if any(keyword in page_title for keyword in ['教程', '指南', 'Tutorial']): - return '本文提供了详细的教程指南，通过实例演示帮助读者掌握相关技术要点。' - elif any(keyword in page_title for keyword in ['配置', '设置', '安装', 'Config']): - return '本文介绍了系统配置的方法和步骤，提供实用的设置建议和最佳实践。' - elif any(keyword in page_title for keyword in ['开发', '编程', 'Development']): - return '本文分享了开发经验和技术实践，提供了实用的代码示例和解决方案。' + if page_title: + # 根据标题生成通用摘要 + if any(keyword in page_title for keyword in ['教程', '指南', '配置', '安装']): + return f"本文介绍了{page_title}的相关内容，包括具体的操作步骤和注意事项，为读者提供实用的技术指导。" + elif any(keyword in page_title for keyword in ['分析', '研究', '探讨', '原理']): + return f"本文深入分析了{page_title}的核心概念和技术原理，为读者提供详细的理论解析和实践见解。" + elif any(keyword in page_title for keyword in ['开发', '构建', '实现', '设计']): + return f"本文详细讲解了{page_title}的开发过程和实现方法，分享了实际的开发经验和技术方案。" + else: + return f"本文围绕{page_title}展开讨论，介绍了相关的技术概念、应用场景和实践方法。" else: - return '本文深入探讨了相关技术内容，提供了实用的方法和解决方案。' - + return "本文介绍了相关的技术概念和实践方法，为读者提供有价值的参考信息。" + def _generate_english_fallback(self, page_title=""): """生成英文备用摘要""" - if any(keyword in page_title.lower() for keyword in ['tutorial', 'guide', '教程', '指南']): - return 'This article provides a detailed tutorial guide with practical examples to help readers master relevant technical points.' - elif any(keyword in page_title.lower() for keyword in ['config', 'setup', 'install', '配置', '设置', '安装']): - return 'This article introduces system configuration methods and procedures, providing practical setup suggestions and best practices.' - elif any(keyword in page_title.lower() for keyword in ['develop', 'programming', 'code', '开发', '编程']): - return 'This article shares development experience and technical practices, providing practical code examples and solutions.' + if page_title: + # 根据标题生成通用摘要 + if any(keyword in page_title.lower() for keyword in ['tutorial', 'guide', 'setup', 'install', 'config']): + return f"This article provides a comprehensive guide on {page_title}, including step-by-step instructions and important considerations for practical implementation." + elif any(keyword in page_title.lower() for keyword in ['analysis', 'research', 'study', 'principle']): + return f"This article presents an in-depth analysis of {page_title}, exploring core concepts and technical principles with detailed theoretical insights." + elif any(keyword in page_title.lower() for keyword in ['develop', 'build', 'implement', 'design']): + return f"This article explains the development process and implementation methods for {page_title}, sharing practical development experience and technical solutions." + else: + return f"This article discusses {page_title}, covering relevant technical concepts, application scenarios, and practical methods." else: - return 'This article explores relevant technical content in depth, providing practical methods and solutions.' - - def calculate_reading_stats(self, markdown): - """计算中文字符数和代码行数""" - # 清理内容用于中文字符统计 - content = markdown - content = self.yaml_front_pattern.sub('', content) - content = self.html_tag_pattern.sub('', content) - content = self.image_pattern.sub('', content) - content = self.link_pattern.sub(r'\1', content) - content = self.code_block_pattern.sub('', content) - content = self.inline_code_pattern.sub('', content) - - chinese_chars = len(self.chinese_chars_pattern.findall(content)) - - # 统计代码行数 - code_lines = self.count_code_lines(markdown) - - # 计算阅读时间（中文：400字/分钟） - reading_time = max(1, round(chinese_chars / 400)) - - return reading_time, chinese_chars, code_lines - - def count_code_lines(self, markdown): - """统计代码行数""" - code_blocks = self.code_block_pattern.findall(markdown) - total_code_lines = 0 - - for block in code_blocks: - # 提取语言标识 - lang_match = re.match(r'^```(\w*)', block) - language = lang_match.group(1).lower() if lang_match else '' - - # 移除开头的语言标识和结尾的``` - code_content = re.sub(r'^```\w*\n?', '', block) - code_content = re.sub(r'\n?```$', '', code_content) - - # 过滤空代码块 - if not code_content.strip(): - continue - - # 计算有效行数 - lines = [line for line in code_content.split('\n') if line.strip()] - line_count = len(lines) - - # 如果有明确的编程语言标识，直接统计 - if language and language in self.programming_languages: - total_code_lines += line_count - continue - - # 检测是否为代码内容 - if self.is_code_content(code_content): - total_code_lines += line_count - - return total_code_lines - - def is_code_content(self, content): - """判断内容是否为代码""" - # 命令行检测 - command_indicators = [ - 'sudo ', 'npm ', 'pip ', 'git ', 'cd ', 'ls ', 'mkdir ', 'rm ', 'cp ', 'mv ', - 'chmod ', 'chown ', 'grep ', 'find ', 'ps ', 'kill ', 'top ', 'cat ', 'echo ', - 'wget ', 'curl ', 'tar ', 'zip ', 'unzip ', 'ssh ', 'scp ', 'rsync ', - '$ ', '# ', '% ', '> ', 'C:\\>', 'PS>', '#!/', - '/Applications/', '/usr/', '/etc/', '/var/', '/home/', '~/', - ] - - if any(indicator in content for indicator in command_indicators): - return True - - # 编程语法检测 - programming_indicators = [ - 'def ', 'class ', 'import ', 'from ', 'return ', 'function', 'var ', 'let ', 'const ', - 'public ', 'private ', 'protected ', 'static ', 'void ', 'int ', 'string ', - '==', '!=', '<=', '>=', '&&', '||', '++', '--', '+=', '-=', - 'while ', 'for ', 'if ', 'else:', 'switch ', 'case ', - ' 1 and any(line.startswith(' ') or line.startswith('\t') for line in lines): - return True - - if '<' in content and '>' in content: - return True - - if any(char in content for char in ['{', '}', '(', ')', '[', ']']) and ('=' in content or ':' in content): - return True - - return False - + return "This article introduces relevant technical concepts and practical methods, providing valuable reference information for readers." + def is_ci_environment(self): """检测是否在 CI 环境中运行""" # 常见的 CI 环境变量 @@ -839,83 +769,115 @@ Please generate bilingual summary:""" else: return 'Unknown CI' + def _auto_migrate_cache(self): + """自动迁移缓存文件（仅在需要时执行一次）""" + # 如果禁用了缓存功能，跳过缓存迁移 + if not self.ci_config.get('cache_enabled', True): + return + + old_cache_dir = Path("site/.ai_cache") + new_cache_dir = Path(".ai_cache") + + # 检查是否需要迁移 + if old_cache_dir.exists() and not new_cache_dir.exists(): + print("🔄 检测到旧缓存目录，开始自动迁移...") + + try: + # 创建新目录 + new_cache_dir.mkdir(exist_ok=True) + + # 复制文件 + cache_files = list(old_cache_dir.glob("*.json")) + copied_count = 0 + + for cache_file in cache_files: + target_file = new_cache_dir / cache_file.name + try: + shutil.copy2(cache_file, target_file) + copied_count += 1 + except Exception as e: + print(f"⚠️ 复制缓存文件失败 {cache_file.name}: {e}") + + if copied_count > 0: + print(f"✅ 自动迁移完成！共迁移 {copied_count} 个缓存文件") + print("💡 提示：请将 .ai_cache 目录提交到 Git 仓库") + else: + print("ℹ️ 没有缓存文件需要迁移") + + except Exception as e: + print(f"❌ 自动迁移失败: {e}") + + elif new_cache_dir.exists(): + # 新缓存目录已存在，检查是否有文件 + cache_files = list(new_cache_dir.glob("*.json")) + if cache_files: + is_ci = self.is_ci_environment() + env_desc = '(CI)' if is_ci else '(本地)' + print(f"📦 发现根目录缓存 {env_desc}，共 {len(cache_files)} 个缓存文件") + def process_page(self, markdown, page, config): - """处理页面，生成AI摘要和阅读统计（支持CI环境检测）""" + """处理页面，生成AI摘要（支持CI环境检测）""" # 检查是否应该在当前环境运行 if not self.should_run_in_current_environment(): return markdown - # 检查是否需要显示阅读信息 - show_reading_info = self.should_show_reading_info(page, markdown) - - # 检查是否需要生成AI摘要 - should_generate_ai_summary = self.should_generate_summary(page, markdown) - - # 如果两者都不需要，直接返回原内容 - if not show_reading_info and not should_generate_ai_summary: + if not self.should_generate_summary(page, markdown): return markdown - # 计算阅读统计 - reading_time, chinese_chars, code_lines = self.calculate_reading_stats(markdown) + clean_content = self.clean_content_for_ai(markdown) - result_blocks = [] + # 内容长度检查 + if len(clean_content) < 100: + print(f"📄 内容太短，跳过摘要生成: {page.file.src_path}") + return markdown - # 处理AI摘要 - if should_generate_ai_summary: - clean_content = self.clean_content_for_ai(markdown) + content_hash = self.get_content_hash(clean_content) + page_title = getattr(page, 'title', '') + is_ci = self.is_ci_environment() + + # 检查缓存 + cached_summary = self.get_cached_summary(content_hash) + if cached_summary: + summary = cached_summary.get('summary', '') + ai_service = cached_summary.get('service', 'cached') + env_desc = '(CI)' if is_ci else '(本地)' + print(f"✅ 使用缓存摘要 {env_desc}: {page.file.src_path}") + else: + # 如果在 CI 环境中且配置为只使用缓存，直接跳过摘要生成 + if is_ci and self.ci_config['ci_only_cache']: + print(f"📦 CI 环境仅使用缓存模式，无缓存可用，跳过摘要生成: {page.file.src_path}") + return markdown - # 内容长度检查 - if len(clean_content) >= 100: - content_hash = self.get_content_hash(clean_content) - page_title = getattr(page, 'title', '') - is_ci = self.is_ci_environment() - - # 检查缓存 - cached_summary = self.get_cached_summary(content_hash) - if cached_summary: - summary = cached_summary.get('summary', '') - ai_service = cached_summary.get('service', 'cached') - env_desc = '(CI)' if is_ci else '(本地)' - print(f"✅ 使用缓存摘要 {env_desc}: {page.file.src_path}") - else: - # 生成新摘要 - lang_desc = {'zh': '中文', 'en': '英文', 'both': '双语'} - env_desc = '(CI)' if is_ci else '(本地)' - print(f"🤖 正在生成{lang_desc.get(self.summary_language, '中文')}AI摘要 {env_desc}: {page.file.src_path}") - summary, ai_service = self.generate_ai_summary(clean_content, page_title) - - if not summary: - # 尝试生成备用摘要 - summary = self.generate_fallback_summary(clean_content, page_title) - if summary: - ai_service = 'fallback' - print(f"📝 使用备用摘要 {env_desc}: {page.file.src_path}") - else: - print(f"❌ 无法生成摘要 {env_desc}: {page.file.src_path}") - else: - print(f"✅ AI摘要生成成功 ({ai_service}) {env_desc}: {page.file.src_path}") - - # 保存到缓存 - if summary: - self.save_summary_cache(content_hash, { - 'summary': summary, - 'service': ai_service, - 'page_title': page_title - }) - - # 添加AI摘要块 + # 生成新摘要 + lang_desc = {'zh': '中文', 'en': '英文', 'both': '双语'} + env_desc = '(CI)' if is_ci else '(本地)' + print(f"🤖 正在生成{lang_desc.get(self.summary_language, '中文')}AI摘要 {env_desc}: {page.file.src_path}") + summary, ai_service = self.generate_ai_summary(clean_content, page_title) + + if not summary: + # 尝试生成备用摘要 + summary = self.generate_fallback_summary(clean_content, page_title) if summary: - ai_summary_block = self.format_summary(summary, ai_service) - result_blocks.append(ai_summary_block) + ai_service = 'fallback' + print(f"📝 使用备用摘要 {env_desc}: {page.file.src_path}") + else: + print(f"❌ 无法生成摘要 {env_desc}: {page.file.src_path}") + return markdown + else: + print(f"✅ AI摘要生成成功 ({ai_service}) {env_desc}: {page.file.src_path}") + + # 保存到缓存 + if summary: + self.save_summary_cache(content_hash, { + 'summary': summary, + 'service': ai_service, + 'page_title': page_title + }) - # 添加阅读信息块 - if show_reading_info: - reading_info_block = self.format_reading_info(reading_time, chinese_chars, code_lines) - result_blocks.append(reading_info_block) - - # 合并所有块并返回 - if result_blocks: - return '\n'.join(result_blocks) + '\n\n' + markdown + # 添加摘要到页面最上面 + if summary: + summary_html = self.format_summary(summary, ai_service) + return summary_html + '\n\n' + markdown else: return markdown @@ -953,52 +915,6 @@ Please generate bilingual summary:""" # 默认不生成摘要 return False - def should_show_reading_info(self, page, markdown): - """判断是否应该显示阅读信息""" - # 检查页面元数据 - if hasattr(page, 'meta') and page.meta.get('hide_reading_time', False): - return False - - # 获取文件路径 - src_path = page.file.src_path.replace('\\', '/') - - # 使用现有的排除模式检查 - exclude_patterns = [ - r'^index\.md$', r'^about/', r'^trip/index\.md$', r'^relax/index\.md$', - r'^blog/indexblog\.md$', r'^blog/posts\.md$', r'^develop/index\.md$', - r'waline\.md$', r'link\.md$', r'404\.md$' - ] - - for pattern in exclude_patterns: - if re.match(pattern, src_path): - return False - - # 检查页面类型 - if hasattr(page, 'meta'): - page_type = page.meta.get('type', '') - if page_type in {'landing', 'special', 'widget'}: - return False - - # 内容长度检查 - if len(markdown) < 300: - return False - - # 计算中文字符数 - _, chinese_chars, _ = self.calculate_reading_stats(markdown) - if chinese_chars < 50: - return False - - return True - - def format_reading_info(self, reading_time, chinese_chars, code_lines): - """格式化阅读信息显示""" - if code_lines > 0: - return f'''!!! info "📖 阅读信息" - 阅读时间：**{reading_time}** 分钟 | 中文字符：**{chinese_chars}** | 有效代码行数：**{code_lines}**''' - else: - return f'''!!! info "📖 阅读信息" - 阅读时间：**{reading_time}** 分钟 | 中文字符：**{chinese_chars}**''' - def format_summary(self, summary, ai_service): """格式化摘要显示（包含CI环境标识）""" # 根据语言设置显示不同的标题 @@ -1053,7 +969,7 @@ ai_summary_generator = AISummaryGenerator() # 🔧 配置函数 def configure_ai_summary(enabled_folders=None, exclude_patterns=None, exclude_files=None, ai_service=None, service_config=None, language='zh', - ci_enabled=None, local_enabled=None, ci_only_cache=None, ci_fallback=None): + ci_enabled=None, local_enabled=None, ci_only_cache=None, ci_fallback=None, cache_enabled=None): """ 配置AI摘要功能（支持CI和本地环境分别配置） @@ -1068,24 +984,33 @@ def configure_ai_summary(enabled_folders=None, exclude_patterns=None, exclude_fi local_enabled: 是否在本地环境中启用 ci_only_cache: CI 环境是否仅使用缓存 ci_fallback: CI 环境是否启用备用摘要 + cache_enabled: 是否启用缓存功能 Example: - # 推荐配置：只在 CI 中启用，本地禁用 + # 本地开发时禁用缓存，总是生成新摘要 configure_ai_summary( enabled_folders=['blog/', 'docs/'], language='zh', - ci_enabled=True, # CI 中启用 - local_enabled=False, # 本地禁用 - ci_only_cache=False, # CI 中允许生成新摘要 - ci_fallback=True # CI 中启用备用摘要 + local_enabled=True, + cache_enabled=False # 禁用缓存 + ) + + # CI中启用缓存，本地禁用缓存 + configure_ai_summary( + enabled_folders=['blog/', 'docs/'], + language='zh', + ci_enabled=True, + local_enabled=True, + ci_only_cache=True, # CI仅使用缓存 + cache_enabled=True # 启用缓存功能 ) """ ai_summary_generator.configure_folders(enabled_folders, exclude_patterns, exclude_files) ai_summary_generator.configure_language(language) # 配置环境行为 - if any(x is not None for x in [ci_enabled, local_enabled, ci_only_cache, ci_fallback]): - configure_ci_behavior(ci_enabled, local_enabled, ci_only_cache, ci_fallback) + if any(x is not None for x in [ci_enabled, local_enabled, ci_only_cache, ci_fallback, cache_enabled]): + configure_ci_behavior(ci_enabled, local_enabled, ci_only_cache, ci_fallback, cache_enabled) if ai_service: if service_config: @@ -1097,7 +1022,7 @@ def configure_ai_summary(enabled_folders=None, exclude_patterns=None, exclude_fi ai_summary_generator.configure_ai_service(ai_service) # 🔧 新增 CI 配置函数 -def configure_ci_behavior(enabled_in_ci=None, enabled_in_local=None, ci_only_cache=None, ci_fallback_enabled=None): +def configure_ci_behavior(enabled_in_ci=None, enabled_in_local=None, ci_only_cache=None, ci_fallback_enabled=None, cache_enabled=None): """ 配置 CI 和本地环境行为 @@ -1106,16 +1031,17 @@ def configure_ci_behavior(enabled_in_ci=None, enabled_in_local=None, ci_only_cac enabled_in_local: 是否在本地环境中启用 AI 摘要 ci_only_cache: CI 环境是否仅使用缓存 ci_fallback_enabled: CI 环境是否启用备用摘要 + cache_enabled: 是否启用缓存功能（默认True） Example: - # 只在 CI 中启用，本地禁用（推荐配置） - configure_ci_behavior(enabled_in_ci=True, enabled_in_local=False) + # 完全禁用缓存 + configure_ci_behavior(cache_enabled=False) - # 本地和 CI 都启用 - configure_ci_behavior(enabled_in_ci=True, enabled_in_local=True) + # 本地开发时禁用缓存，总是生成新摘要 + configure_ci_behavior(enabled_in_local=True, cache_enabled=False) - # 只在本地启用，CI 中禁用 - configure_ci_behavior(enabled_in_ci=False, enabled_in_local=True) + # CI中使用缓存，本地禁用缓存 + configure_ci_behavior(enabled_in_ci=True, enabled_in_local=True, ci_only_cache=True, cache_enabled=True) """ if enabled_in_ci is not None: ai_summary_generator.ci_config['enabled_in_ci'] = enabled_in_ci @@ -1132,6 +1058,10 @@ def configure_ci_behavior(enabled_in_ci=None, enabled_in_local=None, ci_only_cac if ci_fallback_enabled is not None: ai_summary_generator.ci_config['ci_fallback_enabled'] = ci_fallback_enabled print(f"✅ CI 环境备用摘要: {'启用' if ci_fallback_enabled else '禁用'}") + + if cache_enabled is not None: + ai_summary_generator.ci_config['cache_enabled'] = cache_enabled + print(f"✅ 缓存功能: {'启用' if cache_enabled else '禁用'}") def on_page_markdown(markdown, page, config, files): """MkDocs hook入口点"""