academic-workspace

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Academic Workspace — Project Management

学术工作区——项目管理

Overview

概述

The workspace at
/workspace/
is a persistent volume that survives container restarts. Use it for all user data: projects, notebooks, output files.
位于
/workspace/
的工作区是一个持久化卷,可在容器重启后保留数据。请将所有用户数据(项目、笔记本、输出文件)存储在此处。

Directory Structure

目录结构

/workspace/
├── projects/          # Research projects (one directory per project)
│   └── my-paper/
│       ├── main.tex
│       ├── sections/
│       ├── figures/
│       ├── references.bib
│       └── Makefile
├── notebooks/         # Jupyter notebooks
│   └── analysis.ipynb
├── output/            # Compiled PDFs, plots, results
│   ├── paper.pdf
│   └── figure1.png
├── skills/            # Academic skills (auto-managed)
└── .openclaw/         # OpenClaw configuration (auto-managed)
/workspace/
├── projects/          # Research projects (one directory per project)
│   └── my-paper/
│       ├── main.tex
│       ├── sections/
│       ├── figures/
│       ├── references.bib
│       └── Makefile
├── notebooks/         # Jupyter notebooks
│   └── analysis.ipynb
├── output/            # Compiled PDFs, plots, results
│   ├── paper.pdf
│   └── figure1.png
├── skills/            # Academic skills (auto-managed)
└── .openclaw/         # OpenClaw configuration (auto-managed)

When To Use

使用场景

  • User starts a new research project
  • User asks to organize files or set up a project structure
  • User needs paper templates
  • 用户启动新的研究项目时
  • 用户请求整理文件或搭建项目结构时
  • 用户需要论文模板时

Create a New Project

创建新项目

LaTeX paper project

LaTeX论文项目

bash
PROJECT="/workspace/projects/my-paper"
mkdir -p "$PROJECT"/{sections,figures}
bash
PROJECT="/workspace/projects/my-paper"
mkdir -p "$PROJECT"/{sections,figures}

Create main.tex

Create main.tex

cat > "$PROJECT/main.tex" << 'TEX' \documentclass[11pt]{article} \usepackage[utf8]{inputenc} \usepackage{amsmath,amssymb} \usepackage{graphicx} \usepackage{hyperref} \usepackage[style=numeric,backend=biber]{biblatex} \addbibresource{references.bib}
\title{Paper Title} \author{Author Name} \date{\today}
\begin{document} \maketitle
\input{sections/abstract} \input{sections/introduction} \input{sections/method} \input{sections/experiments} \input{sections/conclusion}
\printbibliography \end{document} TEX
cat > "$PROJECT/main.tex" << 'TEX' \documentclass[11pt]{article} \usepackage[utf8]{inputenc} \usepackage{amsmath,amssymb} \usepackage{graphicx} \usepackage{hyperref} \usepackage[style=numeric,backend=biber]{biblatex} \addbibresource{references.bib}
\title{Paper Title} \author{Author Name} \date{\today}
\begin{document} \maketitle
\input{sections/abstract} \input{sections/introduction} \input{sections/method} \input{sections/experiments} \input{sections/conclusion}
\printbibliography \end{document} TEX

Create section stubs

Create section stubs

for sec in abstract introduction method experiments conclusion; do echo "\section{$(echo $sec | sed 's/.*/\u&/')}" > "$PROJECT/sections/$sec.tex" echo "% TODO: Write $sec" >> "$PROJECT/sections/$sec.tex" done
for sec in abstract introduction method experiments conclusion; do echo "\section{$(echo $sec | sed 's/.*/\u&/')}" > "$PROJECT/sections/$sec.tex" echo "% TODO: Write $sec" >> "$PROJECT/sections/$sec.tex" done

Create empty bibliography

Create empty bibliography

