Vibe Coding: textfx 若干 issue 更新

konabot/docs/user/textfx.txt

@@ -30,14 +30,35 @@
 ## 二、流水线语法（超简单）
 
 - 用 `|` 连接多个操作，前一个的输出自动作为后一个的输入。
-- 用 `>` 或 `>>` 把结果保存起来（见下文）。
+- 用 `;` 分隔多条独立指令，它们各自产生输出，最终合并显示。
+- 用 `>` 或 `>>` 把结果保存起来（见下文），被重定向的指令不会产生输出。
 
-**例子**：把“HELLO”先反转，再转成摩斯电码：（转换为摩斯电码功能暂未实现）
+**例子**：把"HELLO"先反转，再转成摩斯电码：（转换为摩斯电码功能暂未实现）
 ```
 textfx reverse HELLO | morse en
 ```
 → 输出：`--- .-.. .-.. . ....`
 
+**例子**：多条指令各自输出：
+```
+textfx echo 你好; echo 世界
+```
+→ 输出：
+```
+你好
+世界
+```
+
+**例子**：重定向的指令不输出，其余正常输出：
+```
+textfx echo 1; echo 2 > a; echo 3
+```
+→ 输出：
+```
+1
+3
+```
+
 ---
 
 ## 三、功能清单（含示例）
@@ -91,6 +112,18 @@ Base64 编码或解码。
 输出指定文字。
 示例：`/textfx echo 你好` → `你好`
 
+### cat
+读取并拼接缓存内容，类似 Unix cat 命令。
+- 无参数时直接传递标准输入（管道输入或回复的消息）。
+- 使用 `-` 代表标准输入，可与缓存名混合使用。
+- 支持多个参数，按顺序拼接输出。
+
+示例：
+- 传递输入：`/textfx echo 你好 | cat` → `你好`
+- 读取缓存：`/textfx cat mytext` → 输出 mytext 的内容
+- 拼接多个缓存：`/textfx cat a b c` → 依次拼接缓存 a、b、c
+- 混合标准输入和缓存：`/textfx echo 前缀 | cat - mytext` → 拼接标准输入与缓存 mytext
+
 ### 缓存操作（保存中间结果）
 - 保存：`/textfx reverse 你好 > mytext`（不输出，存入 mytext）
 - 读取：`/textfx cat mytext` → `好你`
@@ -104,6 +137,32 @@ Base64 编码或解码。
 示例（普通）：`/textfx replace 世界 宇宙 你好世界` → `你好宇宙`
 示例（正则）：`/textfx replace \d+ [数字] 我有123个苹果` → `我有[数字]个苹果`
 
+### trim（或 strip、去空格）
+去除文本首尾空白字符。
+示例：`/textfx trim "  你好  "` → `你好`
+示例：`/textfx echo "  hello  " | trim` → `hello`
+
+### ltrim（或 lstrip）
+去除文本左侧空白字符。
+示例：`/textfx ltrim "  你好  "` → `你好  `
+
+### rtrim（或 rstrip）
+去除文本右侧空白字符。
+示例：`/textfx rtrim "  你好  "` → `  你好`
+
+### squeeze（或 压缩空白）
+将连续的空白字符（空格、制表符）压缩为单个空格。
+示例：`/textfx squeeze "你好   世界"` → `你好 世界`
+
+### lines（或 行处理）
+按行处理文本，支持以下子命令：
+- `lines trim` — 去除每行首尾空白
+- `lines empty` — 去除所有空行
+- `lines squeeze` — 将连续空行压缩为一行
+
+示例：`/textfx echo "  hello\n\n\n  world  " | lines trim` → `hello\n\n\n world`
+示例：`/textfx echo "a\n\n\nb" | lines squeeze` → `a\n\nb`
+
 ---
 
 ## 常见问题