Propcore catalog
将你 Propcore 工作区中的项目、单元和实时可用情况带到你的 EmDash 站点。
插件
Propcore catalog
将你 Propcore 工作区中的项目、单元和实时可用情况带到你的 EmDash 站点。
描述
你的 Propcore 项目、单元和实时可用情况，直接呈现在 EmDash 站点中。从 EmDash 注册表安装，输入你的 Propcore 站点 slug 和来源密钥，你的页面就可以通过三条路由读取目录。projects 最多返回 100 个项目。units 每页返回 100 个单元；传入 cursor= 可获取下一页。availability 每次调用都会向 Propcore 发出一次实时请求，并且仅适用于已同步的项目。同步会在一次请求中读取整个目录；已用 119 个单元进行测试，更大的目录已在计划中。
路由
GET /_emdash/api/plugins/propcore/projects GET /_emdash/api/plugins/propcore/units?project= GET /_emdash/api/plugins/propcore/availability?project= (live)
响应为 “。字段与 Propcore 返回的完全一致（snake_case）。
安装
- 在 Propcore Admin 中，依次进入 Storefronts、New，然后选择 AI Source。选取要公开的 Views，创建后，从抽屉面板中复制站点 slug 和来源密钥。slug 是
.propcore.page之前的部分。位于工作区子域名下的站点，其 slug 带有点号，例如astra-demo.demo.propcore.page对应astra-demo.demo。 - 在 EmDash 管理后台中，进入 Plugins，然后进入 Registry。安装 Propcore catalog 并批准其能力（对
*.propcore.page的网络访问）。 - 在管理后台侧边栏中打开 Propcore，输入 slug 和密钥，Save，然后点击 Sync now。此后插件每小时同步一次。
常见问题
密钥会被暴露吗？ 不会。它以加密方式存储，只发送到你的 Propcore 站点，任何路由都不会返回它。
某个单元已从 Propcore 中消失，但仍在我的站点上。 每小时同步会添加和更新单元。在 Propcore 中被移除的单元目前尚不会从站点缓存中删除；这已在计划中。
需要哪种 Propcore 套餐？ 任何带有 storefronts 的工作区。
“Sync now” 与每小时同步有区别吗？ 没有，它只是立即运行同一个同步。
故障排除
保存失败，或密钥未被存储。 站点需要 EMDASH_ENCRYPTION_KEY 环境变量（格式为 emdash_enc_v1_...）来存储机密设置。请在站点的环境中设置它。使用 astro dev 时，.env 文件不会被加载到进程中，因此请先导出它：set -a; . ./.env; set +a; pnpm dev。
沙盒插件无法启动。 沙盒插件运行在 workerd 包上。使用 pnpm 时，请允许其构建脚本（allowBuilds: ）并安装它。
本地 pnpm add file: 安装已过时。 file: 会复制插件而不是链接它。每次构建后请重新添加。
状态显示 401 ...。 来源密钥已被轮换或撤销。请粘贴新密钥并 Save。
我应该输入哪个 slug？ .propcore.page 之前的部分，例如 astra-demo.demo。粘贴的地址会自动为你缩短。