dsh-tool-regex 使用指南

为 DSH 助手提供零依赖的正则工具，可测试匹配、提取捕获组、安全替换文本，并能静态解释正则含义，全程内置 ReDoS 多层防护。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add github:omdsh-dev/dsh-toolkit#path:packages/dsh-tool-regex

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

这个插件需要配置吗？

不需要。安装后插件会自动注册到 profile，无需任何额外配置即可使用 regex 工具的全部 4 个动作（test/find/replace/explain）。

和系统的 grep 有什么区别？

grep 只能在文件域搜索，且要起 shell 进程。本插件接受任意文本字符串作为输入，能提取捕获组、执行替换，还能把正则解析成可读的语义节点，速度快且不依赖文件。

病理正则（灾难性回溯）会卡死助手吗？

不会。test/find/replace 全部跑在独立 worker 线程里，1000ms 到期即强制终止并返回 "regex: execution timed out"。explain 走静态 tokenizer，天然不会触发回溯。

输入大小有限制吗？

有硬上限：待匹配文本 ≤ 64KB、pattern ≤ 16KB、replacement ≤ 16KB、输出 ≤ 1MB、find 匹配数 ≤ 1000。超限会在入口直接拒绝（不截断）。

explain 和 test/find/replace 有什么区别？

explain 只把正则字符串拆成节点（字面量、字符类、量词等）返回，告诉你这条正则"长什么样"，完全不执行匹配；其他三个动作则会真实跑匹配并返回结果。

怎么卸载？

通过 profile 的 bundle 层管理移除：dsh plugin --profile web remove tool-regex，或直接编辑 profile 的 layer stack 删除对应 row。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则