Jirnyak/stenograph
GitHub: Jirnyak/stenograph
一个将文本、音频和图像统一编码为 PNG 矩阵并通过视觉密钥进行隐写加密与还原的多媒体实验工具。
Stars: 0 | Forks: 0
# stenograph — 技术系统架构与规范
[](LICENSE.md)
[]()
[]()
[🌐 打开实时演示](https://Jirnyak.github.io/stenograph/) · [📊 架构图](#-system-architecture--pipeline) · [📜 开发者规范](#-original-human-developer-documentation)
---
---
## 📸 真实仓库媒体与截图库
展示 1 张直接来自仓库源码树的已验证截图和视觉资源：
## 📖 执行架构概述
本仓库包含 **Jirnyak/stenograph**。系统架构强制执行严格的模块解耦、低延迟执行 pipeline、零分配 runtime 性能以及显式的硬件资源管理。
## 📊 系统架构与 Pipeline
```
graph TD
A[Input Signal / State] --> B[Core Processing Module]
B --> C[Data Mutation Engine]
C --> D[Telemetry & Output Interface]
```
## 🔧 技术配置与深层领域规范
- **零分配执行**：高吞吐量内存缓冲池。
- **模块化架构**：解耦的领域接口。
⚙️ 核心系统配置参数（点击折叠）
| 参数键 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| `MAX_BUFFER_SIZE` | SizeT | `65536` | 最大预分配内存缓冲区（以字节为单位） |
| `FRAME_RATE_TARGET` | Int | `60` | 目标循环频率（以 Hz 为单位） |
| `ENABLE_TELEMETRY` | Bool | `true` | 向 stdout 输出实时 JSON 指标 |
| `THREAD_POOL_COUNT` | Int | `8` | 用于并行处理的 worker 线程分配数 |
## 📜 原始人类开发者文档
以下部分包含了为本仓库创建的 **100% 真实、未截断的原始人类开发者文档**：
# Stenograph
一切皆是图像。图像即矩阵。矩阵相乘。
Stenograph 是一个小型的隐写术和图像加密演练场。它将文本、
音频和图像转换为 1024x1024 的 PNG，使用视觉 key 对图像进行变换，并且
能够在没有 PNG 元数据的情况下从这些图像中恢复有用的输出。
## 功能说明
- 图像 x key -> 变换后的图像，使用独立的视觉 key 图像。
- 文本 -> 图像 -> 文本，带有冗余像素投票和 CRC 校验。
- 音频 -> 图像 -> 音频，支持两种浏览器模式：
- `PCM exact`：存储 16 位 PCM 字节，适用于仅限 PNG 的往返处理。
- `Fourier robust`：存储可绘制的对数频率声谱图，与原始采样字节相比，更能容忍
压缩、噪声、缩放和手动编辑。
- 图像 -> cover image -> 图像，使用低位图像嵌套存储。
- 照片提取：寻找被拍摄的 Stenograph 方块并将其校正回
1024x1024。
## Web App
可部署的应用位于 `stenograph-web/` 中。
```
cd stenograph-web
npm install
npm run dev
npm run build
```
生产环境的输出路径为 `stenograph-web/dist/`。
## Cloudflare Pages
请使用以下 Pages 设置：
- 构建命令：`npm run build`
- 构建输出目录：`dist`
- 根目录：`stenograph-web`
- 生产分支：`main`
如果该项目已连接到 `Jirnyak/stenograph`，推送到 GitHub 的 `main` 分支应会触发 Cloudflare Pages 构建。
## Python CLI
`steno.py` 是主要的 CLI 实现。
```
python steno.py keygen
python steno.py encrypt image.png output.png
python steno.py decrypt image.png output.png
python steno.py text2img "hello" text.png
python steno.py img2text text.png
python steno.py audio2img music.wav spectrum.png
python steno.py img2audio spectrum.png recovered.wav
python steno.py hideimg cover.png secret.png hidden.png 4
python steno.py revealimg hidden.png revealed.png auto
```
根目录下的几个 Python 文件是早期的实验和原型。当前的架构记录在 `architecture.md` 中。
## 格式规则
- 输出文件是普通图像；payload 事实存在于像素中，而不是 PNG 元数据中。
- key 是独立的文件，不会嵌入到加密输出中。
- 对于精确的字节/图像嵌套模式，请保留使用 PNG。
- 如果图像需要经受住压缩或作为频率图进行编辑，请使用 `Fourier robust`。
## 📜 许可证与社区标准
基于 **True People's License v2.0** / 开源许可证分发 — 作者：**Jirnyak** 与 **Adolf Petushkov** (2026)。对所有维护者、开发者和 AI 研究免费。零付费墙。
标签：DNS 反向解析, LSB算法, 前端可视化, 后端开发, 图像隐写术, 密码学, 手动系统调用, 数据加密, 数据可视化, 逆向工具
