unicode-path

unicode-path 只解决终端或 AI 命令无法可靠传递中文、日文、emoji 等非 ASCII 路径的问题，不读取也不修改文件内容。

运行要求

• Python 3.12 或更高版本。
• 仅使用 Python 标准库，无第三方运行时依赖。

使用

当路径被重新解析、显示为乱码，或 shell 无法稳定传递非 ASCII 路径时，先列出候选：

python scripts/path_bridge.py list --root "C:\资料" --contains "报告"

再验证用户选定的精确路径：

python scripts/path_bridge.py resolve --path "C:\资料\年度报告.docx"

两个命令都输出 UTF-8 JSON。list 返回全部候选，不会替用户选择；resolve 只验证原样路径。拿到 absolute 后，把它交给调用方自己的文档、图片或数据能力。

明确不做的事

• 不读取、提取、转换、编辑或填写文档。
• 不识别 .doc、.docx、.pdf 等格式，不启动 Office/COM，不安装第三方包。
• 不猜测编码、转换 MSYS/UNC 路径，不访问网络，不启动子进程。

开发与测试

运行时只需要 Python 标准库：

python -m unittest discover -s tests -v
python -m compileall -q scripts
git diff --check

测试只使用临时合成样本，避免把真实文档或个人资料放入仓库。上述检查只依赖 Python 标准库和 Git，不依赖特定 AI 工具。