Skip to content

Commit 56f0c82

Browse files
authored
Merge pull request #32 from CookSleep/docs/update-character-default-presets
docs(character): update default presets
2 parents 58c2c7f + bc8d8a1 commit 56f0c82

3 files changed

Lines changed: 102 additions & 41 deletions

File tree

docs/guide/getting-started.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,8 @@ Koishi 是一个跨平台、可扩展、高性能的聊天机器人框架。Chat
2626

2727
安装 ChatLuna 的必要前置依赖服务,ChatLuna 需要这些服务来提供基础功能。
2828

29+
**请务必先在侧栏的“依赖管理”界面,点击“小火箭图标”,再点击“✓”,并点击确认以更新所有预装的插件!**
30+
2931
#### 数据库服务
3032

3133
ChatLuna 需要 `database` 服务,用于存储会话信息等持久化数据。

docs/public/resources/character_preset.yml

Lines changed: 52 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,35 @@
1-
# 本文件最后更新时间:2026-05-20
2-
#
3-
# 使用须知
4-
#
5-
# 本预设依赖以下插件,请自行安装,不要忘记在修改后点击右上角的“重载配置”按钮:
1+
# 本文件最后更新时间:2026-06-01
2+
#
3+
# 使用须知
4+
# 推荐使用以下插件,如有需要请自行安装,不要忘记在修改后点击右上角的“重载配置”按钮:
5+
#
66
# - chatluna-long-memory
77
# - 插件用途:提供长期记忆功能
88
# - 配置说明:
99
# - 将所有“长期记忆引擎配置”改为“Basic”,“启用的记忆检索层”只勾选“群组层”
10+
#
1011
# - chatluna-forward-msg
11-
# - 插件用途:可选,提供合并转发记录读取、发送功能
12+
# - 插件用途:提供合并转发记录读取、发送功能
1213
# - 配置说明:
1314
# - 在“协议选择”中启用“NapCat OneBot”或“LLBot OneBot”中你使用的协议
1415
# - 在“图片描述服务”中选择一个多模态模型
1516
# - 在 chatluna 插件的“对话行为选项”中启用:attachForwardMsgIdToContext
1617
# - 在 chatluna-character 插件对应会话配置的“上下文”中启用:enableMessageId
18+
#
1719
# - chatluna-plugin-common
1820
# - 插件用途:提供一些通用的工具,包括本预设中用到的群管工具
1921
# - 配置说明:
2022
# - 只启用“群管插件”,其他选项全部关闭
2123
# - 在“群管插件配置”中配置好“允许使用群管功能的成员 ID 列表”(可以要求 Bot 使用群管功能的人)和“允许使用群管功能的群 ID 白名单”
24+
#
2225
# - chatluna-toolbox
2326
# - 插件用途:提供戳一戳、贴表情、撤回消息等功能
2427
# - 配置说明:
2528
# - 在“原生工具”中启用“NapCat OneBot”或“LLBot OneBot”中你使用的协议
26-
# - 在“XML 工具”中启用除了“injectXmlToolAsReplyTool”和“enableBanXmlTool”之外的全部选项
29+
# - 在“XML 工具”中启用除了“enableBanXmlTool”之外的全部选项
2730
# - 其他选项全部关闭
28-
# - chatluna-storage-service
31+
#
32+
# - chatluna-storage-service(强烈建议安装)
2933
# - 插件用途:提供文件存储服务,防止 QQ 图床链接过期
3034
# - 配置说明:
3135
# - 将“存储后端类型”改为“本地文件存储”
@@ -37,28 +41,53 @@
3741
# - 不建议使用容器在宿主机的内网 IP 连接,因为容器的内网 IP 可能会在重启后重新分配,导致原有连接断开
3842
# - 其他部署:
3943
# - 其他部署方案(如 Windows),请尝试保持默认地址“http://127.0.0.1:5140”,不要修改
40-
# - chatluna-google-gemini-adapter(可选,使用 Gemini 系列时推荐)
44+
#
45+
# - chatluna-google-gemini-adapter(使用 Gemini 系列时推荐)
4146
# - 插件用途:提供 Gemini 模型接入
4247
# - 配置说明:
4348
# - Gemini API 请求地址末尾需添加 /v1beta
44-
# - chatluna-multimodal-service(可选,使用 Gemini 或不支持图像输入的模型时推荐)
49+
#
50+
# - chatluna-multimodal-service(使用 Gemini 或不支持图像输入的模型时推荐)
4551
# - 插件用途:提供图像描述服务、图像及文件(含视频)读取/描述工具
4652
# - 配置说明:
4753
# - 若使用 Gemini,可以启用 enableImageReadTool、enableFileReadTool
4854
# - 若使用不支持图像输入的模型(如 DeepSeek),可以启用 enableContextImageDescription、enableImageReadTool,并在图像描述服务设置中配置一个支持图像输入的模型以生成图像描述
49-
# - chatluna-agent(可选,用于进行控制工具在任意会话中的权限、进行文件处理、使用子 Agent 节约时间与 token 开销等用途)
50-
# - 插件用途:提供丰富的 Agent 相关能力(Skill、子 Agent、沙盒终端等)
51-
# - 配置说明:暂未撰写文档,并且缺乏一些好用的默认Skill、Agent示例,可以先等等
52-
# - emojiluna
55+
#
56+
# - chatluna-agent
57+
# - 插件用途:提供丰富的 Agent 相关能力(Skill、子 Agent、沙盒终端等),可控制工具在任意会话中的权限、进行文件处理、使用子 Agent 节约时间与 token 开销
58+
# - 配置说明:暂未撰写文档,并且缺乏一些好用的默认 Skill、Agent 示例,可以先等等
59+
#
60+
# - memesluna
5361
# - 插件用途:提供表情包发送功能,建议自行准备一张“拒绝”类型的表情包
5462
# - 配置说明:
5563
# - 跟随指引即可
64+
#
65+
# - chatluna-llm-web-search
66+
# - 插件用途:提供全网/X 平台搜索、URL 读取功能
67+
# - 配置说明:
68+
# - 跟随指引即可
69+
#
70+
# - chatluna-social-media-reader
71+
# - 插件用途:提供 B 站、小红书视频/帖子读取功能
72+
# - 配置说明:
73+
# - 跟随指引即可
74+
#
75+
# - chatluna-google-reverse-image-search
76+
# - 插件用途:提供高质量的以图搜图功能
77+
# - 配置说明:
78+
# - 跟随指引即可
79+
#
80+
# - chatluna-qweather
81+
# - 插件用途:提供天气查询功能
82+
# - 配置说明:
83+
# - 跟随指引即可
84+
#
5685
# - 语音服务
5786
# - 插件用途:提供 TTS 服务用于发送语音
5887
# - 配置说明:
5988
# - 语音服务请自行寻找合适的插件或尝试使用 media-luna
6089
# - 如果无需使用,也可以直接删去 voice 相关描述
61-
#
90+
#
6291
# 重要提醒:
6392
# - 请在使用前自行修改其中的“CHARACTER”、“MASTER”、“USER”、“【记得改这里的ID!括号也要删掉!】”、“example.com”、“大部分群友的id及详细信息”等内容为你自己的
6493
# - 如果使用私聊,可复制一份本预设并删改部分信息
@@ -67,14 +96,15 @@
6796
# - 若没有安装对应的插件或是无管理员权限、不是官方 Bot 而无法发送 Markdown 消息等,请自行根据情况删改预设中的描述!
6897
# - 如:
6998
# - 开启了@功能,则删去“- 互动限制:不要尝试使用`at`,系统暂无此功能”
70-
# - Bot没有管理员权限,则删除禁言部分
99+
# - Bot 没有管理员权限,则删除禁言部分
71100
# - 没有安装表情包相关插件,则删除表情包部分
72-
# - 不是官方Bot则移除Markdown 消息部分
73-
# - 没有配置chatluna-agent等可以生成或修改文件的终端环境插件,则移除文件消息部分
101+
# - 没有安装长期记忆插件,则删除长期记忆部分
102+
# - 不是官方 Bot 则移除 Markdown 消息部分
103+
# - 没有配置 chatluna-agent 等可以生成或修改文件的终端环境插件,则移除文件消息部分
74104
# - <think> 部分的示例内容可以在 Bot 运行一段时间后挑一些看起来比较好的思考内容放进去
75105
# - 名词解释部分需要多填写一些内容,如你群里特定的梗、缩写等,避免Bot一直重复示例内容
76106
# - 如果你在使用官方 Bot 进行私聊(目前伪装插件对于官方 Bot 仅支持私聊),请开启 Koishi 插件 inspect,并向 Bot 发送 inspect,将其中“用户 ID”的值填写至 chatluna-character 的“应用到的私聊”配置中
77-
#
107+
#
78108
# 作者的话:
79109
# 感谢你使用了卢恩伪装插件预设模板!如有问题,敬请优先查询 ChatLuna 文档:
80110
# 通用文档:https://chatluna.chat/guide/introduction.html
@@ -241,8 +271,7 @@ system: |
241271
- 互动限制:不要尝试使用`at`,系统暂无此功能
242272
- 引用消息回复:如果你想回复的消息并非最后一条,可以选择使用引用消息回复
243273
- 发送表情包:
244-
- 可用表情包列表:
245-
{emojis}
274+
{memesluna}
246275
- 你只能从系统提示中有的分类中选一项发送,每一条消息中**只能发送一次**表情包
247276
- “拒绝”类型的表情包的发送应当十分谨慎,只在事态非常非常非常令你恼火或是不合适的情况下才能发送
248277
- 一般不要对别人发的表情包进行回复,那会很突兀
@@ -409,13 +438,13 @@ system: |
409438
</output>
410439
- 表情包:
411440
<output>
412-
<message><sticker>http://example.com/emojiluna/get/id-123</sticker></message>
441+
<message><sticker>{base_url}/memesluna/example</sticker></message>
413442
</output>
414443
- 组合消息:
415444
<output>
416445
<message quote="id">消息1文本</message>
417446
<message>消息2文本</message>
418-
<message><sticker>http://example.com/emojiluna/get/id-123</sticker></message>
447+
<message><sticker>{base_url}/memesluna/example</sticker></message>
419448
</output>
420449
421450
# **最高指令**

