跳转至

可重排序集合系统规格

{
  "paths": ["packages/core/src/**", "packages/lab/src/**"]
}

意图

createReorderable 应用于整个集合:其对象作为集合的 reorderable prop 传入,或附加到普通元素的容器上(FR4b)。逐项控制来自每一项的 key(itemKey,或集合已有的身份标识)以及 isReorderable(key)。

用户可以通过拖拽行的手柄、键盘或屏幕阅读器来更改集合中项目的顺序,并且每个允许这样做的集合都以相同的方式运行。调用方通过将 createReorderable 一次性创建的行为对象传给集合的 reorderable prop,或将其附加到普通元素上,来开启重排序,并应用它报告的变更。不重排序的集合不会加载其中的任何部分。

非目标

  • 一次拖动多个项目、目标谓词、集合实例之间的移动;每一项都可以在以后添加,而无需更改此契约。
  • 集合之间的项目移动、自由画布放置和文件拖放。
  • 重排序的运动值、阈值和时序:这些保持内部(spec:AST-002 FR3),来自主题的运动角色和 spec:AST-094 的测量值。
  • 移动行的视觉处理和插入提示由 design:ordered-collection-reordering 负责。

公共契约

import {createReorderable} from '@astryxdesign/core';

const moveTo = (items, key, to) => {
  const moved = items.find(item => item.id === key);
  const rest = items.filter(item => item.id !== key);
  return [...rest.slice(0, to), moved, ...rest.slice(to)];
};

const reorderable = useMemo(
  () =>
    createReorderable({
      onReorder: ({key, to}) => setItems(items => moveTo(items, key, to)),
    }),
  [],
);

<Button label="Move" onClick={() => reorderable.start(selectedId)} />
<List reorderable={reorderable}>
  {items.map(item => (
    <ListItem key={item.id} itemKey={item.id} label={item.name} />
  ))}
</List>;

第二个集合使用同一个对象和选项,连接到其自身的内部机制。树将位置报告为父级和一个索引:

const reorderable = createReorderable({
  onReorder: ({key, to}) => setTree(tree => moveNode(tree, key, to)),
});

<TreeList reorderable={reorderable} items={tree} />;

这里 to 为 { parent, index },key 是节点已有的 id;手柄、key、操作和公告与 FR3 和 FR4 中的相同,树不添加任何选项。

在没有 React 的情况下,同一个对象会附加到普通元素:

const {detach} = reorderable.attach(listElement, {
  items: () =>
    cards.map(card => ({key: card.id, element: card.el, handle: card.grip})),
});

