跳到主要内容

证据映射 · ARC 2.0.0-beta.28

Showcase 映射

把 showcase-dsl / showcase 页面映射到 AUP primitive 与 widget 单元页，并说明如何本地跑 Showcase——不是全量托管。

本页是什么： 从本地 Showcase 路由到站内单元参考页的公开映射。
本页不是什么： 全量 Showcase 的生产托管、多能力 sample 合同正文，或第二份 API 手册。

Showcase 证明某份 ARC checkout 能演示某类型。它不自动成为 docs-safe 产品 sample。单元合同与 sample 诚实边界在：

  • /docs/aup/primitives/<name>/
  • /docs/aup/widgets/<name>/

内部全量清单（不对外路由）：content/docs/aup/capability-matrix.md §7。

两个 Showcase blocklet（ARC 仓库）

Blocklet角色规范来源
blocklets/showcase-dslDSL 编写的 companion（读 page 源优先）.aup/pages/*.aup、.aup/app.aup
blocklets/showcaseJSON 树 companion（页面集大体同构；重测试 fixture）.aup/pages/*.json、.aup/app.json

二者在 ARC 仓库（ArcBlock/arc），不在本站 blocklet。本站只链接单元文档，并说明如何本地跑 Showcase。

注册说明（showcase-dsl）

app.aup 加载 pages from "pages/*.aup" except [afs-list-searchable, degradation-demo, errors, globe]，另有 recipe 页 blocklet-settings、scaffold-app、afs-workspace。物理页文件可以存在但未注册。

本地运行 Showcase

使用含 blocklets/showcase-dsl（可选 blocklets/showcase）的本地 ARC checkout。命令与 运行、检查与查看、校验、运行与查看 同一直接运行模式：不要为这条证据路径部署 DID Space。

在 ARC 仓库根目录：

bash
arc --version
# 使用你打算对照的版本（文档矩阵基线：2.0.0-beta.28）。

# 推荐：只服务 showcase-dsl，并用 CLI 打印的 URL
arc service start --blocklet blocklets/showcase-dsl --port 4901

或在 blocklet 目录内：

bash
cd blocklets/showcase-dsl
arc blocklet run .

打开 CLI 实际打印的 host 与路径（常见为 *.localhost）。不要用其他机器或文档里猜的 host/port 替代。

JSON companion（需要已入库 JSON 树或既有测试 fixture 时）：

bash
# 在 ARC 仓库根
arc service start --blocklet blocklets/showcase --port 4902

仅在 ARC 仓库内改 DSL 源时再生成 JSON（Showcase 维护者）：

bash
pnpm dsl:regen blocklets/showcase-dsl

本站不把该生成流程写成 www.arcblock.io 的产品能力。

结束后停止

bash
arc service stop
# 或只停掉本次检查启动的 daemon —— 不要影响你仍需要的其他本机服务

主要 primitive 演示 → 单元页

下列 Showcase page id 是各跨设备 primitive 的常用入口。状态、document caps、降级与 sample 诚实边界打开单元页。

Showcase page id主要 primitive单元页备注
chartchartchartweb-full 演示；document 常 unsupported —— 读单元页
mapmap（+ globe widget）map · globeglobe 物理页可能存在但被 except
calendarcalendarcalendar
timetimetime
overlaysoverlayoverlaydocument 上多为交互 / experimental —— 读单元页
chatchatchat常与 afs-list 组合
devicesurfacesurface不是 Web Device docs-page surface
subsystemseditor、canvaseditor · canvas
explorerexplorer（+ AFS widgets）explorer · afs-list · afs-stat · afs-preview
list-basicafs-listafs-list · pagination widget另见下方 list-*
markdowntext / view / editortext · view · editorMD 渲染对照，不是 MD 单元文档
dashboardview、input、table、action、media、timeview · input · table · action · media · time组合页
form-contact / form-wizardinput、action、viewinput · action · view表单演示
rtc（§7 扫描无专用 page id）rtc用单元页 + 矩阵；不伪造 Showcase 行

Hub：全部 primitives · Primitive 分类。

主要 widget 演示 → 单元页

Showcase page id主要 widget单元页
prim-app-headerapp-headerapp-header
prim-app-footerapp-footerapp-footer
prim-key-value-listkey-value-list、tooltipkey-value-list · tooltip
financefinance-chartfinance-chart · chart primitive
moonphasemoonphasemoonphase
natalnatal-chartnatal-chart
commentscomments-surface（widget）comments-surface widget — 与 Web Device comments-surface surface 不同
auto-surfaceauto-surfaceauto-surface
wm-desktopwm（+ wm-surface）wm · wm-surface
tx-detailentity-overview、key-value-list、tooltipentity-overview · key-value-list · tooltip
openai-homeagent（等）agent

Hub：全部 widgets。

afs-list 变体页

Showcase page id焦点单元页
list-basic基础列表afs-list · pagination
list-pagination分页同上
list-template模板afs-list · text · media
list-grid / list-virtual布局模式afs-list
list-fields-row / card / compact / media / hero字段呈现afs-list · media · action
afs-list-searchable可搜索变体except 未注册 —— 仅物理页；证据仍映射到 afs-list

组合 / 复刻页（只映射，不当单类型 sample）

这些页为产品形演示组合多种 primitive。用于导航与交互证据，再按关心的类型各开一个单元页。

Showcase page id典型命中（非穷尽）起步单元页
indexhubview
content / portal / report / workspace多 primitiveview · table · afs-list
google / openai-home / openai-help / once / myvibe / unsplash / exposure布局复刻view · media · input
sh-climate … sh-livingsmart-home 系列view · table · input
session / session-chromeapp chromeapp-header
live-updates实时列表 / terminalafs-list · explorer · terminal
universal / supplementary / sharing组合surface · view
set-sugarDSL sugarafs-list · text · DSL 语言参考
blocklet-settings / scaffold-app / afs-workspacerecipe 页（非 pages/*.aup）见 ARC scaffold / settings shells —— 不是 layout-component 单元页

未注册的物理页

Page id注册用途
degradation-demoexcept降级链 —— 设备能力与降级 + primitive 单元
errorsexcept错误面 —— surface
globeexceptglobe（pages/ 下文件可能仍在）
afs-list-searchableexcept可搜索 afs-list 变体

没有专用 Showcase 页名的 widget

不要为仅以组合出现或根本没有专用页的 widget 伪造 Showcase 行。矩阵附录记录的例子包括 deck、frame、ticker、hero-widget、breadcrumb、chip 等。那些类型的证据在各自的 widget 单元页 与内部矩阵 —— 不在本映射里假造 page id。

本站 Markdown slides 走 MD 单元 + deck，不是 Showcase 页：实作：文章中的 slides。

如何与单元文档一起用

  1. 选定上方一个 Showcase page id，在本地 Showcase 中打开。
  2. 对你要断言的每个类型，打开链接的单元页。
  3. 若需要 www.arcblock.io 上的 docs-safe sample，那是另一道门槛（released + 单元页 sample 合同 / #304）—— 仅有 Showcase 不够。

相关