dsh-files 使用指南
文件上传（彩色附件卡片、会话隔离存储、sha256 去重、TTL 清扫）+ 内容嗅探的 read_document 文档读取（PDF/DOCX/XLSX/TXT）。
本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。
本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。
快速上手
文件上传（彩色附件卡片、会话隔离存储、sha256 去重、TTL 清扫）+ 内容嗅探的 read_document 文档读取（PDF/DOCX/XLSX/TXT）。
— 源: plugins.ai_summary
安装与验证
dsh plugin --profile web add github:taxueseek/dsh-files
复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。
— 源: plugins.install
关键要点
- 上传：回形针按钮 + 浮动彩色卡片，发送时自动附入文件路径；按会话隔离存储，TTL 清扫，sha256 去重
- 文档读取：
read_document工具读取文本 / PDF / DOCX / XLSX，内容嗅探不信任扩展名，LRU 缓存 - 会话隔离：文件存到
<会话工作区>/.dsh-filess/<sessionId>/，agent 一定能读到，会话间不可见 - 两种入口：回形针按钮选择，或拖拽到页面任意位置上传（悬停有遮罩提示）
- 卡片 UI：按字节嗅探的真实格式着色角标（伪装文件不按扩展名显示）、文件名、大小、移除按钮
— 源: plugin_wiki.readme_zh (fallback readme_raw)
踩坑提醒
安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。
— 来源：通用规则