需求

  • FR1 — 一个工厂函数生成该行为。 createReorderable(options) 返回一个可重排序对象。options 携带变更回调 onReorder({ key, to })、可选的 isReorderable(key) 谓词,以及 可选的 positions(),后者为诸如扇形展开的手牌或自定义网格等布局提供放置位置;已由测量布局放置的集合不需要它。 positions() 按项目顺序为每个项目返回一个 {x, y}:该项目槽位的中心, 以集合容器框左上角为原点的像素坐标。一次拖拽会将 to 报告为放置范围内中心点最接近被拖拽项目中心点的槽位, 并且被放置的项目会落在该槽位的中心。 长度与项目数量不同的数组会被忽略,树中的 positions 同样会被忽略; 随后放置位置来自测量布局。 实现差距:尚未构建;positions 目前不存在,因此放置位置始终来自测量布局。 在没有 positions 时,放置位置来自测量布局; 在回调中,key 用其 key 来命名被移动的项目,to 是该项目移动后在集合完整项目顺序(所给予的每个项目,无论是否挂载)中所处的索引。在 树中,to 为 { parent, index }:parent 是新父级的 key(根节点为 null),index 是移动后该项目在该父级子项中的位置(DEC-3)。它不携带任何手势、动画或时序设置。可选的 isReorderable(key) 谓词将某行保持在原位:被它拒绝的行不显示手柄且无法被拿起(DEC-2)。被它拒绝的位于集合任一端的行也会限定放置范围: 没有任何内容可以放到它之外,键盘或辅助技术的越界移动会被拒绝并播报(FR4)。 每个项目的 key 都来自数据,绝不来自 React 的 key:List 读取每个 ListItem 的 itemKey(字符串或数字,即 Table 的 idKey 返回的形状),onReorder 按原样报告该 key;项目已带有身份标识的集合(如 TreeList 的 id 或 Table 的 idKey)直接使用它;而没有身份标识的数据集合则采用 Table 形状中的 idKey,即字段名或项目的函数(DEC-4)。没有 key 的行不显示手柄且无法被拿起。该对象意在为每个集合创建一次,例如使用 useMemo;每次渲染时重新创建也能正常工作,因为集合在移动提交时会使用最新的回调,而拖拽过程中的新对象不会取消拖拽。同一个对象传给两个集合,或附加到两个容器时,会各自独立重排序,不会在它们之间移动任何项目;其 start 以最后挂载或附加的那个为目标,并发出开发警告。该对象在注册的 key 下携带其机制,因此包与 swizzled 副本能就它达成一致(spec:AST-110 FR3):一个 swizzled 的 List、TransferList 或 ListInput 能读取包创建的对象,而包也能读取由副本适配的对象。options 还接受 labels?: ReorderableLabels,其中包含该对象播报或显示的每个字符串(architecture:internationalization INV3a):
  • 公告(announcements):pickedUp 和 dropped(一次拖拽的拿起与放下,包含位置和计数),cancelled(被取消的拖拽,回到其位置),place、placeAtTop、placeAtEnd、placeInGrid 和 placeInTree(FR4 的移动公告,placeInTree 会加上父级),refused(越过被拒绝行的移动),notMoved(FR4b 中应用未执行的移动),modeDone(离开重排序模式),以及 unnamedItem(公告对无文本项目的称呼,如“Item 2”);
  • 显示标签(shown labels):handle(手柄的名称,“Reorder”和项目的标签),handleVerb(单独的“Reorder”,在该标签本身作为手柄名称时于行自身的标签之前读出),unnamedHandle(无文本项目的手柄,如“Reorder item 3”),handleHint(手柄对拖拽和重排序模式的描述),moveUp、moveDown、moveLeft 和 moveRight(提示中的移动按钮),以及 done(提示中的 Done)。

