Automatic Gemini API key rotation for modlens on DeepSeek Harness (dsh) — when one key hits its quota (HTTP 429), the read
automatically switches to the next key in the pool and retries, with zero
intervention. Works everywhere modlens reads an image: the dsh GUI paste flow,
the modlens_read_image tool, and the CLI.

⚠️ Unofficial: this patches the installed modlens package. The patch is
wiped by any modlens upgrade; patch.ps1 re-applies it in one command.
If modlens upstream ever ships native multi-key support, drop this project.

Why

modlens reads images through a single Gemini API key stored in ~/.modlens/config.json. Free-tier keys hit daily quota (429 RESOURCE_EXHAUSTED) / rate limits quickly, and modlens has no retry or
failover for that. This project adds:

• a key pool (~/.modlens/api-keys.json) — list, add, rotate, inspect
• an engine patch — 429 triggers an automatic switch to the next pool key,
  persisted to the config, then a retry of the same request (up to 8 rotations)
• a CLI wrapper — 429 → rotate + retry; 5xx → backoff retry on the same key
• a re-patch script — re-applies the engine patch after a modlens upgrade

Requirements

• DeepSeek Harness (dsh) with the modlens plugin installed: npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modlens@<version>
• Node 22.19+ (modlens requirement)
• PowerShell (Windows) — the scripts are .ps1

Install

Clone this repo (or copy scripts/), then:

1
2
3
4
5
6
7
8
9

# 1. copy scripts next to the modlens config
Copy-Item scripts\* "$env:USERPROFILE\.modlens\"
# or link: New-Item -ItemType SymbolicLink ... (per-file)

# 2. apply the engine patch (idempotent)
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.modlens\patch.ps1"

# 3. seed the key pool (one command per key)
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.modlens\rotate.ps1" add <GEMINI_API_KEY>

The active key is the one modlens uses: if you already configured a key via modlens config set gemini-api.apiKey, add it to the pool too so rotation can
cycle back to it.

Usage

1
2
3
4
5
6
7
8

# manage the pool
rotate.ps1 list                          # show pool, >> marks the active key
rotate.ps1 status                        # pool size + active key (masked)
rotate.ps1 rotate                        # switch to the next key (persists)
rotate.ps1 add <key>                     # add a key to the pool

# read an image with automatic rotation
ml.ps1 -Image <path-or-url>

The engine patch makes rotation automatic for every read path (GUI paste, modlens_read_image tool, CLI), so rotate.ps1 rotate is mainly for manual
override or diagnosis.

If you use a proxy

modlens itself supports it — no changes needed here:

1

modlens config set proxy http://127.0.0.1:<port>

Note: Google’s Gemini API is region-restricted. A proxy exit in an unsupported
region (e.g. mainland China, Thailand) fails with 400 User location is not supported for all keys — rotation cannot fix
that; switch the proxy node instead.

After a modlens upgrade

1

powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.modlens\patch.ps1"

It detects whether the patch is still present; if a new version changed the
targeted code and the hunks no longer match, it reports which hunk failed and
tells you to file a new patch.

How it works

modlens ships two components in one package:

• dsh/index.js — the dsh plugin shell: registers modlens_read_image,
  handles paste-to-path. It contains no image-reading logic; it spawns a
  child process running the CLI engine.
• dist/main.js — the CLI engine: reads the image, calls Gemini
  (executeGeminiApi), parses structured JSON. Every read path funnels
  through this file.

The patch lives in executeGeminiApi: a single request becomes a loop that
rotates the pool on 429. See PATCH.md for the exact change.

Security

• Keys are stored in plain text at ~/.modlens/api-keys.json (same trust
  level as modlens’s own config.json, which also stores the key in plain
  text). Do not share your home directory.
• This repo contains no keys, no credentials, no machine-specific paths —
  all paths derive from $env:USERPROFILE.

Credits & license

• modlens by Leon Liu (liustack) — the vision engine this project wraps and patches. MIT licensed
  (Copyright © 2026 Leon Liu), see LICENSE.modlens.
  The patch hunks in this repo are a derivative modification of modlens
  source and carry its MIT notice as required.
• This project is not endorsed by upstream — it is an independent utility
  that depends on modlens.
• Our own scripts and docs: MIT (see LICENSE).
• Full attribution: ACKNOWLEDGMENTS.md — please star
  the upstream project, the real work lives there.

