让 WorkBuddy 建资料索引，搬动文件夹后链接怎样仍可用

让 WorkBuddy 建资料索引时，想要搬动整个文件夹后链接仍可用，应把索引与资料放在同一根目录，并使用相对路径。本文只交付可移动的离线索引，不重复归档目录设计。相对链接能减少固定盘符依赖，但文件内部单独改名后仍需更新清单。

一个可搬动的最小结构

资料包/
  index.html
  manifest.csv
  docs/
    说明 一.txt
  images/
    示意图.png

index.html 的链接使用 docs/说明%20一.txt 这类相对 URL，不写 D:/个人目录/...。HTML 链接中的路径分隔符用斜杠，空格、井号和中文按 URL 编码处理；文件系统路径与 URL 字符串不能直接混为一谈。

清单同时保存稳定编号、相对路径、大小、摘要和标题。标题可供人阅读，摘要可帮助确认移动后内容是否一致。不要把本机绝对路径当作唯一字段，否则整包拷贝给别人就失效。

先生成预览，再核验每条链接

交给工具的指令可以是：“只在指定根目录读取允许的资料，生成离线 index.html 与 manifest.csv。链接从 index.html 所在目录相对定位，保留中文文件名，不上传。完成后检查每个目标存在且没有越出根目录。”这属于工程约定，不意味着文件编辑能力自动包含断链保证。

本地检查相对路径时，要防止 ../ 或符号链接指向包外。解析路径后确认仍在根目录范围内；外部链接单列，不冒充离线可用。摘要比较说明字节是否变了，不说明资料标题是否写对。

条目	搬家前	搬家后	通过条件
目录根	D:/demo/资料包	E:/演练/资料包	根可变化
相对路径	docs/说明 一.txt	同值	必须一致
目标文件	存在	存在	两侧均存在
内容摘要	实际计算	实际计算	相同
浏览器打开	待核	待核	能到正确文件

真正移动副本做一次验收

不要仅凭代码中没有盘符就宣布可移动。把完整资料包复制到另一个目录，最好路径含空格与中文，然后从新位置打开索引。逐条点击代表性文件，同时用脚本检查全部目标存在。浏览器对本地文件的安全策略可能影响预览，所以“存在”和“能在当前查看器打开”需要分开记录。

如果只搬 index.html 而没搬 docs，链接当然会断；如果搬完又改了内部文件名，摘要可能仍一致但路径已不同。清单应提供重新生成流程，文件新增、移动或改名后重新核验，不能把一次通过当作长期免维护。

交付物和边界

索引页应显示根目录说明、条目数、生成时间和使用方法，避免用户把它误认为云端搜索页面。含敏感文件的包按原资料权限保管，离线不等于无需权限控制。本文未在 WorkBuddy 中执行，提供的是可验收任务协议；实际客户端结果需按同一清单核对。

可以用 Python 的路径与摘要工具独立复核，无需依赖生成索引的同一个模型。若发现断链，报告编号、原相对路径和失败原因，不让工具静默删除条目以达到“零断链”。

常见问题

相对路径能承受任意改名吗？ 不能，只保护根目录整体移动，内部结构变化仍需更新。

只检查文件存在够吗？ 还应检查指向内容正确、没有越界，并人工打开代表性链接。

需要在线发布吗？ 离线索引通常不需要；若另行发布，要单独决定访问范围与托管方式。

继续处理相关问题

相关入口：WorkBuddy 卡住后的处理。

官方依据与核对日期

核对日：2026-10-23。WorkBuddy 文件产物：文件浏览器支持查看和编辑文件；本文离线索引协议是工程方案；Python pathlib：支持路径解析与相对路径操作。文中的流程、阈值和合成数据属于工程示例，不能代替当前账号、文件或运行环境的验收。