arxiv-paper-zh 0.1.0

package/.codex-plugin/plugin.json

@@ -0,0 +1,33 @@
+{
+  "name": "arxiv-paper-zh",
+  "version": "0.1.0",
+  "description": "Verify and translate arXiv papers into compilable Chinese editions with paired English and Chinese PDFs.",
+  "author": {
+    "name": "AndrewYq",
+    "url": "https://github.com/yqstar"
+  },
+  "homepage": "https://github.com/yqstar/arxiv-paper-zh#readme",
+  "repository": "https://github.com/yqstar/arxiv-paper-zh",
+  "license": "MIT",
+  "keywords": [
+    "arxiv",
+    "translation",
+    "latex",
+    "chinese",
+    "agent-skill"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "arXiv 论文中文化",
+    "shortDescription": "核验并翻译 arXiv 论文，交付中英文源码与 PDF。",
+    "longDescription": "核验论文身份，下载并翻译 TeX 源码，检查依赖和漏译，最后编译并逐页核验中英文 PDF。",
+    "developerName": "AndrewYq",
+    "category": "Productivity",
+    "capabilities": [
+      "Read",
+      "Write"
+    ],
+    "websiteURL": "https://github.com/yqstar/arxiv-paper-zh",
+    "defaultPrompt": "使用 arxiv-paper-zh 核验并翻译我指定的论文，交付中英文源码与 PDF。"
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AndrewYq
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,242 @@
+# arxiv-paper-zh
+
+将 arXiv/LaTeX 论文快速转换为可编译的中文版本。该 Agent Skill 会先核验论文身份，再下载 TeX 源码，按内容量并行翻译，自动检查漏译与 TeX 依赖，最后使用 XeLaTeX 编译并逐页检查 PDF。
+
+方案参考了科学空间的[《让 AI 翻译一篇完整的论文》](https://spaces.ac.cn/archives/11578)，并针对 Codex、Claude Code 等 Agent Skills 兼容环境补充了并行分片、依赖缓存、自动审计和可重复构建流程。
+
+## 功能
+
+- 核对论文简称、标题、作者、摘要、URL 与 arXiv ID，避免翻错同名论文。
+- 按 `arxiv-paper/<paper-name>/` 统一保存原始源码、中文源码以及中英文 PDF。
+- 按可见英文词量均衡分片，支持多个 subagent 并行处理长论文。
+- 保留公式、数值、引用键、标签、人名、模型名、数据集名和常用缩写。
+- 翻译正文、章节标题、脚注、表头、表注和 caption。
+- 批量检查并安装缺失的 TeX 宏包，复用共享 TinyTeX/TeX Live 缓存。
+- 自动执行漏译审计、BibTeX/Biber 构建和引用收敛检查。
+- 使用 XeLaTeX 生成中文 PDF，并要求逐页视觉核验。
+
+## 项目结构
+
+```text
+arxiv-paper-zh/
+├── .codex-plugin/
+│   └── plugin.json
+├── .agents/
+│   └── plugins/
+│       └── marketplace.json
+├── bin/
+│   └── arxiv-paper-zh.mjs
+├── skills/
+│   └── arxiv-paper-zh/
+│       ├── SKILL.md
+│       ├── agents/
+│       │   └── openai.yaml
+│       ├── scripts/
+│       │   ├── audit_tex_translation.py
+│       │   ├── build_and_check.py
+│       │   ├── inventory_and_shard.py
+│       │   ├── prepare_output_layout.py
+│       │   └── prepare_tex_runtime.py
+│       └── references/
+│           └── paper-translation-packages.txt
+├── install.sh
+├── package.json
+├── .gitignore
+└── README.md
+```
+
+`skills/arxiv-paper-zh/` 是可以被 Agent 独立加载的完整 Skill；根目录同时提供 Codex Plugin manifest、npm/npx 安装器和原有 Shell 安装器。
+
+## 环境要求
+
+- macOS 或 Linux。
+- Python 3.9 或更高版本。
+- 可执行 `curl`、`tar` 等常用命令。
+- Codex、Claude Code，或其他支持 [Agent Skills 开放格式](https://agentskills.io/) 的客户端。
+- 编译时需要 XeLaTeX。可以使用系统 TeX Live，也可以让 Skill 准备并复用 TinyTeX。
+- 第一次下载论文源码或安装缺失宏包时需要网络连接。
+
+TeX 运行时不包含在本仓库中，避免让仓库体积增加数百 MB。不同论文缺少的宏包会被批量安装到共享运行时。
+
+## 安装
+
+### 使用 npm / npx
+
+无需先克隆仓库，可直接安装到 Codex 和 Claude Code：
+
+```bash
+npx arxiv-paper-zh install
+```
+
+安装到 Codex、Claude Code 和通用 Agent Skills 目录：
+
+```bash
+npx arxiv-paper-zh install --all
+```
+
+也可以选择单个客户端或安装到指定项目：
+
+```bash
+npx arxiv-paper-zh install --codex
+npx arxiv-paper-zh install --claude
+npx arxiv-paper-zh install --agents
+npx arxiv-paper-zh install --project /path/to/project --all
+```
+
+npm 安装器会复制完整 Skill 目录。目标已存在时默认停止；明确需要升级或替换时增加 `--force`。
+
+### 作为 Codex Plugin 安装
+
+本仓库同时是一个 Codex Plugin，并通过仓库内的 marketplace 从 npm registry 获取版本化包：
+
+```bash
+codex plugin marketplace add yqstar/arxiv-paper-zh --ref main
+codex plugin add arxiv-paper-zh@arxiv-paper-zh
+```
+
+### 从源码一键安装到 Codex 和 Claude Code
+
+```bash
+git clone https://github.com/yqstar/arxiv-paper-zh.git
+cd arxiv-paper-zh
+./install.sh --all
+```
+
+安装脚本默认创建符号链接，因此更新仓库后各客户端会立即使用新版本。它不会覆盖已经存在的同名 Skill。
+
+### 仅安装到指定环境
+
+```bash
+./install.sh --codex
+./install.sh --claude
+./install.sh --agents
+```
+
+对应的用户级目录为：
+
+| 环境 | 安装位置 |
+| --- | --- |
+| Codex | `~/.codex/skills/arxiv-paper-zh` |
+| Claude Code | `~/.claude/skills/arxiv-paper-zh` |
+| 通用 Agent Skills | `~/.agents/skills/arxiv-paper-zh` |
+
+如果客户端已经启动，请重新开启会话；Claude Code 通常支持技能目录的热更新。
+
+### 项目级安装
+
+把 Skill 安装到某个仓库，仅供该项目使用：
+
+```bash
+./install.sh --project /path/to/project --agents
+./install.sh --project /path/to/project --claude
+```
+
+这会分别创建：
+
+- `/path/to/project/.agents/skills/arxiv-paper-zh`
+- `/path/to/project/.claude/skills/arxiv-paper-zh`
+
+### 手动安装
+
+也可以直接复制或链接 Skill 子目录。例如：
+
+```bash
+ln -s "$(pwd)/skills/arxiv-paper-zh" ~/.codex/skills/arxiv-paper-zh
+```
+
+不要只复制 `SKILL.md`，因为工作流还依赖 `scripts/` 和 `references/`。
+
+## 使用
+
+安装后直接向 Agent 描述论文即可：
+
+```text
+使用 arxiv-paper-zh 翻译论文 RankMixer。
+```
+
+也可以提供更精确的信息：
+
+```text
+使用 arxiv-paper-zh 翻译 arXiv:2507.15551。保留公式、引用和人名，
+将产物放到 arxiv-paper/RankMixer，分别编译并返回中英文 PDF。
+```
+
+Codex 中可显式调用：
+
+```text
+$arxiv-paper-zh 翻译 arXiv:2507.15551
+```
+
+Claude Code 中可直接输入自然语言，或在发现该 Skill 后使用：
+
+```text
+/arxiv-paper-zh 翻译 arXiv:2507.15551
+```
+
+如果简称可能对应多篇论文，Skill 会先返回候选论文的完整标题、作者与 arXiv ID，请用户确认后再下载。
+
+## 交付内容
+
+每次任务均按论文简称建立固定目录。例如 `paper-name=EST`：
+
+```text
+arxiv-paper/EST/
+├── latex/
+│   ├── source.tar
+│   ├── paper-en/
+│   └── paper-zh/
+├── paper-en/
+│   └── EST-en.pdf
+└── paper-zh/
+    └── EST-zh.pdf
+```
+
+- `latex/source.tar`：从 arXiv 下载的原始压缩包。
+- `latex/paper-en/`：未经翻译的英文源码。
+- `latex/paper-zh/`：保持可编译性的中文源码副本。
+- `paper-en/<paper-name>-en.pdf`：英文原版编译结果。
+- `paper-zh/<paper-name>-zh.pdf`：中文译版编译结果。
+
+`paper-name` 使用用户熟悉的简短名称并保留大小写，例如 `EST`、`Onetrans`，且只能包含英文字母、数字、点、下划线和连字符。
+
+参考文献元数据默认不翻译；原图内部文字不修改，只翻译必要 caption。公式内的英文说明按“公式不变”原则保留。
+
+## 内置工具
+
+```bash
+# 创建并输出固定的论文产物路径
+python3 skills/arxiv-paper-zh/scripts/prepare_output_layout.py EST --root arxiv-paper
+
+# 统计文件并生成均衡翻译分片
+python3 skills/arxiv-paper-zh/scripts/inventory_and_shard.py arxiv-paper/EST/latex/paper-zh --entry main.tex --workers 3 --json
+
+# 检查预装包和论文专用宏包
+python3 skills/arxiv-paper-zh/scripts/prepare_tex_runtime.py arxiv-paper/EST/latex/paper-zh --preset --kpsewhich /path/to/kpsewhich
+
+# 扫描可能漏译的英文自然语言
+python3 skills/arxiv-paper-zh/scripts/audit_tex_translation.py arxiv-paper/EST/latex/paper-zh
+
+# 自动运行 XeLaTeX 与 BibTeX/Biber，检查构建日志
+python3 skills/arxiv-paper-zh/scripts/build_and_check.py arxiv-paper/EST/latex/paper-zh/main.tex --tex-bin /path/to/tex/bin
+```
+
+## 兼容性说明
+
+本项目遵循以 `SKILL.md` 为入口的 Agent Skills 目录格式。核心翻译与构建步骤可以跨客户端复用，但以下能力取决于具体客户端：
+
+- 是否支持自动触发 Skill。
+- 是否支持并行 subagent。
+- 是否允许网络下载与安装宏包。
+- 是否提供可写文件系统和本地 XeLaTeX。
+
+客户端不支持 subagent 时，Agent 应顺序处理分片；不影响翻译规则与构建脚本的使用。
+
+## 发布前检查
+
+```bash
+python3 -m py_compile skills/arxiv-paper-zh/scripts/*.py
+python3 /path/to/skill-creator/scripts/quick_validate.py skills/arxiv-paper-zh
+shellcheck install.sh   # 可选
+```
+
+发布前还应选择并添加合适的开源许可证，例如 MIT、Apache-2.0 或 GPL-3.0。

package/bin/arxiv-paper-zh.mjs

@@ -0,0 +1,210 @@
+#!/usr/bin/env node
+
+import {
+  cpSync,
+  existsSync,
+  lstatSync,
+  mkdirSync,
+  readFileSync,
+  renameSync,
+  rmSync,
+} from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const SKILL_NAME = "arxiv-paper-zh";
+const PACKAGE_ROOT = fileURLToPath(new URL("../", import.meta.url));
+const SOURCE_DIR = join(PACKAGE_ROOT, "skills", SKILL_NAME);
+const PACKAGE_JSON = JSON.parse(
+  readFileSync(join(PACKAGE_ROOT, "package.json"), "utf8"),
+);
+
+function usage() {
+  process.stdout.write(`Usage: arxiv-paper-zh [install] [options]
+
+Install the ${SKILL_NAME} Agent Skill.
+
+Options:
+  --all           Install for Codex, Claude Code, and generic Agent Skills
+  --codex         Install for Codex
+  --claude        Install for Claude Code
+  --agents        Install in the generic .agents/skills directory
+  --project PATH  Install at project scope instead of user scope
+  --force         Replace an existing installation
+  -h, --help      Show this help
+  -v, --version   Show the package version
+
+With no target option, Codex and Claude Code are selected.
+`);
+}
+
+function fail(message) {
+  process.stderr.write(`error: ${message}\n`);
+  process.exitCode = 1;
+}
+
+function pathExists(path) {
+  try {
+    lstatSync(path);
+    return true;
+  } catch (error) {
+    if (error?.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+}
+
+function parseArgs(argv) {
+  const args = [...argv];
+  if (args[0] === "install") {
+    args.shift();
+  }
+
+  const options = {
+    agents: false,
+    claude: false,
+    codex: false,
+    force: false,
+    project: null,
+  };
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    switch (arg) {
+      case "--all":
+        options.agents = true;
+        options.claude = true;
+        options.codex = true;
+        break;
+      case "--agents":
+        options.agents = true;
+        break;
+      case "--claude":
+        options.claude = true;
+        break;
+      case "--codex":
+        options.codex = true;
+        break;
+      case "--force":
+        options.force = true;
+        break;
+      case "--project":
+        index += 1;
+        if (index >= args.length) {
+          throw new Error("--project requires a path");
+        }
+        options.project = resolve(args[index]);
+        break;
+      case "-h":
+      case "--help":
+        usage();
+        return null;
+      case "-v":
+      case "--version":
+        process.stdout.write(`${PACKAGE_JSON.version}\n`);
+        return null;
+      default:
+        throw new Error(`unknown option: ${arg}`);
+    }
+  }
+
+  if (!options.agents && !options.claude && !options.codex) {
+    options.claude = true;
+    options.codex = true;
+  }
+  return options;
+}
+
+function destinations(options) {
+  const paths = [];
+  if (options.project) {
+    if (!existsSync(options.project)) {
+      throw new Error(`project path does not exist: ${options.project}`);
+    }
+    if (options.codex || options.agents) {
+      paths.push(join(options.project, ".agents", "skills", SKILL_NAME));
+    }
+    if (options.claude) {
+      paths.push(join(options.project, ".claude", "skills", SKILL_NAME));
+    }
+  } else {
+    const userHome = homedir();
+    if (options.codex) {
+      const codexRoot = process.env.CODEX_HOME
+        ? resolve(process.env.CODEX_HOME)
+        : join(userHome, ".codex");
+      paths.push(join(codexRoot, "skills", SKILL_NAME));
+    }
+    if (options.claude) {
+      paths.push(join(userHome, ".claude", "skills", SKILL_NAME));
+    }
+    if (options.agents) {
+      paths.push(join(userHome, ".agents", "skills", SKILL_NAME));
+    }
+  }
+  return [...new Set(paths)];
+}
+
+function install(destination, force) {
+  const parent = dirname(destination);
+  mkdirSync(parent, { recursive: true });
+
+  if (pathExists(destination) && !force) {
+    throw new Error(
+      `destination already exists: ${destination} (use --force to replace it)`,
+    );
+  }
+
+  const suffix = `${process.pid}-${Date.now()}`;
+  const temporary = join(parent, `.${SKILL_NAME}.tmp-${suffix}`);
+  const backup = join(parent, `.${SKILL_NAME}.backup-${suffix}`);
+  let backedUp = false;
+
+  try {
+    cpSync(SOURCE_DIR, temporary, { recursive: true, errorOnExist: true });
+    if (pathExists(destination)) {
+      renameSync(destination, backup);
+      backedUp = true;
+    }
+    renameSync(temporary, destination);
+    if (backedUp) {
+      rmSync(backup, { recursive: true, force: true });
+    }
+  } catch (error) {
+    rmSync(temporary, { recursive: true, force: true });
+    if (backedUp && !pathExists(destination)) {
+      renameSync(backup, destination);
+    }
+    throw error;
+  }
+
+  process.stdout.write(`installed: ${destination}\n`);
+}
+
+try {
+  if (!existsSync(join(SOURCE_DIR, "SKILL.md"))) {
+    throw new Error(`packaged skill is missing: ${SOURCE_DIR}`);
+  }
+  const options = parseArgs(process.argv.slice(2));
+  if (options) {
+    const targets = destinations(options);
+    if (!options.force) {
+      const existing = targets.find(pathExists);
+      if (existing) {
+        throw new Error(
+          `destination already exists: ${existing} (use --force to replace it)`,
+        );
+      }
+    }
+    for (const destination of targets) {
+      install(destination, options.force);
+    }
+    process.stdout.write(
+      "Installation complete. Start a new agent session if the skill is not detected immediately.\n",
+    );
+  }
+} catch (error) {
+  fail(error.message);
+}

package/install.sh

@@ -0,0 +1,105 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SKILL_NAME="arxiv-paper-zh"
+REPO_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)"
+SKILL_DIR="$REPO_DIR/skills/$SKILL_NAME"
+PROJECT_DIR=""
+INSTALL_CODEX=0
+INSTALL_CLAUDE=0
+INSTALL_AGENTS=0
+
+usage() {
+  printf '%s\n' \
+    "Usage: ./install.sh [--all] [--codex] [--claude] [--agents] [--project PATH]" \
+    "" \
+    "  --all           Install for Codex, Claude Code, and generic Agent Skills" \
+    "  --codex         Install for Codex" \
+    "  --claude        Install for Claude Code" \
+    "  --agents        Install in the generic .agents/skills directory" \
+    "  --project PATH  Install at project scope instead of user scope" \
+    "  -h, --help      Show this help"
+}
+
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --all)
+      INSTALL_CODEX=1
+      INSTALL_CLAUDE=1
+      INSTALL_AGENTS=1
+      ;;
+    --codex) INSTALL_CODEX=1 ;;
+    --claude) INSTALL_CLAUDE=1 ;;
+    --agents) INSTALL_AGENTS=1 ;;
+    --project)
+      shift
+      if [ "$#" -eq 0 ]; then
+        printf 'error: --project requires a path\n' >&2
+        exit 2
+      fi
+      PROJECT_DIR="$(cd -- "$1" && pwd)"
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      printf 'error: unknown option: %s\n' "$1" >&2
+      usage >&2
+      exit 2
+      ;;
+  esac
+  shift
+done
+
+if [ "$INSTALL_CODEX" -eq 0 ] && [ "$INSTALL_CLAUDE" -eq 0 ] && [ "$INSTALL_AGENTS" -eq 0 ]; then
+  INSTALL_CODEX=1
+  INSTALL_CLAUDE=1
+fi
+
+install_link() {
+  destination="$1"
+  parent="$(dirname -- "$destination")"
+  mkdir -p -- "$parent"
+
+  if [ -L "$destination" ]; then
+    current="$(readlink "$destination")"
+    if [ "$current" = "$SKILL_DIR" ]; then
+      printf 'already installed: %s\n' "$destination"
+      return
+    fi
+  fi
+
+  if [ -e "$destination" ] || [ -L "$destination" ]; then
+    printf 'error: destination already exists: %s\n' "$destination" >&2
+    printf 'remove or rename it manually, then run this installer again.\n' >&2
+    exit 1
+  fi
+
+  ln -s -- "$SKILL_DIR" "$destination"
+  printf 'installed: %s -> %s\n' "$destination" "$SKILL_DIR"
+}
+
+if [ -n "$PROJECT_DIR" ]; then
+  if [ "$INSTALL_CODEX" -eq 1 ]; then
+    install_link "$PROJECT_DIR/.agents/skills/$SKILL_NAME"
+  fi
+  if [ "$INSTALL_CLAUDE" -eq 1 ]; then
+    install_link "$PROJECT_DIR/.claude/skills/$SKILL_NAME"
+  fi
+  if [ "$INSTALL_AGENTS" -eq 1 ]; then
+    install_link "$PROJECT_DIR/.agents/skills/$SKILL_NAME"
+  fi
+else
+  if [ "$INSTALL_CODEX" -eq 1 ]; then
+    install_link "${CODEX_HOME:-$HOME/.codex}/skills/$SKILL_NAME"
+  fi
+  if [ "$INSTALL_CLAUDE" -eq 1 ]; then
+    install_link "$HOME/.claude/skills/$SKILL_NAME"
+  fi
+  if [ "$INSTALL_AGENTS" -eq 1 ]; then
+    install_link "$HOME/.agents/skills/$SKILL_NAME"
+  fi
+fi
+
+printf '%s\n' "Installation complete. Start a new agent session if the skill is not detected immediately."

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "arxiv-paper-zh",
+  "version": "0.1.0",
+  "description": "Install the arxiv-paper-zh Agent Skill for Codex, Claude Code, and compatible agents.",
+  "type": "module",
+  "bin": {
+    "arxiv-paper-zh": "./bin/arxiv-paper-zh.mjs"
+  },
+  "files": [
+    ".codex-plugin/",
+    "bin/",
+    "skills/",
+    "install.sh",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test tests/*.test.mjs",
+    "check": "node --check bin/arxiv-paper-zh.mjs && python3 -c \"from pathlib import Path; [compile(path.read_bytes(), str(path), 'exec') for path in Path('skills/arxiv-paper-zh/scripts').glob('*.py')]\" && npm test"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yqstar/arxiv-paper-zh.git"
+  },
+  "homepage": "https://github.com/yqstar/arxiv-paper-zh#readme",
+  "bugs": {
+    "url": "https://github.com/yqstar/arxiv-paper-zh/issues"
+  },
+  "keywords": [
+    "agent-skills",
+    "arxiv",
+    "codex",
+    "claude-code",
+    "latex",
+    "translation",
+    "chinese"
+  ],
+  "author": "AndrewYq",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/skills/arxiv-paper-zh/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: arxiv-paper-zh
+description: Verify that a requested paper name, acronym, title, authors, abstract, URL, and arXiv ID identify the intended work; then rapidly download and translate its TeX source into Chinese with balanced subagent sharding, deterministic artifact paths under arxiv-paper, paired English/Chinese PDFs, cached dependencies, audits, XeLaTeX compilation, and full-page visual verification. Use when a user asks to locate and translate an arXiv or LaTeX research paper into a compilable Chinese edition, especially for ambiguous acronyms or long papers requiring parallel translation.
+---
+
+# arXiv 论文快速中文化
+
+交付保留原始数学、数据、引用和作者信息的中英文可编译源码及经过页面核验的中英文 PDF。身份正确性与译文完整性优先，但要并行执行互不依赖的阶段。
+
+## 输出目录契约
+
+将全部用户产物固定放到 `arxiv-paper/<paper-name>/`。`paper-name` 优先使用用户给出的论文简称并保留大小写，例如 `EST`、`Onetrans`；若用户只给出标题，则核验论文身份后生成简短名称。名称必须匹配 `[A-Za-z0-9][A-Za-z0-9._-]*`，不得包含空格、斜杠或 arXiv ID，除非 ID 本身就是用户指定名称。
+
+```text
+arxiv-paper/<paper-name>/
+├── latex/
+│   ├── source.tar
+│   ├── paper-en/
+│   └── paper-zh/
+├── paper-en/
+│   └── <paper-name>-en.pdf
+└── paper-zh/
+    └── <paper-name>-zh.pdf
+```
+
+`latex/paper-en/` 保存未经翻译的解压源码，`latex/paper-zh/` 保存其完整中文副本；两个 PDF 目录只保存最终交付 PDF。开始下载前先运行：
+
+```bash
+python3 scripts/prepare_output_layout.py <paper-name> --root arxiv-paper
+```
+
+以脚本输出的绝对路径为准，后续不得另建 `work/<arxiv-id>`、顶层 `paper_cn/` 或其他平行交付目录。临时渲染图、构建日志和联系表可放在论文目录下的隐藏临时目录，交付前不得混入 `paper-en/` 或 `paper-zh/`。
+
+## 共享论文翻译运行时
+
+优先复用固定位置的 TinyTeX/TeX Live，不要将运行时复制进每个论文目录。首次建立或主动刷新共享运行时时，使用内置预装清单一次检查并一次批量安装：
+
+```bash
+python3 scripts/prepare_tex_runtime.py --preset \
+  --kpsewhich <shared-tex-root>/bin/<platform>/kpsewhich \
+  --tlmgr <shared-tex-root>/bin/<platform>/tlmgr --install
+```
+
+预装清单位于 `references/paper-translation-packages.txt`，覆盖 XeLaTeX 中文排版、BibTeX/Biber、常见数学与字体、表格、算法、代码、绘图、caption，以及 ACM、IEEE、Elsevier、Springer 模板。首次安装需要联网；后续任务先离线检查，只有论文特有依赖缺失时才联网批量补装。不要安装 `scheme-full`。
+
+## 快速流水线
+
+1. 从 arXiv 摘要页或 API 核验规范化 ID、完整标题、作者、摘要、版本和日期。简称不是唯一标识。只有一个候选与用户主题高度一致时才继续，否则先让用户确认。明确告知用户“标题 + 作者 + arXiv ID”。
+2. 确定并校验 `paper-name`，运行 `scripts/prepare_output_layout.py`。从 `https://export.arxiv.org/e-print/<ID>` 下载原始压缩包到 `latex/source.tar`，解压到 `latex/paper-en/`。用主 TeX 的 `\title{}`、作者或 README 做第二次身份核验；不一致时停止。
+3. 将 `latex/paper-en/` 的全部内容完整复制到 `latex/paper-zh/`，不得产生 `latex/paper-zh/paper-en/` 额外嵌套；此后只修改中文副本。分别定位英文和中文入口文件。
+4. 立即并行启动两条路径：
+
+   - 翻译路径：按可见英文词量生成均衡文件分片；正文较多时占满可用 subagent 槽位。每个代理只能编辑明确分配的文件。
+   - 构建路径：主代理同时本地化入口/样式文件、准备中文字体并预检 TeX 依赖。不要等待翻译结束后才开始配置编译。
+
+   ```bash
+   python3 scripts/inventory_and_shard.py arxiv-paper/<paper-name>/latex/paper-zh --entry main.tex --workers 3 --json
+   python3 scripts/prepare_tex_runtime.py arxiv-paper/<paper-name>/latex/paper-zh --preset --kpsewhich /path/to/kpsewhich
+   ```
+
+5. 若依赖缺失，使用同一脚本增加 `--tlmgr /path/to/tlmgr --install`，在一次 `tlmgr` 调用中补齐预装包和论文特有包；不得逐个安装。优先复用共享运行时。只有不存在可用运行时时才在可写缓存目录安装便携 TinyTeX；不得使用 `sudo`、`scheme-full` 或完整 TeX Live collection。
+6. 主代理修改入口文件以支持 XeLaTeX 中文排版，通常使用 `\usepackage[UTF8,fontset=fandol]{ctex}`。删除仅适用于 pdfLaTeX 的 `inputenc` 和 T1 `fontenc`。本地化模板硬编码的 `Abstract`、`References`、`Keywords` 等可见字符串。
+7. 翻译所有渲染的英文自然语言：标题、摘要、正文、章节标题、列表、脚注、表头、表注和 caption。保留公式、数学符号、数值、引用键、label/ref、URL、LaTeX 结构、人名、模型名、数据集名、缩写与通行技术标识。图片只翻译必要 caption；算法/代码只翻译自然语言注释、docstring、caption 和说明。参考文献元数据默认不翻译。
+8. 子代理完成后，主代理只运行一次全局审计并人工复核全部命中；不得仅扫描顶层章节，也不得把子代理的自检当作最终证明：
+
+   ```bash
+   python3 scripts/audit_tex_translation.py arxiv-paper/<paper-name>/latex/paper-zh
+   ```
+
+9. 先使用原论文声明或兼容的构建引擎编译 `latex/paper-en/`，确保英文源码、参考文献和交叉引用收敛。再使用自动构建脚本识别 BibTeX/Biber，并完成中文 XeLaTeX 收敛：
+
+   ```bash
+   python3 scripts/build_and_check.py arxiv-paper/<paper-name>/latex/paper-zh/main.tex --tex-bin /path/to/tex/bin
+   ```
+
+   若仍报告缺包，一次批量安装全部新缺失项后重试。不得接受 LaTeX 错误、未定义引用/citation 或缺失字符。
+10. 分别低分辨率渲染中英文 PDF 的全部页面生成联系表，检查裁切、重叠、表格溢出、图片和页数；只对可疑页面高分辨率渲染。另用能正确显示 CJK 的系统 PDF 引擎抽查中文字体。Poppler 缺少 CMap 时不得把空白中文误判为正常。
+11. 将英文成品复制为 `paper-en/<paper-name>-en.pdf`，将中文成品复制为 `paper-zh/<paper-name>-zh.pdf`。回复列出完整标题、作者、arXiv ID、`latex/paper-en/`、`latex/paper-zh/` 以及两个 PDF 的绝对路径。
+
+## 并行规则
+
+- 分片前先创建 `latex/paper-zh/`，并按脚本的权重而非文件数分配。
+- 入口文件、共享宏和样式只由主代理修改；任何文件不得由两个代理同时编辑。
+- 主代理在翻译进行时完成依赖预检、字体方案和编译入口改造。
+- 共享运行时只建立一次；论文任务不得重复下载或复制相同运行时。
+- 对小论文不强制派发代理；代理启动与合并开销高于预计翻译时间时直接处理。
+
+## 完成标准
+
+- arXiv 元数据与源码身份两次核验通过，原始源码未修改。
+- 英文与中文源码分别完整位于 `latex/paper-en/` 和 `latex/paper-zh/`，原始压缩包位于 `latex/source.tar`；渲染的英文自然语言均已翻译或被人工判定为允许保留项。
+- `paper-en/<paper-name>-en.pdf` 与 `paper-zh/<paper-name>-zh.pdf` 均构建成功，参考文献和交叉引用收敛；中文版无缺字。
+- 中英文 PDF 的全部页面均已检查，中文字体由 CJK 能力正常的渲染器确认。
+
+## 方案参考
+
+本 Skill 的论文中文化方案参考了科学空间文章：[《让 AI 翻译一篇完整的论文》](https://spaces.ac.cn/archives/11578)。具体实现结合 Codex 的并行代理、依赖缓存、自动审计和 XeLaTeX 构建流程进行了调整。

package/skills/arxiv-paper-zh/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "arXiv 论文中文化"
+  short_description: "并行翻译 arXiv 论文并交付中英文源码与 PDF"
+  default_prompt: "Use $arxiv-paper-zh to verify and translate my intended paper, then save English and Chinese sources and PDFs under arxiv-paper/<paper-name>."

package/skills/arxiv-paper-zh/references/paper-translation-packages.txt

@@ -0,0 +1,53 @@
+# TeX Live package | representative file. Keep one package per line.
+latexmk|bin:latexmk
+biber|bin:biber
+ctex|ctex.sty
+xecjk|xeCJK.sty
+fandol|FandolSong-Regular.otf
+unicode-math|unicode-math.sty
+libertinus-fonts|LibertinusMath-Regular.otf
+amsmath|amsmath.sty
+amsfonts|amssymb.sty
+mathtools|mathtools.sty
+biblatex|biblatex.sty
+natbib|natbib.sty
+booktabs|booktabs.sty
+multirow|multirow.sty
+tools|tabularx.sty
+makecell|makecell.sty
+colortbl|colortbl.sty
+graphics|graphicx.sty
+xcolor|xcolor.sty
+caption|caption.sty
+subcaption|subcaption.sty
+float|float.sty
+wrapfig|wrapfig.sty
+algorithm2e|algorithm2e.sty
+algorithms|algorithm.sty
+algorithmicx|algorithmicx.sty
+listings|listings.sty
+tcolorbox|tcolorbox.sty
+pgf|tikz.sty
+tikzfill|tikzfill.image.sty
+cleveref|cleveref.sty
+hyperref|hyperref.sty
+url|url.sty
+microtype|microtype.sty
+geometry|geometry.sty
+enumitem|enumitem.sty
+setspace|setspace.sty
+l3packages|xfrac.sty
+preprint|balance.sty
+comment|comment.sty
+acmart|acmart.cls
+ieeetran|IEEEtran.cls
+elsarticle|elsarticle.cls
+llncs|llncs.cls
+newtx|newtxtext.sty
+libertine|libertine.sty
+inconsolata|inconsolata.sty
+psnfss|pifont.sty
+ifoddpage|ifoddpage.sty
+relsize|relsize.sty
+pdfcol|pdfcol.sty
+ncctools|manyfoot.sty

package/skills/arxiv-paper-zh/scripts/audit_tex_translation.py

@@ -0,0 +1,63 @@
+#!/usr/bin/env python3
+"""Inventory TeX files and flag likely untranslated English prose."""
+
+from __future__ import annotations
+
+import argparse
+import re
+from pathlib import Path
+
+
+PROSE = re.compile(r"[A-Za-z]{4,}(?:[ \t]+[A-Za-z][A-Za-z'’-]{2,}){2,}")
+COMMAND_ONLY = re.compile(r"^[ \t]*\\(?:usepackage|documentclass|input|include|addbibresource)\b")
+
+
+def tex_files(root: Path) -> list[Path]:
+    return sorted(path for path in root.rglob("*.tex") if path.is_file())
+
+
+def visible_part(line: str) -> str:
+    escaped = False
+    for index, char in enumerate(line):
+        if char == "%" and not escaped:
+            return line[:index]
+        escaped = char == "\\" and not escaped
+        if char != "\\":
+            escaped = False
+    return line
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("root", type=Path)
+    parser.add_argument("--inventory", action="store_true")
+    args = parser.parse_args()
+    root = args.root.resolve()
+    files = tex_files(root)
+    if not files:
+        parser.error(f"no .tex files below {root}")
+
+    if args.inventory:
+        for path in files:
+            count = sum(1 for _ in path.open(encoding="utf-8", errors="replace"))
+            print(f"{count:5d}  {path.relative_to(root)}")
+        return 0
+
+    hits = 0
+    for path in files:
+        for number, raw in enumerate(path.read_text(encoding="utf-8", errors="replace").splitlines(), 1):
+            line = visible_part(raw)
+            if not line.strip() or COMMAND_ONLY.match(line):
+                continue
+            if PROSE.search(line):
+                hits += 1
+                excerpt = line.strip()
+                if len(excerpt) > 220:
+                    excerpt = excerpt[:217] + "..."
+                print(f"{path.relative_to(root)}:{number}: {excerpt}")
+    print(f"suspect_lines={hits}")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/skills/arxiv-paper-zh/scripts/build_and_check.py

@@ -0,0 +1,24 @@
+#!/usr/bin/env python3
+"""Build with XeLaTeX, select BibTeX/Biber, and audit the final log."""
+from __future__ import annotations
+import argparse, re, shutil, subprocess
+from pathlib import Path
+ERROR = re.compile(r"LaTeX Error|Undefined control sequence|Emergency stop|Fatal error|undefined references|Citation .* undefined|Reference .* undefined|Missing character")
+def tool(name: str, bindir: Path | None) -> str:
+    candidate = bindir / name if bindir else None; result = str(candidate) if candidate and candidate.exists() else shutil.which(name)
+    if not result: raise SystemExit(f"missing executable: {name}")
+    return result
+def run(command: list[str], cwd: Path) -> None: print("+ " + " ".join(command)); subprocess.run(command, cwd=cwd, check=True)
+def main() -> int:
+    parser = argparse.ArgumentParser(); parser.add_argument("entry", type=Path); parser.add_argument("--tex-bin", type=Path); args = parser.parse_args()
+    entry = args.entry.resolve(); args.tex_bin = args.tex_bin.resolve() if args.tex_bin else None; cwd, stem = entry.parent, entry.stem; source = entry.read_text(encoding="utf-8", errors="replace")
+    command = [tool("xelatex", args.tex_bin), "-interaction=nonstopmode", "-halt-on-error", entry.name]; run(command, cwd)
+    if re.search(r"\\(?:usepackage(?:\[[^]]*\])?\{biblatex\}|addbibresource)", source): run([tool("biber", args.tex_bin), stem], cwd)
+    elif re.search(r"\\bibliography\s*\{", source): run([tool("bibtex", args.tex_bin), stem], cwd)
+    run(command, cwd); run(command, cwd)
+    hits = [line for line in (cwd / f"{stem}.log").read_text(encoding="utf-8", errors="replace").splitlines() if ERROR.search(line)]
+    if hits: print("\n".join(hits)); return 2
+    pdf = cwd / f"{stem}.pdf"
+    if not pdf.is_file() or not pdf.stat().st_size: print(f"missing output: {pdf}"); return 3
+    print(f"build_ok={pdf}"); return 0
+if __name__ == "__main__": raise SystemExit(main())

package/skills/arxiv-paper-zh/scripts/inventory_and_shard.py

@@ -0,0 +1,36 @@
+#!/usr/bin/env python3
+"""Inventory reachable TeX sources and greedily balance translation shards."""
+from __future__ import annotations
+import argparse, json, re
+from pathlib import Path
+INCLUDE = re.compile(r"\\(?:input|include)\s*\{([^}]+)\}")
+COMMENT = re.compile(r"(?<!\\)%.*$")
+COMMAND = re.compile(r"\\[A-Za-z@]+\*?(?:\[[^]]*\])?")
+MATH = re.compile(r"\$[^$]*\$|\\\([^)]*\\\)|\\\[[^]]*\\\]", re.S)
+def reachable(entry: Path, root: Path) -> list[Path]:
+    pending, seen = [entry.resolve()], set()
+    while pending:
+        path = pending.pop()
+        if path in seen or not path.is_file() or (root not in path.parents and path != root): continue
+        seen.add(path)
+        for value in INCLUDE.findall(path.read_text(encoding="utf-8", errors="replace")):
+            child = (path.parent / value.strip()).resolve()
+            pending.append(child if child.suffix else child.with_suffix(".tex"))
+    return sorted(seen)
+def weight(path: Path) -> int:
+    text = "\n".join(COMMENT.sub("", line) for line in path.read_text(encoding="utf-8", errors="replace").splitlines())
+    return len(re.findall(r"[A-Za-z]{2,}", COMMAND.sub("", MATH.sub("", text))))
+def main() -> int:
+    parser = argparse.ArgumentParser(); parser.add_argument("root", type=Path); parser.add_argument("--entry", type=Path); parser.add_argument("--workers", type=int, default=3); parser.add_argument("--min-weight", type=int, default=1); parser.add_argument("--json", action="store_true"); args = parser.parse_args()
+    root = args.root.resolve(); entry = (root / args.entry).resolve() if args.entry else None
+    files = reachable(entry, root) if entry else sorted(root.rglob("*.tex")); shared = {"macro.tex", "macros.tex", "commands.tex"}; records = [(p, weight(p)) for p in files if p.is_file() and p != entry and p.name.lower() not in shared]; records = [(p, score) for p, score in records if score >= args.min_weight]
+    groups = [[] for _ in range(max(1, args.workers))]; totals = [0] * len(groups)
+    for path, score in sorted(records, key=lambda item: item[1], reverse=True):
+        index = min(range(len(groups)), key=totals.__getitem__); groups[index].append((path, score)); totals[index] += score
+    payload = [{"worker": i + 1, "weight": totals[i], "files": [str(p.relative_to(root)) for p, _ in group]} for i, group in enumerate(groups)]
+    if args.json: print(json.dumps(payload, ensure_ascii=False, indent=2))
+    else:
+        for group in payload:
+            print(f"worker={group['worker']} weight={group['weight']}"); [print(f"  {p}") for p in group["files"]]
+    return 0
+if __name__ == "__main__": raise SystemExit(main())

package/skills/arxiv-paper-zh/scripts/prepare_output_layout.py

@@ -0,0 +1,45 @@
+#!/usr/bin/env python3
+"""Create the deterministic artifact layout for one translated paper."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import re
+from pathlib import Path
+
+
+SAFE_NAME = re.compile(r"^[A-Za-z0-9][A-Za-z0-9._-]*$")
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("paper_name", help="short, filesystem-safe paper name, e.g. EST or Onetrans")
+    parser.add_argument("--root", type=Path, default=Path("arxiv-paper"))
+    args = parser.parse_args()
+
+    name = args.paper_name.strip()
+    if not SAFE_NAME.fullmatch(name):
+        parser.error("paper_name must match [A-Za-z0-9][A-Za-z0-9._-]*")
+
+    paper_root = (args.root / name).resolve()
+    paths = {
+        "paper_root": paper_root,
+        "latex_root": paper_root / "latex",
+        "source_archive": paper_root / "latex" / "source.tar",
+        "latex_en": paper_root / "latex" / "paper-en",
+        "latex_zh": paper_root / "latex" / "paper-zh",
+        "pdf_en": paper_root / "paper-en" / f"{name}-en.pdf",
+        "pdf_zh": paper_root / "paper-zh" / f"{name}-zh.pdf",
+    }
+    for key in ("latex_en", "latex_zh"):
+        paths[key].mkdir(parents=True, exist_ok=True)
+    paths["pdf_en"].parent.mkdir(parents=True, exist_ok=True)
+    paths["pdf_zh"].parent.mkdir(parents=True, exist_ok=True)
+
+    print(json.dumps({key: str(value) for key, value in paths.items()}, ensure_ascii=False, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/skills/arxiv-paper-zh/scripts/prepare_tex_runtime.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python3
+"""Check or batch-install paper-translation and document-specific TeX packages."""
+from __future__ import annotations
+import argparse, os, re, shutil, subprocess
+from pathlib import Path
+
+USEPACKAGE = re.compile(r"\\usepackage(?:\[[^]]*\])?\{([^}]+)\}")
+ALIASES = {"balance": "preprint", "manyfoot": "ncctools", "tikzfill.image": "tikzfill", "xspace": "tools", "graphicx": "graphics", "pifont": "psnfss", "xfrac": "l3packages"}
+TRANSITIVE = {"algorithm2e": ["ifoddpage", "relsize"], "tcolorbox": ["tikzfill", "pdfcol"]}
+PRESET = Path(__file__).resolve().parent.parent / "references" / "paper-translation-packages.txt"
+
+def executable(value: str | None, fallback: str) -> str:
+    result = value or shutil.which(fallback)
+    if not result: raise SystemExit(f"missing executable: {fallback}")
+    path = Path(result).expanduser()
+    return os.path.abspath(path) if path.exists() else result
+
+def read_preset() -> dict[str, str]:
+    result = {}
+    for raw in PRESET.read_text(encoding="utf-8").splitlines():
+        line = raw.strip()
+        if line and not line.startswith("#"):
+            package, probe = line.split("|", 1); result[package.strip()] = probe.strip()
+    return result
+
+def main() -> int:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("root", type=Path, nargs="?")
+    parser.add_argument("--kpsewhich")
+    parser.add_argument("--tlmgr")
+    parser.add_argument("--preset", action="store_true", help="include the reusable paper-translation preset")
+    parser.add_argument("--install", action="store_true", help="install all missing packages in one tlmgr call")
+    args = parser.parse_args()
+    if not args.root and not args.preset: parser.error("provide root and/or --preset")
+    kpsewhich = executable(args.kpsewhich, "kpsewhich")
+    candidates: dict[str, str] = read_preset() if args.preset else {}
+    if args.root:
+        for path in args.root.resolve().rglob("*.tex"):
+            text = path.read_text(encoding="utf-8", errors="replace")
+            for group in USEPACKAGE.findall(text):
+                for name in (x.strip() for x in group.split(",") if x.strip()):
+                    package = ALIASES.get(name, name); candidates.setdefault(package, f"{name}.sty")
+                    for dependency in TRANSITIVE.get(name, []): candidates.setdefault(dependency, f"{dependency}.sty")
+    missing = []; tex_bin = Path(kpsewhich).resolve().parent
+    for package, probe in sorted(candidates.items()):
+        found = (tex_bin / probe.removeprefix("bin:")).exists() if probe.startswith("bin:") else bool(subprocess.run([kpsewhich, probe], capture_output=True, text=True).stdout.strip())
+        if not found: missing.append(package)
+    print(f"preset_file={PRESET}" if args.preset else "preset_file=")
+    print("checked_packages=" + " ".join(sorted(candidates)))
+    print("missing_packages=" + " ".join(missing))
+    if args.install and missing:
+        return subprocess.run([executable(args.tlmgr, "tlmgr"), "install", *missing]).returncode
+    return 0
+
+if __name__ == "__main__": raise SystemExit(main())