文档 on Hardy Blog

curl命令

Sat, 02 May 2026 00:00:00 +0000

curl 是一个非常强大的命令行工具，它用于与服务器交换数据。通过 curl，你可以向服务器发送 HTTP 请求，下载或上传文件，甚至与 API 进行交互。它支持多种协议，如 HTTP、HTTPS、FTP、FTPS、SFTP、SMTP 等等。

基本语法：#

curl [选项] [URL]

常见用途：#

获取网页内容:

curl http://example.com

这条命令将会获取 example.com 网站的 HTML 内容并显示在终端上。

下载文件:

curl -O https://example.com/file.zip

使用 -O 选项可以将文件下载到本地并保留原文件名。

发送 POST 请求:

curl -X POST -d "username=user&password=pass" http://example.com/login

这条命令向 example.com/login 发送一个 POST 请求，数据为 username=user&password=pass。

上传文件:

curl -X POST -F "file=@/path/to/file" http://example.com/upload

使用 -F 选项可以发送文件，@ 后跟文件路径表示上传的文件。

获取响应头:

curl -I http://example.com

-I 选项只获取响应的头部信息。

发送自定义请求头:

curl -H "Authorization: Bearer your_token" http://example.com/data

使用 -H 选项可以添加自定义的请求头，这里用于设置 Authorization 头。

跟随重定向:

curl -L http://example.com

-L 选项使得 curl 自动跟随服务器返回的重定向。

MCP Server

Thu, 30 Apr 2026 00:00:00 +0000

MCP Server 是 Model Context Protocol 的缩写，是 Anthropic 推出的一个开放协议，让 AI 模型可以调用外部工具。

简单理解#

传统方式：
你 ──打字──> Claude ──回答──> 你
（Claude 只能聊天，不能操作外部世界）

MCP 方式：
你 ──提问──> Claude ──调用工具──> MCP Server ──执行──> 返回结果
 │
 ├── 读写文件
 ├── 查询数据库
 ├── 调用API
 └── 任何你能编程实现的事

MCP 就是一个标准化的插件系统。你写一个 Python/TypeScript 脚本，声明它提供哪些工具，Agent 就能在对话中自动调用这些工具。类似于给浏览器写扩展插件，只不过是给 AI Agent 写的。

Next.js

Thu, 30 Apr 2026 00:00:00 +0000

Next.js 是一个把 React 从纯前端库升级为全栈应用框架的生产力工具，让你通过文件即路由、服务端组件和开箱即用的优化，简单高效地构建现代 Web 应用。

使用 Next.js，你可以用 JavaScript/TypeScript 这一种语言，在同一个项目里同时编写：

前端：React 组件（UI 交互、页面渲染）
后端：API Routes、Server Actions、数据获取、数据库查询等

具体体现：#

层级	传统方式	Next.js 方式
语言	前端 JS + 后端（Java/Go/PHP等）	统一用 JavaScript/TypeScript
项目	前后端分离，两个仓库/两个部署	一个项目，一键部署
接口	需要定义 REST/GraphQL，通过 HTTP 调用	直接导入函数或调用 Server Action，无需手动写接口
数据获取	前端 fetch → 后端 → 返回 JSON	服务端组件里直接 await db.query()

TailwindCSS与传统CSS

Thu, 30 Apr 2026 00:00:00 +0000

🎯 场景：创建一个用户卡片#

假设你需要做一个这样的用户卡片：

白色背景、圆角、阴影
内边距、外边距
标题大号加粗、文字灰色
按钮蓝色背景、白色文字、圆角

📝 传统 CSS 写法#

你先要写一个 CSS 文件：

/* styles.css */

.card {

background-color: white;

border-radius: 8px;

box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);

padding: 20px;

margin: 16px;

max-width: 300px;

}

.title {

font-size: 24px;

font-weight: bold;

color: #374151;

margin-bottom: 12px;

}