每个键都是可选的。缺失的键会回退到目录消息:当集合在 provider 下渲染时,该消息会被翻译;在没有 provider 时则为英语;如果提供了字符串,则会替换该消息,包括覆盖 provider 的翻译。带模板的消息的键采用目录中带有相同参数的 ICU 模板,例如 place 的标签、位置、数量和邻居,或 dropped 的位置和数量。实现缺口:尚未构建;labels 尚不存在,因此每个字符串都是目录中的。

  • FR2 — 存在即启用。 接受重排的集合通过一个 reorderable prop 接收该对象;没有单独的布尔值。当该 prop 缺失时,集合不渲染手柄、不注册重排监听器、也不加载重排代码:在传入该对象之前,集合不会导入其中任何内容。
  • FR3 — 每个集合的拖拽方式都相同。 每个采用该对象的集合都将其接入自身的内部拖拽、键盘和辅助技术路径,并且所有集合中的行为都一致:
    • 拖拽从行的拖拽手柄开始(design:ordered-collection-reordering DR1);使用鼠标,或使用主指针为精细的触控笔时,从手柄开始的拖拽无需按住即可启动;使用手指,或使用主指针为粗略的触控笔时,则需要保持按住,这会在 spec:AST-094 的值处拾起该行,且快速滑动仍然会滚动;
    • 在滚动容器边缘附近保持拖拽时,会向该边缘滚动,越靠近越快,并在到达末尾时停止;
    • 一次拖拽在放下时(DR4)只提交一次,并为此调用一次 onReorder;被取消的拖拽不调用任何内容;
    • 在“减少动态效果”下,移动中的预览仍然跟随手指或指针,其余行和放置位置则直接就位,不发生移动(design:reduced-motion DR1–DR3;鼠标放下在主指针为粗略时遵循 DR2,否则遵循 DR3)。
  • FR4 — 重排模式是不需要拖拽的唯一路径。 每个可重排行的手柄都是一个开关按钮,名称为“Reorder”加上该行的标签,并带有 aria-pressed。通过点击、Enter 或 Space 激活它,会进入该项目的重排模式,鼠标、键盘和辅助技术都可以使用它(spec:AST-094 FR39)。在重排模式中:
    • 方向键沿布局轴移动项目:在垂直集合中 Up 和 Down,在水平集合中 Left 和 Right,在二维布局(如网格或自动换行的面板)中则四个方向键都可用;其中 Left 和 Right 按阅读顺序移动到上一个和下一个位置,在 RTL 布局中镜像反向,Up 和 Down 移动到上一行或下一行的同一列,若该行较短则移动到该行的最后一个位置;行和列来自测量后的布局,to 始终是完整顺序中的最终索引;在树形结构中,Up 和 Down 在可见位置之间移动,Left 和 Right 在 isReorderable 允许的情况下将项目移出或移入父级;
    • 每次移动都会立即通过 onReorder({ key, to }) 提交,因此数据、屏幕和播报始终一致;
    • 每次移动在渲染后都会通过共享的 polite 播报通道播报一次;在模态框内时,按照 spec:AST-086 FR14 的要求进行,播报中会命名该项目、它的位置和数量以及它的邻居,例如“Milk, position 3 of 5, after Eggs, before Bread”;第一个和最后一个位置会说“at the top”和“at the end”;二维布局会加上行和列,例如“Milk, row 2, column 3, position 8 of 12”;树形结构则加上父级;
    • 当移动越过集合任一端处被 isReorderable 拒绝的行时,该移动会被拒绝并播报,例如“Can't move past Pinned”;中间被拒绝的行会被跳过,就像拖拽跳过它一样(FR1);
    • 焦点停留在手柄上,并且该行滚动到视野中;
    • Escape,或再次激活手柄,会退出重排模式并保留所有移动,同时播报“Done”及项目的位置,例如“Done, Milk at position 3 of 5”;
    • 当项目处于重排模式时,拖拽显示的同一条强调插入线会标记该项目的位置,并随每次移动而移动(design:ordered-collection-reordering DR7);
    • 当项目处于重排模式时,一个锚定到该项目上的提示会显示其轴向的移动操作和一个 Done 控件,使用与 Core 键盘提示相同的层、锚定和主题角色,并一直保持到模式结束;提示中的每个移动操作都是一个按钮,功能与其对应的键完全一致,具有相同的播报且焦点保持在手柄上;Done 与 Escape 一样退出模式,因此指针或手指可以通过依次点击手柄、移动按钮和 Done 来重排;
    • 该提示是每个采用集合的 anatomy 中命名的一个部件;它是一个遵循 family:overlay-dismissal 的层;它使用 Core 键盘提示的层、锚定和主题角色,其公共 API 不变;与该提示不同,它的按钮接受点击,并向辅助技术公开。
  • FR4a — 应用可以启动重排模式。 该对象暴露 start(key),它会从应用自己的 UI(例如工具栏按钮或菜单中的“Move”项)进入 FR4 中该项目的重排模式。焦点移动到该项目的手柄上,手柄会滚动到视野中,提示出现,播报和退出行为均与 FR4 相同。一个不可重排、未挂载或未找到的键不会执行任何操作,并在开发环境中发出警告。模式通过 Escape、Done、手柄或项目卸载而结束,因此没有 stop。除了 FR4b 的 attach 之外,该对象上没有其他公开 API;start 和手柄进入相同的模式。
  • FR4b — 普通元素无需 React 即可 attach。 该对象暴露 attach(container, {items}),其中 items() 按顺序为每个项目返回一个 {key, element, handle},它返回 {detach}。实现缺口:尚未构建;该对象目前还没有 attach。已 attach 的容器会获得 FR3 的拖拽、每个手柄上的 FR4 重排模式以及相应的播报,而无需集合组件;positions 和 isReorderable 的适用方式与集合相同。attach 为每个 handle 赋予 FR4 的角色和切换状态,并用“Reorder”和项目名称来命名它:优先使用项目元素的可访问名称,否则使用其文本内容;当两者都为空时给出开发警告;它把每个手柄放入 Tab 键顺序中;被拒绝项目的手柄,或没有 key 的项目的手柄,不会获得这些,也不会启动拖拽;start(key) 可以像作用于集合项目一样作用于已 attach 的项目;并且 attach 会将 FR4 的提示渲染为它拥有的元素。当 onReorder 之后 items() 报告新顺序时,一次移动即告提交:attach 随即播报并播放放下(drop)效果;当容器被模态对话框包围时,attach 会通过该对话框内的一个持久的 polite 容器进行播报,正如 spec:AST-086 FR14 为 Astryx 模态框所规定的那样;如果在运行 onReorder 的任务结束时顺序没有改变,则此次移动会被拒绝并播报,例如“Can't move King of hearts”。一旦移动提交,attach 会根据 items() 返回的结果聚焦被移动项目的手柄,并将其滚动到视野中,因此无论应用如何移动或重新渲染该项目,焦点都保持在该手柄上。attach 从对象的 labels(FR1)获取每个字符串,缺失的键回退到随附的英文目录,并以 provider 外部的组件的方式格式化数字(architecture:internationalization INV3、INV3a)。实现缺口:尚未构建;attach 目前对所有字符串都使用随附的英文目录。detach 会结束任何进行中的拖拽或重排模式,不调用任何内容,并移除 attach 添加的每一个监听器、观察器、定时器、元素(包括该容器)和属性,恢复每个手柄自身的角色、名称和 Tab 键顺序;并且创建或导入该对象不会执行任何 DOM 操作,因此在服务器上是安全的。
  • FR5 — 重排最多给一行增加一个元素。 添加的那一个元素就是手柄,即交互式拖拽目标,带有其角色。它的握柄是装饰性的,由伪元素或主题角色字形绘制,而不是由元素绘制。在一行被拖拽时,源行保持在原位并变暗,一个移动中的预览跟随指针(design:ordered-collection-reordering):该预览是 architecture:component-style-authoring INV7 允许的唯一临时副本,它是惰性的、对辅助技术隐藏,并在放下时移除。重排监听器按集合级别或挂在 document 上,绝不会按行(spec:AST-094 FR24)。
  • FR6 — 从一开始就稳定。 createReorderable、它的选项以及集合的 reorderable prop 是稳定的公共 Core API:没有 _experimental 名称,也没有实验性子路径(DEC-1)。spec:AST-017 FR21 和 DEC-28 仅适用于被选为实验性的 API。
  • FR7 — 被承认并记录为公共 API。 reorderable 是调用方的意图,任何集合都无法自行推导(spec:AST-002 FR1、DEC-1),其阈值保持为内部实现(spec:AST-002 FR3)。createReorderable 有自己规范的描述符,每个采用集合的描述符都会记录 reorderable(spec:AST-039 FR1、FR3)。
  • FR8 — 一种公开形态即可完成该任务。 进行重排的集合使用此对象,而不使用任何其他公共重排 API。

