# Vort 本地化编译器与开发工具链 SDK (Vort Localization SDK)

欢迎使用 Vort 本地化开发工具链。本 SDK 包含了开发和运行 Vort 脚本所需的全部核心组件，供本地化开发人员快速集成和分发。

## 目录结构说明

```
vort-sdk/
├── bin/                       # 编译器及运行时二进制目录
│   ├── vort.js                # Vort 单文件编译器可执行文件 (CLI & LSP 服务端)
│   └── wasm-core/             # Rust 原生 WASM 排版引擎字节码
│       └── pkg/
│           ├── wasm_core_bg.wasm
│           └── wasm_core.js
├── vscode-extension/          # VS Code 语法高亮与 LSP 插件开发包目录
└── README.md                  # 本说明文档
```

## 快速上手使用

### 1. 初始化本地化项目
进入您的翻译工作空间，运行以下命令一键初始化翻译记忆库、风格指南和工作流脚本模板：
```bash
node bin/vort.js init [目标目录]
```

### 2. 静态语法校验
编写完 `.vort` 脚本后，无需实际调用 API 即可进行语法静态诊断：
```bash
node bin/vort.js check <脚本路径.vort>
```

### 3. 执行文件翻译
运行翻译任务流程：
```bash
node bin/vort.js <脚本路径.vort> <输入待译文件> <输出译文文件> [目标语言]
```
*例如：*
```bash
node bin/vort.js bin/translate_docx.vort document.docx output_en.docx English
```

## 端到端流式渲染预览 (Streaming Recipient)

本版本新增了对 **所见即所得流式翻译预览** 的原生支持：
1. **行高与排版动态计算**：在并发执行 LLM 翻译期间，Vort 运行时会基于字符长度实时计算段落边界与仿真布局高度。
2. **增量预览写入 (.preview)**：运行时无需等待全文翻译返回，即会一边流式吐出译文 Token，一边将更新后的排版内容增量保存到 `[output_path].preview`。
3. **Stdout 流式日志规范**：运行时会自动向控制台输出 `[Streaming Recipient: Recalculating Layout] Segment #i -> Height: Hpx | Text: "..."` 格式的标准流式日志，Tauri 宿主端可以直接通过捕获子进程的 stdout 管道来刷新前端所见即所得的打字机特效。

## 编辑器配置与集成 (VS Code)

本 SDK 内置了对 VS Code 的开发环境对接支持：
1. **安装依赖**：进入 `vscode-extension/` 目录运行 `npm install` 下载 LSP 客户端库。
2. **本地加载或打包**：
   - 可以将 `vscode-extension/` 整个目录移动到 VS Code 扩展目录（Windows 下通常为 `~/.vscode/extensions/vscode-vort`）下重启 VS Code 使用。
   - 或者，在 `vscode-extension/` 目录下运行 `npx vsce package`，即可编译打包出一个单独的 `.vsix` 扩展离线安装包，方便在开发团队内部分发安装。
3. **功能激活**：在 VS Code 中打开任意 `.vort` 后缀的脚本，插件即会自动激活：
   - 自动开启语法高亮。
   - 后台自动运行 `bin/vort.js lsp`，提供实时错误红线（Linter）、代码自动补全和内置算子鼠标悬停说明。
