关于座位表格式…

Jbyccc

目前电教圈内涉及座位表/学生信息存储的项目，个人了解到的有：

我自己的座位表编辑器

@laosan 的不想排座位（或 Fuckseats）

cc-cpstudio 的 ImmersingPicker （开发中）

secRandom 等各类名单点名器

你说有没有必要搞一个统一的交换格式？

laosan

Jbyccc 这是好事啊（
而且技术层面实现起来可能大概或许不会太难？问题就是几个现实问题：

存哪些数据
谁来主导
兼容层怎么做
规范应该强制遵守还是给保留字段以便所有人使用

不过确实值得讨论👍

（还有就是…open-fuckseats是Fuckseats的开源版，所以不想排座位应该叫 Fuckseats 而非open-fuckseats😊）

Millennium

感觉是有搞头的，参考隔壁课表软件。不过还是看实现难度吧

Jbyccc

Millennium 课表的那个交换格式链接能给一下吗，之前看过但找不到了

Millennium

Jbyccc 这个吗？SmartTeachCN/CSES

Jbyccc

Millennium ok

Jbyccc

laosan 咱觉得非技术方面效仿CSES就没太大问题了。本质维护一个yaml模板就行（

维护者的话我可以干一会。

有些软件只存储学生信息，有些要在学生信息的基础上加上一些属性（每个人的评分啥的），有些要额外加上座位表……因此，这些软件导出来的文件就有一些对象会没法填。有一些软件则会有一些特殊需求，比如存储了头像图片啥的，这样的话是应该多开一个对象，而没有存储这些数据的软件导入时自然会忽略。我们需要做的是对已知的需求做好规范（比如座位表先定义大小和组数啥的还是像你那样，像excel表格一样规定这里是空行，那里是讲台）。这个格式只用来交换数据，存储的数据结构各个软件怎么舒服怎么来就行（

laosan

Jbyccc 有搞头加油吧佬我这种业余人员就等着坐收渔利了🤣

做成后功绩堪比秦始皇了说是👍只用于交换这个想法👍

Jbyccc

征求意见qwq

format: student-data-exchange-schema # 固定
version: 1 # 固定，当前格式版本为 1

manifest: # 可选，文件元信息
  producer: BSCE # 可选，string，导出来源软件
  producerVersion: "2.3.0" # 可选，string，来源软件版本
  exportedAt: "2026-07-05T10:00:00+08:00" # 可选，string，ISO 8601 时间，建议加引号
  locale: zh-CN # 可选，string，语言/地区

metadata: # 可选，班级/名单说明信息
  name: 三年级二班 # 可选，string，班级、群组或名单名称
  description: 三年级二班的学生数据 # 可选，string，说明文字

students: # 学生名单
  - id: student:001 # string，本文件内学生 ID
    number: "1" # 可选，string，学号/编号
    gender: male # 可选，string，male / female / other / unknown
    name: # 姓名信息
      display: 张三 # string，用于显示的姓名
    tags:
      - tag:group-a # string，引用 tags.id
    attributes: # 可选，学生属性值，键引用 attributeDefinitions.id
      attr:score: 92 # 成绩示例；实际类型由 attributeDefinitions 定义
      attr:height: 168 # 身高示例

  - id: student:002
    number: "2"
    gender: female
    name:
      display: 李四
    tags:
      - tag:group-b
    attributes:
      attr:score: 88
      attr:height: 162

tags: # 可选，array，标签定义
  - id: tag:group-a # string，标签 ID
    name: A组 # string，标签显示名
    color: "#FF0000" # 可选，string，颜色，"#RRGGBB" 或 "rgba(...)"
  - id: tag:group-b
    name: B组
    color: "rgba(0, 255, 0, 0.5)"

attributeDefinitions: # 可选，array，学生属性定义
  - id: attr:score # string，属性 ID
    name: 成绩 # string，属性显示名
    type: number # string，枚举：number / 整数 / string / boolean / color
    unit: 分 # 可选，string，单位
  - id: attr:height
    name: 身高
    type: number
    unit: cm

