opencode-nju-cli 1.3.6

package/README.md

@@ -0,0 +1,63 @@
+# NJU CLI OpenCode Plugin
+
+This package provides an OpenCode plugin for `nju-cli`, plus bundled OpenCode-compatible skill docs for Nanjing University workflows.
+
+## Install
+
+Add the npm plugin to `opencode.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-nju-cli"]
+}
+```
+
+OpenCode installs npm plugins automatically at startup with Bun.
+
+## Tools
+
+The plugin exposes two tools:
+
+- `nju_cli`: runs the bundled `nju-cli` binary.
+- `nju_cli_docs`: reads bundled skill guidance before choosing a subcommand.
+
+Example prompt:
+
+```text
+用 nju_cli_docs 看一下 ehall 怎么查培养方案，然后用 nju_cli 查询。
+```
+
+## Optional Native OpenCode Skill
+
+OpenCode discovers native skills from `.opencode/skills/<name>/SKILL.md` or `~/.config/opencode/skills/<name>/SKILL.md`.
+
+The npm plugin already exposes `nju_cli_docs`, so this copy step is optional. If you want OpenCode's native `skill` tool to discover `nju-cli`, copy `skills/nju-cli` from this repository or unpacked package to one of the native skill paths:
+
+```bash
+mkdir -p ~/.config/opencode/skills
+cp -R skills/nju-cli ~/.config/opencode/skills/
+```
+
+For project-local use, copy `skills/nju-cli` to `.opencode/skills/nju-cli`.
+
+## Packaged CLI
+
+The package includes release binaries under `bin/` and wrappers under `scripts/`.
+
+Supported packaged targets:
+
+- Linux x86_64
+- Linux aarch64, when release artifacts are synced
+- macOS Apple Silicon
+- Windows x86_64
+
+The `nju-cli` binary is built and released from <https://github.com/nju-cli/nju-cli>.
+
+## Development
+
+Dry-run the npm package contents:
+
+```bash
+npm pack --dry-run
+```

package/opencode.example.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-nju-cli"],
+  "permission": {
+    "skill": {
+      "nju-cli": "allow"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "opencode-nju-cli",
+  "version": "1.3.6",
+  "description": "OpenCode plugin and skill docs for Nanjing University workflows powered by nju-cli.",
+  "type": "module",
+  "main": "./src/index.js",
+  "bin": {
+    "nju-cli": "scripts/nju-cli.mjs"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "skills/",
+    "src/",
+    "LICENSE",
+    "README.md",
+    "opencode.example.json"
+  ],
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "nju",
+    "nanjing-university",
+    "cli",
+    "skills"
+  ],
+  "author": {
+    "name": "nju-cli",
+    "url": "https://github.com/nju-cli"
+  },
+  "homepage": "https://github.com/nju-cli/nju-cli",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nju-cli/opencode-nju-cli.git"
+  },
+  "license": "GPL-3.0-only",
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.16.2"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "pack:dry-run": "npm pack --dry-run"
+  }
+}

package/scripts/nju-cli

@@ -0,0 +1,31 @@
+#!/usr/bin/env sh
+set -eu
+
+script_dir=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+plugin_dir=$(CDPATH= cd -- "${script_dir}/.." && pwd)
+
+os=$(uname -s)
+arch=$(uname -m)
+
+case "${os}:${arch}" in
+  Linux:x86_64|Linux:amd64)
+    bin="${plugin_dir}/bin/linux-x86_64/nju-cli"
+    ;;
+  Linux:aarch64|Linux:arm64)
+    bin="${plugin_dir}/bin/linux-aarch64/nju-cli"
+    ;;
+  Darwin:arm64|Darwin:aarch64)
+    bin="${plugin_dir}/bin/macos-aarch64/nju-cli"
+    ;;
+  *)
+    echo "unsupported platform: ${os}/${arch}" >&2
+    exit 1
+    ;;
+esac
+
+if [ ! -x "${bin}" ]; then
+  echo "nju-cli binary is not packaged for ${os}/${arch}; sync package binaries from a release first" >&2
+  exit 1
+fi
+
+exec "${bin}" "$@"

