# @agntn/puzzles 中文文档

规范地址：https://npmcn.com/package/%40agntn/puzzles/

版本：0\.31\.0
npm 元数据更新时间：2026-10-29T00:35:09.525Z
中文译文更新时间：2026-11-06T23:58:48.227Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agntn/puzzles
原文对照：https://npmcn.com/package/%40agntn/puzzles/?lang=original
项目主页：https://github.com/agntn/puzzles#readme
源码仓库：https://github.com/agntn/puzzles

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.4 MB，192 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=26
- 运行依赖：9 个
- peer 依赖：@oh-my-pi/pi-coding-agent \>=18\.0\.0 \<19，@earendil-works/pi-coding-agent \>=0\.84\.2 \<1
- 首次发布：2026-09-18T09:36:52.209Z
- 最新版本发布：2026-10-29T00:35:09.217Z
- 近 30 天下载量：2143（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：27（近 12 个月 27 个）

## 中文简介

密码、谜题和挑战作为代理商的阶级数据

## 安装

```sh
npm install @agntn/puzzles
```

也可以使用：`pnpm add @agntn/puzzles`、`yarn add @agntn/puzzles`、`bun add @agntn/puzzles`

## README

# @ agntn/ 谜题

[![npm version](https://npmx.dev/api/registry/badge/version/@agntn/puzzles)](https://npmx.dev/package/@agntn/puzzles) [![npm downloads](https://npmx.dev/api/registry/badge/downloads/@agntn/puzzles)](https://npmx.dev/package/@agntn/puzzles) [![license](https://npmx.dev/api/registry/badge/license/@agntn/puzzles)](https://npmx.dev/package/@agntn/puzzles) [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/agntn/puzzles)

公开密码谜题和奖赏,作为打字记录. 你问一个谜题,你得到它的地址,它的关键材料和链上发生的事情.

## 为什么?

每个谜题线索都有相同的三件事:地址,奖品,以及谁解决了什么. 每一个扫描仪和跟踪器都从线程中重新打出它们,每次都略有不同. 所以他们住在这里一次,作为代码。 谜题是 TypeScript 记录 。 类型检查器在测试之前读取. CLI,MCP服务器和Pi和OMP扩展读取一个登记册.

Docs,每个谜题一页和一个现场游乐场: [谜题.agntn.dev](https://puzzles.agntn.dev/)。 。 。 .

> \[尖叫声\] 预1.0. API,CLI旗和数据模型仍然可以移动. 如果你在它的基础上再做一个精确的版本.

## \* 特性

-   🧾 **数据作为代码.** 一个 `PuzzleSpec` 每个谜题的字元, 由一个 `puzzle()` 工厂每条链。 没有JSON,没有建设步骤.
-   🕳️ **缺席意味着缺席.** 没有解谜器或奖品的谜题没有这种密钥. 连载都是假的.
-   🔑 **每个形状的关键材料.** Hex, WIF, BIP38 有效载荷, 种子短语, 秘密股份, 密封的 Arweave 密钥文件, 或只是略宽一些 。 多相之键也. 一个建筑师.
-   💤 **懒活登记.** 正在导入包装入无记录 . `get("bits/71")` 导入一个收集模块.
-   ✅ **核查是一种价值.** 已公布的密钥获得地址或者它没有. 无所投出坏记录.
-   💰 **生活平衡。 。 .** `puzzle.balance()` 结束 `@agntn/explorers`基本单位为: `bigint`,API 密钥因出错而编辑.
-   👀 **出录一表.** `puzzles watch` 列出存款和支出记录缺失, 奖金移动, 公用钥匙, 支出送出, 源页更改。 它从来不编辑记录。 你这样做.
-   📋 **周末前的核对表.** `puzzles eligibility` 收集来源,地址,来自探险家的终身总数,其证据的状态和算什么作为解决方案. 不管谁能填满什么 都会像一个 `missing` 排队,从不猜测.
-   🖼️ **谜题本身,不是它的一个链接.** `puzzles_assets` 将图像模型、舞台文件和提示后面的存档帖子 与SHA -256记录针对照 链接腐烂。 这些没有.
-   🤖 **十五个代理工具.** MCP, Pi 和 OMP 背后的一位执行者. 到处都是同样的答案.
-   🌐 **到处跑.** 在获取 API 上中立的无害环境管理 。 节点 浏览器 边缘工人.

## QQ 安装

```bash
pnpm add @agntn/puzzles
```

节点.js 26或更新的CLI.

## 第一次通话

```bash
npx @agntn/puzzles stats
```

印出总数,每个状态一个数 有多少谜题有已知的公钥。 没有钥匙 没有配置 没有网络 包裹内的纪录船. 赤裸裸的 `puzzles` 以下为 `pnpm exec puzzles` 在本地状态之后 `pnpm add`或仅仅是 `puzzles` 之后 `pnpm add -g @agntn/puzzles`。 。 。 .

```bash
puzzles show hash-collision/sha256
```

```text
hash-collision/sha256	unsolved	0.27734251 BTC	35Snmmy3uhaer2gTboc81ayCip4m9DT4ko
chain: bitcoin  address kind: p2sh
hash160: 292fb39df7cd619a396069383928e6bfb74ebec5
redeem script: 6e879169a87ca887 (hash 292fb39df7cd619a396069383928e6bfb74ebec5)
public key: unknown
private key: unknown
started: 2013-09-13 05:59:09
transactions: 1
    funding	2013-09-13 05:59:09	0.1 BTC	397f12ee15f8a3d2ab25c0f6bb7d3c64d2038ca056af10dd8251b98ae0f076b0
explorer: https://blockstream.info/address/35Snmmy3uhaer2gTboc81ayCip4m9DT4ko
source: https://bitcointalk.org/index.php?topic=293382.0
```

### 图标

| 命令 | 印着什么 |
| --- | --- |
| `puzzles stats` | 总数、状况计数、奖金和数据版本 |
| `puzzles collections` | 每集一行:按键、计数、作者 |
| `puzzles authors [key]` | 每个作者一行,或作者有其来源事实的记录 |
| `puzzles author <key>` | 一个作者的记录,直接从 `puzzles_author` 工具 |
| `puzzles solvers [key]` | 每个命名的解析器一行,或者一个解析器的记录:每个解析,剖析和来源的事实 |
| `puzzles solver <key>` | 一个解决者的记录,直接从 `puzzles_solver` 工具 |
| `puzzles show <id>` | 一个谜题的记录:关键材料,交易,提示和链接. `--json` 数据 |
| `puzzles hints <id>` | 收藏的提示,谜题的自有,然后是它的提示文件. `--json` 两者 |
| `puzzles stages <id>` | 多阶段谜题的阶段与他们的页面,文件和已公布的答案. `--json` 用于列表 |
| `puzzles assets <id>` | SHA -256和大小的拼图船 存档页. `--read <path>` 写一个, `--check`编号 :`--live` 校验 |
| `puzzles list [collection]` | 每行一个谜题. `--address`, (中文(简体) ), `--chain`, (中文(简体) ), `--status`, (中文(简体) ), `--technique` 财务报告和审定财务报表 `--with-pubkey` 缩小范围, `--limit` 财务报告和审定财务报表 `--offset` 页面 |
| `puzzles verify [id]` | 已经公布的密钥及其与地址相对的配方. `--all` 或 `list` 集的过滤器, 在不匹配时退出 1 |
| `puzzles balance [id]` | 活平相会. 这个 `list` 过滤器检查整个集,每集一行. `--api-key`,或每个链条一个变量 |
| `puzzles watch [id]` | 链子知道什么 记录没有. `--since` 检查源页, 任何发现的第1出入口 |
| `puzzles eligibility <query>` | 奖项工作前的核对表,通过身份或地址。 缺少任何字段时退出 1 |
| `puzzles export` | 整个数据集及其 `data_version` |
| `puzzles mcp` | MCP 服务器通过 stdio |

`--json` 打印文本后的数据, `bigint` 作为字符串和遗漏的字段。 命令来自代理商得到的相同的工具定义,所以旗下的一个打字失败了,就像它失败了模型一样. 旗帜和出口代码在 [CLI 指南](https://puzzles.agntn.dev/guide/cli)。 。 。 .

## 图书馆

```ts
import { get, stats, verify } from "@agntn/puzzles";
import { bits } from "@agntn/puzzles/collections/bits";

const puzzle = await get("bits/71"); // loads the bits collection, nothing else
puzzle?.address().value; // "1PWo3JeB9jrGwfHDNpdGK54CRas7fsVzXU"
puzzle?.keyRange(); // [2n ** 70n, 2n ** 71n - 1n]

(await verify(bits.require(1))).verified; // true, key 1 derives its address
(await stats()).unsolved; // how many are still waiting for a key
(await bits.require(71).balance()).totalUnits(); // 7.10190014 when I ran it, mempool.space decides
```

这是大部分,真的。 收藏是它自己的入口 上面的一切都是同步的 横跨收藏的视图在等待一负荷。 出错从 `PuzzlesError`平衡有他们自己的家庭 `BalanceError`其余部分在指南中: [记录](https://puzzles.agntn.dev/guide/records), (中文(简体) ), [登记](https://puzzles.agntn.dev/guide/registry), (中文(简体) ), [浏览](https://puzzles.agntn.dev/guide/lookups), (中文(简体) ), [核查](https://puzzles.agntn.dev/guide/verification), (中文(简体) ), [结余](https://puzzles.agntn.dev/guide/balances)。 。 。 .

## · 收款情况

| 密钥 | 链条 | 这是什么 |
| --- | --- | --- |
| `bits` | 比特币 | 1至256比特的密钥,每个地址一个 |
| `quizchain` | 比特币 | 以键为链的查询区块 |
| `quizchain2` | 比特币 | Quizchain第二出道 从2019年5月起 |
| `rushwallet` | 比特币 | 2014年比赛的脑袋 |
| `zden` | 比特币,乙烷,利特币,去除 | Zden 的视觉谜题 |
| `weave` | r, ether | Tiamat 谜题编织系列 |
| `move-over-brokers` | 比特币 | 十二个隐藏在块链簿中的密钥 |
| `mini` | 比特币,比特币现金 | 退休的Coder的七个小谜团 |
| `warp` | 比特币 | Keybase 的 scrypt 脑钱包挑战 |
| `hash-collision` | 比特币 | 彼得·托德的P2SH相撞弹 |
| `teikhos` | 醚 | 支付公用钥匙的合同 |
| `ballet` | 比特币 | BIP38 键被打印在物理钱包上 |
| `dug` | 比特币 | 2025年学生种子狩猎 |
| `coin-games` | 比特币 | 有头骨、狮子和金星的钞票 |
| `bitimage` | 比特币 | 从相片上散出种子 |
| `luckylurker` | 比特币 | 二个比特币假发种子挑战 |
| `iamabananaamaa` | 比特币 | 一个ZIP在GIF, 然后一个假凯撒 |
| `doges-gambit` | 乙烷、多吉币 | 两把钥匙读出一盘棋盘视频 |
| `crypto-puzzles` | 醚 | 隐藏在短视频中的原始以太密钥 |
| `walking-banks` | 比特币 | 藏在比特币惊悚小说里的种子 |
| `grycoin` | 比特币 | Quizchain 重新命名, 在关闭前几天 |
| `smith-lyle-moore` | 比特币 | 一个乐队的两次打猎,每一次 |
| `real-big-block` | 比特币 | 777 mBTC for a Wattpad 分会,无要求 |
| `school-of-bitcoin` | 比特币 | 后面有张1M的名片 |
| `liberte-guidant-le-peuple` | 比特币 | 穿黄背心的Delacroix,法语种子 |
| `hunting-time` | 比特币 | 在小说中伪装成时代的种子词 |
| `bitaps` | 比特币 | 5个秘密分享计划中的3个 |
| `gsmg` | 比特币 | 多相相图像谜题 |
| `movie-enigma` | 比特币 | 作为种子词的电影标题,已解决 2026 |
| `ledger-donjon` | 比特币 | 剪刀保密分享 |
| `coin-artist` | 比特币 | TORCHED H34R7S 画 |
| `genesis` | 比特币 | 创世纪块 OP RETURN 拼图 |
| `mineshop` | 醚 | 种子在视频和帖子之间分割 |
| `satoshi-birthday-quiz` | 比特币 | 7个答题被拼入钱包 |
| `book-quiz` | 比特币 | 一个书考,没有谁及时赢了 |
| `80-bit` | 比特币 | 80个隐藏的位子和一个集市比赛 |
| `wickex` | 比特币 | Hex, Morse 和一个分光谱密码句 |
| `picture-puzzle` | 比特币 | 四张拼写密钥数据库的相片 |
| `brave-new-world` | 比特币 | 隐藏在2020年拼图中的种子短语 |
| `wealth-in-poetry` | 比特币 | 隐藏在2019年中篇散文中的种子词 |
| `path-to-greatness` | 立克币 | 游戏演示的线索, Litecoin 密钥 |
| `proof-of-writing` | 电子现金 | 散文对角上的卡什塔布种子 |
| `bitaddress` | 比特币 | BIP38 有被遗忘密码的钱包 |
| `powerful-moss` | 基础 | 专辑中的种子,合同中的奖金 |
| `trivia-brainwallet` | 比特币 | 十二个三维谜语被盐化成碎屑 |
| `great-riddle` | 比特币 | 隐藏在球点笔画中的种子词 |
| `satoshi-maze` | 比特币 | 一个从e乘以2个 Base58 字的质数 |
| `natasha-otomoski` | 比特币 | 8个骆驼字作为原始密钥字节 |
| `phy` | 比特币 | 一个签名的帖子和一个灰色的螺旋相间 |
| `seed-phrase` | 比特币 | 约会线索,然后两年的沉默 |
| `9vw04` | 比特币 | 一个微博中的世界投资基金,彩虹未包含在内 |

标识符是 `collection/name`单子,例如 `gsmg`, (中文(简体) ), `genesis` 或者说 `80-bit`只是关键 每个集都有一页 故事、怪事和每个谜题: [谜题.agntn.dev/收藏](https://puzzles.agntn.dev/collections)。 。 。 .

## 代理人

```bash
claude mcp add puzzles --scope user -- npx -y @agntn/puzzles mcp
claude mcp add --transport http puzzles https://puzzles.agntn.dev/mcp # nothing to install
pi install npm:@agntn/puzzles
```

```json
{
  "mcpServers": {
    "puzzles": { "command": "npx", "args": ["-y", "@agntn/puzzles", "mcp"] }
  }
}
```

15个工具: `puzzles_stats`, (中文(简体) ), `puzzles_collections`, (中文(简体) ), `puzzles_authors`, (中文(简体) ), `puzzles_author`, (中文(简体) ), `puzzles_solvers`, (中文(简体) ), `puzzles_solver`, (中文(简体) ), `puzzles_show`, (中文(简体) ), `puzzles_hints`, (中文(简体) ), `puzzles_stages`, (中文(简体) ), `puzzles_assets`, (中文(简体) ), `puzzles_list`, (中文(简体) ), `puzzles_verify`, (中文(简体) ), `puzzles_balance`, (中文(简体) ), `puzzles_watch` 财务报告和审定财务报表 `puzzles_eligibility`。最后三个离开过程,同样 `puzzles_assets` 当它读一个文件。 他们的说明是这样说的。 文本包含什么,限制在哪里: [代理指南](https://puzzles.agntn.dev/guide/agents)。 。 。 .

## ~ 这不起作用 ~

解无所取. 没有扫描仪,没有袋鼠, 没有脑花饼干, 和没有猜测 从交易列表. `solved`, (中文(简体) ), `swept`, (中文(简体) ), `claimed` 财务报告和审定财务报表 `expired` 因为债权交易加上已公布的密钥仍意味着解决。 链式事实来自 `@agntn/chains`,从 `@agntn/keys` 余额 `@agntn/explorers`。这个包裹不会重新执行其中的任何一项.

## 添加谜题

一个记录文件下 `src/collections/<key>/` 和收藏模块中的一行。 礛 `pnpm test` 运行数据门:独特的ID、地址和txid格式、密钥衍生、BIP38有效载荷、资产路径及其SHA-256,无空。 记录的形状在 [谜题记录](https://puzzles.agntn.dev/guide/records) 和规则 [捐款额](https://npmcn.com/package/%40agntn/puzzles/CONTRIBUTING.md)。 。 。 .

## 发展

```bash
pnpm install      # the library and the docs site, one lockfile
pnpm lint         # vp lint and vp fmt, docs included
pnpm typecheck    # builds first, then checks src, Pi and OMP
pnpm test         # unit tests and the data gate
pnpm test:packed  # packs the tarball and runs every published entry without src/
pnpm run docs     # the Docus site on localhost
```

一个安装也覆盖了网站. 没有第二次旅行 `docs/`没有第二个锁文件 悄悄地离开第一个。 还有 `run` 最后一行不是装饰 pnpm 12有一个 `docs` 它想要一个包名,而不是我们的网站.

## 谢谢

此软件包的存在得益于Anthropic和OpenAI的开源程序: [Claude 打开源代码](https://claude.com/contact-sales/claude-for-oss) 财务报告和审定财务报表 [开源代码](https://developers.openai.com/community/codex-for-oss)。 。 。 .

## 许可证

[麻省理工学院](https://npmcn.com/package/%40agntn/puzzles/LICENSE)

## 常见问题

### @agntn/puzzles 是什么？

密码、谜题和挑战作为代理商的阶级数据

### 如何安装 @agntn/puzzles？

在项目目录运行 npm install @agntn/puzzles，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 puzzles，可以用 npx puzzles 直接运行。

### @agntn/puzzles 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @agntn/puzzles 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @agntn/puzzles 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=26。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @agntn/puzzles 可以商用吗？

@agntn/puzzles 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @agntn/puzzles 的下载量有多少？

根据 npm 官方下载统计，@agntn/puzzles 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,143 次，日均约 71 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @agntn/puzzles 还在维护吗？

最新版本 0\.31\.0 发布于 2026/10/29（9 天前）；至今共发布 27 个版本，其中过去 12 个月发布了 27 个；首次发布于 2026/09/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。