@tianbuyu-wwx/dsh-formatforge

使用

1. 网页拖拽（零学习成本）

把任何支持的文件拖进 dsh 网页任意位置：

• 非图片文件 → 自动上传并锻造，右下角 toast 显示进度与结果
• 图片 → 走 dsh 原生图片附件通道（不受影响）
• 转换完成后活跃会话收到轻量通知，附产物路径

产物落在收件箱目录（默认 ~/.dsh/formatforge/inbox/）： .ff.md（可直接阅读）+ .ff.json(完整协议数据)。

2. 对话内工具

工具	用途
ff_translate	转换：path（单个）/ paths（多个，支持 * glob）/ text 三选一；format json·markdown·html·text；max_chars/offset 分页；quality 附质量报告
ff_formats	列出支持的输入格式矩阵

3. CLI（脱离 dsh 也能用）

pip install -e .   # 之后
python -m formatforge translate document.pdf --format markdown
python -m formatforge translate --stdin-text < notes.txt
python -m formatforge formats      # 支持格式矩阵

stdout 输出单行协议 JSON（{ok, code, data:{content, meta, quality?, enhance?}}），日志走 stderr，退出码 0/2/3/4。

配置

变量	默认	说明
FF_REPO_ROOT	自动探测	含 formatforge/ core/ parsers/ 的仓库根
FF_PYTHON	探测链兜底 PATH	指定解释器（≥3.10）
FF_MAX_BYTES	104857600	单文件上限（100MB）
FF_TIMEOUT_S	120	单次转换超时（秒）
FF_INBOX_NOTIFY	true	锻造完成后是否向会话注入轻量通知
OCR_ENABLED	true	启用本地 OCR（tesseract/paddleocr/easyocr 任一）