package/scripts/nju-cli.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process"
+import { dirname, join } from "node:path"
+import { fileURLToPath } from "node:url"
+
+const root = join(dirname(fileURLToPath(import.meta.url)), "..")
+
+function binaryPath() {
+  if (process.platform === "linux" && process.arch === "x64") return join(root, "bin/linux-x86_64/nju-cli")
+  if (process.platform === "linux" && process.arch === "arm64") return join(root, "bin/linux-aarch64/nju-cli")
+  if (process.platform === "darwin" && process.arch === "arm64") return join(root, "bin/macos-aarch64/nju-cli")
+  if (process.platform === "win32" && process.arch === "x64") return join(root, "bin/windows-x86_64/nju-cli.exe")
+
+  throw new Error(`nju-cli is not packaged for ${process.platform}/${process.arch}`)
+}
+
+const child = spawn(binaryPath(), process.argv.slice(2), {
+  stdio: "inherit",
+  windowsHide: true,
+})
+
+child.on("error", (error) => {
+  console.error(error.message)
+  process.exit(1)
+})
+
+child.on("close", (code, signal) => {
+  if (signal) {
+    console.error(`nju-cli terminated by ${signal}`)
+    process.exit(1)
+  }
+  process.exit(code ?? 1)
+})

package/scripts/nju-cli.ps1

@@ -0,0 +1,11 @@
+$ErrorActionPreference = "Stop"
+
+$PluginDir = Resolve-Path (Join-Path $PSScriptRoot "..")
+$Bin = Join-Path $PluginDir "bin/windows-x86_64/nju-cli.exe"
+
+if (!(Test-Path $Bin)) {
+  Write-Error "nju-cli binary is not packaged for Windows; sync package binaries from a release first"
+}
+
+& $Bin @args
+exit $LASTEXITCODE

package/skills/nju-cli/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: nju-cli
+description: 南京大学相关操作，比如教务通知，交换生，排名，团委等等。
+license: GPL-3.0-only
+compatibility: opencode
+---
+
+# nju-cli
+
+与南京大学网站交互。
+
+## CLI
+
+优先使用 OpenCode plugin 暴露的工具：
+
+- `nju_cli`: 运行打包的 `nju-cli` 二进制
+- `nju_cli_docs`: 读取此 skill 及其子命令文档
+
+如果是通过本地 skill 文件使用，也可以直接运行 OpenCode plugin / npm package 内置的 `nju-cli` 二进制：
+
+- macOS/Linux: `scripts/nju-cli`
+- Windows: `scripts/nju-cli.ps1`
+
+如果当前安装没有内置二进制，再使用系统 PATH 中的 `nju-cli`。
+
+## Subcommands
+
+这里的文件路径是相对skill目录（也就是此SKILL.md所在目录）来的
+
+| 网站                                               | skill                           |
+| -------------------------------------------------- | ------------------------------- |
+| 教务网：官方通知、校历，比如毕业要求，四六级考试等 | subcommands/academic-affairs.md |
+| ehall网上办事大厅：包含课表、培养方案、成绩查询等  | subcommands/ehall.md            |
+| 交换生管理                                         | subcommands/exchange-system.md  |
+| 南大团委：最新动态、公告通知                       | subcommands/youth-league.md     |

package/skills/nju-cli/subcommands/academic-affairs.md