当前状态影响

  • component:List 成为 reorderable 的首个采用者。
  • 目前 Core 中没有任何集合支持拖拽重排。Tokenizer 报告了一个 reorder 变更(spec:AST-056);将其纳入此对象是后续工作。一个支持重排的 Lab 集合会采用此对象。

验证

契约 验证 代表性状态 变更或失败预期
FR1、FR6–FR8 公共 API 审查、类型测试和描述符检查 工厂的选项(包括 ReorderableLabels 的键);集合的 reorderable 类型;工厂和 List 的描述符 额外的手势、时序或动画选项;实验性名称或子路径;缺失的描述符;第二个公共重排 API;对象宣布或显示但没有任何 labels 键可替换的字符串;或翻译器选项——均会导致失败
FR1 副本 加载 List 重排上下文及内部重排条目的第二份副本的单元测试 副本 List 读取包创建的对象;包 List 读取副本条目适配的对象 副本在包放置机制的位置读取到 undefined(无论哪个方向),均会导致失败
FR2 对带和不带该 prop 的集合进行打包与运行时检查 不带该 prop;带该 prop 在不带该 prop 的情况下,对打包文件中的代码、句柄或重排监听器进行重排会失败;测得的成本记录在拉取请求中
FR3 使用真实触摸输入和鼠标的浏览器测试(spec:AST-013 FR10) 按住并拖拽;轻弹;放置;取消的拖拽;Reduce Motion;带有自定义 positions 的扇形手掌;不带这些的列表;长度错误的 positions 数组;带 positions 的树;自定义 positions 与一个被拒绝的末尾行;在精细和粗糙主指针上的笔拖拽 从手柄外开始的拖拽、放置前的提交、一次拖拽产生两个回调、取消时的回调、Reduce Motion 下的移动、忽略正确长度 positions 的放置、长度错误的数组或放置并非来自测量布局的树、超出放置范围的放置、鼠标拖拽、在精细主指针上等待长按的笔拖拽、在没有长按的情况下开始的粗糙主指针笔拖拽,或者不带 positions 但行为发生变化的调用——均失败
FR3 autoscroll 使用鼠标在滚动边缘附近按住拖拽的浏览器测试,以及自动滚动步骤及其计时器的单元测试 一行被按住并停留在页面底部边缘附近,直到列表末尾进入视野;一行被按住并停留在列表滚动所在容器的底部附近;在越过边缘的每种深度下的步骤;处于边缘的计时器 在边缘附近按住拖拽时,如果出现以下情况则失败:不滚动任何内容;在某个容器持有列表时滚动页面;滚动远离边缘;在靠近边缘时保持同一速度;或滚动超过末尾
FR4 对重新排序模式进行键盘、鼠标和公告路由测试(spec:AST-009 FR17) 通过单击、Enter 和 Space 进入;在垂直、水平和网格集合中使用箭头键;在树中使用 Up、Down、Left 和 Right;每次移动在顶部、中间和末尾的公告;越过被拒绝的行的移动;Escape 和第二次激活;每次移动后的焦点和滚动 如果出现以下情况则失败:移动没有立即提交;公告缺失、重复或在渲染前出现;移动越过位于任一端被拒绝的行,或列表中部的被拒绝行阻挡了移动;焦点离开手柄;或退出时移动被撤销
FR4 hint 使用鼠标、手指和键盘的浏览器测试 提示在垂直、水平和网格集合中的轴;每个移动按钮和 Done;仅通过点按进行的重新排序;提示的主题角色 提示偏离键盘提示的层、锚定或主题角色,忽略点按或对辅助技术隐藏的按钮,按钮的移动或播报与其键位不符,焦点离开手柄,或提示在模式结束后仍然存在,则失败
FR4 two-dimensional 在换行的卡片网格上,从左到右和从右到左进行键盘和播报路由测试 跨越行末的左和右移动;在完整行之间以及向较短的末行进行上和下移动;带有行和列的播报;提示的四个按钮;改变列数的尺寸调整 偏离阅读顺序的移动、在从右到左布局中错误的镜像方向、未钳制在其最后位置的短行移动、缺失的行或列,或列数并非依据布局读取,则失败
FR4a 对 start(key) 的键盘、鼠标和通告路由测试 从上下文菜单项和工具栏按钮触发 start;一个不可重新排序、未挂载或未知的 key;每次渲染都会重新创建的对象;同一对象同时位于两个集合中 以下情况均属失败:start 未聚焦并滚动到手柄;提示或通告与手柄的模式不同;缺失 key 的调用抛出异常或产生行为;跨两个集合调用但未给出开发警告。
FR4b 在普通元素上使用鼠标、手指、触控笔和键盘对 attach 进行浏览器测试,并检查 detach 后的监听器数量 一次拖拽、一次被取消的拖拽、重新排序模式、带 positions 的扇形布局、应用采纳的一次移动和应用未采纳的一次移动、拖拽中途的 detach、服务端导入、以另一种语言显示的页面(分别提供了全部 labels key 和未提供任何 key)、provider 下的给定 key、没有可访问名称的条目元素、被 isReorderable 拒绝的条目、无 key 的条目、对已附加条目调用 start(key)、带自身 tabindex="-1" 的手柄、页面打开的模态对话框内的容器、附加到两个容器上的同一个对象、在精细主指针和粗粒度主指针上的触控笔拖拽、应用通过移动条目元素采纳的一次移动和通过重新渲染条目采纳的一次移动 普通元素上缺失拖拽、模式或通告;手柄缺少 FR4 的角色、按下状态或名称,或在条目有文本时被单独命名为“Reorder”,或位于 Tab 键顺序之外;被拒绝或无 key 的条目,其手柄是 Reorder 切换器或可被拖拽;start(key) 未到达已附加的条目;在 items() 报告移动之前就宣告了该移动,或应用未采纳且未被拒绝的移动;detach 后拖拽或模式仍在运行,或仍留有监听器、观察器、提示元素、手柄属性或变更后的 Tab 键顺序;通告字符串不是其给定的 labels key,或在未给定时不是随附英文目录中的字符串;页面打开的模态对话框内仅到达页面主体通道的通告;未给出开发警告就在两个容器之间移动,或在那里调用 start;在精细主指针上等待长按的触控笔拖拽,或在粗粒度主指针上无需长按即启动的触控笔拖拽;移动后焦点不在被移动条目的手柄上;或导入时的 DOM 操作失败。证据缺口:labels 尚未构建,因此目前尚无测试覆盖给定的 key。
FR5 带有和不带该 prop 的列表的元素与监听器数量 静止的行;被拿起的行;被放下的行 每行不止一个新增元素、用元素绘制的拖动手柄、每行一个监听器、第二个预览、离开其位置的源、拖放后留下的预览,或可被辅助技术访问到的预览,即失败

