搭了什么#

• AstroPaper 7.1.0 / Astro 7.4.5，Node 24、pnpm，语言 zh-CN、时区 Asia/Shanghai。
• 分仓库：源码在私有仓库 blog-source，构建产物在公开仓库 cleeate.github.io。免费版 GitHub Pages 只能从公开仓库发布，源码私有、产物公开是最干净的做法。旧测试站 blog-astro（AstroPaper v5）的两篇文章迁了过来，旧仓库没动。
• 部署链：推一次源码库 main，Action 构建后把 dist/ 推到输出库，再由输出库的 Pages 工作流发布。

构建时修的两个问题#

1. 动态 OG 图被关掉了。 satori 生成中文标题的 OG 图时会挂起构建，改用静态 default-og.jpg。
2. RSS 构建报错 MissingLocale。 astro.config.ts 里把 i18n locales 设为 zh-CN/en、默认 zh-CN 之后通过。

滚动位置 bug：两次修复才确认#

上线后发现一个问题：用浏览器前进、后退离开文章页再回来，总是回到文章顶部，而不是之前读到的位置。

原因是文章页里有一段上游主题带过来的代码，在每次页面切换后无条件执行 window.scrollTo(0, 0)。而 Astro 的 ClientRouter 本来会在前进、后退时恢复滚动位置，这段代码把恢复好的位置又覆盖回了顶部。

• 第一版修复：只在前进导航时滚回顶部，后退时不动。部署后实测没起作用。
• 第二版修复：把那段监听整个删掉。ClientRouter 本来就负责这两件事：前进滚到顶部，后退恢复位置，不需要主题再补一段。

但第二版实测一开始也显示失败。最后发现问题在测试方法上：站点头部不是吸顶的，滚到一半时 logo 已经滚出屏幕，要点它得先滚回顶部，而这一滚就把保存的位置改成了 0，回来自然是顶部。换成干净的测法——滚到中间后只按浏览器后退、前进，不点链接也不滚动——位置分毫不差，y=1996，两次都一样。

顺带一个结论：如果你平时是滚回顶部再点导航离开文章，那回来是顶部就是浏览器本身的行为，因为离开那一刻存的就是顶部位置。直接用浏览器前进、后退键，才能回到之前读到的地方。

部署链上的一个坑#

输出库的部署用 force_orphan 强制推送，会把整个分支替换掉。第一次推送后，输出库里的 Pages 工作流文件 .github/workflows/pages.yml 被清掉了——部署用的 action 默认排除 .github 目录。这样下次部署就没人触发 Pages 发布，网站会停在旧版本。

修复办法：源码库里留一份 .github/pages-output.yml 做源头，部署时拷进 dist/.github/workflows/pages.yml，并把 exclude_assets 设为空，让 .github 能一起推过去。

收尾#

排查滚动问题时临时加过一个调试框（左下角绿字，实时显示滚动位置和路由方向），确认结论后已经从源码里删掉。这篇就是新博客的第一篇原创文章。

前置条件#

1. 一个已经能用的 Hermes 实例。你可以从 hermes-agent.nousresearch.com 下载和安装。它不需要特殊的依赖，只要 Python 环境即可。
2. 一个 Telegram 账号。
3. 一个 Telegram Bot 的 Token。没有的话，先给 @BotFather 发消息 /newbot，按提示创建即可。

配置 Telegram 频道#

Hermes 的设定非常灵活，但最核心的步骤是把 Telegram 加到 config.yaml 的 platform 配置里。把下面这一小段配置粘贴到 config.yaml 中对应的区域：

1
platforms:
2
  telegram:
3
    bot_token: "你的BOT_TOKEN"
4
    admin: "你的CHAT_ID"

从技术上讲，Chat ID 是你想接收通知的频道或私聊。

验证#

配置好之后，直接向你的 Bot 发消息。如果一切正常，Hermes 会把结果通过对话频道返回。

总结#

Hermes 的价值只有一个：你想在 Telegram 里实现的控制能力。它支持 Monday、Friday、crontab 等各种定时任务，剩下的事情只需要通过 Bot 发消息即可。

配置非常简单，几步之后你就能在 Telegram 里指挥 AI 干活了。

避坑总览：先看这五条#

1. 小内存先加 Swap，再装 DSH。 不加 Swap，npm 安装 DSH 时很容易被 OOM killer 杀掉，表现为安装莫名中断、dsh 命令缺失、服务起不来。
2. 不要装旧的 dsh-telegram。 新版教程用的是 @xmanrui/dsh-im，两者不要混装。
3. Token 只走 DSH 设置界面。 不要把 Bot Token 写进 cordis.patch.yml、settings.yaml 或任何会被提交的文件。
4. 私聊一定要开白名单。 dsh-im 默认对所有私聊开放，不设白名单等于谁都能指挥你的机器人。
5. 模型选错是最高频的报错来源。 要 Key 的官方模型、要 GitHub 授权的 EAC 模型、免密的 Kilo 免费池，这三类不要混着选。

一、服务器准备#

1
hostnamectl set-hostname b2

1
127.0.1.1 b2

1
free -m        # 查看内存与已有 Swap
2
df -h          # 确认根分区剩余空间大于 2GB

1
fallocate -l 2G /swapfile
2
chmod 600 /swapfile
3
mkswap /swapfile
4
swapon /swapfile

1
echo '/swapfile none swap sw 0 0' >> /etc/fstab
2
sysctl vm.swappiness=10
3
echo 'vm.swappiness=10' >> /etc/sysctl.conf

1
apt update
2
apt install -y curl ca-certificates gnupg git

二、安装 Node 和 DSH#

