From 74812525a2b9d85a4615e7e9d0fe226fb521a344 Mon Sep 17 00:00:00 2001 From: Wcowin <1135801806@qq.com> Date: Wed, 4 Jun 2025 15:22:07 +0800 Subject: [PATCH] Update ai_summary.py --- .../008bdcfed0b0b9b589c54c03e8783d0d.json | 7 + .../0b6176fc36485a4b7648d96ffd6b7282.json | 7 + .../0d3e95ce9ad53d469c8aaae47719525f.json | 7 + .../0dcbc37ab3e6963f1b3741d81c32b9c9.json | 7 + .../0ec4ff66c09bcbc1f189ff70391a7d5d.json | 7 + .../0eeeda15a44fd8926aaf5ff9812ea5ea.json | 7 + .../11703e885f66213ef55252aa0203d1f8.json | 7 + .../2159251c4cc57ddc1a2e5a4d6ce49b0f.json | 7 + .../220350a8f8e51d3b7455257138a808af.json | 7 + .../2d86ca064a44a260d18cfb9cb515d7a0.json | 7 + .../2f0d26f2d010b74892d9144710852c11.json | 7 + .../30abfae7f16ecb7e41855d7ee59fe151.json | 7 + .../3309c39267871635526f6fed179bdcc7.json | 7 + .../3b92e621cadfddb1f9d06e307c5f7ccf.json | 7 + .../3d3b50606857af8f7e5e972fcf31b31f.json | 7 + .../42b524e7ffe869ec1cdd013899773fe9.json | 7 + .../4d823b90bb4a370baba6d254759e8951.json | 7 + .../5560f97450f87a5fc516715dca59124e.json | 7 + .../59c551361d3a6a9dc416cfcb9a16b6d0.json | 7 + .../9135036bb2cee912073c79448a507199.json | 7 + .../941b898d6a2fb8331109e1dbec8a087c.json | 7 + .../b387ce5ca7493235052b340338689e8a.json | 7 + .../d3b41a11e5859b15b2707e47aae0c888.json | 7 + .../d9cacc5ca0e343bad0c95d22720949e9.json | 7 + .../e7267ce6a4cd1f5054768befa04b1173.json | 7 + .../eb9262abe9f1173610b1de79da25b5dd.json | 7 + .../ee2f15a1a2f326e50b283acbba050ccf.json | 7 + .../ef4140da894c1462ea138ccbb859b9cb.json | 7 + .ai_cache/service_config.json | 10 + .github/workflows/ci.yml | 61 ++- .gitignore | 11 + docs/blog/websitebeauty/MkDocs-AI-Hooks.md | 4 +- .../__pycache__/ai_summary.cpython-311.pyc | Bin 41109 -> 49380 bytes docs/overrides/hooks/ai_summary.py | 490 ++++++++---------- 34 files changed, 474 insertions(+), 298 deletions(-) create mode 100644 .ai_cache/008bdcfed0b0b9b589c54c03e8783d0d.json create mode 100644 .ai_cache/0b6176fc36485a4b7648d96ffd6b7282.json create mode 100644 .ai_cache/0d3e95ce9ad53d469c8aaae47719525f.json create mode 100644 .ai_cache/0dcbc37ab3e6963f1b3741d81c32b9c9.json create mode 100644 .ai_cache/0ec4ff66c09bcbc1f189ff70391a7d5d.json create mode 100644 .ai_cache/0eeeda15a44fd8926aaf5ff9812ea5ea.json create mode 100644 .ai_cache/11703e885f66213ef55252aa0203d1f8.json create mode 100644 .ai_cache/2159251c4cc57ddc1a2e5a4d6ce49b0f.json create mode 100644 .ai_cache/220350a8f8e51d3b7455257138a808af.json create mode 100644 .ai_cache/2d86ca064a44a260d18cfb9cb515d7a0.json create mode 100644 .ai_cache/2f0d26f2d010b74892d9144710852c11.json create mode 100644 .ai_cache/30abfae7f16ecb7e41855d7ee59fe151.json create mode 100644 .ai_cache/3309c39267871635526f6fed179bdcc7.json create mode 100644 .ai_cache/3b92e621cadfddb1f9d06e307c5f7ccf.json create mode 100644 .ai_cache/3d3b50606857af8f7e5e972fcf31b31f.json create mode 100644 .ai_cache/42b524e7ffe869ec1cdd013899773fe9.json create mode 100644 .ai_cache/4d823b90bb4a370baba6d254759e8951.json create mode 100644 .ai_cache/5560f97450f87a5fc516715dca59124e.json create mode 100644 .ai_cache/59c551361d3a6a9dc416cfcb9a16b6d0.json create mode 100644 .ai_cache/9135036bb2cee912073c79448a507199.json create mode 100644 .ai_cache/941b898d6a2fb8331109e1dbec8a087c.json create mode 100644 .ai_cache/b387ce5ca7493235052b340338689e8a.json create mode 100644 .ai_cache/d3b41a11e5859b15b2707e47aae0c888.json create mode 100644 .ai_cache/d9cacc5ca0e343bad0c95d22720949e9.json create mode 100644 .ai_cache/e7267ce6a4cd1f5054768befa04b1173.json create mode 100644 .ai_cache/eb9262abe9f1173610b1de79da25b5dd.json create mode 100644 .ai_cache/ee2f15a1a2f326e50b283acbba050ccf.json create mode 100644 .ai_cache/ef4140da894c1462ea138ccbb859b9cb.json create mode 100644 .ai_cache/service_config.json create mode 100644 .gitignore 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 700047c122a54db50ad1e6583aa88f5af0aba1ec..576fc3cdcc116b914844f7442284e45385c5e4cb 100644 GIT binary patch delta 14758 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]+>') - 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入口点"""