日常管理员指南

你是哪一种管理员

AIshie 只有两种平台角色：Root 和 管理员，合称平台管理员。此外，任何人都可以被任命为某个部门的部门管理员；这是对一个部门的任命，不是平台角色。

• Root：服务器运维者在安装时创建的第一个账号。Root 和其他人一样，用邮箱（或学号／工号）和密码登录。只有 Root 可以设立其他平台管理员，也只有 Root 可以管理拥有平台角色的人。
• 管理员：由 Root 在注册时授予，之后不能再授予或收回。Root 能做的其他一切，管理员都可以做。
• 部门管理员：管理被任命的部门及其下所有部门的课程和部门树（见任命部门管理员）。

要在课程内工作，例如上传教材或查看成绩，要先把自己指派为讲师，之后和其他人一样受席位权限的约束。

在活动栏点击 管理，侧边栏会列出你可以打开的管理页面：

其他人打开管理页面的网址，会被带回首页。

注册人员、学期、权限预设、单点登录和服务凭证，只有平台管理员可以处理。创建、修改、启用、归档、移动课程，指派讲师，清除误传的内容，调整部门树和导出对话，则由平台管理员和部门管理员在各自的范围内分担。

管理页面的布局

• 活动栏和侧边栏的用法与其他页面一样（见用户指南的界面导览）：点击 管理 打开管理侧边栏，再点击一次收起。
• 管理页面按页面本身的宽度排版，而不是按窗口的宽度：在较小的笔记本电脑上打开侧边栏、页面变窄时，人员与智能体列表会由表格改为每行一张卡片；课程和部门列表仍是表格，但会收起部分列，改在名称下注明；并排的两栏会改为上下排列。对话窗口浮在页面上，不占页面的宽度。AI 与文件 页也是这样。
• 页面较窄时，部门列表不显示权限预设这一列，而是在部门名称下注明，例如“权限预设：内置＋本部门1个”。
• 在手机上，活动栏和侧边栏收进左上角的 菜单（见用户指南的在手机和窄窗口上使用）。按“返回”会先关闭盖在页面上的菜单、权限预设或部门管理员的抽屉，而不是离开页面；在电脑上，这两个抽屉也可以用浏览器的“返回”关闭。

首次设置

新安装的网站只有 Root 一个账号：没有学期、部门、课程，也没有单点登录。按以下顺序设置，每一步都链接到详细说明。

1. 用服务器运维者交给你的邮箱和密码，以 Root 身份登录。Root 没有任何课程的席位，所以“我的课程”是空的。
2. （可选）在 人员与智能体 注册其他平台管理员，勾选“平台管理员”，再为每人创建邀请链接。每人一个账号，以后每项操作都能分清是谁做的。
3. 在 学期 点击 创建学期（见学期）。学期创建后不能改名或删除。
4. 在 部门 点击 新建顶层部门，再在其下创建部门（见部门树）。
5. （可选）在 权限预设 为部门创建自己的预设（见权限预设）。
6. 在 课程 点击 创建课程，然后指派讲师。
7. 在顶层部门任命部门管理员，由他们接手日常的课程管理。
8. （可选）在 登录方式 设置单点登录。
9. （服务器部署了智能体运行环境时）在 AI 与文件 设置学校 AI 方案、OCR 和文件转写。

还没有学期或部门时，课程页会提示“课程必须属于某个学期和部门，但目前尚未创建其中之一”，并提供 创建学期、创建部门 按钮。部门管理员看到的提示则说明学期由平台管理员创建。

学期

管理 › 学期（仅限平台管理员）

1. 点击 创建学期。
2. 填写“名称”（例如“2026–2027学年第一学期”）、“第一天”和“最后一天”。最后一天不能早于第一天。
3. 核对名称和日期后点击 创建学期。学期创建后不能改名，也不能删除。

列表列出每个学期的日期和长度，并标示“进行中”“尚未开始”或“已结束”，可以按名称筛选。所有已登录的人都可以看到学期，只有平台管理员可以创建。

创建课程

管理 › 课程 › 创建课程

平台管理员看到所有学期、所有部门的课程；部门管理员只看到所管理部门及其下属部门的课程。列表可按“学期”和“部门”筛选；选了部门后，可勾选 包括下属部门。

1. 点击 创建课程。
2. 选择“学期”和“部门”，填写“课程编号”（例如 CS101）、“教学班”（只有一个教学班时可留空）、“课程名称”和“说明”。同一学期内，课程编号与教学班的组合不能重复。
3. 点击 创建课程。新课程是草稿，没有任何成员，并会打开它的课程管理页。下一步是指派讲师。

指派讲师

管理 › 课程 › 某课程 › “指派讲师”卡片

新课程在指派第一位讲师之前没有任何成员。讲师会获得内置的“讲师”权限预设，之后由讲师在课程的 成员 页加入其他人（见用户指南的添加成员）。

平台管理员

1. 在“讲师”栏用姓名或邮箱搜索，或粘贴对方的 ID；要指派自己，点击 我自己。
2. 点击 指派为讲师。

找不到对方，说明他还没有注册：先在 人员与智能体 注册，再回来指派。

部门管理员

