Liu Yiyi 的博客

背景是这样的：公司统一用 IDaaS（Identity as a Service）做登录，IDaaS 自己持有会话（cookie）；后端服务有十几个，谁都不想在自己的代码里接一遍 SDK、写一遍登录跳转、管一遍会话。这篇把整个方案完整收拢：认证架构怎么定、ingress-nginx 怎么全局拦截、用户信息怎么以 hea... 阅读全文 →

这是统一认证系列的第四篇，也是方案 B（业务 starter filter 直连 auth 服务，不依赖 ingress 全局拦截）的实现篇。前三篇分别是：GitOps 与 K8s 统一认证落地、GitOps 里 k8s 公共配置放哪、统一认证完整方案。这一篇只回答一个问题：方案 B 到底怎么写——auth 服务的 /authz 契约与实现、sta... 阅读全文 →

这次的起因很日常：一晚上写了 7 篇文章，凌晨一点半推上去，当场验了一下线上——好家伙，首页没有、搜索搜不到、直接访问 404，7 篇文章集体蒸发。排查到最后，发现这个 bug 我已经带着跑了十几篇文章，只是每次都被我自己”睡好”了。 现象：本地一切正常，线上集体蒸发 那天晚上的时间线是这样的： ... 阅读全文 →

三年前写过一篇《如何自定义Github个人主页？》，当时只是开了个头。最近把自己的主页从零折腾了一遍：先做了个”火力全开”的炫酷版，又亲手全删掉回归极简。这篇文章记录整个过程、用到的工具，以及第三方服务的坑。 起点 改造前的主页大概是这样：两张统计卡片、一段自我介绍、六个纯文字徽章。能用，但访客 1... 阅读全文 →

背景是这样的：最初的需求非常朴素——根据 git 历史记录自动生成周报，自动通过 Outlook 发出去。但从这个问题出发一路往下推：提交信息质量决定周报质量、git 里查不到下周计划、周报的目的其实是”可见度 + 留痕”、个人工具要不要给领导用、手里有专项工作怎么单独汇报……最后发现真正值得做的不是”周报生... 阅读全文 →

接着上一篇 GitOps 与统一认证落地继续聊。上一篇讲了 GitOps 是什么、auth 服务怎么用，这篇回答一个很自然的追问：业务服务的东西写进 Git 没问题，但 ingress-nginx、RBAC、监控这些 k8s 公共的东西放哪？也是同一个仓库吗？还是搞一个专门的仓库？ 先说结论 搞... 阅读全文 →

背景是这样的：公司统一用 IDaaS（Identity as a Service）做登录，IDaaS 自己持有会话（cookie）；后端服务有很多个，想加一个 auth 服务统一做校验 + RBAC，但不想让每个业务服务都折腾一遍接入。这篇文章记录整个方案的推导过程：认证架构怎么设计、ingress-nginx 怎... 阅读全文 →

上一篇《把 GitHub 主页从”炫酷”改回”极简”，我踩过的坑》里说过：”主页上每一个外部 URL，都是一个别人随时可能关掉的灯”。话音刚落，灯就灭了——这次把根因挖到底，并给出终极解法。 现象：图又裂了 极简版主页刚上线没几天，GitHub Stats 两张卡变成了这样： Something went wro... 阅读全文 →

本文记录 DeepSeek Harness 的基本运行方法，并介绍 pnpm、Claude Agent SDK、Cordis、Koishi、本地插件开发和 DSH 社区插件。Claude Agent SDK 只保留一个 Python 入门示例，其余内容重点放在 DSH 插件生态。 运行 DeepSeek Harness Dee... 阅读全文 →

一次完整的接入实录：为什么内置图像工具不可用、如何用阿里百炼 Qwen-Image API + Codex 技能曲线救国，以及直接基于参考图片出图的 I2I 玩法。 TL;DR 现象：Codex 使用 DeepSeek API（纯文本），内置的 image_gen 工具不出现，说“画一只猫”没有反应。 原因：... 阅读全文 →

开源大模型的使用链路可以概括为：从 Hugging Face 获取模型和数据，使用 Unsloth 等工具完成 LoRA 或 QLoRA 微调，再根据部署环境导出为 Safetensors 或 GGUF。本篇笔记梳理这条链路中最容易混淆的概念，并给出一套可落地的微调流程。 Hugging Face ... 阅读全文 →

在较新的 Debian、Ubuntu 和 WSL 环境中，直接执行 pip install 可能出现 externally-managed-environment 错误。这是 PEP 668 的保护机制：系统不允许 pip 直接修改由操作系统管理的 Python 环境。 安装 LiteLLM Proxy 时，不建议使用 sudo p... 阅读全文 →

OpenAI 目前有两个常见的文本生成接口：/v1/chat/completions 和 /v1/responses。前者仍然可用，后者更适合新项目。 简单地说：Chat Completions 围绕消息列表设计；Responses 围绕不同类型的输入、输出和工具调用设计。 我还做了一个交互式演示页，改参数就能实时对照两种接口的请... 阅读全文 →

