编程技巧项目实战 - 自游人 - 专注AI旅行与赚钱技术的自由行社区 17you.com

Google 登录全流程实战：前端 GIS SDK 与后端 Node/Python 验证

Mon, 20 Jul 2026 00:00:00 +0000

在为网站集成 Google 登录时，常常会因为 OAuth 配置、Token 验证或跨域问题卡住。下面的完整指南帮你一步到位，从前端按钮到后端安全校验，全程示例代码直接可用，省去摸索时间，让用户登录体验顺畅、系统安全可靠。

$0.01/天搭建独立网站：你的数字主权，从 Hugo + Cloudflare 开始

Sun, 19 Jul 2026 00:00:00 +0000

📌 你的博客、作品集、产品页、知识库——这些数字资产，是放在别人平台上随时可能消失，还是放在你自己的域名下谁也拿不走？这篇文章用 4 步带你从零搭建一个纯静态的独立网站，每年最少花 $1（对，一美元），加载速度秒杀一切 CMS，而且没有服务器就没有安全漏洞。

流量统计UTM参数全场景应用指南

Fri, 19 Jun 2026 00:00:00 +0000

在数字营销和网站数据分析中，Direct（直接流量）常常让人头疼。当用户从微信、钉钉、PDF 或线下扫码等渠道访问网站时，由于缺少来源信息，Google Analytics 4（GA4）会把这些流量统一归类为 Direct，导致我们无法准确判断真正的流量来源。本篇文章将为你提供一套完整的 UTM 参数配置方案，覆盖多种应用场景，帮助你把“黑盒子”般的 Direct 流量变得清晰可追踪，实现精准营销分析。

Hacker News 全面解析：技术与创业者的高质量信息源

Mon, 08 Jun 2026 00:00:00 +0000

Hacker News（简称 HN）是由知名创业孵化器 Y Combinator 所维护的一个社交新闻平台，专注分享和讨论科技、编程、创业、产品以及科学研究相关的内容。这里聚集了大量程序员、创业者、投资人和技术爱好者，形成了一个以深度讨论和高质量内容为核心的独特社区。如果你希望了解前沿技术动向、获取一手创业经验，或者想让你的产品被更多技术人看到，HN 是一个不容忽视的重要渠道。

node-ipc供应链投毒事件深度解析

Thu, 28 May 2026 00:00:00 +0000

node-ipc 供应链投毒事件深度解析：一个过期域名如何劫持千万级 npm 包

2026年5月14日，npm 生态遭遇年度最严重供应链攻击。攻击者仅凭一个过期邮箱域名，就将拥有千万级下载量的 node-ipc 库变成了窃取全球开发者凭证的武器。69 万次下载、90+ 类凭证目标、DNS 隧道外传——这起事件重新定义了供应链安全的底线。这次事件让我们不得不思考：一个看似微不足道的域名过期，竟能引发如此巨大的安全灾难，我们的开源生态到底还有多少这样的"定时炸弹"？

Caddy Web 服务器：自动 HTTPS 入门指南

Fri, 08 May 2026 00:00:00 +0000

Caddy 是一款由 Go 语言编写的现代化 Web 服务器与反向代理，以“默认自动 HTTPS”而闻名。它旨在让开发者与运维人员以最少的配置成本获得安全、可靠、高性能的 Web 服务体验。Caddy 的设计理念是“开箱即用”，尤其适合云原生、容器化与微服务架构场景。

Wrangler 完整指南：Cloudflare Workers 开发部署实战

Wed, 06 May 2026 00:00:00 +0000

本指南针对希望在 Cloudflare 边缘构建「数字后花园」或自动化工具的前端、后端开发者，系统阐述从本地快速迭代、资源绑定、调试定位，到通过 GitHub Actions 实现推送即部署的完整流程。掌握文中命令与配置，即可在本地放心开发、在云端安全发布，并实现 CI/CD 自动化。

OpenClaw Browser Relay：AI 直接控制浏览器指南

Sun, 19 Apr 2026 00:00:00 +0000

OpenClaw 控制的是一个专用 Chrome 配置文件（名为 openclaw，UI 带橙色色调）。
它与你日常使用的浏览器配置文件是分开的。
对于智能体浏览器工具调用：

AI编程的8个级别：你现在处于哪一级？

Fri, 17 Apr 2026 00:00:00 +0000

AI 编程的能力正随着大模型和智能工具的演进而快速提升。为帮助开发者了解自己与 AI 协作的成熟度，Bassim Eledath（2026）提出了 AI 编程的 8 个级别——从最基础的代码补全到由多个自主智能体组成的团队协作，清晰划分了不同阶段的特征与要求。阅读下面的层级描述，看看你目前处于哪个水平，并思考如何进一步提升 AI 辅助开发的效率与质量。

让AI输出有价值的内容我的项目开发笔记

Sun, 12 Apr 2026 00:00:00 +0000

为什么大多数 AI 速递没用？

因为它们回答的是“发生了什么”，而你需要的是“那又怎样”。
信息过载的本质不是信息太多，而是 缺乏判断。

Open-Higgsfield-AI：免费开源的多模型AI创作平台

Fri, 10 Apr 2026 00:00:00 +0000

Open-Higgsfield-AI 是「带界面的创作平台」，通过集成 Muapi.ai 统一 API 网关，实现 200 + 模型的 “一键调用”，其核心逻辑是「请求封装 - 异步提交 - 结果轮询」的三段式流程。免费开源是商业平台 Higgsfield AI 的开源替代品。

Gemma-4-31B开源大模型权重级攻击Abliteration越狱技术

Tue, 07 Apr 2026 00:00:00 +0000

开源大模型“越狱”真相：从 Gemma-4-31B 破解看权重对齐抹除

本文基于 2026 年 4 月最新安全研究整理，深度解析开源模型“越狱”的技术本质。
近期，Google 的开源大模型 Gemma-4-31B 在发布后极短时间内被社区彻底“破解”，其花费数百万美元构建的安全对齐机制被完全移除。
这一事件并非通过传统的提示词技巧，而是通过一种被称为 **Abliteration（消融法）** 的权重级攻击技术实现的。
这标志着大模型安全攻防进入了“外科手术”时代：
攻击者不再满足于绕过外部过滤器，而是直接修改模型的“大脑电路”。

Valkey安装使用教程：Redis完美替代方案

Sat, 28 Mar 2026 00:00:00 +0000

Valkey 完全兼容 Redis 协议，所以所有 Redis 客户端、用法、配置都能直接用，几乎不用改代码！
Valkey 主打低延迟、高并发、实时性，适配 Redis 的核心使用场景，尤其适合对响应速度要求高的业务：

Heretic：全自动移除LLM审查机制的开源工具，无需训练低成本对齐

Mon, 16 Mar 2026 00:00:00 +0000

Heretic 全自动移除 transformer 架构语言模型审查机制（即“安全对齐”/censorship） 的工具，无需昂贵的模型后训练流程

OpenClaw对接本地Llama模型完整配置指南：Ubuntu与Win11详细教程

Mon, 16 Mar 2026 00:00:00 +0000

OpenClaw 配置使用 llama.cpp 部署的本地模型
OpenClaw 可无缝对接 llama.cpp 部署的本地模型（HTTP 服务）
以下是针对 Ubuntu/Win11 系统的精准配置步骤，适配 llama.cpp b8370 版本。

Supabase免费快速构建开源后端数据库

Fri, 13 Mar 2026 00:00:00 +0000

Supabase 是一个开源的 Firebase 替代品，基于 PostgreSQL 数据库构建，提供了数据库、认证、存储、实时订阅等一站式后端服务，无需编写复杂的后端代码即可快速构建应用。

OpenClaw TTS 让你的大龙虾开口说话

Thu, 12 Mar 2026 00:00:00 +0000

好消息

升级到最新的20260312版本后，openclaw大龙虾已经原生支持语音功能，不用麻烦再进行配置了。

一步搞定 OpenClaw QQBot 插件安装与配置

Tue, 10 Mar 2026 00:00:00 +0000

本文详细演示申请腾讯 QQ 机器人 API、使用 OpenClaw 插件管理器一键安装 @tencent-connect/openclaw-qqbot 插件、通过 openclaw channels add 绑定 appid:AppSecret 令牌、以及执行 openclaw gateway restart 重启本地网关的完整流程，帮助开发者快速搭建功能完整的 QQ Bot 环境。该方案适用于 OpenClaw 本地部署和云端运行，省去手动配置繁琐步骤。

Docker 多项目启动脚本

Mon, 23 Feb 2026 00:00:00 +0000

docker多项目管理脚本

vi ./start-all.sh

#!/bin/bash
# 启动所有项目
cd /opt/searxng && docker compose up -d
cd /opt/other-proj && docker compose up -d

# 停止所有项目可写：
# cd /opt/searxng && docker compose down
# cd /opt/other-proj && docker compose down

赋予执行权限并运行：

chmod +x start-all.sh
./start-all.sh

git stash暂存本地修改安全拉取技巧

Mon, 23 Feb 2026 00:00:00 +0000

当你为了本地部署而修改了项目中的配置文件时，如何既保留自己的修改，又能顺利地从远程仓库拉取（git pull）未来的更新，而不会每次都遇到冲突。