@@ -0,0 +1,25 @@
+# 教务网
+
+```sh
+# 输出当前全学年教学校历的页面、PDF 和图片链接；不下载、不转文本
+nju-cli academic-affairs calendar
+
+# 列出最近 20 条公告，并缓存公告 ID
+nju-cli academic-affairs list
+
+# 列出最近 100 条公告
+nju-cli academic-affairs list --page-size 100
+
+# 查看公告正文，输出 Markdown；需要先 list
+nju-cli academic-affairs view [公告ID]
+```
+
+如果想要处理大量通知，或从中搜索，可以先下载：
+
+```sh
+# 下载一条公告；需要先 list
+nju-cli academic-affairs download [公告ID]
+
+# 下载多条公告
+nju-cli academic-affairs download [公告ID] [公告ID] [公告ID]
+```

package/skills/nju-cli/subcommands/ehall/all-undergraduate-courses.md

@@ -0,0 +1,53 @@
+# ehall：全校本科课表
+
+页面进入方式是服务大厅搜索“课表”，选择“本-课表查询”。CLI 对应：
+
+```sh
+# 列出当前学期第 1 页，每页 20 条
+nju-cli ehall all-undergraduate-courses list
+
+# 指定页码和页大小
+nju-cli ehall all-undergraduate-courses list --page 2 --page-size 50
+
+# 指定学期
+nju-cli ehall all-undergraduate-courses list --term 2025-2026-2
+
+# 常用筛选：课程名、教师、校区代码、开课单位代码
+nju-cli ehall all-undergraduate-courses list --course-name 高等数学 --teacher 张三 --campus 3 --department 400290
+
+# 任意字段筛选。默认自动推断 builder，也可显式写 FIELD:BUILDER=VALUE
+nju-cli ehall all-undergraduate-courses list --filter KCH=00000041 --filter SKJS=王建华
+nju-cli ehall all-undergraduate-courses list --filter PKDWDM:m_value_equal=400290
+
+# 输出完整 JSON
+nju-cli ehall all-undergraduate-courses list --json --page-size 5
+```
+
+下载会拉取所有匹配课程，默认写 TSV：
+
+```sh
+# 下载当前学期所有课程到 all-undergraduate-courses.tsv
+nju-cli ehall all-undergraduate-courses download
+
+# 指定筛选和输出文件
+nju-cli ehall all-undergraduate-courses download --course-name 中国近现代史纲要 -o courses.tsv
+
+# 下载 JSON
+nju-cli ehall all-undergraduate-courses download --json -o courses.json
+```
+
+常用筛选参数：
+
+- `--course-id` 课程号 KCH
+- `--course-name` 课程名 KCM
+- `--class-name` 教学班名称 JXBMC
+- `--teacher` 上课教师 SKJS
+- `--campus` 校区代码 XXXQDM
+- `--department` 开课单位代码 PKDWDM
+- `--general-category` 通修课程类别代码 TXKCLB
+- `--weekday` 上课日期 SKXQ
+- `--start-period` 开始节次 KSJC
+- `--end-period` 结束节次 JSJC
+- `--week` 上课周次 SKZC
+- `--building` 教学楼代码 JXLDM
+- `--classroom` 上课教室 SKJAS

package/skills/nju-cli/subcommands/ehall/grades.md

