Detailed behaviour notes for people who want every detail. This text was written for v1.4.3 and may lag behind newer releases; the README is the short version.
- Download the v1.4.3 ZIP above and extract it. Open
edge://extensions, enable Developer mode, choose Load unpacked, and select the extracted folder containingmanifest.jsondirectly. / 下载上方 ZIP 并解压，打开扩展管理页，启用开发人员模式，加载直接包含manifest.json的文件夹。 - Pin WatDesk and click its toolbar icon to open the side panel. On first launch, connect LEARN, Crowdmark and Odyssey using your own authorized accounts. Complete passwords and MFA on the original sites. All three enabled core sources must connect before entering the workspace. CS135 and Möbius are optional. / 固定扩展后打开侧栏，首次使用需连接三个核心来源，密码与验证码在原网站输入；CS135 和 Möbius 为可选来源。
- Review imported courses, then enter the workspace. Use More actions → Open full workspace for the full page. / 核对导入课程后进入工作台，可从“更多操作”打开完整面板。
Existing users / 已安装用户： Export a JSON backup in Settings first. Replace files inside the existing unpacked extension folder, then click Reload on the WatDesk card in edge://extensions. Keep the original extension installed to retain its local data. Refresh inside WatDesk updates data, not extension code. / 先备份，再覆盖原目录并重新加载扩展；不要移除原扩展。面板内刷新只更新数据，不更新代码。
The release includes a SHA-256 file for verifying the ZIP. It contains the same extension package published on Edge Add-ons. / 发布页附校验文件，安装包与 Edge 商店上架的包一致。
A complete visual redesign uses warm paper surfaces, deep ink navigation and restrained gold accents. The overview groups work by campus date, highlights today's exams separately from task deadlines, and lets you expand later dates or filter every course. Tasks, exams, grades, calendar and settings share the same responsive system in both languages and themes. Released grade records lead; optional estimates and detailed source diagnostics live in disclosures. Dates without published times remain explicitly date-only.
- LEARN deadlines, released grades and calendar/schedule quizzes, including teacher-created Module Quiz reminder events. Online quiz windows also appear in Exams without duplicate reminders; office hours and unrelated reminders are excluded. Crowdmark supplies deadlines, submission state and historical grades.
- Course-outline items can be added through Settings → My local data → Import items (add only), using
watdesk-items-v1JSON. These are imported snapshots, not an automatically polled course-outline source; dates without a published time remain date-only. - Odyssey assessment dates, duration, room and seat; unpublished times remain unknown.
- CS135 calendar deadlines (only with the website's explicit 9pm rule), quizzes/midterm, lecture-note and assignment links. View Submissions records verify submission by assignment and term; basic-test links alone do not prove submission.
- Optional Möbius reads metadata from an already-open View Policies/settings page. It never opens an activity, starts a quiz, requests an exception or submits answers. LEARN quiz dates do not require Möbius.
- Chinese/English, light/dark/system theme; month/week/next-seven-days calendar with course filters, exam markers and date-specific personal items.
- Personal tasks, checkmarks and notes; conservative cross-platform task merging with source links and an opt-out; platform submission and personal completion remain separate.
- Term selection, orientation-module hiding and course visibility controls; hidden courses are excluded from coursework views and reminders.
- Per-course grade trends, manual assessment weights, graded-weight averages and target-score estimates. Unreleased grades are not counted as zero.
- Exam countdowns and time conflicts; new exam time, room or seat changes trigger notifications and remain in the update history.
- Course-specific deadline/exam reminders, manually entered weekly classes, course muting, calendar ICS export (including the next 90 days of classes), full JSON backup/restore and a self-contained offline HTML viewer.
- Record-level verification times distinguish saved or retained data from freshly checked data. Learn skips hidden courses and reuses course reads for 10 minutes; manual refresh bypasses this cache. Failed reads retain the previous snapshot. Account name changes block replacement until source cache is cleared.
Checking a task is personal bookkeeping; it does not submit anything to the university. Reminder delivery requires Edge to be running and the operating system to allow notifications. Opening shows saved data immediately. Automatic sync defaults to every six hours, with a configurable interval in Settings (including manual only). Background reads do not activate your tabs; when a platform needs a rendered page, WatDesk creates an inactive temporary tab and closes it after use. The browser can still show that temporary tab in its tab strip. An expired session may require you to finish sign-in or verification on the platform. Browser shutdown or computer sleep can delay scheduled runs. Manual Refresh bypasses freshness caches. Grade estimates follow manually entered weights and do not model drop rules or pass-the-final conditions. Platform APIs/page layouts may change. Course content and external resource titles retain their original language.
Academic data stays in this extension's local browser storage. No password collection or external font CDN. Anonymous usage counting is on by default and can be disabled in setup or Settings; opening the workspace sends only a random install ID and version to the developer's Cloudflare Worker, as described in PRIVACY.md. Source requests go to the corresponding university/Crowdmark service using the browser session. Backups contain your academic data and notes; keep them private. Removing the extension removes its local data: export a backup first.
Build the released version from the v1.4.3 tag, for a reproducible release checkout:
git clone --branch v1.4.3 --depth 1 https://github.com/Jelly-RayTian/WatDesk.git
cd WatDeskNode 22.13+ and pnpm: pnpm install --frozen-lockfile, pnpm typecheck, pnpm test, pnpm build, pnpm package.
Production builds exclude preview.html and tests/preview.ts, which use clearly isolated development fixtures and no real login. Runtime assets are bundled locally. See THIRD_PARTY_NOTICES.md for the two MIT readers reused from WATnow; all WatDesk product UI, state, schedule parsers, calendar and packaging are independent.
Some courses restrict individual tools or grade endpoints. WatDesk displays the course, tool and HTTP status separately from network/server failures, and retains previously read records for unavailable sections. HTTP 403 can mean the course tool is disabled or the endpoint is restricted; HTTP 404 may mean no matching data or endpoint. Neither proves that an assignment is unsubmitted or a grade is unreleased. Check the original Learn page when in doubt.
部分课程会限制工具或成绩接口。WatDesk 会列出课程、工具及 HTTP 状态，保留无法刷新部分的旧记录；不会把接口不可用判定为未提交或未公布。自动更新会缓存近期检查结果，手动刷新仍会重试。
GitHub Actions runs type checking, tests and a production build. Its downloadable WatDesk-extension artifact can be extracted and loaded in Edge using the installation steps above.
Enable 学校登录自动继续 / School sign-in helper in Settings and grant the optional adfs.uwaterloo.ca permission. On the Waterloo HTTPS ADFS sign-in page, WatDesk clicks Next once if a Waterloo username is already filled. It never fills credentials, reads passwords, or advances password/MFA/error steps. Disable the helper in Settings at any time.
Type checking, 251 tests across 58 files, the production build, and ZIP integrity checks passed. Both full and production-only dependency audits reported zero advisories. Vitest 4.1.12 is installed. Build and fixture checks do not establish authenticated behavior for every account or course. Report platform issues with the installed version and source status, without posting credentials or private academic records.
发布前通过类型检查、58 个文件中的 251 项测试、生产构建及安装包完整性检查。全量与生产依赖审计均为零告警。真实学校账号同步仍需实际使用验证；反馈时请提供版本及来源状态，不要公开密码或私人课程记录。
Integrates the verified dependency updates: Vite 8.3.5, jsdom 30.1.3, Chrome types 0.3.6, and updated pinned GitHub Actions for checkout, pnpm, Node setup and artifact upload. Retains the v1.4.2 sync and validation fixes. React and react-dom remain together on 19.3.0; TypeScript remains 5.9.3.
整合已验证的构建、测试、Chrome 类型与 CI 工具升级，保留 v1.4.2 的同步和校验修复。React 与 react-dom 保持相同版本，未纳入测试失败的升级。
Repairs unsafe saved source links on every storage read, validates settings and personal-item patches before mutation, and checks normalized Crowdmark API paths in both relays and the packaged content bridge. Valid external course links and unlinking remain supported. Shared URL rules and duplicate backup checks have been consolidated. The original WATnow vendor files remain unchanged.
统一读取旧数据时的链接清理，补齐设置与备注字段值校验，统一 Crowdmark 请求路径检查；保留正常外部课程链接和解除关联操作，并合并重复校验。
v1.4.1 — hidden items and localized listing
- Hidden items / 已隐藏事项: Settings lists hidden items with per-item and bulk restore. / 设置中可逐条或全部恢复已隐藏事项。
- Localized extension name and description (en, zh-CN);
SECURITY.mdand Dependabot added. / 扩展名称与描述支持中英文，新增安全政策与依赖自动更新。
- Style picker / 界面风格: Settings → Language & appearance now offers Forest, Ocean, Plum and Graphite, each with light and dark variants. / 设置中可选择森林、海洋、梅紫、石墨四种风格，均支持浅色与深色。
- Calendar delete / 日历删除: personal items can be deleted from the calendar; synced items can be hidden and restored from the bottom of the calendar. / 日历中可删除个人事项，同步事项可隐藏并在日历底部恢复。
- Explicit extension-page CSP and 16/32/48/128 px icons for Edge store submission. / 增加扩展页面 CSP 与多尺寸图标。
LEARN Course Schedule PDFs can now be fetched using the existing browser session and parsed locally with bundled Mozilla PDF.js. The current parser recognizes explicit assignment deadlines, numbered Quiz intervals, Midterm intervals and an explicitly undated Final Exam. Tested against the MATH 135 schedule. Scanned PDFs require OCR and are reported as unreadable; unfamiliar layouts, missing dates or ambiguous clock ranges are not guessed. Files are limited to 2 MB and 20 pages. Same-course PDF/Odyssey exams merge only when both exact start and end match, retaining Odyssey room/seat; conflicts stay separate. Other course tool restrictions remain visible.
Double-click a calendar date or blank cell in month/week view to open a personal item with that date filled in. Clicking an existing event opens it; it does not create another item. Keyboard users can still use the selected-day Add item button.
LEARN 的课程日程 PDF 通过现有登录会话读取，在本机解析，不上传到第三方。已用真实 MATH 135 日程核对；无法识别的版式、扫描件或不明确的日期不会猜测。月/周日历可双击日期或空白格新增事项并自动带入日期。 The v1.3.2 GitHub download now includes these fixes; the Edge submission is updated separately.
The current main source fixes school SSO redirects that take longer than four seconds: the login helper now waits up to 30 seconds for the original platform to return, with cancellation and a bounded timeout. LEARN also retries a signed-out or no-tab session through its own inactive temporary page, then closes that page after reading or failure. Network errors do not trigger login navigation. Password and MFA prompts still require the user. These fixes are included in the v1.3.2 GitHub release. Edge Add-ons certification is handled separately.
当前 main 源码将学校登录跳转等待延长至最多 30 秒，避免在会话自动返回前提前关闭页面；补齐 LEARN 会话恢复的临时后台页流程。读取结束、失败或取消均关闭自己创建的页面，网络故障不触发登录。密码与 MFA 仍由本人完成。 The v1.3.2 GitHub download now includes these fixes; the Edge submission is updated separately.
The following entries describe behavior at each earlier version. Later changes supersede them; use the installation and sync guidance above for v1.3.0. In particular, v1.3.0 may create inactive temporary tabs and closes its own read tabs after use.
以下是各旧版本当时的行为，并非当前操作说明。后续版本会替代旧行为；v1.3.0 可能创建非活动临时标签页，并在读取结束后关闭自己创建的页面。
Version history: 1.0.2–1.2.3 / 展开旧版本记录
Crowdmark grade pages use existing same-origin navigation links where available. Current courses are read before archive, each page has a separate wait budget, and successfully read courses are saved immediately even if a later course fails. Silent archive checks are cached for one day; manual refresh bypasses the cache. Grade retries after failure wait five minutes during automatic refresh; manual refresh retries immediately.
Platform overall grades, category aggregates and class averages are labeled and excluded from equal-weight assessment statistics, trends and weight entry. Learn classification uses its official grade object types when present, then common explicit titles. Unnamed aggregates without metadata cannot be safely inferred.
Platform refreshes run concurrently, with per-source deduplication and serialized state writes. A failed source does not block other sources. Overview course counts include open tasks and future exams; its upcoming list now includes Odyssey exam cards and supports course filtering.
Automatic sync no longer opens Learn, Crowdmark or Odyssey tabs. It only reads existing loaded pages, retains saved data when a platform is closed or signed out, and never navigates to login or Crowdmark grade pages. Returning from sign-in retries only that platform. Manual refresh and initial setup can still open source pages. CS135 uses a direct background fetch without opening a tab.
自动同步不再突然打开 Learn、Crowdmark 或 Odyssey。只读取已打开且加载完成的页面；网站关闭或登录过期时保留历史数据，不自动跳转登录或浏览 Crowdmark 成绩页。登录后仅重试对应平台。手动刷新及首次连接仍可打开平台页面；CS135 直接后台读取，无需打开标签页。
Learn now supplements Module Quiz deadlines from file-type Course Schedule topics. Möbius is an optional source with access limited to https://uwmo.mobius.cloud/*: enable it, then manually open an activity’s View Policies page from LEARN. WatDesk reads only settings metadata on already-loaded pages, never starts an attempt or requests an exception, and never navigates or opens Möbius even during manual refresh. Availability windows remain task deadlines; the per-attempt time limit is displayed separately. Only explicit submission/completion status counts as submitted; attempts used, content viewed and “results recorded” settings do not. Matching Learn/Möbius tasks merge into one calendar event and reminder while retaining the time limit. Previously seen settings remain saved when a different activity is read.
新增可选 Möbius 来源，读取你从 LEARN 手动打开的「查看设置」页；Course Schedule 补齐 Module 1–12 Quiz 日期。开放窗口与单次限时分别显示，与 Learn 相同任务合并，仅提醒一次。不会自动打开网页、开始测验、请求例外或提交答案。
CS135 tasks now read actual timestamped source-file records from an already-loaded Assignments → View Submissions page. The latest record marks that assignment as submitted, matched by assignment number and academic term. Basic-test results and marksheet links alone do not imply submission or a final grade. Without a readable page, saved submission confirmations are retained and unchecked tasks are labeled unknown. Opening the CS135 source explicitly goes to View Submissions; background refresh never opens or navigates tabs. The reader collects submission metadata only and never opens source files or submits work.
Allow the extension’s own full-page tab to request state from its worker, while keeping content-page messages isolated. Loading failures now show a diagnostic and the installed extension version, making a browser data refresh distinguishable from reloading the extension itself.
Skip frozen source tabs during quiet background reads; explicit refresh may activate a frozen source and manually opens CS135 View Submissions. Bound CS135/Möbius page collection to five seconds and passive source runs to 45 seconds. Once a read times out, late sign-in/page responses cannot resurrect its reading phase or overwrite a later sync. Timed-out and interrupted reads show actionable explanations while retaining saved data.
Manual and automatic refresh no longer create, activate, reload or navigate source tabs. Learn and Crowdmark use their existing authenticated background readers; Odyssey and Learn schedules use a bundled, short-lived offscreen DOM parser. The parser closes after each operation, including failures. Existing user tabs are never closed. Login expiry is reported inside WatDesk; use Open website to sign in explicitly.
Automatic sync defaults to 6 hours, including profiles upgrading from the old fixed 30-minute timer. Settings → Automatic sync offers 30 minutes, 1/2/6/12/24 hours or Manual only. Changing the interval updates the browser alarm; ordinary worker restarts preserve the next run. Opening the workspace reuses recent successful data for the selected interval; Refresh bypasses that cache. Scheduled runs do not skip a cycle merely because the previous read finished a few seconds after its alarm. Browser shutdown/sleep can delay alarms.
CS135 attempts a background metadata read, then uses already-loaded View Submissions pages if needed. If the server supplies only a JavaScript shell or the login expires, existing submission confirmations stay saved and unverified tasks remain unknown. Möbius still requires an already-loaded settings page. Crowdmark tasks refresh through its API; grades are checked on already-loaded course pages, with other saved grades retained and labeled accordingly. Quiet sync does not browse courses or archives to retrieve grades.
手动刷新与定时同步均不再弹出、激活或跳转平台标签页。临时后台解析页面用完即关闭，你自己打开的页面保持原样。默认每 6 小时同步，可在「设置 → 自动同步」调整；登录过期或部分信息无法静默核实时，保留历史结果并显示提示。
Crowdmark refresh again checks rendered grades for current courses and, when due, the archive. It uses a separate inactive temporary tab, leaves user tabs untouched, and closes its own tab on success, error, cancellation or timeout. The page reader never activates a tab or focuses a window. The six-hour default and configurable sync interval remain.
Online quizzes from LEARN, including Course Schedule Module Quizzes, now also appear on the Exams page. They keep their original task records, calendar events and deadline reminders; no duplicate exam record is created. Cards show both opening and closing dates and any known attempt limit. Availability windows do not participate in fixed exam time-conflict checks. Past quizzes remain available under Show past exams.
Update details remains available alongside Retry after a source failure. Disabled optional sources are excluded from the progress banner, including failures saved by an older run. Möbius remains optional; LEARN quiz dates do not require enabling it.
Fix the real LEARN data boundary: course API paths use numeric orgUnitId, while the internal ou-prefixed ID remains the cache key. Handle the current TOC {Modules} envelope and TopicId / TypeIdentifier fields as well as the older shape. File topics use the verified same-course enforced-content URL, never an external learning-tool launch.
Teacher-created Module N Quiz Calendar events are imported as quiz deadlines even when LEARN labels them EventType 1 (Reminder). Office hours, recurring events and unrelated reminders stay excluded. Calendar and Course Schedule entries merge by course, title and actual timestamp, filling opening times without duplicating tasks, calendar exports or reminders. Profiles affected by the old schedule 404 receive a one-time cache repair without changing user entries, settings or last-success timestamps.
Outline deadlines can be added through Settings → My local data → Import items (add only). The bounded JSON format watdesk-items-v1 accepts personal items and never replaces existing records, settings or completion marks; repeat imports are idempotent. An official outline link can be retained on each item. Date-only records are labeled as having an unpublished time and export as all-day calendar events. Their date reminder does not claim an exact deadline time. Outline snapshots are imported records, not an automatically polled source.
When Odyssey returns only a sign-in redirect to the worker, retry through an owned inactive browser page using the normal school sign-in entry. Close that page after success, error, cancellation or timeout; never activate a user page. Crowdmark likewise falls back to its rendered course/grade reader when its API session is signed out, rather than failing before the temporary page can run. The school sign-in helper still never reads or enters passwords or verification codes. Cancellation guards prevent late login callbacks from continuing navigation after a job ends.
The progress banner recognizes a source recovered by an individual read, instead of remaining stuck on an old incomplete run. A fresh calendar/schedule merge now updates deadline verification state, avoiding a misleading retained-data label after a successful read.