Skip to content

学校预设维护 ​

从插件提交 ​

  1. 完成一键配置并保存账号。
  2. 在成功页面填写学校与校区;确认网络可用后勾选 已确认校园网可正常使用。
  3. 展开 预览提交内容,核对网关、SSID、账号类型与后缀。
  4. 点击 创建预设 Issue,在 GitHub 确认并提交。内容过长时,按提示复制草稿到新 Issue。

Issue 草稿不包含账号和密码,也不会自动提交。若使用的插件版本尚无此入口,可在 Issue 中手动填写上述信息。

保存、密码验证、实际联网是不同结果,应如实说明。记录自己实际使用的账号类型;认证页中的其他选项只能标为“页面发现”,不要推断已验证。预设草稿使用 draft 状态,由维护者核查后合并。

维护目录 ​

公开目录的唯一源文件是 doc/school-presets.json。Go 安装包直接将它安装到 /usr/share/smart-srun/school-presets.json,不再维护 Python 的 fallback 副本。

presets list 和页面读取使用本地数据;只有显式刷新或已启用的每日调度才请求远端。远端来源、schema 验证及缓存顺序由 presets 实现维护,更新行为与数据约束见 doc/AGENTS.md。目录可用与学校已经实测是两件事。

字段规则 ​

  • operators[].suffix 是真实认证后缀,label 使用学校页面的账号类型名称;兼容读取旧 id,新数据写 suffix。
  • 已确认无后缀使用 "";只知道类型存在但真实后缀未确认可由维护者标记 "??"。向导不将未知值作为已知候选,账号归一化不会拼出 user@??。
  • 不新增 defaults.operator、defaults.operator_suffix、no_suffix_operators;空后缀写为 ""。真实后缀保留大小写,xn 仅在旧版 operator 字段中作为历史占位符迁移。
  • defaults 记录已知 base_url / ac_id / ssid / access_mode。未知内容保持缺失,不为补齐格式造值。
  • observed_login_shape 只记录真实捕获的 n / type / enc / info_prefix / double_stack / os / name;Go 账号对应 login 对象中的同名字段(例如 login.os / login.name);旧 1.x 表单字段为 login_os / login_name。
  • 保留 source_issue、贡献者及验证范围。历史可用数据可以保留原状态;失败样本与未确认场景不能因格式整理升级为已适配。

合法的特殊后缀示例:

json
{"suffix": "students.example.edu", "label": "学生用户"}

不要在示例或运行时中默认补齐三家运营商。保持主文件既有字段顺序、缩进和紧凑/展开写法。修改后从插件源码仓根目录运行:

sh
python3 -m unittest discover -s tests -p test_preset_catalogue.py -v

修改加载器还需运行对应 Go 包测试,入口见源码仓 tests/README.md。Go 树不执行旧版 sync_school_presets.py。镜像站维护于独立 Pages 仓库;本站的预设展示快照通过显式同步更新。

Go 2.x 已正式发布;最新版本与验证范围见下载页,Python 1.x 资料独立归档。