用途：ntn 是 Notion 官方命令行工具，面向需要在终端或由智能体自动化操作 Notion 的场景，覆盖认证、Workers 管理、公共 API 调用与文件上传。
安装与认证：通过 npm i -g ntn 全局安装；使用 ntn login 登录、ntn logout 退出。调用 API 与文件命令需配置 Notion 集成令牌环境变量 NOTION_API_TOKEN。
主要能力：ntn api 可访问完整公共 Notion API，ntn api ls 列出可用端点，--spec 与 --docs 查看端点规范或文档。请求支持内联语法：字符串赋值如 parent[page_id]=abc123，类型化 JSON 赋值如 archived:=true，查询参数用 ==（如 page_size==100），请求头直接写 Accept:application/json，也可用 -d 传 JSON 体。默认 GET，存在 body 字段时自动 POST，可用 -X/--method 覆盖。文件方面支持 ntn files create 从 stdin 或 --external-url 上传，ntn files list 与 ntn files get 查看上传。Workers 提供 ntn workers list、ntn workers deploy 等，可用 --help 查看。
使用方式：安装后先登录并设置令牌，再按上述语法调用 API 或管理 Workers；shell 补全可提示 API 路径与支持的方法。
限制：目前为 alpha 版本，聚焦 Workers 开发工作流；ntn files create 成功时默认静默，仅在 stderr 为 TTY 时显示进度条。其他功能、收费与平台支持资料暂未提供。