关于本站

你好，我是 yourname。这里记录我在前后端开发、AI 工具应用与工程实践中的所思所得。

本站既不是教程站也不是新闻站，更像是一份可检索的工程笔记——遇到的问题、踩过的坑、最终落地的方案，整理成文以便日后回溯。如果其中某篇恰好帮到了你，那是意外之喜。

🎯 关注方向

• 现代前端工程：Astro / React / TypeScript / 构建工具链
• Python 后端开发：FastAPI / 异步编程 / 类型系统
• AI Native 工具：Claude Code / Prompt Engineering / Agent 工作流
• 个人效率基建：博客 / 知识库 / 自动化脚本

🛠️ 技术栈

前端

• 框架：Astro 6（Islands 架构，零 JS 默认） + React 19
• 样式：Tailwind CSS 4（utility-first，按需生成）
• 类型：TypeScript 6（strict mode）
• 内容：MDX + Zod Schema 严格校验 frontmatter
• 搜索：Orama（客户端全文索引，中英文加权）
• 状态 / 表单：React Hooks + 自研 Hooks（useDebounce 等）

后端 / Python

• Web 框架：FastAPI（类型驱动 + 自动 OpenAPI 文档）
• 异步运行时：asyncio + uvicorn
• 数据校验：Pydantic v2（与 FastAPI 一脉相承）
• ORM：SQLAlchemy 2.0（async 模式） / SQLModel
• 任务队列：Celery / Arq（按需）
• 测试：pytest + httpx（异步 API 测试）

AI 工具链

• 主力 IDE / Agent：Claude Code（Anthropic 官方 CLI，agentic workflow + tool use）
• 本地 LLM 推理：LM Studio（OpenAI 兼容 API + 向量检索 RAG）
• Embedding：text-embedding-nomic-embed-text-v1.5 / bge-m3
• 提示词工程：few-shot / chain-of-thought / structured output

工程 / 部署

• 版本控制：Git + GitHub
• CI/CD：GitHub Actions + release-please（conventional commits → 自动化版本）
• 包管理：pnpm（前端）/ uv（Python）
• 代码质量：TypeScript strict / ESLint / tsc --noEmit / pre-commit
• 部署：Node standalone / Docker（反代 + HTTPS）

✨ 本站特点

• ⚡ 极致性能：Astro Islands 架构，文章页默认 0 JS，按需水合
• 🔍 全文搜索：客户端索引（Orama），⌘K 唤起命令面板
• 🤖 AI 问答：基于本地大模型 + RAG（向量检索博客内容），支持多轮对话
• 🛡️ 安全优先：CSP / API 限流 / HMAC 鉴权 / 真实 IP 解析
• 📊 错误监控：客户端 4 类错误捕获 + /admin 后台查看
• 🏷️ 标签系统：单一真源（tags.json）+ zod 严格校验引用
• 🌗 深色模式：跟随系统或手动切换
• 📤 一键分发：支持自动发布到 CSDN / 掘金

💼 工作方式

我个人偏好 AI Native 工作流——用 Claude Code 处理重复性任务（代码生成 / 重构 / 测试编写 / 文档整理）， 自己聚焦在问题定义、方案决策、关键代码 review。这种分工让我能把精力放在真正需要判断力的地方。

如果你也用 Claude Code，可以看看我整理的实践笔记；如果有不同看法，欢迎在评论区或 GitHub 交流。

📬 联系方式

• GitHub: https://github.com/yourname
• RSS: /rss.xml
• 文章页右下角 AI 助手（基于本地大模型 + RAG）

如果你发现文章中有错误或有不同见解，欢迎通过 GitHub Issue / PR 指正。 本站所有内容均为个人见解，与雇主无关。