Skip to content

v1.8.2

Latest

Choose a tag to compare

@LingNc LingNc released this 17 Feb 18:25
· 1 commit to main since this release

更新内容

  1. 新增:--unwrap 核心重磅功能!支持将由 dir2txt 打包的单文件内容(_context.md)完整解析并还原回原本的文件夹结构。并在底层重构了解包逻辑,完美支持超大文件的安全流式解包。
  2. 新增:--wrap/-w 参数(可替代 --dir/-d 使用)。开启打包模式,支持将图片、音视频、可执行程序等非文本的二进制内容以 Base64 形式嵌入到 Markdown 中,并可通过 --unwrap 无损还原。
  3. 新增:--view 预览模式(配合 --wrap 使用)。可将嵌入的二进制文件转为能被 Markdown 直接解析展示的语法(例如图片渲染为 ![图片名](data:image/png;base64,...),音视频渲染为 HTML 标签 <audio controls> 等)。不加此参数时,默认以代码块包裹 Base64 数据。
  4. 新增:--recursive/-R 递归展开选项(配合 --unwrap 使用)。在解包完成后,会自动识别并就地递归展开内部嵌套的 *_context.md 模块文件,实现类似文件夹的树状释放,并自动清理冗余释放源。
  5. 新增:--version/-v 选项,用于快速查看当前程序版本号与署名。
  6. 更新:全面优化 CLI 命令行错误提示。采用类似 Git 的紧凑型语法摘要排版,去除冗长的刷屏报错,提示更加精简、直观且专业。
  7. 修复:解决了 --gitignore 在特定情况下未能正确忽略 .git 隐藏目录的问题。
  8. 修复:解决了在 Windows 环境下使用 --install 自动配置环境变量时,控制台输出中文出现乱码(Mojibake)的问题。
  9. 移除:全面废弃并移除了旧版的指令式配置选项 -Fc/-fc(保留 --config,为未来支持全新的声明式配置文件做准备)。

使用说明:

  1. dir2txt --version 或者 dir2txt -v 可以快速打印当前工具的版本信息。
  2. dir2txt -w ./assets --view -o assets_context.md 可以将 assets 目录进行二进制打包,并将里面的媒体文件转化为能在 Markdown 阅读器中直接渲染预览的格式。
  3. dir2txt --unwrap project_context.md 可以读取打包好的 Markdown 文件,并将其内部的所有代码和二进制文件原样解包还原到当前目录下。
  4. dir2txt --unwrap complex_test_context.md -o output_dir/ -R 可以将文件解包到指定的 output_dir/ 目录中,并自动搜索里面嵌套的其他 *_context.md,将它们像文件夹一样就地递归解压出来。
  5. 若输入了错误的参数(如 dir2txt --unwrap 未加路径),程序将不再刷屏输出整篇帮助文档,而是精准提示 错误: --unwrap 需要指定一个 markdown 文件路径 并附带简短的语法摘要。

Full Changelog: v1.7.4...v1.8.2