应用市场

它是什么，以及如何打开

应用市场不属于主页面滑动区的五个页面之一。它以全屏浮层的形式覆盖在你当前所做的事情之上，并有自己的界面：首页、搜索、类别列表、资源页面和 我的库。

六种进入方式

设置中没有应用市场的入口。

如何在其中移动

• 返回就是系统返回手势。 在任何界面中，它都会回到 首页；在 首页 中，它会关闭应用市场（如果你是从编辑器进来的，则会回到编辑器）。屏幕上没有返回箭头。
• 第一次使用： 会出现三张卡片的欢迎页（精选目录、一键安装、你的库），带有 跳过、下一步 和 知道了。它只显示一次。
• 目录从哪里来： 来自 PocketCode 的服务器 api.pocketcodeapp.com。应用不内置任何目录，因此浏览需要联网。只有 我的库（已安装和已保存）可以离线使用。
• 账号： 浏览不需要账号，安装需要。编辑器的代码片段面板用应用自己的话说明了这一点：“登录后即可安装市场中的代码片段。浏览无需账号。”

首页

首页 是第一个界面。每个分区都并行加载，只有在有内容可显示时才会出现。下拉可刷新全部分区，也可以点 重新加载。如果什么都没加载出来，你会看到 无法加载应用市场 和 重试。

顶部是：搜索应用市场 输入框（它只负责打开搜索，输入在搜索界面里进行）、我的库 图标和 重新加载 图标。

搜索与筛选

点首页上的 搜索应用市场 输入框。键盘会打开，光标已经在输入框中。搜索在目录服务器上运行，你停止输入四分之一秒后刷新，或者在你按下键盘的搜索键时刷新。最多返回 30 个结果，以紧凑卡片显示。没有内容可显示时，你会看到 没有 “…” 的结果；如果服务器没有响应，你会看到 无法加载 和重试按钮，因此网络故障不会被误当成空结果。输入框为空时，搜索界面会列出 最近搜索（最多 8 条；只有按下搜索键时才会保存一个词）和 按类别浏览；清除 会清空输入框。

筛选

筛选 图标会打开 筛选结果，筛选条件生效时图标上会显示数字角标。种类 列出全部 12 种资源类型（包括插件和工作流），套餐 有 免费 和 Pro，类别 列出目录中的类别。每组最多选一个标签（再点一次可取消，或选 任意），然后点 应用；全部清除 会重置这三组。输入框为空时筛选同样有效，因此你可以列出，比如说，所有的 Pro 主题。

类别与「查看全部」

点一个类别标签（在首页或搜索中）或 查看全部，会打开一个以该类别或分区名称为标题的列表。它是一个卡片网格，滚动时每次加载 30 个。如果为空，你会看到 这里还没有内容 — 请稍后再来；如果网络失败，则会显示错误和重试按钮。要按类型缩小列表范围，请使用搜索中的 筛选。

排序方式 提供 热门（下载最多）、最新 和 评分。排序是在你的手机上对已经加载的内容进行的，因为目录服务器只按最近更新排序。列表总是从 热门 开始，从 新增和更新 的 查看全部 进入时也一样。

资源页面

点任意卡片即可打开该资源的页面。你做决定所需的一切都在这里，安装它的按钮也在这里。主按钮的作用取决于资源的类型（见下一节）。

标题栏与详情

• 标题栏。 它显示的是资源的类型（主题、页面、按钮……），而不是名称。右侧是：收藏、分享 和带有 举报 的 ⋮ 菜单。
• 摘要。 图标、名称、作者（点它可打开个人资料）和类别，然后是一行：评分（尚无评分时显示短横线）及评分数量、下载量和 类型（即免费或 Pro 档位），以 PRO 徽章或 免费 标签显示。
• 类型卡片。 一张卡片会告诉你主按钮会做什么：代码片段、编辑器配色主题、AI 斜杠命令、正则表达式包、MCP 服务器、AI 智能体角色、项目模板、可执行插件（也用于工作流）或 不支持的资源。
• 安装前预览。 如果目录提供了相关内容，主题、正则表达式包、MCP 服务器、提示词和智能体可以显示色板、示例表达式、启动命令或简短摘录。
• 截图与相似资源。 如果资源有截图，会接着显示；最后，与此相似（你可能喜欢的其他资源）列出目录推荐的相关资源。
• 收藏与分享。 收藏 会把资源保存到 已保存 下而不安装它（再点一次，即 取消收藏，可撤销）。分享 会通过系统分享面板发送 Name · https://pocketcodeapp.com/m/<slug>。
• 无法加载时。 你会看到失败请求的错误文本；如果没有错误文本，则显示 无法加载此资源。如果完全没有内容可显示，则显示 未找到资源。