1. 输入对方完整的邮箱或完整的学号／工号，点击 查找（不支持部分搜索）；要指派自己，点击 我自己。
2. 点击 指派为讲师。
3. 用邮箱找不到人时，点击 邀请新人员，填写“姓名”、“邮箱”和链接有效期，点击 注册并邀请。复制显示的链接，自行交给对方（AIshie 不会发送电子邮件），再点击 指派某某为讲师。用学号／工号找不到人时不会提供邀请：请改用邮箱查找。

对方还没有登录过时，查找结果旁会有 再次邀请：新链接会取代之前给对方的链接。部门管理员只能再次邀请这样的人：从未登录过、没有平台角色、不是部门管理员、不拥有任何智能体，而且只在你所管理的课程有席位。其他情况下不会有 再次邀请 按钮（页面不会另作说明），请平台管理员创建邀请链接。

课程有了成员后，这张卡片列出讲师（或你在此页指派的人），并提供 前往成员页面 和 再指派一位讲师。成员页只对课程成员开放；你自己没有席位时，要先指派自己。

课程状态：草稿、进行中、已归档

管理 › 课程 › 某课程

• 重新开放：成员可以再次在课程中工作。归档期间到期的席位、超时的提议和已过的截止日期，会在重新开放时一并处理。
• 编辑：只能修改课程名称和说明。课程编号、教学班和学期界定了课程本身，不能更改。讲师也可以在课程的概览页修改名称和说明。
• 移动到其他部门：成员、席位和课程内的一切都不变；管理权随所属部门改变，原部门的管理员如果不管理新部门，会立即失去这门课的管理权。部门管理员只能移动到自己也管理的部门。
• 进入课程：只在你在这门课有席位时出现。

课程归档后，编辑和移动都不能使用，要先重新开放。

清除误传的内容

教材、作业说明或评分标准误传了不该公开的内容（例如学生的个人信息），可以永久清除。只有平台管理员，或课程所属部门（或其上级部门）的管理员可以清除：移除数据不属于任何课程席位的权限。按钮在文档页上，所以你要在这门课有席位，才能打开文档页。已归档的课程也可以清除。

1. 打开文档，点击 清除…（清除整份文档的所有版本），或在某个版本上点击 清除此版本。
2. 填写“原因”（必填，最多 500 字）。原因会保留在清除记录上，向阅读这份文档的人显示。
3. 勾选“我明白此操作会永久移除内容”，点击 清除。

• 正文和文件会被移除，文件也会从存储空间删除，无法恢复。一个版本可以有多个文件：清除时它的所有文件，连同文件的文字版和 PDF 预览，都会被删除。完成后页面会写明清除了多少个版本、删除了多少个文件。
• 被清除的版本以“已清除”记录留在版本记录中，写明由谁、何时、为何清除。被清除的如果是已发布的版本，在另一个版本发布之前，它仍是已发布的版本。
• 清除整份文档后，文档会永久归档，不能再添加内容或恢复。
• 依据被清除版本提交的作业仍会引用它，并看到清除记录；成绩不受影响。
• 课程的 动态 会显示“清除了一个版本”或“清除了整份文档（n个版本）”。
• 学校的智能体运行环境为智能体搜索教材而保存的文字，清除后不会再被搜索到，并最迟在 30 天内从运行环境删除。
• 智能体的回答曾依据被清除的版本的，回答下的“依据”对所有读者（包括教职员）都只显示为“一份你无法打开的课程教材”（见用户指南的回答依据的教材）。

部门树

管理 › 部门

平台管理员看到整个部门树；部门管理员看到所管理的部门及其下的一切。每个部门列出课程数（点击后打开直属该部门的课程列表）和管理员数（点击后打开管理员抽屉）。平台管理员还会看到每个部门的权限预设，例如“查看（内置＋本部门1个）”。

• 新建顶层部门：只有平台管理员可以。
• 在此新建部门：部门最多 8 层，同一层不能重名。部门创建后不能删除，但可以改名或移动。
• 改名、移动、管理员（任命）：部门管理员只能对被任命部门以下的部门这样做，不能改动自己被任命的部门或其上级。

移动部门

• 其下的部门和课程会一并移动。只经由旧上级部门获得管理权的管理员，会立即失去管理权；新上级部门的管理员则立即获得。课程之内的一切保持不变。
• 不能选择的目的地会写明原因：“当前所在位置”、“连同其下部门会超过层数上限”或“该处已有同名部门”。部门不能移动到自身或其下属部门之下。
• 部门管理员只能移动到自己也管理的部门之下；移动到顶层只有平台管理员可以。

任命部门管理员

1. 在部门的操作菜单中点击 管理员，打开管理员抽屉。
2. 在抽屉下方的“任命管理员”一栏，输入对方完整的邮箱或学号／工号，点击 查找。
3. 点击 任命某某。

抽屉列出在此任命的管理员，以及经由上级部门管理它的人（标示为“经由‘上级部门’”），每项任命都写明由谁、何时任命。打开 显示过往任命，可以看到已结束的任命和结束者。

部门管理员可以：创建、修改、启用、归档和移动这些部门的课程，指派讲师，在其下创建部门，并为其下的部门改名、移动及任命管理员。任命不会给予任何课程的席位。

权限预设

管理 › 权限预设（仅限平台管理员）