决策日志

DEC-1 — Reorderable 是稳定的公共 API

参考: spec:AST-103/DEC-1 决策者: cixzhang, 2026-10-25

重排序是调用方依赖的一种能力,因此 createReorderable 和集合的 reorderable prop 从一开始就是稳定的公共 API,没有实验性名称或子路径。

已否决:先以实验性功能发布。

DEC-2 — 谓词使行保持在原位

参考: spec:AST-103/DEC-2
决策者: cixzhang、2026-10-25

某些行不能移动,例如固定的首行,用户应当事先看到这一点。可选的 isReorderable(key) 谓词会标记这些行:该行不显示手柄,也无法被拿起,正如 UIKit 表格的 canMoveRow 所做的那样。此命名遵循 Astryx 的 is… 谓词约定。

已否决:不提供逐行控件,而是拖放后忽略不想要的移动。

DEC-3 — 移动通过其键来命名项

参考: spec:AST-103/DEC-3
决策者: cixzhang、2026-10-25

onReorder 接收被移动项的键及其新位置,isReorderable 接收一个键,因此该契约在所有地方都以键来命名项。当列表被虚拟化,或树在父级之间移动项时,键仍然保持正确,而一对索引则做不到。调用方若过滤了传入的项,则会将 to 映射回其完整列表。

