快速开始
Memex 把一本书变成一个 Wiki。上传书 → 等待生成 → 打开预览，三步完成。
- 服务地址：
https://memex-server.memect.cn；下文示例统一以$HOST指代 - Web 界面：浏览器直接打开服务地址，上传、看进度、开预览都能在页面上完成
- API 调用：见下文
第 1 步：获取 API Key
向管理员申请，或（管理员）在 Web 界面「设置 → API Token」中创建。
Key 形如 sk-memex-xxxxxxxx，每次请求放在 Header 里：
Authorization: Bearer sk-memex-xxxxxxxx
后续示例可原样复制，先设好两个环境变量：
export HOST=https://memex-server.memect.cn
export MEMEX_API_KEY=sk-memex-xxxxxxxx # 替换为你的 API Key
第 2 步：上传一本书
支持 epub / pdf / md / txt。上传即自动排队生成，无需其他操作。
curl -X POST $HOST/api/v1/upload \
-H "Authorization: Bearer $MEMEX_API_KEY" \
-F "file=@苏东 坡传.epub" \
-F "wiki_name=苏东坡传" \
-F "lang=zh"
返回：
{ "ok": true, "job_id": 42, "wiki_slug": "su-dong-po-zhuan" }
记下 job_id 和 wiki_slug。
也可以直接给一个 URL：
curl -X POST $HOST/api/v1/upload-url \
-H "Authorization: Bearer $MEMEX_API_KEY" -H "Content-Type: application/json" \
-d '{"source_url": "https://example.com/book.epub", "wiki_name": "我的书"}'
第 3 步：查看进度
生成需要一段时间（视书的大小，通常 1～4 小时）。随时查询：
curl $HOST/api/v1/jobs/42 \
-H "Authorization: Bearer $MEMEX_API_KEY"
status 字段变为 ready 或 completed 即生成完毕。
也可以在浏览器打开 $HOST/job/42 看实时日志，
或用 SSE 订阅：
curl -N "$HOST/api/v1/jobs/42/stream?access_token=$MEMEX_API_KEY"
第 4 步：打开 Wiki
curl -X POST $HOST/api/v1/wiki/su-dong-po-zhuan/serve \
-H "Authorization: Bearer $MEMEX_API_KEY"
然后浏览器访问：
$HOST/preview/su-dong-po-zhuan/
完成。
一个完整的例子
HOST=https://memex-server.memect.cn
KEY="sk-memex-xxxxxxxx"
# 上传
JOB=$(curl -s -X POST $HOST/api/v1/upload \
-H "Authorization: Bearer $KEY" \
-F "file=@book.epub" -F "wiki_name=我的书" | python3 -c "import sys,json;print(json.load(sys.stdin)['job_id'])")
# 轮询直到完成
while true; do
S=$(curl -s $HOST/api/v1/jobs/$JOB -H "Authorization: Bearer $KEY" | python3 -c "import sys,json;print(json.load(sys.stdin)['status'])")
echo "status: $S"
[ "$S" = "ready" ] || [ "$S" = "completed" ] && break
[ "$S" = "failed" ] && exit 1
sleep 60
done
# 开预览
SLUG=$(curl -s $HOST/api/v1/jobs/$JOB -H "Authorization: Bearer $KEY" | python3 -c "import sys,json;print(json.load(sys.stdin)['wiki_slug'])")
curl -s -X POST $HOST/api/v1/wiki/$SLUG/serve -H "Authorization: Bearer $KEY"
echo "打开: $HOST/preview/$SLUG/"