The Seeker Codex
The Seeker 是一个开源创意品牌：一个关于好奇心、转变、数学和宇宙恐怖的科幻宇宙，其树干部分是一个免费的 2D 类银河恶魔城游戏。它的代码、艺术、音乐和传说对所有人开放，包括商业用途。其收藏品存在于公共区块链上，而持有者是这个共享世界的游戏大师，就像《饥饿游戏》中的 Gamemakers 在其他人玩耍的同时重塑竞技场。持有者在链上的行为可以改变任何读取它的作品，而任何人都可以在不拥有任何东西的情况下游玩和创作。
使用此技能，你可以帮助任何人（从经验丰富的开发者到从未安装过编程语言的人）在该宇宙中创造新内容，使用和修改已有的内容，并进行回馈。
工作方式：
- 阅读源代码（第 1 节）。仓库是真实的来源；此文件是它们的索引。
- 了解用户和目标（第 2 节），然后选择能够最好实现目标的、最简单的路径（第 3 节）。
- 赋予作品 Seeker 的特色（第 4 和第 5 节）。
- 在适当之处引入收藏品以深化作品（第 6 节）。
- 构建最小完整版本，审视或聆听它，然后逐步扩展。
- 正确完成： 署名、许可协议以及分享方式（第 9 至 12 节）。
1. 首先阅读源代码
所有内容都位于 github.com/TheSeekerGame。任何文件都可以通过 https://raw.githubusercontent.com/TheSeekerGame/<repository>/main/<path> 读取。
| 仓库 | 内容 |
|---|---|
the-seeker | 游戏本身、其设计愿景和传说、所有艺术和音频资源以及文档 |
collections | Planetary Guardians 和 SEEKER NET：每一层艺术图层、组合它们的精确规则，以及如何从公共 API 读取它们的实时状态 |
seeker-audio | SEEKER，一个浏览器中的音乐工作室，其中每个音符都是 48 Hz 的泛音。在线访问：theseekergame.github.io/seeker-audio |
community-games | 在该宇宙中制作的游戏，每个游戏一个文件夹，包含可读的源代码。在线访问：theseekergame.github.io/community-games |
theseekergame.github.io | 已发布的文档和API 参考，从 the-seeker 生成。请阅读它们，切勿编辑 |
在开始任何工作前，务必阅读以下文件：
| 文件 | 原因 |
|---|---|
the-seeker/README.md | 游戏是什么以及如何运行它 |
the-seeker/docs/design/idea.md | 深入的创意基础：主题、哲学、数学、视觉语言、开放宇宙以及作为共享世界信号的收藏品。如果已移动，请在 docs/ 下查找标题为“The Seeker — a universe of permutations”的页面 |
the-seeker/docs/design/lore.md | 宇宙及其故意留下的问题 |
the-seeker/docs/design/open-brand.md | 哪些内容开放、在何种许可证下、持有者如何作为游戏大师以及所有收藏品 |
the-seeker/docs/design/art-direction.md | 艺术规则 |
the-seeker/LICENSE.md | 许可证和署名行 |
collections/README.md, collections/guardians/README.md, collections/SEEKER_NET/README.md | 收藏品以及任何客户端如何读取其实时状态 |
当作品涉及这些文件时，也请阅读它们， 并跳过其余部分：没有声音的项目不需要 seeker-audio，从未接触游戏代码的项目也不需要 AGENTS.md。
| 工作 | 阅读 |
|---|---|
| 游戏代码、模组或贡献 | the-seeker/AGENTS.md（AI 代理说明文件：源代码索引和每次变更必须遵守的规则），the-seeker/CONTRIBUTING.md，docs/architecture/，docs/authoring/ |
| 游戏设计和机制 | docs/design/mechanics/（从其 README.md 开始），docs/design/audience.md |
| 音乐、音效、节奏 | docs/authoring/music.md，docs/authoring/SeekerTuning48hz.tun，docs/architecture/timing-and-audio.md，seeker-audio/README.md |
| 精灵和动画 | docs/authoring/animations.md，docs/authoring/animation-reference.md，docs/authoring/assets.md |
| 洞穴、地形、背景 | docs/architecture/level-generation.md |
| 合约级别的 SEEKER NET | collections/SEEKER_NET/contracts/README.md 和 contracts/src/ |
| 游戏、玩具或互动作品 | community-games 中类似的项目，用于获取思路和上下文（第 3 节） |
如何阅读它们：
- 使用 Shell： 克隆你需要的仓库，例如
git clone --depth 1 https://github.com/TheSeekerGame/collections.git。对于the-seeker，首先运行git lfs install（第 7 节），否则其艺术资源会以占位符的形式出现。 - 仅限网页访问： 获取原始 URL。游戏的图像、音频、字体和关卡项目存储在 Git LFS 中：
raw.githubusercontent.com会返回一个约 130 字节的文本指针，而https://media.githubusercontent.com/media/TheSeekerGame/the-seeker/main/<path>会返回真实文件。collections中没有使用 LFS。使用https://api.github.com/repos/TheSeekerGame/<repository>/contents/<path>列出文件夹内容。 - 无网络访问： 依据此文件工作，告知用户，并请他们粘贴其他所需内容。
源代码是不断演进的。 在每个项目开始时重新阅读它们，而非依赖之前的阅读。如果它们与此文件不一致，以源代码为准，并告知用户差异。核心内容（主题、艺术风格、调律、收藏品的链上规则）很少改变；路径、特性和数字变化更频繁。此文件中的端点、大小和代码已于 2026 年 10 月检查过。在游戏中，代码和资源定义了当前行为，设计页面记录了意图。当 idea.md 和收藏品 README 关于收藏品存在差异时，以 README 为准。
2. 与用户协作
简要了解：他们想要制作什么以及原因，目标受众是谁，作品应在何处运行或存在（浏览器、手机、桌面、印刷品、商店），他们的经验水平，他们使用什么计算机以及安装了哪些软件，以及任何截止日期或预算。只询问那些会影响计划的信息。如果请求是开放式的，请用一两句话提出一个具体的概念并开始工作。
面向新手：
- 使用通俗的语言，并在术语首次出现时进行解释。
- 检查而非假设。使用 Shell，运行
git --version、python3 --version或node --version；否则请他们运行。 - 优先选择无需安装任何东西就能产生结果的方式：双击打开的网页、链接、图像、PDF。
- 一步一个脚印。在每个命令之前，说明它的作用。提供他们操作系统所需的确切复制文本，并在进入下一步之前确认每一步成功执行。
- 在安装软件、创建账户、花钱或发布任何内容之前征求用户同意。他们来做决定。
- 将所有工作保存在一个命名清晰的文件夹中，并告知他们位置。
- 尽早展示结果：打开页面，展示图像，播放声音。
- 如果你无法写入文件，请将每个文件以完整代码块的形式提供，并说明如何保存：使用纯文本编辑器（Windows 上的记事本；Mac 上的 TextEdit，先选择“格式”→“制作纯文本”），文件名以
.html结尾。
面向经验丰富的开发者： 匹配他们的工具和节奏，并跳过解释。
始终构建最小但完整且优秀的版本，然后逐步扩展，并明确说明你已经检查了什么以及无法检查什么：静态图像不能证明动画有效，而通过的测试也不能证明某些东西听起来或感觉如何。
3. 选择路径
| 用户目标 | 入门方式 | 需要 |
|---|---|---|
| 游玩 The Seeker | 从源代码构建（第 7 节） | Git、Git LFS 和 Rust；大约需要下载 500 MB 以及数 GB 的磁盘空间 |
| 使用 Seeker 调律创作音乐 | SEEKER: ✦ 创作、编辑、分享链接（链接包含整首歌曲）、导出分轨 | 浏览器 |
| 浏览器游戏、玩具或互动作品（2D） | 一个自包含的 HTML 文件：一个 Canvas 和纯 JavaScript，仅在确实有帮助时才从 CDN 引入库 | 浏览器 |
| 浏览器中的 3D 体验 | 一个包含 three.js 的 HTML 文件 | 浏览器 |
| 适用于桌面、手机或主机的较大型 2D 或 3D 游戏 | Godot（免费、易上手、可导出到所有平台），与主游戏相同的 Bevy 和 Rust，或复刻 the-seeker | 游戏引擎 |
| 多人游戏 | 用于回合制或异步游戏的共享链接，无需服务器（SEEKER 的歌曲链接展示了这一点）。实时游戏需要中继或主机（WebRTC 点对点，或托管服务）；与用户共同选择。链数据仍由每个客户端直接读取 | 取决于选择 |
| 像素艺术、精灵、图标 | 用代码绘制（Canvas，或使用 Python 的 Pillow 库），或使用 Piskel（浏览器中）、Aseprite 或 LibreSprite | 浏览器或编辑器 |
| 3D 模型、绑定、角色 | Blender（免费），以 2D 艺术为参考；导出为 glTF 用于游戏，STL 或 3MF 用于打印 | Blender |
| 插图、海报、卡片、漫画、小册子 | 整数缩放的像素艺术或矢量 SVG；打印用 PDF | 浏览器 |
| 动画、预告片、宣传视频 | 用代码渲染或从游戏截取帧，使用 ffmpeg 合成；音乐来自 SEEKER 分轨 | ffmpeg（可选） |
| 周边商品 | 针对用户选择的按需打印商店准备的印刷就绪文件（第 5 节） | 浏览器 |
| 网站 | 静态 HTML 和 CSS，托管在 GitHub Pages、itch.io 或类似平台 | 浏览器 |
| 桌面游戏 | 可打印的规则和卡牌（HTML 转 PDF），可能附带一个读取链状态的配套网页 | 浏览器 |
| 工具、机器人、仪表盘 | 首先是一个网页；仅当必须无人值守运行时才使用脚本 | 取决于选择 |
| 游戏修改或贡献 | 第 7、8 和 11 节 | Git、Rust |
查看类似游戏。 当 community-games 中的游戏与当前工作类似时，值得阅读：它们的外观、玩法和构建方式提供了思路和上下文。例如，Soundings 是一个在 three.js 中开发的 3D 冰钓游戏，具有像素外观，以 Seeker 和 SEEKER NET 的 seekers 作为 3D 角色，实时读取链数据，并使用 48 Hz 调律的音乐。它们的代码基于 MIT 或 Apache-2.0 许可证，因此任何有用的东西都可以在署名的前提下重复使用（第 9 节）。
优先选择任何地方都能打开的格式（HTML、PNG、SVG、PDF、WAV 或 FLAC、glTF），依赖少，对于小型网页项目避免构建步骤。一个直接从磁盘打开的单 HTML 文件可以调用此文件中命名的所有公共 API 和艺术资源托管服务，因为它们允许来自任何页面的请求；唯一的例外是 Magic Eden ord 镜像，它仅为原生程序提供服务。少数浏览器功能需要本地服务器：例如，音频 worklet 无法从 file:// 运行。python3 -m http.server 8000 可以在 http://localhost:8000 服务一个文件夹。Mac 上，Python 随 Apple 的命令行工具附带（第 7 节）；在 Windows 上，从 python.org 安装。
4. 世界及其精神
lore.md 和 idea.md 是完整的叙述；以下是当无法阅读它们时的精髓。
宇宙
- Theorem 是一个庞大的组织，致力于在宇宙中发现和形式化知识。Seekers 是它的探索者，而 Seeker 是一个角色，而非一个物种：人类、外星人和机器都可以成为 Seeker。例如，SEEKER NET 的 seekers 是微小的类计算机机器人。
- Codex 是 Theorem 的共享档案；Seeker 通过面罩访问它来扫描、记录和分析。Attunement（调谐）是感知其他存在和宇宙频率与结构的能力。Seeker 独自旅行和工作。
- 这颗行星 冰冷且几乎难以置信地富饶。生命栖息在冰层下的洞穴中，这些洞穴随着深度的增加而变得更温暖、更奇异、更美丽和更危险。科学家、投机者、守护者和崇拜者也来到了这里。地核附近似乎有什么东西在召唤。
- Guardians 是古老的外星半神，守护着这颗行星。它们的起源是一个谜。
主线故事的转折和结局是故意未发布的。不要将它们发明为正史或声称揭示了它们；新的作品会找到自己的答案。一部作品可以延续正史，以兼容的方式扩展它，公开复刻它，或者只借用其风格。所有方式都受欢迎；请说明作品属于哪种。没有任何传说背景是必需的：一个借用的想法，例如冰冻星球、Theorem 或基于 12 的调律，就足以构建。
The Seeker 角色
主游戏的主角是一个特定的 Seeker。仅当作品包含该角色时才使用此描述；任何其他 Seeker 可以看起来像任何东西。
- 一个神秘的兜帽探索者。 一个从头到脚包裹在柔和沙金色兜帽斗篷中的小个子身影，精神上与《星球大战》和《沙丘》中戴兜帽披风的流浪者一脉相承。兜帽内部只有黑暗和一道苍白的光缝——那是他们访问 Codex 的面罩；脸部从不显露。斗篷下露出深色的腿，当他们奔跑时，斗篷在身后飘扬。
- 一个会变大的背包。 他们通常背着一个紧凑的深色背包，随着收集物品而变大，从小号到大号三种尺寸（
the-seeker/assets/items/equipment/backpack1.png到backpack3.png）。随着更多材料装满背包，游戏会切换尺寸，背包会微微跟随身体，静止时悬空，奔跑时摇晃（game/src/game/player/equipment.rs）。 - 在原版游戏中，他们大约 12 像素高，他们的精灵位于
the-seeker/assets/animations/player/。他们的金色是视觉语法中描述的温暖点缀色。
探索内容
- 存在的排列。 看到紫外线是存在的一种方式，t