holiday
日历查询——查询某日的农历、节气、节日、干支年、数九及放假补班,与 cyeam.com/calendar 共用服务端数据。【重要】必须先读 skill 原文获取正确命令格式,禁止瞎猜。
How do I install this agent skill?
npx skills add https://github.com/mnhkahn/cyeam-cli --skill holidayIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides calendar and holiday information by querying a vendor API or using a dedicated CLI tool. It downloads a binary from the author's GitHub repository, verifies its integrity using SHA-256, and installs it to the user's local directory. The skill also includes documented usage analytics and checks for updates.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
日历与假期查询
概述
查询日期的完整日历信息,数据与 万年历页面 共用 https://www.cyeam.com/api/calendar/dates?year=<年份>。页面和 CLI 都使用服务端返回的农历、节气、节日、干支年、数九以及休息/补班状态,不在 Skill 中维护节日表或计算规则。
优先直接请求上述页面接口,按完整日期键取当天记录并展示。这样无需安装或更新 CLI,网页服务端的数据升级后,Skill 下次请求即会获取新版结果。示例:
curl --fail --silent --show-error 'https://www.cyeam.com/api/calendar/dates?year=2027'
响应是以 YYYY-MM-DD 为键的全年对象。当天记录含 date、week(周一为 1)、type、name、is_holiday、is_adjusted_workday、lunar、lunar_day、term、festivals、gan_zhi_year、shu_jiu。展示农历、节气(含南北方小年标签)、节日、休息/补班状态,按需补充干支年和数九;空值不展示。仅凭节日名称不能推断放假,须使用返回的状态字段。未来新增字段可直接按其含义展示。
接口报错、404 或缺少目标日期时说明数据不可用,不切回 timor.tech 或自行猜测放假安排。404 通常表示网页新版接口尚未部署。
也可使用已迁移的本地 CLI(旧版 CLI 仍直连 timor.tech,不能保证一致):
cyeam date holiday # 今天
cyeam date holiday 2026-10-01 # 指定日期
cyeam date holiday 2026-10-01 --json # 完整记录,保留未来新增字段
cyeam date holiday next-monday # 不支持,只接受 YYYY-MM-DD
安装
安装前先阅读下面的命令。示例固定为 v1.1.4,不跟随 latest;下载的是可执行程序归档。 仅在需要安装 CLI 时执行,不要在每次调用命令时重复安装。
macOS / Linux:校验后安装到用户目录
在 Bash 或 Zsh 中执行;需要 curl、tar、install,以及 shasum 或 sha256sum。
脚本自动选择 macOS / Linux 的 arm64 或 x86_64,其他平台会停止。
(
set -eu
version='v1.1.4'
case "$(uname -s)/$(uname -m)" in
Darwin/arm64)
asset='cyeam_Darwin_arm64.tar.gz'
sha256='06b5af004ab4f0f05d5829ea6bd18b97c4449c262af7df14c67175f7d3cb29db' ;;
Darwin/x86_64)
asset='cyeam_Darwin_x86_64.tar.gz'
sha256='107342bb9d2fa444b96155c468e71b8cc63e0f5ad0acc784698afe221548efa6' ;;
Linux/aarch64|Linux/arm64)
asset='cyeam_Linux_arm64.tar.gz'
sha256='ed87697f3948bead67b585e9881c3bef20e8d2d903beb5b125587281a5091c5b' ;;
Linux/x86_64)
asset='cyeam_Linux_x86_64.tar.gz'
sha256='873d6805fab8ab56540bb034aaf2f57f12eb672fcabd322ebe401e8250a5966d' ;;
*) echo '不支持的平台,请查看固定版本的 Release。' >&2; exit 1 ;;
esac
workdir=$(mktemp -d)
trap 'rm -rf "$workdir"' EXIT
cd "$workdir"
curl --fail --show-error --silent --location --proto '=https' --proto-redir '=https' \
--output "$asset" "https://github.com/mnhkahn/cyeam-cli/releases/download/$version/$asset"
printf '%s %s\n' "$sha256" "$asset" > expected.sha256
if command -v sha256sum >/dev/null 2>&1; then
sha256sum -c expected.sha256
else
shasum -a 256 -c expected.sha256
fi
# set -e 确保下载或校验失败时,不会解压或安装。
tar -xzf "$asset" cyeam
mkdir -p "$HOME/.local/bin"
install -m 0755 cyeam "$HOME/.local/bin/cyeam"
CYEAM_CLI_NO_UPDATE_NOTIFIER=1 "$HOME/.local/bin/cyeam" --no-analytics version
)
只写临时目录和 ~/.local/bin/cyeam(已有同名程序会被替换),无需管理员权限,
不修改系统目录、服务或 shell 配置。当前 shell 使用:
export PATH="$HOME/.local/bin:$PATH"
如需永久生效,可自行把上面这一行加入 shell 配置。 可在 v1.1.4 发布页 和 checksums.txt 核对摘要。升级固定版本时,必须同时核对并替换版本号和对应 SHA-256。 摘要用于核对发布文件一致性,不等同于独立签名或安全审计。
外部请求和权限用途
- 安装下载:只从 GitHub 的固定 Release 下载选定归档;GitHub 可能重定向到其资产 CDN。
下载后先验证文档中固定的 SHA-256,再解压单个
cyeam文件。安装检查关闭统计与更新提示。 - 日历查询:向
https://www.cyeam.com/api/calendar/dates?year=<年份>请求全年日历, 取目标日期的完整记录;与页面共用服务端规则、假期缓存和上游降级结果。不上传本地文件,不需要登录。 网页服务端部署后,数据与日历规则的更新会同时作用于页面和 Skill;接口字段含义或命令格式变更仍需同步客户端。 - 使用统计:默认向
https://us.i.posthog.com发送命令名称、CLI 版本、系统信息和随机安装编号, 服务端可根据出口 IP 解析地域;不发送命令参数、图片内容或登录凭证。 随机编号保存在~/.cyeam/analytics-id,用--no-analytics或CYEAM_CLI_NO_ANALYTICS=1关闭。 - 更新提示:默认最多每 24 小时向 GitHub 检查最新版本,并缓存到
~/.cyeam/update-state.json, 提示本身不会替换程序。设置CYEAM_CLI_NO_UPDATE_NOTIFIER=1关闭。cyeam update是显式升级命令,会下载并校验最新 Release、替换当前程序,成功后还会尝试通过npx skills add同步 skills;需要保持固定版本时不要运行它,按上述步骤安装选定版本。
关闭 CLI 统计和更新提示(业务本身的网络请求不受影响),可在当前 shell 设置:
export CYEAM_CLI_NO_ANALYTICS=1
export CYEAM_CLI_NO_UPDATE_NOTIFIER=1
输出
日期: 2026-10-01
星期: 周四
状态: 休息日
名称: 国庆节
农历: 八月廿一
干支年: 丙午
节日: 国庆节
状态说明
| 状态 | 含义 |
|---|---|
| 工作日 | 普通上班日 |
| 休息日 | 法定假日或周末 |
| 周末休息 | 周末 |
| 调休补班 | 调休安排的上班日(如国庆前的周末) |
注意事项
- 日期格式必须为
YYYY-MM-DD,支持 1900–2100 年,省略参数默认为用户所在时区的今天 - 不需要登录
- 未公布年度或上游异常时,服务端可能仅返回周末规则;页面与 Skill 共用该结果,不代表该年法定安排已公布。
- 页面手机版会缩短农历和“补班”标签;Skill 展示完整记录。
- 上述 v1.1.4 安装示例为历史固定版本,不含本次迁移;要使用共享日历,请直接请求页面接口,或使用包含本次改动的 CLI 构建。
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/mnhkahn/cyeam-cli/holiday">View holiday on skillZs</a>