权限预设是新成员的起点：名册角色、涵盖的学生和作业，以及十七项权限各自的级别。成员加入课程时，预设会被复制到他的席位上。权限级别、十七项权限、内置预设和不可逾越的规则，见用户指南的四种权限级别、十七项权限、内置权限预设和不可逾越的规则。

某项权限的级别是“需审批”时，AIshie 会先像批准时一样检查这个请求：如果现在批准也会被拒绝（例如发布已发布的版本、撤销已撤销的链接、为已有席位的人安排席位，或到期时间已过），就会立即拒绝并说明原因，而不会变成提议。

页面有两种视图：预设（每个预设一张卡片）和 比较权限（每一列是一个预设的矩阵）。默认只显示内置预设；选择一个部门，就会在内置预设旁看到该部门自己的预设。

内置的 8 个预设（学生、旁听者、助教、讲师、辅导（智能体）、评分（智能体）、个人智能体、课程智能体）随系统安装提供，不能编辑。要让某个部门有不同的设置，打开内置预设，点击 复制为部门预设。

创建部门预设

1. 点击 创建预设。
2. 选择“部门”（必填：每个预设属于一个部门），填写“名称”（同一部门内不能重复，但可以与内置预设同名）和“说明”。
3. （选填）在“以此为起点”选择一个现有的预设，会填入它的角色、范围和权限。
4. 选择“名册角色”，以及“涵盖的学生”和“涵盖的作业”：全部，或仅限列表（列表在成员加入时选定）。学生的学生列表如果留空，会自动列入本人；其他列表留空，就什么都涵盖不到。
5. 逐项设置权限的级别，保持“禁止”的即不允许。点击 创建预设。

• 预设的名称和所属部门创建后不能更改；预设也不能删除。
• 编辑 会替换预设的说明、角色、范围和所有权限。已经以此预设加入的成员保留原本获得的设置；只有之后加入的成员才会获得新设置。成员的席位可以在课程内单独调整（见用户指南的调整成员的权限、范围和角色）。

人员与智能体目录

管理 › 人员与智能体

用姓名、邮箱或学号／工号搜索，或粘贴 ID；可按“类型”（人员、智能体）和“状态”筛选。“登录方式”一列显示每个人可以怎样登录：

• 密码、单点登录：已经可以登录。
• 已邀请，某日前有效：已创建邀请链接，对方还没有使用。
• 邀请已过期：链接还没使用就过期了，要创建新链接。
• 尚未设置密码或单点登录：对方还不能登录。

注册人员或智能体

1. 点击 注册，“类型”选择“人”或“智能体”。
2. 填写“显示名称”。人员可以填写“邮箱”和“学号／工号”：两者都是选填，但要用密码登录，至少需要其中一项。两者都只能属于一个人，以后可以更改，但不能移除。学号／工号只能使用英文字母、数字、句点、连字符和下划线，最多 64 个字符，不能含 @。
3. 注册智能体时，选择它的“运行方式”：站内托管（由学校的智能体运行环境运行）或 MCP 访问（用 API 令牌从外部的 AI 工具连接）。需要时选择“拥有者”（见下文）。
4. “平台管理员”只有 Root 可以勾选：勾选即授予管理员身份（有拥有者的智能体不能勾选）。
5. 点击 注册。

注册后的下一步

• 人员：在其页面创建邀请链接，或关联单点登录身份。之后让对方加入课程：在课程管理页指派为讲师，或请该课程的讲师在 成员 页加入。
• 有拥有者的智能体：由拥有者在“我的智能体”交给 AIshie 托管，或为它签发令牌，再带入自己的课程。它不会经“成员 → 添加”加入课程。
• 没有拥有者、MCP 访问的智能体：在其页面签发 API 令牌，再请课程讲师用“评分（智能体）”或“辅导（智能体）”等预设为它安排席位，并把范围限定于它所服务的学生或作业。
• 没有拥有者、站内托管的智能体：这里不会为它签发令牌。运行环境的运维者用这个智能体的 ID 配置它之后，运行环境才会运行它并自行获取令牌（见系统管理员指南）。

邀请链接（设置密码）与重置密码

人员与智能体 › 某人 › “邀请链接”卡片

邀请链接让对方设置密码并随即登录。AIshie 不会发送电子邮件：链接要由你自行交给对方。

1. 选择“链接有效期”：1、3、7（默认）、14 或 30 天。
2. 点击 创建邀请链接。已有一条未使用的链接时，按钮是 创建新链接；对方已设置密码时，按钮是 创建重置密码的链接。
3. 链接只显示一次：请立即复制，并通过可靠的方式交给对方。任何打开链接的人都可以设置密码。

• 每人同时只有一条有效的链接：创建新链接会取代旧链接。链接只能使用一次。
• 重置密码：对方忘记密码时，创建重置密码的链接。对方使用后，新密码取代原有密码。
• 更改对方的邮箱，会撤回正在等待使用的链接，要在更改后重新创建。
• 不能创建链接的情况：你自己（请在“账号”页设置密码）、系统账号、智能体（改为签发令牌）、已停用的人（先重新启用）、既没有邮箱也没有学号／工号的人（先为对方添加其中之一），以及拥有平台角色的人（只有 Root 可以）。

对方打开链接后看到的画面，见用户指南的用管理员的链接设置密码。