修复 OpenViking 在 Windows + 本地向量库 + 本地 embedding 模型 组合下，记忆文件已生成但搜索不到的问题。

问题现象

• OpenViking 服务可以正常启动
• 记忆文件可以正常生成
• 但执行搜索时返回空结果

1

ov find "LoopingIsle" --context-type memory

返回：

1
2
3
4
5
6
7
8
9

{
  "ok": true,
  "result": {
    "memories": [],
    "resources": [],
    "skills": [],
    "total": 0
  }
}

服务日志出现：

1
2

openviking.storage.viking_vector_index_backend - ERROR - Error reading existing record before partial update: Strings must be encoded before hashing
openviking.storage.collection_schemas - ERROR - Failed to write to vector database: Strings must be encoded before hashing

根本原因

OpenViking 在把字符串 ID 转成 64 位整数时，使用了：

1

xxhash.xxh64(input_string)

但 xxhash 在 Python 3 中要求传入 bytes，不能直接传入 str，因此抛出：

1

Strings must be encoded before hashing

这导致：

• 记忆 Markdown 文件正常写入
• 向量没有成功写入向量库
• 所以记忆文件存在，但语义搜索找不到

修复

修改文件：

1

openviking/storage/vectordb/utils/str_to_uint64.py

修改前：

1
2

def str_to_uint64(input_string: str) -> int:
    return xxhash.xxh64(input_string).intdigest()

修改后：

1
2

def str_to_uint64(input_string: str) -> int:
    return xxhash.xxh64(input_string.encode("utf-8")).intdigest()

补丁文件

使用方法

方法一：Git apply

1

git apply patches/0001-fix-str_to_uint64-xxhash-encoding.patch

方法二：PowerShell 脚本

1

powershell -ExecutionPolicy Bypass -File patches\patch-openviking-xxhash.ps1

修复后重新索引

1
2

ov reindex viking://user/default/memories --mode semantic_and_vectors --wait true
ov find "LoopingIsle" --context-type memory

环境

为什么很多人没遇到

这个 bug 主要在以下组合下出现：

• Windows
• Python 3.14
• 本地向量库
• 本地 GGUF embedding 模型

大多数用户使用的是：

• Linux + Docker
• 云端 embedding API
• 云端/托管向量数据库
• 较旧的 Python 版本

所以这条本地路径测试覆盖较少。

额外注意

如果只是移动了 OpenViking 目录导致向量库元数据路径不匹配，可以在配置中加：

1
2
3
4
5

{
  "embedding": {
    "allow_metadata_override": true
  }
}

前提是模型没有换、维度没有变。

有始有终，值得好评。

虽然后面有点赶，但感觉把想呈现的效果都呈现了。

就像看了一段也许真的存在的冒险。人物的变化和成长也悄然地推进，不突兀挺好。

原本是单人游戏，但我是跟朋友一起用合作模式通的关。

对于多人体验而言，如果不是多人游戏荒了，不建议把这游戏作为首选项。

各种解密和动作体验中规中矩，在2026年下，没有啥新鲜内容。

各种互动还算不错，动作有些僵硬。

剧情方面中等偏上水准。

值得一提的是，在剧情的最后，当主角处在一个特殊状态下时，一开始无法正确地前往目的地，当我以为附近有什么谜题时，突然脑子里意识到了一个新的可能性，当我把这个可能性告诉我朋友，并真的成功时，当时带给我的尤里卡时刻，还是非常震撼的，并且这个设计也十分符合剧情和玩法，让游戏的机制玩法解释了剧情，让剧情和体验更上了一层楼。甚至我有点怀疑，作者是因为这个时刻，才做了这么一款游戏。

准备工作

在开始之前，请确保你具备以下条件：

• 一台 Linux 服务器：本文以 Ubuntu为例。

• 一个公网 IP：确保你的服务器拥有独立的公网 IP，或已做好端口映射。

• 开放防火墙端口：确保服务器防火墙和云服务商的安全组放行以下端口：

许可证说明：TeamSpeak 3 对非商业用途免费，内置 1个虚拟服务器 和 32个在线用户 的限制，对绝大多数私人团队来说完全够用。

开始安装

系统更新与创建用户

