fix: complete _separate function table (10→17) in out-pointer doc
Some checks failed
CI/CD Pipeline / Lint (push) Has been cancelled
CI/CD Pipeline / Test (push) Has been cancelled
CI/CD Pipeline / Build (push) Has been cancelled
CI/CD Pipeline / Release (macos-15, aarch64-apple-ios, aarch64-apple-ios) (push) Has been cancelled
CI/CD Pipeline / Release (macos-15, aarch64-apple-ios-sim, aarch64-apple-ios-sim) (push) Has been cancelled
CI/CD Pipeline / Package xcframework (push) Has been cancelled

- Add missing: build_document_info, search_epub, update_position,
  create_note_anchor, create_note_anchor_from_search
- Add memory management functions (rustbuffer_free/from_bytes)
- Organize by category: memory, parse, search, events, anchors

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
wangdl 2026-06-18 15:00:57 +08:00
parent 3c925d7fd7
commit bb0422682e

View File

@ -207,18 +207,49 @@ data: *mut *mut u8 → 数据指针(双重指针:写入指针值)
项目中有以下函数使用 out-pointer 模式(`_separate` 后缀):
| 函数 | 输入 | 输出 | 状态 |
|------|:--:|:--:|:--:|
| `parse_markdown_separate` | JSON args | `Vec<DocumentBlock>` | ✅ 已实现 |
| `parse_text_separate` | JSON args | `Vec<DocumentBlock>` | ✅ 已实现 |
| `detect_material_type_separate` | 文件路径 | `MaterialType` | ✅ 已实现 |
| `read_image_meta_separate` | 文件路径 | `ImageMeta` | ✅ 已实现 |
| `read_text_stats_separate` | 文件路径 | `TextStats` | ✅ 已实现 |
| `search_markdown_blocks_separate` | JSON args | `Vec<SearchResult>` | ✅ 已实现 |
| `search_text_content_separate` | JSON args | `Vec<SearchResult>` | ✅ 已实现 |
| `search_pdf_pages_separate` | JSON args | `Vec<SearchResult>` | ✅ 已实现 |
| `push_reading_event_separate` | JSON event | () | ✅ 已实现 |
| `export_pending_events_separate` | () | `Vec<ReadingEvent>` | ✅ 已实现 |
### 内存管理
| 函数 | 说明 |
|------|------|
| `rustbuffer_free_separate` | 释放 out-pointer 分配的 buffer |
| `rustbuffer_from_bytes_separate` | 从 raw bytes 构造 RustBuffer |
### 文档解析
| 函数 | 输入 | 输出 |
|------|:--:|:--:|
| `build_document_info_separate` | JSON args | `DocumentInfo` |
| `parse_markdown_separate` | JSON args | `Vec<DocumentBlock>` |
| `parse_text_separate` | JSON args | `Vec<DocumentBlock>` |
| `detect_material_type_separate` | String | `MaterialType` |
| `read_image_meta_separate` | String | `ImageMeta` |
| `read_text_stats_separate` | String | `TextStats` |
### 搜索
| 函数 | 输入 | 输出 |
|------|:--:|:--:|
| `search_markdown_blocks_separate` | JSON args | `Vec<SearchResult>` |
| `search_text_content_separate` | JSON args | `Vec<SearchResult>` |
| `search_pdf_pages_separate` | JSON args | `Vec<SearchResult>` |
| `search_epub_chapters_ffi_separate` | JSON args | `Vec<SearchResult>` |
### V1 事件deprecated
| 函数 | 输入 | 输出 |
|------|:--:|:--:|
| `push_reading_event_separate` | JSON event | () |
| `update_reading_position_separate` | JSON args | () |
| `export_pending_events_separate` | () | `Vec<ReadingEvent>` |
### 锚点
| 函数 | 输入 | 输出 |
|------|:--:|:--:|
| `create_note_anchor_separate` | JSON args | `NoteAnchor` |
| `create_note_anchor_from_search_separate` | JSON args | `NoteAnchor` |
**总计**17 个 `_separate` 函数(含 2 个内存管理 + 15 个业务函数)
---