编辑、核实学号、停用

人员与智能体 › 某人

• 编辑：修改显示名称、邮箱和学号／工号。类型和平台角色不会改变。只有平台管理员可以更改学号／工号，本人不能自行更改。
• 核实学号：通过课程邀请链接自行创建账号的人，所填的学号／工号标示为“未确认”。核对无误后，在 编辑 中勾选“我已核实：保存为已确认”再保存；改成正确的学号，也同样算作已确认。
• 停用：对方在所有课程中的每一个操作都会被拒绝，也不能登录；智能体也一样。席位、记录和登录凭证都会保留，重新启用 后恢复原状。你不能停用自己；拥有平台角色的人只有 Root 可以停用；系统账号不能停用。
• 由拥有者停用的智能体：页面上方会说明。在这里 重新启用 也会解除停用；点击 接手停用，这次停用就归你所有，拥有者之后不能自行解除。
• 智能体的页面写明“拥有者”和“运行方式”（都在注册时定下，不会更改）；人员的页面列出他“拥有的智能体”。

令牌与登录方式

人员与智能体 › 某人 › “令牌与登录方式”卡片

这张卡片列出进入此账号的所有方式：浏览器会话、密码、单点登录身份和邀请链接。可以逐一 撤销，不必停用对方，其他凭证和席位都会保留。打开 显示已撤销及已过期的凭证 开关，可以看到过往的项目。

• 讲师重置的密码标示为“临时”，并写明设置者：对方下次登录时须设置自己的密码。
• 单点登录身份写明“账号”和“关联者”；邀请链接写明“邀请者”。
• 人员没有 API 令牌：如果这里列出某人仍持有令牌，请撤销。
• 你自己的凭证请在“账号”页撤销，那里能分辨哪一个会话是你正在使用的。

站内托管的智能体只有一个令牌，由学校的智能体运行环境获取，签发者标示为“本站的智能体运行环境”。撤销它之后，在运行环境获取新令牌之前，站内就无法向这个智能体提问；拥有者会在智能体页看到需要重新连接。

为智能体签发 API 令牌

人员与智能体 › 某个 MCP 访问的智能体 › “API 令牌”卡片

智能体不能自行登录申请令牌，第一个凭证要从这里获得。有拥有者的智能体，通常由拥有者在“我的智能体”自行签发（见用户指南的令牌）。

1. 填写“标签”，注明用途，例如“CS101秋季学期评分智能体”。
2. 选择“有效期”：30 天、90 天（默认）、365 天、永不过期，或选“其他…”填写 1 至 3650 天。
3. 点击 签发令牌。令牌只显示一次（Core 只保存它的哈希值），请立即复制。

结果同时列出 MCP 连接信息：端点（Streamable HTTP）和请求头。把智能体的 MCP 客户端指向这个端点，以令牌作为 Bearer 令牌。令牌泄露时，在“令牌与登录方式”撤销那一个即可，智能体本身不会被停用。站内托管的智能体不会在这里签发令牌。

通过课程邀请链接创建的账号

讲师可以为课程创建 10 分钟内有效的邀请链接或二维码（见用户指南的邀请链接与二维码）。还没有账号的人可以通过它自行创建账号，并以学生身份加入课程。

• 这样创建的账号，学号／工号和邮箱都是对方自己填写的，未经核实：学号标示为“未确认”，请按核实学号的步骤确认。
• 对方自己填写的邮箱不会用于以邮箱自动关联单点登录。
• 服务器运维者可以关闭通过链接创建账号（例如学校已全面使用单点登录时）：之后链接只提供“登录以加入”，对方要先有账号。这是服务器的设置，见系统管理员指南。

单点登录：开始之前

管理 › 登录方式（仅限 Root 和平台管理员）

• AIshie 支持 OpenID Connect 身份提供者。对话框为 AD FS、Microsoft Entra ID、Google Workspace 和 Keycloak 逐一说明要在哪里注册应用、颁发者 URL 该怎样填写。
• 单点登录不会创建账号：身份提供者认可某人，不代表他在 AIshie 有账号。先注册这些人，再把他们的账号关联到提供者。
• 客户端密钥在服务器上用 SECRETS_KEY 加密保存。页面提示需由服务器运维者为服务器设置一把用来加密客户端密钥的密钥时（旁边的 ⓘ 写明是 SECRETS_KEY），在运维者添加之前无法添加提供者；这把密钥的设置、保管和更换见系统管理员指南。用 AIShie-Deploy 部署的新服务器已经设置好。
• 服务器只会连接位于公网地址的提供者。提供者在学校内部网络（例如域名解析到以 10. 开头的地址的 AD FS），或服务器通过代理服务器（proxy）上网时，要请运维者设置 SSO_ALLOW_PRIVATE_ISSUERS。

整个流程是：添加提供者（新的提供者处于停用状态）→ 关联账号 → 测试并启用。

添加提供者

