把一篇文档，原样传上去。

↑一键上传当前文档

命令面板、文档树右键、编辑器标题栏右键、状态栏、可自定义快捷键五个入口同一个动作。右键的第一项永远是「Netglimmer 一键上传」，按今天的设置上传（是否含子文档由那个开关决定，不在菜单上分两条）；这篇文档传过之后又改过的，下面多出一项 「检测到改动，重新上传」，按那条记录当初的协议与「含子文档」口径重传，而不是按今天的设置新开一次。判不准的一律不给第二项——没有成功记录、没存指纹、指纹查询失败、记录对应的远端已经删掉，都只留第一项，不摆一颗点下去只会把远端原样再盖一遍的按钮。

Δ增量上传

预检遍历一次同时算出「要传哪些」和「远端多了什么」；HTML (SiYuan) 档每次导出都附带的运行时文件按内容比对跳过（Markdown 档没有运行时，产物本来就只剩正文与图片；Word 档只有一个 .docx，增量无事可做、每次全量，历史记录里 reused 恒为 0），只改了几个字的重传就只剩那几个文件。

⌀试算（Dry run）

只统计「会传哪些文件、共多少字节、跳过多少」，一个字节都不写——回归里对此有专门的零写入断言。

▤上传看板

搜索文档名/路径/错误文本，按协议、结果、只看有改动筛选，点表头排序；列宽可拖动并按浏览器记忆，还会按当前界面上真实排出来的格子量出下限。

◔改动检测

用文档块索引（块数 + 最后更新时间）做指纹，一次批量查询比完全部记录；文档树角标区分「已上传」与「有改动未上传」。

×远端清理

「删除远端文件」删掉该文档自己的远端目录，文档与记录都保留并标记为「已删除远端」；另有「清理已删除文档的远端」批量处理当前筛选出来的那批。

⇄每协议一套配置

WebDAV / FTP / SFTP / 本地各自保存地址、端口、账号、前缀，切协议不用重填；FTP 与 SFTP 都有独立端口框，支持 host:2121 老写法。

✓测试连接

填完地址和账号先点「测试连接」再保存：WebDAV 用 PROPFIND 探可达性与认证（还会认应答里到底是不是 WebDAV 的 XML），再走一次写探针（MKCOL → PUT → GET 读回比对 → DELETE）；FTP / SFTP 先登录，然后建目录、上传一个已知大小的临时探针、核对尺寸再删掉；本地档同样建目录 + 探针，量出来的是这个目录真的可写。SFTP 首次连接会在结果里给出主机密钥指纹并记录（TOFU），之后指纹变化直接拒绝，需要在「已知主机密钥 (SFTP)」一栏「清除全部」。

☰页面注入

侧边大纲可拖宽、左右停靠、目录折叠，正文居中，图片点击放大并支持触摸滑动；窄视口下大纲收进抽屉。

≡三种导出格式

设置里一个「导出格式」下拉框，与协议无关：HTML (SiYuan) 交思源自己那一整套静态页面（index.html + 运行时 + 引用的资源），还原度最高；Markdown 只交内核「导出 → Markdown」的那份正文（<文档名>.md，含前置元数据）和它真正引用到的 assets/——不带运行时、不注入大纲，产物小一到两个数量级；Word (.docx) 交内核（自带 pandoc，本机 3.8.6 是 3.10.1）那一个自包含文件，图片在包内的 word/media/ 里、与本地原件逐字节一致，「含子文档」在这档是真生效的（子文档并进同一个 word/document.xml），远端目录里除了它只剩一枚归属标记。三档里推荐 HTML (SiYuan)，理由就是页首那块「推荐组合」讲的完整性 / 风格 / 被验得最足。

进度面板

右下角单块面板：阶段文字、按字节计算的进度条、当前文件名、节流刷新，以及一个「取消」。失败时错误里带着文件名与服务器给的原因（比如 413 会告诉你体积超限）。

半途取消之后

取消发生在写入口文件（index.html 或 <文档名>.md）之前 → 远端目录不完整，警告并留一条重传入口；发生在之后 → 远端已经是一份完整产物，按信息提示。两种情况都不会假装成功。

列宽：拖一列只动一列

每列表头右缘一根把手，拖完只改被拖那一列（放得下就照给，表格已经挤满时让无可让的那几个像素会当场折回去，而不是裁字）；双击把手复位那一列，工具条「重置列宽」清掉记忆值。「操作」列的把手收在格子里，不会凭空撑出一条拖不动的横向滚动条。

下限来自实测，不来自某一种语言

时间 / 协议 / 结果 / 操作四列内容不许折行，它们的宽度下限在渲染时按当前界面上真排出来的格子量出来——换一种语言的字典，列会跟着变宽，而不是把字截成省略号。

删除记录有守卫

单条、批量、筛选后单条、筛选后批量四种都做得到；远端还挂着的行勾不动（勾选框禁用，tooltip 指向「删除远端文件」）。要删记录就先取消挂载，反过来也一样说得清。

①归属标记

每个上传目录里有一个 netglimmer-owner-*.json。两篇同名文档因此各占各目录（第二篇自动改名），删除远端时如果目录带着别人的归属标记，直接拒绝。

②不猜路径

「删除远端文件」只删该条记录里记录过的远端分段。记录里没有这个信息时，插件不会靠猜去删（也从不拿展示地址反推路径）——那种行根本不出现删除按钮，清理要手动做。

③空前缀警告

