spanseek 1.0.2 格式支持表
本表登记当前版本支持的格式与边界,不把“能够导入”写成“无损理解”。每个“部分支持”都附已知损失;未实测的组合不冒充通过。
等级定义:
- 完整:导入、阅读、摘录、备份/恢复全链有证据,且没有已知内容损失。
- 部分:主链可用,但有明确列出的损失或不支持项。
- 仅引用:只保留指向原件的引用/计数,不进入正文能力。
- 未验:实现可能存在,但当前版本没有可复现证据。
说明:资料随完整备份与恢复,不提供单篇 Markdown 导出;笔记提供 Markdown / HTML / DOCX / PDF 与完整包导出。
1. 资料格式
| 形态 | 导入 | 阅读 | 摘录 | 随完整包恢复 | 等级与边界 |
|---|---|---|---|---|---|
| TXT | 是 | 原文/文本阅读 | 是(块锚) | 是 | 完整(按 UTF-8 文本) |
| Markdown | 是(原件不可变) | 渲染 + 可摘录原文 | 是(块锚) | 是 | 部分:来源内语法按文本保留,渲染失败回原文 |
| HTML | 是(正文提取) | 是 | 是 | 是 | 部分:脚本/样式/交互不执行,原件保留 |
| 是 | PDFium 连续阅读、目录、缩放、适宽/适页 | 字符/区域 | 是 | 部分:复杂多栏、跨页表格仍有损失 | |
| DOCX | 是 | Word 精确版式(Word 可用)或内置语义渲染 | 是(原文视图) | 是 | 部分:复杂分页、字体替换与嵌入对象可能不同 |
| DOC(Word 97–2003) | 是(边界检查 + 纯 Rust 解析) | Word 精确版式缓存,或内置原文阅读 | 是(原文视图) | 是 | 部分:修订删除项过滤;无 Word 时不承诺精确分页 |
| XLSX | 是 | 工作表、公式缓存/来源、日期/时间/百分比、合并范围 | 是 | 是 | 部分:图表/透视表等对象不进入正文 |
| XLS(BIFF8) | 是 | 多工作表、单元格、日期、公式来源、合并文本 | 是 | 是 | 部分:宏、图表对象与复杂格式不执行;引用修复已 vendor |
| CSV | 是 | 表格文本阅读 | 是 | 是 | 部分:编码与分隔符按导入检查,不推断业务类型 |
| PPTX | 是 | 演示顺序、表格、图片、图表缓存、SmartArt、备注 | 是 | 是 | 部分:动画、切换、嵌入媒体和精确版式不进入阅读投影 |
| EPUB | 是 | 封面、内置目录、章节、正文图片 | 是 | 是 | 部分:固定版式 EPUB、脚本和 DRM 不支持 |
| MOBI | 是(DRM 明确拒绝) | 封面、目录、章节、正文图片 | 是 | 是 | 部分:AZW3/DRM/复杂排版不承诺 |
| 扫描 PDF + OCR | 是 | 显示 OCR 状态并阅读 | 是(词框映射) | 是 | 部分:中文质量、低质扫描与手写需实机验收 |
| PDF 表格 | 是(字符几何) | 表格预览 + Markdown 复制 | 是(bbox 回原文) | 是 | 部分:合并单元格、跨页表格不保证 |
2. 笔记、块与互操作
| 形态 | 导入 | 阅读 | 操作 | 导出 | 恢复 | 等级与边界 |
|---|---|---|---|---|---|---|
| 原生笔记 D1/D2/D3 | 是 | 是 | 属性、版本历史、冲突处理 | Markdown / HTML / DOCX / PDF / 完整包 | 是 | 完整(按 schema 契约) |
| 稳定块数据库 | 是 | 是 | 引用、属性、排序、复制、嵌入、块历史 | 随笔记 | 是 | 当前修改投影与不可变修订同源;块身份不复用 |
| Obsidian/Markdown vault | 是(CLI) | 是 | 双链/嵌入 | 是(CLI) | 是 | 部分:插件语法与非图片附件不转正文 |
| 双链与嵌入 | 是 | 是 | 标题/块锚、固定版本、循环与深度保护 | 是 | 是 | 完整(受 3 层嵌入与预算限制) |
| YAML frontmatter | 是 | 是 | 保留未知键 | 是 | 是 | 完整(单块约束) |
| 图片附件 | 是(PNG/JPEG/WebP) | 是 | 插入/说明 | 打包 | 是 | 部分:单张 ≤20 MiB;不抓远程图片 |
| BibTeX / CSL-JSON | 是 | 是 | 引用选择器 | 随报告 | 是 | 部分:只消费已实现字段,未知字段保留 |
| CSL 引文 | 是 | 是 | 样式选择、自定义/依赖样式、locator、note 序号、in-text、文献表、多条目选择器、样式恢复、手写修改警告 | HTML / DOCX / PDF | 是 | 部分:更广 locale/field 与在线样式库仍未逐一实机回归;同 marker 多次出现按 occurrence 渲染;手写保护为区块级指纹而非逐条合并 |
3. 检索与索引
| 能力 | 状态 | 说明 |
|---|---|---|
| 中文分词与繁简折叠 | 支持 | FTS 与查询使用同一规范化 |
| 关键词 + 语义融合 | 支持 | 无语义配置时明确回退关键词,不伪造命中 |
| 块检索 | 支持 | 稳定块 ID、别名、keyset 分页、引用计数 |
| 10k/50k 图谱布局 | 支持 | 视口裁剪、路径高亮、facet/AND 标签与性能探针 |
| 搜索历史 | 支持 | 按物理 workspace 隔离,不保存结果正文 |
4. 明确边界
- 不可执行宏、脚本、远程图片、外部嵌入或 DRM 内容。
- Office/EPUB 阅读是只读投影,不承诺与 Office/阅读器逐像素一致;可摘录原文始终独立保留。
- OCR 仍需真实设备上的中文质量、第三方读屏与安装包验收,不能由单元测试代替。
- 同步与协作需要配置服务和设备权限;不同物理设备、网络与辅助技术的覆盖边界见已知问题。