为了安全，我们强烈建议不要使用 root 账号运行 TS3 服务。

更新系统

sudo apt update && sudo apt upgrade -y

创建一个名为 teamspeak 的系统用户

sudo adduser teamspeak

切换到该用户

su - teamspeak

下载服务端软件

进入用户目录，并从官网下载最新版服务端（请以官网最新版本号为准）：

cd /home/teamspeak

下载服务端压缩包 (以 3.13.7 版本为例)

wget https://files.teamspeak-services.com/releases/server/3.13.7/teamspeak3-server_linux_amd64-3.13.7.tar.bz2

解压

tar -xjvf teamspeak3-server_linux_amd64-*.tar.bz2

启动服务器

进入解压后的目录，接受许可协议并启动：

cd teamspeak3-server_linux_amd64

创建同意许可协议的文件

touch .ts3server_license_accepted

启动服务器

./ts3server_startscript.sh start

🚨 关键步骤：保存管理员令牌

首次启动时，终端日志中会显示两行极其重要的信息：

ServerAdmin privilege key created, please use it to gain serveradmin rights for your virtualserver.
token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

请立即复制并保存这个 token（令牌）。如果你关闭了终端，将无法找回，只能清空数据重新初始化。

设置开机自启 (Systemd)

为了确保服务器在重启后自动运行，我们可以将其注册为系统服务。

创建服务文件 (需要 root 权限)：

sudo nano /etc/systemd/system/teamspeak3.service

粘贴以下配置 (注意将 /path/to 替换为你的实际绝对路径)：

[Unit]
Description=TeamSpeak 3 Server
After=network.target
[Service]
User=teamspeak
Group=teamspeak
WorkingDirectory=/home/teamspeak/teamspeak3-server_linux_amd64
ExecStart=/home/teamspeak/teamspeak3-server_linux_amd64/ts3server
ExecStop=/home/teamspeak/teamspeak3-server_linux_amd64/ts3server_startscript.sh stop
ExecReload=/home/teamspeak/teamspeak3-server_linux_amd64/ts3server_startscript.sh restart
Restart=always
RestartSec=15
[Install]
WantedBy=multi-user.target

重载配置并启用：

sudo systemctl daemon-reload
sudo systemctl enable teamspeak3
sudo systemctl start teamspeak3

连接与使用

下载客户端：从 TeamSpeak 官网 下载适用于你系统的客户端。

连接服务器：打开客户端，点击 Connections -> Connect，输入你的 服务器 IP 地址（端口默认 9987，可不填）。

获取管理员权限：首次进入频道时，客户端会弹出窗口要求输入 Token。粘贴你在第三步保存的令牌，即可获得管理员权限。

常见问题排查 (Troubleshooting)

搭建 TeamSpeak 音乐机器人 (teamspeak-music-bot)

有了 TeamSpeak 服务器之后，不妨再给它配上一个“点歌台”。teamspeak-music-bot 是一个功能强大的开源音乐机器人，链接，支持从网易云音乐、QQ音乐、酷狗音乐、哔哩哔哩等多个平台搜索并播放音乐。它最大的亮点在于提供了一个 YesPlayMusic 风格的 WebUI 控制面板，让你可以通过浏览器轻松管理播放，体验非常接近专业的音乐播放器。

从零搭建自托管加密 DNS：AdGuard Home 完整配置指南

如果你受够了运营商的 DNS 劫持，想在手机、电脑上全局去广告，又希望保护上网隐私，这篇文章就是为你准备的。

📖 前言

我花了几天时间，从一台云服务器开始，一步步搭建了自己的加密 DNS 服务。整个过程踩了不少坑：证书申请、端口配置、iOS 描述文件、安卓 DoT 连接失败……最终所有设备都成功跑了起来。

这篇文章就是完整的操作记录，希望能帮你少走弯路。

🎯 最终效果

• 全屋去广告：所有连接到 AdGuard Home 的设备自动屏蔽广告
• 加密 DNS：手机蜂窝网络、公共 Wi-Fi 下 DNS 查询全程加密
• 跨设备支持：iPhone、安卓、Windows 全部配置完成
• 自动续期：证书到期自动更新，无需人工干预

🧱 整体架构

1
2
3
4
5
6
7
8
9
10
11
12
13

互联网
   │
   ▼
