使用自己的算力

CiteArk Agent 读取论文和代码，根据你的目标与算力规划实验，执行、评估证据并签名生成 CAP。它可以独立使用。CiteArk 网站也托管同一个引擎，并提供成果存储与展示。

开始

先安装 Node.js 22 或更新版本、Git 和 tar。本机执行需要 Docker；Windows 使用 Docker Desktop 的 WSL2 后端和 Linux 容器。苹果芯片支持 CPU 实验，CUDA 需要兼容的 NVIDIA 硬件。也可通过 SSH 使用 Linux 服务器，或通过 --compute-catalog 指定 GCP Batch、AutoDL 算力目录。

安装一次

复制以下命令，在终端中安装或升级 CiteArk Agent：

安装后，日常只需运行：

citeark

交互界面可选择论文文件、论文网址、CAP 或已有工作区。工具会询问本次目标、算力目录和首次模型配置，再列出实验供你选择；后续复用已保存的模型设置。

在论文页点击 使用自己的算力，执行第二步的 citeark start <论文短编号>，即可从该论文的资料开始。论文不需要先在平台成功复现。

Windows PowerShell 若阻止脚本，可改用 npm.cmd 和 citeark.cmd。安装后若提示找不到 citeark，重新打开终端并确认 npm 的全局命令目录在 PATH 中。

也可以完全独立地开始：

citeark start --paper ./paper.pdf --repository ./code --goal '比较不同推理批大小'
citeark start --cap ./previous.cap --paper ./paper.pdf --guide ./REPRODUCE.md

CAP 可提供已签名的论文清单、历史证据和参考代码，Agent 仍会为本次研究制定计划。执行说明帮助寻找路径，不固定本次实验，也不替代实际观测。需要按已有交付直接复跑时，显式使用 deploy <论文短编号> --replay。

--plan-only 保存计划而不执行实验；start --resume --work-dir <目录> --experiments <id1,id2> 继续研究。新目标或新资料使用新工作区。--dry-run 只准备输入，不调用模型、构建容器或启动实验。

本机解析 PDF

首次读取 PDF 前，安装 Python 3.12 和 unzip，然后运行：

citeark paper setup --python python3.12
citeark paper parse --input ./paper.pdf --output ./paper-reading

第一条命令在独立环境安装固定版本解析器并下载公开模型；第二条可单独验证解析，不调用科研模型或启动实验。正常 citeark start 自动复用同一解析器。默认使用 4 个 CPU 线程，建议准备 16 GiB 内存；无需 GPU、CiteArk 账号、Google Cloud 或 MinerU 官方接口密钥。Windows 的 PDF 路径目前建议使用 WSL2。

模型默认保存在 ~/.citeark/mineru-4.0.10，后续离线复用；CITEARK_MINERU_HOME 可修改目录。需要时用 --source modelscope 下载模型。Linux 还需安装 libgl1、libglib2.0-0、libgomp1 和 libvulkan1。在 SSH 服务器上运行时，在服务器完成同一准备。

阅读副本保留页码、公式、表格和图片；摘要缓存避免重复解析。转换仍可能出现上下标或图注关联错误，应保留原 PDF 供 Agent 按页核对。平台按需 CPU 任务运行包内同一解析脚本；私有云资源、任务队列与费用仅由平台宿主管理。

查看研究过程

终端界面使用英文，顶部显示获取论文、理解研究、准备材料、运行实验、评估与交付五个阶段。正文按实际事件展示 Agent 的正常发言、工具调用、命令和结果。AI 发言完整显示，较长的工具结果可用 Ctrl+O 展开。

使用鼠标滚轮或 PgUp/PgDn 翻阅历史；阅读旧消息时，新输出不会把画面拉回底部，按 End 回到实时输出。显示时机取决于运行器何时输出事件，部分工具在执行结束后才返回完整结果。

工作区保留 session.events.jsonl，可只读打开历史会话：

citeark view ./my-research

