命名审查与垃圾代码清理（纯重命名 / 死代码删除，无行为变更）

前提：加载完成后全部采样都已驻留内存，程序此后与源文件再无联系。
据此修正了一批会让人误以为"仍在读写文件"的命名：

- SampleFileAt → SampleSignalAt（取的是内存信号在给定时刻的采样值）。
- DataSet::AddPreparedFile → AddDataFile。
- PlotView::InvalidatePolylineCache → InvalidateDerivedCaches
  （它同时清空折线、边沿统计、中心平均值曲线、静态场景缓存与悬停引用）。
- PlotView::CursorColor(int which) → CursorColor()（两条光标同色，参数从未使用）。
- UiEllipsize(g,…) → UiEllipsize(…)：纯测量不绘制，删掉被忽略的绘图上下文参数；
  同时删除与 UiMeasureTextWidth 完全重复的 UiTextWidth，调用点统一到 UiMeasureTextWidth。

清理残留参数（(void)xxx;）：
- TabConfig 的可见性/网格族（SetVisible / ToggleVisible / SetFileVisible / SetAllVisible /
  SoloSignal / SetMode / SyncLanes / FileHasVisible / FileAllVisible）去掉从未使用的
  const DataSet& 参数（仅 SyncToDataSet 真正需要数据层，保留）。
- PlotView::OnLButtonUp(int y)、OnMouseWheel(int delta, bool shift)；PainterSignalHalo 去掉未用的 ref。
- BuildDataFile 中未使用的局部 rowCount。

删除无人调用的死函数：
  DataSet::Clear / AddFromTable；SignalColorCount；WideToUtf8 / StartsWith；
  PlotView::ViewMinTime / ViewMaxTime / EdgePanelRect / EdgePanelCloseRect /
  EdgeCenterPanelRect / ScaleLaneRange / BeginLaneValueEdit / LaneContentHeight；
  SignalPanel::NeedsScrollBar / IsFilterEditing / FilterText / ContentHeight；
  PopupMenu::EditingItemId；TabBar::IsDragging；TextEdit::PlaceCaret。

删除只写不读的死字段：CsvTable::sourceRowCount（与 rowCount 等义）与 skippedRowCount。

以 VERY_BIG_DATA.CSV 回归验证：加载与勾选、筛选框（含"无匹配的筛选信号"）、
样式区线宽文案省略、选区放大（横向与纵向）、双光标读数与 Δt、右键菜单（Y 轴数值与
实验性功能子菜单）、合并/拆分网格、标签与信号重命名省略号，行为均与改动前一致；
make clean && make all 无任何警告。

Utilities/Inc/CsvTable.hpp

@@ -23,9 +23,7 @@ namespace jdi
 		std::vector<std::vector<double>> columns;		/**< 列优先数值矩阵：columns[列][行]，缺失处为 NaN。 */
 		std::size_t rowCount = 0;						/**< 有效数据行数。 */
 		wchar_t delimiter = L',';						/**< 实际使用的分隔符。 */
-		std::size_t sourceRowCount = 0;					/**< 文件中有效数据行数（不含空行与注释行）。 */
-		std::size_t skippedRowCount = 0;				/**< 因格式异常被置为缺失值的行数。 */
-		unsigned long long fileBytes = 0;				/**< 源文件字节数（用于按比例预留容量与进度显示）。 */
+		unsigned long long fileBytes = 0;				/**< 源文件字节数（用于按比例预留容量）。 */
 
 		/**
 		 * @brief 判断解析结果是否包含可用的表格数据。

Utilities/Inc/DataModel.hpp

@@ -189,28 +189,13 @@ namespace jdi
 	class DataSet
 	{
 	public:
-		/**
-		 * @brief 清空全部已加载文件。
-		 */
-		void Clear();
-
-		/**
-		 * @brief 依据 CSV 解析结果追加一个数据文件。
-		 * @param [IN] table CSV 解析结果。
-		 * @param [IN] filePath 源文件路径。
-		 * @param [OUT] error 失败原因描述（成功时清空）。
-		 * @param [OUT] fileIndex 新文件下标，失败时为 -1。
-		 * @return 追加成功返回 true。
-		 */
-		bool AddFromTable(const CsvTable& table, const std::wstring& filePath, std::wstring& error, int& fileIndex);
-
 		/**
 		 * @brief 追加一个已构建好的数据文件（仅做一次移动，不拷贝采样数据）。
 		 * @param [IN,OUT] file 数据文件（内部缓冲会被移走）。
 		 * @param [OUT] fileIndex 新文件下标。
 		 * @return 追加成功返回 true。
 		 */