自动同步github仓库 Fork 工作流

Mon, 23 Feb 2026 00:00:00 +0000

自动同步远程fork仓库的工作流

完整可直接使用的 sync-fork.yml 模板

# 工作流名称，可自定义
name: Auto Sync Fork with Upstream

# 触发条件：定时执行 + 手动触发
on:
 # 定时执行：每天 UTC 0 点（北京时间 8 点）执行一次
 # 如需调整频率，可改 cron 表达式（比如 0 */12 * * * 是每12小时）
 schedule:
 - cron: '0 0 * * *'
 # 手动触发：在仓库 Actions 页面可手动点击运行
 workflow_dispatch:

# 执行的任务
jobs:
 sync:
 # 运行环境：使用最新的 Ubuntu
 runs-on: ubuntu-latest
 steps:
 # 第一步：检出当前 Fork 仓库的代码
 - name: Checkout Fork Repository
 uses: actions/checkout@v4
 with:
 fetch-depth: 0 # 拉取所有历史，避免合并冲突
 persist-credentials: false

 # 第二步：配置 Git 用户名和邮箱（Actions 提交代码用）
 - name: Configure Git User
 run: |
 git config --global user.name "GitHub Actions"
 git config --global user.email "actions@github.com"

 # 第三步：添加上游仓库（原仓库）地址
 - name: Add Upstream Remote
 run: |
 # 👇 【必改】替换成你 Fork 的原仓库地址（格式：https://github.com/原作者/原仓库名.git）
 git remote add upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git
 # 验证远程仓库是否添加成功
 git remote -v

 # 第四步：拉取上游仓库的最新代码
 - name: Fetch Upstream Code
 run: git fetch upstream

 # 第五步：合并上游代码到当前分支
 - name: Merge Upstream to Fork
 run: |
 # 👇 【必改】替换成你要同步的分支名（通常是 main 或 master）
 git checkout main
 # 快进合并，避免不必要的提交记录；如果无更新则提示，不中断流程
 git merge --ff-only upstream/main || echo "No new changes to sync from upstream"

 # 第六步：推送合并后的代码到你的 Fork 仓库
 - name: Push to Fork Repository
 run: |
 git push https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git main

如何使用这个文件？

打开你的 Fork 仓库 → 点击顶部的 Add file → Create new file；
文件名填写 .github/workflows/sync-fork.yml（注意路径和后缀不能错）；文件路径必须是 .github/workflows/sync-fork.yml，否则 GitHub Actions 无法识别；
把上面修改好的模板内容粘贴进去；
拉到页面底部，填写提交信息（比如 Add auto sync fork workflow），点击 Commit new file。
提交后，你可以在仓库的 Actions 页面看到这个工作流，点击 Run workflow 可手动测试一次同步是否成功；
如果同步时遇到冲突（比如你修改了 Fork 仓库的默认分支），工作流会失败，此时需要你本地手动解决冲突后再同步；
cron 表达式可自定义频率，比如：

每6小时：0 */6 * * *
每天凌晨2点（北京时间）：0 18 * * *（UTC 时间比北京时间晚8小时，18+8=26→次日2点）
支持定时自动同步 + 手动触发，无需额外配置权限（GITHUB_TOKEN 是内置的）。

Open WebUI自托管AI平台指南

Sun, 15 Feb 2026 00:00:00 +0000

Open WebUI 是一款开源的、用户友好的自托管AI平台，支持全离线运行

核心特性

便捷部署与多环境适配：支持Docker、Kubernetes、Python pip等多种安装方式，提供ollama/cuda专属镜像，适配GPU/CPU环境，支持离线运行模式。
多接口集成：无缝对接Ollama、OpenAI兼容API，可自定义API地址适配LMStudio、GroqCloud等平台，支持多模型同时对话。
权限与安全管理：提供细粒度权限、用户组及基于角色的访问控制（RBAC），支持企业级认证（LDAP/AD、SCIM 2.0、SSO、OAuth）。
丰富的交互能力：支持Markdown/LaTeX、语音/视频通话（多端语音转文字/文字转语音）、PWA移动端适配，内置代码编辑器和Python原生函数调用。
强大的RAG能力：集成本地RAG，支持9种向量数据库、多内容提取引擎，可通过15+服务商实现网页搜索，支持直接导入URL/web内容到对话。
多模态与工具集成：支持DALL-E、ComfyUI等多引擎的图片生成/编辑，提供持久化制品存储、云原生集成（Google Drive/OneDrive）。
可扩展性与监控：拥有Pipelines插件框架，支持自定义逻辑和Python库集成；内置OpenTelemetry监控，支持Redis会话管理和水平扩展。
其他特性：支持多语言国际化、模型可视化构建、灵活的数据库（SQLite/PostgreSQL）和云存储（S3/阿里云等）选项。

安装方式

Python pip安装：要求Python 3.11，通过pip install open-webui安装，open-webui serve启动，默认访问地址http://localhost:8080。
Docker快速部署：提供多种场景命令，适配本地/远程Ollama、仅OpenAI API使用、GPU/CPU、捆绑Ollama等情况，核心需挂载数据卷防止数据丢失，默认访问http://localhost:3000。
其他方式：支持Docker Compose、Kustomize、Helm部署，也可进行非Docker原生安装，提供本地开发指南。
开发版试用：可使用:dev标签体验最新功能，但存在不稳定性风险。

Svelte 5 + FastAPI全栈开发指南

Sun, 15 Feb 2026 00:00:00 +0000

一、核心定位：为什么选 Svelte 5 + FastAPI？

FastAPI：后端 Python 框架，主打高性能（基于 Starlette + Pydantic）、自动生成 API 文档、强类型校验，适合快速构建 RESTful API/异步接口，是后端接口层的最优选择之一。
Svelte 5：前端编译型框架，核心是零运行时开销（将逻辑编译为原生 JS，无虚拟 DOM）、极简语法、响应式系统重构（引入 $state/$props 等新特性），适合构建轻量、高性能的前端界面。

这个组合的核心优势：后端快（开发+运行）+ 前端轻（体积+性能），尤其适合中小型全栈应用、数据可视化、工具类产品。

ZeroClaw龙虾AI助手介绍

Sun, 15 Feb 2026 00:00:00 +0000

ZeroClaw是由theonlyhennygod开发的一款基于Rust语言的全自主AI助手基础设施

核心优势

轻量高效：发布版二进制文件仅3.4MB，启动时间<10ms，冷启动–help命令仅0.38s，内存占用极低，对比Node.js开发的OpenClaw，在体积、启动速度、内存占用上有数量级优势。
安全设计：默认网关仅绑定本地地址，需6位一次性配对码获取令牌；文件系统默认作用于工作区，拦截敏感目录与空字节注入；支持隧道访问，拒绝无隧道的公网绑定；渠道消息需白名单授权，默认拒绝所有入站消息。
高度可插拔：所有子系统基于Rust trait实现，仅需修改配置即可替换实现，无代码侵入，支持OpenAI兼容的自定义端点，避免技术锁定。
功能完善：内置1017项测试，支持22+AI模型提供商、8大核心特质、50+跨9大分类的集成，拥有全栈自研内存系统，无外部依赖。

核心架构与子系统

所有子系统均为可扩展的trait，支持自定义实现，核心包含12大模块，关键模块能力如下：

OpenClaw多Agent路由配置

Sat, 14 Feb 2026 00:00:00 +0000

多 agent + 渠道路由（bindings）示例

{
 "agents": {
 "defaults": {
 "workspace": "~/.openclaw/workspace"
 },
 "list": [
 {
 "id": "personal",
 "default": true,
 "workspace": "~/.openclaw/workspace-personal",
 "model": "zai/glm-5"
 },
 {
 "id": "work",
 "workspace": "~/.openclaw/workspace-work"
 }
 ],
 "bindings": [
 {
 "agentId": "personal",
 "match": { "channel": "whatsapp", "peer": { "kind": "dm", "id": "+15555550123" } }
 },
 {
 "agentId": "work",
 "match": { "channel": "slack", "teamId": "T01234567", "peer": { "kind": "dm", "id": "U12345678" } }
 },
 {
 "agentId": "work",
 "match": { "channel": "discord", "guildId": "123456789012345678" }
 }
 ]
 }
}

说明

Docker部署SearXNG搜索服务

Fri, 13 Feb 2026 00:00:00 +0000

用国内镜像源一键安装 Docker

# 先删除失败的脚本
rm -f get-docker.sh

# 执行阿里云镜像版 Docker 安装脚本
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

# 验证安装
docker --version

设置 Docker 权限

# 1. 将当前用户加入 docker 组（永久解决权限问题）
sudo usermod -aG docker $USER

# 2. 立即生效权限（无需重启系统，重新加载用户组）
newgrp docker

# 验证权限：执行以下命令无报错即成功
docker ps

配置 searxng 支持 valkey

mkdir -p ~/searxng && cd ~/searxng

# 进入 searxng 目录
cd ~/searxng

# 编辑配置文件
nano docker-compose.yml