seatCharts: # 可选，array，座位表列表
  - id: chart:grid-main # string，座位表 ID
    name: 网格座位表 # 可选，string，座位表名称
    layoutModel: grid # string，布局模型；grid 表示 open_fuckseats 类二维网格
    coordinateSystem: # 坐标系统说明
      origin: front-left # string，枚举：front-left / front-right / back-left / back-right
      xDirection: left-to-right # string，枚举：left-to-right / right-to-left
      yDirection: front-to-back # string，枚举：front-to-back / back-to-front
    grid: # layoutModel 为 grid 时建议填写，object
      rows: 6 # 正整数，网格总行数
      columns: 8 # 正整数，网格总列数
    seats: # array，网格内座位或标志物
      - id: seat:grid:1:1 # string，单元 ID，assignments 需要引用
        x: 1 # 整数，网格 x 坐标
        y: 1 # 整数，网格 y 坐标
        kind: seat # string，枚举建议：seat / platform / door / aisle / empty / guard
        group: 1 # 可选，整数|string，座位所属组
        capacity: 1 # 可选，非负整数，每个座位的容量，默认 1
      - id: aisle:grid:2:1
        x: 2
        y: 1
        kind: aisle
      - id: platform:grid:front
        x: 4
        y: 0
        kind: platform
    assignments: # 可选，array，学生与座位绑定关系
      - seatId: seat:grid:1:1 # string，引用 seats.id
        studentId: student:001 # string，引用 students.id

  - id: chart:grouped-main
    name: 大组座位表
    layoutModel: groupedColumns # string，布局模型；groupedColumns 表示 scev2 类大组-列-行
    coordinateSystem:
      origin: front-left
      xDirection: left-to-right
      yDirection: front-to-back
    groupedColumns: # layoutModel 为 groupedColumns 时建议填写
      groups: # 大组定义
        - id: group:0 # 可选，string，大组 ID
          columns: 2 # 正整数，该大组列数
          rows: 7 # 正整数，该大组行数
        - id: group:1
          columns: 2
          rows: 7
    seats:
      - id: seat:grouped:0:0:0
        kind: seat
        group: 0 # 大组ID
        column: 0 # 整数，组内列索引
        row: 0 # 整数，组内行索引
        capacity: 1
      - id: seat:grouped:0:1:0
        kind: seat
        group: 0
        column: 1
        row: 0
      - id: guard:left
        kind: guard
        side: left # 可选，string，guard 专用，枚举：left / right
    assignments:
      - seatId: seat:grouped:0:0:0
        studentId: student:001
      - seatId: guard:left
        studentId: student:002

extensions: # 可选，扩展数据；未知命名空间应原样保留但不能执行
  app.bsce: # 可选，BSCE 私有扩展
    customLayoutMode: compact # 可选，任意 JSON/YAML 基础类型，私有字段示例
  org.open-fuckseats: # 可选，open_fuckseats 私有扩展
    constraints: [] # 可选，array，无法映射到通用规则时可保留在这里

2-2-3-trimethylpentane

@lincube 开发的作业交换格式，看了觉得很不错

Jbyccc

2-2-3-trimethylpentane 感觉可以（~~怎么跟病毒似的~~

Jbyccc

格式做了一版，应该够用吧（Braydenccc/SDES

@laosan

laosan

Jbyccc 建议还是用json吧通用点

MacrosMeng

unnuTechnology/CSIS

查看这之中的 ESPS。可能会有用。

@Jbyccc #p22698 单独看，其实很多项目不是必要的，如 manifest 等。另外不建议使用 YAML，隔壁 CSES 其实很后悔用了 YAML。解析等方面会有很多问题。

yizhilanzhu

MacrosMeng
Bro的BBcode引用是不是炸了😰

Jbyccc

MacrosMeng 感谢，个人第一次做这种工作，考虑的不多，原来之前就有先人搞过（
确实可能要用 json 或者 csv

manifest 是拿来写针对这个 sdes 文件的元数据的，比如来源软件，咱寻思可能会用上（例如，某个软件没存学号而id和学号恰好一个顺序，或者某些数据在某些版本错了，接收方可以针对适配一下……或许确实没多大用就是了）

自动轮换和规则集这块，有这玩意的貌似也只有 sce 和 fs ，看看怎么统一一下

按同桌来定位比起规定列号好像没有优势，如果是多列一组的情况就得把 deskmate_pos 写成列号了

CSLS 这块可以借鉴一下，我这边元数据只有个 description ，给班级年级也写进去才对

各个软件规范外的额外信息，这边集中放在 extensions。不过确实要最低限度规范一下

MacrosMeng

Jbyccc 不是啊这是我写的😰（）好像完全没有人用啊，也希望采用者多提点建议

yizhilanzhu 我草还真是

Jbyccc

MacrosMeng 啊这，要不用你的得了（

MacrosMeng

啊那也行（）感谢采用

Jbyccc

MacrosMeng 算了我把我这个做完得了（