-		bool AddPreparedFile(DataFile&& file, int& fileIndex);
+		bool AddDataFile(DataFile&& file, int& fileIndex);
 
 		/**
 		 * @brief 在指定文件的指定信号**下方**插入一条新信号（派生信号）。
@@ -431,15 +416,19 @@ namespace jdi
 	};
 
 	/**
-	 * @brief 计算某条信号在给定时刻的取值。
-	 * @param [IN] file 信号所属文件。
+	 * @brief 从内存中的信号采样点取某一时刻的取值。
+	 *
+	 * 加载完成后全部采样值已在内存中，本函数只查询内存数据，与源文件无关。
+	 *
+	 * @param [IN] file 信号所属的已加载数据分组（提供时间轴）。
 	 * @param [IN] signal 目标信号。
 	 * @param [IN] time 采样时刻。
 	 * @param [IN] interpolate 是否在相邻采样点之间做线性插值。
 	 * @param [OUT] value 输出采样值，缺失时为 NaN。
 	 * @return 时间点落在数据范围内且取到有效值返回 true。
 	 */
-	bool SampleFileAt(const DataFile& file, const SignalData& signal, double time, bool interpolate, double& value);
+	bool SampleSignalAt(const DataFile& file, const SignalData& signal, double time, bool interpolate,
+	                    double& value);
 
 	/**
 	 * @brief 计算 N 点滑动平均（窗口 = [i-N, i+N]，边界按实际窗口长度）。
@@ -506,56 +495,49 @@ namespace jdi
 
 		/**
 		 * @brief 设置指定信号的可见性，并同步网格划分。
-		 * @param [IN] dataSet 数据集合。
 		 * @param [IN] ref 信号引用。
 		 * @param [IN] visible 目标可见状态。
 		 */
-		void SetVisible(const DataSet& dataSet, const SignalRef& ref, bool visible);
+		void SetVisible(const SignalRef& ref, bool visible);
 
 		/**
 		 * @brief 切换指定信号的可见性，并同步网格划分。
-		 * @param [IN] dataSet 数据集合。
 		 * @param [IN] ref 信号引用。
 		 */
-		void ToggleVisible(const DataSet& dataSet, const SignalRef& ref);
+		void ToggleVisible(const SignalRef& ref);
 
 		/**
 		 * @brief 设置某个文件全部信号的可见性，并同步网格划分。
-		 * @param [IN] dataSet 数据集合。
 		 * @param [IN] fileIndex 文件下标。
 		 * @param [IN] visible 目标可见状态。
 		 */
-		void SetFileVisible(const DataSet& dataSet, int fileIndex, bool visible);
+		void SetFileVisible(int fileIndex, bool visible);
 
 		/**
 		 * @brief 设置全部信号可见性，并同步网格划分。
-		 * @param [IN] dataSet 数据集合。
 		 * @param [IN] visible 目标可见状态。
 		 */
-		void SetAllVisible(const DataSet& dataSet, bool visible);
+		void SetAllVisible(bool visible);
 
 		/**
 		 * @brief 仅显示指定信号，其余全部隐藏。
-		 * @param [IN] dataSet 数据集合。
 		 * @param [IN] ref 需要保持可见的信号。
 		 */
-		void SoloSignal(const DataSet& dataSet, const SignalRef& ref);
+		void SoloSignal(const SignalRef& ref);
 
 		/**
 		 * @brief 判断某文件是否存在可见信号。
-		 * @param [IN] dataSet 数据集合。
 		 * @param [IN] fileIndex 文件下标。
 		 * @return 存在可见信号返回 true。
 		 */
-		bool FileHasVisible(const DataSet& dataSet, int fileIndex) const;
+		bool FileHasVisible(int fileIndex) const;
 
 		/**
 		 * @brief 判断某文件是否全部信号可见。
-		 * @param [IN] dataSet 数据集合。
 		 * @param [IN] fileIndex 文件下标。
 		 * @return 全部可见且至少有一条信号返回 true。
 		 */
-		bool FileAllVisible(const DataSet& dataSet, int fileIndex) const;
+		bool FileAllVisible(int fileIndex) const;
 
 		/**
 		 * @brief 判断是否存在任何可见信号。
@@ -577,16 +559,14 @@ namespace jdi
 
 		/**
 		 * @brief 设置网格划分策略并同步网格。
-		 * @param [IN] dataSet 数据集合。
 		 * @param [IN] mode 目标策略。
 		 */
-		void SetMode(const DataSet& dataSet, LaneMode mode);
+		void SetMode(LaneMode mode);
 
 		/**
 		 * @brief 依据当前可见性与策略重新生成网格划分。
-		 * @param [IN] dataSet 数据集合。
 		 */
