TapeNow / TapeOut 发布排错手册（中文·社区整理）

1. 发布前准备清单

先免费试：登录 → 建项目 → 导入构建包 → 私有预览。这些都不需要钱包、不花钱。只有「正式上链发布」才需要下面这些。

构建包合格：是能直接打开的静态网站，根目录有 index.html；不超过 10 MiB / 500 个文件。源码 ZIP 不一定是构建包。
持有一颗 TapeOut 芯片并开通了容器（电路容器 NFT）。芯片用来证明你有权限，容器存放网站文件。还没有的话，在 TapeNow 项目「生态与链上站点」里看 One-Click Container 等入口。流片、开容器、上传文件是三件不同的事，各自按上游页面收费。
选对链：BSC / X Layer / Base 三选一，必须是你芯片所在的那条链。
常见错误：芯片在 BSC，项目里却选了 X Layer。BSC 付 BNB，X Layer 付 OKB，Base 付 ETH。如果发布计划里的预算显示 OKB，说明你选的是 X Layer。
钱包里有一点对应链的原生币付 gas（BSC 就是 BNB）。BSC 的网站地址激活费目前是 0 BNB（交易仍要 gas）；X Layer 是 0.026 OKB／30 天，Base 是 0.0012 ETH／30 天（官方 2026-09-28 核对，以钱包报价为准）。
BEM：芯片 / 容器等上游操作如果要求 BEM，按上游页面提示准备。TapeNow 本身的发布交易只花链上 gas，不收 BEM。
处理器编号（CPU Index）和芯片编号（Token ID）在哪填：
项目设置 → 链上发布目标 → 选链 → 填 CPU Index 和 Token ID → 点「保存目标」。
不是在发布页面填！见官方手册 03 / 正式发布 →「选择链与芯片容器」。
不要把别的游戏或别的链的编号直接照抄过来；保存编号不代表有权限，真正发布前系统还会核对容器和当前持有人。
钱包连接 ≠ 登录 TapeNow 账号，也不代表你已经持有芯片。签名的钱包要和芯片持有人一致。
外部脚本要打包进来：链上网站在容器里运行，不能从 CDN 加载 JS（见下表「外部脚本不加载」）。像 ethers.umd.min.js 这种库，下载下来放进构建包，用相对路径引用。
免费版额度：公测免费账号每个 UTC 月最多 10 个新版本发起公开发布，每天 300 次修改操作。

发布流程（手册 03）：部署详情 →「发布检查」→ 勾选确认 → 点「确认本次发布」→ 展开「链上发布」→ 点「生成发布计划」→ 钱包逐步签名 → 读回核验 → 激活访问入口 → 浏览器实际打开检查。

2. 常见报错对照表

标签：官方手册来自 TapeNow 文档；实测本人 2026-10-07 起实际遇到；源码可查直接看网页代码确认。

红色横幅「请先设置处理器编号与芯片 ID」实测官方手册

原因: 项目还没保存链上发布目标。
怎么办: 去 项目设置 → 链上发布目标，选链、填 CPU Index 和 Token ID，点「保存目标」，再回部署详情。发布页面里没有填写的地方。

预算 / 报价显示的是 OKB实测官方手册

原因: 链选成了 X Layer（X Layer 用 OKB 付费）。
怎么办: 芯片在 BSC 的，回「链上发布目标」改成 BSC 并保存，报价应变成 BNB。

「确认本次发布」按钮是灰的，点不了实测官方手册

原因: 还没勾选「已检查差异 / 数据库影响」的确认框；或者有已知不兼容被拦下。
怎么办: 在「发布检查」展开文件与配置差异，看完后勾选确认框，按钮就会亮。如果有红色的不兼容提示，先按提示改构建包再重新导入。

点「生成发布计划」后弹出「操作未完成，请检查连接或稍后重试」实测

原因

这句提示很笼统，不一定是你的网络问题。要看控制台里到底是哪个请求失败。

怎么办

按 F12 打开控制台（见第 3 节）→ 切到 Network（网络）→ 再点一次。找红色的请求：

