docs(character): 同步最新配置结构与默认预设说明#21
Conversation
|
Caution Review failedThe pull request is closed. ℹ️ Recent review info⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (2)
📝 WalkthroughWalkthroughUpdated documentation for ChatLuna character configuration and presets. Restructured character.md to reflect a new configuration hierarchy with global and session-level overrides. Updated character_preset.yml with revised plugin guidance, output format examples, and configuration clarifications. Changes
Estimated code review effort🎯 2 (Simple) | ⏱️ ~18 minutes Possibly related PRs
Suggested reviewers
Poem
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request updates the character plugin documentation to reflect a new configuration structure consisting of base, global, and session-specific settings. It also enhances the character preset template with updated protocol instructions, a file message example, and logic for handling message intervals. The review feedback suggests maintaining documentation consistency by adding terminal punctuation to descriptive comments within the YAML preset.
| # - 若 Koishi 与你的 Napcat 或 LLBot 使用Docker部署在同一个容器中，请尝试保持默认地址“http://127.0.0.1:5140”，不要修改 | ||
| # - 若 Koishi 与你的 Napcat 或 LLBot 使用Docker部署在不同容器中、但使用同一个 Docker 网桥时，可以填写“http://koishi:5140”，5140 为你的 Koishi 容器内端口 | ||
| # - 如果不会，请尝试咨询AI | ||
| # - 不建议使用容器在宿主机的内网IP连接，因为容器的内网IP可能会在重启后重新分配，导致原有连接断开 | ||
| # - 其他部署： | ||
| # - 其他部署方案（如Windows），请尝试保持默认地址“http://127.0.0.1:5140”，不要修改 |
There was a problem hiding this comment.
为了保持文档注释的格式统一，建议在这些说明性语句的末尾添加中文句号“。”。
# - 若 Koishi 与你的 Napcat 或 LLBot 使用Docker部署在同一个容器中，请尝试保持默认地址“http://127.0.0.1:5140”，不要修改。
# - 若 Koishi 与你的 Napcat 或 LLBot 使用Docker部署在不同容器中、但使用同一个 Docker 网桥时，可以填写“http://koishi:5140”，5140 为你的 Koishi 容器内端口。
# - 如果不会，请尝试咨询AI。
# - 不建议使用容器在宿主机的内网IP连接，因为容器的内网IP可能会在重启后重新分配，导致原有连接断开。
# - 其他部署：
# - 其他部署方案（如Windows），请尝试保持默认地址“http://127.0.0.1:5140”，不要修改。| # - Gemini API 请求地址末尾需添加 /v1beta | ||
| # - chatluna-multimodal-service（可选，使用 Gemini 或不支持图像输入的模型时推荐） | ||
| # - 插件用途：提供图像描述服务、图像及文件（含视频）读取/描述工具 | ||
| # - 配置说明： | ||
| # - 若使用 Gemini，可以启用 enableImageReadTool、enableFileReadTool | ||
| # - 若使用不支持图像输入的模型（如 DeepSeek），可以启用 enableContextImageDescription、enableImageReadTool，并在图像描述服务设置中配置一个支持图像输入的模型以生成图像描述 | ||
| # - chatluna-agent（可选，用于进行文件处理、使用子Agent节约时间和token开销等用途） | ||
| # - 插件用途：提供丰富的Agent相关能力（Skill、子Agent、沙盒……） | ||
| # - 配置说明：此插件暂未达到稳定可用状态，不推荐使用 |
There was a problem hiding this comment.
为了保持文档注释的格式统一，建议在这些说明性语句的末尾添加中文句号“。”。
# - Gemini API 请求地址末尾需添加 /v1beta。
# - chatluna-multimodal-service（可选，使用 Gemini 或不支持图像输入的模型时推荐）
# - 插件用途：提供图像描述服务、图像及文件（含视频）读取/描述工具
# - 配置说明：
# - 若使用 Gemini，可以启用 enableImageReadTool、enableFileReadTool。
# - 若使用不支持图像输入的模型（如 DeepSeek），可以启用 enableContextImageDescription、enableImageReadTool，并在图像描述服务设置中配置一个支持图像输入的模型以生成图像描述。
# - chatluna-agent（可选，用于进行文件处理、使用子Agent节约时间和token开销等用途）
# - 插件用途：提供丰富的Agent相关能力（Skill、子Agent、沙盒……）
# - 配置说明：此插件暂未达到稳定可用状态，不推荐使用。| # - 请在使用前自行修改其中的“CHARACTER”、“MASTER”、“USER”、“记！得！改！这！里！的！ID！”、“example.com”、“大部分群友的id及详细信息”等内容为你自己的 | ||
| # - 如果使用私聊，可复制一份本预设并删改部分信息 | ||
| # - 确保各种涉及工具的内容已经配置妥当、Bot拥有相关权限 | ||
| # - 若没有安装对应的插件或是无管理员权限、不是官方Bot而无法发送Markdown消息等，请自行根据情况删改预设中的描述！尤其是表情包相关！ | ||
| # - <think>部分的示例内容可以在Bot运行一段时间后挑一些看起来比较好的思考内容放进去 | ||
| # - 如果你在使用官方 Bot 进行私聊（目前伪装插件对于官方 Bot 仅支持私聊），请开启Koishi插件 inspect，并向Bot发送 inspect，将其中“用户ID”的值填写至 chatluna-character 的“应用到的私聊”配置中 | ||
| # - 如果固定间隔触发中的消息间隔设定为 0，将会启用发言等待功能，建议删去预设中的 next_reply 相关内容避免冲突 | ||
| # - 确保各种涉及工具的内容已经配置妥当、Bot 拥有相关权限 | ||
| # - 若没有安装对应的插件或是无管理员权限、不是官方 Bot 而无法发送 Markdown 消息等，请自行根据情况删改预设中的描述！如：表情包、Markdown 消息、文件消息等！ | ||
| # - <think> 部分的示例内容可以在 Bot 运行一段时间后挑一些看起来比较好的思考内容放进去 | ||
| # - 如果你在使用官方 Bot 进行私聊（目前伪装插件对于官方 Bot 仅支持私聊），请开启Koishi插件 inspect，并向 Bot 发送 inspect，将其中“用户ID”的值填写至 chatluna-character 的“应用到的私聊”配置中 |
There was a problem hiding this comment.
为了保持文档注释的格式统一，建议在这些说明性语句的末尾添加中文句号“。”（已包含感叹号的除外）。
# - 请在使用前自行修改其中的“CHARACTER”、“MASTER”、“USER”、“记！得！改！这！里！的！ID！”、“example.com”、“大部分群友的id及详细信息”等内容为你自己的。
# - 如果使用私聊，可复制一份本预设并删改部分信息。
# - 如果固定间隔触发中的消息间隔设定为 0，将会启用发言等待功能，建议删去预设中的 next_reply 相关内容避免冲突。
# - 确保各种涉及工具的内容已经配置妥当、Bot 拥有相关权限。
# - 若没有安装对应的插件或是无管理员权限、不是官方 Bot 而无法发送 Markdown 消息等，请自行根据情况删改预设中的描述！如：表情包、Markdown 消息、文件消息等！
# - <think> 部分的示例内容可以在 Bot 运行一段时间后挑一些看起来比较好的思考内容放进去。
# - 如果你在使用官方 Bot 进行私聊（目前伪装插件对于官方 Bot 仅支持私聊），请开启Koishi插件 inspect，并向 Bot 发送 inspect，将其中“用户ID”的值填写至 chatluna-character 的“应用到的私聊”配置中。
1 participant
总结
Summary by CodeRabbit