跳到正文

天行健,君子以自强不息

Python 后端项目的 AI Agent 规则约束实践:让 AI 乖乖按你的规矩写代码

AI
2.5k 9 分钟

📌 前言

用 AI Agent(Cursor、Copilot、Claude Code 之类)写代码有一段时间了,爽是真爽,但坑也没少踩。没有约束的 AI 就像一个能力超强但没有项目上下文的新员工:代码风格一会儿一变、动不动就给你写个五百行的”上帝函数”、改完代码注释还是上一版的、Git 提交信息写得随心所欲……

后来我开始给 AI 立”规矩”——把项目的开发规范写成规则文件,让 AI 每次干活前都必须遵守。这篇文章就以我自己的 Python 后端项目(FastAPI)为例,把我实际在用的全套规则方案分享出来。每个规则都附上了我项目里真实使用的文件原文,可以直接复制到自己项目里改改用,包括:

  • 哪些规则对开发规范有明显帮助(先规划后编码、长度/耦合限制、接口文档同步)
  • Git 提交信息生成的规范
  • VS Code / Cursor 里怎么配置这些规则
  • 为了跨工具兼容,通用的 AGENTS.md 应该怎么写

Git 凭证免密配置:.git-credentials 一次搞定,告别反复输入 Token

2k 7 分钟

📌 前言

最近公司内网搭了一个 Gitea 仓库,团队的代码协作都靠它。作为一个典型的「i 人」,当我发现用 SSH 方式克隆仓库需要管理员审批密钥时,内心是抗拒的——为了克隆一个仓库还要专门去麻烦别人,想想就社恐发作。于是果断选择了 HTTP 方式。

但 HTTP 方式默认只能读不能写,想推送代码,还得再去申请一个访问令牌(Token)。本以为申请完就一劳永逸了,真正用起来才发现另一个坑:每克隆一个新仓库,都得在 URL 里手动带上用户名和 Token,长这样:

1
git clone http://用户名:token@gitea.example.com:3000/团队/项目.git

这一长串又难记又难输,复制粘贴时还要担心记错,而且 Token 直接暴露在命令行里也有安全隐患。实在忍不了,我开始研究 Git 官方的凭证机制,最终找到了一个一劳永逸的配置方案——配置一次,从此 clone / push / pull 全程免输

Docker 从入门到实践:安装部署、核心概念与常用命令

1.3k 5 分钟

📌 前言

Docker 是目前最流行的容器化平台,它可以将应用及其依赖打包成一个标准化的容器镜像,实现”一次构建,到处运行“。无论你是在本机开发、测试环境验证,还是在生产服务器上部署,Docker 都能保证环境的一致性。

本文将涵盖四大板块:

  • 🔍 Docker 核心概念(镜像、容器、仓库的关系)
  • 🐧 Ubuntu 22.04 安装 Docker Engine
  • 🪟 Windows 安装 Docker Desktop + WSL2 优化
  • 🛠️ 常用命令与实战示例

WSL2 Ubuntu 安装部署 Ollama 本地大模型

AI
1k 4 分钟

📌 前言

Ollama 是一款优秀的本地大语言模型(LLM)运行工具,支持在本地轻松下载、管理和运行各种开源大模型(如 Llama、Mistral、Qwen、DeepSeek 等)。与云端 API 方案相比,Ollama 具有数据完全本地化、无需网络、无限次调用等优势。

本教程将详细介绍在 WSL2 Ubuntu 20.04 环境下从零开始安装部署 Ollama 的完整流程。

Hexo常用操作

63 1 分钟

Welcome to Hexo ! This is your very first post. Check documentation for more info. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub ....