Compare commits

..

No commits in common. "main" and "v1.0.4" have entirely different histories.
main ... v1.0.4

19 changed files with 107 additions and 1348 deletions

1
.gitignore vendored
View File

@ -5,4 +5,3 @@ env.json
env.yml env.yml
env.yaml env.yaml
.log.meta.json .log.meta.json
/test_res/

View File

@ -1,44 +1,5 @@
# CHANGELOG # CHANGELOG
## v1.1.0 (2026-05-17)
- **PDF 语义重构**: 引入全局语义分析引擎。
- **无缝流**: 彻底移除分页干扰(移除 `---``Page X` 标记),实现跨页内容自然合并。
- **智能标题层级**: 自动锁定文档总标题,智能识别并合并跨行长标题,避免封面期标题碎片化。
- **自动平衡**: 根据文档内容自动提升章节标题层级,确保 Markdown 目录结构平衡。
- **鲁棒表格识别**: 调优列间距算法并增加长句过滤,大幅降低 PDF 误判表格的概率。
- **转换能力全面对齐**:
- **PPTX**: 每一页幻灯片标题现在统一识别为 `#` 一级标题,优化页面视觉分层。
- **DOCX**: 重构 XML 解析,完美支持 Word 原生表格 (`w:tbl`) 转换为 Markdown 表格。
- **XLSX**: 提升 Sheet 名称为 `#` 标题。
- **工程化增强**: 新增 `test_res/testmd.sh` 自动化验证脚本,覆盖 4 种主流办公格式的 Markdown 转换质量。
- **接口一致性**: 强制所有格式 Markdown 输出从一级标题 (`#`) 开始。
## v1.0.9 (2026-05-17)
- **新特性**: 内置功能完整的命令行工具 `doc` (`cmd/doc`)。
- **功能增强**: `doc` 支持创建、打开、查看预览Markdown、转换为 JSON、查看元数据Inspect以及数据注入Excel
- **文档优化**: README 增加 `doc` 命令行工具的安装与使用指南。
## v1.0.8 (2026-05-15)
- **基础设施对齐**: 同步更新 `go/cast``go/file` 至最新版本。
- **功能修复**: 修复 Excel 单元格解析在某些边界情况下的偏差。
## v1.0.7 (2026-05-14)
- **依赖同步**: 对齐基础设施版本。
## v1.0.6 (2026-05-13)
- **新特性**: 支持 `.csv` 格式,支持对象数组与 Markdown 表格转换。
- **新特性**: 支持 `.md``.txt` 格式,统一纳入 `Document` 接口管理。
- **功能增强**: `Excel.ToMarkdown` 现在支持提取所有工作表 (Sheet),并自动添加标题。
- **功能增强**: `PDF.ToMarkdown` 增加页码标记 (`<!-- Page X -->`),方便 RAG 场景按页分片。
- **功能增强**: Markdown 表格转换增加对管道符 (`|`) 的转义处理。
## v1.0.5 (2026-05-13)
- **新特性**: 引入 `Graph` 关系型文档类型 (`.graph`),支持节点内容与关系的统一建模。
- **新特性**: 关系型文档支持一键转换为带 **Mermaid** 图表的 Markdown适用于脑图与分镜。
- **功能增强**: 改进 `Docx` 提取算法,支持自动识别标题层级并转换为标准的层级 Markdown (H1-H6)。
- **架构对齐**: `OpenGraph` 支持文件不存在时自动创建,与 `OpenExcel` 行为一致。
- **文档更新**: README 增加 RAG 增强与关系文档示例。
## v1.0.4 (2026-05-12) ## v1.0.4 (2026-05-12)
- **依赖同步**:同步更新 `go/cast``go/file` 至最新版本。 - **依赖同步**:同步更新 `go/cast``go/file` 至最新版本。
- **文档优化**:完善 README 与测试用例。 - **文档优化**:完善 README 与测试用例。

View File

