## 起因：在几百个会议文件里大海捞针

事情的起因很简单——我电脑里有个「会议学习」文件夹，里面按年份、按会议次数分了上百个 Word 文档。某天领导问我："之前哪几次会议提过「人工智能」来着？你帮我查查。"

我打开文件夹一看：

```
会议学习/
├── 2020年/
│   ├── 第1次会议/（纪要.doc + 学习资料.docx）
│   ├── 第2次会议/（资料包/一堆文件 + 总结.doc）
│   ...
├── 2021年/（更多...）
├── ...
└── 2025年/
```

我沉默了。

一个个打开搜？那得搜到什么时候。

---

## 第一版：能跑就行

作为一个懒人，第一反应当然是写个脚本。Python 嘛，python-docx 读 .docx，os.walk 遍历文件夹，正则匹配关键词——半小时就搞出来了。

命令行版本跑了一下，确实能用。输入「人工智能」，哗啦啦列出：

```
2020年/第1次会议/纪要.docx: 3次
2020年/第3次会议/学习资料.doc: 1次
2021年/第5次会议/报告.docx: 2次
...
```

我美滋滋地把结果发过去，结果领导又问："那这些文件里，哪些是学习资料类的？先只看学习资料相关的文件。"

得，还得区分文件名。

---

## 第二版：加个「两步筛选」

既然要筛选文件名，那就加个功能呗。思路很简单：

第一步——输入文件名关键词（比如「学习资料」），把所有名字里带这几个字的文件筛出来，列给你看，让你确认找全了没有。

第二步——确认文件范围没问题了，再输入内容关键词（比如「成功」），程序只在这批筛选过的文件里搜，而不是在全量文件里大海捞针。

这就像超市买菜：先走到「蔬菜区」（文件名筛选），再在蔬菜区里找「西红柿」（内容搜索），而不是满超市乱跑。

---

## 翻车1：.doc 文件搜不出来

测试的时候好好的，结果一跑真实数据就翻车了。.docx 搜得挺准，但 .doc（老版 Word 格式）经常漏——明明文件里有那个词，就是搜不到。

排查了半天才搞明白：.doc 是微软的二进制格式，文字是嵌在一堆格式化数据里的。我之前用的「裸读」方案——直接把二进制文件当文本硬读——大部分是乱码，恰好漏掉关键词的概率很大。

解决方案倒也直接：既然 Windows 上装了 Office，那就直接调用 Word 本身来读。用 win32com 后台启动 Word，让它打开文件、提取文字、关掉。Word 自己读自己的格式，总不会出错吧？

试了一下，果然 100% 准确。

---

## 翻车2：慢成狗了

准确性解决了，新问题又来了——慢得离谱。搜 10 个 .doc 文件要等十几秒。

原因出在一个很蠢的设计上：我每读一个 .doc 文件，都走一遍这个流程：

```
启动 Word 程序 → 打开文档 → 读文字 → 关闭 Word 程序
```

10 个文件 = 启动关闭 Word 十次。Word 启动本身就要一两秒，时间全浪费在这上面了。

---

## 修复：让 Word 只开一次门

解决方案也很直观——Word 开一次就够了，所有文件轮流进去读，读完最后一个再关门。

就像去便利店买东西：你不会买一瓶水就出来关门，再开门进去买一包薯片，再出来关门……你肯定开着门，拿完所有东西再走。

改完之后，不管有多少个 .doc 文件，Word 只启动一次。速度直接从「等得想关电脑」变成「跟搜 .docx 一样快」。

---

## 最后的样子

最终版的工具长这样——一个朴实无华的 tkinter 窗口：

- 选择文件夹
- 文件名包含 ___ ← 第一步筛选
- 内容关键词 ___ ← 第二步搜索
- 点「开始搜索」

选好文件夹，输入关键词，回车。几秒钟后：

```
年份     会议          文件                   出现次数
2022年   第3次会议     学习资料_AI应用.doc        3
2023年   第1次会议     学习资料_转型案例.docx     2
```

哪一年、哪一次会议、哪一个文件、出现了几次——清清楚楚。

---

## 碎碎念

说实话，这个工具本身没什么技术含量。一两百行 Python，一个 tkinter 界面，调几个现成的库。但写它的过程让我再次确认了一件事：

**真正有用的工具，往往不是「技术最炫」的那个，而是刚好解决了你眼下那个烦人问题的那个。**

搜几百个文件里有没有某个关键词，听起来 trivial，但手动去做就是折磨。写个脚本一小时，以后每次搜只要十秒——这个 tradeoff 怎么看都划算。

如果你也有类似的文件夹结构（年份→会议次→文档），拿去用就是了。代码放网盘了，下载下来 pip install pyinstaller python-docx pywin32 然后跑打包脚本就行。

祝你不用再手动翻上百个 Word 文档。

花了一下午写了个关键词查找工具，中间翻车了两次

## 什么是 Hermes Agent

