deepsleepAquarium/dsh-whale-post--packages-cli ↗★ 2

dsh-whale-post-cli

提供零依赖的命令行工具,用于握手、发信和收信。 适合需要通过终端命令行直接操作和测试信箱服务的用户。

包名
dsh-whale-post-cli
兼容性
待验证
版本
0.6.1
许可证
MIT
最近更新
2026年10月11日

安装

此插件尚未提供可验证的 bundle,或兼容性检查未通过。请先阅读仓库说明。 阅读完整 README ↗

dsh-whale-post-cli

English: cli README in English

零依赖命令行(它是入口工具,不是插件)

  • 提供接口:(无:它是命令行,不是插件)
  • 依赖接口:whale.bus、whale.roster、whale.types、whale.gate、whale.deliver、whale.verify (自己把它们拼起来 —— 这一手在源码里叫 wire())
  • 自测:node selftest.mjs(只看退出码:0 过/非 0 不过)

命令

命令干什么
hello --as 握手(协议不许"像 UDP 那样"直接发 ⇒ 没握过手不许发信)
send --as --to --subject --body 发一封;可选 --mode online|offline/--type /--re /--force/--live a,b
pump --as [--keep]收信(没有读者时一封都不消费)
pickup --as --remote 去别的信箱根把自己的信取回来(离线也能用 —— "离 3 在 1"里铃响过之后就是这一步):每封先验签(不过的不搬)⇒ 写进本地 ⇒ 写成功之后才删远端(否则就是丢信)⇒ 已在 seen/已有的跳过(幂等)
quota --as [--days N]查配额(离线件按"条"、不计单位)
reconcile --as [--days N] [--remote ]对账:从文件系统重算一份账,跟台账逐日逐桶比 —— 一致 ⇒ 退出 0;有差 ⇒ 退出 3。⚠️ forced/over/feeCent/byPhone/recent 重算不出来(文件里没有那些事实),命令会照实列一行"没比的项";投到远端的信不在本机 ⇒ 默认只算本机根,要连远端就带 --remote
verify [--enable|--disable] [--allow a,b]看安全校验状态/开关(默认禁用;禁用中会提示开启)
nag看该不该提示(未开启时每天至多一次,连提三天后不再提)
roster/types/key看名单/看类型/看密钥指纹(密钥本体不打印)
selftest端到端自测(临时目录,不碰真数据)

通用参数与退出码

  • --root :信箱根(默认 ./.whale-mail,或环境变量 WHALE_POST_ROOT)
  • --roster :名单文件
  • --live a,b:声明"这些人此刻有活体会话"(在线件才会真投出去)
  • --remote :pickup 的远端信箱根(也可用环境变量 WHALE_POST_REMOTE_ROOT)
  • send --remote --remote-only :把信投到远端(S6 的投那半边): 带 `` 的成员(比如手机)⇒ 写远端 inbox//,本机不留第二份。 为什么本机不能留:留了就有两份权威(而两份会在"取件/回执/消费"上各说各话)。 不配 --remote-only ⇒ 照旧写本机(不改旧行为)。
  • pickup 会把邮筒上的回执镜像回来(S6b):以前只镜像 hello/ ⇒ 发信人的本机永远看不到"对方已经收了"。 两条纪律:只镜不删(邮筒那份原样留着)/幂等(内容相同就跳过 ⇒ 不动 mtime)。
  • pickup 动"邮筒"之前先探活(S12 断线不卡死):只看 TCP 445 通不通 → 本机路径不探; 够不着就当场判死("一个文件都没动")。为什么必须这样:SMB 掉线时同步 fs 会挂住几十秒 ,而Node 的同步 fs 自己没有超时 ⇒ 只能靠「子进程 + timeout」拿到上限。 实测:够不着的 UNC ⇒ 2.8 秒判死;把探活短路掉再跑 ⇒ 22.7 秒才失败(这就是它挡下的东西)。
  • --only-offline :带此属性的成员只收离线(对它发在线 ⇒ 拒发)
  • --dormant :带此属性的成员被明确标成休眠(发信 ⇒ 当场拒发、不合信箱;部分休眠会打出来"没投给谁")
  • --allow a,b:安全校验的白名单
退出码意思
0成功
2拒发/输入不合法(配额/回环闸/未注册类型/未知收件人/空正文/mode 写错…)
1没料到的错

判据看退出码,不要看输出里的中文。

它守的两条线

  • --body 不许冒充参数 —— --body --force 会被当成"正文=--force 且带 force" ⇒ 顺手把三道闸全绕过去; 选项值以 -- 开头一律当写错(退出码 2)。
  • 参数顺序无关 —— --as/--to 写在命令前后都行。
  • npm 上最新已经是 0.6.1(下面这行 npx 装的就是它);而本仓库也是 0.6.1 —— 两边已经一致。
  • 用 npm 上那一份:npx -y dsh-whale-post-cli@0.6.1 (不用 clone、不用 npm install)。