已否决:onReorder(from, to) 使用一对位置。

DEC-4 — 重排键来自数据

参考: spec:AST-103/DEC-4
决策者: cixzhang、2026-10-25

React 不会将 key 传给组件,因此集合不能依赖它。ListItem 通过一个 itemKey 属性来命名其项;而没有自身标识的数据集合,则在 Table 的 shape 中采用 idKey,即一个字段名或一个作用于该项的函数,从而同一职责保持同一名称。itemKey 是一个新名称,因为当前没有任何行属性承载项的标识:类似选项的行上的 value 是表单读取的选中值,属于另一职责。其项已带有标识的集合(如 TreeList 的 id 或 Table 的 idKey)会使用该标识,而不是再引入第二个,因为没有新 API 与现有 API 分担同一职责。

已否决:读取每个直接子项的 React key。

DEC-5 — 重排模式(而非移动菜单)是无需拖拽的途径

参考: spec:AST-103/DEC-5
决策者: cixzhang、2026-10-25

移动菜单对键盘用户来说很累。手柄改为切换一种重排模式,在该模式下,方向键移动项,并且每次移动都会连同其位置和相邻项一起播报。每次移动都会立即提交,因此离开该模式会保留这些移动,应用也绝不会撤销多次提交;焦点会停留在手柄上,直到按下 Escape 或再次激活。

当该模式开启时,锚定在该项上的提示会显示移动操作和“完成”,其图标为按钮,因此不想拖拽的有视力用户也可以通过点击完成同样的移动;它重用键盘提示的层级,而不是采用第二种提示模式。

已否决:提供“移到前面”和“移到后面”的菜单。

DEC-6 — 一个 labels 对象容纳所有字符串

参考: spec:AST-103/DEC-6
决策者: cixzhang、2026-11-01

没有 provider 的页面(例如挂载普通元素的页面)仍然需要自己的语言,而该对象会播报并显示许多字符串。一个可选的 labels 对象容纳所有这些字符串,每个键都会回退到目录消息,正如 architecture:internationalization INV3a 对包含多个字符串的工厂所规定的那样;翻译本身仍由 provider 负责。

已否决:提供翻译函数选项,以及每个字符串一个扁平选项。

开放问题

无。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 as/astryx