@@ -0,0 +1,89 @@
+# ehall：成绩查询
+
+页面进入方式是服务大厅搜索“成绩查询”，选择“成绩查询”。CLI 对应：
+
+## 课程成绩
+
+```sh
+# 列出所有学期
+nju-cli ehall grades terms
+
+# 列出默认学期范围内的成绩
+nju-cli ehall grades list
+
+# 指定学期，支持多次传入
+nju-cli ehall grades list --term 2025-2026-2
+nju-cli ehall grades list --term 2025-2026-1 --term 2025-2026-2
+
+# 按课程名或课程号筛选
+nju-cli ehall grades list --course-name 形势与政策
+nju-cli ehall grades list --course-id 00000080H
+
+# 只看及格或未及格课程
+nju-cli ehall grades list --passed
+nju-cli ehall grades list --failed
+
+# 和页面里的“显示最高成绩”一致
+nju-cli ehall grades list --show-max-grade
+
+# 输出完整 JSON
+nju-cli ehall grades list --json
+```
+
+`list` 的普通输出包含学年学期、课程号、课程名、学分、课程性质、总成绩、是否及格和成绩单标记。
+
+## 四六级成绩
+
+```sh
+# 查询大学英语四级、六级成绩
+nju-cli ehall grades cet
+
+# 指定学期
+nju-cli ehall grades cet --term 2023-2024-1
+
+# 指定考试项目代码；不传默认 CET4 和 CET6
+nju-cli ehall grades cet --exam-type CET6
+
+# 输出完整 JSON
+nju-cli ehall grades cet --json
+```
+
+`cet` 的普通输出包含学年学期、考试项目、成绩、是否通过、考试日期和院系。
+
+## 体测成绩
+
+```sh
+# 查询体测成绩
+nju-cli ehall grades fitness
+
+# 指定学期
+nju-cli ehall grades fitness --term 2025-2026-2
+
+# 输出完整 JSON
+nju-cli ehall grades fitness --json
+```
+
+`fitness` 的普通输出包含学年学期、考试项目、成绩、是否通过、考试日期和院系。
+
+## 下载
+
+下载会拉取所有匹配成绩，默认写 TSV：
+
+```sh
+# 下载默认学期范围内所有成绩到 grades.tsv
+nju-cli ehall grades download
+
+# 指定筛选和输出文件
+nju-cli ehall grades download --term 2025-2026-2 -o grades.tsv
+
+# 下载 JSON
+nju-cli ehall grades download --json -o grades.json
+
+# 下载四六级成绩
+nju-cli ehall grades download-cet -o cet-grades.tsv
+nju-cli ehall grades download-cet --json -o cet-grades.json
+
+# 下载体测成绩
+nju-cli ehall grades download-fitness -o fitness-grades.tsv
+nju-cli ehall grades download-fitness --json -o fitness-grades.json
+```

package/skills/nju-cli/subcommands/ehall/my-course-schedule.md

@@ -0,0 +1,76 @@
+# ehall：我的课表
+
+页面进入方式是服务大厅搜索“课表”，选择“我的课表”。如果搜索不到入口，先在服务大厅点一次登录；统一认证的 `CASTGC` cookie 不能直接作为 ehall 会话使用。
+
+## 学期和课表
+
+```sh
+# 列出可选学期
+nju-cli ehall my-course-schedule terms
+
+# 输出学期接口的完整 JSON
+nju-cli ehall my-course-schedule terms --json
+
+# 列出当前学期我的课表
+nju-cli ehall my-course-schedule list
+
+# 列出指定学期课表
+nju-cli ehall my-course-schedule list --term 2025-2026-2
+
+# 指定页码和页大小
+nju-cli ehall my-course-schedule list --page 1 --page-size 50
+
+# 输出课表接口的完整 JSON
+nju-cli ehall my-course-schedule list --term 2025-2026-2 --json
+```
+
+`list` 的普通输出包含课程号、课程名、教师、上课时间地点、开课单位、学分、期末信息和备注等摘要字段。
+
+## 课程详情
+
+课程详情可用课程号 `KCH` 或教学班 `JXBID` 查询，支持一次查询多个课程：
+
+```sh
+# 直接输出课程详情 JSON
+nju-cli ehall my-course-schedule detail 00000080H
+
+# 一次查询多个课程
+nju-cli ehall my-course-schedule detail 00000080H 22011720S
+
+# 查询指定学期
+nju-cli ehall my-course-schedule detail 00000080H --term 2025-2026-2
+
+# 下载详情到目录，每个课程写一个 JSON 文件
+nju-cli ehall my-course-schedule detail 00000080H 22011720S -o course-details
+```
+
+详情 JSON 会尽量包含接口能拿到的全部课程信息，包括课表行、课程信息、教材信息、选课/教学班信息、期末信息和备注等字段。
+
+## 考试说明
+
+页面底部的考试说明、上课冲突说明等内容来自 `.kssm-container`：
+
+```sh
+nju-cli ehall my-course-schedule exam-notes
+```
+
+## 免修不免考
+
+```sh
+# 查看所有已申请记录
+nju-cli ehall my-course-schedule exemptions
+
+# 只看某个学期的申请记录
+nju-cli ehall my-course-schedule exemptions --term 2025-2026-2
+
+# 输出完整 JSON
+nju-cli ehall my-course-schedule exemptions --json
+
+# 申请某门课免修不免考，课程参数可以是课程号 KCH 或教学班 JXBID
+nju-cli ehall my-course-schedule apply-exemption 00000080H --reason "已自学相关内容"
+
+# 指定学期申请
+nju-cli ehall my-course-schedule apply-exemption 00000080H --term 2025-2026-2 --reason "已自学相关内容"
+```
+
+`apply-exemption` 会先按页面 JS 的流程检查课程是否可申请、选择对应流程和初始状态，再提交申请。这个命令会实际发起申请，运行前确认课程和理由无误。