┌─────────────────┐
│  云服务器        │
│  (公网 IP)       │
│  运行 AdGuard Home│
│  监听 443/853 端口│
└─────────────────┘
   │         │
   ▼         ▼
 iPhone    安卓手机   电脑
(DoH/TLS)  (DoH)    (DoH)

第一部分：准备工作

1.1 域名与服务器

• 域名：我使用的是在 NameSilo 注册的域名
• 服务器：一台有公网 IP 的云服务器（我是阿里云）
• 系统：Ubuntu

1.2 域名解析

在 DNS 服务商控制台添加 A 记录：

第二部分：安装 AdGuard Home

2.1 一键安装

1

curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v

安装完成后，访问 http://你的服务器IP:3000 进行初始化设置。

2.2 设置用户名和密码

按照网页指引完成设置，记住你设置的管理员账号密码。

第三部分：申请 SSL 证书

3.1 为什么需要证书？

AdGuard Home 启用 DoH/DoT 加密必须使用 SSL/TLS 证书。我使用 Let’s Encrypt 的免费证书。

3.2 手动申请证书（首次）

先通过手动 DNS 验证方式申请：

1

sudo certbot certonly --manual --preferred-challenges=dns -d 域名

系统会提示你添加 TXT 记录：

1

_acme-challenge.域名 TXT "这里是一串验证值"

添加完成后等待生效，按回车继续。证书申请成功，一共有两份。

⚠️ 注意：--manual 方式不会自动续期！我们后面会改成自动方式。

3.3 查看证书内容

将输出的内容（从 -----BEGIN CERTIFICATE----- 到 -----END CERTIFICATE-----）复制下来。

第四部分：配置 AdGuard Home 加密

4.1 进入加密设置

登录 AdGuard Home 管理面板 → 设置 → 加密

4.2 填写证书

💡 进阶做法：填完内容后，可以改为填写文件路径，方便自动续期时自动加载。

4.3 放行端口

服务器防火墙（如 ufw）：

1
2
3

sudo ufw allow 443/tcp
sudo ufw allow 853/tcp
sudo ufw reload

云服务商安全组：在控制台添加入站规则，允许 TCP 443 和 853 端口。

第五部分：各设备端配置

5.1 iPhone / iPad（通过描述文件）

推荐方式：使用在线工具生成描述文件

1. 访问 dns.notjakob.com
2. 选择 DNS-over-HTTPS (DoH)
3. DoH server URL 填写：https://域名/dns-query
4. IPv4/IPv6 填写你喜欢的公共DNS
5. 生成并下载 .mobileconfig 文件
6. 通过 QQ/微信/邮件传到 iPhone，iPhone用自带的文件APP另存，并在文件APP里打开，进行安装

安装路径：设置 → 通用 → VPN 与设备管理 → 已下载的描述文件

5.2 安卓手机（推荐 DoH）

安卓系统内置的“私人 DNS”仅支持 DoT（853 端口），但国内网络环境可能干扰 853 端口。推荐使用 DoH。

使用 Intra 应用（Google 官方开源）：

1. 在 Google Play 下载 Intra

5.3 Windows 电脑

方法一：系统网络设置（推荐）

1. 设置 → 网络和 Internet → Wi-Fi/以太网
2. 点击当前网络 → DNS 服务器分配 → 编辑 → 填写你的服务器公网IP

Pixel升级后 VoLTE 废了？别慌，这份“亲兄弟”救命指南请收好！ - 少数派

第一部分：云服务器配置（搭建 Moon 中转节点）

1. 租一台有公网 IP 的云服务器（推荐阿里云，最便宜有公网IP就行，系统选 Ubuntu）。

2. 开放服务器的UDP 9993端口。

3. 连接服务器：登录服务器，依次执行以下命令：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

    # 安装 ZeroTier

    curl -s https://install.zerotier.com | sudo bash

    # 进入 ZeroTier 配置目录

    cd /var/lib/zerotier-one

    # 生成 moon.json 配置文件

    sudo zerotier-idtool initmoon identity.public > moon.json

    # 编辑 moon.json，找到 "stableEndpoints": [] 这一行，改成你的服务器公网 IP

    sudo vi moon.json

    # 示例："stableEndpoints": ["123.123.123.123/9993"]

    # 根据 moon.json 生成 .moon 签名文件

    sudo zerotier-idtool genmoon moon.json

    # 创建 moons.d 目录并移动文件

    sudo mkdir -p moons.d

    sudo mv *.moon moons.d/

    # 重启 ZeroTier 服务

    sudo systemctl restart zerotier-one
    # 记下服务器的 Node ID（例如 `12abcdef34`）
    
    sudo zerotier-cli status

