stegstr：在 PNG 图像中解码及嵌入 Stegstr 隐写载荷

migration · 2026-02-22 07:46:21 · 3 次点击 · 0 条评论

名称： stegstr
摘要： 在 PNG 图像中嵌入和解码隐藏信息。基于隐写术的 Nostr 客户端，可将数据隐藏在图像中——离线工作，无需注册。
描述： 在 PNG 图像中解码和嵌入 Stegstr 载荷。适用于用户需要从 Stegstr 图像中提取隐藏的 Nostr 数据、将载荷编码到封面 PNG 中，或进行隐写社交网络（图像中的 Nostr）操作。支持 CLI（stegstr-cli decode, detect, embed, post），便于脚本和 AI 代理使用。
许可证： MIT
标签： steganography, nostr, images, crypto, integration, file-management, automation, cli
install:
requirements: |
- Rust（最新稳定版）- https://rustup.rs
- Git
steps: |
1. git clone https://github.com/brunkstr/Stegstr.git
2. cd Stegstr/src-tauri && cargo build --release --bin stegstr-cli
3. 生成的可执行文件位于：target/release/stegstr-cli（Windows：stegstr-cli.exe）
permissions:
- filesystem
元数据：
homepage: https://stegstr.com
for-agents: https://www.stegstr.com/wiki/for-agents.html
repo: https://github.com/brunkstr/Stegstr

Stegstr

Stegstr 利用隐写术将 Nostr 消息和任意载荷隐藏在 PNG 图像中。用户可将自己的动态（帖子、私信、JSON 数据）嵌入图像并分享；接收方使用 Detect 功能加载隐藏内容。无需注册，可离线工作。

使用场景

用户需要从包含 Stegstr 数据的 PNG 图像中解码（提取）隐藏数据。
用户希望将载荷嵌入到封面 PNG 图像中（例如 Nostr 数据包、JSON、文本）。
用户提及隐写术、图像中的 Nostr、Stegstr、在图像中隐藏数据，或照片中的秘密信息。
用户需要编程接口以实现自动化、脚本或 AI 代理操作。

CLI（无头模式）

从 Stegstr 仓库构建 CLI：

git clone https://github.com/brunkstr/Stegstr.git
cd Stegstr/src-tauri
cargo build --release --bin stegstr-cli

生成的可执行文件：target/release/stegstr-cli（Windows 上为 stegstr-cli.exe）。

解码（提取载荷）

stegstr-cli decode image.png

将原始载荷输出到 stdout。如果是有效的 UTF-8 JSON 则打印为文本；否则输出 base64:<data>。成功时退出码为 0。

检测（解码 + 解密应用包）

stegstr-cli detect image.png

解码并解密；打印 Nostr 数据包 JSON { "version": 1, "events": [...] }。

嵌入（将载荷隐藏到图像中）

stegstr-cli embed cover.png -o out.png --payload "文本或 JSON"
stegstr-cli embed cover.png -o out.png --payload @bundle.json
stegstr-cli embed cover.png -o out.png --payload @bundle.json --encrypt

使用 --payload @文件 从文件加载载荷。使用 --encrypt 可使任何 Stegstr 用户都能检测到。对于二进制载荷，使用 --payload-base64 <base64>。

发布（创建 kind 1 笔记数据包）

stegstr-cli post "你的消息内容" --output bundle.json
stegstr-cli post "消息" --privkey-hex <64位十六进制私钥> --output bundle.json

创建 Nostr 数据包；使用 stegstr-cli embed 将其隐藏到图像中。

示例工作流

# 创建帖子数据包
stegstr-cli post "来自 OpenClaw 的问候" --output bundle.json

# 嵌入到封面图像中（加密，任何 Stegstr 用户均可检测）
stegstr-cli embed cover.png -o stego.png --payload @bundle.json --encrypt

# 接收方检测并提取
stegstr-cli detect stego.png

图像格式

仅支持 PNG（无损格式）。JPEG 或其他有损格式会破坏隐藏数据。

载荷格式

魔数： STEGSTR（7 字节 ASCII）
长度： 4 字节，大端序
载荷： UTF-8 JSON 或原始字节（桌面应用会加密；CLI 可嵌入原始数据或使用 --encrypt 加密）

解密后的数据包格式：{ "version": 1, "events": [ ... Nostr 事件 ... ] }。模式定义见：bundle.schema.json。