用 NodeSource 装 Node 22：

1
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
2
apt install -y nodejs
3
node -v
4
npm -v

实测版本：Node v22.23.4、npm 10.9.9。

全局安装 DSH，并补装 pnpm（插件安装需要它，缺了会报 pnpm 未找到）：

1
npm install -g @deepseek-ai/dsh
2
npm install -g pnpm
3
dsh --version

实测 DSH 版本：0.2.1-rc.5。

长耗时安装建议脱离 SSH 会话运行，例如用 setsid / nohup 后台跑，避免 SSH 断线把安装进程一起带走。SSH 偶尔出现 banner 交换超时，多半是网络抖动，先重试，不要轻易判定服务器挂了。

三、安装免费模型插件和 IM 插件#

1
dsh plugin --profile web add github:Ebony-Vinyl/dsh-our-free-model

1
dsh --profile web --dump-config

1
dsh plugin --profile web add -w @xmanrui/dsh-im

1
@deepseek-ai/dsh-base
2
@deepseek-ai/dsh-web-app
3
dsh-our-free-model
4
@xmanrui/dsh-im

四、用 systemd 跑 DSH，不要对外暴露 Web UI#

教程本身只要求前台跑 dsh --profile web，但为了让机器人 survives 重启，建议写一个 systemd 服务。关键点：Web UI 只监听本地，Telegram 走长轮询，不需要开放任何入站端口。

/etc/systemd/system/dsh.service 示例：

1
[Unit]
2
Description=DSH Telegram Agent
3
After=network-online.target
4
Wants=network-online.target
5

6
[Service]
7
Type=simple
8
User=root
9
WorkingDirectory=/root
10
Environment=DSH_HOME=/root/.dsh
11
Environment=HOME=/root
12
ExecStart=/usr/bin/dsh --profile web
13
Restart=always
14
RestartSec=10
15

16
[Install]
17
WantedBy=multi-user.target

启动并验证：

1
systemctl daemon-reload
2
systemctl enable dsh
3
systemctl start dsh
4
systemctl status dsh --no-pager
5
ss -tlnp | grep -E '3080|8326'

正常情况下服务是 active，且 3080、8326 只出现在 127.0.0.1 上，不要在防火墙或安全组里放行它们。

五、绑定 Telegram 机器人#

1. 在 BotFather 创建机器人，拿到 Bot Token，记好但不要发到公开场合。
2. 打开 DSH 的「设置 → IM机器人」，选择 Telegram，粘贴 Token 并保存。
3. 务必开启私聊白名单模式，填入自己的数字 USER_ID，例如：

1
<你的数字 USER_ID>

只放你一个人。群聊默认是开放模式，如需收紧要另外设置，不要以为开了私聊白名单群聊就自动安全了。

绑定成功后，机器人应显示已连接、长轮询正常。绑定信息保存在 ~/.dsh/integrations/dsh-telegram/，Token 在里面是引用形式，不是明文，但这不等于可以把该目录公开分享。

六、模型选择避坑：这是本次部署最关键的一节#

dsh-im 的模型列表里混了三类模型，选错就会报错：

正确做法：把默认模型写进 ~/.dsh/profiles/web/cordis.patch.yml 的 agent-default-model：

1
- id: agent-default-model
2
  name: "@deepseek-ai/dsh-agent-default-model"
3
  config:
4
    provider: our-free-model
5
    model: kilo-auto/free
6
    reasoningEffort: high

改完重启服务：

1
systemctl restart dsh
2
systemctl is-active dsh
3
dsh --profile web --dump-config | grep -A4 agent-default-model

重要：改完模型一定要在 Telegram 里先发 /new 开新会话，再发正常消息。 旧会话还钉在旧模型上，不换会话，报错会继续出现。这一步最容易被忽略。

七、验证清单#

按顺序全部通过，才算部署完成：

• systemctl status dsh 是 active
• 3080、8326 只监听在 127.0.0.1
• Telegram 发 /start 有回复
• Telegram 发 /status 能看到会话和模型
• Telegram 发 /new 后，再发一句正常消息能正常回复
• 没有出现“任务结果未确认”“内部未知错误”之类的提交失败提示

八、常见问题#

Q：npm 安装 DSH 装到一半就没了，dsh 命令也不存在？ A：先看内存和 Swap，十有八九是 OOM killer 杀了 npm。按第一节补 2GB Swap 再重装，不要反复在没 Swap 的机器上硬装。

Q：插件安装报 pnpm 未找到？ A：先全局装 pnpm 再装插件。

Q：/start 失败，提示缺少凭据？ A：会话默认模型走了 DeepSeek 官方渠道，但你没配 Key。按第六节把默认模型改成 Kilo 免费池，再 /new。

Q：正常消息报 401，要 GitHub 授权 star 仓库？ A：你选到了 EAC 模型。换回 kilo-auto/free，再 /new。不要尝试绕过 EAC 的授权闸门。

Q：改了模型还是报错？ A：先确认你是不是还在旧会话里。/new 之后再测一次；同时用 journalctl -u dsh --no-pager | tail -n 100 看服务日志，用 Telegram 的 /status 看当前会话到底用的是哪个模型。

Q：SSH 经常断，b2 是不是挂了？ A：不一定。先重试连接，再看服务状态。长安装一定要脱离 SSH 会话跑，断线才不会中断安装。

九、发布前的安全提醒#

• 不要把 Bot Token、服务器密码、API Key 写进教程、截图或代码仓库。
• 数字 USER_ID、白名单、机器人用户名在公开发布时建议用占位符或打码。
• Web UI 只监听本地是刻意为之，不要为了图方便把它暴露到公网。