第二部分：本地被控电脑配置

1. 安装 ZeroTier 客户端（官网下载）。

2. 加入你创建的虚拟网络：

   1. 在 ZeroTier 官网创建 Network，获得 16 位 Network ID。
   2. 你的电脑上右键 ZeroTier 图标 → Join Network → 输入 Network ID。

3. 添加 Moon 节点（让你的电脑优先通过你的服务器寻找朋友）：

   1. 以管理员身份打开命令提示符，进入 ZeroTier 安装目录（默认 C:\Program Files (x86)\ZeroTier\One\）。
   2. 执行：zerotier-cli orbit <你的服务器NodeID> <你的服务器NodeID>（两次输入相同 ID）。

4. 在 ZeroTier 官网授权：将你和朋友的设备都勾选允许加入网络。

5. 安装 Parsec，登录账号，并确保你的电脑设置为 “主机”（Host） 模式（默认就是）。

6. （可选）设置网络优先级，让 Parsec 优先走 ZeroTier 虚拟网卡。

   1. 按下键盘上的 Win + R 键，在弹出的“运行”对话框中输入 ncpa.cpl，然后点击“确定”。

   2. 在打开的“网络连接”窗口中，找到名为 ZeroTier One 的虚拟网卡。右键点击它，选择 “属性”。

      1. 在弹出的属性窗口中：

             找到并双击 Internet 协议版本 4 (TCP/IPv4)。

             在新窗口中，点击下方的 “高级” 按钮。

   3. 修改接口跃点数

      1. 在“高级TCP/IP设置”窗口中，取消勾选“自动跃点”。
      2. 在“接口跃点数”输入框中，手动输入一个很小的数字，比如 1。
      3. 点击“确定”保存设置。

   4. 重启电脑

第三部分：你的朋友（控制端）

1. 安装 ZeroTier 客户端。
2. 加入同一个虚拟网络：输入你提供的 Network ID。
3. 添加同一个 Moon 节点：
   1. 同样以管理员身份打开命令提示符，进入 ZeroTier 安装目录。
   2. 执行：zerotier-cli orbit <你的服务器NodeID> <你的服务器NodeID>（和之前执行的命令完全一样）。
4. 安装 Parsec，登录同一个账号（或互加好友）。
5. （可选同上）设置网络优先级，让 Parsec 优先走 ZeroTier 虚拟网卡。
6. 连接你的电脑：在 Parsec 界面中，你的电脑会出现在列表中，点击即可远程连接并开始联机。

本体+DLC，全程多人通关。

非常优秀高质量的一款游戏。

最值得称赞的是画风，有别于市面上常见的游戏，茶杯头的画风独树一帜，非常具有辨识度。在我个人看来，算是非常美观且生动的。

弹幕也能看出来是有设计过的，能够对玩家进行考验与互动，特别的格挡机制，也给游戏增添了别样的韵味。唯一的缺点是，有些初看是弹幕，但实际上只是场景特效，在初遇时会难以区分。

多人方面，互救带来的乐趣与节目效果还算不错。但除此之外，并没有更进一步的地方，有点遗憾。steam自带的远程同乐，并不算多好的选择，特别是在中国大陆境内。我个人推荐的方式是zeroTier + parsec，这种方式需要你租一个便宜的有公网IP的服务器，具体细节可通过AI查询。

剧情方面，整体符合画风与基调，中等偏上，无功无过，并不足以成为加分项。

好玩！

肉鸽带来的无尽可能，再加上各种各样规则碰撞在一起形成的化学反应，令每一把自然形成的卡组都有着不同程度的爽感。

无论是当区蠕动，还是爽局平推，都能带来不同程度的乐趣。

最好玩的还当属多人模式了，令杀戮尖塔的游戏体验上升了不仅一个台阶，多人的讨论与卡牌联动。爽局与区局的互相分享与承担。这些都令游戏的体验维度增加了，给人予丰富的游戏体验。