YUNA.BLOG

YUNA / Command line

把 YUNA
带进终端。

读一篇文章，查下一次相聚的课表。
或者，带一枚数据包穿过网络。

燕山大学大学生网络信息协会的命令行工具。
从日常学习到课间的一局小游戏，一条命令就能开始。

npx -y yuna-team@latest --help

已安装 Node.js？复制到终端，先看看能做什么。

安装与下载 浏览命令
yuna — terminal

yuna --help

yuna / 从终端出发

join
招新与加入信息
posts
找到想读的文章
read
接着读下去
projects
发现协会项目
lesson
看看这学期学什么
open
在浏览器继续探索
play
来一局数据包冒险

命令概览 · 界面示意

与官网同步公开文章、项目与授课计划

按你的习惯使用终端阅读，也支持 JSON 输出

留一点好玩完全离线的网络主题小游戏

Get started

选一种方式，开始使用。

完整使用文档

01 / npm

已经有 Node.js

需要 Node.js 18.17 或更新版本。安装一次，以后在任意目录都能使用 yuna。

  1. 安装 CLI

    在终端中运行，获取最新发布版本。

    npm i -g yuna-team@latest

  2. 确认安装成功

    看到版本号，就可以开始使用了。

    yuna --version

  3. 读点新内容

    看看最近的五篇文章，再用 yuna read 1 阅读第一篇。

    yuna posts -n 5

之后如何更新或卸载？

更新时再次运行上面的安装命令。卸载使用 npm uninstall -g yuna-team，本地游戏成绩和文章快照会保留。

只想临时体验？页面顶部的 npx 命令无需全局安装。

在 npm 查看软件包

02 / Standalone

直接下载独立程序

无需安装 Node.js。从 GitHub Releases 的 Assets 下载对应压缩包，解压后在该目录打开终端。六种下载文件与程序名称如下：

Windowsx64
下载 yuna-windows-x64.zip运行 yuna-windows-x64.exe
WindowsARM64
下载 yuna-windows-arm64.zip运行 yuna-windows-arm64.exe
macOSIntel · x64
下载 yuna-darwin-x64.tar.gz运行 yuna-darwin-x64
macOSApple · ARM64
下载 yuna-darwin-arm64.tar.gz运行 yuna-darwin-arm64
Linuxx64
下载 yuna-linux-x64.tar.gz运行 yuna-linux-x64
LinuxARM64
下载 yuna-linux-arm64.tar.gz运行 yuna-linux-arm64
查看各平台运行命令

先解压，再选择与你下载的程序对应的一组命令执行。

Windows x64 · PowerShell
.\yuna-windows-x64.exe --help
Windows ARM64 · PowerShell
.\yuna-windows-arm64.exe --help
macOS Intel · x64
chmod +x ./yuna-darwin-x64
./yuna-darwin-x64 --help
macOS Apple 芯片 · ARM64
chmod +x ./yuna-darwin-arm64
./yuna-darwin-arm64 --help
Linux x64
chmod +x ./yuna-linux-x64
./yuna-linux-x64 --help
Linux ARM64
chmod +x ./yuna-linux-arm64
./yuna-linux-arm64 --help

macOS 的下载文件使用 darwin 命名。只有 Windows 程序带 .exe；macOS / Linux 程序没有扩展名。若拿到的已是程序文件，可直接使用上面的运行命令。

要直接使用下方的 yuna 示例，请将程序重命名为 yuna.exe（Windows）或 yuna，并将所在目录加入 PATH；也可以把示例中的 yuna 换成解压后程序的相对路径。

打开 GitHub Releases

Everyday commands

常用命令，熟悉的 YUNA。

安装后即可使用。
yuna <命令> --help 查看详细用法。

想做什么试试这条命令使用提示
了解招新yuna join查看加入信息；招新结束后显示收官与后续参与入口。
找文章yuna posts -n 5 --tag 运维按标签筛选，默认显示最近 10 篇，支持文章与资料分类。
读一篇yuna read 1先运行 posts，再按列表编号阅读；也可以直接输入文章 slug。
发现项目yuna projects --network public查看公网项目；支持关键词、进展状态与标签筛选。
查看课表yuna lesson默认展示最新届次，使用 --all 查看全部届次。
打开网页yuna open recap在浏览器打开招新收官页，也支持站内路径与完整网址。
玩一局yuna play packet --seed yuna离线数据包冒险，固定地图可以反复练习。

想交给脚本处理？加上 --json。例如 yuna lesson --json 输出课表数据；yuna open recap --json 只输出地址，不启动浏览器。

A little side quest

这一次，
你就是数据包。

用方向键或 WASD 移动，经过两个路由，再把自己送到服务器。

避开拥塞与丢包，留意 TTL（体力）和重传机会（护盾）。停下来想路线不会扣体力，按 T 还能看看提示。

同一个种子就是同一张地图。用 yuna 练手，把地图名字发给同学比比成绩；通关后按 V 查看传输复盘。

yuna play packet --seed yuna

安装后完全离线游玩，成绩保存在你的电脑上。

packet / 数据包冒险

送达之前，每一步都算数。

[]
你 / 数据包
R
路由打卡点
G?
待解锁终点
~~
链路拥塞

↑ ↓ ← → 移动 · H 帮助 · Q 退出

玩法示意，非实际种子地图。途经两个路由后，服务器终点解锁。

Good to know

开始之前，
你可能还想知道。

反馈问题
需要什么环境？需要登录吗？

npm / npx 方式需要 Node.js 18.17 或更新版本；独立程序无需 Node.js。文章、课表、项目与招新信息读取官网公开内容，无需登录或密钥。小游戏安装后无需网络。

如何更新或卸载？

npm 安装用户执行 npm i -g yuna-team@latest 更新，执行 npm uninstall -g yuna-team 卸载。独立程序用户从 Releases 下载新版，解压后替换旧程序，删除程序文件即可卸载。yuna --version 可以查看当前版本；卸载程序不会自动删除本地缓存与游戏成绩。

安装后提示找不到 yuna 命令？

先重新打开终端。npm 全局安装后，需要将 npm 的全局可执行文件目录加入 PATH。独立程序的名称包含系统与架构：例如 Windows x64 在解压目录执行 .\yuna-windows-x64.exe --help；其它平台的完整命令见安装与下载。也可以重命名为 yuna.exe / yuna 并将所在目录加入 PATH。

网络连接不通，如何使用代理？

联网命令可以显式指定代理，例如 yuna posts --proxy http://127.0.0.1:7890，请把地址改为你实际使用的代理。CLI 不会自动读取 HTTP_PROXY / HTTPS_PROXY；代理失败会报错。该参数只影响 CLI 的接口请求，离线 play 命令不接受代理参数。

小游戏窗口太小，或终端不支持交互？

把终端调整到至少 42 列 × 18 行，游戏会随窗口大小调整布局。没有键盘交互的环境可以运行 yuna play packet --seed yuna --json 查看地图数据；交互游玩请使用本机终端。

数据和成绩存在哪里？

普通命令只读取官网公开数据，不写入线上内容。文章列表编号快照和游戏成绩保存在本地；YUNA_CACHE_DIR 可指定缓存目录。完整路径与说明见 使用文档。

Built by YUNA

一起把它变得更好用。

一个实用的命令，一段更清楚的文档，都可以从你的想法开始。

源码与文档更新记录建议与反馈