Sandwave: 为Layerfs专门设计的一套UI界面

Đang mở
  • Có gì không ổn?
#421 1 bình luận 2 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
35/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
rust
Lĩnh vực
design, frontend

Hướng nghiên cứu

Start by reviewing the Sandwave interactive prototype at redesignlayerfs.vercel.app and the screenshots in the issue, then compare the proposed branch timeline, workspace views, and history navigation with LayerFS’s existing UI. The issue does not name source files or tests. Agree on the design direction and identify a small implementation scope with the maintainers; done would mean an agreed, working UI change that fits the existing technical design.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

new feature
Image

Sandwave 是我为 LayerFS 专门设计的一套多 Agent 活动展示界面：设计目标是提升多Agent复杂视图的Readability。

Design Citique

1. 术语多、信息量大，上手门槛高

首页的主体是原始命令日志和存储明细：C98、L9、ws/5、read-only、mounted … → /workspaces/4、142× dedup · 2.9× compression。这些满足了专业用户，但普通用户看不懂。我希望 LayerFS 能成为一款通用应用，所以这次的改动倾向于面向大多数用户。
UX 上也有问题：想看「现在正在发生什么改动」，要在 Work、History、各分支的标签页，以及 Storage / Sandboxes 子标签之间来回跳。

2. 多种视觉语言混在一起，抓不到重点

同一屏里有等宽字体的终端日志、彩色标签、虚线卡片、柱状图，以及枝叶隐喻的树（Branch / Commit / Layer）。颜色同时表示分支、agent、状态和警告，没有视觉重心，用户不知道该看哪。

3. 「现在」和「过去」被拆在不同页面

Work 只显示现在，History 只显示过去。用户没法顺着时间看一项改动是怎么发生的；回看历史时，也看不到当时有哪些 agent、在哪条分支上。

4. 分支一多就难以浏览

分支靠顶部标签切换，多出来的折叠进 +10，要逐个点开才能看到每条线程的状态。同一时间也只能看一条分支的工作区。

Solution

两层结构

首页满足大部分用户的日常需求；专业数据和信息放进详情页。

首页以Branch为骨架
Image
  • 每条分支是一行：左边是分支树，右边是它随时间展开的进度条。
  • agent 停在 Now 处，旁边是它当前在做的事（npm test、2 tests failing）。
  • 进行中的工作有流动的脉冲；多个 agent 在同一条线程上时，头像叠放，脉冲混合他们的颜色。
  • 修改和成果可以直观查看：点 agent 打开工作区，看终端输出和未提交的改动；每次提交是进度条上的一道标记。
渐进式揭露

默认只显示状态，用户关心哪里就点哪里：

悬停：显示名字
悬停：显示名字。		 点击浅色的历史进度条
点击浅色的历史进度条：查看那次 commit，以及它合并或发布到了哪里。
点 agent
点 agent：在底部打开工作区，可放大到全屏。		 点沙箱
点沙箱：列出其中的 agents。
一条时间轴贯穿现在和过去
Image Image

拖动 Now 把手或滚动条就能回到任意时刻，分支树和 commit 列表跟着回到那一刻；点 Follow 回到现在。

只展示用户最关心的数据
  • 节省了多少存储：实际占用 / 不用 LayerFS 时的体积，以及节省倍数。
  • Sandbox 的运行情况：开了几个、每个里有几个 agent，点开看各工作区在做什么。
  • Commits，也就是产出：按时间排列，可按 agent 筛选。
Image

写在最后

我没什么使用Github的经验，对流程和惯例还不太熟悉。如果 Issue 的写法、提出的方式，或者对 LayerFS 概念的理解有不对的地方，还请多包涵，也欢迎直接指出，我会马上改。

Sandwave 目前还只是一个设计提案和可交互原型，我很希望能和各位作者一起，把它变成 LayerFS 真正可用的界面：

先讨论方向：欢迎在这个 Issue 下直接评论，哪些部分认同、哪些不认同、哪些和现有的技术设计有冲突，我都会根据意见调整。
再分步落地：如果方向可行，我很愿意参与实现。可以先从最小的一块开始（比如首页的线程时间轴），按你们习惯的方式拆成几个小的 PR，代码结构和规范也会遵循你们的约定。

完整视频演示

https://drive.google.com/file/d/17s4hPhXmJZqLfXplDaO7JLGmjWTcTppO/view?usp=sharing

可交互demo

https://redesignlayerfs.vercel.app/

Ngôn ngữ chính
Rust
Star
2.1k
Fork
110
Merge trung bình
23 giờ 52 phút
Pull request đã merge (30 ngày)
138

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của Ephemeral-AI-Lab/layerfs

Tất cả issue của Ephemeral-AI-Lab/layerfs

Issue tương tự

Thêm issue về Rust

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.