docs/public/resources/character_preset_tool_call.yml

Lines changed: 48 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,35 @@
1-
# 本文件最后更新时间:2026-05-20
2-
#
3-
# 使用须知
4-
#
5-
# 本预设依赖以下插件,请自行安装,不要忘记在修改后点击右上角的“重载配置”按钮:
1+
# 本文件最后更新时间:2026-06-01
2+
#
3+
# 使用须知
4+
# 推荐使用以下插件,如有需要请自行安装,不要忘记在修改后点击右上角的“重载配置”按钮:
5+
#
66
# - chatluna-long-memory
77
# - 插件用途:提供长期记忆功能
88
# - 配置说明:
99
# - 将所有“长期记忆引擎配置”改为“Basic”,“启用的记忆检索层”只勾选“群组层”
10+
#
1011
# - chatluna-forward-msg
11-
# - 插件用途:可选,提供合并转发记录读取、发送功能
12+
# - 插件用途:提供合并转发记录读取、发送功能
1213
# - 配置说明:
1314
# - 在“协议选择”中启用“NapCat OneBot”或“LLBot OneBot”中你使用的协议
1415
# - 在“图片描述服务”中选择一个多模态模型
1516
# - 在 chatluna 插件的“对话行为选项”中启用:attachForwardMsgIdToContext
1617
# - 在 chatluna-character 插件对应会话配置的“上下文”中启用:enableMessageId
18+
#
1719
# - chatluna-plugin-common
1820
# - 插件用途:提供一些通用的工具,包括本预设中用到的群管工具
1921
# - 配置说明:
2022
# - 只启用“群管插件”,其他选项全部关闭
2123
# - 在“群管插件配置”中配置好“允许使用群管功能的成员 ID 列表”(可以要求 Bot 使用群管功能的人)和“允许使用群管功能的群 ID 白名单”
24+
#
2225
# - chatluna-toolbox
2326
# - 插件用途:提供戳一戳、贴表情、撤回消息等功能
2427
# - 配置说明:
2528
# - 在“原生工具”中启用“NapCat OneBot”或“LLBot OneBot”中你使用的协议
2629
# - 在“XML 工具”中启用除了“enableBanXmlTool”之外的全部选项
2730
# - 其他选项全部关闭
28-
# - chatluna-storage-service
31+
#
32+
# - chatluna-storage-service(强烈建议安装)
2933
# - 插件用途:提供文件存储服务,防止 QQ 图床链接过期
3034
# - 配置说明:
3135
# - 将“存储后端类型”改为“本地文件存储”
@@ -37,37 +41,64 @@
3741
# - 不建议使用容器在宿主机的内网 IP 连接,因为容器的内网 IP 可能会在重启后重新分配,导致原有连接断开
3842
# - 其他部署:
3943
# - 其他部署方案(如 Windows),请尝试保持默认地址“http://127.0.0.1:5140”,不要修改
40-
# - chatluna-google-gemini-adapter(可选,使用 Gemini 系列时推荐)
44+
#
45+
# - chatluna-google-gemini-adapter(使用 Gemini 系列时推荐)
4146
# - 插件用途:提供 Gemini 模型接入
4247
# - 配置说明:
4348
# - Gemini API 请求地址末尾需添加 /v1beta
44-
# - chatluna-multimodal-service(可选,使用 Gemini 或不支持图像输入的模型时推荐)
49+
#
50+
# - chatluna-multimodal-service(使用 Gemini 或不支持图像输入的模型时推荐)
4551
# - 插件用途:提供图像描述服务、图像及文件(含视频)读取/描述工具
4652
# - 配置说明:
4753
# - 若使用 Gemini,可以启用 enableImageReadTool、enableFileReadTool
4854
# - 若使用不支持图像输入的模型(如 DeepSeek),可以启用 enableContextImageDescription、enableImageReadTool,并在图像描述服务设置中配置一个支持图像输入的模型以生成图像描述
49-
# - chatluna-agent(可选,用于进行控制工具在任意会话中的权限、进行文件处理、使用子 Agent 节约时间与 token 开销等用途)
50-
# - 插件用途:提供丰富的 Agent 相关能力(Skill、子 Agent、沙盒终端等)
51-
# - 配置说明:暂未撰写文档,并且缺乏一些好用的默认Skill、Agent示例,可以先等等
52-
# - emojiluna
55+
#
56+
# - chatluna-agent
57+
# - 插件用途:提供丰富的 Agent 相关能力(Skill、子 Agent、沙盒终端等),可控制工具在任意会话中的权限、进行文件处理、使用子 Agent 节约时间与 token 开销
58+
# - 配置说明:暂未撰写文档,并且缺乏一些好用的默认 Skill、Agent 示例,可以先等等
59+
#
60+
# - memesluna
5361
# - 插件用途:提供表情包发送功能,建议自行准备一张“拒绝”类型的表情包
5462
# - 配置说明:
5563
# - 跟随指引即可
64+
#
65+
# - chatluna-llm-web-search
66+
# - 插件用途:提供全网/X 平台搜索、URL 读取功能
67+
# - 配置说明:
68+
# - 跟随指引即可
69+
#
70+
# - chatluna-social-media-reader
71+
# - 插件用途:提供 B 站、小红书视频/帖子读取功能
72+
# - 配置说明:
73+
# - 跟随指引即可
74+
#
75+
# - chatluna-google-reverse-image-search
76+
# - 插件用途:提供高质量的以图搜图功能
77+
# - 配置说明:
78+
# - 跟随指引即可
79+
#
80+
# - chatluna-qweather
81+
# - 插件用途:提供天气查询功能
82+
# - 配置说明:
83+
# - 跟随指引即可
84+
#
5685
# - 语音服务
5786
# - 插件用途:提供 TTS 服务用于发送语音
5887
# - 配置说明:
5988
# - 语音服务请自行寻找合适的插件或尝试使用 media-luna
6089
# - 如果无需使用,也可以直接删去 voice 相关描述
61-
#
90+
#
6291
# 重要提醒:
6392
# - 请在使用前自行修改其中的“CHARACTER”、“MASTER”、“USER”、“【记得改这里的ID!括号也要删掉!】”、“example.com”、“大部分群友的id及详细信息”等内容为你自己的
6493
# - 如果使用私聊,可复制一份本预设并删改部分信息
65-
# - 如果固定间隔触发中的消息间隔设定为 0,将会启用发言等待功能,建议删去预设中的 next_reply 相关内容避免冲突
6694
# - 确保各种涉及工具的内容已经配置妥当、Bot 拥有相关权限
95+
# - 如:
96+
# - 没有安装表情包相关插件,则删除表情包部分
97+
# - 没有安装长期记忆插件,则删除长期记忆部分
6798
# - <think> 部分的示例内容可以在 Bot 运行一段时间后挑一些看起来比较好的思考内容放进去
6899
# - 名词解释部分需要多填写一些内容,如你群里特定的梗、缩写等,避免Bot一直重复示例内容
69100
# - 如果你在使用官方 Bot 进行私聊(目前伪装插件对于官方 Bot 仅支持私聊),请开启 Koishi 插件 inspect,并向 Bot 发送 inspect,将其中“用户 ID”的值填写至 chatluna-character 的“应用到的私聊”配置中
70-
#
101+
#
71102
# 作者的话:
72103
# 感谢你使用了卢恩伪装插件预设模板!如有问题,敬请优先查询 ChatLuna 文档:
73104
# 通用文档:https://chatluna.chat/guide/introduction.html
@@ -186,8 +217,7 @@ system: |
186217
- 格式:纯文本,不在回复中使用Markdown、LaTeX,除非另有要求
187218
- 引用消息回复:如果你想回复的消息并非最后一条,可以选择使用引用消息回复
188219
- 发送表情包:
189-
- 可用表情包列表:
190-
{emojis}
220+
{memesluna}
191221
- 你只能从系统提示中有的分类中选一项发送,每一条消息中**只能发送一次**表情包
192222
- “拒绝”类型的表情包的发送应当十分谨慎,只在事态非常非常非常令你恼火或是不合适的情况下才能发送
193223
- 一般不要对别人发的表情包进行回复,那会很突兀

0 commit comments

Comments
 (0)