用途:在网络驱动器(如 O:、Z:)上快速查找作业(job)文件夹,可集成到桌面应用、命令行工具或文件对话框中做作业路径解析。
主要能力:以 find_job_folder() 为主入口,先查索引(命中 <1ms),未命中则用 ThreadPoolExecutor 并行搜索(约 3-5 秒),找到后后台更新索引缓存。提供 ensure_index_exists() 在启动时非阻塞建索引、get_dxf_output_path() 确定 DXF 输出路径,以及 is_indexing()、get_status() 状态查询。支持 JobIndex 类、build_index/save_index/load_index 等高级操作。识别 YY-NNNN、YYNNNN、NNNNNNN、XX-NNNN 等作业号格式并归一化。
使用方式:从 services.job_search 导入函数,例如 find_job_folder("24-1234") 或带 base_path 参数。命令行:cd Arc_Segment_Calculator 后运行 python -m src.services.job_search <command>,命令有 build、status、search、clear,如 python -m src.services.job_search search --job 24-1234。可用 configure_index() 设置索引目录、最大缓存时长、扫描深度,用 configure_parallel_search() 设置线程数、深度与超时。索引默认存于 ~/.arc_segment_calculator/job_index.json。
适用场景:网络驱动器作业查找、桌面应用作业路径解析、命令行搜索工具、文件对话框路径集成。
限制:资料未提供依赖版本、平台兼容性、授权与收费信息;性能数据为资料所述,实际可能因网络环境而异。