Files
konabot/konabot/docs/user/textfx.txt
passthem d4cde42bdc
All checks were successful
continuous-integration/drone/push Build is passing
Vibe Coding: textfx 若干 issue 更新
2026-02-16 19:36:24 +08:00

175 lines
5.4 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 文字处理机器人使用手册(小白友好版)
欢迎使用文字处理机器人!你不需要懂编程,只要会打字,就能用它完成各种文字操作——比如加密、解密、打乱顺序、进制转换、排版整理等。
---
## 一、基础演示
在 QQ 群里这样使用:
1. **直接输入命令**(适合短文本):
```
/textfx reverse 你好世界
```
→ 机器人回复:`界世好你`
2. **先发一段文字,再用命令处理它**(适合长文本):
- 先发送:`Hello, World!`
- 回复这条消息,输入:
```
/textfx b64 encode
```
→ 机器人返回:`SGVsbG8sIFdvcmxkIQ==`
> 命令可写为 `/textfx`、`/处理文字` 或 `/处理文本`。
> 若不回复消息,命令会处理当前行后面的文本。
---
## 二、流水线语法(超简单)
- 用 `|` 连接多个操作,前一个的输出自动作为后一个的输入。
- 用 `;` 分隔多条独立指令,它们各自产生输出,最终合并显示。
- 用 `>` 或 `>>` 把结果保存起来(见下文),被重定向的指令不会产生输出。
**例子**:把"HELLO"先反转,再转成摩斯电码:(转换为摩斯电码功能暂未实现)
```
textfx reverse HELLO | morse en
```
→ 输出:`--- .-.. .-.. . ....`
**例子**:多条指令各自输出:
```
textfx echo 你好; echo 世界
```
→ 输出:
```
你好
世界
```
**例子**:重定向的指令不输出,其余正常输出:
```
textfx echo 1; echo 2 > a; echo 3
```
→ 输出:
```
1
3
```
---
## 三、功能清单(含示例)
### reverse或 rev、反转
反转文字。
示例:`/textfx reverse 爱你一万年` → `年万一你爱`
### b64或 base64
Base64 编码或解码。
示例:`/textfx b64 encode 你好` → `5L2g5aW9`
示例:`/textfx b64 decode 5L2g5aW9` → `你好`
### caesar或 凯撒、rot
凯撒密码(仅对英文字母有效)。
示例:`/textfx caesar 3 ABC` → `DEF`
示例:`/textfx caesar -3 DEF` → `ABC`
### morse或 摩斯)
将摩斯电码解码为文字(支持英文和日文)。字符间用空格,单词间用 `/`。
示例:`/textfx morse en .... . .-.. .-.. ---` → `HELLO`
示例:`/textfx morse jp -... --.-- -.. --.. ..- ..` → `ハアホフウイ`
### baseconv或 进制转换)
在不同进制之间转换数字。
示例:`/textfx baseconv 2 10 1101` → `13`
示例:`/textfx baseconv 10 16 255` → `FF`
### shuffle或 打乱)
随机打乱文字顺序。
示例:`/textfx shuffle abcdef` → `fcbade`(每次结果不同)
### sort或 排序)
将文字按字符顺序排列。
示例:`/textfx sort dbca` → `abcd`
### b64hex
在 Base64 和十六进制之间互转。
示例:`/textfx b64hex dec SGVsbG8=` → `48656c6c6f`
示例:`/textfx b64hex enc 48656c6c6f` → `SGVsbG8=`
### align或 format、排版
按指定格式分组排版文字。
示例:`/textfx align 2 4 0123456789abcdef` →
```
01 23 45 67
89 ab cd ef
```
### echo
输出指定文字。
示例:`/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` → `好你`
- 追加:`/textfx echo world >> mytext`
- 删除:`/textfx rm mytext`
> 缓存仅在当前对话中有效,重启后清空。
### replace或 替换、sed
替换文字(支持正则表达式)。
示例(普通):`/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`
---
## 常见问题
- **没反应?** 可能内容被安全系统拦截,机器人会提示“内容被拦截”。
- **只支持纯文字**,暂不支持图片或文件。
- 命令拼错时,机器人会提示“不存在名为 xxx 的函数”,请检查名称。
快去试试吧!用法核心:**`/textfx` + 你的操作**