如果是 POST /api/releases/…/chain/prepare 返回 500：这是 TapeNow 服务器出错，不是你的网络、VPN 或代理。换网络、开关 Clash、换手机都没用。直接去反馈（第 4 节），附上项目编号和时间。
如果是请求根本没发出去 / 超时：才是网络问题，换网络再试。

控制台一堆黄色 MaxListenersExceededWarning，来自 contentscript.js实测

原因: 这是钱包浏览器插件（如 MetaMask）自己注入页面的脚本发出的警告，跟 TapeNow 和你的网站无关。
怎么办: 可以忽略。只看红色错误和 Network 里的失败请求。

「普通访问入口」一直显示「待处理」实测官方手册

原因: 链上写入、读回核验、入口激活是分开的几步，前面没全部完成，入口就不会生效。
怎么办: 回部署详情看每一步状态和交易哈希：读回核验没过就先做读回；读回过了再按界面激活访问入口。

打开 tapeout.link/<芯片编号>.<处理器编号>.tape 是空白 / 404 / 没内容实测

原因: 这个容器里还没有成功发布的网站（或入口没激活 / 已过期）。打开这个地址只是一个读链的预览器外壳，外壳能打开不代表网站已经上链。
怎么办: 先在 TapeNow 部署详情确认链上发布、读回、激活都完成了。格式例子：芯片 15657、处理器 30 → https://tapeout.link/15657.30.tape。

网站在本地好好的，放进容器后按钮没反应 / 钱包连不上，控制台报 Content Security Policy 拦截脚本源码可查

原因: 链上网站跑在一个独立的 frame 里，它的安全策略是 default-src 'none'，脚本只允许内联和 blob，不允许从外部网址（CDN）加载 JS。图片、样式、字体和 https 请求（比如调 RPC）是允许的。
怎么办: 把 <script src="https://cdn…"> 换成本地文件，例如把 ethers.umd.min.js 放进构建包，写 <script src="./ethers.umd.min.js">。可以在 TapeNow「构建文件」里看「外部依赖」检查还有没有漏网的。

依据：tapeout.link 预览器 https://tapeout.link/assets/tapekit/frame.html 里的 CSP。其他入口的策略可能不同，但打包本地最保险。

ZIP 导入失败官方手册

原因: 不是构建产物、根目录没有 index.html（多套了一层文件夹最常见），或超过 10 MiB / 500 个文件。
怎么办: 打开 ZIP 看第一层就是 index.html；重新构建、压缩图片后再导入。

钱包网络不对 / 余额不足官方手册

原因: 钱包当前网络和发布计划的链不一致，或原生币不够付 gas。
怎么办: 按发布计划切到 BSC/BNB、X Layer/OKB 或 Base/ETH；看清每一步报价和整次预算，报价过期要重新生成。

交易发出去了但结果不明 / 页面关了官方手册

原因: 交易已广播，但页面没拿到回执。
怎么办: 不要盲目重新签名或付款。先回部署详情看交易哈希和状态，或在钱包里找哈希，刷新后继续确认，或按界面输入已有哈希。提示「可能已执行」时先查操作记录。

网站能打开，但数据 / 接口失败官方手册

原因: 外部 API、数据库不会跟着 ZIP 上链；可能是权限、CORS 或你自己的服务挂了。
怎么办: 分别检查自己的接口和 CORS 设置。恢复旧版网站文件不会回滚数据库。

X Layer / Base 的网站过了一个月打不开官方手册

原因: X Layer、Base 的访问激活按 30 天计，到期入口会停；TapeNow 不会自动扣款续期。
怎么办: 延长激活后重新核验。BSC 目前官方说明为 10 年、免服务费延期。

还没解决？在项目「活动日志」「用量与诊断」里找出错的时间和错误文字，部署详情可展开「最近操作与重试状态」。把这些带去反馈。

3. 怎么看控制台

电脑（Chrome / Edge / Brave）

在出错的页面按 F12（Mac 用 ⌥ Option+⌘ Cmd+I），或右键 →「检查」。
Console（控制台）：只看红色的行，黄色警告大多可以忽略。
Network（网络）：保持打开，再操作一次。红色的行就是失败的请求，点开看 Status（状态码）和 Response（返回内容）。
- 5xx（如 500）= 服务器出错，找官方。
- 4xx（如 401/403）= 登录过期或没权限，重新登录再试。
- 请求失败 / 超时 = 网络问题。
截图时把请求网址、状态码、时间都截进去；钱包地址不想公开可以打码。

