nostr-nak

🔧 Nostr 协议全能命令行工具

基于 Nostr Army Knife 的 CLI 交互指南,支持中继发现与密钥管理,助力安全高效地操作去中心化社交协议。

收藏
5.9k
安装
1.7k
版本
1.0.1
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

nostr-nak 是一款面向 Nostr 协议的通用 CLI 工具使用指南型 Skill,旨在帮助用户通过 Nostr Army Knife (nak) 命令行工具与去中心化社交网络进行交互。该 Skill 提供了完整的操作文档,特别针对非交互式环境中的 PTY(伪终端)缓冲问题提供了关键技术解决方案,使用户能够在各类自动化环境中稳定使用 nak 工具。

核心用法方面,nostr-nak 要求所有 nak 命令必须通过 script -q -c 包装以强制创建伪 TTY 环境,避免 stdout 缓冲导致的挂起问题。在 relay(中继)配置上,默认使用 Damus、Primal 和 Nostr.band 三个发现中继,同时支持用户自定义覆盖。身份处理采用 Nostr 标准的 npub(公钥)和 nsec(私钥)格式,分别用于查询和发布操作。典型应用场景包括获取特定公钥的最新笔记、订阅特定话题标签、以及发布事件到指定中继。

该 Skill 的显著优点在于其纯文档属性带来的极高安全性,无代码执行风险,内容完全透明可审计。技术文档详细且实用,特别是针对 PTY 问题的解决方案填补了 nak 工具在非交互式环境中的使用空白。默认中继配置覆盖了 Nostr 生态中最可靠的公共节点,降低了新手用户的配置门槛。同时,文档明确区分了只读查询(-a)和写入操作(--sec)的权限模型,有助于用户理解密钥安全管理。

然而,nostr-nak 也存在一定局限性。首先,它完全依赖外部安装的 nak CLI 工具,该工具来源于 T3 级别的个人开发者,版本兼容性和长期维护存在不确定性。其次,用户需要对 Nostr 协议的密钥体系(npub/nsec)和中继概念有基本了解,学习曲线较陡峭。此外,由于强制使用 script 命令包装,在某些受限的容器环境或 Windows 系统中可能遇到兼容性问题。

适合使用 nostr-nak 的目标群体主要包括:Nostr 协议的开发者和技术研究人员,需要去中心化社交网络的自动化运维人员,以及偏好命令行界面的高级用户。对于希望构建 Nostr 机器人、数据抓取工具或自动化发布系统的开发者尤为适用。

使用风险方面,首要关注的是私钥安全问题。文档示例中涉及使用 nsec 私钥进行发布操作,如果在共享环境或日志未隔离的系统中使用,存在私钥泄露风险。其次,虽然 Skill 本身无网络代码,但 nak 工具会与用户指定的中继建立 WebSocket 连接,选择不可信中继可能导致数据被追踪或拦截。最后,依赖外部 CLI 工具意味着用户需要自行承担该工具的安全更新责任,建议定期检查 nak 官方仓库的安全公告。

安全解读

核心用法

nostr-nak 是一个纯文档型 Skill,专注于指导用户正确使用 Nostr Army Knife (nak) CLI 工具。该 Skill 不提供可执行代码,而是作为使用手册存在。

关键使用模式

  • PTY 强制包裹:由于 nak 在非交互环境下会因 stdout 缓冲而挂起,必须使用 script -q -c "nak ..." /dev/null | cat 包裹所有命令
  • 默认中继:未指定中继时自动使用 wss://relay.damus.iowss://relay.primal.netwss://relay.nostr.band
  • 身份管理:查询用 -a <npub>,发信用 --sec <nsec>

典型示例:获取最近 5 条笔记

script -q -c "nak req -k 1 -a <npub> <relays> -l 5" /dev/null | cat

显著优点

  • 技术细节完整:准确指出 nak 的 PTY 依赖问题并提供可靠解决方案
  • 安全引导:明确区分公钥查询(npub)与私钥签名(nsec)的使用场景
  • 零代码风险:纯 Markdown 文档,无自动执行逻辑,用户完全掌控实际命令执行
  • 生态集成:对接 Nostr 主流中继网络,降低新手配置门槛

潜在局限

  • 工具依赖前置:用户需自行安装 nak CLI,Skill 不提供安装脚本或版本管理
  • T3 来源级别:个人开发者维护,长期更新承诺不确定
  • 无许可证声明:SKILL.md 未明确开源协议
  • 反馈渠道缺失:未提供作者联系方式或问题上报途径

适合人群

  • 熟悉命令行操作的 Nostr 协议用户
  • 需要批量查询或自动化 Nostr 数据的技术开发者
  • 注重密钥本地管理、不愿依赖第三方客户端的隐私敏感用户

常规风险

  • 私钥泄露--sec 参数在命令历史中可能留下痕迹,建议配合专用密钥管理工具
  • 中继可靠性:文档引用中继为第三方公共服务,可用性与数据隐私由对应运营方负责
  • 工具供应链:nak 本体需从官方渠道(fiatjaf/nak)获取,避免使用来路不明的二进制分发

nostr-nak 内容

手动下载zip · 1.3 kB
manifest.jsonapplication/json
请选择文件