1. 复制页面最上方的 重定向 URI（https://你的网址/v1/auth/sso/callback），在身份提供者那边注册一个应用，把它填作重定向（回复、回调）URI。每个提供者都用同一个。
2. 点击 添加提供者。对话框上方会再列出重定向 URI，以及各种提供者的设置说明。
3. 填写“ID”（小写英文字母、数字和连字符，最多 64 个字符，例如 school-adfs；账号以它关联，之后永不更改）和“显示名称”（登录按钮上的名称，最多 64 个字符）。
4. 填写“颁发者 URL”：须与提供者的发现文档（…/.well-known/openid-configuration）中写的完全相同，结尾的 / 也要一致，而且必须是 https。
5. 点击颁发者旁边的 测试。测试只读取提供者的发现文档和密钥：不会让任何人登录，也不会发送密钥。结果是“可以使用”或“未能使用”，并列出问题、端点和签名密钥。
6. 填写“客户端 ID”和“客户端密钥”。密钥加密后才保存，之后只显示最后四个字符。
7. 需要时展开“高级”（见下文），然后点击 添加提供者。新的提供者处于停用状态，登录页还不会出现它的按钮。

测试报告提示有地址位于本机，或属私有、链路本地或保留地址时，表示服务器不会连接这个提供者：请服务器运维者设置 SSO_ALLOW_PRIVATE_ISSUERS，再测试一次。

高级

• 范围：登录时请求的范围，一定包括 openid，最多 20 个。
• 主体声明：用来识别账号的声明，即关联时所用的值。除非提供者另有说明，否则是 sub；AD FS 用 upn。
• 邮箱声明：只在以邮箱关联时读取。
• 在登录页的位置：0 至 10000，数字小的排在前面。服务器运维者配置的提供者一定排第一。
• 允许以已验证邮箱自动关联现有账号和允许的邮箱域名：见关联账号。

关联账号

每个人要关联到提供者，才能通过它登录。有两种方法：

逐一关联

1. 在 人员与智能体 打开此人，找到“单点登录”卡片。
2. 选择“身份提供者”，填写此人在提供者那里的“账号”，即主体声明的值（例如 AD FS 的 UPN name@example.edu；含 @ 时不区分大小写）。可以点击 使用其邮箱。
3. 点击 关联身份。

一个身份只能关联一个人，而且是永久的：一经关联，就不会再转给其他人。智能体不使用单点登录。

以邮箱关联

在提供者的“高级”中开启“允许以已验证邮箱自动关联现有账号”，并列出允许的邮箱域名（最多 50 个）。之后，首次通过它登录、身份尚未关联任何账号的人，在以下各项全部成立时，会自动关联到现有账号：

• 提供者为该邮箱担保：ID 令牌的邮箱声明载有该邮箱，而且 email_verified 为 true；
• 邮箱属于允许的域名之一，且须完全相符（子域名算作另一个域名）；
• 使用该邮箱的账号属于一位已启用的人员，其邮箱由管理员提供，而不是对方通过课程邀请链接自行输入的；
• 该账号没有平台角色（Root 和管理员要逐一关联）；
• 该账号尚未关联到这个提供者。

其他人会被拒绝，视为未注册，也不会创建任何账号。曾被解除关联的身份，永远不会再以邮箱关联。AD FS 和 Entra ID 不会发送 email_verified：使用它们时这项设置不会关联任何人，请逐一关联。

测试、启用、停用

1. 关联好账号后，在列表中点击 测试，再确认一次“可以使用”。
2. 打开“启用”开关。一分钟内，登录页就会出现它的按钮。启用时如果还没有任何账号关联到它，页面会提醒你：在关联账号之前，没有人能通过它登录。

用户在登录页看到的按钮如下（给用户的说明见用户指南的登录）：

• 停用：一分钟内按钮从登录页消失。关联全部保留，再次启用就能使用。
• 编辑：可以修改显示名称、颁发者、客户端 ID、密钥（选“以新密钥替换”）和高级设置，下次登录时生效。修改颁发者时，已关联的账号保持关联：新颁发者以同一主体担保的人，会以这些账号登录。另一位管理员同时修改了同一个提供者时，页面会显示“其间已有人修改”，请检查后再保存。
• 删除：仍有账号关联到它时，对话框会写明有多少个账号会失去单点登录，按钮是 删除并解除n个账号的关联。那些人之后只能用密码登录，或无法登录。以后用同一 ID 重新创建，也不会自动恢复关联。只想暂停的话，请停用。

列表上的状态

• 旧密钥标签：密钥以之前的 SECRETS_KEY 加密，服务器仍保留那把密钥。运维者完成密钥更换后，标签会消失。
• 由服务器运维者设置：运维者在服务器的环境配置（OIDC_*）中设置的提供者，始终启用，这里只能查看，不能修改；旁边的 ⓘ 写明是哪些设置。

AI 与文件：谁可以使用

管理 › AI 与文件

• 这个项目只在服务器部署了智能体运行环境时，才会出现在平台管理员的侧边栏。
• 运行环境的管理员默认就是 AIshie 的所有 Root 和管理员。服务器运维者可以用运行环境的 ADMIN_ACTOR_IDS 只指定其中一部分人；不在名单上的平台管理员，打开这一页会看到“你不是这个运行环境的管理员”。
• “这个服务器没有智能体运行环境”或“无法连接智能体运行环境”：前者要由运维者部署，后者可能是运行环境正在重启，一分钟后点击重试。

页面分为五个标签页：学校 AI 方案、计价与额度、今日用量、文件 和 智能体托管。运行环境还没有提供的功能，标签页上会这样说明。