# 输入如下内容
services:
 searxng:
 # 拉取指定版本镜像 https://github.com/searxng/searxng/pkgs/container/searxng
 image: ghcr.io/searxng/searxng:2026.3.16-4c4ed4b19
 container_name: searxng
 # 开机自启，避免服务器重启后容器停止
 restart: always
 # 强制指定可靠DNS
 dns:
 - 114.114.114.114
 - 223.5.5.5
 - 8.8.8.8
 # 端口映射：宿主机8080 → 容器8080（若8080被占用，改前面的数字，如9090:8080）
 ports:
 - "192.168.1.197:8080:8080"
 depends_on:
 - valkey
 environment:
 - SEARXNG_SECRET=REPLACE_WITH_RANDOM_32_CHARSdsf2464xx
 - SEARXNG_VALKEY_URL=valkey://valkey:6379/0 # 环境变量优先级最高
 - SEARXNG_LIMITER_TOKENS=120
 - SEARXNG_LIMITER_WINDOW=60
 # 数据卷持久化：配置/缓存不会因容器删除丢失
 volumes:
 - searxng-data-2026:/usr/local/searxng/data
 - ./searxng/settings.yml:/etc/searxng/settings.yml:ro

 valkey:
 # 通过镜像拉取valkey最新版本
 image: docker.1ms.run/valkey/valkey:9.0.3
 container_name: searxng-valkey
 command: valkey-server --appendonly yes
 volumes:
 - valkey-data:/data

# 数据卷名称（自动创建，无需手动操作）
volumes:
 searxng-data-2026:
 valkey-data:

