# yzj-text
**Repository Path**: yzj-developer/yzj-text
## Basic Information
- **Project Name**: yzj-text
- **Description**: 椰子鸡文本编辑器
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-12
- **Last Updated**: 2026-11-02
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
YText
面向开发人员的轻量级桌面文本编辑器 · 1.0.7 · Windows
Tauri v2 · Rust 内核 · SolidJS · CodeMirror 6
---
**2 GB 的日志打得开、搜得动;从 Windows 改完的 shell 脚本传回 Linux 能直接跑。**
这两件事是 YText 存在的理由,其余的是一个日常编辑器该有的样子。
## 它能做什么
### 打开什么都不卡
| 文件多大 | 打开成什么 |
|---|---|
| 8 MB 以下 | 常规编辑器,带语法高亮;**但最长一行 ≥ 100 KB(压成一行的 JSON 那种)也关高亮**,仍可编辑、保存、格式化 |
| 8 MB – 200 MB | 仍可编辑,**关掉语法高亮**(词法分析的成本比托管文本高两个数量级) |
| 200 MB 以上,或内存预算不够 | **只读查看器**,只读横幅会说清原因和出路 |
| 图片 | 图片预览(经 `asset:` 协议由 WebView 自己解码,不走 base64) |
| 二进制 | **不打开**,给一条提示,并留着「仍以文本打开」 |
路由在打开时一次定死(`crates/yzj-core/src/router.rs` 是全系统唯一的模式判断点),
中途不切换 —— 要换模式就是关掉重开。
只读查看器是给日志用的:流式建索引(2 GB 约 0.46 s,建的同时就能滚),
Rust 流式搜索、边搜边亮,跳到行号 / **跳到字节偏移**,跟随尾部(手动往上滚就自动关掉跟随),
超长单行横向滚动,以及唯一的写出口 **「另存筛选结果」** —— 把全部命中行写成新文件,
不受结果列表 5000 条的显示上限约束。文件在后台增长、被截断、被删,都有对应的反馈。
GB 级文件**不做**原地编辑(决策 D3)。
### 编码与换行符是两个独立的开关
- **12 种编码**:UTF-8、UTF-8 with BOM、UTF-16 LE / BE(带 BOM 与不带 BOM 各一个条目)、
GBK、GB18030、Big5、Shift_JIS、EUC-KR、Windows-1252;打开时自动检测,推测出来的会标「推测」。
- **检测不只看开头**:开头全是英文时往后找第一个非 ASCII 字节再判;能在编辑器里打开的文件读入时顺带整份校验,
猜的 UTF-8 在后面解不下去,就换成对的编码打开(只换多字节的老编码,且要整份无损),并告诉你是从第几行起换的。
- **换行符**:LF / CRLF / CR;混合换行会被指出来,并能看到各类的行数。
- **规则优先级**(首次命中即生效):本文档的手动设置 → `.editorconfig` → 工作区规则 → 全局默认。
手动设置与规则冲突时,保存前确认一次,而不是悄悄覆盖。
- 规则声明的编码**也参与读入**,但有门槛:能把文件无损解出来才按它读。utf-8 仓库里的一份老 GBK 文件
照旧按 GBK 正确打开;保存时要按规则转成 UTF-8,会先问一句 —— 磁盘编码是猜的,猜错的话这一存就把乱码写进去了。
- **内置规则只收「换行符错了就跑不起来」的那几类**:`*.sh` `*.bash` `*.zsh` `*.fish`、
`Makefile` `*.mk`、`Dockerfile` 一律 LF —— CRLF 会让 shebang 变成 `/bin/bash^M`。
### 编辑
- 30 多门语言的语法高亮(官方 Lezer 语法 + `legacy-modes` 覆盖长尾),**一门语言一个 chunk、用到才拉**
- 代码折叠,折叠状态跨重启(连文件印记一起存,证明不了文件没变就一段都不折)
- **格式化文档**(Shift+Alt+F):JSON / JSONC、CSS / LESS / SCSS、XML、SQL。
为什么不支持 JS/TS、HTML、YAML、Markdown,理由逐条写在 `src/format/index.ts` 的 `NO_FORMATTER` 里
- 命令面板(Ctrl+Shift+P)、顶部菜单栏、亮 / 暗两套主题与代码主题切换
### Markdown
- 三种模式:纯编辑 / 双栏 / 纯渲染(Ctrl+Shift+V),**每个文档各记各的**
- 双栏滚动同步;预览里的链接可点、本地图片能显示
- **导出为 HTML**:一个自带全部内容的文件(图片进 `data:` URI),不跟随导出者的主题,
不留任何本地路径;双击打开再 Ctrl+P 就是 PDF
- 渲染在沙箱 iframe 里,经 DOMPurify 消毒并受 CSP 约束;**远程图片默认不加载**
(一份别人写的文档不该能往外发请求),所在文件夹被信任后经 Rust 代理拉取(只认 https 的图片);
内嵌脚本无论信不信任都消毒
### HTML 预览
- `.html` 同样有三种模式;内容从编辑器内存出,未保存的改动也看得到;相对路径的 CSS / JS / 图片
在资源根(所在工作区根,不在工作区时为文件所在目录)内加载,越界与指向外部的符号链接一律不给
- **默认不跑页面脚本、不加载远程资源**;「信任此文件夹」(含子目录,可随时撤销,
命令面板「已信任的文件夹…」统一管理)后放开脚本与 https 资源,**fetch / XHR / WebSocket 始终禁止**
- 预览帧是 `sandbox="allow-scripts"` 的独立源(自定义协议 `ytpreview`),**不加 `allow-same-origin`** ——
门禁实测加了它子帧就能调到宿主命令,见 [ADR-001](.document/adr/adr-001-preview-protocol.md)
### 工作区与文件树
- 多根工作区,可命名存档、随时切换;根可以是文件夹也可以是单个文件
- 文件树上 **git 改动高亮**(M / A / U / D / C,目录向上卷),保存后立即刷新;机器上没装 git 时这个功能静默不存在
- 右键菜单:新建文件(先是草稿,保存时才落盘)、新建文件夹、重命名、移出工作区(只对根,磁盘上不动)、删除(**进回收站**,且先确认)
- Ctrl / Shift 点击多选;选中几个根后右键或按 Delete 一次移出(先确认)
- 拖放:从系统拖进窗口即打开,树内拖动即移动,拖进文件夹即复制
- 「在文件树中定位」(Alt+L),不抢编辑器焦点;目录展开状态跨重启
- 标签右键六种关法;侧边栏可拖宽,标签条可横向滚动
### 不丢东西
- **Hot exit**:未保存的修改在退出甚至崩溃之后都还在,下次启动原样恢复
- 会话恢复:打开的标签、光标 / 滚动位置、手动选过的编码、折叠、树的展开状态
- 文件被外部改动:干净的文档自动重载;有未保存修改的给**三选一**,不是一句「保存失败」
- **读入时有字节解不出来**(比如编码判错了):打开时就说清几处、第一处在第几行,保存前再拦一次 ——
原样保存会把那些字节永久换成替换字符 U+FFFD,这一类损坏不会报任何错
- 「有未保存的修改」**按内容判断**:打一个字再撤回,就又是干净的;保存之后再改,照样算未保存
- **设了只读属性的文件**(微信等收到的文件都带):状态栏标出「只读属性」,保存时问一句「取消只读并保存」,
不是一句「保存失败」;其他写不进去的情况说清原因(没有写入权限或被占用、磁盘满)
- 保存**保留原文件的权限与属性**:`chmod +x` 的脚本存完照样能跑,`0600` 的文件不会变宽,隐藏 / 系统属性还在
- 所有删除动作都先确认,并共用同一道闸
### 融入系统
- 安装器把 YText 注册为「打开方式」的**候选**,**不抢任何扩展名的默认打开程序**
(想设成默认,在「打开方式」里自己勾一下);设成默认之后,资源管理器里的**文件类型照旧**(「TXT 文件」),不会被改名
- 单实例:再次「用 YText 打开」的文件交给已经开着的窗口,并收进工作区
- 自绘标题栏
### 隐私
整个应用**只有一处**主动往外发请求:启动时检查一次有没有新版本。
在设置里写 `"checkUpdate": false` 即可关掉(「关于」里的手动检查不受影响)。
只提示、不自动下载安装;下载地址必须与更新端点同源,不同源时按钮置灰并说明原因。
## 安装
目前只出 **Windows x64 的 NSIS 安装包**:`YText_<版本>_x64-setup.exe`。
Windows 11 自带 WebView2;Windows 10 上缺 WebView2 时安装器会引导安装。
> 安装包与 `latest.json` 发布在 rustfs 的 `public/yzj-text/` 目录:
> (`src-tauri/src/main.rs` 的 `UPDATE_ENDPOINT`)。
> **1.0.7 起**的版本才会去那里检查更新;更早的版本编进去的是占位地址,要手动装一次新版。
> **安装包还没有代码签名,目前只用文件传输分发**(2026-10-10 起)。从 rustfs **下载**的安装包会在安装时被拦,
> 而且拦截会记在那个文件上:1.0.7 下载过一次之后,同一个文件再直接传过去也装不了;内容相同、文件不同的 1.0.8
> 直接传就能装。证书本身没问题(Let's Encrypt,信任链完整)—— 拦的是「未签名 + 下载来源没有信誉」。
> 所以 rustfs 上的 `latest.json` 停在 1.0.7,不提示大家去下一个装不上的包;签名之后再恢复下载渠道。
平台优先级(决策 D1):Windows 一等公民,macOS 跟随,Linux best-effort 且不作发布门禁。
## 快捷键
| 键 | 动作 |
|---|---|
| Ctrl+Shift+P | 命令面板 |
| Ctrl+N | 新建文件 |
| Ctrl+O | 打开文件 |
| Ctrl+K | 打开文件夹 |
| Ctrl+S | 保存 |
| Ctrl+W | 关闭标签 |
| Ctrl+Tab / Ctrl+Shift+Tab | 下一个 / 上一个标签 |
| Ctrl+F | 搜索(编辑器与只读查看器各有各的) |
| F3 / Shift+F3 | 下一个 / 上一个命中(只读查看器) |
| Ctrl+G | 跳到行 |
| Ctrl+Shift+G | 跳到字节偏移(只读查看器) |
| Esc | 取消正在进行的索引 / 搜索(只读查看器) |
| Shift+Alt+F | 格式化文档 |
| Ctrl+Shift+V | 切换 Markdown 预览模式 |
| Alt+L | 在文件树中定位当前文件 |
| Ctrl+, | 打开设置 |
| Ctrl+Z / Ctrl+Y | 撤销 / 重做 |
应用级键位**一律带 Ctrl / Alt 修饰**,裸字母不做全局键位 —— 编辑器里那些字母是正文。
编辑器自己处理掉的按键不再往上派发,谁先谁后的判据是「离焦点近的先」。
## 设置
Ctrl+, 会**在编辑器里打开 `settings.json`** —— 目标用户是开发人员,改一行 JSON 比一个设置界面快。
```json
{
"version": 1,
"workspaceRules": [
{ "glob": "*.py", "eol": "lf" },
{ "glob": "*.bat", "eol": "crlf", "charset": "gbk" }
],
"checkUpdate": true
}
```
- 这是**纯 JSON,不能写注释**
- `workspaceRules` 追加在内置规则之后,同一个 glob 你写的赢
- `eol`:`lf` / `crlf` / `cr`;`charset`:`utf-8` `utf-8-bom` `utf-16le` `utf-16be` `gbk` `gb18030` `big5` `shift_jis` `euc-kr` `windows-1252` 等
- 写错的那一条会被跳过并**明确告诉你是哪一条、错在哪**,不会让整份设置失效;
整份文件解析失败时本次用默认值运行,**原文件不覆盖**
- 内置规则不能「关掉」,只能用一条同名 glob 覆盖(关掉等于鼓励踩那个坑)
用户数据都在 `%APPDATA%\dev.yzj.text\` 下:
| 文件 | 内容 |
|---|---|
| `settings.json` | 设置(你写的) |
| `session.json` | 会话(应用替你记的:标签、位置、折叠、展开状态) |
| `workspaces.json` | 命名的工作区存档 |
| `hot-exit\` | 未保存修改的备份 |
目录名来自 `identifier`,它**没有跟着应用改名**,也不该改 —— 改了之后升级上来的用户,
设置、会话和未保存的备份会全部「消失」,而且不报错。
## 开发
### 环境
- Node 22、pnpm 10(版本钉在 `package.json` 的 `packageManager`)
- Rust stable ≥ 1.85,带 clippy
- Windows 上需要 WebView2(Windows 11 自带)
先装依赖:
```bash
pnpm install
```
只动前端时开回归台(不需要 Rust):
```bash
pnpm dev
```
要真窗口、真后端:
```bash
pnpm app:dev
```
`pnpm app:dev` 报 `program not found` 的话,是 `cargo` 不在 PATH 里(rustup 装的时候没写),
在 PowerShell 里先执行一次 `$env:PATH = "$env:USERPROFILE\.cargo\bin;$env:PATH"`。
### 三个跑得起来的地方
| 入口 | 是什么 | 什么时候用 |
|---|---|---|
| `pnpm dev` → http://localhost:5173 | **契约回归台**:全部组件与业务流程,接的是替身后端(`src/preview/fakeBackend.ts`),不需要 Rust | 日常开发、组件与交互 |
| `pnpm dev` → `/shell-probe.html` | 在**真正的 document** 上挂外壳 | 验窗口级布局 —— 回归台把外壳装在一个盒子里,看不见它自己的布局问题 |
| `pnpm app:dev` | 真窗口 + 真后端 | 验 IPC、文件系统、CSP、窗口 API —— 很多问题只在这里出现 |
### 命令
| 命令 | 作用 |
|---|---|
| `pnpm dev` | 契约回归台 |
| `pnpm app:dev` | 真窗口开发(`tauri dev`) |
| `pnpm package` | 打安装包:先清空 `target/release/bundle/nsis`,再 `tauri build`,再生成 `latest.json` |
| `pnpm manifest` | 只重新生成 `latest.json`(更新说明走环境变量 `RELEASE_NOTES`) |
| `pnpm release:tag` | 发出去之后给这个版本打 `v<版本>` 附注 tag 并推到 origin;`--dry-run` 只查不打 |
| `pnpm build` | 前端生产构建(会先重新生成图标 sprite) |
| `pnpm build:icons` | 从 Phosphor 抽取图标 → sprite + 类型 |
| `pnpm typecheck` | `tsc --noEmit` |
| `pnpm lint` | ESLint(含设计系统与 i18n 的执行规则) |
| `pnpm test` | 前端:契约断言 + 组件测试 |
| `pnpm rs:lint` | `cargo clippy --workspace --all-targets -- -D warnings` |
| `pnpm rs:test` | `cargo test --workspace` |
| `pnpm check` | typecheck · lint · test · rs:lint · rs:test 五项一起跑,提交前跑它 |
报「全绿」之前看**退出码**,不看摘要行。
### 打包与发布
1. **改版本号**:`src-tauri/tauri.conf.json`、`package.json`、根 `Cargo.toml` 的 `[workspace.package]`,
三处必须一致(`tests/contracts/version.test.ts` 盯着)。**内容变了就要升** —— 同版本号、不同内容的两个安装包,
关于对话框与检查更新都分不出来
2. 从**合并后的 master** 打:`pnpm package` → `target/release/bundle/nsis/` 下只有当次的 `YText_<版本>_x64-setup.exe` 与 `latest.json`
(每次先清空,是因为并排放几个只差前缀的安装包,已经导致装错过一次)。打之前关掉开在那个目录上的资源管理器窗口,
否则清目录那一步报 `EBUSY`
3. **签名之前:只用文件传输分发,不往 rustfs 传**(见上面「安装」一节的说明)。**也别拿正式包去试下载** ——
一个文件被拦过一次就废了,之后怎么传都装不了,只能升版本号重打。
签名之后:把这两个文件传到 rustfs 的 `public` 桶、`yzj-text/` 目录:**先传安装包,最后覆盖 `latest.json`** ——
反过来的话,中间点「下载」的人拿到 404。`latest.json` 里的下载地址是**按端点拼出来**的,同源在生成时就成立
4. 传完从真实地址核对:`latest.json` 与本地逐字节相同、安装包的 sha256 与本地一致
5. 换过端点、证书或桶权限之后,手动跑一次真实网络的那条检查(走的是生产那条 `fetch_update`):
`cargo test -p yzj-text-app -- --ignored --nocapture net_spike`
6. **发出去、核对过之后打 tag**:`pnpm release:tag`(tag 说明同样取 `RELEASE_NOTES`,没有就写 `YText <版本>`)。
它先查六件事,有一件不满足就一个都不打:在 master 上、`HEAD` 与 `origin/master` 一致、版本号三处一致、
`v<版本>` 本地与远端都还没有、安装包在、构建输入路径(`src` `src-tauri` `crates` `public` `scripts` 与几份配置)
**没有改动也没有未跟踪文件** —— 否则包里有、tag 上却没有。推送失败时本地 tag 留着,再跑一次就只推不建。
它**不挂进 `pnpm package`**:打包成功不等于发出去了,试打包也不该留下 tag
安装包只打 NSIS(`"targets": ["nsis"]` 是显式写死的,不吃默认的 `"all"` —— 那会连 MSI 一起打,
而 MSI 需要在第一次构建时现下载 WiX)。
## 架构
```
src/ SolidJS 前端
│ app/ 业务装配 · editor/ CM6 · render/ Markdown 与 HTML 预览 · format/ 格式化
│ ui/ 自研组件库 · state/ 状态 · services/ipc.ts 唯一的 IPC 出口
│
│ invoke ↓ ↑ event
│
src-tauri/ Tauri 壳:命令注册 · dto · session · hotexit · registry · preview(预览协议)
│
crates/yzj-core/ 纯 Rust 内核,不依赖 Tauri
router 打开路由(唯一的模式判断点)
fileservice 唯一的文件访问口
charset · eol · editorconfig · rules 编码与换行
index · slice · search · export 大文件:索引、切片、搜索、导出
fsops · name 文件操作与文件名校验
git · image · binary git 状态、图片与二进制识别
settings · workspace · archive 设置、工作区、命名存档
update · budget · embed 检查更新、内存预检、导出时内嵌图片
preview · trust 预览协议的路径解析与 CSP、已信任文件夹
```
- **双模式的切口在文档类型**,不在缓冲区内部:`TextDocument` 与 `LargeFileView` 不共享 trait,
打开时由 `router` 一次性路由。前端按判别联合消费,不是到处写条件分支。
- **文件访问收敛在 `fileservice`** 一个模块里(决策 D4:不做远程 SSH,也不预留抽象)。
- 只有只读查看器在 Rust 侧留状态(文件句柄 + 行索引,见 `src-tauri/src/registry.rs`);
索引、搜索、导出、检查更新都是「命令立刻返回、结果走事件」同一个形状。
- 跨语言的真源有三处,各有契约对账:`charset.rs ↔ charset.ts`、版本号三处、
`name.rs ↔ entryName.ts`(行为,靠 `.document/fixtures/entry-name-cases.json` 共享用例表)。
### 目录
```
crates/yzj-core/ Rust 内核(tests/large_file.rs 在 GB 级语料上跑)
src-tauri/ Tauri 壳 · capabilities · nsis/hooks.nsh(打开方式注册)
src/
├─ app/ 外壳与业务装配(标题栏、菜单、侧边栏、各类视图与对话框)
├─ editor/ CM6:语言表 · 主题 · 格式化结果的最小改动写回
├─ render/ Markdown 管线 · 预览沙箱 · HTML 预览帧与桥接脚本 · 滚动同步 · 导出 HTML
├─ format/ 按扩展名派发格式化器(prettier / sql-formatter 全部懒加载)
├─ state/ 文档 · 工作区 · 设置 · git 状态
├─ services/ ipc.ts · 编码表 · 文件名校验的前端副本
├─ commands/ 命令注册表 · 键位派发
├─ ui/ 自研组件库(kbd / primitives / layout / nav / overlay / feedback / data)
├─ styles/ tokens.css(唯一真源)· base.css · fonts.css
├─ i18n/ t() + Intl 格式化 + 字典
├─ icons/ sprite 与类型(构建产物,入库)
├─ a11y/ 对比度与焦点(测试与回归台共用同一份实现)
├─ brand/ 应用图标源文件
├─ preview/ 契约回归台与替身后端
└─ testing/ 测试夹具与 mock 派生
tests/contracts/ 31 条契约
scripts/ 图标构建 · latest.json 生成
spike/ 阶段 0 可行性门禁的一次性验证代码(不进工作区,只为可复现)
```
## 几条不该被绕过的约定
这些不是建议,都有**机制**在守:违反了会在 `pnpm check` 里红掉。
| 约定 | 守它的机制 |
|---|---|
| 颜色只能来自 token,组件里不许出现 hex | ESLint `no-restricted-syntax` |
| 所有展示文案走 i18n key,不许裸中文 | ESLint `no-restricted-syntax` |
| 不许解构 props(会静默丢响应性) | `solid/reactivity`、`solid/no-destructure` 设为 error |
| 文本对比度 ≥ 4.5:1,控件边界 ≥ 3:1,两套主题逐对断言 | `contrast.test.ts` |
| 每个 `var(--x)` 都有定义;间距只取刻度;动效只有一个真源 | `cssVars` · `spacing` · `motion` |
| 图标 sprite 与 manifest 一致,清单里不许有没用到的图标 | `icons.test.ts`(`build-icons --check`) |
| 文件树的类型图标与编辑器的高亮说同一件事 | `language.test.ts` |
| 禁用态一律 `aria-disabled` + 原因,不用原生 `disabled` | `src/ui/primitives/disabledReason.tsx` 是唯一实现 |
| Toast 同键合并、error 永不自动消失、暂停可恢复 | `toast.test.ts` |
| 字体栈必须含中文字体面,不许打包 CJK、不许请求外部字体 | `fonts.test.ts` |
| 声明了 overflow 就必须声明对应方向的 scroll-padding | `scroll.test.ts` |
| 焦点顺序不许被无声改动 | `focusOrder.test.ts` 与 `src/ui/a11y.test.tsx` 的**入库文本快照** |
| CSP、窗口 API 的授权、IPC 参数名、设置 schema 前后端一致 | `csp` · `capabilities` · `ipcArgs` · `settings` |
| 预览帧不许带 `allow-same-origin`;主窗口 `frame-src` / `img-src` 不许放 `https:` | `previewProtocol` · `csp` |
| 应用名四处一致、版本号三处一致、`identifier` 不改 | `appName` · `version` |
| 格式化器不许在 src 里静态 import;prettier 版本钉死 | `format.test.ts` |
| 更新端点与下载地址同源,前后端对账 | `update.test.ts` |
| 周期性的、搬大文本的命令不在主线程上跑(`#[tauri::command(async)]`) | `ipcArgs.test.ts` 的「必须 async」清单 |
| 高亮阈值(8 MB、单行 100 KB)前端副本与 `router.rs` 一致 | `thresholds.test.ts` |
以上全部在 [`.github/workflows/ci.yml`](.github/workflows/ci.yml) 里跑:前端检查在 ubuntu,
Rust 在 **windows-latest**(发布平台那条 `#[cfg]` 分支必须被测到)。
加功能之前先翻一遍 `tests/contracts/` —— 多半已经有一条在管你要动的那件事。
## 体积
1.0.7,2026-10-10 的生产构建(与 1.0.6 相比,启动 JS 多了 2.3 KB —— 只读属性的保存与对话框;按需加载那部分一个字节没变)。
| 产物 | 大小 |
|---|---:|
| 安装包 `YText_1.0.7_x64-setup.exe` | 4.4 MB |
| `YText.exe`(前端资源已嵌入) | 14.8 MB |
| 前端 | 原始 | gzip |
|---|---:|---:|
| 启动即加载的 JS(9 个 chunk,含 CM6 核心) | 721.0 KB | 244.9 KB |
| CSS | 48.6 KB | 9.6 KB |
| 字体(6 个 woff2,仅 latin 子集) | 132.7 KB | — |
| 按需加载(40 个 chunk) | 1 916.7 KB | 603.1 KB |
| 其中格式化器(prettier + 插件 + sql-formatter) | 1 175.3 KB | 323.6 KB |
本地应用没有网络传输,gzip 那一列只作跨版本比较的参照;影响启动的是原始体积(解析量)。
怎么量的(下一版照这个量才比得上):「启动即加载」= `dist/index.html` 引的入口,加上入口里 `__vite__mapDeps`
给 App 那条路径列的预加载 chunk(`Harness` 是回归台,不算);其余 JS 都是按需加载;格式化器是
`standalone`、`babel`、`estree`、`postcss`、`plugin`、`esm`(sql-formatter)六个。gzip 用 Node `zlib` 第 9 级,
1 KB = 1024 字节。**1.0.6 及之前的 gzip 数是另一种量法量的**(原始体积对得上、gzip 对不上,方法没记下来),
与这一版起的不能直接比。
- **语言语法一门一个 chunk**:一辈子不开 `.php` 的人从不为 php 付一个字节,所以语言表可以随便加长 ——
它的成本在安装体积上,不在启动时间上。
- **格式化器只在第一次按 Shift+Alt+F 时拉**,契约盯着 src 里不许静态 import 它们。
- **CM6 核心有意不拆**:算过账,本地应用多解析的那部分是十几毫秒,换来的是一整圈异步边界。
- 中文走系统字体,不打包。
## 无障碍
- **只有 Toast 是 live region。** 状态栏刻意不是 —— 行列号每次按键都在变,做成 live region
就是对读屏用户的持续轰炸。Toast 内分 `polite` 与 `assertive` 两个区,两个容器都常驻 DOM
(读屏只播报已存在的 live region 里的变化)。
- **焦点顺序走入库的文本快照**,不走可视化:谁改了焦点顺序,谁的 PR 里就会出现那个 diff。
它写完当场抓到过两个真问题(命令面板输入框没有可访问名;标签的可访问名把状态读在名字前面)。
- **高对比度**:`@media (forced-colors: active)` 的适配在 `src/styles/base.css` 末尾,
只靠背景色表意的元素(脏标记、进度填充、滚动条拇指、搜索命中)已逐一处理。它无法在页面内模拟,
回归台只做检测与指引(Windows 设置 → 辅助功能 → 对比度主题)。
- **缩放**:回归台顶部有 100 / 125 / 150% 切换,用 `zoom` 而非 `transform`,会真的参与布局 ——
Windows 笔记本默认就是 125%,22px 行高在那里是 27.5px。
## 有意没做的
| 条目 | 理由 |
|---|---|
| GB 级文件的原地编辑 | 决策 D3:完全只读,唯一写出口是「另存筛选结果」 |
| 远程 SSH | 决策 D4:不做,也不预留抽象 |
| 删文件夹、跨盘移动文件夹 | 没有进度也没有取消,中途失败会留下两份半截。菜单项置灰并给理由,后端也拒 |
| JS/TS、HTML、YAML、Markdown 的格式化 | 各有理由,见 `NO_FORMATTER`;JS/TS 是下一轮最便宜的一条 |
| 保存时自动格式化 | 不做「不请自来的格式化器」 |
| 自动下载安装更新 | 需要签名密钥对,**私钥丢了所有已装客户端永远收不到更新**,值得单独一轮 |
| 保存时带上 ACL、属主属组、扩展属性;经符号链接保存时写到真目标 | 原子保存是「临时文件 → rename」,这几样 rename 给不了,要特权或另一套 API(Windows 上是 `ReplaceFileW`) |
| Win11 贴靠布局浮层 | 纯前端做不到,要在 Rust 侧挂窗口过程;贴靠本身可用 |
完整的待办、以及每一条为什么还欠着,在 [`lessons.md` §六](.document/design/lessons.md)。
## 文档
| 文档 | 内容 |
|---|---|
| [`.document/design/lessons.md`](.document/design/lessons.md) | **接手先读 §六「接手时先看这里」**:基线、动手前的习惯、各模块先读哪一段;前五节是这个项目反复踩过的坑 |
| [`.document/design/phase1-spec.md`](.document/design/phase1-spec.md) | 阶段 1 规格:双文档类型的切口、编码与换行、只读查看器的操作集合,以及每一刀的落地记录 |
| [`.document/design/phase2-spec.md`](.document/design/phase2-spec.md) | 阶段 2 规格:Markdown 渲染的安全边界、渲染管线、三模式 |
| [`.document/adr/`](.document/adr/) | 架构决策记录(ADR-001:预览协议与沙箱) |
| [`.document/prd/editor-tech-stack.md`](.document/prd/editor-tech-stack.md) | 原始技术方案 |
| [`.document/prd/editor-tech-stack-review.md`](.document/prd/editor-tech-stack-review.md) | 技术评审(决策 D1–D5、六处修正、工时估算) |
| [`.document/prd/phase0-gate-report.md`](.document/prd/phase0-gate-report.md) | 阶段 0 可行性门禁报告(结论 GO,数字已归档,不必重跑) |
| [`design-system/yzj-text/MASTER.md`](design-system/yzj-text/MASTER.md) | 设计系统 |
| [`.document/prototype/`](.document/prototype/) | 7 屏静态 UI 原型(设计基准) |
| [`src/brand/README.md`](src/brand/README.md) | 应用图标的原始件与派生规则 |