schnsrw/casual-sheets

Casual Sheets

类Excel在线表格，支持实时协同编辑

基于https://github.com/dream-num/univer%EF%BC%88Apache-2.0%E5%8D%8F%E8%AE%AE%EF%BC%89%E5%BC%80%E5%8F%91%EF%BC%8C%E5%8D%95%E9%95%9C%E5%83%8F%E9%9B%86%E6%88%90Web%E5%BA%94%E7%94%A8%E3%80%81Hocuspocus%E5%8D%8F%E4%BD%9C%E6%9C%8D%E5%8A%A1%E5%92%8CFastify%E6%9C%8D%E5%8A%A1%E5%99%A8%E3%80%82

源码： https://github.com/schnsrw/sheets  ·  单用户演示： sheet.schnsrw.live  ·  文档： schnsrw.live/docs/sheets/

---

快速开始

sh
# 内存模式（重启后房间消失，适合快速试用）：
docker run --rm -p 3000:3000 schnsrw/casual-sheets:latest
# 访问 http://localhost:3000

推荐：使用Redis持久化

sh
docker compose up -d
# 访问 http://localhost:3000

若未克隆仓库，可使用以下docker-compose.yml：

yaml
services:
  app:
    image: schnsrw/casual-sheets:0.1   # 滚动更新小版本（自动获取补丁更新）
    restart: unless-stopped
    ports: ['3000:3000']
    environment:
      REDIS_URL: redis://redis:6379
      ROOM_TTL_MIN: '15'
    depends_on:
      redis:
        condition: service_healthy

  redis:
    image: redis:7.4-alpine
    restart: unless-stopped
    command: ['redis-server', '--appendonly', 'yes']
    volumes:
      - redis-data:/data
    healthcheck:
      test: ['CMD', 'redis-cli', 'ping']
      interval: 10s
      timeout: 3s
      retries: 5

volumes:
  redis-data:

---

协同编辑表格

1. 打开http://localhost:3000，点击文件 → 分享协同编辑…，设置密码和角色，获取两个分享链接。
2. 将任一链接粘贴到其他浏览器或设备，加入者会在标题栏头像栈中显示（约1秒内）。
3. 移动选区时，同伴可见你的命名光标；在单元格输入时，同伴实时看到字符。

***会话，无需账户。房间地址为/r/<roomId>。

---

核心功能

• Office风格功能区：首页、插入、公式、数据、视图、审阅标签页
• 全格式往返支持：xlsx/ods/csv/tsv，通过Web Workers解析和序列化，主线程不阻塞
• .xlsm宏与数据透视表：通过OOXML透传实现字节级一致（54/54测试用例无损坏）
• 图表：插入对话框、8种图表类型、趋势线、日期轴检测、拖拽调整、格式对话框、协同同步、xlsx嵌入PNG
• 数据透视表：多行紧凑布局、筛选字段、钻取（Ctrl+Shift+D）
• 迷你图：折线/柱形/盈亏，单元格内显示，xlsx往返支持
• 条件格式、数据验证、绘图：往返支持且协同同步
• 自动保存：保存到IndexedDB，重新加载时显示恢复提示
• 版本历史：自动快照，一键恢复（单用户模式）
• 协同编辑：实时光标、实时输入预览、在线状态头像、密码保护房间
• 视图权限控制：Univer引擎层（服务端onAuthenticate）强制只读
• 会话历史面板：按房间操作日志，可查看或回滚更改
• 同步状态检测："同步中"提示与"等待重连"横幅
• 11种模板库：个人/工作/财务/教育等场景
• 移动端支持：查看器+轻编辑器，触摸滚动、底部操作栏、小屏幕适配
• 357+ Playwright端到端测试：覆盖所有主要工作流

---

配置说明

快速参考，完整文档见https://github.com/schnsrw/sheets/blob/main/docs/ENV.md%E3%80%82

构建时参数（VITE_MAX_OPEN_MB、VITE_SOFT_WARN_MB、VITE_COLLAB_ENABLED）已嵌入镜像，若需修改可在构建自定义镜像时使用--build-arg。

v0.1.0新增WOPI主机集成环境变量（CASUAL_STORAGE、CASUAL_S3_*、CASUAL_PG_URL等）及管理/网络相关变量（CASUAL_ADMIN_PASSWORD、CASUAL_PUBLIC_ORIGIN等），详见docs/ENV.md。

---

镜像标签

CI在每次发布时构建并发布完整滚动标签集，可根据需求选择：

多架构支持：linux/amd64 + linux/arm64。镜像包含SBOM和溯源证明，可用于trivy/snyk/GitHub依赖图分析。

近期版本

---

OCI标签（docker inspect查看）

每个发布的镜像包含org.opencontainers.image.*标签：

sh
docker inspect schnsrw/casual-sheets:latest \
  | jq '.[0].Config.Labels | with_entries(select(.key | startswith("org.opencontainers")))'

示例输出：

json
{
  "org.opencontainers.image.title":         "Casual Sheets",
  "org.opencontainers.image.description":   "Excel-flavored web spreadsheet …",
  "org.opencontainers.image.url":           "https://sheet.schnsrw.live/",
  "org.opencontainers.image.source":        "https://github.com/schnsrw/sheets",
  "org.opencontainers.image.documentation": "https://schnsrw.live/docs/sheets/",
  "org.opencontainers.image.vendor":        "Sachin Sarwa",
  "org.opencontainers.image.licenses":      "Apache-2.0",
  "org.opencontainers.image.version":       "v0.1.0",
  "org.opencontainers.image.revision":      "abc1234…",
  "org.opencontainers.image.created":       "2026-06-01T14:23:09Z"
}

version、revision和created标签在CI构建时生成，可通过完整SHA+标签锁定特定构建。

---

镜像内容

• Web应用：React + Vite + TypeScript，由Fastify服务器静态托管。
• 协作服务器：Yjs + Hocuspocus通过WebSocket在/yjs提供服务，支持操作日志和压缩。
• xlsx I/O：ExcelJS + JSZip在专用Web Workers运行，主线程不阻塞大文件操作。
• OOXML透传：xl/vbaProject.bin（宏）和xl/pivotCaches/**+xl/pivotTables/**（数据透视表）保持字节级一致，确保.xlsm文件保留宏，数据透视表在Excel中正常显示。
• 懒加载插件：条件格式、数据验证等功能按需加载，提升性能。

---

许可协议

Apache-2.0。第三方依赖Univer OSS保留其Apache-2.0协议，未修改且不包含在构建中。