上传文档

POST /api/v1/upload

上传本地文件，自动入队，调度器在并发额度内自动运行。

curl -X POST $HOST/api/v1/upload \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@/path/to/book.epub" \
  -F "wiki_name=深度学习实战" \
  -F "lang=zh"

表单字段

字段	必填	默认值	说明
file	✓	—	epub / pdf / md / txt 文件
wiki_name		文件名	wiki 显示名称
wiki_slug		从名字派生	URL 标识，仅小写字母/数字/连字符；冲突自动加后缀
lang		zh	内容语言（zh / en）
auto_start		true	true = 上传后立即入队；false = 仅创建不运行

响应

{
  "ok": true,
  "job_id": 42,
  "wiki_slug": "deep-learning",
  "wiki_name": "深度学习实战",
  "target_dir": "/wikis/alice/deep-learning",
  "message": "Wiki '深度学习实战' created. Job #42 queued."
}

提示

内容去重：同一本书（内容指纹相同）已生成过时，服务直接克隆已有成果并跳过整个流水线，秒级返回。

---

POST /api/v1/upload-url

从远程 URL 下载文件并提交任务。

curl -X POST $HOST/api/v1/upload-url \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"source_url":"https://example.com/book.epub","wiki_name":"远程书籍","lang":"zh"}'

字段	必填	说明
source_url	✓	文件 URL（http / https）
wiki_name		wiki 显示名称
wiki_slug		URL 标识
lang		内容语言（默认 zh）

注意

默认拒绝私网地址与非 http(s) 协议（防 SSRF）。如需访问内网，须以 MEMEX_ALLOW_PRIVATE_URLS=1 启动服务。