@ -4,11 +4,10 @@
## 核心设计 ## 核心设计
`document` 包将所有复杂的文档格式Excel, Word, PPT, PDF, Graph)抽象为统一的 `Document` 接口。你只需要关心 **数据载体** (JSON/Markdown),而不需要关心底层实现。 `document` 包将所有复杂的文档格式Excel, Word, PPT, PDF抽象为统一的 `Document` 接口。你只需要关心 **数据载体** (JSON/Markdown),而不需要关心底层实现。
- **结构化数据 (Excel)** <-> **JSON** - **结构化数据 (Excel)** <-> **JSON**
- **半结构化内容 (Word/PPT/PDF)** -> **结构化 Markdown** (支持标题识别) - **半结构化内容 (Word/PPT/PDF)** -> **Markdown**
- **关系型内容 (Graph/Mindmap)** <-> **JSON/Mermaid**
## 统一 API ## 统一 API
@ -19,10 +18,10 @@ import "apigo.cc/go/document"
doc, _ := document.Open("data.xlsx") doc, _ := document.Open("data.xlsx")
// 2. 转换为通用载体 // 2. 转换为通用载体
jsonStr := doc.ToJSON() // 适合 Excel / Graph jsonStr := doc.ToJSON() // 适合 Excel
mdStr := doc.ToMarkdown() // 适合 Word / PDF / Graph (Mermaid) mdStr := doc.ToMarkdown() // 适合 Word/PPT/PDF
// 3. 修改并保存 (Excel/Graph 支持数据回写) // 3. 修改并保存 (Excel 支持数据回写)
if xls, ok := doc.(*document.Excel); ok { if xls, ok := doc.(*document.Excel); ok {
xls.SetData("Sheet1", newData, "A1", "") xls.SetData("Sheet1", newData, "A1", "")
} }
@ -33,32 +32,21 @@ doc.Save("updated.xlsx")
| 格式 | 后缀 | `ToJSON` 表现 | `ToMarkdown` 表现 | `Save` 行为 | | 格式 | 后缀 | `ToJSON` 表现 | `ToMarkdown` 表现 | `Save` 行为 |
| :--- | :--- | :--- | :--- | :--- | | :--- | :--- | :--- | :--- | :--- |
| **Excel** | `.xlsx` | 返回第一个 Sheet 的对象数组 | 返回**所有 Sheet** 的 MD 表格 | 保存为 Excel | | **Excel** | `.xlsx` | 返回第一个 Sheet 的对象数组 | 返回第一个 Sheet 的 MD 表格 | 保存为 Excel 文件 |
| **Word** | `.docx` | 返回 `{"metadata":..., "content":...}` | 返回**带层级标题**的 Markdown | 保存为文本 | | **Word** | `.docx` | 返回 `{"metadata":..., "content":...}` | 返回提取的全文文本 | 保存为纯文本文件 |
| **PPT** | `.pptx` | 返回 `{"metadata":..., "content":...}` | 返回提取的全文文本 | 保存为文本 | | **PPT** | `.pptx` | 返回 `{"metadata":..., "content":...}` | 返回提取的全文文本 | 保存为纯文本文件 |
| **PDF** | `.pdf` | 返回 `{"metadata":..., "content":...}` | 返回**带页码标记**的 Markdown | 保存为文本 | | **PDF** | `.pdf` | 返回 `{"metadata":..., "content":...}` | 返回提取的全文文本 | 保存为纯文本文件 |
| **Graph** | `.graph` | 返回节点与关系的结构化 JSON | 返回 **Mermaid 关系图** + 节点详情 | 保存为 JSON |
| **CSV** | `.csv` | 返回对象数组 | 返回 MD 表格 | 保存为 CSV |
| **Markdown**| `.md` | 返回 `{"content":...}` | 返回原始文本 | 保存为 Markdown |
| **Text** | `.txt` | 返回 `{"content":...}` | 返回原始文本 | 保存为文本 |
## 快速示例 ## 快速示例
### AI 友好型转换 (RAG 增强) ### AI 友好型转换
```go ```go
// 一行代码将 Word 转为带层级标题的 Markdown方便 AI 分片 (Chunking) // 一行代码将 PDF 转为 AI 易读的 Markdown
md, _ := document.Open("manual.docx").ToMarkdown() md, _ := document.Open("report.pdf").ToMarkdown()
```
### 关系型文档 (脑图/小说大纲/分镜脚本) // 一行代码将 Excel 转为结构化 JSON
json, _ := document.Open("sales.xlsx").ToJSON()
```go
g := document.NewGraph()
g.Title = "故事大纲"
g.AddNode(&document.Node{ID: "1", Title: "开端", Content: "主角获得系统", Type: "plot"})
g.AddNode(&document.Node{ID: "2", Title: "冲突", Content: "反派出现", Links: []string{"1"}})
mdStr := g.ToMarkdown() // 包含 Mermaid graph TD 的渲染内容
``` ```
## API 参考 ## API 参考
@ -71,38 +59,3 @@ mdStr := g.ToMarkdown() // 包含 Mermaid graph TD 的渲染内容
- `ToJSON() string` - `ToJSON() string`
- `ToMarkdown() string` - `ToMarkdown() string`
- `Save(filename ...string) error` - `Save(filename ...string) error`
## 命令行工具 (doc)
`document` 包内置了一个强大的命令行工具 `doc`,位于 `cmd/doc` 目录下。
### 安装
使用 `go install` 安装,生成的二进制文件名即为 `doc`
```bash
go install apigo.cc/go/document/cmd/doc@latest
```
### 常用命令
```bash
# 1. 预览 Excel/Word/PDF 内容 (默认输出 Markdown)
doc report.xlsx
# 2. 将文档转为结构化 JSON (适合 RAG 或自动化脚本)
doc manual.docx --json
# 3. 提取 PDF 内容并保存为 Markdown 文件
doc paper.pdf -o paper.md
# 4. 向已有的 Excel 注入数据 (支持追加或覆盖)
doc --data '[{"id":1,"name":"Alice"}]' -o test.xlsx test.xlsx
# 5. 查看文档元数据 (如工作表名、PDF 页数等)
doc paper.pdf --inspect
```
### 帮助信息
运行 `doc --help` 查看完整参数说明。
### Graph 专用 (关系型文档)
- `AddNode(n *Node)`
- `OpenGraph(filename string) (*Graph, error)`

19
TEST.md Normal file
View File

@ -0,0 +1,19 @@
# document TEST
## 覆盖场景
- [x] **Excel 基础读写**: 验证 `NewExcel`, `Set`, `Get`, `Save`, `OpenExcel`
- [x] **Excel 对象映射**: 验证 `SetData`, `GetData` 及动态列扩展。
- [x] **统一 API**: 验证 `document.Open` 自动识别、`ToJSON``ToMarkdown`
- [x] **ID 生成解析**: 验证 `MakeCellID``ParseCellID` 的准确性。
## 性能测试 (Benchmark)
- **环境**: Darwin / Intel(R) Core(TM) i7-1068NG7 CPU @ 2.30GHz
- **Excel.SetData**: 写入 100 行对象数据。
```text
BenchmarkExcel_SetData-8 712 1673885 ns/op
```
## 基础设施对齐
- 全面使用 `apigo.cc/go/cast` 替代原生类型转换。
- 移除了所有原生 `os``strconv` 依赖。

View File