package/skills/nju-cli/subcommands/ehall/training-program.md

@@ -0,0 +1,94 @@
+# ehall：本科人才培养方案查询
+
+页面进入方式是服务大厅搜索“培养方案”，选择“本-培养方案查询”。CLI 对应：
+
+```sh
+# 列出所有专业培养方案
+nju-cli ehall training-program list
+
+# 按培养方案名称模糊搜索
+nju-cli ehall training-program list --name 计算机
+
+# 按年级、院系代码、修读类型代码筛选
+nju-cli ehall training-program list --grade 2026 --department 400290 --study-type 01
+
+# 设置每次请求页大小；命令会自动拉取全部匹配结果
+nju-cli ehall training-program list --page-size 200
+
+# 输出完整 JSON
+nju-cli ehall training-program list --name 计算机 --json
+```
+
+`list` 的普通输出为 TSV 摘要，包含培养方案代码 `PYFADM`、培养方案名称、年级、院系和专业。后续 `detail`、`nodes` 等命令都需要使用 `PYFADM`。
+
+常用筛选参数：
+
+- `--name` 培养方案名称 `PYFAMC`，模糊搜索。
+- `--grade` 年级代码 `NJDM`，如 `2026`。
+- `--department` 院系代码 `DWDM`。
+- `--study-type` 修读类型代码 `XDLXDM`，如 `01`。
+
+## 方案详情
+
+```sh
+# 查看某个培养方案详情
+nju-cli ehall training-program detail PYFADM
+
+# 输出完整 JSON
+nju-cli ehall training-program detail PYFADM --json
+```
+
+普通输出包含培养方案代码、名称、年级、院系、专业、修读类型，以及接口返回的培养目标、修读要求、准出要求等文本。
+
+## 课程结构节点
+
+培养方案里的课程要求以节点树组织，每个节点有节点代码 `KZH`：
+
+```sh
+# 列出某个培养方案的节点树
+nju-cli ehall training-program nodes PYFADM
+
+# 输出完整 JSON
+nju-cli ehall training-program nodes PYFADM --json
+```
+
+普通输出会显示节点树，并提示：
+
+```text
+课程查询: nju-cli ehall training-program courses PYFADM <KZH>
+节点详情: nju-cli ehall training-program node-detail PYFADM <KZH>
+```
+
+节点摘要包含 `KZH`、节点类型、课程类别、课程数、要求学分等信息；如果节点有修读要求或备注，会显示 `[node-detail有额外信息]`。
+
+## 节点详情
+
+```sh
+# 查看某个节点详情
+nju-cli ehall training-program node-detail PYFADM KZH
+
+# 输出完整 JSON
+nju-cli ehall training-program node-detail PYFADM KZH --json
+```
+
+节点详情普通输出包含父节点、节点类型、课程类别、课程数、总学分、至少修读学分、修读要求和备注等字段。
+
+## 节点课程
+
+```sh
+# 查看某个节点下的所有课程
+nju-cli ehall training-program courses PYFADM KZH
+
+# 输出完整 JSON
+nju-cli ehall training-program courses PYFADM KZH --json
+```
+
+`courses` 会自动拉取该节点下全部课程。普通输出为 TSV 摘要，包含课程号、课程名、学分、建议修读学期和开课院系。
+
+## 会话说明
+
+该功能默认使用“本科学生组”角色。命令执行前会自动打开应用入口、进入带 `_roleId` 的应用页并切换角色；如果接口返回 302、403 或提示会话异常，通常需要重新执行：
+
+```sh
+nju-cli login --username USERNAME --password PASSWORD
+```