Claude Code 的 VS Code 扩展可以通过环境变量指定 API 地址和不同档位对应的模型。对于提供 Anthropic 兼容接口的模型平台，可以直接修改 VS Code 的 settings.json，不必额外安装模型切换工具。 本文将介绍一种纯手动配置方案，只需修改 VSCode 的 settings.json，即可实... 阅读全文 →

在使用 Claude Code 构建领域专用 Agent 的过程中，知识库的组织方式直接影响着 Agent 的性能和实用性。一个结构清晰、组织良好的知识库能够帮助 Claude Code 更准确地理解和应用专业知识。本文将详细介绍如何在 Claude Code 中有效地组织知识库，构建高效的领域专用知识管理体系。 为什么需要良... 阅读全文 →

随着大语言模型技术的快速发展，越来越多的开发者开始关注如何构建具有特定领域知识的智能代理（Agent）。Claude Code 作为 Anthropic 推出的先进代码助手，为创建领域专用 Agent 提供了强大的支持。本文将详细介绍如何将医院领域的专业知识注入到 Claude Code 制作的 Agent 中，构建专业的医疗... 阅读全文 →

一、原电脑：把WSL打包备份 先给旧电脑上的WSL做个“备份包”，确保所有东西都能带走。 打开PowerShell，先查下WSL是不是在运行：输入 wsl -l -v 如果状态是“Running”，再输 wsl --shutdown 关掉它（不关... 阅读全文 →

在 Windows 终端中安装 Nerd Font 字体并解决图标乱码问题，可按以下步骤操作： 第一步：下载 Nerd Font 字体 访问 Nerd Fonts 官方网站：https://www.nerdfonts.com/font-downloads 推荐下载以下常用字体（点击即可下载）： ... 阅读全文 →

在开源项目的README文件中展示Star History图表，能够让访问者快速了解项目的热度变化趋势，增加项目的吸引力和可信度。那么，如何将这一实用的可视化内容添加到README中呢？ 使用 Markdown 语法嵌入图表 在项目的 README 文件中，添加以下 Markdown 代码： [![... 阅读全文 →

在使用 MkDocs 编写技术文档时，如果你需要多语言支持或智能交互功能，这两个插件能帮上大忙。它们操作简单、配置灵活，能显著提升文档的实用性和用户体验。 一、mkdocs-translate：一键实现文档多语言翻译 适用场景：需要将英文文档翻译成中文、法语等其他语言，或维护多语言版本的项目文档。 核心功能 基于 D... 阅读全文 →

要将 mkdocs-chatgpt 插件与 Ollama 本地大语言模型服务集成，需要进行一些自定义配置。虽然该插件默认支持 OpenAI API，但我们可以通过修改其请求逻辑来适配 Ollama 的 API 格式。以下是具体实现方法： 一、核心思路 mkdocs-chatgpt 插件通过 JavaScript 与后端 API 通信。我们... 阅读全文 →

想把用 MkDocs 写好的文档部署到 GitHub Pages 上，方便分享和展示？按下面步骤操作，轻松搞定。 一、准备工作 1. 准备 MkDocs 文档 先整理好项目目录： 项目根目录/ ├── .github/ │ └── workflows/ │ └── deploy.yml # 部署配置文件 ├── doc... 阅读全文 →

在 langgraph 项目中有许多的文档，仔细观察可以发现许多文档是只有 .ipynb 这样的笔记本格式，并没有直接的 Markdown 文本与之对应。文档使用 mkdocs 来构建，但 mkdocs.yaml 文件中也没有 jupyter 相关的插件，那 langgraph 到底是怎么直接展示 ipynb 文件的文档的呢？下面是豆包给的回答： ... 阅读全文 →

Windows 系统 AutoHotkey 脚本开机自启动 Windows系统AutoHotkey脚本开机自启动 一、为什么要设置AutoHotkey开机自启动？ AutoHotkey是一款强大的自动化工具，可通过脚本自定义快捷键、自动输入文本或执行复杂操... 阅读全文 →

blog中可以插入一些demo，交互式的demo可以让blog更具有表现力 gradio只需通过几行python代码，即可制作一个机器学习的demo，hugging face space中大多都是由gradio实现的。 使用hugging face space托管我们的gradio应用，即可... 阅读全文 →

Github 可以自定义用户主页，也许这是程序员最棒的自我介绍。自定义也非常简单，即建立一个与自己账号同名的仓库，README.md文件就会自动出现Github的个人首页中。我们只需在README.md文件中编写想要展示的内容即可。 自定义的重点和难点也许在于如何写这个READM... 阅读全文 →

在“如何使用 Jekyll 和 GitHub Pages 搭建个人博客”中介绍了基础建站流程，本文继续使用 Utterances 为静态博客增加评论功能。 因为是静态博客，讲道理是没有评论这种动态功能的，但只要思想不滑坡办法总比困难多。utterances就是一个利用Github的issue功能来在静态博客里面实现评论的项目。 _... 阅读全文 →

Jekyll 负责把 Markdown、模板和配置生成静态网站，GitHub Pages 负责托管生成后的页面。这套方案不需要单独购买服务器，适合个人博客和技术笔记。 1. 准备工作 一个 GitHub 账号 Git 基本用法 2. 选择主题 因为使用的是开源的博客模板，所以需要先去主题官网挑选一个自... 阅读全文 →