`Ctrl + X → 退出 nano 编辑器，选“Y"保存 
运行 `docker compose config`检查语法是否正确

启动 SearXNG并配置 json

# 启动容器
docker compose up -d

# 配置支持 json 
# 官方模板 https://raw.githubusercontent.com/searxng/searxng/master/utils/templates/etc/searxng/settings.yml
# 设置 settings.yml
vi ./searxng/settings.yml

# 将 `json`格式添加到允许的格式列表中。
 # 找到或添加以下部分
 search:
 formats:
 - html # 默认允许的网页格式
 - json # 必须添加此行，以允许通过 ?format=json 访问
 
# 重启 SearXNG 容器
docker compose restart searxng

curl -s "http://localhost:8080/search?q=test&format=json"
# {"query": "test", "number_of_results": 0, "results": [], "answers": [], "corrections": [], "infoboxes": [], "suggestions": [], "unresponsive_engines": [["brave", "timeout"], ["duckduckgo", "timeout"], ["google", "timeout"], ["startpage", "timeout"], ["wikipedia", "timeout"]]}a

# 查看容器状态（显示 Up 则成功）
docker compose ps

searxng docker.io/searxng/searxng:latest "/usr/local/searxng/…" searxng 11 minutes ago Up About a minute 0.0.0.0:8080->8080/tcp, [::]:8080->8080/tcp

#访问，右上角“首选项”配置选择开启搜索引擎
http://ip:8080/

#进入容器终端：
docker exec -it searxng sh
cd searx
ls -l

#进入容器终端：
docker exec searxng grep formats /etc/searxng/settings.yml
# 配置检查
docker inspect searxng | grep -A5 Mounts
 "Mounts": [
 {
 "Type": "bind",
 "Source": "/xxxx/searxng/searxng/settings.yml",
 "Destination": "/etc/searxng/settings.yml",
 "Mode": "ro",


# 想知道当前运行的所有项目和服务，用以下命令：
# 查看所有容器（含所属项目）
docker compose ps -a # 执行在任意目录，会显示所有项目的容器
# 或更直观的：
docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"

# 进入项目目录停止 
cd /opt/searxng 
docker compose down # 停止并删除容器（保留卷和网络） 
# 彻底删除（含卷、网络）： 
docker compose down -v

# 启动容器
docker compose up -d

#查看容器日志
docker logs searxng | grep -i "start"
#查看容器最新50条日志
docker logs searxng --tail 50


#查看进程
ps aux | grep searxng

在 OpenClaw 中使用

部署成功后，你的 SearXNG 实例地址为 http://你的服务器IP:8080。
在 OpenClaw 中，你可以通过 web_fetch工具直接调用：

OpenClaw配置NVIDIA Build指南

Fri, 13 Feb 2026 00:00:00 +0000

核心配置原理

OpenClaw 通过配置 models.providers来接入 NVIDIA Build 平台。由于 NVIDIA Build 提供了 OpenAI 兼容的 API 端点，你可以直接将其配置为一个自定义提供商。

Ubuntu软件卸载清理指南

Fri, 13 Feb 2026 00:00:00 +0000

1. 普通删除（保留配置）

sudo apt remove 软件名

2. 彻底删除（连配置一起删）

sudo apt purge 软件名

3. 删除后清理残留（非常推荐）

sudo apt autoremove

最干净三连（推荐你用这个）

sudo apt purge 软件名
sudo apt autoremove
sudo apt clean

举例（比如删除 openssl）

sudo apt purge openssl
sudo apt autoremove

不知道软件 exact 名字？先搜索

apt list | grep 关键词

OpenClaw访问disconnected1008解决

Thu, 12 Feb 2026 00:00:00 +0000

disconnected (1008): control ui requires HTTPS or localhost (secure context)

使用 HTTPS 访问

这是最可靠、功能最完整的方式。

OpenClaw轻量AI助手部署指南

Wed, 11 Feb 2026 00:00:00 +0000

开源超轻量级个人AI助手项目，基于Go语言开发，核心特点是极致轻量化、低成本、高性能，2026年02月09日正式发布，可部署在低成本硬件上，支持多平台交互与丰富的功能扩展。

Edge TTS文本转语音使用指南

Tue, 10 Feb 2026 00:00:00 +0000

Edge TTS 是微软基于 Azure 语音服务推出的免费、开源、高质量文本转语音工具，支持多语言、多音色，可通过命令行、Python 代码或网页使用，适合视频配音、有声读物、无障碍场景。

FixIt主题Markdown扩展语法

Fri, 06 Feb 2026 00:00:00 +0000

这篇文章展示了 [FixIt 风格的 Markdown]^(FixIt Flavored Markdown) 扩展语法。

Hugo项目启用Emoji指南

Fri, 06 Feb 2026 00:00:00 +0000

Emoji 可以通过多种方式在 Hugo 项目中启用。

巴菲特谈潜力开发与复利

Sat, 31 Jan 2026 00:00:00 +0000

1999年巴菲特演讲的关键内容整理：

大多数人一生赚不到大钱，不是缺少机会，而是忽略了自己拥有的“价值50万美元的东西”——自身潜力。

巴菲特用发动机比喻：如果你有300马力的引擎，却因坏习惯只发挥100马力，那潜力就浪费了。

Waline评论数据库从leancloud迁移到neon

Mon, 19 Jan 2026 00:00:00 +0000

LeanCloud 即将停止对外服务

https://github.com/orgs/walinejs/discussions/3370
我的waline评论系统使用 vercel部署，使用 LeanCloud 的免费数据库，决定提前迁移到 vercel 的 neon 免费数据库。

MusicGen API可视化工具

Thu, 15 Jan 2026 00:00:00 +0000

✅ MusicGen HuggingFace API 完整测试工具（带GUI可视化界面+一键生成播放）

Windows11专属、完整可运行、带图形界面 的Python测试工具，集成了「HuggingFace API调用+音乐生成+本地保存+一键播放」全部功能

Gradio快速上手教程

Wed, 14 Jan 2026 00:00:00 +0000

Gradio 是 HuggingFace 出品的轻量级 Python 可视化库，核心优势是：一行代码就能把 Python 函数/模型，快速封装成带网页交互的可视化应用，无需前端知识、无需部署复杂框架，本地运行即可访问，对机器学习/深度学习模型演示、算法可视化、快速做 DEMO 极其友好。

Python虚拟环境venv与conda对比

Wed, 14 Jan 2026 00:00:00 +0000

Python中conda（Anaconda/Miniconda）和venv（Python内置模块）这两个主流虚拟环境工具

FixIt主题配置中文注释版本

Mon, 12 Jan 2026 00:00:00 +0000

Fixit 主题的完整的 中文注释版本

# =====================================================================================
# 建议使用「备用主题配置」来配置 FixIt 主题
# 修改此文件可能会导致合并冲突（使用 Git 管理时需注意）
# 当前主题组件的可配置项存在一些限制，仅支持配置以下内容：
# 参数（params）、菜单（menu）、输出格式（outputformats）和媒体类型（mediatypes）
# =====================================================================================

# -------------------------------------------------------------------------------------
# Hugo 基础配置
# 参考文档：https://gohugo.io/configuration/all/
# -------------------------------------------------------------------------------------

# 网站标题
title = "自游人"
# 网站根域名（及路径）
baseURL = "http://localhost:1313"
# 启用的主题列表
theme = ["FixIt"] # 请在你的站点配置文件中启用此主题
# 网站默认内容语言 ["en", "zh-cn", "fr", "pl", ...]
defaultContentLanguage = "en"
# 网站语言代码 ["en", "zh-CN", "fr", "pl", ...]
languageCode = "en"
# 网站语言名称 ["English", "简体中文", "Français", "Polski", ...]
languageName = "English"
# 是否包含中日韩文字（用于自动处理字符间距等）
hasCJKLanguage = false
# 仅用于 SEO 结构化数据的版权声明
copyright = ""
# 是否启用 robots.txt（控制搜索引擎抓取规则）
enableRobotsTXT = true
# 是否启用 Git 提交日志（用于显示文章最后修改时间）
enableGitInfo = true
# 是否启用 Emoji 代码支持
enableEmoji = true
# 网站的主要内容分区
# 如果设置，站点对象的 MainSections 方法会返回指定分区；否则返回文章数量最多的分区
# mainSections = ["posts"]

# -------------------------------------------------------------------------------------
# 前置元数据（Front Matter）配置
# 参考文档：https://gohugo.io/configuration/front-matter/
# -------------------------------------------------------------------------------------

[frontmatter]
# 合并策略：浅合并（仅合并顶层字段）
_merge = "shallow"
# 文章最后修改时间的读取优先级（按顺序查找）
lastmod = [
 "lastmod", # 优先读取 frontmatter 中的 lastmod 字段
 ":git", # 其次读取 Git 提交记录中的时间
 ":fileModTime", # 再次读取文件的修改时间
 ":default", # 最后使用默认值
]

# -------------------------------------------------------------------------------------
# 图片处理配置
# 参考文档：https://gohugo.io/configuration/imaging/
# -------------------------------------------------------------------------------------

[imaging]
# 合并策略：浅合并
_merge = "shallow"
# 图片压缩质量（0-100，数值越高质量越好）
quality = 75

# -------------------------------------------------------------------------------------
# 菜单配置
# 参考文档：https://fixit.lruihao.cn/documentation/basics/#menu-configuration
# -------------------------------------------------------------------------------------

[menus]

# 「归档」菜单配置
[[menus.main]]
identifier = "archives" # 菜单唯一标识
parent = "" # 父菜单标识（无父菜单则留空）
# 菜单名称前缀（支持 HTML 格式，可用于添加图标）
pre = ""
# 菜单名称后缀（支持 HTML 格式，可用于添加图标）
post = ""
name = "Archives" # 菜单显示名称
url = "/archives/" # 菜单跳转链接
# 鼠标悬浮时显示的提示文本
title = ""
weight = 1 # 菜单排序权重（数值越小越靠前）

# FixIt 0.2.14 新增 | 支持为菜单项添加自定义配置
[menus.main.params]
# 为当前菜单项添加自定义 CSS 类名
class = ""
# 是否设为草稿菜单项（功能与草稿文章类似，不会在生产环境显示）
draft = false
# FixIt 0.2.16 新增 | 为当前菜单项添加 Font Awesome 图标
icon = "fa-solid fa-archive"
# FixIt 0.2.16 新增 | 设置菜单项显示设备，可选值：["mobile", "desktop"]
type = ""
# FixIt 0.3.9 新增 | 是否显示子菜单项的分隔线
divided = false

# 「分类」菜单配置
[[menus.main]]
identifier = "categories"
parent = ""
pre = ""
post = ""
name = "Categories"
url = "/categories/"
title = ""
weight = 2

[menus.main.params]
icon = "fa-solid fa-folder-tree"

# 「标签」菜单配置
[[menus.main]]
identifier = "tags"
parent = ""
pre = ""
post = ""
name = "Tags"
url = "/tags/"
title = ""
weight = 3

[menus.main.params]
icon = "fa-solid fa-tags"

# -------------------------------------------------------------------------------------
# 相关内容配置
# 参考文档：https://gohugo.io/content-management/related-content/
# -------------------------------------------------------------------------------------

[related]
# 是否包含发布时间晚于当前文章的内容
includeNewer = false
# 匹配阈值（0-100）：仅匹配得分≥此值的文章才会被推荐
threshold = 80
# 匹配时是否将内容转为小写（忽略大小写）
toLower = false

# 自定义匹配索引规则 1：关键词匹配
[[related.indices]]
# 是否启用过滤规则
applyFilter = false
# 基数阈值（控制匹配的精准度）
cardinalityThreshold = 0
# 匹配字段名称（此处留空，默认匹配文章关键词）
name = 'keywords'
# 匹配模式（正则表达式，留空则为精确匹配）
pattern = ''
# 匹配时是否忽略大小写
toLower = false
# 索引类型：基础匹配
type = 'basic'
# 匹配权重（数值越高，优先级越高）
weight = 100

# 自定义匹配索引规则 2：日期匹配
[[related.indices]]
applyFilter = false
cardinalityThreshold = 0
name = 'date'
pattern = ''
toLower = false
type = 'basic'
weight = 10

# 自定义匹配索引规则 3：标签匹配
[[related.indices]]
applyFilter = false
cardinalityThreshold = 0
name = 'tags'
pattern = ''
toLower = false
type = 'basic'
weight = 80

# 自定义匹配索引规则 4：片段引用匹配
[[related.indices]]
applyFilter = false
name = 'fragmentrefs'
# 索引类型：片段引用匹配（适用于文章内互相引用的场景）
type = 'fragments'
weight = 80

# -------------------------------------------------------------------------------------
# 模块配置
# 参考文档：https://gohugo.io/configuration/module/
# -------------------------------------------------------------------------------------

[module]

# Hugo 版本兼容性配置
[module.hugoVersion]
# 是否需要 Hugo 扩展版（支持 SCSS/SASS 等功能）
extended = true
# 最低支持的 Hugo 版本
min = "0.147.7"

# -------------------------------------------------------------------------------------
# 标记语言（Markdown）配置
# 参考文档：https://gohugo.io/configuration/markup/
# -------------------------------------------------------------------------------------

[markup]
# 合并策略：浅合并
_merge = "shallow"

# 语法高亮配置（参考文档：https://gohugo.io/content-management/syntax-highlighting）
[markup.highlight]
# ~~~~~~~~~~ 必须配置的项 ~~~~~~~~~~
# 参考：https://github.com/hugo-fixit/FixIt/issues/43
# 是否启用代码块语法高亮
codeFences = true
# 是否不生成 CSS 类名（false 表示生成类名，便于自定义样式）
noClasses = false
# ~~~~~~~~~~ 必须配置的项 ~~~~~~~~~~
# 是否为行号添加锚点链接
anchorLineNos = false
# 是否自动识别代码语言
guessSyntax = true
# 是否显示代码行号
lineNos = true
# 是否将行号放在表格中（便于样式控制）
lineNumbersInTable = true

# Goldmark 配置：Hugo 0.60 及以上版本默认的 Markdown 渲染引擎
# 参考文档：https://gohugo.io/configuration/markup/#goldmark
[markup.goldmark]
# 是否允许重复的资源文件
duplicateResourceFiles = false

# Goldmark 扩展功能配置
[markup.goldmark.extensions]
# 是否启用定义列表
definitionList = true
# 是否启用脚注
footnote = true
# 是否自动将文本中的链接转为可点击链接
linkify = true
# 自动链接使用的协议
linkifyProtocol = 'https'
# 是否启用删除线（~~文本~~）
strikethrough = false
# 是否启用表格
table = true
# 是否启用任务列表（- [ ] 待办 / - [x] 已完成）
taskList = true
# 是否启用排版优化（如将引号转为弯引号）
typographer = true

# Goldmark 额外扩展配置（参考文档：https://gohugo.io/configuration/markup/#extras）
[markup.goldmark.extensions.extras]

# 启用删除线（<del> 标签）
[markup.goldmark.extensions.extras.delete]
enable = true

# 启用插入线（<ins> 标签）
[markup.goldmark.extensions.extras.insert]
enable = true

# 启用标记高亮（<mark> 标签）
[markup.goldmark.extensions.extras.mark]
enable = true

# 启用下标（<sub> 标签）
[markup.goldmark.extensions.extras.subscript]
enable = true

# 启用上标（<sup> 标签）
[markup.goldmark.extensions.extras.superscript]
enable = true

# 数学公式支持配置（参考文档：https://gohugo.io/content-management/mathematics/）
[markup.goldmark.extensions.passthrough]
# 是否启用公式透传（不转义公式语法）
enable = true

# 公式分隔符配置
[markup.goldmark.extensions.passthrough.delimiters]
# 块级公式分隔符（多行公式）
block = [
 [
 '\[', # 开始标记
 '\]' # 结束标记
 ],
 [
 '$$', # 开始标记
 '$$' # 结束标记
 ]
]
# 行内公式分隔符（单行公式）
inline = [
 [
 '\(', # 开始标记
 '\)' # 结束标记
 ],
 [
 '$', # 开始标记
 '$' # 结束标记
 ]
]

# Goldmark 解析器配置
[markup.goldmark.parser]

# 为 Markdown 元素添加属性的配置
[markup.goldmark.parser.attribute]
# 是否允许为块级元素添加属性（如 {.class #id}）
block = true
# 是否允许为标题添加属性
title = true

# Goldmark 渲染器配置
[markup.goldmark.renderer]
# 是否将换行符转为 <br> 标签
hardWraps = false
# 是否允许在 Markdown 中直接使用 HTML 标签
unsafe = true
# 是否生成 XHTML 格式的输出
xhtml = false

# -------------------------------------------------------------------------------------
# 站点地图配置
# 参考文档：https://gohugo.io/templates/sitemap/#configuration
# -------------------------------------------------------------------------------------

[sitemap]
# 搜索引擎抓取频率（可选值：always, hourly, daily, weekly, monthly, yearly, never）
changefreq = "weekly"
# 是否禁用站点地图生成
disable = false
# 生成的站点地图文件名
filename = "sitemap.xml"
# 页面优先级（0.0-1.0，数值越高优先级越高）
priority = 0.5

# -------------------------------------------------------------------------------------
# 永久链接（Permalinks）配置
# 参考文档：https://gohugo.io/content-management/urls/#permalinks
# -------------------------------------------------------------------------------------

[permalinks]

# 单篇文章的永久链接规则
[permalinks.page]
# posts = "/p/:slugorcontentbasename"

# 分类目录的永久链接规则
[permalinks.section]
# posts = "/posts/:slugorcontentbasename"

# 分类法页面的永久链接规则
[permalinks.taxonomy]

# 分类术语页面的永久链接规则
[permalinks.term]

# -------------------------------------------------------------------------------------
# 隐私政策配置
# 参考文档：https://gohugo.io/configuration/privacy/
# -------------------------------------------------------------------------------------

[privacy]

# X（原 Twitter）隐私配置
[privacy.x]
# 是否启用「禁止跟踪」（Do Not Track）功能
enableDNT = true

# YouTube 隐私配置
[privacy.youtube]
# 是否启用增强隐私模式（不加载额外跟踪脚本）
privacyEnhanced = true

# -------------------------------------------------------------------------------------
# 媒体类型配置
# 参考文档：https://gohugo.io/configuration/media-types/
# -------------------------------------------------------------------------------------

[mediaTypes]
# 示例：配置 JSON 订阅源的媒体类型
# [mediaTypes."application/feed+json"]
# suffixes = ["json"]

# -------------------------------------------------------------------------------------
# 输出格式配置
# 参考文档：https://gohugo.io/configuration/output-formats/
# -------------------------------------------------------------------------------------

[outputFormats]

# FixIt 0.3.0 新增 | 配置生成 /archives/index.html 文件的规则
[outputFormats.archives]
path = "archives" # 输出目录
baseName = "index" # 文件名
mediaType = "text/html" # 媒体类型
isPlainText = false # 是否为纯文本文件
isHTML = true # 是否为 HTML 文件
permalinkable = true # 是否生成永久链接
notAlternative = true # 是否不作为替代格式

# FixIt 0.3.0 新增 | 配置生成 /offline/index.html 文件的规则
[outputFormats.offline]
path = "offline"
baseName = "index"
mediaType = "text/html"
isPlainText = false
isHTML = true
permalinkable = true
notAlternative = true

# FixIt 0.3.0 新增 | 配置生成 readme.md 文件的规则
[outputFormats.readme]
baseName = "readme"
mediaType = "text/markdown"
isPlainText = true
isHTML = false
notAlternative = true

# FixIt 0.3.0 变更 | 配置生成 baidu_urls.txt 文件的规则
[outputFormats.baidu_urls]
baseName = "baidu_urls"
mediaType = "text/plain"
isPlainText = true
isHTML = false
notAlternative = true

# FixIt 0.3.10 新增 | 配置生成 search.json 文件的规则（用于站点搜索）
[outputFormats.search]
baseName = "search"
mediaType = "application/json"
rel = "search" # 关联类型（用于 SEO）
isPlainText = true
isHTML = false
permalinkable = true

# -------------------------------------------------------------------------------------
# 输出内容配置
# 参考文档：https://gohugo.io/configuration/outputs/
# -------------------------------------------------------------------------------------

# 配置 Hugo 生成的文件类型，可选值如下：
# home = ["html", "rss", "archives", "offline", "readme", "baidu_urls", "search"]
# page = ["html", "markdown"]
# section = ["html", "rss"]
# taxonomy = ["html"]
# term = ["html", "rss"]
[outputs]
# 合并策略：浅合并
_merge = "shallow"
# 首页输出格式
home = [
 "html",
 "rss",
 "archives",
 "offline",
 "search"
]
# 单篇文章输出格式
page = [
 "html",
 "markdown"
]
# 分类目录输出格式
section = [
 "html",
 "rss"
]
# 分类法页面输出格式
taxonomy = [ "html" ]
# 分类术语页面输出格式
term = [
 "html",
 "rss"
]

# -------------------------------------------------------------------------------------
# 分类法配置
# 参考文档：https://gohugo.io/configuration/taxonomies/
# -------------------------------------------------------------------------------------

[taxonomies]
# 合并策略：浅合并
_merge = "shallow"
# 分类配置：URL 路径为 /categories/
category = "categories"
# 标签配置：URL 路径为 /tags/
tag = "tags"
# 集合配置：URL 路径为 /collections/
collection = "collections"

# -------------------------------------------------------------------------------------
# 主题核心配置
# 参考文档：https://fixit.lruihao.cn/documentation/basics/#theme-configuration
# -------------------------------------------------------------------------------------

[params]
# FixIt 0.2.15 变更 | FixIt 主题版本号
# 示例："0.2.X", "0.2.15", "v0.2.15" 等
version = "0.4.X"
# 网站描述（用于 SEO）
description = ""
# 网站关键词（用于 SEO，数组格式）
keywords = []
# 网站默认主题模式 ["light" 亮色, "dark" 暗色, "auto" 跟随系统]
defaultTheme = "auto"
# 用于子资源完整性校验（SRI）的哈希算法
# 可选值：["sha256", "sha384", "sha512", "md5"]，留空则不启用 SRI
fingerprint = ""
# 日期显示格式（Go 语言时间格式）
dateFormat = "2006-01-02"
# 用于 Open Graph 和 Twitter 卡片的网站默认图片（数组格式）
images = []
# FixIt 0.2.12 新增 | 是否启用渐进式网页应用（PWA）
enablePWA = false
# FixIt 0.2.14 新增 | 是否自动为外部链接添加外部图标
externalIcon = false
# FixIt 0.3.13 新增 | 是否将页面标题首字母大写
capitalizeTitles = true
# FixIt 0.3.0 新增 | 是否将网站标题添加到每个页面的标题中
# 请确保在 hugo.toml 中设置了网站标题（例如 title = "网站标题"）
withSiteTitle = true
# FixIt 0.3.0 新增 | 网站标题与页面标题的分隔符
titleDelimiter = "-"
# FixIt 0.3.0 新增 | 是否将网站副标题添加到首页标题中
# 需通过 params.header.subtitle.name 配置网站副标题
indexWithSubtitle = false
# FixIt 0.3.13 新增 | 是否以纯文本形式显示文章摘要
summaryPlainify = false
# FixIt 0.4.0 新增 | 是否启用缺失翻译的合并功能
# 设置为 true 时，会合并并显示其他语言中缺失的翻译内容
# 单语言站点建议设为 false 以提升性能
# 多语言站点设为 true 可显示全部内容
enableTranslationMerge = false
# FixIt 0.2.14 新增 | FixIt 默认仅在首页的 HTML 头部注入主题元标签
# 你可以关闭此功能，但我们建议保留——这有助于统计 FixIt 主题的使用热度
disableThemeInject = false

# 作者信息配置
[params.author]
name = "" # 作者姓名
email = "" # 作者邮箱
link = "" # 作者主页链接
avatar = "" # 作者头像图片链接

# FixIt 0.3.0 新增 | 公共 Git 仓库信息（仅在 enableGitInfo 为 true 时生效）
[params.gitInfo]
# 仓库地址，示例："https://github.com/hugo-fixit/docs"
repo = ""
# 仓库分支
branch = "main"
# 内容目录相对于仓库根目录的路径
dir = "content"
# 文章问题反馈的模板链接（支持参数替换）
# 可用参数：{title} 文章标题 {URL} 文章链接 {sourceURL} 源文件链接
issueTpl = "title=[BUG]%20{title}&body=|Field|Value|%0A|-|-|%0A|Title|{title}|%0A|URL|{URL}|%0A|Filename|{sourceURL}|"

# 应用图标配置
[params.app]
# 当网站添加到 iOS 主屏幕或 Android 启动器时，覆盖默认的网站标题
title = "FixIt"
# 是否省略 favicon 图标资源链接
noFavicon = false
# 用于替代传统 png/ico 图标的现代 SVG 图标
svgFavicon = ""
# Safari 浏览器的遮罩图标颜色
iconColor = "#5bbad5"
# Windows 8-10 系统的磁贴颜色
tileColor = "#da532c"

# FixIt 0.2.12 变更 | Android 浏览器的主题颜色配置
[params.app.themeColor]
light = "#f8f8f8" # 亮色模式下的主题颜色
dark = "#252627" # 暗色模式下的主题颜色

# 搜索功能配置
[params.search]
enable = false # 是否启用搜索功能
# 搜索引擎类型 ["algolia" 第三方搜索, "fuse" 本地搜索, "cse" 自定义搜索, "post-chat" AI 搜索]
type = "fuse"
contentLength = 4000 # 搜索索引的最大内容长度
placeholder = "" # 搜索框占位提示文本
maxResultLength = 10 # 最大搜索结果数量
snippetLength = 30 # 搜索结果摘要长度
highlightTag = "em" # 搜索结果中高亮文本的 HTML 标签
absoluteURL = false # 搜索索引中是否使用基于 baseURL 的绝对链接
# FixIt 0.4.0 新增 | 是否为搜索结果中的标题添加锚点链接
anchorify = true

# Algolia 搜索配置
[params.search.algolia]
index = "" # Algolia 索引名称
appID = "" # Algolia 应用 ID
searchKey = "" # Algolia 搜索密钥

# FixIt 0.2.17 新增 | Fuse.js 本地搜索配置（参考文档：https://fusejs.io/api/options.html）
[params.search.fuse]
isCaseSensitive = false # 是否区分大小写
minMatchCharLength = 2 # 最小匹配字符长度
findAllMatches = false # 是否查找所有匹配项
location = 0 # 匹配位置的权重
threshold = 0.3 # 匹配阈值（0-1，数值越小越精准）
distance = 100 # 匹配距离
ignoreLocation = false # 是否忽略匹配位置
useExtendedSearch = false # 是否启用扩展搜索
ignoreFieldNorm = false # 是否忽略字段标准化

# FixIt 0.3.16 新增 | 自定义搜索引擎（CSE）配置
[params.cse]
# 搜索引擎类型 ["google" 谷歌, "bing" 必应]
engine = ""
# 搜索结果页面的 URL（对应 layout: search 模板）
resultsPage = "/search/"

# Google 自定义搜索引擎配置（参考文档：https://programmablesearchengine.google.com/）
[params.cse.google]
cx = "" # Google CSE 的上下文 ID

# 必应自定义搜索引擎配置（暂不支持）
[params.cse.bing]

# 头部导航栏配置
[params.header]
# FixIt 0.2.13 变更 | 桌面端头部导航栏模式 ["sticky" 粘性, "normal" 普通, "auto" 自动]
desktopMode = "sticky"
# FixIt 0.2.13 变更 | 移动端头部导航栏模式 ["sticky" 粘性, "normal" 普通, "auto" 自动]
mobileMode = "auto"

# 头部标题配置
[params.header.title]
# Logo 图片的 URL
logo = ""
# 标题名称
name = ""
# 标题前缀（支持 HTML 格式，可用于添加图标）
pre = ""
# 标题后缀（支持 HTML 格式，可用于添加图标）
post = ""
# 是否为标题名称启用打字机动画效果
typeit = false

# FixIt 0.2.12 新增 | 头部副标题配置
[params.header.subtitle]
# 副标题名称
name = ""
# 是否为副标题启用打字机动画效果
typeit = false

# FixIt 0.2.18 新增 | 面包屑导航配置
[params.breadcrumb]
enable = false # 是否启用面包屑导航
sticky = false # 是否粘性固定面包屑导航
showHome = false # 是否显示首页链接
# FixIt 0.3.13 新增 | 面包屑导航的分隔符
separator = "/"
# FixIt 0.3.13 新增 | 是否将面包屑导航的文本首字母大写
capitalize = true

# FixIt 0.3.10 新增 | 文章导航配置（上一篇/下一篇）
[params.navigation]
# 是否在分类目录页面显示文章导航
inSection = false
# 是否反转上一篇/下一篇的顺序
reverse = false

# 底部页脚配置
[params.footer]
enable = true # 是否启用页脚
copyright = true # 是否显示版权信息
author = true # 是否显示作者信息
since = "" # 网站创立年份
# FixIt 0.2.12 新增 | 备案信息（仅中国站点需要，支持 HTML 格式）
icp = ""
# 许可证信息（支持 HTML 格式）
license = ""

# FixIt 0.3.0 新增 | 是否显示 Hugo 和主题信息
[params.footer.powered]
enable = true # 是否启用
hugoLogo = true # 是否显示 Hugo 图标
themeLogo = true # 是否显示 FixIt 主题图标

# FixIt 0.2.17 变更 | 网站运行时间配置
[params.footer.siteTime]
enable = false # 是否启用
animate = true # 是否启用动画效果
icon = "fa-solid fa-heartbeat" # 图标
pre = "" # 前缀文本
value = "" # 初始时间，示例："2021-12-18T16:15:22+08:00"

# FixIt 0.2.17 新增 | 页脚各模块的显示顺序，可选值：["first", 0, 1, 2, 3, 4, 5, "last"]
[params.footer.order]
powered = 0 # 技术支持模块顺序
copyright = 0 # 版权信息模块顺序
statistics = 0 # 统计信息模块顺序
visitor = 0 # 访客数量模块顺序
beian = 0 # 备案信息模块顺序

# FixIt 0.3.0 新增 | 归档页面配置（所有 posts 类型的文章）
[params.archives]
paginate = 20 # 归档页面每页显示的文章数量
dateFormat = "01-02" # 日期显示格式（月-日）

# 分类目录页面配置（分类下的所有文章）
[params.section]
paginate = 20 # 分类页面每页显示的文章数量
dateFormat = "01-02" # 日期显示格式（月-日）

# FixIt 0.3.10 新增 | 分类目录的订阅源配置（支持 RSS、Atom、JSON 格式）
[params.section.feed]
limit = -1 # 订阅源包含的文章数量（-1 表示全部）
fullText = false # 是否在订阅源中显示文章全文

# 分类术语列表页面配置（分类/标签下的文章列表）
[params.list]
paginate = 20 # 列表页面每页显示的文章数量
dateFormat = "01-02" # 日期显示格式（月-日）

# FixIt 0.3.10 新增 | 分类术语列表的订阅源配置
[params.list.feed]
limit = -1 # 订阅源包含的文章数量（-1 表示全部）
fullText = false # 是否在订阅源中显示文章全文

# FixIt 0.3.13 新增 | 最近更新文章的显示配置（适用于归档、分类、术语列表页面）
[params.recentlyUpdated]
archives = true # 归档页面是否显示
section = true # 分类页面是否显示
list = true # 术语列表页面是否显示
days = 30 # 最近更新的时间范围（天）
maxCount = 10 # 最多显示的文章数量

# FixIt 0.2.17 新增 | 标签云配置（标签页面专用）
[params.tagcloud]
enable = false # 是否启用标签云
min = 14 # 标签的最小字体大小（px）
max = 32 # 标签的最大字体大小（px）
peakCount = 10 # 单个标签对应的最大文章数量
orderby = "name" # 标签排序方式，可选值：["name" 按名称, "count" 按数量]

# 首页配置
[params.home]

# 首页个人资料卡片配置
[params.home.profile]
enable = false # 是否启用个人资料卡片
# FixIt 0.4.0 新增 | 是否仅在首页的第一页显示个人资料和内容
onlyFirstPage = false
# Gravatar 邮箱（用于自动获取头像，优先级高于 avatarURL）
gravatarEmail = ""
# 首页头像的 URL（默认使用作者头像 params.author.avatar）
avatarURL = ""
# FixIt 0.2.17 新增 | 头像链接对应的菜单标识
avatarMenu = ""
# 首页显示的标题（支持 HTML 格式）
title = ""
# 首页显示的副标题（支持 HTML 格式）
subtitle = ""
# 是否为副标题启用打字机动画效果
typeit = true
# 是否显示社交链接
social = true
# 免责声明文本（支持 HTML 格式）
disclaimer = ""

# 首页文章列表配置
[params.home.posts]
enable = true # 是否启用首页文章列表
paginate = 6 # 首页每页显示的文章数量

# FixIt 0.2.16 变更 | 作者社交链接配置
[params.social]
GitHub = ""
Linkedin = ""
Twitter = ""
Instagram = ""
Facebook = ""
Telegram = ""
Medium = ""
Gitlab = ""
Youtubelegacy = ""
Youtubecustom = ""
Youtubechannel = ""
Tumblr = ""
Quora = ""
Keybase = ""
Pinterest = ""
Reddit = ""
Codepen = ""
FreeCodeCamp = ""
Bitbucket = ""
Stackoverflow = ""
Weibo = ""
Odnoklassniki = ""
VK = ""
Flickr = ""
Xing = ""
Snapchat = ""
Mix = ""
Goodreads = ""
Lastfm = ""
Foursquare = ""
Hackernews = ""
Kickstarter = ""
Patreon = ""
Steam = ""
Twitch = ""
Strava = ""
Skype = ""
Whatsapp = ""
Zhihu = ""
Douban = ""
Angellist = ""
Slidershare = ""
Jsfiddle = ""
Deviantart = ""
Behance = ""
Dribbble = ""
Wordpress = ""
Vine = ""
Googlescholar = ""
Researchgate = ""
Mastodon = ""
Thingiverse = ""
Devto = ""
Gitea = ""
XMPP = ""
Matrix = ""
Bilibili = ""
ORCID = ""
Liberapay = ""
Ko-Fi = ""
BuyMeaCoffee = ""
Linktree = ""
QQ = ""
QQGroup = "" # QQ 群链接，参考：https://qun.qq.com/join.html
Diaspora = ""
CSDN = ""
Discord = ""
DiscordInvite = ""
Lichess = ""
Pleroma = ""
Kaggle = ""
MediaWiki = ""
Plume = ""
HackTheBox = ""
RootMe = ""
Feishu = ""
TryHackMe = ""
Douyin = ""
TikTok = ""
Credly = ""
Bluesky = ""
Phone = ""
Email = ""
RSS = true

# 自定义社交链接的示例（可按需添加）
# [params.social.twitter]
# id = "lruihao" # 社交账号 ID
# weight = 3 # 排序权重
# prefix = "https://twitter.com/" # 链接前缀
# Title = "Twitter" # 链接标题

# [params.social.twitter.icon]
# class = "fa-brands fa-x-twitter fa-fw" # 图标 CSS 类名

# 打字机动画配置
[params.typeit]
speed = 100 # 字符输入速度（毫秒/字符）
cursorSpeed = 1000 # 光标闪烁速度（毫秒）
cursorChar = "|" # 光标字符（支持 HTML 格式）
duration = -1 # 动画持续时间（毫秒，-1 表示无限循环）
# FixIt 0.2.18 新增 | 动画完成后是否持续循环
loop = false

# FixIt 0.2.15 新增 | Mermaid 流程图配置
# 参考文档：http://fixit.lruihao.cn/documentation/content-management/diagrams-support/mermaid/
[params.mermaid]
# FixIt 0.4.0 新增 | Mermaid ESM 模块的 CDN 地址
# 默认值：https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.esm.min.mjs
cdn = ""
# FixIt 0.4.0 新增 | ZenUML ESM 模块的 CDN 地址
# 默认留空，设置后可启用 ZenUML 支持
# 示例：https://cdn.jsdelivr.net/npm/@mermaid-js/mermaid-zenuml/dist/mermaid-zenuml.esm.min.mjs
zenuml = ""
# 主题列表（参考文档：https://mermaid.js.org/config/theming.html#available-themes）
themes = [
 "default",
 "dark"
]
# FixIt 0.4.0 新增 | Mermaid 流程图的安全级别
# 可选值：["strict" 严格, "loose" 宽松, "antiscript" 防脚本, "sandbox" 沙箱]
securityLevel = "loose"
# FixIt 0.4.0 新增 | Mermaid 流程图的外观风格
# 可选值：["classic" 经典, "handDrawn" 手绘]
look = "handDrawn"
# FixIt 0.4.0 新增 | 流程图使用的字体
fontFamily = ""
# FixIt 0.4.0 新增 | 从 ESM 模块 CDN 加载的布局引擎（例如 ELK 布局）
# 示例：["https://cdn.jsdelivr.net/npm/@mermaid-js/layout-elk/dist/mermaid-layout-elk.esm.min.mjs"]
# 加载后支持的布局选项：["elk", "elk.layered", "elk.stress", "elk.force", "elk.mrtree"]
layoutLoaders = []
# 流程图的默认布局算法
# 可选值："dagre"（默认）, "elk", "elk.layered", "elk.stress", "elk.force", "elk.mrtree"
# 注意：ELK 布局需要先配置 layoutLoaders
layout = "dagre"

# FixIt 0.3.13 新增 | 提示框（Admonition）自定义配置
# 参考文档：https://fixit.lruihao.cn/documentation/content-management/shortcodes/extended/admonition/#custom-admonitions
# 配置语法：<提示框类型> = <图标类名>
[params.admonition]
# 示例：ban = "fa-solid fa-ban"

# FixIt 0.3.14 新增 | 任务列表自定义配置
# 参考文档：https://fixit.lruihao.cn/documentation/content-management/advanced/#custom-task-lists
# 配置语法：<任务状态> = <图标类名>
[params.taskList]
# 示例：tip = "fa-regular fa-lightbulb"

# FixIt 0.3.15 新增 | 版本短代码配置
[params.repoVersion]
# 版本标签的 URL 前缀
url = "https://github.com/hugo-fixit/FixIt/releases/tag/v"
# 项目名称
name = "FixIt"

# FixIt 0.2.12 新增 | Pangu.js 配置（用于自动添加中日韩文字与英文/数字的间距）
[params.pangu]
enable = false # 是否启用 Pangu.js
selector = "article" # FixIt 0.2.17 新增 | 生效的 CSS 选择器

# FixIt 0.2.12 新增 | 水印功能配置
# 详细配置参考：https://github.com/Lruihao/watermark#readme
[params.watermark]
enable = false # 是否启用水印
content = "" # 水印文本（支持 HTML 格式）
opacity = 0.1 # 水印透明度（0-1）
width = 150 # 水印宽度（px）
height = 20 # 水印高度（px）
rowSpacing = 60 # 水印行间距（px）
colSpacing = 30 # 水印列间距（px）
rotate = 15 # 水印旋转角度（度）
fontSize = 0.85 # 水印字体大小（rem）
# FixIt 0.2.13 新增 | 水印字体
fontFamily = "inherit"

# FixIt 0.3.10 新增 | 不蒜子统计配置
[params.busuanzi]
enable = false # 是否启用不蒜子统计
# 统计脚本的 CDN 地址，默认值：https://vercount.one/js
source = "https://vercount.one/js"
siteViews = true # 是否显示站点总访问量
pageViews = true # 是否显示单页访问量

# 搜索引擎验证配置（支持 Google/Bing/Yandex/Pinterest/Baidu/360/Sogou）
[params.verification]
google = "" # Google 验证代码
bing = "" # Bing 验证代码
yandex = "" # Yandex 验证代码
pinterest = "" # Pinterest 验证代码
baidu = "" # 百度验证代码
so = "" # 360 搜索验证代码
sogou = "" # 搜狗搜索验证代码

# 站点 SEO 配置
[params.seo]
image = "" # SEO 专用图片 URL
thumbnailUrl = "" # 缩略图 URL

# 网站分析配置
[params.analytics]
enable = false # 是否启用网站分析

# Google Analytics 配置
[params.analytics.google]
id = "" # Google Analytics 跟踪 ID
anonymizeIP = true # 是否匿名化用户 IP 地址

# Fathom Analytics 配置
[params.analytics.fathom]
id = "" # Fathom 站点 ID
# 自托管 Fathom 时的服务器地址
server = ""

# FixIt 0.3.16 新增 | 百度统计配置
[params.analytics.baidu]
id = "" # 百度统计跟踪 ID

# FixIt 0.3.16 新增 | Umami Analytics 配置
[params.analytics.umami]
data_website_id = "" # Umami 网站 ID
src = "" # Umami 脚本地址
data_host_url = "" # Umami 服务器地址
data_domains = "" # 统计的域名

# FixIt 0.3.16 新增 | Plausible Analytics 配置
[params.analytics.plausible]
data_domain = "" # 统计的域名
src = "" # Plausible 脚本地址

# FixIt 0.3.16 新增 | Cloudflare Analytics 配置
[params.analytics.cloudflare]
token = "" # Cloudflare 令牌

# FixIt 0.3.16 新增 | Splitbee Analytics 配置
[params.analytics.splitbee]
enable = false # 是否启用
no_cookie = true # 是否启用无 Cookie 模式
do_not_track = true # 是否尊重浏览器的「禁止跟踪」设置
# 可选的 Splitbee 令牌，参考文档：https://splitbee.io/docs/embed-the-script
data_token = ""

# Cookie 同意提示配置
[params.cookieconsent]
enable = true # 是否启用 Cookie 同意提示

# Cookie 同意提示的文本配置
[params.cookieconsent.content]
message = "" # 提示消息文本
dismiss = "" # 关闭按钮文本
link = "" # 隐私政策链接文本

# 第三方库的 CDN 配置
[params.cdn]
# CDN 数据文件名，默认禁用（可选值：["jsdelivr.yml", "unpkg.yml", ...]）
# 文件位置："themes/FixIt/assets/data/cdn/"
# 也可将自定义数据文件放在项目目录："assets/data/cdn/"
data = ""

# 兼容性配置
[params.compatibility]
# 是否使用 Polyfill.io 兼容旧版浏览器（CDN 地址：https://cdnjs.cloudflare.com/polyfill）
polyfill = false
# 是否使用 object-fit-images 兼容不支持 object-fit 属性的浏览器
objectFit = false

# FixIt 0.2.14 新增 | 页面右上角/左上角的 GitHub 角标配置
[params.githubCorner]
enable = false # 是否启用角标
# 角标跳转链接，示例："https://github.com/hugo-fixit/FixIt"
permalink = "https://github.com/hugo-fixit/FixIt"
# 鼠标悬浮时的提示文本
title = "View source on GitHub"
# 角标位置，可选值：["left" 左侧, "right" 右侧]
position = "right"

# FixIt 0.2.14 新增 | Gravatar 头像配置
[params.gravatar]
# FixIt 0.2.18 新增 | 基于作者邮箱获取头像，若未设置邮箱则使用本地头像
enable = false
# Gravatar 服务器地址，默认："www.gravatar.com"
# 可选值：["cravatar.cn", "gravatar.loli.net", ...]
host = "www.gravatar.com"
# 头像风格，可选值：["", "mp", "identicon", "monsterid", "wavatar", "retro", "blank", "robohash"]
style = ""

# FixIt 0.2.16 新增 | 返回顶部按钮配置
[params.backToTop]
enable = true # 是否启用返回顶部按钮
# FixIt 0.4.0 变更 | 是否在返回顶部按钮周围显示滚动进度百分比
scrollpercent = false

# FixIt 0.2.16 新增 | 阅读进度条配置
[params.readingProgress]
enable = false # 是否启用阅读进度条
# 进度条起始位置，可选值：["left" 左侧, "right" 右侧]
start = "left"
# 进度条位置，可选值：["top" 顶部, "bottom" 底部]
position = "top"
reversed = false # 是否反转进度条方向
light = "" # 亮色模式下的进度条颜色
dark = "" # 暗色模式下的进度条颜色
height = "2px" # 进度条高度

# FixIt 0.2.17 新增 | 页面加载时的顶部进度条配置（基于 Pace.js）
# 参考文档：https://github.com/CodeByZach/pace
[params.pace]
enable = false # 是否启用进度条
# 进度条颜色，可选值：
# ["black", "blue", "green", "orange", "pink", "purple", "red", "silver", "white", "yellow"]
color = "blue"
# 进度条主题，可选值：
# ["barber-shop", "big-counter", "bounce", "center-atom", "center-circle", "center-radar", "center-simple",
# "corner-indicator", "fill-left", "flash", "flat-top", "loading-bar", "mac-osx", "material", "minimal"]
theme = "minimal"

# FixIt 0.3.17 新增 | PostChat AI 配置
# 基于文章内容构建知识库，支持 AI 摘要、AI 搜索、AI 聊天机器人
# 从以下邀请链接获取 PostChat Key，感谢支持！
# https://ai.zhheo.com/console/login?InviteID=85041330
[params.postChat]
enable = false # 是否启用 PostChat AI
key = "" # PostChat 密钥
# 用户触发聊天的方式，可选值：["iframe" 嵌入窗口, "magic" 悬浮按钮]
userMode = "iframe"
addButton = true # 是否添加触发按钮
defaultInput = false # 是否显示默认输入提示
left = "" # 组件左侧偏移量
bottom = "" # 组件底部偏移量
width = "" # 组件宽度
height = "" # 组件高度
fill = "" # 组件填充颜色
backgroundColor = "" # 组件背景颜色
upLoadWeb = true # 是否上传网站内容
showInviteLink = true # 是否显示邀请链接
userTitle = "" # 用户端标题
userDesc = "" # 用户端描述
# 需要屏蔽的 DOM 元素选择器，示例：[".aplayer"]
blackDom = []
# 仅 iframe 模式生效 | 嵌入窗口宽度，示例："375px"
frameWidth = ""
# 仅 iframe 模式生效 | 嵌入窗口高度，示例："600px"
frameHeight = ""
# 仅 magic 模式生效 | 用户头像 URL
userIcon = ""
# 仅 magic 模式生效 | 默认聊天问题列表
defaultChatQuestions = []
# 仅 magic 模式生效 | 默认搜索问题列表
defaultSearchQuestions = []
# FixIt 0.4.0 新增 | 是否显示热门关键词
hotWords = true

# FixIt 0.3.17 新增 | 摘要 AI 配置
# 参考文档：https://ai.zhheo.com/docs/summary.html
[params.postSummary]
enable = false # 是否启用摘要 AI
# 若已配置 params.postChat.key，则无需重复配置此密钥
key = ""
title = "" # 摘要标题
# 主题风格，可选值：["", "simple" 简约, "yanzhi" 雅致, "menghuan" 梦幻]
theme = ""
postURL = "" # 文章链接
blacklist = "" # 黑名单关键词
wordLimit = 1000 # 摘要字数限制
typingAnimate = true # 是否启用打字机动画
beginningText = "" # 开头文本
loadingText = true # 是否显示加载文本

# FixIt 0.4.0 新增 | 播客 AI 配置
# 参考文档：https://ai.zhheo.com/docs/podcast.html
[params.podcast]
enable = false # 是否启用播客 AI

# FixIt 0.3.10 新增 | 全局订阅源配置（支持 RSS、Atom、JSON 格式）
[params.feed]
limit = 10 # 订阅源包含的文章数量（-1 表示全部）
fullText = true # 是否在订阅源中显示文章全文

# Follow 站点验证配置（参考：https://follow.is/）
[params.feed.follow]
feedId = "" # Follow 订阅源 ID
userId = "" # Follow 用户 ID

# FixIt 0.3.17 新增 | 图片处理配置
# 结合 Hugo 的 image 配置实现图片优化
[params.image]
cacheRemote = false # 是否缓存远程图片（提升优化效果）
optimise = false # 是否启用图片缩放和优化（可能会增加构建时间）
# FixIt 0.4.0 新增 | 排除优化的图片文件名或匹配模式
# 示例：["no-optimize.jpg", "*.tiff", "images/exclude-*.webp"]
blackList = []

# FixIt 0.4.0 新增 | 代码块容器配置
# 可通过 Markdown 属性覆盖全局配置，示例：
# ```lang {mode="mac", max_shown_lines=5}
# code here
# ```
[params.codeblock]
wrapper = true # 是否启用代码块容器
# 代码块风格模式
# 可选值：["classic" 经典, "mac" Mac 风格, "simple" 简约, ...]
# 若设置为自定义值，需为 data-mode 属性编写对应的 CSS 样式
mode = "classic"
# 代码块容器的额外 CSS 类名
# 示例："is-collapsed is-expanded line-nos-hidden line-wrapping"
wrapperClass = ""
# 代码块预览区域显示的最大行数
max_shown_lines = 10
copyable = true # 是否启用代码复制按钮
# [classic 模式生效] 是否启用代码行号的切换按钮
lineNosToggler = true
# [classic 模式生效] 是否启用代码换行的切换按钮
lineWrapToggler = true
# [classic 模式生效][实验性功能] 是否启用代码编辑按钮
editable = false