package/skills/nju-cli/subcommands/ehall.md

@@ -0,0 +1,22 @@
+# ehall
+
+ehall 命令用于访问南京大学网上办事大厅相关服务。
+
+## 登录
+
+使用 ehall 命令前需要先登录，但本机很可能已经登陆过了：
+
+```sh
+nju-cli login --username USERNAME --password PASSWORD
+```
+
+## 功能文档
+
+这里的文件路径是相对 skill 目录（也就是 `nju-cli-skills/SKILL.md` 所在目录）来的。
+
+| 功能                           | CLI 子命令                                | 文档                                             |
+| ------------------------------ | ----------------------------------------- | ------------------------------------------------ |
+| 本科人才培养方案               | `nju-cli ehall training-program`          | `subcommands/ehall/training-program.md`          |
+| 全校本科课表                   | `nju-cli ehall all-undergraduate-courses` | `subcommands/ehall/all-undergraduate-courses.md` |
+| 我的课表                       | `nju-cli ehall my-course-schedule`        | `subcommands/ehall/my-course-schedule.md`        |
+| 成绩查询（课程，四六级，体测） | `nju-cli ehall grades`                    | `subcommands/ehall/grades.md`                    |

package/skills/nju-cli/subcommands/exchange-system.md

@@ -0,0 +1,27 @@
+# 交换生系统
+
+## 查看项目
+
+```bash
+nju-cli exchange-system project list --page-size 10
+# 输出: [id] [name]
+
+nju-cli exchange-system project view [id]
+
+# 如果要处理大量项目描述，可先下载
+nju-cli exchange-system project download [id1] [id2] ...
+```
+
+## 查看通知
+
+通知一般是公示某个项目通过了哪些人。
+
+```bash
+nju-cli exchange-system notice list --page-size 10
+# 输出: [id] [name]
+
+nju-cli exchange-system notice view [id]
+
+# 如果要处理大量项目通知，可先下载
+nju-cli exchange-system notice download [id1] [id2] ...
+```

package/skills/nju-cli/subcommands/youth-league.md

@@ -0,0 +1,33 @@
+# 南大团委
+
+支持“最新动态”和“公告通知”两个栏目：
+
+- `latest-dynamics` 最新动态
+- `announcements` 公告通知
+
+```sh
+# 列出最新动态第 1 页，并缓存文章 ID
+nju-cli youth-league list latest-dynamics
+
+# 列出公告通知第 1 页，并缓存文章 ID
+nju-cli youth-league list announcements
+
+# 指定页码；团委站点固定每页 14 条
+nju-cli youth-league list announcements --page 2
+
+# 查看文章正文，输出 Markdown；需要先 list
+nju-cli youth-league view announcements [文章ID]
+nju-cli youth-league view latest-dynamics [文章ID]
+```
+
+如果想要处理大量文章，或从中搜索，可以先下载：
+
+```sh
+# 下载一篇文章；需要先 list
+nju-cli youth-league download announcements [文章ID]
+
+# 下载多篇文章
+nju-cli youth-league download latest-dynamics [文章ID] [文章ID] [文章ID]
+```
+
+公告中嵌入的 PDF player 会在 Markdown 末尾保留 PDF 文件的绝对 URL。