@ -1,159 +0,0 @@
package main
import (
"flag"
"fmt"
"os"
"strings"
"apigo.cc/go/cast"
"apigo.cc/go/document"
)
var (
jsonOut = flag.Bool("json", false, "以 JSON 格式输出文档内容")
mdOut = flag.Bool("md", false, "以 Markdown 格式输出文档内容 (默认模式)")
savePath = flag.String("o", "", "保存结果到指定文件路径 (如: output.xlsx, content.md)")
createType = flag.String("create", "", "创建新文档,支持类型: xlsx, csv, graph, md")
password = flag.String("password", "", "访问加密文档所需的密码 (主要针对 Excel)")
sheetName = flag.String("sheet", "", "操作 Excel 时指定的工作表名称或索引 (0, 1...)")
dataStr = flag.String("data", "", "注入数据的 JSON 字符串 (支持对象数组或单个对象)")
inspect = flag.Bool("inspect", false, "只查看文档元数据 (如类型、页数、工作表列表等)")
version = flag.Bool("v", false, "显示版本信息")
)
const docVersion = "1.0.0"
func main() {
flag.Usage = func() {
fmt.Fprintf(os.Stderr, "🗂️ Document CLI (doc) - 极简办公文档处理工具 v%s\n\n", docVersion)
fmt.Fprintf(os.Stderr, "用法:\n")
fmt.Fprintf(os.Stderr, " doc [flags] [file] # 处理已有文件\n")
fmt.Fprintf(os.Stderr, " doc --create [type] [flags] # 创建新文档\n\n")
fmt.Fprintf(os.Stderr, "常见示例:\n")
fmt.Fprintf(os.Stderr, " doc report.xlsx # 预览 Excel 内容 (Markdown 表格)\n")
fmt.Fprintf(os.Stderr, " doc manual.docx --json # 提取 Word 内容为结构化 JSON\n")
fmt.Fprintf(os.Stderr, " doc paper.pdf -o text.md # 提取 PDF 文字并存为 Markdown\n")
fmt.Fprintf(os.Stderr, " doc --create xlsx -o n.xlsx # 创建空白 Excel\n")
fmt.Fprintf(os.Stderr, " doc test.xlsx --data '[{\"ID\":1}]' -o test.xlsx # 向 Excel 追加数据\n\n")
fmt.Fprintf(os.Stderr, "参数详解:\n")
flag.PrintDefaults()
fmt.Fprintf(os.Stderr, "\n支持的格式:\n")
fmt.Fprintf(os.Stderr, " Excel (.xlsx), Word (.docx), PDF (.pdf), PPT (.pptx), CSV (.csv), Graph (.graph), Markdown (.md)\n")
}
flag.Parse()
if *version {
fmt.Printf("doc version %s\n", docVersion)
return
}
args := flag.Args()
var doc document.Document
var err error
// 1. 获取文档实例
if *createType != "" {
doc, err = document.Create(*createType)
if err != nil {
fail("创建文档失败: %v", err)
}
} else if len(args) > 0 {
filename := args[0]
if *password != "" {
doc, err = document.Open(filename, *password)
} else {
doc, err = document.Open(filename)
}
if err != nil {
fail("无法打开文件 '%s': %v", filename, err)
}
} else {
flag.Usage()
return
}
// 2. 数据注入逻辑
if *dataStr != "" {
applyData(doc, *dataStr, *sheetName)
}
// 3. 执行核心操作
if *inspect {
runInspect(doc)
return
}
if *savePath != "" {
if err := doc.Save(*savePath); err != nil {
fail("保存失败: %v", err)
}
fmt.Printf("✨ 成功保存至: %s\n", *savePath)
} else {
outputContent(doc, *jsonOut)
}
}
func applyData(doc document.Document, dataStr, sheet string) {
var data []map[string]any
if err := cast.UnmarshalJSON(dataStr, &data); err != nil {
var single map[string]any
if err2 := cast.UnmarshalJSON(dataStr, &single); err2 == nil {
data = []map[string]any{single}
} else {
fail("数据格式无效,请提供有效的 JSON 对象或数组: %v", err)
}
}
switch d := doc.(type) {
case *document.Excel:
if err := d.SetData(sheet, data, "A1", ""); err != nil {
fail("写入 Excel 失败: %v", err)
}
case *document.Graph:
fmt.Println("⚠️ 提示: Graph 类型目前主要通过 API 操作,暂不支持通过 CLI 批量 SetData。")
default:
fmt.Printf("⚠️ 警告: 当前文档类型 (%T) 不支持数据注入操作。\n", d)
}
}
func runInspect(doc document.Document) {
fmt.Printf("🔍 文档详情:\n")
fmt.Printf(" 类型: %T\n", doc)
switch d := doc.(type) {
case *document.Excel:
fmt.Printf(" 工作表: %s\n", strings.Join(d.Sheets(), ", "))
case *document.PDF:
if pages, ok := d.Metadata["pages"]; ok {
fmt.Printf(" 总页数: %v\n", pages)
}
for k, v := range d.Metadata {
if k != "pages" {
fmt.Printf(" %s: %v\n", k, v)
}
}
}
}
func outputContent(doc document.Document, asJSON bool) {
if asJSON {
fmt.Println(doc.ToJSON())
} else {
content := doc.ToMarkdown()
if content == "" {
fmt.Println("(文档内容为空)")
} else {
fmt.Println(content)
}
}
}
func fail(format string, a ...any) {
fmt.Fprintf(os.Stderr, "❌ 错误: "+format+"\n", a...)
os.Exit(1)
}

101
csv.go
View File

@ -1,101 +0,0 @@
package document
import (
"encoding/csv"
"strings"
"apigo.cc/go/cast"
"apigo.cc/go/file"
)
// CSV 封装了 CSV 文件的读写。
type CSV struct {
filename string
Data [][]string
}
// OpenCSV 打开一个 CSV 文件。
func OpenCSV(filename string) (*CSV, error) {
if !file.Exists(filename) {
return &CSV{filename: filename}, nil
}
content, err := file.Read(filename)
if err != nil {
return nil, err
}
r := csv.NewReader(strings.NewReader(content))
data, err := r.ReadAll()
if err != nil {
return nil, err
}
return &CSV{
filename: filename,
Data: data,
}, nil
}
// ToJSON 返回 JSON 数组。
func (c *CSV) ToJSON() string {
if len(c.Data) == 0 {
return "[]"
}
header := c.Data[0]
var res []map[string]string
for i := 1; i < len(c.Data); i++ {
row := make(map[string]string)
for j, h := range header {
if j < len(c.Data[i]) {
row[h] = c.Data[i][j]
}
}
res = append(res, row)
}
jsonStr, _ := cast.ToJSON(res)
return jsonStr
}
// ToMarkdown 返回 Markdown 表格。
func (c *CSV) ToMarkdown() string {
if len(c.Data) == 0 {
return ""
}
var sb strings.Builder
for i, row := range c.Data {
sb.WriteString("| ")
for _, col := range row {
val := strings.ReplaceAll(col, "|", "\\|")
sb.WriteString(val)
sb.WriteString(" | ")
}
sb.WriteString("\n")
if i == 0 {
sb.WriteString("|")
for range row {
sb.WriteString(" --- |")
}
sb.WriteString("\n")
}
}
return sb.String()
}
// Save 保存为 CSV 文件。
func (c *CSV) Save(filename ...string) error {
path := c.filename
if len(filename) > 0 && filename[0] != "" {
path = filename[0]
}
var sb strings.Builder
w := csv.NewWriter(&sb)
w.WriteAll(c.Data)
w.Flush()
return file.Write(path, sb.String())
}

View File

@ -28,12 +28,6 @@ func Open(filename string, password ...string) (Document, error) {
return OpenPptx(filename) return OpenPptx(filename)
case ".pdf": case ".pdf":
return OpenPDF(filename) return OpenPDF(filename)
case ".graph":
return OpenGraph(filename)
case ".csv":
return OpenCSV(filename)
case ".md", ".markdown", ".txt":
return OpenMarkdown(filename)
default: default:
return nil, fmt.Errorf("unsupported file type: %s", ext) return nil, fmt.Errorf("unsupported file type: %s", ext)
} }
@ -48,12 +42,6 @@ func Create(ext string) (Document, error) {
case "docx": case "docx":
// TODO: 支持创建 Word // TODO: 支持创建 Word
return nil, fmt.Errorf("creating docx not supported yet") return nil, fmt.Errorf("creating docx not supported yet")
case "graph":
return NewGraph(), nil
case "csv":
return &CSV{}, nil
case "md", "markdown":
return &Markdown{}, nil
default: default:
return nil, fmt.Errorf("unsupported creation type: %s", ext) return nil, fmt.Errorf("unsupported creation type: %s", ext)
} }

144
docx.go
View File

