日常管理員指南

你是哪一種管理員

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/27第一學期」）、「第一天」和「最後一天」。最後一天不能早於第一天。
3. 核對名稱和日期後按 建立學期。學期建立後不能改名，也不能刪除。

清單列出每個學期的日期和長度，並標示「進行中」「尚未開始」或「已結束」，可以按名稱篩選。所有已登入的人都可以看到學期，只有平台管理員可以建立。

建立課程

管理 › 課程 › 建立課程

平台管理員看到所有學期、所有部門的課程；部門管理員只看到所管理部門及其下屬部門的課程。清單可按「學期」和「部門」篩選；選了部門後，可勾選 包括下屬部門。

1. 按 建立課程。
2. 選「學期」和「部門」，填「課程編號」（例如 CS101）、「分組」（只有一個分組時可留空）、「課程名稱」和「說明」。同一學期內，課程編號加分組不能重複。
3. 按 建立課程。新課程是草稿，沒有任何成員，會打開它的課程管理頁。下一步是指派講師。

指派講師

管理 › 課程 › 某課程 › 「指派講師」卡

新課程在指派第一位講師之前沒有任何成員。講師會獲得內建的「講師」權限預設，之後由講師在課程的 成員 頁加入其他人（見用戶指南的新增成員）。

平台管理員

1. 在「講師」欄以姓名或電子郵件搜尋，或貼上對方的 ID；要指派自己，按 我自己。
2. 按 指派為講師。

找不到對方，表示他還沒有登記：先在 人員與代理 登記，再回來指派。

部門管理員

1. 輸入對方完整的電子郵件或完整的學號／工號，按 查找（不設部分搜尋）；要指派自己，按 我自己。
2. 按 指派為講師。
3. 以電子郵件找不到人時，按 邀請新人員，填「姓名」、「電子郵件」和連結有效期，按 登記並邀請。複製顯示的連結，自行交給對方（AIshie 不會發送電子郵件），再按 指派某某為講師。以學號／工號找不到人時不會提供邀請：請改用電子郵件查找。

對方尚未登入過時，查找結果旁會有 再次邀請：新連結會取代先前給對方的連結。部門管理員只能再次邀請這樣的人：從未登入過、沒有平台角色、不是部門管理員、不擁有任何代理，而且只在你所管理的課程有席位。其他情況下不會有 再次邀請 按鈕（頁面不會另作說明），請平台管理員建立邀請連結。

課程已有成員後，這張卡列出講師（或你在此頁指派的人），並提供 前往成員頁面 和 再指派一位講師。成員頁只開放給課程成員；你自己沒有席位時，要先指派自己。

課程狀態：草稿、進行中、已封存

管理 › 課程 › 某課程

• 重新開放：成員可以再次在課程中工作。封存期間到期的席位、逾時的提案和已過的截止日期，會在重新開放時一併處理。
• 編輯：只能改課程名稱和說明。課程編號、分組和學期界定了課程本身，不能更改。講師也可以在課程的概覽頁修改名稱和說明。
• 搬到其他部門：成員、席位和課程內的一切都不變；管理權隨所屬部門改變，原部門的管理員若不管理新部門，會即時失去這門課的管理權。部門管理員只能搬到自己也管理的部門。
• 進入課程：只在你在這門課有席位時出現。

課程封存後，編輯和搬移都不能使用，要先重新開放。

清除誤傳的內容

教材、作業說明或評分準則誤傳了不該公開的內容（例如學生的個人資料），可以永久清除。只有平台管理員，或課程所屬部門（或其上層部門）的管理員可以清除：移除資料不屬於任何課程席位的權限。按鈕在文件頁上，所以你要在這門課有席位，才能打開文件頁。已封存的課程也可以清除。

1. 打開文件，按 清除…（清除整份文件的所有版本），或在某個版本按 清除此版本。
2. 填「原因」（必填，最多 500 字）。原因會保留在清除記錄上，向閱讀這份文件的人顯示。
3. 勾選「我明白此操作會永久移除內容」，按 清除。

• 內文和檔案會被移除，檔案也會從儲存空間刪除，無法復原。一個版本可以有多個檔案：清除時它的所有檔案，連同檔案的文字版和 PDF 預覽，都會刪除。完成後頁面會寫明清除了多少個版本、刪除了多少個檔案。
• 清除的版本以「已清除」記錄留在版本紀錄中，寫明由誰、何時、為何清除。清除的若是已發佈的版本，在另一個版本發佈之前，它仍是已發佈的版本。
• 清除整份文件後，文件會永久封存，不能再新增內容或恢復。
• 依據被清除版本繳交的作業仍會引用它，並看到清除記錄；成績不受影響。
• 課程的 動態 會顯示「清除了一個版本」或「清除了整份文件（n 個版本）」。
• 學校的代理執行環境為代理搜尋教材而保存的文字，清除後不會再被搜尋到，並最遲在 30 天內從執行環境刪除。
• AI 代理的回答曾依據被清除的版本的，回答下的「依據」對所有讀者（包括教職員）都只顯示為「一份你無法開啟的課程教材」（見用戶指南的回答依據的教材）。

部門樹

管理 › 部門

平台管理員看到整個部門樹；部門管理員看到所管理的部門及其下的一切。每個部門列出課程數（按下去打開直屬該部門的課程清單）和管理員數（按下去打開管理員抽屜）。平台管理員還會看到每個部門的權限預設，例如「查看（內建＋本部門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 文字。超出時頁面顯示「未能匯出」，並建議改為匯出一門課程、只匯出一位參與者，或縮短日期範圍。
• 連線中斷：以相同選擇再次匯出，伺服器會交回已完成的匯出，不會重複匯出。
• 伺服器沒有設定檔案儲存時無法匯出，請通知伺服器營運者。

你在這個瀏覽器匯出、檔案仍在伺服器的，會列在「最近的匯出」，可以再次下載。這份清單只存在這個瀏覽器中。

操作紀錄與動態

• 每項管理操作都會留下紀錄：誰、何時，以甚麼身分（平台管理員，或憑哪個部門的任命）。
• 與課程有關的操作，例如建立、修改、啟用、封存、搬移課程，以及清除內容，會出現在該課程的 動態，課程成員按自己席位的權限可以看到（見用戶指南的動態與我的操作）。
• 部門、任命、帳戶、單一登入和匯出的操作不屬於任何課程，不會出現在任何課程的動態中。網站目前沒有列出這些紀錄的頁面；需要查閱時，請伺服器營運者協助。