cat > "$PROJECT/references.bib" << 'BIB' % Bibliography — add entries here % Example: % @article{key2024, % author = {Last, First}, % title = {Title}, % journal = {Journal}, % year = {2024}, % } BIB
cat > "$PROJECT/references.bib" << 'BIB' % Bibliography — add entries here % Example: % @article{key2024, % author = {Last, First}, % title = {Title}, % journal = {Journal}, % year = {2024}, % } BIB

Create Makefile for easy compilation

Create Makefile for easy compilation

cat > "$PROJECT/Makefile" << 'MAKE' all: main.pdf
main.pdf: main.tex sections/*.tex references.bib pdflatex -interaction=nonstopmode main.tex biber main pdflatex -interaction=nonstopmode main.tex pdflatex -interaction=nonstopmode main.tex cp main.pdf /workspace/output/
clean: rm -f *.aux *.bbl *.bcf *.blg *.log *.out *.run.xml *.toc *.pdf
.PHONY: all clean MAKE
echo "Project created at: $PROJECT"
undefined
cat > "$PROJECT/Makefile" << 'MAKE' all: main.pdf
main.pdf: main.tex sections/*.tex references.bib pdflatex -interaction=nonstopmode main.tex biber main pdflatex -interaction=nonstopmode main.tex pdflatex -interaction=nonstopmode main.tex cp main.pdf /workspace/output/
clean: rm -f *.aux *.bbl *.bcf *.blg *.log *.out *.run.xml *.toc *.pdf
.PHONY: all clean MAKE
echo "Project created at: $PROJECT"
undefined

Python data analysis project

Python数据分析项目

bash
PROJECT="/workspace/projects/analysis"
mkdir -p "$PROJECT"/{data,results,figures}

cat > "$PROJECT/README.md" << 'MD'
bash
PROJECT="/workspace/projects/analysis"
mkdir -p "$PROJECT"/{data,results,figures}

cat > "$PROJECT/README.md" << 'MD'

Data Analysis Project

Data Analysis Project

Structure

Structure

  • data/
    — raw and processed datasets
  • results/
    — analysis outputs
  • figures/
    — generated plots
  • analysis.py
    — main analysis script MD
echo "Project created at: $PROJECT"
undefined
  • data/
    — raw and processed datasets
  • results/
    — analysis outputs
  • figures/
    — generated plots
  • analysis.py
    — main analysis script MD
echo "Project created at: $PROJECT"
undefined

Available Templates

可用模板

When creating a LaTeX project, ask the user which template they prefer:
TemplateUse caseEngine
article
General paperspdflatex
article-zh
Chinese papersxelatex
beamer
Presentations/slidespdflatex
ieee
IEEE conference formatpdflatex
Check available templates:
curl -sf http://localhost:8080/templates | jq .
创建LaTeX项目时,请询问用户偏好的模板类型:
TemplateUse caseEngine
article
General paperspdflatex
article-zh
Chinese papersxelatex
beamer
Presentations/slidespdflatex
ieee
IEEE conference formatpdflatex
查看可用模板:
curl -sf http://localhost:8080/templates | jq .

Compile a Project

编译项目

bash
cd /workspace/projects/my-paper
make              # Uses Makefile
bash
cd /workspace/projects/my-paper
make              # Uses Makefile

or manually:

or manually:

pdflatex main.tex && biber main && pdflatex main.tex && pdflatex main.tex
undefined
pdflatex main.tex && biber main && pdflatex main.tex && pdflatex main.tex
undefined

Tips

小贴士

  • Always save outputs to
    /workspace/output/
    — the web UI can display PDFs from there.
  • Keep projects self-contained: all deps inside the project directory.
  • Use Makefiles for reproducible compilation.
  • Git is available for version control:
    cd /workspace/projects/my-paper && git init
    .
  • 请始终将输出文件保存到
    /workspace/output/
    ——Web界面可从此处展示PDF文件。
  • 保持项目独立:所有依赖项都放在项目目录内。
  • 使用Makefile实现可复现的编译流程。
  • 可使用Git进行版本控制:
    cd /workspace/projects/my-paper && git init
    .