koishi-plugin-md-tryer
用于测试和调试 QQ 平台原生 Markdown 消息的 Koishi 插件。
功能特性
-
发送原生 Markdown 格式消息
-
提供 10 个预置的 Markdown 示例
-
支持发送原始文本模式
-
支持调试模式，在 console 打印发送的内容
安装
# 在 Koishi 插件市场搜索 md-tryer 安装
# 或使用命令行安装
yarn add koishi-plugin-md-tryer
配置
在 Koishi 配置文件中添加：
plugins:
md-tryer:
verboseConsoleInfo: false # 是否开启调试模式，打印发送的 Markdown 内容
使用方法
发送自定义 Markdown
echo-md # 标题\n**粗体**文本
发送预置示例
# 使用完整参数名
echo-md --example 0
# 使用简写
echo-md -e 5
发送原始文本
echo-md --raw "这是原始文本"
echo-md -e 2 --raw
预置示例
插件提供了 10 个预置的 Markdown 示例，涵盖各种常用格式：
| 索引 | 示例名称 | 说明 |
|------|---------|------|
| 0 | 标题示例 | 展示各级标题和文本格式 |
| 1 | 列表示例 | 展示无序列表和有序列表 |
| 2 | 文本格式示例 | 展示粗体、斜体、删除线等 |
| 3 | 代码示例 | 展示行内代码和代码块 |
| 4 | 引用示例 | 展示多级嵌套引用 |
| 5 | 表格示例 | 展示 Markdown 表格 |
| 6 | 分割线和强调示例 | 展示分割线和文本强调 |
| 7 | 任务列表示例 | 展示任务列表格式 |
| 8 | 混合格式示例 | 展示多种格式的组合 |
| 9 | 高级示例 | 展示数学公式和代码高亮 |
示例展示
示例 0 - 标题示例
示例 1 - 列表示例
示例 2 - 文本格式示例
示例 3 - 代码示例
示例 4 - 引用示例
示例 5 - 表格示例
示例 6 - 分割线和强调示例
示例 7 - 任务列表示例
示例 8 - 混合格式示例
示例 9 - 高级示例
源码
注意事项
-
此插件仅支持 QQ 平台的原生 Markdown 消息
-
需要确保已开通 QQ 机器人的原生 Markdown 权限
-
某些特殊格式可能因平台限制而无法正常显示
内容审查
QQ 平台会对发送的内容进行审查，包含不合规内容的消息会被拒绝发送。常见错误示例：
[E] echo-md 发送失败: HTTPError: Bad Request
{ response: {
data: {
message: '请求参数不允许包含url www.example.com',
code: 40034028,
err_code: 40034028
},
status: 400
}}
常见被拦截的内容：
-
包含特定域名的链接（如
www.example.com） -
敏感关键词
-
违规图片链接
建议：
-
开启
verboseConsoleInfo配置项，在 console 查看实际发送的内容 -
如果遇到发送失败，尝试修改文案或移除可疑内容
-
使用
--raw参数测试原始文本是否能正常发送
markdown 可以使用 普通文本 和 <> 发送链接，不限制URL
加入 []()语法 后强制检测链接，需加白名单才可发送