dela
3a322aa8dc
Add the ledger schema, class router, lint codes, ingest/build pipeline, and three work-tree examples: align derivation, superfig delegation, and supertensor delegation.
58 lines
1.9 KiB
Markdown
58 lines
1.9 KiB
Markdown
# SuperPaper
|
|
|
|
母仓库：把一篇论文编成带 ledger 的中文讲义，并把图路由到独立的子仓库。
|
|
|
|
子仓库各自保有自己的 git 历史、lint 和不变量。母仓库只编排，不往任何一个 `.sty` 里塞笔记宏。
|
|
|
|
```
|
|
superpaper/ this repo (orchestration)
|
|
├── DESIGN.md family spec
|
|
├── SKILL.md document-layer skill
|
|
├── superfig/ submodule — architecture / pipeline / flow
|
|
├── supertensor/ submodule — tensor faces / axes / shards
|
|
└── superderive/ later — stepwise rewrite figures
|
|
```
|
|
|
|
| 子仓库 | 画什么 | 远程 |
|
|
|---|---|---|
|
|
| [`superfig`](superfig/) | 节点、边、分组、机制框图 | `carrydela/SuperFig` |
|
|
| [`supertensor`](supertensor/) | 形状对齐的张量公式图 | `carrydela/SuperTensor` |
|
|
| `superderive` | 逐步代数改写图 | 尚未建 |
|
|
|
|
## Clone
|
|
|
|
```bash
|
|
git clone --recurse-submodules \
|
|
ssh://git@ssh.gitea.mygoband.com:2222/carrydela/SuperPaper.git
|
|
# 已有工作副本：
|
|
git submodule update --init --recursive
|
|
```
|
|
|
|
Each child is also a standalone skill. Point an agent at `superfig/` or
|
|
`supertensor/` when you only need that figure grammar. Point at this
|
|
directory when the job is 读论文 / 脉络 / 推导 / 出图路由.
|
|
|
|
## Layout on disk
|
|
|
|
Under `/home/carry/myprj/tools/skills/` the old sibling paths are
|
|
symlinks into this repo:
|
|
|
|
```
|
|
skills/superpaper/ SuperPaper
|
|
skills/superfig -> superpaper/superfig
|
|
skills/supertensor -> superpaper/supertensor
|
|
```
|
|
|
|
## Status
|
|
|
|
v1 notes scaffold is in this repo: ledger schema, router, lint, ingest,
|
|
and three `--work` examples (`excerpt-toy`, `pipeline-delegate`,
|
|
`tensor-delegate`). `superderive` is still phase 2.
|
|
|
|
```bash
|
|
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
|
|
./scripts/preflight.sh
|
|
./scripts/test.sh
|
|
./scripts/build.sh --work examples/excerpt-toy
|
|
```
|