Skip to content

PolyU LMS CLI 0.2.0 预览版

Pre-release
Pre-release

Choose a tag to compare

@zs-andy zs-andy released this 20 Sep 15:47
· 8 commits to main since this release

PolyU LMS CLI 0.2.0 预览版

面向香港理工大学的 Canvas 和 Blackboard 查询工具,提供 CLI、MCP 服务、Codex 插件和独立登录窗口。这是社区项目,不是学校官方产品。

使用方式

  1. 安装 Node.js 22.16+,推荐 24 LTS。
  2. 下载 canvas-blackboard-cli-0.2.0.tgz,运行 npm install -g ./canvas-blackboard-cli-0.2.0.tgz
  3. 运行 lms init --preset polyu
  4. 按 README 安装 Codex 插件,在新任务中选择「PolyU 学习助手」并直接提问。
codex plugin marketplace add zs-andy/polyu-lms-cli --ref v0.2.0
codex plugin add lms-cli@polyu-lms

这是可从 GitHub 安装的项目插件市场,不代表已获 Codex 官方精选市场收录。

下载说明

  • .tgz:所有系统使用的 CLI 和 MCP 包,仍需 Node.js。
  • .dmg:macOS Apple Silicon 的可选独立授权 App。
  • .exe:Windows x64 授权 App 的 CI 构建。
  • .AppImage:Linux x64 授权 App 的 CI 构建。
  • SHA256SUMS.txt:CLI 包的 SHA-256 校验和。
  • INSTALLER-SHA256SUMS.txt:三个系统授权 App 安装包的 SHA-256 校验和。

授权 App 不能替代 CLI。默认 CLI 安装包含登录所需的 Electron,独立 App 是可选的。

所有安装包均为未签名预览构建;macOS 包未公证。只从本仓库下载,不要将其理解为学校或系统平台的认证。

验证范围

  • 本地 macOS arm64:27 项自动测试通过,干净安装和 11 个 MCP 工具的握手验证通过;登录主页及学校登录页可打开。
  • GitHub Actions:macOS、Windows、Ubuntu 的依赖安装、类型检查、离线测试、依赖审计和安装包构建全部通过,见 构建记录
  • Gitleaks 源码扫描未发现泄漏,生产依赖审计未发现已知漏洞。这些检查不等同于完整安全审计。

授权 App 附件来自上述 CI 的源码提交 e3c100e;发布标签在此基础上仅更新验证文档,没有运行时代码变化。

已知限制

  • 当前只提供 PolyU 配置,其他学校未完成适配验收。
  • 完整账号登录、MFA 和实际课程问答仍需本人按学校政策验收;Windows/Linux 安装交互尚未人工验收。
  • 快速概览有分页和时间范围限制,不保证覆盖全部历史通知或附件。
  • 本项目不会提交作业、开始考试、发送消息或自动开启每日扫描。
  • 自然语言结果可能有遗漏,重要日期应核对学校原始通知。

校徽和第三方名称属于各自权利人,不在本项目的 MIT 许可范围内。请阅读仓库的 README、隐私说明和安全说明后使用。