内容底座
一份内容，八个工位共用
题目、知识卡片、图形、课件同处一个内容模型。在题库里改一道题，引用它的讲义与试卷同步可见；组卷与讲义引用时自动冻结快照，历史卷面不会因为原题被改而变样。每道题都有完整修改链，可逐版对比、可回滚。
- 题目 20+ 字段模型，知识卡片 12 类、10 种段落
- 版本链逐版留痕，误改可回滚
- 引用即冻结快照，历史成品不受后续修改影响
- 内容在工位间直接流转，不需要导出再导入
生态体系
一套底座，八个工位，向外敞开
同砚共学不是把若干工具装在同一个导航里，而是让它们共用同一份内容、同一套权限、 同一条计费与排版链路。这一页把体系的四层结构和每个模块的位置讲完。
结构总览
从下往上读这张图
越靠下越稳定，越靠上越常变。这个顺序不是画得好看——它决定了新能力从哪一层接入。
内容底座权限底座AI 治理网关排版引擎运营后台
砚池砚案砚讲砚匣砚帖砚录砚工砚校
砚印开放 API内容分享群渠道接入多端一致
插件系统会员与权益团队协作语义检索第三方集成
第一层 · 底座
一套底座，撑起所有工位
内容、权限、治理、排版四件事只做一遍。工位不各造一套，所以任何一个工位里的改进，其它工位当天就能吃到。
先说底座，因为上面所有东西都站在它上面。这五件事任何一件各做八遍，体系就散了。
权限底座
越权在架构层就走不通
权限不是在每个页面上判一遍，而是收口在数据访问层：查询函数必须带上「谁在查」才能编译通过。未登录默认拒绝，无权访问与不存在统一按 404 回应——外人连「这个东西存不存在」都问不出来。
- 三层收口：默认拒绝 → 会话校验 → 归属校验
- 内容按空间所有者隔离，公开空间显式开放
- 无权与不存在同一响应，不泄露资源存在性
- 密钥永不回显，管理动作全量审计留痕
AI 治理网关
AI 能力统一入口，用量可查可退
所有 AI 调用走同一道闸门：先查资格与点数，过违禁词，遇上游故障熔断，成功才扣费、失败自动退款。你不用自备 API Key，也不会因为一次超时白扣点数。每一笔用量与流水在个人中心可查。
- OCR 识题、AI 答案解析、公式整理、AI 绘图五类能力同一网关
- 资格 → 违禁词 → 熔断 → 扣费 → 退款，一步不落
- 按次计点，失败自动退回
- 上游供给由站点统一维护，用户零配置
排版引擎
所见即所印的印刷级输出
同一套 LaTeX 引擎服务于试卷、讲义、答题卡。Times 与文楷中英混排精准对齐，公式与插图完美还原，分页效果在预览里就是最终效果。导出的 PDF 可直接送印，源码包可带回本地继续改。
- 学生卷 / 教师卷 PDF、A3 答题卡
- 自包含 HTML 单文件，投屏即用
- LaTeX 源码包，本地可编译可微调
- JSON 结构化数据，便于迁移备份
从用户与空间、AI 服务与模型、点数与兑换码，到会员等级、开放 API 用量、审计日志，全部在同一个后台里。管理员改配置不用改代码、不用重启。
- 用户 / 空间 / 标签 / 认证方式管理
- AI 服务与模型编排、站点级参数
- 点数、兑换批次、财务流水与对账
- 开放 API 调用看板与审计日志
第二层 · 工位
八个工位，各司其职
每个工位对应教学工作里一件真实的事。它们不是八个孤立工具——共用同一份内容与权限，题目在工位间流转不需要导出再导入。
工位建在底座之上：它们不各自维护内容与权限，所以题目从题库流进讲义、从讲义流进试卷，全程不需要导出再导入。
按空间与目录树组织题目，题干关键词、知识点、题型、难度、年份、来源、标签多维组合筛选，多键排序快速定位。找题不再靠翻文件夹。
- 空间与目录树，按教学单元组织
- 六类题型，多维筛选与多键排序
- 题目沿空间所有者隔离，互不干扰
- 检索结果实时统计
定义、定理、方法总结等 12 类卡片，正文之下分段落装证明、例子与注。卡片之间能连前置知识，正文写 [[标题]] 即跳转，反向引用自动生成——知识不是散落的笔记，是一张网。
- 12 种卡片类型，10 种段落类型
- 卡片互链前置知识，反向引用自动生成
- 按知识点列出题库里考它的题
- 独立目录树，与题库并行组织
分节分块编排讲解与题目，题目、正文、小标题、插图、环境五类块自由拖拽。20 种数学环境即选即用，知识篮里的卡片能一次摊进小节。导出 HTML 投屏、导出源码包本地改。
- 五类块分节编排，拖拽排序
- 20 种数学环境即选即用
- 知识卡片批量摊入小节
- 导出 HTML / LaTeX / 可编译源码包
题目插图、几何图形、参考截图集中存放，按引用关系可查可清。图形改了版本留痕，引用它的题目仍指向确定的那一版。
- 图片集中管理与布局控制
- TikZ 图形版本留痕
- 按引用关系追溯与清理
- 与题目、讲义双向关联
题目与知识卡片各一个题篮，按空间分桶。题型区拖拽排序、逐题或分区赋分、规则自动抽题，实时卷面预览。原来一下午的周测卷，现在十分钟。
- 双题篮按空间分桶，跨目录选题
- 题型区拖拽、逐题 / 分区赋分
- 规则组卷自动抽题，可再手工微调
- 实时卷面预览，题目快照冻结
TeX、PDF、JSON 批量导入，图片 OCR 识别为 LaTeX，AI 补全答案与解析，老师只需校对。近五年真题几天入库，之后随时按年份、题型、知识点调用。
- TeX / PDF / JSON 批量导入，受确认保护
- 图片 OCR 识别公式与题干
- AI 生成答案与多种解法解析
- 批量标记录题，一次录入几十道
在浏览器里画几何图形，一键转成 TikZ 编入试卷与讲义。不会 TikZ 语法也能出图，画完的图形与题目绑定，随题流转、组卷、导出。
- 浏览器内交互作图，无需装软件
- 图形一键导出 TikZ，复用现有排版管线
- 图形与题目绑定，随题流转
- 图形版本留痕，可回溯
外部渠道回流的答疑内容、AI 生成的题目解析，先进待审阅池，审过才入正式题库。机器产出的东西不会直接污染你攒了几年的库。
- 外部回流与 AI 产出统一进待审池
- 审阅通过才入正式题库
- 来源可追溯，落到正确的用户
- 待办计数在侧栏常驻提醒
第三层 · 接入
接得进群，也接得进你自己的系统
身份可以对外输出，数据有受控通道。你已有的机器人、答疑系统、教务平台不用重建，接进来就行。
工位内部通了之后，下一个问题是与外部世界怎么通。接入层解决身份与数据的对外通道——没有它，任何外部集成都只能靠导文件。
统一身份
既能用别人的账号，也能当别人的账号中心
支持用外部账号登录，也能反过来对外输出身份——外部系统以标准 OAuth 2.0 / OIDC 流程接入，用户在授权页确认范围后，第三方就能代表这位用户合法调用接口。这是整个开放生态的地基。
- 既是 OIDC 依赖方，也是身份提供方
- 标准授权码流程，用户显式确认 scope
- 签名密钥轮换、令牌可撤销
- 一个人的多个外部账号可绑定到同一身份
开放 API
受控数据通道
题目读取、答疑请求与回写、归档投递、身份查询等能力以版本化 REST 接口开放。每个客户端只拿到被授权的范围，调用量、耗时、错误率在后台看板逐条可查。
- 版本化路径（/api/open/v1），兼容有承诺
- 按 scope 授权，越权即 404
- 调用看板：QPS、耗时、错误率、明细
- 限流与熔断与站内能力同一套内核
内容分享
免注册也能看的链接
把一组题目或一份成品生成带有效期的分享链接，同事点开即看，不用注册、不用导出导入。链接可随时失效，访问留痕。
- 按需生成，可设有效期
- 接收方免注册直接查看
- 可随时撤销，访问记录留痕
- 分享内容为快照，不暴露源库
公测中
群渠道接入
在聊天里提问，答案沉进题库
学生在群里 @机器人 提问，答疑内容带着他的身份回写题库、进入待审阅池。你已有的机器人与答疑系统不用重建，以受信任客户端身份接进来即可。当前与既有机器人联调中。
- 验证码绑定，无需公网回调
- 答疑请求与回答有完整状态机
- 内容自动归档并关联到正确用户
- 渠道逻辑走插件，核心代码零渠道专属分支
多端一致
网页即用，桌面可离线
浏览器打开就能用，无需安装。也提供 macOS 桌面端，数据库、图片与配置全落在本机，断网照样备课。网页版与桌面端是同一套核心，不是两个产品。
- 浏览器零安装，随时接入
- macOS 桌面端本地存储，支持离线
- 同一套核心代码，能力不分叉
- 网站版额外提供多用户、计费与后台
第四层 · 扩展
往哪儿长，已经想清楚了
扩展沿着既有底座生长，不另起平行体系。下面每一项都已完成设计、进入排期，状态会随上线更新。
扩展沿着前三层生长，不另开体系：插件是进程内的受信任客户端，与外部客户端共用同一套权限与审计内核。
- 插件系统公测中
插件是进程内的受信任客户端：配置与启停在后台，权限与审计走和外部客户端同一套内核。渠道对接、导入导出格式、归档规则、通知出口都以插件形态交付——加一个集成不需要改核心代码。目前一方插件已按标准接口接线，第三方分发后置。
- 会员与权益公测中
会员等级字典、权益默认值、定价与用户权益记录已经落库并可在后台配置，点数与兑换码链路完整。面向公众的订阅购买入口待运营方案确定后开放。
- 团队协作规划中
当前空间是单所有者模型。团队版将引入成员与角色，按目录或题目范围分配读写权限、派发任务、汇总进度，教研组共建一套题库而不必互相导出文件。设计已完成，正在排期。
- 语义检索规划中
现有检索已支持中文分词与多词加权召回。下一步引入进程内轻量向量检索：描述「一道用导数判单调性、带参数讨论的压轴题」也能找到，不必凑关键词。
- 第三方集成规划中
在插件系统与开放 API 之上，逐步提供与教务系统、云盘、在线课堂等外部服务的现成连接器。愿望清单开放收集——你最想接哪一个，告诉我们。
体系原则
四条不打算妥协的规矩
这些规矩决定了体系加功能时不会失控，也决定了我们在官网上怎么说话。
底座只做一遍
内容模型、权限、AI 治理、排版、后台配置由全体工位共用。新增一个工位不需要新造一套权限，也不会让既有工位变脆。
平台不变量不可绕过
权限与所有权、身份签发、计费账本、版本链、数据库迁移永远在核心里。插件与外部客户端能扩展能力，但绕不过这几道闸门。
对接优于重建
你已有的机器人、答疑系统、教务平台不必推倒。同砚提供身份与受控数据通道，让它们以受信任客户端身份接进来。
状态如实标注
已上线、公测中、规划中在官网上逐项标明。规划中的能力不会在任何地方被说成「已支持」——这条规矩比多列几个功能重要。