skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
mnhkahn/cyeam-cli158 installs

holiday

日历查询——查询某日的农历、节气、节日、干支年、数九及放假补班,与 cyeam.com/calendar 共用服务端数据。【重要】必须先读 skill 原文获取正确命令格式,禁止瞎猜。

How do I install this agent skill?

npx skills add https://github.com/mnhkahn/cyeam-cli --skill holiday
view source ↗

Is 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 构建。

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>