# FixIt 0.4.0 新增 | JSON 查看器配置
# 参考文档：https://github.com/Lruihao/json-viewer-element
[params.jsonViewer]
enable = true # 是否启用 JSON 查看器
expandDepth = 1 # 默认展开的层级
copyable = true # 是否启用复制功能
sort = false # 是否对 JSON 键进行排序
boxed = true # 是否启用边框样式

# FixIt 0.3.12 新增 | 自定义局部模板配置
# 自定义局部模板必须放在 /layouts/_partials/ 目录下
# 依赖于开放的自定义区块，参考：https://fixit.lruihao.cn/references/blocks/
[params.customPartials]
head = [] # 注入到 <head> 标签的模板
menuDesktop = [] # 注入到桌面端菜单的模板
menuMobile = [] # 注入到移动端菜单的模板
profile = [] # 注入到个人资料卡片的模板
aside = [] # 注入到侧边栏的模板
comment = [] # 注入到评论区的模板
footer = [] # 注入到页脚的模板
widgets = [] # 注入到小工具区域的模板
assets = [] # 注入到资源加载区域的模板
postTocBefore = [] # 注入到文章大纲之前的模板
postTocAfter = [] # 注入到文章大纲之后的模板
postContentBefore = [] # 注入到文章内容之前的模板
postContentAfter = [] # 注入到文章内容之后的模板
postFooterBefore = [] # 注入到文章页脚之前的模板
postFooterAfter = [] # 注入到文章页脚之后的模板