@ -1,11 +1,8 @@
package document package document
import ( import (
"archive/zip"
"encoding/xml"
"fmt" "fmt"
"io" "io"
"strings"
"apigo.cc/go/cast" "apigo.cc/go/cast"
"apigo.cc/go/file" "apigo.cc/go/file"
@ -29,154 +26,15 @@ func OpenDocx(filename string) (*Docx, error) {
Metadata: make(map[string]any), Metadata: make(map[string]any),
} }
// 尝试提取层级结构的 Markdown
md, err := d.extractMarkdown(filename)
if err == nil && md != "" {
d.Content = md
} else {
// 回退到纯文本提取
dp, err := docxtotext.Open(filename) dp, err := docxtotext.Open(filename)
if err == nil { if err == nil {
defer dp.Close() defer dp.Close()
d.Content, _ = dp.ExtractTexts() d.Content, _ = dp.ExtractTexts()
} }
}
return d, nil return d, nil
} }
// extractMarkdown 尝试从 docx 的 XML 中提取带标题和表格的 Markdown。
func (d *Docx) extractMarkdown(filename string) (string, error) {
r, err := zip.OpenReader(filename)
if err != nil {
return "", err
}
defer r.Close()
var docXML io.ReadCloser
for _, f := range r.File {
if f.Name == "word/document.xml" {
docXML, err = f.Open()
break
}
}
if docXML == nil {
return "", fmt.Errorf("word/document.xml not found")
}
defer docXML.Close()
decoder := xml.NewDecoder(docXML)
var sb strings.Builder
var inT bool
var currentStyle string
var inTable bool
var tableRows [][]string
var currentRow []string
var cellText strings.Builder
for {
t, err := decoder.Token()
if err == io.EOF {
break
}
if err != nil {
return "", err
}
switch se := t.(type) {
case xml.StartElement:
switch se.Name.Local {
case "p":
currentStyle = ""
cellText.Reset()
case "pStyle":
for _, attr := range se.Attr {
if attr.Name.Local == "val" {
currentStyle = attr.Value
}
}
case "t":
inT = true
case "tbl":
inTable = true
tableRows = nil
case "tr":
currentRow = nil
case "tc":
cellText.Reset()
}
case xml.EndElement:
switch se.Name.Local {
case "p":
if inTable {
// Paragraph inside table cell is handled by cellEnd
} else {
sb.WriteString("\n")
}
case "t":
inT = false
case "tc":
currentRow = append(currentRow, strings.TrimSpace(cellText.String()))
cellText.Reset()
case "tr":
tableRows = append(tableRows, currentRow)
case "tbl":
inTable = false
sb.WriteString(renderMarkdownTable(tableRows))
sb.WriteString("\n")
}
case xml.CharData:
text := string(se)
if inTable {
cellText.WriteString(text)
} else if inT {
if strings.Contains(strings.ToLower(currentStyle), "heading") ||
strings.Contains(strings.ToLower(currentStyle), "title") ||
strings.Contains(strings.ToLower(currentStyle), "subject") {
level := "1"
if strings.Contains(strings.ToLower(currentStyle), "heading") && len(currentStyle) > 7 {
level = currentStyle[7:]
}
l := cast.To[int](level)
if l == 0 {
l = 1
}
prefix := strings.Repeat("#", l)
sb.WriteString("\n" + prefix + " " + text + "\n")
} else {
sb.WriteString(text)
}
}
}
}
return strings.TrimSpace(sb.String()), nil
}
func renderMarkdownTable(rows [][]string) string {
if len(rows) == 0 {
return ""
}
var sb strings.Builder
sb.WriteString("\n")
for i, row := range rows {
sb.WriteString("| ")
for _, col := range row {
sb.WriteString(strings.ReplaceAll(col, "|", "\\|"))
sb.WriteString(" | ")
}
sb.WriteString("\n")
if i == 0 {
sb.WriteString("|")
for range row {
sb.WriteString(" --- |")
}
sb.WriteString("\n")
}
}
return sb.String()
}
// ToJSON 返回包含元数据和内容的 JSON 字符串。 // ToJSON 返回包含元数据和内容的 JSON 字符串。
func (d *Docx) ToJSON() string { func (d *Docx) ToJSON() string {
res, _ := cast.ToJSON(map[string]any{ res, _ := cast.ToJSON(map[string]any{
@ -197,6 +55,8 @@ func (d *Docx) Save(filename ...string) error {
if len(filename) > 0 && filename[0] != "" { if len(filename) > 0 && filename[0] != "" {
path = filename[0] path = filename[0]
} }
// 如果是原格式保存,目前仅作为文本保存或保持原样
// 复杂的 Docx 写入暂未集成
return file.Write(path, d.Content) return file.Write(path, d.Content)
} }

View File

@ -72,31 +72,22 @@ func (xls *Excel) ToJSON() string {
return res return res
} }
// ToMarkdown 将所有工作表的数据转换为 Markdown 格式 // ToMarkdown 将第一个工作表的数据转换为 Markdown 表格
func (xls *Excel) ToMarkdown() string { func (xls *Excel) ToMarkdown() string {
sheets := xls.Sheets() sheets := xls.Sheets()
if len(sheets) == 0 { if len(sheets) == 0 {
return "" return ""
} }
rows, _ := xls.Get(sheets[0], "A1", "")
if len(rows) == 0 {
return ""
}
var sb strings.Builder var sb strings.Builder
for _, sheetName := range sheets {
rows, _ := xls.Get(sheetName, "A1", "")
if len(rows) == 0 {
continue
}
if len(sheets) > 1 {
sb.WriteString("# Sheet: " + sheetName + "\n\n")
}
for i, row := range rows { for i, row := range rows {
sb.WriteString("| ") sb.WriteString("| ")
for _, col := range row { for _, col := range row {
val := cast.To[string](col) sb.WriteString(cast.To[string](col))
// 转义 Markdown 表格中的管道符
val = strings.ReplaceAll(val, "|", "\\|")
sb.WriteString(val)
sb.WriteString(" | ") sb.WriteString(" | ")
} }
sb.WriteString("\n") sb.WriteString("\n")
@ -109,9 +100,7 @@ func (xls *Excel) ToMarkdown() string {
sb.WriteString("\n") sb.WriteString("\n")
} }
} }
sb.WriteString("\n") return sb.String()
}
return strings.TrimSpace(sb.String())
} }
// --- 基础操作方法 --- // --- 基础操作方法 ---

View File

@ -4,7 +4,6 @@ import (
"strings" "strings"
"testing" "testing"
"apigo.cc/go/cast"
"apigo.cc/go/file" "apigo.cc/go/file"
) )
@ -44,7 +43,7 @@ func TestExcel_Basic(t *testing.T) {
t.Errorf("Unexpected data length: %v", data) t.Errorf("Unexpected data length: %v", data)
} }
if cast.To[string](data[1][0]) != "Alice" { if castTo[string](data[1][0]) != "Alice" {
t.Errorf("Expected Alice, got %v", data[1][0]) t.Errorf("Expected Alice, got %v", data[1][0])
} }
} }
@ -84,7 +83,7 @@ func TestExcel_Data(t *testing.T) {
t.Errorf("Expected 2 rows, got %d", len(readData)) t.Errorf("Expected 2 rows, got %d", len(readData))
} }
if cast.To[string](readData[0]["Value"]) != "A" { if castTo[string](readData[0]["Value"]) != "A" {
t.Errorf("Expected A, got %v", readData[0]["Value"]) t.Errorf("Expected A, got %v", readData[0]["Value"])
} }
} }
@ -157,3 +156,11 @@ func BenchmarkExcel_SetData(b *testing.B) {
_ = xls.SetData("Bench", data, "A1", "") _ = xls.SetData("Bench", data, "A1", "")
} }
} }
func castTo[T any](v any) T {
var res T
if val, ok := v.(T); ok {
return val
}
return res
}