-		void SyncLanes(const DataSet& dataSet);
+		void SyncLanes();
 
 		/**
 		 * @brief 获取网格集合（只读）。

Utilities/Inc/PaintUtil.hpp

@@ -137,15 +137,6 @@ namespace jdi
 	void UiText(gd::Graphics& g, const std::wstring& text, HFONT font, const gd::RectF& rect, std::uint32_t argb,
 	            TextAlign align = TextAlign::LEFT);
 
-	/**
-	 * @brief 测量单行文本的像素宽度。
-	 * @param [IN,OUT] g 绘图上下文。
-	 * @param [IN] text 文本内容。
-	 * @param [IN] font 字体句柄。
-	 * @return 文本像素宽度。
-	 */
-	float UiTextWidth(gd::Graphics& g, const std::wstring& text, HFONT font);
-
 	/**
 	 * @brief 测量单行文本的像素宽度（无需 GDI+ 上下文，可在布局阶段调用）。
 	 * @param [IN] font 字体句柄。
@@ -193,14 +184,13 @@ namespace jdi
 	std::size_t UiEditOffsetAt(HFONT font, const std::wstring& text, float localX);
 
 	/**
-	 * @brief 在超出可用宽度时对文本做尾部省略截断。
-	 * @param [IN,OUT] g 绘图上下文。
+	 * @brief 在超出可用宽度时对文本做尾部省略截断（不绘制任何内容）。
 	 * @param [IN] text 原始文本。
 	 * @param [IN] font 字体句柄。
 	 * @param [IN] maxWidth 允许的最大像素宽度。
 	 * @return 截断后的文本。
 	 */
-	std::wstring UiEllipsize(gd::Graphics& g, const std::wstring& text, HFONT font, float maxWidth);
+	std::wstring UiEllipsize(const std::wstring& text, HFONT font, float maxWidth);
 
 	/**
 	 * @brief 处理输入框内的鼠标按下：命中则把插入符定位到最近的字符边界并开始拖拽框选。

Utilities/Inc/PopupMenu.hpp

@@ -183,12 +183,6 @@ namespace jdi
 		 */
 		bool IsEditing() const { return m_editIndex >= 0; }
 
-		/**
-		 * @brief 获取当前正在编辑的菜单项命令标识。
-		 * @return 命令标识，未编辑时返回 0。
-		 */
-		int EditingItemId() const;
-
 		/**
 		 * @brief 判断坐标是否落在当前正在编辑的输入框内。
 		 * @param [IN] x 客户区横坐标。

Utilities/Inc/TextEdit.hpp

@@ -144,13 +144,6 @@ namespace jdi
 		 */
 		bool DeselectToEnd();
 
-		/**
-		 * @brief 把插入符定位到指定偏移（单击输入框内时使用），并清除选区。
-		 * @param [IN] offset 目标偏移（内部会夹到合法范围）。
-		 * @return 光标或选区发生变化返回 true。
-		 */
-		bool PlaceCaret(std::size_t offset);
-
 		/**
 		 * @brief 开始鼠标拖拽框选：把锚点与插入符都放在给定偏移。
 		 * @param [IN] offset 起始偏移。

Utilities/Inc/Theme.hpp

@@ -121,12 +121,6 @@ namespace jdi
 	 */
 	const std::uint32_t* SignalPalette(int& count);
 
-	/**
-	 * @brief 获取波形默认配色数量。
-	 * @return 配色数量。
-	 */
-	int SignalColorCount();
-
 } // namespace jdi
 
 #endif // __THEME_HPP__

Utilities/Inc/Utf8Util.hpp

@@ -18,13 +18,6 @@ namespace jdi
 	 */
 	std::wstring Utf8ToWide(const char* text, int length = -1);
 
-	/**
-	 * @brief 将宽字符串（UTF-16LE）转换为 UTF-8 编码的字节序列。
-	 * @param [IN] text 宽字符文本起始地址。
-	 * @return 转换后的 UTF-8 字符串，输入非法时返回空字符串。
-	 */
-	std::string WideToUtf8(const wchar_t* text);
-
 	/**
 	 * @brief 去除字符串首尾的空白字符（含制表、换行与不间断空格）。
 	 * @param [IN] text 待处理文本。
@@ -46,14 +39,6 @@ namespace jdi
 	 */
 	std::wstring ToLowerAscii(const std::wstring& text);
 
-	/**
-	 * @brief 判断字符串是否以指定前缀开头。
-	 * @param [IN] text 被检索文本。
-	 * @param [IN] prefix 前缀文本。
-	 * @return 以该前缀开头返回 true，否则返回 false。
-	 */
-	bool StartsWith(const std::wstring& text, const std::wstring& prefix);
-
 	/**
 	 * @brief 判断字符串是否包含指定子串（ASCII 大小写不敏感）。
 	 * @param [IN] text 被检索文本。