安装、应用与保存

如果资源是 Pro 而你使用的是免费计划，整行安装按钮都会被 Pro 资源 卡片取代（见「免费、Pro 与主题试用」）。否则按钮取决于类型。安装进行时，按钮会变成加载转圈，避免双击重复触发，并且会有一条消息告诉你结果。页面不会把按钮改成“已安装”；变化的是 内容 标签页和评价输入框会出现。点按之后会发生以下事情：

1. 1如果资源声明了权限，会先打开 允许此资源…（见下文）。项目模板在下载任何内容之前，还会检查你的计划是否还有空间再容纳一个项目。
2. 2应用向 PocketCode 的服务器请求安装链接，并附上资源和你的应用版本。服务器会检查你是否已登录、资源的档位是否适合你的计划、你的应用是否足够新，然后返回一个有时效的签名下载链接。
3. 3应用下载资源包，并将其 SHA-256 指纹与服务器公布的指纹进行比对。如果服务器还提供了 Ed25519 签名，则会用应用市场的公钥进行验证。不匹配时，安装会停止，下载内容会被丢弃。
4. 4资源包会被解压到应用的缓存中。任何超过 512 MB 或 20,000 个文件的内容、任何膨胀到压缩大小 200 倍以上的内容，以及任何试图跳出其文件夹的路径，都会被拒绝。
5. 5资源会按其类型被应用（见下一节的表格），并添加到 我的库。
6. 6应用会告知服务器安装是否成功：资源 ID 以及成功或失败。

标签页

最多六个标签页，并非总是全部出现：

权限：只是警告，不是沙箱

当资源声明了权限时，点它的主按钮（或 复制 之类的次要按钮）会先打开 允许此资源…：“查看此资源可在你的设备上执行的操作。你可以选择仍然安装或取消。”它每项权限列一行，例如 读取你项目中的文件、修改你项目中的文件、发起网络请求、向你的编辑器插入代码、更改你的编辑器主题、读取或更改应用设置、向你的 AI 聊天添加可用工具、启动一个 MCP 服务器进程、运行 shell 命令、写入剪贴板 和 读取已存储的密钥 / API 密钥。对话框不认识的权限会以原始文本显示。MCP 服务器始终会列出 启动一个 MCP 服务器进程，即使它的清单中没有写。点 仍然安装 或 取消。

评价

评价 标签页列出公开评价，每次 20 条，带 加载更多：星级、日期和文字，不显示姓名。为空时：暂无评价。来发表第一条吧。 要撰写评价，资源必须已安装在此设备上：你的评价 卡片只有那时才会出现。选择 1 到 5 星，添加可选的文字（最多 1,000 个字符），然后点 发表评价。如果失败，你会看到 无法发布你的评价，请重试。

举报此资源

⋮ → 举报 会打开 举报此资源：“告诉我们哪里有问题。团队会审核每一份举报。”从五个原因中选择一个（恶意或不安全，默认选中；垃圾信息或误导；无法使用；不当内容；或 其他），添加最多 500 个字符的可选备注，然后点 发送举报。你会看到 感谢你的举报 — 我们会进行审核。 或 无法发送举报：…。应用不会告诉你举报之后会怎样处理。

作者与截图

• 作者。 点作者姓名会打开一个全屏面板，显示头像（如果有）、姓名、简介、目录将其标记为已验证时的 已验证作者 图标，以及 此作者的 N 个资源；点其中一个即可打开它的页面。应用通过根据姓名派生的 slug 来查找作者；如果失败，你会看到 无法加载此作者的个人资料。
• 截图。 它们以一行缩略图显示。点一张可全屏查看，点图片切换到下一张（会循环），用关闭按钮退出。应用会显示目录提供的所有截图。

12 种资源类型

目录有 12 种资源类型。筛选 会列出全部 12 种；如果某个资源的类型是这个应用版本不认识的，则会显示一个禁用的 不支持的资源 按钮。下表给出了每种类型的主按钮，以及安装会做什么。

如果资源的类型是这个版本不认识的，会显示“此资源使用了应用尚不识别的类型。请尝试更新 PocketCode。”你安装的所有内容也都会列在 我的库 中。

MCP 服务器默认处于关闭状态

MCP 服务器是一个以与 PocketCode 相同的权限运行的 Node 进程，所以应用市场绝不会替你启动它：

