加在入口还是出口 —— 以及一个"看着像文件夹"的文件
2026-10-09 · 概念 + 语法
两个容易搞混的点，本质是一回事：同一段信息，位置不同、或被当成了另一种东西，含义就变了。一个是"窗口加在哪一侧"，一个是"文件夹其实是个文件"。分开讲。
一、窗口加在入口，还是出口？
概念：输入窗 vs 输出窗
一张灰度图，取值落在某个范围内。你想让它"对比更明显"，办法无非是把中间一段拉开、把两头压平。但同一个"拉开/压平"，加在入口和加在出口，效果正好相反。
输出窗（加在出口）——规定"我这张图，最暗只准到 低、最亮只准到 高"。做法是先把本图的 min / max 找出来，再把它们分别映射到 低 / 高：
- 低 = 0、高 = 满量程 → 把本图 min/max 拉满（一次"自动拉伸"）；
- 把"低"往上抬 → 最暗的那批被抬成灰 →对比下降；
- 把"高"往下压 → 最亮的那批被压成灰 →对比下降；
- ⇒两个方向都只能降对比。
输入窗（加在入口）——规定"低于 低 的一律当黑，高于 高 的一律当白，中间线性拉开"：
- 窗越窄，中间那段的落差被放得越大 →对比上升；
- 低 = 0、高 = 满量程 → 什么都不改（恒等）。
一句口诀：输出窗是"把结果塞进一个范围"（只能收），输入窗是"用一个范围去筛原始值"（能放）。
类比·调音台：输入端的增益决定"多大的声音先被收进来"，输出端的总音量决定"最后从喇叭出去多响"。想让某个人声更突出，该动的是输入增益（把一段拾音范围拉开）；把总音量拧小，只会让整首歌一起变小，突出不了谁。
方案 A（输出窗）——先找本图 min/max，再塞进 [低,高] 本图min ───────────── 本图max │ │ ▼ ▼ 低 ────────────────── 高 → 只能把两头往中间挤（对比 ↓） 方案 B（输入窗）——用 [低,高] 去量每个像素 v < 低 ────────────── v > 高 │ │ ▼ ▼ 黑 ───── 线性拉开 ───── 白 → 窗越窄，中间越"炸"（对比 ↑）这也正是图像软件里"亮度/对比度"面板上输入色阶 / 输出色阶两个框的区别——一个加在入口，一个加在出口。名字差不多，作用位置不同，效果正相反。
语法：线性映射 + 截断 + 查表
输入窗干的活是"把 [低,高] 映射到显示满量程，越界就拍到两端"。写成公式就三步：
out = (v - 低) / (高 - 低) * 满量程 # 1) 线性拉开 out = min(max(out, 0), 满量程) # 2) 截断到 [0, 满量程] ← clamp语法点逐个说：
分母别为 0：
高 - 低若等于 0（用户把两端拖到同一点）会除零。要么在交互里夹取保证低 < 高（拖一端越界就把另一端带着走），要么代码里特判。截断 clamp：
min(max(x, lo), hi)是最通用的写法，等价于"低于下界的、高于上界的都拍平到边界"。少了它，越界的像素会溢出或回卷（尤其整数运算），画面出现莫名的黑块/白块。逐像素算太慢 → 预计算查找表（LUT）：这个映射只跟"像素值"有关，而 8bit 灰度只有 256 种输入值。于是可以先把 256 个结果算好，存成一张表；之后每个像素只剩查表。这是"用一点空间换大量时间"的经典套路：
lut = [ clamp((i - 低) / (高 - 低) * 满量程, 0, 满量程) for i in range(256) ] # 只算 256 次 for p in pixels: out[p] = lut[p] # 逐像素只查表，不做除法类比·小词典：把 256 个常用词先翻好、做成一本小词典；正文里每遇到一次就翻词典，而不是每见一个词就重新翻一次语法书。
- 显示变换 ≠ 处理变换：窗口如果只为了"给人看"，它就不该顺着数据流流进后面的计算——否则你调的是"眼睛看到的"，被改的却是"机器算的"。显示层只改显示层那一份缓冲，是这里最要紧的边界。
二、一个"看着像文件夹"的文件
概念：指针 vs 实体
桌面上的那个"文件夹"，双击能进去——但它在磁盘上可能只是个几 KB 的普通文件：里面记着一行"真正的地址在别处"。这就是快捷方式。
关键在这里：整个操作系统里，只有"资源管理器"这类外壳程序才认识快捷方式、会顺着便签跳过去。而程序调用的是文件系统接口——它只认"这里有没有一个叫这名字的目录"，它不读便签。
于是当你把"某个输出目录"配上桌面上那个"看着像文件夹"的东西：
- 配成
.../桌面/输出（不带扩展名）→ 系统发现没有叫"输出"的真目录 → 它老老实实新建一个真文件夹，数据全写进了本机，而且不报错（静默走偏）； - 配成
.../输出.lnk→ 那是个文件、不是目录 → 打开直接失败。
类比·门牌 vs 便签：快捷方式 = 门上贴了张便签"请到 B 座找"。送快递的（外壳程序）会读便签、跑一趟 B 座；但自动分拣机（文件系统）只认门前站的是不是本人，它不认字。
快捷方式 (.lnk)： [门]--贴便签--> (真正的地址) ← 只有"外壳"读便签 目录联接 / 符号链接：[门]═══通道═══> (真正的地址) ← 文件系统直接穿过去想让"桌面上的入口"真的通到别处，要用的是目录联接（junction）或符号链接（symbolic link）——它们是文件系统层的"传送门"，对任何程序都透明：程序以为自己在写"桌面这条路"，数据其实落到了通道另一头。
概念：路径由"读它的那一方"解释
第二个坑更隐蔽：路径不是一个"全局坐标"，它由"正在读的一方、在它自己的环境里"来解释。
- 同一个
D:/xxx，在 A 机器指 A 的 D 盘、在 B 机器指 B 的 D 盘； - 同一个"桌面路径"，只在那台机器的、那个登录用户下才成立；换个用户、换台机器就不存在；
- 想跨机，要么用UNC 路径（
\\主机\共享名\...，网络共享的"全名"），要么靠盘符映射（把\\主机\共享挂成 B 机器的一个盘符，再约定"大家都用这个盘符"）。
盘符映射的命门：它本质是"把路径开头那个盘符字母换掉"。
- 路径
X:/...→ 换个开头字母 →Y:/...，B 机器就懂了； - 但UNC 路径（
\\主机\共享\...）没有盘符→ 替换逻辑找不到"开头的那个字母" →原样塞回去、映射根本没发生→ B 机器拿到一个它够不到的裸地址 → 读不到。
类比·只翻第一个词的口译员：你先说"X 号楼……“，他把开头的"X"翻成"Y”。可你要是说"地球·中国·某市·某路"，前头没有"楼号"可比对，他整句原样还给你——对方照样听不懂。
语法：三个路径处理的坑
- 路径拼接：当后一段自带"根"（开头是盘符或斜杠）时，很多拼接函数会整段改用后一段、把前一段丢掉。Python 里一眼能看到：
os.path.join("输出根", "某型号") == "输出根/某型号" # 正常拼 os.path.join("输出根", "/某型号") == "/某型号" # 后段自带根 → 前段被丢！⇒ 所以"给某一个配置项填了绝对路径"经常看起来生效了，其实是拼接把前缀整段作废。要逐一检查每一处拼接，而不是只看那一个配置。
- 字符串替换只认第一个：盘符替换那种"只换开头"的逻辑，通常写成"替换第一次出现的某字符"：
replace_first("Y:/a/b", 'X', 'Y') == "Y:/a/b" # 冒号前是 Y≠X → 不动 replace_first("X:/a/b", 'X', 'Y') == "Y:/a/b" # 命中 → 改 replace_first("//host/share/a", 'X', 'Y') == "//host/share/a" # 没有冒号 → 不动⇒单字符替换 ≠ 前缀替换。想让"网络全名"也能被翻译，逻辑得升级成"按前缀整段替换"，而不是"换一个字母"。
- 判断"是不是目录"别靠字符串：别盯着后缀猜，要用文件系统去问exists / is_directory。
输出（无后缀）可以是目录，输出.lnk是文件——光看名字分不清，问系统最靠谱。
收尾：两个坑，一个根
- ① 窗口：同一个"阈值"，加在入口是"筛"、加在出口是"塞"——位置放错，效果反了；
- ② 路径：同一个"文件夹"，可能是实体、也可能只是指针；同一个"路径"，含义由读它的一方决定——身份认错，数据就落错地方。
排查口诀：先问三句——这段信息是谁在解释？作用在哪一侧？名字背后是实体，还是指针？