手机

手机浏览器一般没有控制台。最省事：换电脑复现一次再看。
安卓：手机开 USB 调试，用数据线连电脑，在电脑 Chrome 打开 chrome://inspect 调试手机页面。
iPhone：设置 → Safari → 高级 → 打开「网页检查器」，用数据线连 Mac，在 Mac Safari「开发」菜单里选手机页面。
钱包 App 内置浏览器基本看不了控制台，只能截下报错弹窗和时间。

4. 反馈渠道

「帮助与常见问题」页面不能留言。按下面顺序找：

TapeNow 工作台内反馈（首选，适合跟账号有关的问题）：登录后点顶部栏「发送反馈」，类型选「遇到问题」。也可以直接打开：
https://app.tapenow.dev/?feedback=1
GitHub Issues（公开，别贴账号隐私）：选 Bug report，要填工作台版本号。
https://github.com/TapeNow/tapenow/issues/new/choose
版本号在这里看 version 字段：https://app.tapenow.dev/api/health（2026-10-09 是 0.9.16）
安全漏洞不要发公开 Issue，在仓库 Security → Report a vulnerability 私下提交。
TapeNow 开发者 X：@0xAlphana
https://x.com/0xAlphana
TapeOut 官方 X：@TapeOutWorld
https://x.com/TapeOutWorld
TapeOut 官方 TG 群：https://t.me/TapeOutnet
TapeOut 学习群（TG）：https://t.me/tapeoutstudy

报错模板（复制后改掉 ___ 的地方）

【Bug】___ 链 ___ 步骤失败

项目编号：p-________
链：BSC / X Layer / Base
处理器编号（CPU Index）：___
芯片编号（Token ID）：___
所有者钱包：0x________（不想公开可打码）
工作台版本：___（看 https://app.tapenow.dev/api/health 的 version）
浏览器和系统：___（例：Chrome 141 · Windows 11）

复现步骤：
1. 打开部署详情，完成「发布检查」
2. 点「___」
3. 弹出「___」

控制台 / 网络：
请求：___（例：POST /api/releases/…/chain/prepare）
状态码：___（例：500）
红色报错：___

已经试过：换网络 / 换设备 / 重新登录 / 清缓存（删掉没试过的）
第一次出现时间：2026-__-__ __:__（北京时间）

截图见附件。谢谢！

模板里永远不要填助记词、私钥、密码、预览密码或 API 密钥。官方也明确说不要发这些。

5. 防骗提醒

正经的官方和开发者不会私信你要助记词、私钥，也不会让你「验证钱包」「同步资产」。私信说帮你解决发布问题、让你连钱包或填助记词的，一律当骗子。
只在官方地址操作：https://app.tapenow.dev/。看清域名，别点群里陌生人发的「修复工具」链接。
不要给来路不明的工具无限授权（approve 额度无限）。钱包弹窗里看清是「签名」还是「交易 / 授权」：TapeNow 的归属证明是消息签名，不付款；真要转钱的才是交易。
以前给过的授权，可以用区块浏览器的授权检查页撤销，例如 BSC：https://bscscan.com/tokenapprovalchecker
发布用的钱包里只放够用的 BNB，大额资产放另一个钱包。

6. 资料来源

TapeNow 用户手册（0.9.x，含 03 / 正式发布）：https://app.tapenow.dev/docs/manual/
费用说明（2026-09-28 核对）：https://app.tapenow.dev/docs/fees.html
Gateway 指南：https://app.tapenow.dev/docs/gateway.html
A 公测说明与额度：https://app.tapenow.dev/docs/beta-a.html
TapeNow 公开仓库（Issue 模板、安全政策）：https://github.com/TapeNow/tapenow
tapeout.link 预览器与 frame 安全策略：https://tapeout.link/
本人 2026-10-07 起在 BSC 发布时的实测记录（报错横幅、OKB 预算、确认按钮、chain/prepare 500、MaxListeners 警告、访问入口待处理）。