11
go.mod
View File

@ -3,18 +3,17 @@ module apigo.cc/go/document
go 1.25.0 go 1.25.0
require ( require (
apigo.cc/go/cast v1.5.0 apigo.cc/go/cast v1.3.1
apigo.cc/go/file v1.5.0 apigo.cc/go/file v1.3.1
apigo.cc/go/jsmod v1.5.0
github.com/dslipak/pdf v0.0.2 github.com/dslipak/pdf v0.0.2
github.com/xuri/excelize/v2 v2.10.1 github.com/xuri/excelize/v2 v2.10.1
github.com/young2j/oxmltotext v1.0.3 github.com/young2j/oxmltotext v1.0.3
) )
require ( require (
apigo.cc/go/encoding v1.5.0 // indirect apigo.cc/go/encoding v1.3.0 // indirect
apigo.cc/go/rand v1.5.0 // indirect apigo.cc/go/rand v1.3.0 // indirect
apigo.cc/go/safe v1.5.0 // indirect apigo.cc/go/safe v1.3.0 // indirect
github.com/andybalholm/brotli v1.0.5 // indirect github.com/andybalholm/brotli v1.0.5 // indirect
github.com/dgrr/quickxml v0.0.0-20201022091424-4977de546d6c // indirect github.com/dgrr/quickxml v0.0.0-20201022091424-4977de546d6c // indirect
github.com/klauspost/compress v1.17.0 // indirect github.com/klauspost/compress v1.17.0 // indirect

22
go.sum
View File

@ -1,15 +1,13 @@
apigo.cc/go/cast v1.5.0 h1:UBGJtFQ8eJPMQXs37cUgqd7YQo1zI9opuSDBDmn2/pE= apigo.cc/go/cast v1.3.1 h1:Y64mit3tCtA1gnSaeaPNf9QjvwX1RA+hFc80j/yUMnI=
apigo.cc/go/cast v1.5.0/go.mod h1:z2GW5p5WCZGEqVVIJUdhl232vRbLf2Qu4EDlEakX/D8= apigo.cc/go/cast v1.3.1/go.mod h1:lGlwImiOvHxG7buyMWhFzcdvQzmSaoKbmr7bcDfUpHk=
apigo.cc/go/encoding v1.5.0 h1:EJNdRVDOMoI2DAvZwQNQTbYuqB/6zsEzvg7lS5pQI+I= apigo.cc/go/encoding v1.3.0 h1:8jqNHoZBR8vOU/BGsLFebfp1Txa1UxDRpd7YwzIFLJs=
apigo.cc/go/encoding v1.5.0/go.mod h1:8++NfZj3hWig0qh2g7GQRw/4LpSvCYMWUZ+8J+x58cA= apigo.cc/go/encoding v1.3.0/go.mod h1:kT/uUJiuAOkZ4LzUWrUtk/I0iL1D8aatvD+59bDnHBo=
apigo.cc/go/file v1.5.0 h1:Fh1NSDBqaxjuXYJ71yPHPXVJ8BFEv/AGS3l+jkLi5uw= apigo.cc/go/file v1.3.1 h1:qHgiJsn1K9DazWRrPoHVnXtp6hDGGsUpAE/4G1bFXqY=
apigo.cc/go/file v1.5.0/go.mod h1:4YhOGgBINTpmmmgws3H8LAyXQQBGzBp44hYUoCS+kr0= apigo.cc/go/file v1.3.1/go.mod h1:pYHBlB/XwsrnWpEh7GIFpbiqobrExfiB+rEN8V2d2kY=
apigo.cc/go/jsmod v1.5.0 h1:JgQtJNiJWy1NOP9AzE8NX5VXJkpO/x3GqLsCCSny5Ec= apigo.cc/go/rand v1.3.0 h1:k+UFAhMySwXf+dq8Om9TniZV6fm6gAE0evbrqMEdwQU=
apigo.cc/go/jsmod v1.5.0/go.mod h1:bmyeZtOAP/j5am+YRnaiM89smysK24K7ebk0koFtsSw= apigo.cc/go/rand v1.3.0/go.mod h1:mZ/4Soa3bk+XvDaqPWJuUe1bfEi4eThBj1XmEAuYxsk=
apigo.cc/go/rand v1.5.0 h1:1o8hh8fhdBuk1/h02IvugvamuT3dkWbVJrqEJVQKB2E= apigo.cc/go/safe v1.3.0 h1:uctdAUsphT9p60Tk4oS5xPCe0NoIdOHfsYv4PNS0Rok=
apigo.cc/go/rand v1.5.0/go.mod h1:Lh98S2dm9UY0X+M+kNQQEKyXHG5pcCKSFPyXN0QCGdk= apigo.cc/go/safe v1.3.0/go.mod h1:tC9X14V+qh0BqIrVg4UkXbl+2pEN+lj2ZNI8IjDB6Fs=
apigo.cc/go/safe v1.5.0 h1:W1NblmcU8cex1f9Y5z8mNLUJOzZTE1s6fszb3FbhGnk=
apigo.cc/go/safe v1.5.0/go.mod h1:OfQ5d6COePSGEuPvMeOk6KagX2sezw7nvKh7exj9SeM=
github.com/andybalholm/brotli v1.0.5 h1:8uQZIdzKmjc/iuPu7O2ioW48L81FgatrcpfFmiq/cCs= github.com/andybalholm/brotli v1.0.5 h1:8uQZIdzKmjc/iuPu7O2ioW48L81FgatrcpfFmiq/cCs=
github.com/andybalholm/brotli v1.0.5/go.mod h1:fO7iG3H7G2nSZ7m0zPUDn85XEX2GTukHGRSepvi9Eig= github.com/andybalholm/brotli v1.0.5/go.mod h1:fO7iG3H7G2nSZ7m0zPUDn85XEX2GTukHGRSepvi9Eig=
github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=

107
graph.go
View File

@ -1,107 +0,0 @@
package document
import (
"fmt"
"strings"
"apigo.cc/go/cast"
"apigo.cc/go/file"
)
// Node 代表文档中的一个节点,可以是一个场景、一个角色或一个知识点。
type Node struct {
ID string `json:"id"`
Title string `json:"title"`
Content string `json:"content"`
Type string `json:"type,omitempty"`
Meta map[string]any `json:"meta,omitempty"`
Links []string `json:"links,omitempty"` // 与其他节点的关联 (ID 列表)
Parents []string `json:"parents,omitempty"` // 父节点 (用于层级结构)
}
// Graph 是一种具有关联关系的文档,适用于小说大纲、策划分镜、思维导图等场景。
type Graph struct {
filename string
Title string `json:"title"`
Nodes map[string]*Node `json:"nodes"`
}
// NewGraph 创建一个新的关系型文档。
func NewGraph() *Graph {
return &Graph{
Nodes: make(map[string]*Node),
}
}
// AddNode 添加或更新一个节点。
func (g *Graph) AddNode(n *Node) {
if n.ID == "" {
n.ID = cast.To[string](len(g.Nodes) + 1)
}
g.Nodes[n.ID] = n
}
// ToJSON 返回文档的结构化 JSON 表示。
func (g *Graph) ToJSON() string {
res, _ := cast.ToJSON(g)
return res
}
// ToMarkdown 将关系型文档转换为带有 Mermaid 图表的 Markdown。
func (g *Graph) ToMarkdown() string {
var sb strings.Builder
sb.WriteString("# " + g.Title + "\n\n")
// 生成 Mermaid 关系图
sb.WriteString("```mermaid\ngraph TD\n")
for id, node := range g.Nodes {
label := node.Title
if label == "" {
label = id
}
// 节点样式根据类型变化
sb.WriteString(fmt.Sprintf(" %s[\"%s\"]\n", id, label))
for _, link := range node.Links {
sb.WriteString(fmt.Sprintf(" %s --> %s\n", id, link))
}
for _, parent := range node.Parents {
sb.WriteString(fmt.Sprintf(" %s --- %s\n", parent, id))
}
}
sb.WriteString("```\n\n")
// 生成详细内容
for _, node := range g.Nodes {
sb.WriteString("## " + node.Title + " (" + node.ID + ")\n")
if node.Type != "" {
sb.WriteString("> Type: " + node.Type + "\n\n")
}
sb.WriteString(node.Content + "\n\n")
}
return sb.String()
}
// Save 将文档保存为 JSON 文件。
func (g *Graph) Save(filename ...string) error {
path := g.filename
if len(filename) > 0 && filename[0] != "" {
path = filename[0]
}
if path == "" {
return fmt.Errorf("no filename specified")
}
return file.Write(path, g.ToJSON())
}
// OpenGraph 从 JSON 文件加载关系型文档。如果文件不存在,则返回一个新的空白文档。
func OpenGraph(filename string) (*Graph, error) {
g := NewGraph()
g.filename = filename
if file.Exists(filename) {
if err := file.UnmarshalFile(filename, g); err != nil {
return nil, err
}
}
return g, nil
}

View File

@ -1,80 +0,0 @@
package document
import (
"strings"
"testing"
"apigo.cc/go/file"
)
func TestGraph_Basic(t *testing.T) {
filename := "test.graph"
defer file.Remove(filename)
g := NewGraph()
g.Title = "Novel Plot"
g.AddNode(&Node{
ID: "1",
Title: "Chapter 1",
Content: "Alice meets Bob.",
Type: "scene",
Links: []string{"2"},
})
g.AddNode(&Node{
ID: "2",
Title: "Chapter 2",
Content: "They go to the park.",
Type: "scene",
Parents: []string{"1"},
})
err := g.Save(filename)
if err != nil {
t.Fatalf("Save failed: %v", err)
}
g2, err := OpenGraph(filename)
if err != nil {
t.Fatalf("OpenGraph failed: %v", err)
}
if g2.Title != "Novel Plot" {
t.Errorf("Expected Title 'Novel Plot', got '%s'", g2.Title)
}
if len(g2.Nodes) != 2 {
t.Errorf("Expected 2 nodes, got %d", len(g2.Nodes))
}
md := g2.ToMarkdown()
if !strings.Contains(md, "mermaid") {
t.Errorf("Markdown should contain mermaid diagram")
}
if !strings.Contains(md, "Chapter 1") {
t.Errorf("Markdown should contain Chapter 1")
}
jsonStr := g2.ToJSON()
if !strings.Contains(jsonStr, "Novel Plot") {
t.Errorf("JSON should contain Title")
}
}
func TestGraph_Unified(t *testing.T) {
filename := "unified.graph"
defer file.Remove(filename)
doc, _ := Open(filename)
if g, ok := doc.(*Graph); ok {
g.Title = "Unified Test"
g.AddNode(&Node{Title: "Root"})
doc.Save()
}
doc2, _ := Open(filename)
if doc2.ToJSON() == "" {
t.Errorf("ToJSON failed")
}
}

View File

@ -1,93 +0,0 @@
package document
import (
"context"
"apigo.cc/go/file"
"apigo.cc/go/jsmod"
)
func init() {
jsmod.Register("document", map[string]any{
"open": func(ctx context.Context, filename string, password ...string) (*jsDocument, error) {
p, err := file.VerifyPathForSafeMode(ctx, filename)
if err != nil {
return nil, err
}
doc, err := Open(p, password...)
if err != nil {
return nil, err
}
return &jsDocument{ctx: ctx, d: doc}, nil
},
"create": func(ctx context.Context, ext string) (*jsDocument, error) {
doc, err := Create(ext)
if err != nil {
return nil, err
}
return &jsDocument{ctx: ctx, d: doc}, nil
},
"newExcel": func(ctx context.Context) *jsDocument {
return &jsDocument{ctx: ctx, d: NewExcel()}
},
"newGraph": func(ctx context.Context) *jsDocument {
return &jsDocument{ctx: ctx, d: NewGraph()}
},
})
}
type jsDocument struct {
ctx context.Context
d Document
}
func (j *jsDocument) ToJSON() string { return j.d.ToJSON() }
func (j *jsDocument) ToMarkdown() string { return j.d.ToMarkdown() }
func (j *jsDocument) Save(filename ...string) error {
var targetPath string
if len(filename) > 0 {
p, err := file.VerifyPathForSafeMode(j.ctx, filename[0])
if err != nil {
return err
}
targetPath = p
}
return j.d.Save(targetPath)
}
// Excel 增强方法 (如果底层是 Excel)
func (j *jsDocument) Get(sheetName string, start, end string) ([][]any, error) {
if x, ok := j.d.(*Excel); ok {
return x.Get(sheetName, start, end)
}
return nil, nil
}
func (j *jsDocument) GetData(sheetName string, start, end string) ([]map[string]any, error) {
if x, ok := j.d.(*Excel); ok {
return x.GetData(sheetName, start, end)
}
return nil, nil
}
func (j *jsDocument) Set(sheetName string, table [][]any, start, end string) error {
if x, ok := j.d.(*Excel); ok {
return x.Set(sheetName, table, start, end)
}
return nil
}
func (j *jsDocument) SetData(sheetName string, data []map[string]any, start, end string) error {
if x, ok := j.d.(*Excel); ok {
return x.SetData(sheetName, data, start, end)
}
return nil
}
func (j *jsDocument) Sheets() []string {
if x, ok := j.d.(*Excel); ok {
return x.Sheets()
}
return nil
}

View File

@ -1,52 +0,0 @@
package document
import (
"fmt"
"apigo.cc/go/cast"
"apigo.cc/go/file"
)
// Markdown 封装了纯 Markdown 文档的读写,使其符合 Document 接口。
type Markdown struct {
filename string
Content string
}
// OpenMarkdown 打开一个 Markdown 文件。
func OpenMarkdown(filename string) (*Markdown, error) {
m := &Markdown{filename: filename}
if file.Exists(filename) {
content, err := file.Read(filename)
if err != nil {
return nil, err
}
m.Content = content
}
return m, nil
}
// ToJSON 返回包含内容的 JSON 字符串。
func (m *Markdown) ToJSON() string {
res, _ := cast.ToJSON(map[string]string{
"content": m.Content,
})
return res
}
// ToMarkdown 直接返回其内容。
func (m *Markdown) ToMarkdown() string {
return m.Content
}
// Save 保存为 Markdown 文件。
func (m *Markdown) Save(filename ...string) error {
path := m.filename
if len(filename) > 0 && filename[0] != "" {
path = filename[0]
}
if path == "" {
return fmt.Errorf("no filename specified")
}
return file.Write(path, m.Content)
}

View File

@ -1,54 +0,0 @@
package document
import (
"strings"
"testing"
"apigo.cc/go/file"
)
func TestCSV(t *testing.T) {
filename := "test.csv"
defer file.Remove(filename)
c, _ := OpenCSV(filename)
c.Data = [][]string{
{"Name", "Age"},
{"Alice", "25"},
{"Bob", "30"},
}
c.Save()
doc, err := Open(filename)
if err != nil {
t.Fatalf("Open failed: %v", err)
}
md := doc.ToMarkdown()
if !strings.Contains(md, "Alice") || !strings.Contains(md, "| --- |") {
t.Errorf("Unexpected Markdown: %s", md)
}
jsonStr := doc.ToJSON()
if !strings.Contains(jsonStr, "\"Name\":\"Alice\"") {
t.Errorf("Unexpected JSON: %s", jsonStr)
}
}
func TestMarkdown(t *testing.T) {
filename := "test.md"
defer file.Remove(filename)
m, _ := OpenMarkdown(filename)
m.Content = "# Hello\nWorld"
m.Save()
doc, err := Open(filename)
if err != nil {
t.Fatalf("Open failed: %v", err)
}
if doc.ToMarkdown() != "# Hello\nWorld" {
t.Errorf("Unexpected Markdown: %s", doc.ToMarkdown())
}
}

349
pdf.go
View File

@ -1,8 +1,9 @@
package document package document
import ( import (
"bytes"
"fmt" "fmt"
"sort" "io"
"strings" "strings"
"apigo.cc/go/cast" "apigo.cc/go/cast"
@ -28,10 +29,7 @@ func OpenPDF(filename string) (*PDF, error) {
} }
f, err := pdf.Open(filename) f, err := pdf.Open(filename)
if err != nil { if err == nil {
return nil, err
}
p.Metadata["pages"] = f.NumPage() p.Metadata["pages"] = f.NumPage()
trailer := f.Trailer() trailer := f.Trailer()
infoDict := trailer.Key("Info") infoDict := trailer.Key("Info")
@ -44,339 +42,16 @@ func OpenPDF(filename string) (*PDF, error) {
} }
} }
// 收集所有页面的 block var b bytes.Buffer
type Block struct { if t, err := f.GetPlainText(); err == nil {
Type string io.Copy(&b, t)
Level int p.Content = b.String()
Text string
FontSize float64
}
var allBlocks []Block
for i := 1; i <= f.NumPage(); i++ {
page := f.Page(i)
if page.V.IsNull() {
continue
}
content := page.Content()
texts := content.Text
if len(texts) == 0 {
continue
}
// 1. 估算正文字体大小(众数)
fontSizes := make(map[int]int)
for _, t := range texts {
fontSizes[int(t.FontSize)]++
}
bodySize := 0
maxCount := 0
for size, count := range fontSizes {
if count > maxCount {
maxCount = count
bodySize = size
} }
} }
// 2. 按行分组(基于 Y 坐标)
type Line struct {
Y float64
MaxFontSize float64
Text string
Texts []pdf.Text
}
var lines []Line
for _, t := range texts {
found := false
for i := range lines {
if t.Y > lines[i].Y-2 && t.Y < lines[i].Y+2 {
lines[i].Texts = append(lines[i].Texts, t)
found = true
break
}
}
if !found {
lines = append(lines, Line{Y: t.Y, Texts: []pdf.Text{t}})
}
}
sort.Slice(lines, func(i, j int) bool {
return lines[i].Y > lines[j].Y
})
for i := range lines {
sort.Slice(lines[i].Texts, func(m, n int) bool {
return lines[i].Texts[m].X < lines[i].Texts[n].X
})
var sb strings.Builder
maxFS := 0.0
for _, t := range lines[i].Texts {
sb.WriteString(t.S)
if t.FontSize > maxFS {
maxFS = t.FontSize
}
}
lines[i].Text = strings.TrimSpace(sb.String())
lines[i].MaxFontSize = maxFS
}
// 3. 语义块识别
for j := 0; j < len(lines); j++ {
line := lines[j]
if line.Text == "" {
continue
}
isTableLine, cells := p.identifyTableLine(line)
if isTableLine {
tableStr := "| " + strings.Join(cells, " | ") + " |"
allBlocks = append(allBlocks, Block{Type: "table", Text: tableStr})
continue
}
if line.MaxFontSize > float64(bodySize)+1 {
level := 1
if line.MaxFontSize < float64(bodySize)+4 {
level = 3
} else if line.MaxFontSize < float64(bodySize)+8 {
level = 2
}
fullText := line.Text
lastY := line.Y
for k := j + 1; k < len(lines); k++ {
if lines[k].Text != "" && MathAbs(lines[k].MaxFontSize-line.MaxFontSize) < 1.0 {
if MathAbs(lines[k].Y-lastY) < 25 {
fullText += " " + lines[k].Text
lastY = lines[k].Y
j = k
} else {
break
}
} else {
break
}
}
if j < 5 && i == 1 {
if title, ok := p.Metadata["title"].(string); ok && strings.Contains(title, fullText) {
continue
}
}
if len(allBlocks) > 0 && allBlocks[len(allBlocks)-1].Type == "heading" && allBlocks[len(allBlocks)-1].Level == level {
allBlocks[len(allBlocks)-1].Text += " " + fullText
} else {
allBlocks = append(allBlocks, Block{Type: "heading", Level: level, Text: fullText})
}
} else {
if (line.Y < 50 || line.Y > 800) && isPageNumber(line.Text) {
continue
}
fullText := line.Text
lastY := line.Y
for k := j + 1; k < len(lines); k++ {
if lines[k].Text != "" && lines[k].MaxFontSize <= float64(bodySize)+1 {
isT, _ := p.identifyTableLine(lines[k])
if isT {
break
}
if (lines[k].Y < 50 || lines[k].Y > 800) && isPageNumber(lines[k].Text) {
break
}
if MathAbs(lines[k].Y-lastY) > 25 {
break
}
fullText += lines[k].Text
lastY = lines[k].Y
j = k
if isPunctuation(lines[k].Text) {
break
}
} else {
break
}
}
allBlocks = append(allBlocks, Block{Type: "paragraph", Text: fullText})
}
}
}
// 4. 智能封面/标题逻辑 (全局)
h1Count := 0
for _, b := range allBlocks {
if b.Type == "heading" && b.Level == 1 {
h1Count++
}
}
shouldPromote := h1Count <= 1
contentStarted := false
hasMetadataTitle := false
if t, ok := p.Metadata["title"].(string); ok && t != "" {
hasMetadataTitle = true
}
firstHeadingProcessed := false
var sb strings.Builder
for _, b := range allBlocks {
if b.Type == "heading" {
level := b.Level
if !contentStarted {
if !firstHeadingProcessed {
firstHeadingProcessed = true
// 如果有 Metadata Title则 Metadata Title 充当了真正的第一级标题
// 我们把遇到的第一个大标题降级为正文文本(除非它已经是标准章节)
if hasMetadataTitle && !isStandardSection(b.Text) {
sb.WriteString("\n" + b.Text + "\n\n")
continue
} else {
// 否则作为文档的主标题
sb.WriteString("\n# " + b.Text + "\n\n")
continue
}
} else {
if isStandardSection(b.Text) {
contentStarted = true
sb.WriteString("\n# " + b.Text + "\n\n")
continue
}
// 否则作为封面副标题/文本
sb.WriteString(b.Text + "\n\n")
continue
}
}
if shouldPromote {
if level == 2 {
level = 1
} else if level == 3 {
level = 2
}
}
sb.WriteString("\n" + strings.Repeat("#", level) + " " + b.Text + "\n\n")
} else if b.Type == "paragraph" {
contentStarted = true
sb.WriteString(b.Text + "\n\n")
} else if b.Type == "table" {
contentStarted = true
sb.WriteString(b.Text + "\n")
}
}
p.Content = strings.TrimSpace(sb.String())
return p, nil return p, nil
} }
func isStandardSection(s string) bool {
s = strings.TrimSpace(s)
// 常见的章节开头关键词
standards := []string{"引言", "摘要", "目录", "前言", "结论", "背景", "概述", "Introduction", "Abstract", "Conclusion", "Summary"}
for _, std := range standards {
if strings.Contains(s, std) {
return true
}
}
// 如果标题带有数字编号且较短,也认为是章节开始
if len([]rune(s)) < 20 {
if s[0] >= '0' && s[0] <= '9' {
return true
}
if strings.HasPrefix(s, "第") && (strings.Contains(s, "章") || strings.Contains(s, "节") || strings.Contains(s, "部分")) {
return true
}
}
return false
}
func isPageNumber(s string) bool {
s = strings.TrimSpace(s)
if s == "" {
return false
}
isNum := true
for _, r := range s {
if r < '0' || r > '9' {
isNum = false
break
}
}
if isNum {
return true
}
lower := strings.ToLower(s)
return strings.HasPrefix(lower, "page") || (strings.HasPrefix(s, "-") && strings.HasSuffix(s, "-"))
}
func isPunctuation(s string) bool {
if s == "" {
return false
}
runes := []rune(s)
last := runes[len(runes)-1]
return strings.ContainsRune("。.!?:", last)
}
func (p *PDF) identifyTableLine(line struct {
Y float64
MaxFontSize float64
Text string
Texts []pdf.Text
}) (bool, []string) {
if len(line.Texts) < 3 {
return false, nil
}
var cells []string
var currentCell strings.Builder
lastX := -1.0
for _, t := range line.Texts {
if lastX != -1.0 && t.X-(lastX) > 40 {
content := strings.TrimSpace(currentCell.String())
if content != "" {
cells = append(cells, content)
}
currentCell.Reset()
}
currentCell.WriteString(t.S)
lastX = t.X + t.W
}
finalCell := strings.TrimSpace(currentCell.String())
if finalCell != "" {
cells = append(cells, finalCell)
}
if len(cells) >= 2 {
allSingleChar := true
for _, c := range cells {
r := []rune(c)
if len(r) > 1 {
allSingleChar = false
}
if len(r) > 40 {
return false, nil
}
}
if allSingleChar {
return false, nil
}
return true, cells
}
return false, nil
}
func MathAbs(v float64) float64 {
if v < 0 {
return -v
}
return v
}
// ToJSON 返回结构化 JSON。 // ToJSON 返回结构化 JSON。
func (p *PDF) ToJSON() string { func (p *PDF) ToJSON() string {
res, _ := cast.ToJSON(map[string]any{ res, _ := cast.ToJSON(map[string]any{
@ -388,15 +63,7 @@ func (p *PDF) ToJSON() string {
// ToMarkdown 返回 Markdown。 // ToMarkdown 返回 Markdown。
func (p *PDF) ToMarkdown() string { func (p *PDF) ToMarkdown() string {
if p.Content == "" { return p.Content
return ""
}
var sb strings.Builder
if title, ok := p.Metadata["title"]; ok && title != "" {
sb.WriteString("# " + cast.To[string](title) + "\n\n")
}
sb.WriteString(p.Content)
return sb.String()
} }
// Save 保存(目前保存为提取后的文本)。 // Save 保存(目前保存为提取后的文本)。

37
pptx.go
View File

@ -3,7 +3,6 @@ package document
import ( import (
"fmt" "fmt"
"io" "io"
"strings"
"apigo.cc/go/cast" "apigo.cc/go/cast"
"apigo.cc/go/file" "apigo.cc/go/file"
@ -47,41 +46,7 @@ func (p *Pptx) ToJSON() string {
// ToMarkdown 返回 Markdown。 // ToMarkdown 返回 Markdown。
func (p *Pptx) ToMarkdown() string { func (p *Pptx) ToMarkdown() string {
if p.Content == "" { return p.Content
return ""
}
lines := strings.Split(p.Content, "\n")
var res []string
nextIsMainTitle := true
for _, line := range lines {
trimmed := strings.TrimSpace(line)
if trimmed == "" {
continue
}
// 检查幻灯片分隔符
if strings.Contains(line, "--------------------------------") {
res = append(res, "\n---")
nextIsMainTitle = true
continue
}
// 启发式识别标题:行短、无句末标点
if len([]rune(trimmed)) < 50 && !strings.HasSuffix(trimmed, ".") && !strings.HasSuffix(trimmed, "。") && !strings.HasSuffix(trimmed, ":") && !strings.HasSuffix(trimmed, "") {
if nextIsMainTitle {
res = append(res, "\n# "+trimmed)
nextIsMainTitle = false
} else {
res = append(res, "\n## "+trimmed)
}
} else {
res = append(res, trimmed)
// 如果该页已经有了主标题,后续的长文本不会重置标题状态
}
}
return strings.TrimSpace(strings.Join(res, "\n"))
} }
// Save 保存文档(目前保存为提取后的文本)。 // Save 保存文档(目前保存为提取后的文本)。