• 这里的更改片刻之内就会生效，不用重启；每项设置都写明“由某某于某时更改”。另一位管理员同时修改了同一项设置时，页面会显示最新内容，请检查后再试。
• 每天重新计算的时间以你的时区显示，并注明时区；把鼠标移到时间上，会显示准确的 UTC 时间。运行环境默认按 UTC 计日，所以在 UTC+8 的地区会显示为早上 8 点。文件转写的“今日”同样按 UTC 计日，下面写明每天几点重新计算。价格的“生效日”选的是 UTC 的日期，字段下面写明它在你的时区从几点开始，例如“价格从香港标准时间 2026-10-03 08:00起生效，即所选日期在 UTC 开始之时”。

学校 AI 方案

由学校提供并付费、使用学校自己 API 密钥的模型。智能体的拥有者可以为自己的站内托管智能体选用其中一个，不必自备密钥（见用户指南的站内托管）。密钥只保存在服务器上，任何人都看不到。

添加模型

1. 在“方案中的模型”点击 添加模型。
2. 填写“ID”（字母、数字、_ 和 -，最多 64 个字符；智能体用它指代这个模型，之后不能更改）和“向拥有者显示的名称”（一行，最多 80 个字符，例如“学校 AI（快速）”）。
3. 在“模型”中选择供应商和模型；某些供应商还要填写端点、资源或区域。
4. 填写“学校的 API 密钥”。保存之前，运行环境会用一次简短的调用试用它；未通过试用就不会保存任何内容。暂时无法试用时，可以勾选“不试用，直接保存密钥”，它会显示为“未测试”。
5. 需要时打开“向拥有者提供”，点击 添加。

• 密钥交给运行环境加密保存，之后只显示它的结尾。
• 关闭或删除一个模型：拥有者看不到它；使用它的智能体中，拥有者设置了自己的模型作为备用的会改用那个模型，其余的会暂停，直到拥有者改选其他模型。删除会连同学校为它设置的密钥一起永久删除；以后用相同 ID 重新添加，这些智能体会重新使用它。
• 服务器运维者在 runtime.yaml 中配置的模型标示为“只读”。运维者的模型列表不允许的模型标示为“不被允许”，不会提供。

每日额度

学校方案每天可回答的次数，以及（为每个模型定价后）每天的美元上限。留空表示不设上限。

• 每位拥有者：一位拥有者所有智能体的总和。
• 每位提问者：每位提问者在一门课程中向一个智能体提问。
• 全校：学校密钥上的所有用量，不论是谁的智能体回答，包括运维者使用学校密钥的智能体，以及文件转写（只计入美元上限）。任何人自己密钥上的用量都不计算在内。

以美元计的额度需要方案中每个模型都有价格（见计价与额度）。使用服务器默认 会改回 runtime.yaml 的设置。每个智能体从下一次回答起就会应用新额度。

拥有者在自己的智能体页也会看到学校方案的每日额度和重新计算的时间，同样以他自己的时区显示，所以管理员和拥有者说的是同一个时间。

OpenRouter 模型的上游路由

管理 › AI 与文件 › 学校 AI 方案 › 添加模型（供应商选 OpenRouter）

OpenRouter 本身不运行模型：它把每次调用交给提供这个模型的其中一个上游供应商。在学校方案中添加或编辑一个 OpenRouter 的模型时，对话框多了“OpenRouter 上游路由”一节：你可以选择哪些上游供应商可以回答、先尝试哪些，以及它们要符合的条件。这些设置会随每一次调用发送给 OpenRouter。不作设置时，OpenRouter 会按价格和稳定性自行选择。

1. 在“方案中的模型”点击 添加模型，填写 ID 和名称，“供应商”选 OpenRouter。
2. 在“模型”中填写 OpenRouter 的模型 ID，例如 meta-llama/llama-3.3-70b-instruct。片刻之后，下面会列出 OpenRouter 为这个模型列出的上游供应商；ID 不对的话，会显示“OpenRouter 没有…这个模型。请检查模型的 ID。”
3. 填写“学校的 API 密钥”。运行环境照常用一次简短的调用试用它（试用时不发送上游路由）。
4. 按需要设置“OpenRouter 上游路由”（见下文），在最下面的 会发送给 OpenRouter 的设置 中看清楚会发送什么，再点击 添加。

新添加的模型默认已开启三项：只用不保留数据的上游供应商、优先尝试的上游供应商无法回答时改用其他上游供应商，以及只用支持调用中每项设置的上游供应商。

数据与上游供应商

• 只用不保留数据的上游供应商：排除可能保存发送给它们的内容并用来训练模型的上游供应商。建议学校开启。
• 只用零数据保留（ZDR）的端点：更严格，只用回答后不保留调用任何内容的端点，符合的上游供应商较少；列表中符合的标着“ZDR”。
• “可以回答的上游供应商”选 全部，关闭的除外（列表中关闭的不用），或 只限开启的（只用开启的）。选得越少，其中一个停止服务时可以替代的就越少。
• 列表的每一行是一个上游供应商的端点：名称和代号、运行的精度、上下文长度、最多输出、总部所在地、每百万 token 的输入／输出价格（有折扣或长上下文另计时，把鼠标移到价格上会说明）、可否调用工具、最近 30 分钟和 1 天的可用率，以及它的“隐私”“条款”“状态”链接。运行不正常的标着“运行异常”。
• “使用”开关决定它可否回答；被上面某项限制排除的，会写明“已排除，原因：…”。不含“/”的代号（例如 google-vertex）代表该供应商的所有端点，包括各地区，其下的端点写着“已包括在…之内”。
• 优先尝试：先尝试这些上游供应商，可以用 提前、延后 调整次序，或 取消优先。
• 以代号加入：列表中没有的上游供应商，可以输入代号添加，例如 deepinfra/turbo。
• 列表下面写着“OpenRouter 于…列出。”；暂时连不上 OpenRouter 时，会用一小时内读过的列表，并写明。

