diff --git a/ViperBTests/ViperZipfileProject/.gitignore b/ViperBTests/ViperZipfileProject/.gitignore
new file mode 100644
index 0000000..6817232
--- /dev/null
+++ b/ViperBTests/ViperZipfileProject/.gitignore
@@ -0,0 +1,13 @@
+*.o
+*.obj
+*.exe
+*.img
+*.iso
+**/__pycache__/
+.cache/
+*.pyc
+
+# 编译
+**/output/
+**/temp/
+**/.tpv_build/
\ No newline at end of file
diff --git a/ViperBTests/ViperZipfileProject/App/main.vp b/ViperBTests/ViperZipfileProject/App/main.vp
new file mode 100644
index 0000000..764e51e
--- /dev/null
+++ b/ViperBTests/ViperZipfileProject/App/main.vp
@@ -0,0 +1,259 @@
+# main.vp — ViperZipfileProject:zipfile 模块读写测试
+#
+# 覆盖:
+# 1) ZipFile("w") 写入 4 个成员(deflate 文本 / deflate 大文件 / stored 伪随机 / 空文件)
+# 2) ZipFile("r") 读回: 成员数/名称/大小/compress_size 检查 + 逐成员内容比对
+# (CRC32 校验由 zipfile.read 内部完成)
+# 3) 损坏 stored 成员 payload 1 字节 → 再次 read 应返回 None 且错误码 ZIP_ERR_CRC
+import t, c
+from stdint import *
+import stdio
+import stdlib
+import string
+import zipfile
+import w32.fileio as fio
+import w32.win32file as wf
+
+
+ZIP_PATH: str = "zip_roundtrip.zip"
+BIG_LEN: t.CSizeT = 100000
+RND_LEN: t.CSizeT = 5000
+HELLO_TEXT: str = "Hello, Viper Zipfile!\n"
+
+fail_count: t.CInt = 0
+
+
+def chk(name: str, cond: t.CInt):
+ global fail_count
+ if cond:
+ stdio.printf("[PASS] %s\n", name)
+ else:
+ fail_count += 1
+ stdio.printf("[FAIL] %s\n", name)
+
+
+def StrLen(s: bytes) -> t.CSizeT:
+ n: t.CSizeT = 0
+ while s is not None and c.Deref(s) != 0:
+ n += 1
+ s += 1
+ return n
+
+
+def fill_pattern(buf: bytes, length: t.CSizeT, kind: t.CInt):
+ i: t.CSizeT = 0
+ while i < length:
+ if kind == 1:
+ # 'A'..'G' 循环 — 高度可压缩
+ buf[i] = 65 + (i % 7)
+ else:
+ # 伪随机 — 供 ZIP_STORED 成员
+ buf[i] = (i * 37 + 11) & 0xFF
+ i += 1
+
+
+def WriteZip() -> t.CInt:
+ stdio.printf("\n--- 1) 写 zip(4 个成员) ---\n")
+ wf.DeleteFileA(ZIP_PATH)
+ w: zipfile.ZipFile | t.CPtr = zipfile.ZipFile(ZIP_PATH, "w", zipfile.ZIP_DEFLATED)
+ if w.ok == 0:
+ stdio.printf("open(w) failed: %s\n", zipfile.error())
+ return 1
+
+ hello: bytes = stdlib.malloc(64)
+ if not hello:
+ stdio.printf("malloc hello failed\n")
+ w.close()
+ return 1
+ string.strcpy(hello, HELLO_TEXT)
+ hello_len: t.CSizeT = StrLen(hello)
+
+ big: bytes = stdlib.malloc(BIG_LEN)
+ if not big:
+ stdio.printf("malloc big failed\n")
+ stdlib.free(hello)
+ w.close()
+ return 1
+ fill_pattern(big, BIG_LEN, 1)
+
+ rnd: bytes = stdlib.malloc(RND_LEN)
+ if not rnd:
+ stdio.printf("malloc rnd failed\n")
+ stdlib.free(hello)
+ stdlib.free(big)
+ w.close()
+ return 1
+ fill_pattern(rnd, RND_LEN, 0)
+
+ rc: t.CInt = w.write("hello.txt", hello, hello_len, zipfile.ZIP_DEFLATED)
+ chk("write hello.txt (deflate)", rc == zipfile.ZIP_ERR_OK)
+ rc = w.write("big.bin", big, BIG_LEN, zipfile.ZIP_DEFLATED)
+ chk("write big.bin (deflate, 100000B)", rc == zipfile.ZIP_ERR_OK)
+ rc = w.write("random.bin", rnd, RND_LEN, zipfile.ZIP_STORED)
+ chk("write random.bin (stored)", rc == zipfile.ZIP_ERR_OK)
+ rc = w.write("empty.txt", None, 0, zipfile.ZIP_DEFLATED)
+ chk("write empty.txt (deflate, 0B)", rc == zipfile.ZIP_ERR_OK)
+ rc = w.close()
+ chk("close(w)", rc == zipfile.ZIP_ERR_OK)
+
+ stdlib.free(hello)
+ stdlib.free(big)
+ stdlib.free(rnd)
+ return 0
+
+
+def CheckReadBack(buf: bytes, expect: bytes, length: t.CSizeT) -> t.CInt:
+ # buf: zipfile.read 返回的解压缓冲;expect: 期望内容
+ if buf is None:
+ return 0
+ if length == 0:
+ return 1
+ return t.CInt(string.memcmp(buf, expect, length) == 0)
+
+
+def ReadZip() -> t.CInt:
+ stdio.printf("\n--- 2) 读回校验 ---\n")
+ r: zipfile.ZipFile | t.CPtr = zipfile.ZipFile(ZIP_PATH, "r")
+ if r.ok == 0:
+ stdio.printf("open(r) failed: %s\n", zipfile.error())
+ return 1
+
+ chk("entry count == 4", r.info_count == 4)
+ i: t.CSizeT = 0
+ while i < r.info_count:
+ stdio.printf(" [%d] %s\n", t.CInt(i), r.namelist_at(i))
+ i += 1
+
+ # ---- hello.txt:deflate 文本 ----
+ info: zipfile.ZipInfo | t.CPtr = r.getinfo("hello.txt")
+ chk("getinfo(hello.txt)", info is not None)
+ hello_expect: bytes = stdlib.malloc(64)
+ string.strcpy(hello_expect, HELLO_TEXT)
+ exp_len: t.CSizeT = StrLen(hello_expect)
+ if info is not None:
+ chk("hello file_size == 22", info.file_size == exp_len)
+ chk("hello compress_size > 0", info.compress_size > 0)
+ olen: t.CSizeT = 0
+ data: bytes = r.read("hello.txt", c.Addr(olen))
+ chk("read(hello.txt)", data is not None)
+ chk("hello content match", CheckReadBack(data, hello_expect, olen) == 1)
+ stdlib.free(data)
+ stdlib.free(hello_expect)
+
+ # ---- big.bin:deflate 大文件 ----
+ info = r.getinfo("big.bin")
+ chk("getinfo(big.bin)", info is not None)
+ big_expect: bytes = stdlib.malloc(BIG_LEN)
+ fill_pattern(big_expect, BIG_LEN, 1)
+ if info is not None:
+ chk("big file_size == 100000", info.file_size == BIG_LEN)
+ chk("big compress_size < file_size", info.compress_size < info.file_size)
+ chk("big crc != 0", info.crc32 != 0)
+ olen = 0
+ data = r.read("big.bin", c.Addr(olen))
+ chk("read(big.bin)", data is not None)
+ chk("big content match", data is not None and olen == BIG_LEN
+ and CheckReadBack(data, big_expect, BIG_LEN) == 1)
+ stdlib.free(data)
+ stdlib.free(big_expect)
+
+ # ---- random.bin:stored ----
+ info = r.getinfo("random.bin")
+ chk("getinfo(random.bin)", info is not None)
+ rnd_expect: bytes = stdlib.malloc(RND_LEN)
+ fill_pattern(rnd_expect, RND_LEN, 0)
+ if info is not None:
+ chk("random file_size == 5000", info.file_size == RND_LEN)
+ chk("random stored: compress_size == file_size", info.compress_size == info.file_size)
+ olen = 0
+ data = r.read("random.bin", c.Addr(olen))
+ chk("read(random.bin)", data is not None)
+ chk("random content match", data is not None and olen == RND_LEN
+ and CheckReadBack(data, rnd_expect, RND_LEN) == 1)
+ stdlib.free(data)
+ stdlib.free(rnd_expect)
+
+ # ---- empty.txt:空成员 ----
+ info = r.getinfo("empty.txt")
+ chk("getinfo(empty.txt)", info is not None)
+ olen = 0
+ data = r.read("empty.txt", c.Addr(olen))
+ chk("read(empty.txt) ok", data is not None)
+ chk("empty length == 0", olen == 0)
+ stdlib.free(data)
+
+ # ---- 不存在成员 ----
+ olen = 0
+ data = r.read("no_such.txt", c.Addr(olen))
+ chk("read(missing) returns None", data is None)
+ chk("read(missing) code NOT_FOUND", zipfile.error_code() == zipfile.ZIP_ERR_NOT_FOUND)
+
+ rc: t.CInt = r.close()
+ chk("close(r)", rc == zipfile.ZIP_ERR_OK)
+ return 0
+
+
+def CorruptStoredCheck() -> t.CInt:
+ stdio.printf("\n--- 3) 损坏 stored 成员后 CRC 校验 ---\n")
+ r: zipfile.ZipFile | t.CPtr = zipfile.ZipFile(ZIP_PATH, "r")
+ if r.ok == 0:
+ stdio.printf("open(r) failed: %s\n", zipfile.error())
+ return 1
+ info: zipfile.ZipInfo | t.CPtr = r.getinfo("random.bin")
+ chk("getinfo(random.bin)", info is not None)
+ if info is None or info.compress_size < 2:
+ stdio.printf("cannot locate stored member payload\n")
+ r.close()
+ return 1
+
+ # 本地头无 extra 时,数据起点 = header_offset + 30 + 名字长
+ start: t.CSizeT = t.CSizeT(info.header_offset) + 30 + info.name_len
+ flip_pos: t.CSizeT = start + info.compress_size - 1
+ stdio.printf(" flip byte at offset %lld (raw)\n", flip_pos)
+
+ f: fio.File | t.CPtr = fio.File(ZIP_PATH, fio.MODE.RP)
+ chk("open RP", f.closed == 0)
+ if f.closed == 0:
+ byte_buf: bytes = stdlib.malloc(1)
+ if not byte_buf:
+ r.close()
+ return 1
+ f.seek(LONG(flip_pos), fio.SEEK_SET)
+ rd: LONG = f.read(byte_buf, 1)
+ chk("read back byte", rd == 1)
+ f.seek(LONG(flip_pos), fio.SEEK_SET)
+ byte_buf[0] = (byte_buf[0] ^ 0xFF) & 0xFF
+ wr: LONG = f.write(byte_buf, 1)
+ chk("flip byte written", wr == 1)
+ f.close()
+ stdlib.free(byte_buf)
+ r.close()
+
+ z2: zipfile.ZipFile | t.CPtr = zipfile.ZipFile(ZIP_PATH, "r")
+ chk("reopen after corruption", z2.ok == 1)
+ olen: t.CSizeT = 0
+ data: bytes = z2.read("random.bin", c.Addr(olen))
+ chk("corrupted read returns None", data is None)
+ chk("error code == ZIP_ERR_CRC", zipfile.error_code() == zipfile.ZIP_ERR_CRC)
+ stdio.printf(" last error: %s\n", zipfile.error())
+ if data is not None:
+ stdlib.free(data)
+ z2.close()
+ return 0
+
+
+@t.CExport
+def main() -> int:
+ stdio.printf("ViperZipfileProject: zipfile 模块读写测试\n")
+ if WriteZip() != 0:
+ return 1
+ if ReadZip() != 0:
+ return 1
+ if CorruptStoredCheck() != 0:
+ return 1
+
+ wf.DeleteFileA(ZIP_PATH)
+ stdio.printf("\n失败数: %d\n", fail_count)
+ if fail_count == 0:
+ stdio.printf("全部通过\n")
+ return t.CInt(fail_count != 0)
diff --git a/ViperBTests/ViperZipfileProject/LICENSE b/ViperBTests/ViperZipfileProject/LICENSE
new file mode 100644
index 0000000..cee2f62
--- /dev/null
+++ b/ViperBTests/ViperZipfileProject/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TermiNexus
+
+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.
diff --git a/ViperBTests/ViperZipfileProject/README.md b/ViperBTests/ViperZipfileProject/README.md
new file mode 100644
index 0000000..e1fe40f
--- /dev/null
+++ b/ViperBTests/ViperZipfileProject/README.md
@@ -0,0 +1,289 @@
+# Viper Template Project
+
+[English](#english) | [中文](#中文)
+
+A minimal, ready-to-use template for bootstrapping a new [Viper](../wiki/01-overview.md) language project on **Windows (x86_64-pc-windows-gnu)**.
+
+Windows 平台(x86_64-pc-windows-gnu)下 [Viper](../wiki/01-overview.md) 语言新项目的最小可用模板。
+
+---
+
+
+
+## 中文
+
+### 这是什么
+
+`ViperTemplateProject` 是基于 `Viper` 语言的 **Windows 桌面应用模板**。克隆本仓库后,你可以立即得到一个能够:
+
+- 设置 Windows 控制台为 UTF-8 编码(避免中文乱码)
+- 打印一行 `你好,世界`
+- 通过 `llc + clang++`(mingw 工具链)编译为原生 `app.exe`
+
+的最小 Viper 项目。
+
+模板对应的语言编译器是 [TransPyC](https://git.gvsds.com/GVSDS/TransPyC);关于 Viper 语言本身的概览,参见 [TransPyC 仓库 wiki](../wiki/01-overview.md)。
+
+### 目录结构
+
+```
+ViperTemplateProject/
+├── .gitignore # 忽略 build/、*.o、*.exe、缓存等
+├── README.md # 本文件
+├── project.vpj # 项目配置(编译器、链接器、目标三元组等)
+└── App/
+ └── main.py # 入口文件
+```
+
+### 前提条件
+
+| 工具 | 说明 |
+|------|------|
+| `python` ≥ 3.10 | 用于运行 TransPyC 编译器 |
+| `llc` | LLVM 静态编译器,编译 `.ll` → `.o` |
+| `clang++` | mingw 工具链下的链接驱动(`x86_64-w64-mingw32`) |
+| `TransPyC` 仓库 | 本编译器,克隆在 `ViperTemplateProject/..` 同一目录下 |
+
+环境变量建议(PowerShell):
+
+```powershell
+$env:PATH = "D:\msys64\mingw64\bin;D:\LLVM\bin;$env:PATH"
+```
+
+### 快速开始
+
+```powershell
+# 1. 确保目录布局正确
+# D:\Users\TermiNexus\Desktop\TransPyC\
+# ├── TransPyC\ # 编译器仓库
+# └── ViperTemplateProject\ # 本仓库
+
+cd D:\Users\TermiNexus\Desktop\TransPyC\ViperTemplateProject
+
+# 2. 编译并运行
+python ..\TransPyC\Projectrans.py `
+ --project .\project.vpj `
+ --clean-cache=false
+
+# 3. 产物位于 output\app.exe
+.\output\app.exe
+```
+
+预期输出:
+
+```
+你好,世界
+```
+
+### 编写你的第一个程序
+
+打开 `App/main.py`,替换 `print("你好,世界")` 为任意合法 Viper 表达式。例如:
+
+```python
+import w32.win32console as w32cmd
+import t, c
+
+pagecode: t.CDefine = 65001
+
+@t.CExport
+def main() -> int:
+ w32cmd.SetConsoleOutputCP(pagecode)
+ w32cmd.SetConsoleCP(pagecode)
+
+ # 你的代码从这里开始
+ a: t.CInt = 1
+ b: t.CInt = 2
+ print("a + b =", a + b)
+
+ return 0
+```
+
+### 修改项目配置
+
+打开 `project.vpj`,按需调整:
+
+| 字段 | 含义 | 模板默认值 |
+|------|------|-----------|
+| `name` | 项目名(仅显示用) | `Standard Template Project` |
+| `source_dir` | 源文件根目录 | `./App` |
+| `temp_dir` | 中间产物目录(`.pyi` / `.stub.ll`) | `./temp` |
+| `output_dir` | 最终产物目录 | `./output` |
+| `compiler.cmd` | 汇编器 | `llc` |
+| `compiler.flags` | 传给 `llc` 的参数 | `["-filetype=obj", "-relocation-model=pic"]` |
+| `linker.cmd` | 链接器 | `clang++` |
+| `linker.flags` | 链接器参数 | mingw 标准库 + `kernel32` |
+| `linker.output` | 产物名 | `app.exe` |
+| `includes` | 标准库搜索路径 | `["../includes"]` |
+| `target.triple` | LLVM 目标三元组 | `x86_64-pc-windows-gnu` |
+| `target.datalayout` | LLVM 数据布局 | mingw 默认 |
+| `options.target` | 后端目标 | `llvm` |
+| `options.strict_mode` | 严格类型检查 | `true` |
+| `options.slice_level` | 切片级别 | `3` |
+
+### 跨平台使用
+
+本模板默认针对 **Windows + mingw**。若需在其他平台使用,修改 `project.vpj` 的 `compiler.cmd` / `linker.cmd` / `target.triple`:
+
+- **Linux (x86_64)**:`triple = "x86_64-unknown-linux-gnu"`,`linker.cmd = "clang++"`
+- **macOS (x86_64)**:`triple = "x86_64-apple-darwin*"`,`linker.cmd = "clang++"`
+- **裸机 x86_64 (ViperOS)**:`triple = "x86_64-none-elf"`,`linker.cmd = "ld.lld"`,需要 `isr.s` 启动文件
+
+### 常见问题
+
+**Q: 报错 `cannot find includes/os` / `cannot find includes/atom` 之类?**
+A: 检查 `project.vpj` 中的 `includes` 字段是否指向 `TransPyC/includes`。`../includes` 假设本仓库与 `TransPyC` 仓库同级。
+
+**Q: 输出 `app.exe` 双击闪退?**
+A: 在终端中运行 `.\output\app.exe` 而非双击,并确认 mingw 与 LLVM 在 `PATH` 中。
+
+**Q: 想完全清理构建产物?**
+A: 使用 `python ..\TransPyC\Projectrans.py --project .\project.vpj --clean-cache` 清理缓存;删除 `output/` 和 `temp/` 即可彻底重置。
+
+**Q: `StandardTemplateProject` 和本仓库是什么关系?**
+A: 本仓库 `ViperTemplateProject` 是 `StandardTemplateProject` 的独立仓库版本。如果你仍想保留 `StandardTemplateProject` 放在 `TransPyC` 仓库内,只需把它加入 `TransPyC/.gitignore` 的 `# 排除独立仓库的目录` 小节。
+
+### 进一步阅读
+
+- [Viper 语言概览](../wiki/01-overview.md)
+- [类型系统](../wiki/02-type-system.md)
+- [OOP 与对象模型](../wiki/06-oop.md)
+- [自举路线图](../wiki/13-bootstrapping.md)
+
+---
+
+
+
+## English
+
+### What is this
+
+`ViperTemplateProject` is a **Windows desktop application template** based on the [Viper](../wiki/01-overview.md) language. After cloning, you immediately have a minimal Viper project that:
+
+- Sets the Windows console to UTF-8 (avoids mojibake for non-ASCII output)
+- Prints `你好,世界`
+- Compiles to a native `app.exe` via `llc + clang++` (mingw toolchain)
+
+The corresponding compiler is [TransPyC](https://git.gvsds.com/GVSDS/TransPyC). For a Viper language overview, see the [TransPyC wiki](../wiki/01-overview.md).
+
+### Directory layout
+
+```
+ViperTemplateProject/
+├── .gitignore # ignores build/, *.o, *.exe, caches, etc.
+├── README.md # this file
+├── project.vpj # project config (compiler, linker, target triple, ...)
+└── App/
+ └── main.py # entry point
+```
+
+### Prerequisites
+
+| Tool | Notes |
+|------|-------|
+| `python` ≥ 3.10 | runs the TransPyC compiler |
+| `llc` | LLVM static compiler, `.ll` → `.o` |
+| `clang++` | mingw toolchain driver (`x86_64-w64-mingw32`) |
+| `TransPyC` repo | the compiler, cloned as a sibling of `ViperTemplateProject` |
+
+Suggested `PATH` (PowerShell):
+
+```powershell
+$env:PATH = "D:\msys64\mingw64\bin;D:\LLVM\bin;$env:PATH"
+```
+
+### Quick start
+
+```powershell
+# 1. Make sure the layout is right
+# D:\Users\TermiNexus\Desktop\TransPyC\
+# ├── TransPyC\ # compiler repo
+# └── ViperTemplateProject\ # this repo
+
+cd D:\Users\TermiNexus\Desktop\TransPyC\ViperTemplateProject
+
+# 2. Build and run
+python ..\TransPyC\Projectrans.py `
+ --project .\project.vpj `
+ --clean-cache=false
+
+# 3. Output is at output\app.exe
+.\output\app.exe
+```
+
+Expected output:
+
+```
+你好,世界
+```
+
+### Writing your first program
+
+Open `App/main.py` and replace `print("你好,世界")` with any valid Viper expression. Example:
+
+```python
+import w32.win32console as w32cmd
+import t, c
+
+pagecode: t.CDefine = 65001
+
+@t.CExport
+def main() -> int:
+ w32cmd.SetConsoleOutputCP(pagecode)
+ w32cmd.SetConsoleCP(pagecode)
+
+ # your code goes here
+ a: t.CInt = 1
+ b: t.CInt = 2
+ print("a + b =", a + b)
+
+ return 0
+```
+
+### Editing project.vpj
+
+| Field | Meaning | Template default |
+|-------|---------|------------------|
+| `name` | display name | `Standard Template Project` |
+| `source_dir` | source root | `./App` |
+| `temp_dir` | intermediate artifacts (`.pyi` / `.stub.ll`) | `./temp` |
+| `output_dir` | final artifacts | `./output` |
+| `compiler.cmd` | assembler | `llc` |
+| `compiler.flags` | flags passed to `llc` | `["-filetype=obj", "-relocation-model=pic"]` |
+| `linker.cmd` | linker | `clang++` |
+| `linker.flags` | linker flags | mingw stdlib + `kernel32` |
+| `linker.output` | output name | `app.exe` |
+| `includes` | standard library search paths | `["../includes"]` |
+| `target.triple` | LLVM target triple | `x86_64-pc-windows-gnu` |
+| `target.datalayout` | LLVM data layout | mingw default |
+| `options.target` | backend target | `llvm` |
+| `options.strict_mode` | strict type checking | `true` |
+| `options.slice_level` | slice level | `3` |
+
+### Cross-platform use
+
+This template targets **Windows + mingw** by default. To use on another platform, adjust `compiler.cmd` / `linker.cmd` / `target.triple` in `project.vpj`:
+
+- **Linux (x86_64)**: `triple = "x86_64-unknown-linux-gnu"`, `linker.cmd = "clang++"`
+- **macOS (x86_64)**: `triple = "x86_64-apple-darwin*"`, `linker.cmd = "clang++"`
+- **Bare-metal x86_64 (ViperOS)**: `triple = "x86_64-none-elf"`, `linker.cmd = "ld.lld"`, requires `isr.s` startup
+
+### FAQ
+
+**Q: Error like `cannot find includes/os` or `cannot find includes/atom`?**
+A: Check that the `includes` field in `project.vpj` points to the `TransPyC/includes` directory. `../includes` assumes this repo lives next to `TransPyC`.
+
+**Q: `app.exe` flashes and closes on double-click?**
+A: Run `.\output\app.exe` from a terminal, not by double-clicking. Make sure mingw and LLVM are on `PATH`.
+
+**Q: How to fully clean build artifacts?**
+A: `python ..\TransPyC\Projectrans.py --project .\project.vpj --clean-cache` clears the cache. To reset everything, also delete `output/` and `temp/`.
+
+**Q: What is the relationship with `StandardTemplateProject`?**
+A: This repo `ViperTemplateProject` is the standalone-repo version of `StandardTemplateProject`. If you still want `StandardTemplateProject` to live inside the `TransPyC` repo, add it to the `# 排除独立仓库的目录` section in `TransPyC/.gitignore`.
+
+### Further reading
+
+- [Viper language overview](../wiki/01-overview.md)
+- [Type system](../wiki/02-type-system.md)
+- [OOP and object model](../wiki/06-oop.md)
+- [Bootstrapping roadmap](../wiki/13-bootstrapping.md)
diff --git a/ViperBTests/ViperZipfileProject/project.vpj b/ViperBTests/ViperZipfileProject/project.vpj
new file mode 100644
index 0000000..92f3018
--- /dev/null
+++ b/ViperBTests/ViperZipfileProject/project.vpj
@@ -0,0 +1,37 @@
+{
+ "name": "ViperZipfileProject - zipfile 模块测试",
+ "version": "1.0.0",
+ "source_dir": "./App",
+ "build_dir": "./.tpv_build",
+ "compiler": {
+ "cmd": "llc",
+ "flags": [
+ "-filetype=obj",
+ "-relocation-model=pic"
+ ]
+ },
+ "linker": {
+ "cmd": "clang++",
+ "flags": [
+ "-lmsvcrt",
+ "-lucrt",
+ "-lpthread",
+ "-lmingwex",
+ "-lkernel32",
+ "-Wl,--allow-multiple-definition"
+ ],
+ "output": "app.exe"
+ },
+ "includes": [
+ "../../includes"
+ ],
+ "target": {
+ "triple": "x86_64-pc-windows-gnu",
+ "datalayout": "e-m:w-p270:32:32-p271:32:32-p272:64:64-i64:64-f80:128-n8:16:32:64-S128"
+ },
+ "options": {
+ "slice_level": 3,
+ "target": "llvm",
+ "strict_mode": true
+ }
+}
\ No newline at end of file