前缀留空会把文章直接铺到服务器根目录，这个开关会亮出来警告；地址字段还有实时格式校验，缺协议头、有多余空格都会按所选协议给出期望写法。

④路径加固

拒绝含 . / .. 段的配置路径，拒绝解析到裸根目录；上传前还会做字节级截断校验，避免写出半个文件。

⑤「清空远端旧目录」说清楚代价

默认开启，但开启增量时不会整树删除（那会连运行时一起删）；只清理本文档目录里的孤儿资产与改名残留——切换导出格式后重传也算一次清理：上一个入口文件（index.html ↔ <文档名>.md ↔ <文档名>.docx）连同不再需要的运行时一起摘掉，不会留下两种格式混在一起的半套页面（三档来回切过也一样收干净，Word 档切走时那个 .docx 就是孤儿）。关掉它就是只追加模式——远端什么都不删。

⑥不碰剪贴板、不开窗口

上传成功后不自动复制任何地址，也没有「打开」按钮：那条地址只说明文件被放进哪个目录，说明不了有人把它当站点提供。看板与结果卡片里都没有任何剪贴板或 window.open 调用（回归里把剪贴板桩留在原地当绊线，谁再写就变红）。整个插件里只剩一处 window.open：文档树角标点开的是这篇文档记录在案的那个远端地址，带着 noopener,noreferrer（从思源里开出去的页面不许反手够到宿主窗口）；而地址一旦与记录对不上（重传到别的目录、或改了文档名），这枚角标会被重建，不许留下一枚点开「文件早就不在那儿」的旧地址。

⑦校验说不出口的，写进记录

逐个确认文件时，服务器不答文件大小、或一次能读回的个数有上限，那几个文件就是没能确认过——插件不把它念成「远端缺失」，也不假装查过了：这个数会写进那条上传记录，看板上「本文 N 个文件」那一格悬停就能看到「另有 {n} 个文件本次未能逐个确认」。同样地，清单里列得出来、递归进去却列不出来的子目录（403 / 404）会把整份清单标成残缺，后续判定按残缺走。

⑧凭据是明文存的，这件事直说

服务器地址、用户名、密码以明文存在 data/storage/petal/siyuan-plugin-netglimmer-Upload/settings.json（本机可读）。思源没有提供系统钥匙串级别的凭据接口，而任何「加密」只要密钥还在本机，能读到你本机文件的程序同样能解密——所以这里不做假加密，只把话说清楚：不要把工作空间目录（或 data/storage/petal/）原样同步到公开位置或网盘；分享配置前手工删掉 settings.json 里的 password 字段；给上传用的账号只开目标子目录的写权限。两道配套的防泄漏：上传历史 history.json 不含密码，而控制台打印地址时先去凭据（思源的控制台是所有插件共用的，4xx/5xx 那几行不受调试开关控制、始终记录）。设置页每个输入框都向浏览器表态（name="netglimmer-upload-<键名>" + 明确的 autocomplete：密码框 new-password、用户名 username、地址 url，其余 off）——浏览器「好心」预填一个旧凭据比留空更难查，因为报出来的错跟你实际输入的内容毫无关系。

真服务器，不是模拟

WebDAV 打真实 IIS 与本机 nginx（各测各的方言差异），FTP 打 vsftpd（2121），SFTP 打 OpenSSH（2222），本地目录走真实文件系统；另有进程内故障注入验证「瞬时错误重试成功 / 403 快速失败 / 重试入口」。

• 上传链路测完自己收摊：删掉测试前缀并确认 PROPFIND 404 才算通过。
• 取消上传在三种时机各测一遍：导出中（远端没动过）、上传中（远端残缺，警告并留重传入口）、入口文件已传完（远端其实是一份完整产物，就按信息提示，不喊不完整）。

排版是被量出来的

加载思源真实的 base.css 与 daylight 主题，配一份忠实移植宿主行为的对话框，中文字典下 1600/1200/1000/800px、英文字典下 1600/1000px 各量一遍：内容不溢出、每个按钮 clip === 0、不许折行的列不得低于实测单行宽、拖把手那一下也真拖两回（宽档与窄档各一次）：弹性列还让得动时正好宽 60px，它已经让到地板时按剩得出来的空间收窄，两种情况下其余固定列都一像素不动、也没有任何一格被裁字。

• 这套测量就是因为一句「设置项都溢出了」的报告加进套件的，此后界面尺寸问题靠测量而不是争论。
• 像素数来自 daylight 主题 + 默认字号；换主题或缩放会得到另一组数，所以断言写成不变式。

包内有什么

只读写当前插件标识

设置与上传历史只存在当前标识 siyuan-plugin-netglimmer-Upload 自己的 settings.json / history.json 里，不读别的插件的存储，也不替任何别处的配置做转换：这个标识下没有数据，就是一份空设置加空历史，第一次上传时把服务器/账号填一遍即可。

• 配置里只有一种形状：每个协议各自一格 server / port / username / password / prefix，切换协议互不覆盖；顶层没有平铺的凭据字段，读取时也只认当前协议那一格。
• 残留的 copyOnPublish 开关会被识别并丢弃，且不会被静默写回。
• 历史记录里带着 pub 标记与本文自有文件数；能定位远端目录的记录还存着远端分段（rootSegs），「删除远端文件」只认它、不从展示地址反推——没有分段信息的行不出现删除按钮，界面上没有「这种字段可能是老数据没有」的猜测分支。