如何选择、速度和限制

• 优先尝试的上游供应商无法回答时，让 OpenRouter 改用其他上游供应商：关闭时，调用只会交给优先尝试的上游供应商（没有选择时，交给 OpenRouter 首先选出的那个），它们无法回答时调用便会失败。
• 只用支持调用中每项设置的上游供应商：不能调用工具，或会忽略某项设置（例如推理强度）的上游供应商不会被使用。建议开启。
• “选择方式”：OpenRouter 默认（兼顾价格和稳定性）、价格最低、输出最快、最快开始回答，或工具调用质量最佳（Exacto）。设置了优先尝试的上游供应商时，这一项不会使用。
• “偏好的速度”：输出速度和首个 token 的时间，按最近 5 分钟的中位数或 p75、p90、p99 计算。未达标准的上游供应商排在最后尝试，而不是被排除。
• “限制”：“模型运行的精度”只用以其中一种精度运行模型的上游供应商，不选则不限；“可接受的最高价格”（输入和输出每百万 token、每次调用、每张图片）排除收费更高的上游供应商，没有剩下的话调用便会失败。

价格

OpenRouter 按实际回答的上游供应商收费，但学校以美元计的额度和费用报表，每个模型只用一个价格：不论由哪个上游供应商回答，每次调用都按价目表中这个模型的价格计算（见计价与额度）。对话框列出允许的上游供应商中最高的收费，以及价目表的价格。价目表的价格较低时，对话框会提醒学校的实际花费可能超出额度显示的数字：点击 设置价格，把价格提高到不低于最高收费，或设置可接受的最高价格。

发送的设置与方案列表

• 会发送给 OpenRouter 的设置：展开后，就是每次调用随附发送的设置（OpenRouter 称为 provider）。没有任何设置时，显示“不发送任何设置”。
• 清除上游路由：把以上所有设置恢复为 OpenRouter 的默认值，调用时不发送任何设置。
• 在“方案中的模型”中，有上游路由的模型在 ID 后面写着 上游路由，点一下会显示“每次调用时发送给 OpenRouter”的设置；服务器运维者在 runtime.yaml 中配置的模型也一样，但只能查看。
• 只改上游路由不会重新试用密钥。把模型改为另一个供应商，上游路由便会移除。
• 服务器的运行环境较旧、还不支持上游路由时，对话框会显示“这台服务器暂时无法列出 OpenRouter 的上游供应商”，保存时会显示“这台服务器暂时不支持上游路由…”，并提供 不设置上游路由并保存：只有点击了它，模型才会不带上游路由保存。请服务器运维者更新运行环境（见系统管理员指南的依据的版本）。

计价与额度

• 价目表：模型的价格，以每百万 token 美元计（输入、缓存读取、缓存写入、输出），按供应商和模型（可用 * 代表任意文字，例如 gpt-4.1*）以及“生效日”（UTC 的日期，可以是将来的日期）设定。价格以美元显示，写作 US$，例如 US$0.40。服务器价目文件中的价格只能查看；在这里添加同一模型、同一日期的价格，会排在它之前。更改只适用于此后的调用，已记录的费用保留当时的价格。
• 每人额度：一个人所有智能体每天使用学校密钥的回答次数和美元，取代 runtime.yaml 的设置，直到重设为止。两项不能都留空。
• 智能体每日预算：每个在这里托管的智能体每天可使用的上限，不论用哪个密钥回答：包括每个智能体的总量，以及在一门课程中每位提问者的用量。服务器本身配置的智能体保留 runtime.yaml 给它们的预算。
• 费用：按日、按人、按智能体、按模型、按密钥或总计，查看已记录的费用（美元）；密钥可选所有密钥、学校的密钥或拥有者自己的密钥，一次最多选一年。文件转写单独成一行。调用发生时还没有价格的，按 US$0.00 计算，并会标示出来。

今日用量

今天学校方案的回答次数、模型调用和费用，与全校每日上限对比，并按拥有者列出。页面写明“自某时起。每天某时重新计算。”，时间以你的时区显示。这里的费用不含文件转写，但全校的美元上限也把转写计算在内。

文件：OCR 与文件转写

读取扫描文件（OCR）

当模型本身无法读取文件时，运行环境会按这里选择的语言，替它识别扫描 PDF 和图片中的文字。

• 可以开启或关闭，最多选择 8 种语言，按选择的先后顺序识别；或点击 使用服务器默认。
• 服务器运维者关闭了 OCR，或服务器没有安装 OCR 时，状态是“无法使用”：你的设置会保留到可以运行时使用。