# FixIt 0.2.15 新增 | 开发者选项
# 生成个人访问令牌时，请选择 `public_repo` 权限范围
# 可通过环境变量配置：HUGO_PARAMS_GHTOKEN=xxx，参考：https://gohugo.io/functions/os/getenv/#examples
[params.dev]
enable = false # 是否启用开发者模式
c4u = false # 是否检查主题更新

# 页面级配置
# 待办：未来将这些配置迁移到 `params` 根层级
[params.page]
# FixIt 0.2.18 新增 | 是否显示文章作者的头像
authorAvatar = true
# 是否将页面从首页隐藏
hiddenFromHomePage = false
# 是否将页面从搜索结果中隐藏
hiddenFromSearch = false
# FixIt 0.3.0 新增 | 是否将页面从相关文章推荐中隐藏
hiddenFromRelated = false
# FixIt 0.3.10 新增 | 是否将页面从 RSS/Atom/JSON 订阅源中隐藏
hiddenFromFeed = false
# 是否启用 Twemoji 表情
twemoji = false

Hugo缓存清理全面指南

Mon, 12 Jan 2026 00:00:00 +0000

一、第一步：停止所有 Hugo 进程（关键前置）

先关闭正在运行的 hugo server（终端按 Ctrl + C），并结束任务管理器中的 hugo.exe 进程，避免缓存文件被占用无法删除。

大模型文本生成参数详解

Mon, 12 Jan 2026 00:00:00 +0000

大型语言模型生成文本行为的关键参数

Model Capabilities

模型能力：它定义了模型能做什么、不能做什么，以及做得有多好。了解一个模型的能力，可以帮助你更好地利用它，并对其产出有合理的预期