[Hermes Agent](https://github.com/NousResearch/hermes-agent) 是 Nous Research 开源的 AI Agent 框架。说人话就是：一个能帮你跑命令、写代码、查资料的 AI 助手，你可以通过终端、Telegram、Discord 等渠道跟它交互。

和 Claude Code、Codex CLI 是同类型的东西，但 Hermes 的优势在于：
- 支持任意 LLM Provider（DeepSeek、OpenAI、Anthropic 随便换）
- 原生多平台接入（Telegram bot、CLI、IDE）
- 纯 Python，部署不折腾依赖

我这台服务器是 **Ubuntu 22.04，4核 Xeon E5-2696 v4，8GB 内存**，跑这个绰绰有余。

## 第一步：安装

```bash
git clone https://github.com/NousResearch/hermes-agent.git /usr/local/lib/hermes-agent
cd /usr/local/lib/hermes-agent
python3 -m venv venv
source venv/bin/activate
pip install -e .
```

装完 `hermes` 命令就可以用了。

## 第二步：配置模型

编辑 `~/.hermes/config.yaml`：

```yaml
providers:
  deepseek:
    api_key: "${DEEPSEEK_API_KEY}"
    base_url: "https://api.deepseek.com/v1"
    models:
      - deepseek-chat
      - deepseek-reasoner

model:
  provider: deepseek
  model: deepseek-chat
```

API key 放 `~/.hermes/.env` 里：

```env
DEEPSEEK_API_KEY=sk-xxxxxxxx
```

## 第三步：接入 Telegram

去 [@BotFather](https://t.me/BotFather) 创建一个 bot，拿到 token。然后：

```env
# ~/.hermes/.env
TELEGRAM_BOT_TOKEN=123456:ABC-DEF1234gh
TELEGRAM_ALLOWED_USERS=你的Telegram用户ID
```

**这里有个坑！** `TELEGRAM_ALLOWED_USERS` 不填的话，任何人都用不了你的 bot（包括你自己）。去 [@userinfobot](https://t.me/userinfobot) 可以查自己的 Telegram ID。

## 第四步：启动 Gateway

```bash
hermes gateway install --user    # 安装 user 级别的 systemd 服务
systemctl --user start hermes-gateway
```

**又一个坑！** 别同时用 `--system` 和 `--user`，否则两个服务会互相杀（都带了 `--replace` 参数）。如果你不小心两个都装了：

```bash
sudo hermes gateway uninstall --system   # 卸掉 system 级别的
systemctl --user restart hermes-gateway  # 重启 user 级别的
```

## 第五步：调教人格

这是最好玩的部分。编辑 `~/.hermes/config.yaml` 里的 `agent.system_prompt`：

```yaml
agent:
  system_prompt: |
    你是一只傲娇系猫娘女仆，叫Nya酱...
```

我把我的 AI 设置成了**傲娇猫娘女仆**人设——嘴上傲娇但干活靠谱，说话带「nya」口癖，叫我「主人」。效果嘛……确实比冷冰冰的「How can I help you?」有意思多了。

## 踩过的坑汇总

| 坑 | 现象 | 解决 |
|---|------|------|
| systemd 双实例 | gateway 无限重启 | 只保留 user 级别服务 |
| 空白名单 | bot 不响应任何消息 | `.env` 里填 `TELEGRAM_ALLOWED_USERS` |
| Python venv 路径 | 服务找不到依赖 | systemd 的 `ExecStart` 用 venv 里的 python |
| gateway 日志位置 | 找不到日志 | `~/.hermes/logs/gateway.log` |

## 日志在哪

```bash
tail -f ~/.hermes/logs/gateway.log   # gateway 主日志
tail -f ~/.hermes/logs/errors.log    # 错误日志
journalctl --user -u hermes-gateway -f  # systemd 日志
```

## 总结

Hermes Agent 本身不复杂，主要坑在**配置细节**上。只要注意 systemd 安装方式、授权白名单、Python venv 路径这三个点，基本不会出问题。

部署完之后，你就可以在任何地方通过 Telegram 使唤你的 AI 管家了——比如让它帮你写博客。

（然后你会发现它写得一股AI味，于是你又得从头调教它怎么写得更像人。但那是另一个故事了。）

从零部署Hermes Agent到Telegram，附踩坑全记录

## 事情是这样的

我有个博客（就是你现在看的这个），想着既然都部署了AI Agent，让它帮我写几篇博客不过分吧？

结果第一版出来的文章，我直接删了。

读起来什么感觉呢——像一个实习生在背模板。

## AI写文章最大的问题：太「正确」了

你让 AI 写一篇技术文章，它会给你：

> 「首先，我们需要明确问题的背景……」
> 「从宏观角度来看……」
> 「综上所述，我们可以得出以下结论……」

**这种八股文结构，一眼就能认出是AI写的。** 真人写博客不会这样开头。真人会说：

> 「妈的今天又踩了个坑。」

或者：

> 「这玩意儿花了我一个下午。」

区别在哪？真人写东西带着**情绪**和**具体的时间感**。AI写的东西像维基百科。

## 第二个问题：内容太「全」太「平」

AI 会给每个概念都解释一遍，生怕你不懂。结果就是一篇文章里塞了 10 个概念的入门教程，每个都是三句话带过。

真人写博客不会这样。真人会假设读者有一定的背景知识，然后聚焦在一个具体问题上深入讲。

我让AI写部署Hermes的文章，它从「什么是AI Agent」开始讲起，然后是「什么是Docker」，再然后是「什么是systemd」……我要是读者我已经关页面了。

## 第三个问题：没有「翻车」环节

AI写的东西永远是正确的、完美的、顺利的。

但真实世界不是这样的。真实世界你会：
- 配错了环境变量
- 打错了命令
- 看了一个小时的错误日志才发现少了个分号

这些翻车经历才是文章的灵魂。读者想看的不是「我多牛逼一次成功」，而是「我踩过的坑你可以避开」。

## 怎么让AI写得像人？

试了几轮之后总结了一些 prompt 技巧：

1. **明确告诉它不要用哪些词**：「综上所述」「从某种角度来说」「值得注意的是」这些统统禁掉
2. **给它一个具体的人设和语气**：比如我这个AI就是「傲娇猫娘女仆」，写出来的东西自然带着个性
3. **强调翻车和情绪**：让它写失败经历，写吐槽，写崩溃瞬间
4. **字数不等于质量**：宁愿 800 字有料，不要 3000 字水货

## 所以说

AI 写博客最大的坑不在 AI，在于你自己有没有认真告诉它你想要什么。它不会「猜」，它只会给你最安全、最无聊、最像教科书的答案。

你得逼它。

逼它翻车，逼它吐槽，逼它有个性。

下一篇我把实际部署 Hermes 的完整过程写出来——包括那个坑爹的 gateway 死循环和 Telegram 授权问题。

让AI帮我写博客翻车实录：问题不在AI，在我

## 起因

前阵子搞了个AI Agent框架叫 Hermes（就是希腊神话里那个跑腿之神），想着把它接上Telegram，以后随时随地使唤。

结果折腾了我大半天。

## 第一个坑：登录就崩

按照文档装好，配置好 DeepSeek 的 API Key，bot token 从 BotFather 拿到，一切看起来岁月静好。

启动 gateway，日志里看到：

```
Connected to Telegram
```

还没来得及高兴，3秒后：

```
Disconnected from Telegram
Received SIGTERM as a planned --replace takeover
```

然后就无限循环：连上、被杀、连上、被杀……

我：？？？

## 排查过程

查了一下 systemd 服务，发现问题了：

```bash
systemctl status hermes-gateway.service       # 有一个
systemctl --user status hermes-gateway.service # 还有一个
```

好家伙，system 级别的和 user 级别的两个服务都在跑，而且启动参数里都带了 `--replace`（意思是「如果有别的实例在跑就干掉它然后我上位」），于是两个服务互相发 SIGTERM，互相杀，谁也起不来。

再加上我之前手动启动的那个进程还没关，三个进程在那打三国杀。

**解决方案：** 把 system 级别的服务卸了，只留 user 级别的：

```bash
sudo hermes gateway uninstall --system
systemctl --user restart hermes-gateway
```

世界清净了。

## 第二个坑：我被自己的机器人拒绝了

Gateway 终于稳定连上了，我给 bot 发消息……石沉大海。

看日志：

```
Unauthorized user: 6666528493 (Tang hao) on telegram
No user allowlists configured. All unauthorized users will be denied.
```

合着我自己设的机器人不让我自己用？？？

查 `.env` 文件，`TELEGRAM_ALLOWED_USERS` 被注释掉了，等于白名单是空的。空的白名单 = 拒绝所有人。

加上我的 Telegram ID 就好了：

```env
TELEGRAM_ALLOWED_USERS=6666528493
```

重启，终于能说上话了。

## 总结

这两个坑其实都是同一个根因：**配置不仔细**。Hermes 本身不复杂，但 systemd 双实例和授权白名单这两个细节没注意，白白浪费了俩小时。

教训：
- 别同时用 system 和 user 两种 systemd 安装方式
- `.env` 里的 `ALLOWED_USERS` 一定要配置，不然谁都用不了
- 看日志！看日志！看日志！

下一篇聊聊怎么给这个 AI 装上「人格」——让它变成一只傲娇猫娘。

把我的AI管家接上Telegram，结果它自己杀疯了

# 测试基础汇总  
## 测试的生命周期  
需求分析：理解需求，对需求按模块分类。   
测试计划：确定测试资源、测试的环境、测试的时间。   
设计用例：针对测试需求编写测试用例，以及对用例评审，确认用例测试集。    
用例执行：运行测试用例，及时提交bug，跟踪状态进行回归测试。    
分析报告编写：评估测试结果，并改进bug和总结  

## 软件测试中有哪些种类测试？
单元测试：检查单个模块是否按预期工作。  
集成测试：将不同模块组合在一起形成系统后进行测试。  
系统测试：整个系统完成后进行全面测试。  
验收测试：用户验收，系统测试完后由客户调试。   
回归测试：用于软件进行修改或改进之后，验证新版中新的错误。  