交互研究使用独立工作进程。Ctrl+C 退出终端后任务继续，用 citeark session attach ./my-research 重新连接。连接期间可输入后续说明，在下一次 Agent 调用生效；/pause 在下个阶段边界暂停，/resume 继续，/cancel 请求取消。citeark session status ./my-research 显示状态及资源清理结果。

--plain 使用普通文本输出；非交互启动加 --background 后可在断开终端后继续。citeark start --resume --work-dir ./my-research 重新启动中断的工作区，已完成研究不会重新执行。训练恢复取决于实际保存的检查点。

模型与服务器

保存可复用的模型和算力配置：

citeark model add research --agent opencode --api-base-url https://openrouter.ai/api/v1 --model <模型名称> --api-key-env RESEARCH_API_KEY
citeark model use research
citeark compute add lab --type ssh --host my-lab --directory /home/research/citeark
citeark start --paper ./paper.pdf --compute lab

模型密钥放在指定环境变量中。model check research 会发出最多三个小型付费请求，验证工具调用和结构化输出。交互入口的 /model、/compute 选择已保存配置。每项研究保存模型及算力快照，修改默认配置不会改变已有研究；--assessment-profile 可单独选择科学评估模型。

SSH 服务器需安装 Node.js、CiteArk Agent，配置自己的模型；使用服务器本机算力时还需要 Docker。凭据在服务器配置。使用已有 SSH 别名和已验证的主机密钥，compute check lab 检查连接。远程任务会返回工作区路径，用 session attach <远程目录> --compute lab 重连，用 start --resume --work-dir <远程目录> --compute lab --experiments <编号> 选择实验，用 session fetch <远程目录> --compute lab --output ./results 取回并验证 CAP。

用户服务器和 CiteArk 自有服务器运行相同 Agent，平台另行提供账户、队列与计费。当前仍是 alpha：协议和进程测试不代表真实论文与 GPU 稳定性已验证。--model-budget 是运行器限制，不是整项研究的费用上限。

解压安装

下载Agent 压缩包，解压到新目录后执行：

npm ci
node src/cli.mjs setup
node src/cli.mjs paper setup --python python3.12
node src/cli.mjs start --paper ./paper.pdf

setup --gpu 构建 CUDA 环境。网站按 Agent 提交与摘要固定下载包。当前压缩包包含 JavaScript 源码，运行需要 Node.js。固定安装地址 /cli.tgz 随本站正式发布更新；升级时重新运行安装命令即可。已安装的 Agent 不会自动切换版本。

结果与上传

工作区保留规划、执行证据和检查点。完成的 CAP 路径显示在终端，并记录于 workspace.json。默认签名私钥保存在本机 ~/.citeark/signing-key.pem，也可用 --signing-key 选择其他 Ed25519 密钥。

独立使用不需要平台账户。可选上传需要具有写入权限的平台 API 密钥：

citeark publish --plan ./plan.cap --cap ./result.cap
citeark publish --plan ./plan.cap --cap ./result.cap --repository-id '<论文ID>' --visibility public

先上传签名计划，再上传执行结果；无需平台已有复现运行。不指定论文时默认仅上传者可读，--visibility public 明确公开。社区结果保留自己的实验、上传者与签名者，不覆盖平台托管评估。

GET /api/v1/artifacts 列出你的上传。GET /api/v1/artifacts/{artifactDigest} 读取元数据，添加 ?download 下载 CAP。POST /api/v1/artifacts?visibility=private 接收 CAP 文件正文，可选 repository=<id> 关联论文、visibility=public 明确公开。原有论文社区上传接口继续可用。

上传限压缩后 24 MiB、解压后 96 MiB。数据集和模型权重留在原来源或用户算力中。有效签名确认科研产物的来源，评估记录说明证据支持什么结论。

查看研究路线

当前 CiteArk Agent 生成 CAP 2.0.0-alpha.2。citeark graph --cap result.cap --operation subgraph 离线验签并读取研究图；--query query.json 可选择精确路线、比较或来源。网页论文页的「研究路线」以及账号菜单「研究产物」读取同一模型。无论文研究图也可上传，默认私有；完整原生研究编辑工作区尚未提供。