# 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) | 应用图标的原始件与派生规则 |