# 阿尔的代码屋 | 全栈技术笔记

> 探索技术边界，记录从大模型(LLM)微调、RAG系统搭建，到 C++ 高性能编程与 Godot 游戏开发的实战经验。分享编程路上的踩坑与成长。

本文档遵循 [llms.txt 规范](https://llmstxt.org/)，专为 Perplexity、ChatGPT Search、Claude、DeepSeek、Cursor、NotebookLM 等生成式 AI 与大模型 RAG 引擎提供全站结构化语义索引。

- **站点主页**: https://blog.algieba12.cn/
- **博客作者**: Algieba (阿尔)
- **技术领域**: 大模型微调 (LLM/SFT/LoRA)、知识库与检索增强 (RAG/VectorDB)、跨平台开发 (Flutter/iOS/Android)、系统工程 (Linux/WSL2/Docker/SSL)
- **主权实体与开源**: [GitHub](https://github.com/Algieba-dean) | [掘金社区](https://juejin.cn/user/2637068702854868) | [CSDN博客](https://blog.csdn.net/m0_46629751)

## 大模型、RAG 与 AI 前沿实战 (LLM, RAG & Agents)

- [个人独立技术博客的 SEO 与 GEO 实战进阶：从被动等待爬虫到 IndexNow 毫秒级主动推送与全站语义拓扑网格 - 架构优化](https://blog.algieba12.cn/geo02-blog-indexnow-and-semantic-topology/): 深度实战篇：告别传统 Sitemap 的漫长等待，通过 IndexNow 协议实现新博文发布到 Bing/Yandex 的毫秒级主动推送；结合 Cloudflare Pages CI/CD 实现 100% 自动化闭环；构建期全自动生成 /llms.txt 专属说明书与全站语义内链拓扑网格，彻底消灭爬虫孤岛。
- [个人独立技术博客的 SEO 与 GEO 实战指南：从拦截 AI 爬虫到成为大模型答案源 - 架构优化](https://blog.algieba12.cn/geo01-blog-seo-and-geo-optimization-guide/): 深度剖析独立博客在 AI 时代的流量密码。从打破 2023 年陈旧的 robots.txt 封锁，到注入 Schema.org JSON-LD 知识图谱实体，再到打造契合 RAG 分块检索的高增益内容架构，全面实现 SEO 与 GEO（生成式引擎优化）的双重跃迁。
- [在 WSL2 环境下部署 Pixal3D 的从零实战与全流程排雷日志](https://blog.algieba12.cn/record14-pixal3d-deployment-guide/): 本文详尽记录了在 Windows 11 WSL2 环境（Intel i7-13700KF + RTX 4090 24GB）下，从克隆开源 3D 生成大模型 Pixal3D 到成功部署 WebUI 并导出完整 PBR 贴图 GLB 资产的全过程。深度剖析了包括多模型离线缓存、CUDA C++ 自定义算子降级、sm_89 架构重新编译、CPU 抢占冻结宿主机、G
- [在 Android Termux 环境下安装 Hermes Agent 的踩坑与完美解决实践 开发日志](https://blog.algieba12.cn/hermes01-install-on-termux/): 本文记录了在 Android 设备的 Termux 终端中部署 Nous Research 的 Hermes Agent 时所经历的真实踩坑过程。从解决一键脚本的静默死锁，到突破网络代理限制，再到攻克 Rust 交叉编译与 psutil 平台封杀等底层技术难点，最终沉淀出一套稳定可靠的手动编译安装方案。
- [Linux/macOS 下 micromamba 2.6.x 报错 Shard Index not available 与极度卡顿 排坑笔记](https://blog.algieba12.cn/record05-mamba-search-slow/): 在使用 micromamba 连接内部私有仓库时遭遇严重卡顿。最初以为是模糊搜索撑爆了本地渲染，最终查明竟是 micromamba 2.6.x 版本的底层性能回归 Bug。本文记录了完整的排查过程及升级/降级解决方案。
- [VS Code Remote Tunnels本地连接调试Kaggle GPU - 开发技巧](https://blog.algieba12.cn/connect-kaggle-on-vscode/): 本文介绍如何利用 VS Code Remote Tunnels，将 Kaggle 的免费 GPU 算力无缝接入本地 VS Code。告别延迟，拥抱丝滑的本地开发体验。
- [告别孤岛：拥抱 MCP 协议，为大模型打造标准“USB 接口”  - 大模型实战 08 完结篇](https://blog.algieba12.cn/llm08-mcp-intro/): 大模型实战系列完结篇！本文将带你走出 Agent 开发的“重复造轮子”困境，深入浅出地理解 MCP (Model Context Protocol) 协议。我们将动手把之前写的博客监控与通知工具，封装成标准的 MCP Server，并无缝接入 OpenCode 客户端，体验大模型时代的“万能插座”。
- [从 ReAct 到 Workflow：基于云端 API 构建事件驱动的智能体 - 大模型实战 07 额外篇](https://blog.algieba12.cn/llm07-1-llama-index-workflow-groq/): 本篇作为大模型实战07的额外补充，我们将脱离本地算力的限制，介绍如何接入 Groq 和硅基流动的免费 API。同时，我们将把之前的单体 ReAct Agent 升级为 LlamaIndex 新一代的 Workflow 编排引擎，体验事件驱动的多智能体协作模式。
- [基于 LlamaIndex ReAct 框架手搓全自动博客监控 Agent - 大模型实战 07](https://blog.algieba12.cn/llm07-rss-notification-react-agent/): 本节我们将理论付诸实践，利用 LlamaIndex 的 ReAct 框架和 Qwen3 模型，手搓一个全自动的博客监控 Agent。通过为大模型接入 RSS 读取、邮件与微信发送等外部工具，让它从‘聊天机器人’进化为‘能干活的数字员工’。
- [在 Kaggle 上用 Unsloth 极速微调 Qwen3 - 大模型实战 06](https://blog.algieba12.cn/llm06-unsloth-qlora-ft/): 基础理论结束，咱们今天的重心是使用快速高效的微调库Unsloth在Kaggle的T4显卡上，用15分钟将Qwen3-4B模型微调成认主咱们的专属模型。
- [大模型微调实战详解 - 大模型实战 05](https://blog.algieba12.cn/llm05-fine-tune-model/): RAG 虽好，但无法改变模型的“性格”。本文通过实操对比 Base 模型与 Instruct 模型，揭秘大模型“炼丹”的核心心法——微调 (SFT)，并解析大模型从预训练到对齐的完整生命周期。
- [基于 ChromaDB 打造工程级 RAG 系统 - 大模型实战 04](https://blog.algieba12.cn/llm04-rag-llamaindex-chromadb/): 大模型应用开发必修课！本文通过通俗易懂的案例详解 RAG (检索增强生成) 的核心原理，对比 LlamaIndex 与 LangChain 的优劣，并手把手带咱们在 Kaggle 环境下，利用 ChromaDB 和 Qwen 模型搭建一个支持私有数据问答的企业级 RAG 系统。
- [拆解 Transformers 原理与图解 - 大模型实战 03](https://blog.algieba12.cn/llm03-know-more-about-transformer-lib/): 会跑代码还不够，我们要懂原理。本文从 Transformer 的底层视角出发，图解从位置编码到注意力机制的全流程；并基于 Kaggle 平台，深入拆解 HuggingFace Transformers 库的“铁三角”组件与生成参数的玄机。
- [云端炼丹房 2：Kaggle 上手指南 - 大模型实战 03预备](https://blog.algieba12.cn/llm02-2-online-environment-kaggle/): Colab 额度用完了？Kaggle 带着两张 T4 显卡来了！本文详解 Kaggle 账号手机验证、开启 Internet 联网、配置双 T4 GPU 环境，以及如何利用 Kaggle 特有的 Dataset 机制持久化保存 HuggingFace 模型。
- [云端炼丹房：Google Colab 免费 GPU 上手指南 - 大模型实战 03预备](https://blog.algieba12.cn/llm02-1-online-environment-colab/): 本地显卡跑不动大模型？本文手把手教学薅 Google 羊毛！从 Colab 基础操作、免费 T4 GPU 开启，到挂载 Google Drive 持久化存储 HuggingFace 模型，为云端炼丹做好全套准备。
- [Open WebUI 部署与 RAG 实战 - 大模型实战 02](https://blog.algieba12.cn/llm02-start-with-open-webui/): 大模型实战系列第二篇。告别冰冷的命令行！本文带咱们通过 Docker 一键部署 Open WebUI，实现媲美 ChatGPT 的图形化交互，并手把手教你利用 RAG 技术搭建私人本地知识库，让 AI 读懂你的文档。
- [Ollama 部署与 Python 调用本地大模型 - 大模型实战 01](https://blog.algieba12.cn/run-our-own-model-on-pc/): 大模型实战系列第一篇。拒绝晦涩理论，直接上手！我会带着各位友人们零基础安装 Ollama，利用国内 ModelScope 极速下载模型，详解服务端口配置与 Python 脚本调用，涵盖显存计算与常见避坑指南。
- [Streamlit 快速原型开发工具指南 - 开发技巧](https://blog.algieba12.cn/python_streamlit_quick_in_use/): Python 快速开发 Web 应用的最佳工具——Streamlit 上手教程。无需前端基础，本文详解从安装、常用控件（st.write, st.slider）使用，到数据可视化及 Streamlit Sharing 免费公网部署的全流程，助你快速构建 AI 原型与数据面板。

## 移动端与跨平台工程实战 (Flutter / Android / iOS)

- [Android 模拟器代理联网与 No Internet WiFi 锁死排坑笔记](https://blog.algieba12.cn/record12-simulator-proxy/): 记录在日常开发与网络调试中，Android 模拟器配置代理联通谷歌服务时，由于 Captive Portal 检测失败导致系统锁定 WiFi 路由、命令行 -http-proxy 启动与系统 WiFi 代理双重冲突导致 ERR_TIMED_OUT，以及 Google APIs 镜像缺失 Play Store 的排坑历程与解决方案。
- [Flutter 本地通知实现排坑实录 - Android inexactAllowWhileIdle 调度策略与测试方案全解析](https://blog.algieba12.cn/record10-notification-issue/): 记录在 Flutter 项目中实现过期提醒通知功能时，遇到的 Android 系统调度延迟、精确闹钟权限困境、测试验证难题等问题，以及如何通过 inexactAllowWhileIdle + 应用内计时器的混合方案，在保证用户体验的同时实现省电优化和快速测试验证。
- [GoRouter 结合 Isar 运行 Widget 测试并发/粘性线程死锁卡死排坑笔记](https://blog.algieba12.cn/record09-go-router-isar-deadlock-fix/): 记录在 Flutter 项目中，使用 GoRouter 配合 Isar 数据库进行 Widget 测试时，由于 runAsync 导致异步事件逃逸，以及 tearDown 提前关闭数据库所引发的 MDBX 粘性线程断言崩溃和 CI 卡死问题。通过共享测试套件 Isar 实例生命周期彻底解决。
- [Flutter 并发测试踩坑实录 - IsarCore 动态库下载冲突与 Widget 测试 HTTP 拦截全链路解决](https://blog.algieba12.cn/record08-isar-concurrency-test-fix/): 记录在 Flutter 项目中，使用 Isar 数据库运行并发测试时遇到的一系列偶发性与必然性失败：IsarCore 动态库下载冲突（Could not download IsarCore library）、Widget 测试中 mocked HTTP 拦截导致 400 错误、CategorySelector/LocationSelector 等选择器组件的
- [Patrol iOS 集成测试排坑实录 - xcodebuild exit code 70 全链路解决](https://blog.algieba12.cn/record07-patrol-ios-debugging/): 记录在 Flutter 项目中将 Patrol E2E 测试从 Android 扩展到 iOS 模拟器时遇到的一系列问题：xcodebuild exit code 70、RunnerTests vs RunnerUITests 目标配置、模拟器克隆、pressBack 不可用等，以及逐一排查和解决的完整过程。
- [Flutter E2E 测试从 integration_test 迁移到 Patrol - 实践笔记](https://blog.algieba12.cn/record06-patrol-test/): 为 UseUp 项目实现全面的端到端测试，从 integration_test 迁移到 Patrol 框架，配置 Android/iOS 支持，按模块化架构编写测试，并解决 Isar 数据库、版本兼容、本地化文本等踩坑问题。
- [3 分钟搞定 Google Play 隐私政策生成与托管 - Android 开发](https://blog.algieba12.cn/privacy-policy-generator/): 独立开发者必看：无需购买服务器，无需聘请律师。本文提供 2026 年最新 Google Play 隐私政策生成与托管方案，利用 GDPR 模板和 Google Sites 永久免费解决合规问题。

## 系统工程、网络与运维 (Linux / WSL2 / Docker / SSL)

- [VS Code 连接 WSL 精确每 10 分钟掉线 排坑笔记](https://blog.algieba12.cn/record13-vscode-wsl-connection/): 记录日常开发中 VS Code 连接 WSL2 频繁断连且无系统报错的完整排查历程。从怀疑内存 OOM、文件监听数超限，到代理冲突，最终通过 Extension Host 日志揪出企业安全软件 (Zscaler) 600 秒闲置强杀机制，并利用 Mirrored 网络与 TCP Keep-Alive 实现完美绕过。
- [npm 安装依赖排坑实录 - npm ERR! code EHOSTUNREACH 与 IPv6 网络阻断全解析](https://blog.algieba12.cn/record11-npm-install-err/): 记录在执行 npm install 时遭遇 connect EHOSTUNREACH 报错的排查过程。深入解析 Node.js 底层 IPv6 优先级导致的网络阻断问题，并提供从环境变量配置、国内镜像切换到 Linux 系统级 DNS 优先级的全方位解决方案。
- [基于 Cloudflare Pages 的纯前端 WebAssembly 应用自动化部署实践 | 开发日志](https://blog.algieba12.cn/dev01-cloudflare-pages-deployment/): 本文记录了如何将基于 React + Vite + WebAssembly 构建的纯前端应用，零服务器成本自动化部署至 Cloudflare Pages，并解决了构建环境版本控制与自定义域名绑定等细节问题。
- [基于 VS Code 远程开发的 GPU Docker 容器自动清理方案实践 开发日志](https://blog.algieba12.cn/auto-clean-docker/): 本文记录了在 Ubuntu 22.04 共享 GPU 服务器环境下，如何通过编写后台守护进程，解决物理断网场景下的容器自动释放问题，并克服了 Rootless Docker 环境变量丢失等技术难点。
- [解决群晖 NAS SSL 证书自动部署难题](https://blog.algieba12.cn/nas-ssl-certification/): 家里宽带被封了 80 端口无法申请 SSL 证书？本文详解如何在黑/白群晖环境下，利用 Cloudflare API 和 acme.sh 脚本进行 DNS-01 验证，并全自动续期推送证书，彻底告别浏览器不安全提示。

## 架构设计、排坑精选与站长实战 (Engineering & Best Practices)

- [Chrome 扩展开发与上架全流程实战避坑 - 开发技巧](https://blog.algieba12.cn/browser01-register-chrome-extension/): 记录 Chrome Web Store 扩展从注册开发者、自动化打包到隐私合规审核的全流程与常见踩坑点。
- [typing_extensions 有用(四)：使用 TypeIs 替代危险的 cast，做最严谨的类型收窄](https://blog.algieba12.cn/typing-extensions-04-typeis/): 处理外部传入的 JSON 或 Any 类型数据时，如何安全地告诉 IDE 变量的具体类型？本文深入解析 typing_extensions 中的 TypeIs（原 TypeGuard 的究极进化版），教你告别危险的 cast()，实现带静态推断的安全类型校验。
- [typing_extensions 有用(三)：使用 Unpack 结合 TypedDict 给 **kwargs 装上透视眼](https://blog.algieba12.cn/typing-extensions-03-unpack-typeddict/): Python 的 **kwargs 极大地提升了函数的灵活性，但也让代码失去了 IDE 的类型补全，成为了可怕的类型黑洞。本文详细讲解如何利用 typing_extensions 中的 Unpack 和 TypedDict，在保留原生关键字传参优雅性的同时，让 IDE 获得满血的自动补全与静态检查能力。
- [typing_extensions 有用(二)：使用 @override 打造重构代码时的“防呆神器”](https://blog.algieba12.cn/typeing-extensions-02-override/): 在 Python 面向对象编程中，重写父类方法时极易因为拼写错误或父类重构而产生难以察觉的 Bug。本文介绍 typing_extensions 库中的 @override 装饰器，揭秘为何它在运行时是纸老虎，但在静态检查中却是拯救代码的守护神。
- [typing_extensions 有用(一)：使用 Self 终结继承时的类型推断灾难](https://blog.algieba12.cn/typeing-extensions-01-self/): 在 Python 面向对象编程中，方法返回当前类实例时常遇继承类型退化问题。本文介绍 typing_extensions 库中的 Self 类型，讲解如何在链式调用 (Builder 模式)、类工厂方法及上下文管理器中优雅解决此问题，提升代码类型安全与 IDE 补全体验。
- [critical libmamba Shell not initialized micromamba报错 subprocess 无法修改父 Shell - 排坑笔记](https://blog.algieba12.cn/record04-mamba-shell-issue/): 在使用 micromamba 激活虚拟环境时，常遇到 'subprocess and can't modify the parent shell' 的报错。本文记录了该报错的根本原因（子进程环境变量隔离机制）以及永久与临时的解决方案。
- [VS Code Remote-SSH: 彻底告别重复输入密码 - 排坑笔记](https://blog.algieba12.cn/vscode-ssh-login/): 每次使用 VS Code 远程开发都会被要求反复输入密码？本文详细记录了通过配置 SSH 密钥对实现无感免密登录的完整步骤与避坑指南。
- [Git 报警: inexact rename detection was skipped - 排坑笔记](https://blog.algieba12.cn/record03-git-inexact-rename-detection-was-skipped/): 在进行 Git Rebase 或 Merge 时，常因文件变动量超过系统阈值触发 'inexact rename detection was skipped' 报警。本文记录了该警告的成因分析与极速解除方法。
- [Windows 下 Git error: fatal: refusing to work with credential missing host field - 排坑笔记](https://blog.algieba12.cn/record02-git-refusiing-to-work/): 在混合使用公司内网环境与 GitHub 公网开发时，常因 Git 凭据管理器配置冲突或旧版 URL 转换规则干扰，触发 'missing host field' 报错。本文记录了从内网配置清理到公网恢复的全过程。
- [VS Code 调试 Python 第三方库源码的配置 - 开发技巧](https://blog.algieba12.cn/debug-build-in-python-lib/): 有时候只看自己的代码是不够的，我们需要深入第三方库的内部去寻找 Bug。本篇教你如何通过 VS Code 的关键配置，轻松‘潜入’库源码进行断点调试。
- [Windows下Git error: open(xxxx) Filename too long - 排坑笔记](https://blog.algieba12.cn/record01-git-long-file/): 在Windows系统下进行复杂项目开发时，常因目录层级过深触发Git的'Filename too long'报错。本文详细记录了该问题的成因，并提供了通过修改Git全局配置和Windows系统注册表来完美解决的方案。
- [记录2026年零预约港卡开户实录避坑](https://blog.algieba12.cn/request-hk-cards/): 记录2026年3月一场说走就走的香港开户之旅。在没有提前预约中银的情况下，实测汇丰、众安、天星等5家银行的线上开户流程。文章详细分享了手机漫游设置、网络流量解决方案以及必备材料的踩坑经验。
- [Giffgaff eSIM 卡申请与激活教程 - 工具推荐](https://blog.algieba12.cn/giffgaff-esim/): 详细记录如何申请 Giffgaff 英国手机卡，以及激活后如何关闭语音信箱避免高额漫游费的完整教程。
- [自制 Windows 剪贴板历史记录工具 - 开发日志](https://blog.algieba12.cn/windows_clipboard_recorder/): 开源一款基于 Python 开发的 Windows 剪贴板增强工具。它不仅能实现剪贴板历史记录功能（支持文本、图片、文件），还能帮助用户监控剪贴板安全，防止敏感信息泄露。内附 GitHub 源码地址与技术实现解析。
- [用 Python 实现诸葛神数 - 开发日志](https://blog.algieba12.cn/zhuge-horary/): 用 Python 复刻《秘本诸葛神数》占卜算法的完整开发日志。本文涵盖了从爬取签文数据、利用 Unihan 数据库精确计算汉字笔画，到使用 Streamlit 快速构建并免费部署 Web 应用的全过程。一个集爬虫、算法与 Web 开发于一体的趣味实战项目。
- [获取汉字笔画数方案 - 开发技巧](https://blog.algieba12.cn/how_to_get_strokes/): 记录了在开发卜筮脚本时遇到的汉字笔画数获取问题。在排除 pypinyin 库的错误方案后，详细介绍了如何通过解析 Unicode 官方 Unihan 数据库，提取 kTotalStrokes 字段来实现精准的汉字笔画查询功能。

## 补充资源与全文索引 (Optional)

- [全站高密度纯净全文索引 (llms-full.txt)](https://blog.algieba12.cn/llms-full.txt): 汇聚全站技术文章无 HTML 噪声的纯净 Markdown 内容，专供大上下文窗口模型一站式吞吐学习。
- [XML 站点地图 (sitemap.xml)](https://blog.algieba12.cn/sitemap.xml): 传统搜索引擎专用站点地图。
- [RSS 订阅源 (atom.xml)](https://blog.algieba12.cn/atom.xml): 实时文章更新流。