dsh-omnifile

使用

1. 通过 拖拽 / 粘贴 / 点击上传按钮 / @ 选文件 把文件加入输入框：输入框出现文件 chip，图片走 DSH 原生附件。
2. 文件加入后立即开始后台解析，解析进度实时显示在输入框上方 chip 上；解析完成后聊天内生成可展开的文件卡片。
3. 点击发送：若还有文件在解析会先等待（对话区底部显示“正在解析文件 x/y：…”，可随时移除单个文件、不影响本次发送），全部完成后消息发出、主模型开始回答。
4. 点击聊天卡片上的 📂 可本地打开源文件；点击卡片行可展开查看转换后的 md 全文。
5. 图片发给支持 image 的主模型时直接看原图；文本-only 主模型（走 omnifile-* 变体）会收到围绕你问题生成的多模态描述。

配置（settings.yaml 示例）

omnifile:
  providerRef: llm-pi-ai/vision/general-model   # 「设置-模型」中选择的多模态模型唯一引用
  reasoningEffort: medium     # 启用思考模式时发送的 reasoning_effort
  thinking: false             # 默认禁止思考模式
  enableVariants: true        # 为文本-only 主模型注册 omnifile-* 变体
  timeoutMs: 60000            # 单次多模态调用超时（毫秒）
  maxFileBytes: 52428800      # 单文件上限（50MB）
  maxDocImages: 8             # 每个文档最多识别的内嵌图片数
  docMaxChars: 120000         # 文档 Markdown 截断上限（字符）
  describeCacheMax: 300       # 识图结果缓存条数（LRU）
  listMaxFiles: 2000          # @ 文件选择器最多列出文件数
  listMaxDepth: 12            # @ 文件选择器递归深度
  maxNameChars: 120           # 文件名清洗后最大长度（字符）
  maxBatchImages: 20          # 一次粘贴/拖拽最多放入原生附件的图片数（客户端）
  progressPollMs: 400         # 解析进度轮询间隔（毫秒，客户端）
  concurrency: 1              # 多模态并发数
  temperature: 0.7            # 采样温度（0-2，默认 0.7）
  topP: 1                     # nucleus 采样 top_p（0-1，默认 1）
  maxTokens: 8192             # 单次输出最大 token 数

多模态模型从「设置-模型」中选择（唯一配置来源）：设置页「DshOmniFile」下拉会全面列出当前 DSH 已注册的所有提供商/模型（含 DSH 自带的官方 DeepSeek deepseek-v4-* 与你在「设置-模型」配置的 pi-ai 等自定义提供商），每项标注图片能力（🖼 支持图片输入 / 📝 纯文本）。保存一条 providerRef 引用，不在此保存多份模型配置；选择纯文本模型用于识图会失败，请优先选择 🖼 标注的模型。