Repository navigation
更新内容
- 新增:
--unwrap核心重磅功能!支持将由dir2txt打包的单文件内容(_context.md)完整解析并还原回原本的文件夹结构。并在底层重构了解包逻辑,完美支持超大文件的安全流式解包。 - 新增:
--wrap/-w参数(可替代--dir/-d使用)。开启打包模式,支持将图片、音视频、可执行程序等非文本的二进制内容以 Base64 形式嵌入到 Markdown 中,并可通过--unwrap无损还原。 - 新增:
--view预览模式(配合--wrap使用)。可将嵌入的二进制文件转为能被 Markdown 直接解析展示的语法(例如图片渲染为,音视频渲染为 HTML 标签<audio controls>等)。不加此参数时,默认以代码块包裹 Base64 数据。 - 新增:
--recursive/-R递归展开选项(配合--unwrap使用)。在解包完成后,会自动识别并就地递归展开内部嵌套的*_context.md模块文件,实现类似文件夹的树状释放,并自动清理冗余释放源。 - 新增:
--version/-v选项,用于快速查看当前程序版本号与署名。 - 更新:全面优化 CLI 命令行错误提示。采用类似 Git 的紧凑型语法摘要排版,去除冗长的刷屏报错,提示更加精简、直观且专业。
- 修复:解决了
--gitignore在特定情况下未能正确忽略.git隐藏目录的问题。 - 修复:解决了在 Windows 环境下使用
--install自动配置环境变量时,控制台输出中文出现乱码(Mojibake)的问题。 - 移除:全面废弃并移除了旧版的指令式配置选项
-Fc/-fc(保留--config,为未来支持全新的声明式配置文件做准备)。
使用说明:
dir2txt --version或者dir2txt -v可以快速打印当前工具的版本信息。dir2txt -w ./assets --view -o assets_context.md可以将assets目录进行二进制打包,并将里面的媒体文件转化为能在 Markdown 阅读器中直接渲染预览的格式。dir2txt --unwrap project_context.md可以读取打包好的 Markdown 文件,并将其内部的所有代码和二进制文件原样解包还原到当前目录下。dir2txt --unwrap complex_test_context.md -o output_dir/ -R可以将文件解包到指定的output_dir/目录中,并自动搜索里面嵌套的其他*_context.md,将它们像文件夹一样就地递归解压出来。- 若输入了错误的参数(如
dir2txt --unwrap未加路径),程序将不再刷屏输出整篇帮助文档,而是精准提示错误: --unwrap 需要指定一个 markdown 文件路径并附带简短的语法摘要。
Full Changelog: v1.7.4...v1.8.2