# 霓虹21点玩法指南——从一个21点游戏变成赛博肉鸽卡牌的失控过程

我本来只想做一个21点。

发牌，要牌，停牌，比大小。没了。

后来不知道哪根筋搭错了，开始往上加东西：先加了个血条，然后加了战斗卡牌，然后加了芯片系统，然后加了牌库构筑，然后加了三个BOSS和一个隐藏BOSS。现在这个游戏有33张牌的牌库、五种类型的战斗卡牌、10个芯片槽、抽卡池、以及一堆我自己都经常忘掉的隐藏机制。

地址在这：[tiaotiaohu0516.cn:5001](http://tiaotiaohu0516.cn:5001)。

你说这篇文章算什么？算是使用指南吧——教你怎么玩，顺带告诉你哪些地方可能出BUG，因为那些BUG都是我亲手写出来的。

---

## 和传统21点不一样的地方

最本质的区别：你有血条，AI也有血条。默认都是10HP。

每一回合，你跟AI各玩一轮21点。输的人扣血。扣多少取决于几件事：你的芯片有没有+基础伤害、有没有触发黑杰克（天然21点伤害翻倍）、以及对面有没有护盾扛着。

打完一局的标准流程：进战斗→每回合抽3张战斗卡牌→你出牌/要牌/停牌→AI操作→结算→扣血。谁先归零谁输。

回血手段少得可怜。只有个别战斗卡牌能回血，或者特定芯片被动能吸一点。所以你打的每一局都像在走钢丝——这也是为什么标签里有个「肉鸽」。

---

## 战斗卡牌——让我后悔又上瘾的功能

这是整个游戏复杂度爆炸的根源。

战斗卡牌有五种：

**伤害牌**（6张）。直接扣对面血，或者让下回合伤害翻倍。需要消耗能量。

**防御牌**（5张）。给你加护盾，或者让对面下一击伤害减半。

**技能牌**（17张）。在21点桌面上搞事情——锁对面一张牌不让要、强制对面停牌、弃掉自己所有手牌重抽、偷看对面底牌等等。

**能量牌**（5张）。使用不消耗能量，反而加能量。能量是你每回合打战斗牌的「费用」，初始3点，每回合回满。

**传奇牌**。只能从抽卡池出，效果离谱。比如「数据湮灭」直接炸对面手牌。

每回合能打多少张牌取决于你的能量池。伤害牌一般费2-3能，防御牌费1-2能，技能牌费1-4能。所以牌序很重要——你可能需要先打能量牌攒费，再甩伤害牌。也可能对面已经19点了你得赶紧打「强制停牌」锁住他。

### 我修过的两个牌相关BUG

**「校验和」这张牌**——描述是「弃掉所有手牌并重抽」。初版有个问题：如果你已经爆牌了（超过21点），用了这张牌确实把手牌清空了，但`playerBust`这个状态变量忘了重置。结果就是牌桌干干净净，游戏却觉得你已经输了，没有按钮给你按。画面就卡在那里，你只能刷新重来。

修法就是把那个布尔值改回false。一行代码的事。但我发现这个BUG花了两周——因为我自己玩的时候从来不会在爆牌之后才用这张牌。

**另一个是护盾+99的烂活**。说出来你可能不信——我当时为了标记「伤害吸收」和「伤害反射」这两张牌是否生效，用了这个操作：给护盾临时+99。对。用护盾数值当标记变量。写的时候心想「护盾反正有上限，99就是个标志位」。但我忘了护盾上限是后来才加的补丁。第一版里护盾可以无限堆，这+99就变成了真·护盾——你打一张吸收牌，对面打你，你掉0血，因为你有99护盾。

后来把这段删了，用独立的`_absorbUser`和`_reflectUser`变量来追踪状态。这属于典型的「半夜写代码写的什么玩意儿」系列。

---

## 芯片——抽卡+被动技能

每打完一局你会拿到一些「废料」，拿去抽卡池。卡池里能抽出两种东西：**芯片**和**传奇战斗卡牌**。

芯片有10个槽位可以装备，提供各种被动效果。举例：

- 基础伤害+：你每回合保底伤害从1变成2、3、甚至4
- 自动护盾：回合开始自动加1-3护盾。这个我单独讲
- 抽牌+1：每回合战斗牌从3张变4张
- 能量上限+：从3能变4能或5能
- 穿刺：打对面时无视护盾
- 吸血：造成伤害回复等量血量
- 暴击率+：提升暴击概率（暴击伤害翻倍）

有意思的是组合。穿刺+暴击=无视护盾的双倍伤害。穿刺+吸血+基础伤害=打多少吸多少。抽牌+1+能量上限=每回合能打更多牌。这里面的策略空间比看起来大。

### 自动护盾的翻车

自动护盾这个被动，最初没有上限。

想象一下：你跟AI磨了50个回合，每回合自动+2护盾。你的护盾变成了114点。AI打你，跳出来一个-6的数字，然后护盾从114变成108。你全程没掉过血。

这个BUG的修法本身不值一提——加个`Math.min(shield, 15)`。但值得说的是**它为什么藏了那么久**。因为我测试的时候从来没活过15回合。AI前期伤害太高了，我根本拖不到护盾堆起来。是后来一个玩得比我好的朋友跟我说「你这游戏可以无限拖回合啊，我护盾三百多了」，我才知道有这个问题。

教训就是：你永远不知道玩家怎么玩你的游戏。尤其是当玩家比你玩得好。

---

## 牌库构筑——33张牌你自己配

在主菜单点「装备芯片」，左边有个牌库编辑器。

默认牌库33张，你可以加减卡片来调整策略。限制是：每种卡最多带2张，传奇只能靠抽，总数必须≥33才能进战斗。

你可以组：
- 全伤暴力流——12张伤害牌+一堆能量牌，每回合砸对面脸
- 控制流——锁牌+强制停牌+偷看底牌，不让AI好好玩
- 乌龟流——护盾+吸血+防御牌，跟你慢慢磨

编辑器本身挺简陋的，加减卡片、看统计。够用就行，反正我也懒得做UI了。

### 牌库缩水BUG

早期有个问题：打完一局回主菜单，手上和弃牌堆的卡不会回收。你打5局之后33张牌库变成7张。打开编辑器以为游戏出BUG了——「我的牌呢？」

其实不是丢了，是没回收。在`backToTitle()`里加了个`recoverDeck()`调用把所有牌洗回牌库就好了。这个BUG藏得深的原因同上——我开发的时候每局开新档测试，从来没连续打过多局。

---

## 主脑——隐藏BOSS

游戏有三个阶段的AI：

**哨兵**——基础AI。普通21点策略，偶尔丢张伤害牌。新手村。

**执行者**——要牌更激进，伤害牌更多，有时会锁你牌。

**主脑**——打败前三个对手之后解锁。它会精准计算——你接近21点的时候它直接停牌等你爆，你牌小的时候它猛攻。打它没有必胜策略，纯看牌运和芯片积累。

主脑的解锁有一个早期BUG：检查逻辑只在游戏初始化时跑一次。如果你一局内连续打赢三个BOSS（而不是退出重进），主脑永远不会解锁。因为`tryUnlockMainframe()`的调用时机不对。现在改成了每次击败对手后实时检查。

---

## 手机端——从完全不能用到勉强能玩

这个游戏最开始是给电脑做的。大屏、鼠标悬停、小字密集——全是桌面端思维。

放到手机上第一版：你往下划一下，浏览器给你刷新了。游戏没了。从头开始。

后来花了很长时间搞手机适配，总结下来几个核心问题：

**下拉刷新**——移动浏览器的默认行为。解决办法：`html, body`加`overflow:hidden`和`position:fixed`，然后用`#app`容器独立滚动。光靠CSS的`overscroll-behavior: none`不够，iOS Safari不吃这一套。

**长按弹菜单**——浏览器默认的长按会弹「复制/选择」菜单。解决：禁止`contextmenu`事件、禁止`selectstart`事件、CSS加`-webkit-touch-callout: none`。三层防。

**标题按钮看不见**——这个最搞笑。我设的颜色是`rgba(0,255,204,0.06)`——不透明度6%。在黑色背景上约等于没有。我写的时候还觉得「赛博朋克嘛，若隐若现多酷」。发给朋友测试，对方：？？你游戏在哪。

**终端滚动**——标题画面有个打字机终端，手机上滑不动。原因是`touchstart`事件里写了`preventDefault()`阻止了浏览器的滚动行为。删掉就好了。

我现在给自己定的规矩：**所有手机端改动必须锁在`@media (max-width: 700px)`里面**。绝对不动桌面端全局的CSS和JS。否则改手机端一定会搞坏桌面端，没有例外。

---

## V17才加的戰鬥特效

这个游戏做到V16的时候还是纯数字跳。V17终于加了一整套视觉反馈：

伤害数字从目标身上飘起来（暴击的更大更亮）、护盾格挡有蓝色波纹、平局有金色全屏闪、攻击方会闪一下并抖动。

实现方式很简单：`dealDamage`函数不直接创建DOM，而是往数组里push特效规格。等`resolveRound`全部算完之后，延迟80ms一次性渲染。这样不会在逻辑计算中途插DOM操作。

唯一的小问题：如果护盾完全吸收了伤害（实际伤害=0），VFX会生成一个「-0」的伤害数字。看着像个表情包。修法是加了`if (dmg > 0)`。

---

## 存档

用浏览器的`localStorage`，键名`neon21_v2_save`。每回合结算后自动存。

存的东西：牌库组成、弃牌堆、已装备芯片、抽卡保底计数、全局属性。

桌面端左下角有个💾按钮手动存。手机端底部栏也有。读档的时候如果牌库不足33张会自动补默认牌。

---

最后说两句实话。

我做这个游戏没有任何宏大的目标。就是想看看纯前端（HTML+CSS+JS，零框架）能做一个多复杂的游戏。结果越加越多，变成现在这样。

修BUG的过程比我写功能的时间还长。每当我以为「这次肯定没问题了」，就会有人发现一个新的玩法路径把我代码里的漏洞暴露出来。拖50回合的、打完不回收牌库的、手机上各种诡异手势的——我永远在修我没想到的BUG。

如果你上去玩遇到什么问题，那大概率又是我没想到的坑。

地址：[tiaotiaohu0516.cn:5001](http://tiaotiaohu0516.cn:5001)。所有数据存你浏览器里，换设备就没了。

玩得开心——或者说，玩得比我开发的时候开心就行。


霓虹21点玩法指南——从一个21点游戏变成赛博肉鸽卡牌的失控过程

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

事情的起因很简单——我电脑里有个「会议学习」文件夹，里面按年份、按会议次数分了上百个 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 装上「人格」——让它变成一只傲娇猫娘。