1. 1点 连接 MCP 服务器。应用会检查启动命令行：只接受 node 或 npx，并拒绝会运行代码的参数（-e、--eval、-p、--print、-r、--require、--import、--loader、--experimental-loader，对 npx 还包括 -c 和 --call）。变量 NODE_OPTIONS 和 NODE_PATH 会被丢弃。真正能启动的只有 node 服务器：应用没有 npm，所以 npx 服务器会以关闭状态安装，你打开它时，设置里会显示“npx is not available: npm is not bundled with the app”。
2. 2服务器会被保存为 关闭且等待确认 的状态，并有一条消息指引你前往 设置 > MCP。该界面名为 MCP 服务器。
3. 3在那里把服务器打开。一个标题为 这个服务器会在你的手机上运行 的对话框会显示启动命令行，并说明它以与 PocketCode 相同的权限运行。只有点 运行 才会启动；取消则保持关闭。一旦你确认过，它在之后每次启动应用时都会随应用启动，不必每次再打开 设置 > MCP。
4. 4如果资源的后续版本改变了命令、参数或环境变量，服务器会重新变为关闭状态并再次询问。如果没有任何变化，则保留你之前的决定。

我的库

点首页上的 我的库 图标。这些列表来自你手机上的数据库：每一行都是你安装或收藏过的内容。已安装和已保存可以离线使用；更新需要联网。

更新、已安装和已保存

• 已安装（N） 列出安装在此设备上的所有内容。每行显示类型图标、名称、“类型 • 作者 • 版本”和两个图标：重新应用 和 移除。为空时：尚无安装项。
• 已保存（N） 列出你收藏的资源，无论是否已安装。取消收藏 会把一个资源取消收藏；对于未安装的资源，它还会把它从库中移除。为空时：没有已保存的项目。
• 更新（N） 只在有内容存在更新版本时才会出现。当你打开我的库时，应用会通过一次批量请求向目录询问你所有已安装内容的最新版本（下拉可再次检查），并比较版本号。每行显示 v1.0.0 → v1.1.0。行上没有更新按钮：点这一行打开资源页面并重新安装，即可下载最新版本。如果检查失败，会保留上一次成功的结果，而不是声称一切都是最新的。

重新应用与移除

重新应用 使用已经存储在手机上的资源包，无需下载。移除 不会要求确认，并显示 已将 … 从你的库中移除。两者具体做什么取决于类型：

应用市场偏好设置

• 齿轮图标（库设置）会打开 应用市场偏好设置。
• 自动更新资源 默认关闭：“每天在 Wi-Fi 下充电时，为库中已有的每个资源安装新版本。”它会检查版本，并且只下载带有有效 Ed25519 签名的资源。更新会悄悄进行：代码片段、页面和按钮只会刷新存储的副本；主题的颜色会被刷新，但不会切换你的主题；模板绝不会再创建一个项目；提示词、正则表达式包、智能体和组件会被原地重写；启动命令行有变化的 MCP 服务器会重新变为关闭状态。如果至少有一个资源完成了更新，你会收到一条 应用市场已更新 通知，受你的通知设置和免打扰时段限制。
• 兑换促销码：输入兑换码（最多 40 个字符，输入时会自动转为大写），然后点 兑换。成功时你会看到 已添加 N 天 Pro — 尽情享用。 错误信息列在「故障排查」中。

发布

你不能在应用内发布资源。没有上传界面，没有 发布 按钮，也没有任何能解锁它的 Pro 功能。在手机上，目录是只读的，PocketCode 团队通过内部仓库和自动化检查在应用之外发布其内容。

免费、Pro 与主题试用

应用市场本身没有计划限制。取决于你的计划的是：资源自身的档位、模板的项目上限，以及编辑器代码片段面板的自定义代码片段上限。

Pro 资源与 5 分钟主题试用

• 在免费计划下，Pro 资源上的安装行会变成 Pro 资源 卡片：“订阅 PocketCode Pro 即可安装。”并带有 获取 Pro，它会打开付费墙。描述、截图、评价和标签页仍然可见。如果服务器回应该资源需要 Pro，你同样会进入付费墙。
• 在 Pro 主题上，如果可用，你还会得到 试用主题 5 分钟。它会应用该主题，并在五分钟后恢复你之前使用的主题；计时器在关闭应用后依然有效。每个主题每台设备只有一次试用机会，并且同一时间只能有一个。
• 项目上限会显示为 无限项目：“免费计划包含一个项目，且已被使用。升级到 Pro 以添加更多项目，或删除不再需要的项目。”不会下载任何内容，也不会被计为一次安装。