这是什么
跟 sheets-local 对称, 但针对非结构化文档:
- PDF — 合同 / 产品说明书 / 行业报告
- Word (.docx) — SOP / 培训手册 / 退货政策
- Markdown / TXT — 客服模板 / FAQ / 笔记
- 也支持 Excel/CSV (跟 sheets-local 重复, 推荐用 sheets-local 更精细)
上传后 AI 在对话中自动调工具读, 引用具体原文段落.
系统会依次完成“列文件 → 读取相关片段 → 引用来源”。实际耗时取决于文档大小、解析状态和当时服务负载。
5 步上手
1. 进上传页
侧栏 "我的数据" → 找 📚 本地文档 (PDF/Word) → 点进, 或直接打开 /dashboard/integrations/connect/files-local.
2. 上传文档
点 "选择文件" → 选 .pdf / .docx / .md / .txt (≤5MB).
Server 端自动用 pdf-parse / mammoth 等工具抽出纯文本入库.
3. 激活 MCP 连接
第一次上传后点 "一键激活 MCP 连接".
4. 回工作台提问
例如:
- "我刚传的合同有什么风险条款?"
- "把我们的退货 SOP 改成英文给海外客户看"
- "在所有 SOP 里搜 '尺码不对怎么办'"
- "把这份产品说明书的核心卖点提炼 5 条"
5. AI 调 4 个工具
list_files看你都传了什么search_files({query})跨所有文档搜关键词read_file({fileId})读全文 (默认前 8000 字符)read_section({fileId, charFrom, charTo})读指定片段
页面会显示每次工具调用状态；失败、缺失和成功读取会明确区分。
演示场景（虚构数据）
以下人物、效率、收入和 ROI 均为虚构，只用于说明可跟踪哪些指标，不代表真实客户或效果承诺。
合同包演示
上传一份虚构英文合同，演示定位风险条款、引用原文和标记“需律师核实”。
SOP 演示
上传一组虚构 SOP，演示跨文档搜索、来源定位和版本差异核对。
客服模板演示
上传虚构的多语言模板，演示按场景查找模板并生成待人工复核的回复草稿。
更多演示场景见 /case-studies。
AI 能调的 4 个工具
| 工具 | 描述 | 用法举例 |
|---|---|---|
list_files() | 列我所有上传的文档 | "我都传了什么 PDF" |
read_file({fileId, maxChars?}) | 读全文 (默认 8000 chars, 上限 50,000) | "把这份合同读出来" |
search_files({query, maxResults?}) | 跨所有文档全文搜 keyword | "在 SOP 里搜 '尺码偏差'" |
read_section({fileId, charFrom, charTo}) | 按字符位置读片段 (省 token) | "继续读第 8000-16000 字符" |
限制
- 单文件 ≤ 5 MB
- 抽出文本超 50K 字符自动截断 (约 100 页 PDF)
- 每用户最多 20 个文档, 30 天自动清理
- 不支持扫描 PDF (无 OCR) — 必须是有文字层的 PDF
- 不支持图片 / 表格图 / 复杂排版
FAQ
Q: PDF 抽不出来文字怎么办? A: 大概率是扫描版 (图片型 PDF). 用工具如 ABBYY FineReader / Adobe Acrobat 先 OCR, 再上传.
Q: Word 文档里的图片 / 表格能读吗? A: 文字部分能读, 图片会被忽略, 表格转 markdown 格式保留结构.
Q: 30 天到期了我反复用的文档怎么办? A: 上传时点击右上角"延长 90 天" (TBD, 当前需要重传). 或者升级 elite 套餐, 可以申请延长到 1 年.
Q: 跟首页加号有什么区别? A:
- 首页加号 = 一次性附件, 不入库, 问完即丢
- files-local = 持久化, 入库 30 天, AI 反复读
Q: 用了多少 token? A: 典型 "搜文档 + 读片段" 一次 1500-3000 token. 完整读 30 页 PDF (~8K 字符) 约 4000 token.
隐私 / 安全
- 抽出的文本加密存 Postgres (AES-256-GCM)
- 仅你账号能读, 30 天过期自动删
- 仅在完成当前请求所需的范围内交给模型处理
- 不出售，也不用于训练、微调或改进任何模型
- 合同涉及客户隐私可先脱敏再上传 (例: 把公司名替换成 X 公司)
跟其他文档工具的区别
| files-local | 首页加号 (一次性) | Google Drive MCP | |
|---|---|---|---|
| 持久化 | 30 天 | 不入库 | 实时同步 |
| 适合 | 反复读的文档 | 一次性问 | 已有 Drive 体系 |
| 需要凭证 | ❌ | ❌ | OAuth 麻烦 |
| 文件大小 | ≤5MB | ≤5MB | Drive 上限 |
| 国内可用 | ✅ | ✅ | ❌ 翻墙 |
推荐: 反复用的文档(SOP/合同/产品手册)用 files-local; 临时问一次用首页加号.
下一步
- 上传你最重要的一份文档:
/dashboard/integrations/connect/files-local - 看演示场景（虚构数据）: /case-studies
- 看相关技能: 合规审查 (compliance) / 客服话术 (cs)