@tianbuyu-wwx/dsh-formatforge

使用方式

• 拖拽：把非图片文件拖进窗口 → 自动上传锻造 → 收件箱产出 .ff.md（可读）+ .ff.json（完整协议），并向会话注入一条轻量通知。图片与文件夹一律放行：图片走宿主原生附件通道，文件夹由宿主自己变成 @路径 引用——插件不接管（v2.0.2 起，拖文件夹不再卡死）。拖动期间右上角常驻 × 退出拖拽，遮罩右上角也有 ×，按 Esc 等效：点一下就能清掉卡住的遮罩并复位宿主状态，不必刷新页面；× / Esc 之后这一段拖拽整体交回宿主（松手不会再被接管），下一次拖拽照常锻造。
• 右侧栏面板（v3.0.0）：宿主右侧栏的 FormatForge 页签（或侧栏底部按钮 / 内置 guide 页卡片进入）——搜索产物（中文子串可用）、看正文预览与元数据、复制路径、重新锻造、从列表移除；每页条数偏好持久化。面板是增强项：宿主插槽契约变化时只记日志，拖拽与工具不受影响。
• 收件箱索引库（v3.0.0）：/formatforge/index.db（SQLite）存元数据 + 全文索引 + 偏好；.ff.md/.ff.json 仍是真相源，删库可用 python -m formatforge inbox reindex 重建。工具侧可用 ff_result {search:"…"} / {stats:true} / {list:true, limit:20}。
• 路径：在对话里给本地路径，agent 会先 ff_translate 再回答。
• CLI：python -m formatforge translate doc.pdf --format markdown（stdout 单行协议 JSON，退出码 0/2/3/4）；索引库另见 python -m formatforge inbox --help。

配置

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