文件转写（文字版）

运行环境用学校方案中的一个模型、以学校的密钥，把课程文件（幻灯片、PDF、Word）的每个版本转写一次，生成文字版：所有模型都读取这份文字版，读者和教学人员也会在文件旁看到它。默认是关闭的。

1. 先在学校 AI 方案中添加一个能读取 PDF 或图片的模型。请在价目表中为它定价，否则以美元计的全校上限无法涵盖转写的费用。
2. 在“与 AIshie 的凭证”点击 签发并交给运行环境：AIshie 为转写服务签发一个凭证，直接交给运行环境，由它先行测试。凭证不会在画面上显示，也不会保存在浏览器中。
3. 选择“模型”，需要时调整“每份文件最多页数”（1 至 5000，默认 300）、“每日页数”（留空即不限）和“同时转写的文件数”（1 至 8，默认 2）。
4. 打开“把文件转写成文字版”。

• 状态：未启用、运行中、待命，或“受阻”并写明原因（没有凭证、AIshie 拒绝了它的凭证、未选择模型、所选模型无法使用、今日页数已用完）。
• 一个版本有多个文件时，每个文件各自转写；“转写记录”标示“第n个文件”。页数超过上限的文件会被跳过；当日页数用完后，领取的文件也会被跳过，教学人员之后可以再提交。
• 费用由学校支付，计入全校的美元上限，不计入任何拥有者的额度；在费用中列为“文件转写”。
• 智能体搜索课程教材时，扫描件和只能通过文字版读取的文件，要转写好之后才搜索得到。
• 凭证可以 更换 或 撤销；撤销后，在签发新凭证之前不会转写任何文件。凭证数量达到上限时，点击 全部更换。只有 AIshie 的平台管理员可以签发或撤销这个凭证。
• 关闭转写后，已写好的文字版会保留，教学人员仍可自行撰写（见用户指南的文件的文字版）。

智能体托管：运行环境在 AIshie 的凭证

运行环境用自己的凭证（aissvc_…）调用 AIshie：凭它核查智能体的拥有者、获取及撤销它所托管的每个智能体的令牌，也凭它领取 Office 文件并交回转换好的 PDF。没有有效的凭证，它不会托管任何智能体，也不会把 Office 文件转换为 PDF。

• 卡片上列出每个凭证的状态（有效、已撤销、已过期）、签发者（配置服务器时创建的标示为“服务器（设置时）”）、签发时间和最后使用时间。
• 更换：请服务器运维者在服务器上运行 aishie runtime-credential，它会签发新凭证、撤销其他凭证，并让运行环境改用新凭证（见系统管理员指南）。
• 撤销 正在使用的凭证后，在运行环境获得新凭证之前，它不会托管任何智能体，也不会转换 Office 文件。智能体自己的令牌不会被撤销。
• 签发凭证：在这里签发的凭证只显示一次，也不会自动交给运行环境，要由运维者放到服务器上。一般请使用上面的命令。

导出对话用于审计

管理 › 导出对话

对话的完整记录可以导出成 JSON Lines 和 CSV 文件。导出必须由人进行，智能体不能导出。

1. 选择“对话范围”：一门课程、一个部门或整个网站。选课程时按代码或名称搜索，或粘贴课程 ID；选部门时包括其下所有部门的课程。
2. 需要时选择“参与者”，只导出此人提问、或此智能体回答的对话。平台管理员可以按姓名、邮箱或学号搜索；部门管理员要输入人员完整的邮箱或学号／工号，智能体则粘贴其 ID。
3. 需要时填写“开始日期”和“截至并包括”。日期按你的日历和时区计算，页面会写明实际发送的时间。
4. 点击 导出。大型导出可能需要几分钟，期间可以去其他页面，完成后结果会在这里显示。

导出内容包括所选对话的每一条消息（已撤回的消息连同原文，并标示为已撤回）、每条消息所附文件的说明（ID、名称、类型、大小和校验码，不含文件本身），以及曾经提出但从未发布的回答和提问（包括被拒绝或退回修改的）。文件不含任何令牌、密码或密钥。结果列出对话、消息和提议的数量，并提供两个文件及其校验码：

文件内的时间都以 UTC 记录。

• 上限：一次导出默认最多 100,000 条消息（连同提议）或 256 MiB 文字。超出时页面显示“未能导出”，并建议改为导出一门课程、只导出一位参与者，或缩短日期范围。
• 连接中断：以相同选择再次导出，服务器会交回已完成的导出，不会重复导出。
• 服务器没有配置文件存储时无法导出，请通知服务器运维者。

你在这个浏览器导出、文件仍在服务器上的，会列在“最近的导出”中，可以再次下载。这份列表只保存在这个浏览器中。

操作记录与动态

• 每项管理操作都会留下记录：谁、何时、以什么身份（平台管理员，或凭哪个部门的任命）。
• 与课程有关的操作，例如创建、修改、启用、归档、移动课程，以及清除内容，会出现在该课程的 动态 中，课程成员按自己席位的权限可以看到（见用户指南的动态与我的操作）。
• 部门、任命、账号、单点登录和导出的操作不属于任何课程，不会出现在任何课程的动态中。网站目前没有列出这些记录的页面；需要查阅时，请服务器运维者协助。