.button {

background-color: #3b82f6;

color: white;

padding: 8px 16px;

交互式 REPL

Thu, 30 Apr 2026 00:00:00 +0000

交互式 REPL 是编程环境中一个非常实用的工具。这四个字母分别代表：

R (Read，读取)：读取用户输入的代码或表达式。
E (Eval，求值)：对读取的内容进行计算或执行。
P (Print，打印)：显示求值的结果。
L (Loop，循环)：重复以上过程，等待下一个输入。

简单来说，REPL 就像一个“对话式”的代码运行环境。你输入一句代码，它立刻给你一句结果，然后等待你继续输入。

一个直观的类比：计算器#

普通的编程是“写完整本书再翻看”，而 REPL 就像用计算器：

你按下 2 + 3（读取）
计算器显示 5（求值并打印）
你还可以继续按 * 4（循环）

与普通运行代码的区别#

特性	普通脚本运行	交互式 REPL
方式	写完整段代码，一次性执行	一行一行或一句一句执行
状态	每次运行都是全新的开始	变量、函数会一直保留，可逐步测试
目的	完成完整的功能、应用	探索、调试、学习、原型验证
反馈	最后才能看到全部输出	立即得到每一步的结果

OCR

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

OCR 在“OCR语言设置”中的全称是：

Optical Character Recognition中文名称：光学字符识别（也常称为文字识别）

简单解释什么是 OCR？#

OCR 是一种人工智能 + 图像处理技术，它的主要功能是：

从图片、扫描件、照片、PDF 图像中，自动识别出里面的文字。
把图像里的文字转换成可编辑、可搜索、可复制的机器可读文本。

常见应用场景：

把纸质文档扫描后转成可编辑的 Word
识别身份证、发票、名片上的文字
提取图片里的文字（例如截图、书本照片）
视频字幕识别
文档数字化处理（企业常用）
PDF 转可搜索 PDF

“OCR语言设置”是什么意思？#

OCR语言设置 是指你在使用 OCR 功能时，告诉系统当前要识别的文字主要是什么语言。

为什么要设置语言？

不同语言的文字特征差别很大（例如中文是方块字，英文是字母，阿拉伯文是连笔）。
设置正确的语言可以大幅提高识别准确率，减少错别字。
如果不设置，很多 OCR 工具会默认使用英文，导致中文、日文、韩文等识别效果很差。

常见语言代码示例（不同工具略有差异）：

chi_sim 或 zh → 简体中文
chi_tra 或 zh-TW → 繁体中文
eng → 英文
jpn → 日文
kor → 韩文
auto 或留空 → 自动检测语言（部分高级工具支持）

Transformer

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

① Transformer 是什么？#

全称：Transformer 架构
它是目前几乎所有大语言模型（ChatGPT、Llama、Qwen、DeepSeek 等）的核心骨架。
主要特点：抛弃了传统的 RNN、LSTM，完全使用 Self-Attention（自注意力机制） 来处理序列数据。
优点：并行计算能力强，能很好地捕捉长距离依赖关系。

简单说：Transformer 是一种强大的神经网络结构。

② BERT 是什么？#

BERT = Bidirectional Encoder Representations from Transformers
中文：基于 Transformer 的双向编码器表示
BERT 是 Google 在 2018 年发布的预训练语言模型，它使用了 Transformer 中的 Encoder（编码器）部分。
BERT 的最大创新是双向理解：它能同时看一个词的左边和右边上下文（而之前的模型大多只能看一边）。

BERT 一经发布就大幅刷新了各种 NLP 任务的记录，后来几乎所有现代语言模型都受到了它的影响。

③ [CLS] 是什么？为什么会出现？#

[CLS] 是 “Class” 的缩写，中文常称为 分类标记 或 句首标记。

它的作用是：

在 BERT 处理文本时，会在输入文本的最前面自动加上一个特殊的 Token：[CLS]。

例如输入句子：

“今天天气很好”

经过 Tokenizer 处理后变成：

[CLS] 今天天气很好

BERT 的 Transformer 编码器会对整个序列（包括 [CLS]）进行处理。

uv、conda、python（venv）创建虚拟环境的区别

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

Python 自己的虚拟环境（venv）#

uv（强烈推荐了解的新工具）#

Conda（Anaconda / Miniconda）#

实际使用建议（2026 年）

纯 Python 项目（Web 后端、脚本、自动化、学习等）→ 强烈推荐 uv 它目前是速度和体验最好的选择，很多人都已经“删掉 conda 改用 uv”了。
数据科学 / 机器学习 / 需要 GPU → 继续用 Conda（或 micromamba / pixi） 因为 uv 还无法完美替代 conda 处理非 Python 二进制依赖。
极简主义 → 直接用 venv + pip（或 venv + uv pip）。

Api代理与反向代理

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

一句话区别#

API代理（正向代理）：帮“客户端”去访问API
API反向代理：帮“服务器”接收请求

🧩 一、API代理（正向代理）#

👉 核心：代理的是“你（客户端）”

📌 场景理解#

你访问一个国外API，但是：

被墙 / 网络限制
或者你不想暴露自己IP

于是你用一个代理服务器帮你访问。

🧭 流程#

你 → 代理服务器 → 真实API → 返回结果

🍔 类比#

你找“代购”帮你买东西

👉 店家根本不知道是你买的，只知道代购

📌 特点#

API服务器不知道真实客户端是谁
代理是给“客户端”用的
常见：VPN、HTTP代理

🧩 二、API反向代理（你刚刚问的那个）#

👉 核心：代理的是“服务器”

🧭 流程#

客户端 → 反向代理服务器 → 真实API服务器 → 返回结果

🍔 类比#

你去餐厅点餐：

你只看到前台（反向代理）
后面有多少厨房（真实服务器）你不知道

📌 特点#

客户端不知道真实API在哪
反代是“服务器对外的门面”
常见：负载均衡、网关

⚔️ 三、核心区别对比#

对比点	API代理（正向）	API反向代理
代理对象	客户端	服务器
谁在用	客户端主动使用	服务端部署
真实API是否暴露	暴露给代理	被隐藏
典型用途	翻墙、隐藏IP	网关、负载均衡、跨域
客户端是否感知	知道在用代理	通常不知道

💡 四、一个特别关键的理解（重点！）#

👉 判断方法：

git知识

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

一、命令#

rebase#

rebase 会生成全新的提交哈希，导致本地历史与远程历史产生“分叉”。Git 默认禁止非快进（non-fast-forward）推送，因此必须用强制推送来明确告诉远程：“我要用新历史替换旧历史”。

📖 详细原理拆解#

为什么 `rebase` 会改写历史？#

Git 中每个提交的唯一标识是一个 SHA 哈希值（如 a1b2c3d）。这个哈希不是随机生成的，而是由以下信息共同计算得出：

提交内容（diff）
作者/提交者信息
时间戳
父提交的哈希值 ← 关键！

当你执行 git rebase main 时，Git 底层实际在做：

把你分支上的提交临时保存为“补丁”
把当前分支指针移到最新的 main
逐个重新应用补丁，生成全新的提交

因为新提交的父提交变成了 main 的最新提交，所以即使代码内容一模一样，计算出的哈希值也会全部改变。旧提交并没有被“修改”，而是被新提交替换，历史线因此被重写。

为什么普通 `git push` 会失败？#

假设远程分支历史是

main: A ─ B ─ C

你的分支: └─ D ─ E （远程记录）

你本地 rebase 后，历史变成了

main: A ─ B ─ C

你的分支: └─ D’─ E’ （本地新哈希，D’/E’ 内容同 D/E 但哈希不同）

当你执行普通 git push 时，Git 会检查：远程分支的末端（E）是不是本地分支末端（E'）的祖先？ 答案是否。Git 认为这是一次“非快进更新”，出于防误覆盖的安全机制，会直接拒绝推送并报错：

HTT状态码

Wed, 22 Apr 2026 00:00:00 +0000

🟢 1xx Informational（信息性）#

状态码	英文名称	中文含义	常见场景
100	Continue	继续	服务器已接收请求头，客户端可继续发送请求体
101	Switching Protocols	切换协议	同意升级协议（如 HTTP → WebSocket）
103	Early Hints	早期提示	提前返回部分响应头（如预加载 CSS/JS，提升首屏性能）

🟢 2xx Success（成功）#

状态码	英文名称	中文含义	常见场景
200	OK	成功	请求正常完成，返回响应体
201	Created	已创建	请求成功并创建新资源（常用于 POST）
202	Accepted	已接受	请求已入队/异步处理中，结果稍后获取
204	No Content	无内容	请求成功，但无返回体（常用于 DELETE/PUT）
206	Partial Content	部分内容	范围请求成功，用于断点续传、视频分片加载

🟡 3xx Redirection（重定向）#

状态码	英文名称	中文含义	常见场景
301	Moved Permanently	永久重定向	资源已永久迁移，建议更新书签/SEO权重转移
302	Found	临时重定向	资源临时迁移，默认将请求方法转为 GET
303	See Other	查看其他地址	明确指示客户端用 GET 访问新 URL（防重复提交）
304	Not Modified	未修改	缓存有效，客户端使用本地缓存（条件请求命中）
307	Temporary Redirect	临时重定向	保持原请求方法不变（替代 302 的严格场景）
308	Permanent Redirect	永久重定向	保持原请求方法不变的永久跳转（替代 301）

🟠 4xx Client Error（客户端错误）#

状态码	英文名称	中文含义	常见场景
400	Bad Request	错误请求	参数缺失、JSON 格式错误、语法无效
401	Unauthorized	未授权	未登录或凭证无效，需重新认证
403	Forbidden	禁止访问	已认证但权限不足，或被策略/IP 拦截
404	Not Found	未找到	请求的路径或资源不存在
405	Method Not Allowed	方法不允许	使用了不支持的 HTTP 方法（如 GET 调 POST 接口）
408	Request Timeout	请求超时	客户端发送请求过慢，服务器主动断开
409	Conflict	冲突	请求与当前资源状态冲突（如并发修改、重复创建）
413	Payload Too Large	请求体过大	上传文件/数据超过服务器或框架限制
415	Unsupported Media Type	不支持的媒体类型	Content-Type 不被服务端接受
422	Unprocessable Entity	无法处理的实体	格式正确但业务校验失败（API 常用）
429	Too Many Requests	请求过多	触发限流/频率限制，需等待后重试
451	Unavailable For Legal Reasons	因法律原因不可用	内容被依法屏蔽/下架

🔴 5xx Server Error（服务器错误）#

状态码	英文名称	中文含义	常见场景
500	Internal Server Error	内部服务器错误	服务端代码抛异常、未捕获错误、配置故障
501	Not Implemented	未实现	服务器不支持该请求方法或功能
502	Bad Gateway	错误网关	反向代理/网关收到上游无效响应（如 PHP-FPM 崩溃、后端重启）
503	Service Unavailable	服务不可用	服务器过载、维护中、依赖服务宕机（常配合 Retry-After）
504	Gateway Timeout	网关超时	上游服务器未在限定时间内响应（常见于慢 SQL、外部 API 超时）

状态码

GC（Garbage Collection）、栈与堆

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

一、堆（Heap）与栈（Stack）#

Heap（堆）和 Stack（栈）都在内存中，它们是同一块物理内存（电脑的 RAM）被划分出来的两个不同用途的区域。一个是快速自动回收的小区（栈），另一个是存放大对象、需要 GC 打扫的大区（堆）。

场景：你写了一个方法，叫买东西()：

Java

void 买东西() { 
 int 钱 = 1000; *// ← 这就是“栈”上的东西* 
 String 购物车 = new String("苹果"); *// ← 这就是“堆”上的东西*
 }

当你调用买东西() 这个方法时：

栈（上下铺）发生了什么？
- 系统立刻在栈上给你分配一个小空间。
- 把钱 = 1000 这个临时变量放进去。
- 方法开始执行……
- 方法一结束（买完东西了），栈上的钱 立刻自动消失，空间马上回收。
- 特点：快、自动、干净，像住酒店，退房就走。
堆（大小区）发生了什么？
- new String(“苹果”) 这句话会在堆上申请一个大房间。
- “苹果”这个对象就住在堆里。
- 即使买东西() 方法结束了，只要还有其他地方拿着“购物车”这个钥匙（引用），这个“苹果”对象就继续住在堆里。
- 只有当没有任何人再用它时，垃圾回收器（GC）才会过来把它清理掉。

特点	栈（Stack）	堆（Heap）
存放什么	基本类型变量、对象引用、方法参数	真正 new 出来的对象
内存大小	很小（几 MB 到几十 MB）	很大（几百 MB 到几十 GB）
分配和释放速度	非常快	较慢
是否有碎片	没有（严格按顺序进出）	有（会产生内存碎片，靠 GC 整理）
线程安全	每个线程都有自己的栈，互不干扰	所有线程共享一个堆，需要小心并发
出错时提示	栈溢出（StackOverflowError）	堆内存不足（OutOfMemoryError）
谁来清理	方法结束，系统自动清理	垃圾回收器（GC）自动清理

总结：

NoSql数据库

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

一、定义#

**NoSQL **的全称最早是 Not Only SQL（不仅仅是 SQL），意思是它不强制使用关系型数据库的 SQL 语法，而是提供更灵活的方式来操作数据。

我们不能在大多数 NoSQL 里直接复制关系型数据库的复杂 SQL（如带 JOIN、多表事务、外键约束等）。
但很多现代 NoSQL 提供了 SQL-like 或 SQL 兼容层，让熟悉 SQL 的开发者上手更容易。

二、特性#

**NoSQL **数据库被设计成天生支持分布式，这是它与传统关系型数据库（SQL）最大的区别之一

1. 分布式（Distributed）#

意思是：数据库不是跑在一台服务器上，而是自动分布在多台服务器（节点）上组成一个集群。
为什么需要分布式？
- 单台服务器的 CPU、内存、磁盘、网络总有上限（垂直扩展贵且有瓶颈）。
- 当数据量达到 TB/PB 级、并发达到百万级时，必须把压力分散到多台机器上。
NoSQL 的优势：
- 自动处理节点加入/退出、故障转移。
- 支持高可用（一台机器挂了，其他机器还能继续服务）。
- 读写性能可以随着机器数量线性增长。

2. 数据分片（Sharding / Data Partitioning）#

分片就是把一份大数据“切成小块”（shards），然后把这些小块分散存储到不同的服务器上。
怎么切？ 常见规则：
- 按键哈希分片（Hash Sharding）：根据用户ID、订单ID 等字段取哈希值，取模后决定放到哪个节点（最常用）。
- 范围分片（Range Sharding）：按时间、ID 范围划分（如 2025 年数据放节点A，2026 年放节点B）。
好处：
- 每个节点只管自己的一小部分数据，查询和写入更快。
- 容易水平扩展：数据太多？再加几台机器，系统自动把数据重新分片。
NoSQL 天生支持：MongoDB 有自动分片（Auto-Sharding），Cassandra 通过一致性哈希环实现分片，DynamoDB 完全自动管理分片。

3. 数据冗余（Data Redundancy / Replication）#

为了高可用，同一份数据会在多个节点上复制多份（通常 3 份或更多）。

使用外键的优劣

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

一句话总结就是：使用外键可以保证数据安全、一致，降低开发难度；但是在对于高并发、分布式的场景的场景，使用外键意味着每次的sql都会产生额外的外键检查，加大了数据库的负担，降低了速度。
实际开发中的做法: 开发环境 / 测试环境：加上外键，便于发现数据问题。

生产环境：
- 核心业务表（用户、订单、商品等强关联表）保留外键。
- 高并发、大数据量表去掉外键，在应用层或通过消息队列 + 定时任务保证一致性。
替代方案：
- 应用层校验 + 事务
- 数据库触发器（Trigger）（部分复杂场景可补充或替代外键的约束，但同样存在性能和维护成本）
- 异步任务 + 最终一致性（最常用高并发方案）
- 使用**软删除（soft delete）**避免真实删除带来的级联问题（增加一个字段来判断其是或否被删除）

Windows平台下AutoHotKey、PowerShell与VBScript的对比

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

首先来总结一下这三种脚本分别最适合的方向： AutoHotKey：桌面交互自动化

Powershell：系统管理与复杂自动化

VBSript：老旧系统兼容与极简操作

AutoHotKey#

最终目的：使用快捷键来简化人们的手动操作（如鼠标点击，键盘输入）。

使用方式：

首先下载AutoHotKey到我们的电脑上。

在本地按照AutoHotKey的语法编写完ahk脚本文件后，双击后，启动脚本文件，其加载后常驻后台，热键随时可用，几乎零延迟。

然后就可以使用快捷键来使用该脚本文件编写的任务。

具体任务：

可以自定义全局热键来实现任务（最常用的用途）。

例如：我编写了一个使用快捷键“ctrl+J”即可弹窗展来示目标任务的.ahk文件，编写保存完该脚本后，直接双击该脚本文件，然后可以在全局使用快捷键“ctrl+J”来调用脚本文件实现任务。

下面的所有任务，也都是编写脚本定义一个来执行该脚本的快捷键；双击该脚本后，该脚本就会常驻后台。然后使用快捷键执行任务。

重复操作自动化

例如：自动填写网页表单（固定输入账号 / 密码）；游戏 / 办公中重复点击某位置（也是使用自定义的快捷键来调用）

窗口精细化控制

例如：一键关闭所有弹窗；指定窗口置顶 / 隐藏 / 调整大小；多窗口分屏排列（如左边浏览器、右边记事本）。

轻量 GUI 小工具开发

例如：编写无编译的快捷启动面板（点击按钮打开不同工具）。

系统轻量操作辅助

例如：屏蔽键盘某按键；修改鼠标滚轮速度；自动切换输入法。

PowerShell#

使用方式：

无需下载，windows自带，在powershell终端输入命令使用，或者将整个文件保存为.ps1然后在终端使用./name.ps1命令来执行该powershell文件。

文件操作（类似于Linux中的文件操作）

例如：

找出桌面最近7天修改的文件并按大小排序：ls ~/Desktop -File -Recurse | ? { $_.LastWriteTime -gt (Get-Date).AddDays(-7) } | sort Length -Descending

批量改文件的后缀名
快速查看文件的内容
- 使用cat命令查看文件中固定行数的内容
- 找出所有 .ps1 脚本里包含 “api_key” 的行：
sls *.ps1 -Pattern "api_key" -List

文档 on Hardy Blog

curl命令

基本语法：#

常见用途：#

MCP Server

简单理解#

Next.js

具体体现：#

TailwindCSS与传统CSS

🎯 场景：创建一个用户卡片#

📝 传统 CSS 写法#

交互式 REPL

一个直观的类比：计算器#

与普通运行代码的区别#

OCR

简单解释什么是 OCR？#

“OCR语言设置”是什么意思？#

Transformer

① Transformer 是什么？#

② BERT 是什么？#

③ [CLS] 是什么？为什么会出现？#

uv、conda、python（venv）创建虚拟环境的区别

Python 自己的虚拟环境（venv）#

uv（强烈推荐了解的新工具）#

Conda（Anaconda / Miniconda）#

Api代理与反向代理

一句话区别#

🧩 一、API代理（正向代理）#

📌 场景理解#

🧭 流程#

🍔 类比#

📌 特点#

🧩 二、API反向代理（你刚刚问的那个）#

🧭 流程#

🍔 类比#

📌 特点#

⚔️ 三、核心区别对比#

💡 四、一个特别关键的理解（重点！）#

git知识

一、 命令#

rebase#

📖 详细原理拆解#

为什么 rebase 会改写历史？#

为什么普通 git push 会失败？#

HTT状态码

🟢 1xx Informational（信息性）#

🟢 2xx Success（成功）#

🟡 3xx Redirection（重定向）#

🟠 4xx Client Error（客户端错误）#

🔴 5xx Server Error（服务器错误）#

GC（Garbage Collection）、栈与堆

一、堆（Heap）与栈（Stack）#

NoSql数据库

一、定义#

二、特性#

1. 分布式（Distributed）#

2. 数据分片（Sharding / Data Partitioning）#

3. 数据冗余（Data Redundancy / Replication）#

使用外键的优劣

Windows平台下AutoHotKey、PowerShell与VBScript的对比

AutoHotKey#

PowerShell#

一、命令#

为什么 `rebase` 会改写历史？#

为什么普通 `git push` 会失败？#