AstrBot 4.11.3__tar.gz → 4.12.0__tar.gz

astrbot-4.12.0/EULA.md

@@ -0,0 +1,244 @@
+# 最终用户许可协议（EULA）
+
+> 我们热爱开源软件，并始终致力于为所有用户提供健康、安全、可靠的使用体验。 ❤️
+
+For English edition, please refer to the section below the Chinese version.
+
+**最后更新：** 2026-01-12
+
+感谢您使用 **AstrBot**。
+在使用本项目之前，请仔细阅读以下声明内容。
+
+**您一旦安装、运行或使用本项目，即表示您已阅读、理解并同意本声明中的全部内容。**
+
+## 1. 项目性质
+
+AstrBot 是一个遵循 **GNU Affero General Public License v3（AGPLv3）** 协议发布的**免费开源软件项目**。
+
+* 截至目前，AstrBot 项目未开展任何形式的商业化服务，AstrBot 团队也未通过本项目向用户提供任何收费服务。若您因使用 AstrBot 被要求付费，请务必提高警惕，谨防诈骗行为。
+* AstrBot 的代码实现未对任何第三方系统进行逆向工程、破解、反编译或绕过安全机制等行为。AstrBot 仅使用并支持各即时通讯（IM）平台官方公开提供的机器人接入接口、开放平台能力或相关通信协议进行集成与通信。
+
+## 2. 无担保声明
+
+AstrBot 按“**现状（as is）**”提供，不附带任何形式的明示或暗示担保。
+
+AstrBot 团队不对以下内容作出任何保证：
+
+* 系统本身的安全性、可靠性或稳定性；
+* 任何第三方插件的安全性、正确性或可信度；
+* 任何第三方 AI 模型或外部服务 API 的可用性、质量、准确性或安全性；
+* 本软件对任何特定用途的适用性。
+
+**您使用本软件所产生的一切风险均由您自行承担。**
+
+## 3. 第三方插件与服务
+
+* AstrBot 支持第三方插件及外部 AI 服务接入；
+* AstrBot 团队**不对任何第三方插件、扩展或服务进行审计、控制、背书或担保**；
+* 因使用第三方插件或服务所产生的任何风险、损失、数据泄露或法律后果，均由用户自行承担。
+* 第三方插件指代的是非 AstrBot 自带的插件，AstrBot 自带的插件指代的是插件实现代码已经包含在 AstrBotDevs/AstrBot 代码库中的插件。插件市场中的插件都是第三方插件。
+
+## 4. 使用与内容限制
+
+您同意不会将 AstrBot 用于以下行为：
+
+* 输入、生成、传播或处理任何违法、极端、暴力、色情、仇恨、辱骂或其他有害内容；
+* 从事违反您所在国家或地区法律法规，或任何适用国际法律的行为；
+* 试图绕过、关闭、削弱或破坏本系统内置的安全机制或内容限制。
+* 任何侵犯他人合法权益、损害他人和自己身心健康、涉及个人隐私、个人信息等敏感内容的内容。
+
+## 5. 项目用途说明
+
+AstrBot 是一个**工具型对话与 Agent 系统**，在**安全、健康、友善**的前提下提供有限的人性化交互能力。
+
+项目的主要目标是：
+
+* 提供 Agent 能力与自动化辅助；
+* 帮助用户提升工作、学习和信息处理效率；
+* 在合理范围内提供友好的人机交互体验。
+* 辅助用户成长，提供有益于用户身心健康的内容。
+
+## 6. 安全措施说明
+
+AstrBot 团队**已尽合理努力在技术和策略层面设置安全与内容约束机制**，以引导系统输出健康、友善、安全的内容。
+
+但请理解：
+
+* 世界上任何的系统均无法保证完全无误、绝对安全或无法被滥用；
+* 用户仍有责任自行合理配置、监督并正确使用本系统。
+
+如果您要关闭 AstrBot 默认启用的“健康模式”，请在 cmd_config.json 中将 `provider_settings.llm_safety_mode` 设置为 `False`。但请注意，关闭健康模式不是推荐的使用方式，可能导致系统输出不安全或不适当的内容。关闭该功能所产生的任何风险与后果，均由用户自行承担，AstrBot 团队不对此承担任何责任。
+
+## 7. 心理健康提示
+
+如果您在使用本项目过程中因系统输出内容而感到心理不适、情绪困扰，  
+或您本身正处于心理压力较大、情绪不稳定、焦虑、抑郁等状态并因此使用本项目，  
+请优先考虑寻求来自专业人士的帮助，例如心理咨询师、心理医生或当地心理援助机构。
+
+如遇紧急情况（例如存在自伤或他伤风险），请立即联系当地的紧急救助电话或专业机构。
+
+## 8. 统计信息与隐私说明
+
+AstrBot 可能会收集有限的匿名统计信息，用于了解系统使用情况、发现问题以及持续改进项目。
+
+所收集的统计信息仅包括与系统运行和功能使用相关的基础技术指标，例如功能使用频率、错误信息等。
+
+AstrBot **不会收集、上传或存储您的对话内容、消息正文、输入文本，或任何能够识别您个人身份的敏感信息**。
+
+您可以手动关闭此项功能，通过在系统环境变量中设置 `ASTRBOT_DISABLE_METRICS=1` 来禁用匿名统计信息收集。
+
+## 9. 责任限制
+
+在法律允许的最大范围内，AstrBot 团队不对因以下原因导致的任何直接或间接损失承担责任，包括但不限于：
+
+* 使用或无法使用本软件；
+* 使用第三方插件或服务；
+* 系统生成的内容或输出；
+* 数据丢失、服务中断或安全事件。
+
+## 10. 条款的接受
+
+您一旦安装、运行、修改或使用 AstrBot，即确认：
+
+* 您已阅读并理解本声明内容；
+* 您同意并接受上述所有条款；
+* 您对自身使用行为承担全部责任。
+
+如您不同意本声明的任何内容，请勿使用本项目。
+
+## 11. 许可与版权
+
+AstrBot 的源代码、文档及相关内容受版权法及相关法律保护。
+
+在遵守本声明及 AGPLv3 协议的前提下，AstrBot 授予您一项非独占、不可转让、不可再许可的许可，用于下载、安装、运行、修改和分发本软件。
+
+除非法律另有规定或本声明另有明确说明，AstrBot 团队保留本项目的所有未明确授予的权利。
+
+## 12. 适用法律
+
+本声明的解释与适用应遵循您所在地或项目发布地适用的法律法规。
+
+如本声明的任何条款被认定为无效或不可执行，其余条款仍然有效。
+
+---
+
+# EULA
+
+> We love open-source software and are always committed to providing all users with a healthy, safe, and reliable experience. ❤️
+
+**Last updated:** January 12, 2026
+
+Thank you for using **AstrBot**.
+Please read the following notice carefully before using this project.
+
+**By installing, running, or using this project, you acknowledge that you have read, understood, and agreed to all the terms stated below.**
+
+## 1. Nature of the Project
+
+AstrBot is a **free and open-source software project** released under the **GNU Affero General Public License v3 (AGPLv3)**.
+
+* AstrBot does not constitute any form of commercial service;
+* The AstrBot Team does not provide any paid services through this project;
+* AstrBot’s implementation does not involve reverse engineering, cracking, decompilation, or circumvention of security mechanisms of any third-party systems. AstrBot only uses and supports officially published bot integration interfaces, open platform capabilities, or related communication protocols provided by instant messaging (IM) platforms for integration and communication.
+
+## 2. No Warranty
+
+AstrBot is provided **“as is”**, without any express or implied warranties.
+
+The AstrBot Team makes no guarantees regarding:
+
+* The security, reliability, or stability of the system;
+* The security, correctness, or trustworthiness of any third-party plugins;
+* The availability, quality, accuracy, or safety of any third-party AI model APIs or external services;
+* The fitness of the software for any particular purpose.
+
+**All risks arising from the use of this software are borne solely by the user.**
+
+## 3. Third-Party Plugins and Services
+
+* AstrBot supports third-party plugins and external AI services;
+* The AstrBot Team does **not audit, control, endorse, or guarantee** any third-party plugins, extensions, or services;
+* Any risks, losses, data leaks, or legal consequences arising from the use of third-party plugins or services are solely the responsibility of the user;
+* “Third-party plugins” refer to plugins that are not built into AstrBot. Built-in plugins are those whose implementation code is included in the AstrBotDevs/AstrBot repository. All plugins available in the plugin marketplace are third-party plugins.
+
+## 4. Usage and Content Restrictions
+
+You agree not to use AstrBot for any of the following activities:
+
+* Inputting, generating, distributing, or processing any illegal, extremist, violent, pornographic, hateful, abusive, or otherwise harmful content;
+* Engaging in activities that violate the laws or regulations of your country or region, or any applicable international laws;
+* Attempting to bypass, disable, weaken, or undermine the built-in safety mechanisms or content restrictions of the system;
+* Any activities that infringe upon the legitimate rights and interests of others, harm the physical or mental well-being of yourself or others, or involve personal privacy or sensitive personal information.
+
+## 5. Intended Use
+
+AstrBot is a **tool-oriented conversational and agent system** that provides limited human-like interaction capabilities under the principles of **safety, health, and friendliness**.
+
+The primary goals of the project are to:
+
+* Provide agent capabilities and automation assistance;
+* Help users improve efficiency in work, study, and information processing;
+* Offer a friendly human–computer interaction experience within reasonable boundaries;
+* Support user growth and provide content beneficial to users’ physical and mental well-being.
+
+## 6. Safety Measures
+
+The AstrBot Team has made **reasonable efforts** at both technical and policy levels to implement safety and content restriction mechanisms, guiding the system to produce healthy, friendly, and safe outputs.
+
+However, please understand that:
+
+* No system in the world can be guaranteed to be completely error-free, absolutely secure, or immune to misuse;
+* Users remain responsible for properly configuring, supervising, and using the system.
+
+If you wish to disable AstrBot’s default “Safety Mode,” please set `provider_settings.llm_safety_mode` to `False` in `cmd_config.json`. However, please note that disabling Safety Mode is not recommended and may lead to unsafe or inappropriate outputs. Any risks or consequences arising from disabling this feature are solely borne by the user, and the AstrBot Team assumes no responsibility.
+
+## 7. Mental Health Notice
+
+If you experience psychological discomfort or emotional distress due to system outputs during use,
+or if you are experiencing significant psychological stress, emotional instability, anxiety, or depression and are using this project for such reasons,
+please prioritize seeking help from qualified professionals, such as psychologists, psychiatrists, or local mental health support services.
+
+In case of emergency (for example, if there is a risk of self-harm or harm to others), please immediately contact your local emergency number or professional crisis support services.
+
+## 8. Metrics and Privacy
+
+AstrBot may collect a limited amount of anonymous usage statistics to understand system usage, identify issues, and continuously improve the project.
+
+Collected metrics are limited to basic technical indicators related to system operation and feature usage, such as feature usage frequency and error information.
+
+AstrBot **does not collect, upload, or store your conversation content, message bodies, input text, or any personally identifiable or sensitive information**.
+
+You may manually disable this feature by setting the environment variable `ASTRBOT_DISABLE_METRICS=1` to turn off anonymous metrics collection.
+
+## 9. Limitation of Liability
+
+To the maximum extent permitted by law, the AstrBot Team shall not be liable for any direct or indirect losses arising from, including but not limited to:
+
+* The use or inability to use this software;
+* The use of third-party plugins or services;
+* Generated content or system outputs;
+* Data loss, service interruptions, or security incidents.
+
+## 10. Acceptance of Terms
+
+By installing, running, modifying, or using AstrBot, you confirm that:
+
+* You have read and understood this Notice;
+* You agree to and accept all the terms stated above;
+* You assume full responsibility for your use of the software.
+
+If you do not agree with any part of this Notice, please do not use this project.
+
+## 11. License and Copyright
+
+The source code, documentation, and related materials of AstrBot are protected by copyright laws and applicable regulations.
+
+Subject to compliance with this Notice and the AGPLv3 license, AstrBot grants you a non-exclusive, non-transferable, non-sublicensable license to download, install, run, modify, and distribute this software.
+
+Unless otherwise required by law or expressly stated in this Notice, the AstrBot Team reserves all rights not expressly granted.
+
+## 12. Governing Law
+
+The interpretation and application of this Notice shall be governed by the laws and regulations applicable in your jurisdiction or the jurisdiction where the project is released.
+
+If any provision of this Notice is held to be invalid or unenforceable, the remaining provisions shall remain in full force and effect.

{astrbot-4.11.3 → astrbot-4.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: AstrBot
-Version: 4.11.3
+Version: 4.12.0
 Summary: Easy-to-use multi-platform LLM chatbot and development framework
 License-File: LICENSE
 Keywords: Astrbot,Astrbot Module,Astrbot Plugin
@@ -47,6 +47,7 @@ Requires-Dist: qq-botpy>=1.2.1
 Requires-Dist: quart>=0.20.0
 Requires-Dist: rank-bm25>=0.2.2
 Requires-Dist: readability-lxml>=0.8.4.1
+Requires-Dist: shipyard-python-sdk>=0.2.4
 Requires-Dist: silk-python>=0.2.6
 Requires-Dist: slack-sdk>=3.35.0
 Requires-Dist: sqlalchemy[asyncio]>=2.0.41
@@ -196,8 +197,6 @@ uv run main.py
 - [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter)
 - [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter)
 - [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat)
-- [Bilibili 私信](https://github.com/Hina-Chat/astrbot_plugin_bilibili_adapter)
-- [wxauto](https://github.com/luosheng520qaq/wxauto-repost-onebotv11)
 
 ## 支持的模型服务
 

{astrbot-4.11.3 → astrbot-4.12.0}/README.md

@@ -135,8 +135,6 @@ uv run main.py
 - [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter)
 - [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter)
 - [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat)
-- [Bilibili 私信](https://github.com/Hina-Chat/astrbot_plugin_bilibili_adapter)
-- [wxauto](https://github.com/luosheng520qaq/wxauto-repost-onebotv11)
 
 ## 支持的模型服务
 

{astrbot-4.11.3 → astrbot-4.12.0}/README_en.md

@@ -137,8 +137,6 @@ Or refer to the official documentation: [Deploy AstrBot from Source](https://ast
 - [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter)
 - [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter)
 - [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat)
-- [Bilibili Direct Messages](https://github.com/Hina-Chat/astrbot_plugin_bilibili_adapter)
-- [wxauto](https://github.com/luosheng520qaq/wxauto-repost-onebotv11)
 
 ## Supported Model Services
 

{astrbot-4.11.3 → astrbot-4.12.0}/README_fr.md

@@ -137,8 +137,6 @@ Ou consultez la documentation officielle : [Déployer AstrBot depuis les sources
 - [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter)
 - [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter)
 - [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat)
-- [Messages directs Bilibili](https://github.com/Hina-Chat/astrbot_plugin_bilibili_adapter)
-- [wxauto](https://github.com/luosheng520qaq/wxauto-repost-onebotv11)
 
 ## Services de modèles pris en charge
 

{astrbot-4.11.3 → astrbot-4.12.0}/README_ja.md

@@ -137,8 +137,7 @@ uv run main.py
 - [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter)
 - [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter)
 - [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat)
-- [Bilibili ダイレクトメッセージ](https://github.com/Hina-Chat/astrbot_plugin_bilibili_adapter)
-- [wxauto](https://github.com/luosheng520qaq/wxauto-repost-onebotv11)
+
 
 ## サポートされているモデルサービス
 

{astrbot-4.11.3 → astrbot-4.12.0}/README_ru.md

@@ -137,8 +137,6 @@ uv run main.py
 - [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter)
 - [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter)
 - [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat)
-- [Личные сообщения Bilibili](https://github.com/Hina-Chat/astrbot_plugin_bilibili_adapter)
-- [wxauto](https://github.com/luosheng520qaq/wxauto-repost-onebotv11)
 
 ## Поддерживаемые сервисы моделей
 

{astrbot-4.11.3 → astrbot-4.12.0}/README_zh-TW.md

@@ -137,8 +137,6 @@ uv run main.py
 - [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter)
 - [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter)
 - [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat)
-- [Bilibili 私訊](https://github.com/Hina-Chat/astrbot_plugin_bilibili_adapter)
-- [wxauto](https://github.com/luosheng520qaq/wxauto-repost-onebotv11)
 
 ## 支援的模型服務
 

astrbot-4.12.0/astrbot/cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "4.12.0"

{astrbot-4.11.3 → astrbot-4.12.0}/astrbot/core/agent/runners/tool_loop_agent_runner.py

@@ -227,7 +227,8 @@ class ToolLoopAgentRunner(BaseAgentRunner[TContext]):
                         encrypted=llm_resp.reasoning_signature,
                     )
                 )
-            parts.append(TextPart(text=llm_resp.completion_text or "*No response*"))
+            if llm_resp.completion_text:
+                parts.append(TextPart(text=llm_resp.completion_text))
             self.run_context.messages.append(Message(role="assistant", content=parts))
 
             # call the on_agent_done hook
@@ -277,7 +278,8 @@ class ToolLoopAgentRunner(BaseAgentRunner[TContext]):
                         encrypted=llm_resp.reasoning_signature,
                     )
                 )
-            parts.append(TextPart(text=llm_resp.completion_text or "*No response*"))
+            if llm_resp.completion_text:
+                parts.append(TextPart(text=llm_resp.completion_text))
             tool_calls_result = ToolCallsResult(
                 tool_calls_info=AssistantMessageSegment(
                     tool_calls=llm_resp.to_openai_to_calls_model(),
@@ -361,7 +363,7 @@ class ToolLoopAgentRunner(BaseAgentRunner[TContext]):
                         ToolCallMessageSegment(
                             role="tool",
                             tool_call_id=func_tool_id,
-                            content=f"error: 未找到工具 {func_tool_name}",
+                            content=f"error: Tool {func_tool_name} not found.",
                         ),
                     )
                     continue
@@ -427,7 +429,7 @@ class ToolLoopAgentRunner(BaseAgentRunner[TContext]):
                                 ToolCallMessageSegment(
                                     role="tool",
                                     tool_call_id=func_tool_id,
-                                    content="返回了图片(已直接发送给用户)",
+                                    content="The tool has successfully returned an image and sent directly to the user. You can describe it in your next response.",
                                 ),
                             )
                             yield MessageChain(type="tool_direct_result").base64_image(
@@ -452,7 +454,7 @@ class ToolLoopAgentRunner(BaseAgentRunner[TContext]):
                                     ToolCallMessageSegment(
                                         role="tool",
                                         tool_call_id=func_tool_id,
-                                        content="返回了图片(已直接发送给用户)",
+                                        content="The tool has successfully returned an image and sent directly to the user. You can describe it in your next response.",
                                     ),
                                 )
                                 yield MessageChain(
@@ -463,7 +465,7 @@ class ToolLoopAgentRunner(BaseAgentRunner[TContext]):
                                     ToolCallMessageSegment(
                                         role="tool",
                                         tool_call_id=func_tool_id,
-                                        content="返回的数据类型不受支持",
+                                        content="The tool has returned a data type that is not supported.",
                                     ),
                                 )
 
@@ -480,7 +482,7 @@ class ToolLoopAgentRunner(BaseAgentRunner[TContext]):
                             ToolCallMessageSegment(
                                 role="tool",
                                 tool_call_id=func_tool_id,
-                                content="*工具没有返回值或者将结果直接发送给了用户*",
+                                content="The tool has no return value, or has sent the result directly to the user.",
                             ),
                         )
                     else:
@@ -492,7 +494,7 @@ class ToolLoopAgentRunner(BaseAgentRunner[TContext]):
                             ToolCallMessageSegment(
                                 role="tool",
                                 tool_call_id=func_tool_id,
-                                content="*工具返回了不支持的类型，请告诉用户检查这个工具的定义和实现。*",
+                                content="*The tool has returned an unsupported type. Please tell the user to check the definition and implementation of this tool.*",
                             ),
                         )
 

{astrbot-4.11.3 → astrbot-4.12.0}/astrbot/core/config/default.py

@@ -5,7 +5,7 @@ from typing import Any, TypedDict
 
 from astrbot.core.utils.astrbot_path import get_astrbot_data_path
 
-VERSION = "4.11.3"
+VERSION = "4.12.0"
 DB_PATH = os.path.join(get_astrbot_data_path(), "data_v4.db")
 
 WEBHOOK_SUPPORTED_PLATFORMS = [
@@ -113,6 +113,14 @@ DEFAULT_CONFIG = {
             "provider": "moonshotai",
             "moonshotai_api_key": "",
         },
+        "sandbox": {
+            "enable": False,
+            "booter": "shipyard",
+            "shipyard_endpoint": "",
+            "shipyard_access_token": "",
+            "shipyard_ttl": 3600,
+            "shipyard_max_sessions": 10,
+        },
     },
     "provider_stt_settings": {
         "enable": False,
@@ -242,7 +250,7 @@ CONFIG_METADATA_2 = {
                         "callback_server_host": "0.0.0.0",
                         "port": 6196,
                     },
-                    "OneBot v11 (QQ 个人号等)": {
+                    "OneBot v11": {
                         "id": "default",
                         "type": "aiocqhttp",
                         "enable": False,
@@ -989,17 +997,6 @@ CONFIG_METADATA_2 = {
                         "api_base": "http://127.0.0.1:1234/v1",
                         "custom_headers": {},
                     },
-                    "ModelStack": {
-                        "id": "modelstack",
-                        "provider": "modelstack",
-                        "type": "openai_chat_completion",
-                        "provider_type": "chat_completion",
-                        "enable": True,
-                        "key": [],
-                        "api_base": "https://modelstack.app/v1",
-                        "timeout": 120,
-                        "custom_headers": {},
-                    },
                     "Gemini_OpenAI_API": {
                         "id": "google_gemini_openai",
                         "provider": "google",
@@ -2550,6 +2547,62 @@ CONFIG_METADATA_3 = {
             #         "provider_settings.enable": True,
             #     },
             # },
+            "sandbox": {
+                "description": "Agent 沙箱环境",
+                "type": "object",
+                "items": {
+                    "provider_settings.sandbox.enable": {
+                        "description": "启用沙箱环境",
+                        "type": "bool",
+                        "hint": "启用后，Agent 可以使用沙箱环境中的工具和资源，如 Python 代码执行、Shell 等。",
+                    },
+                    "provider_settings.sandbox.booter": {
+                        "description": "沙箱环境驱动器",
+                        "type": "string",
+                        "options": ["shipyard"],
+                        "condition": {
+                            "provider_settings.sandbox.enable": True,
+                        },
+                    },
+                    "provider_settings.sandbox.shipyard_endpoint": {
+                        "description": "Shipyard API Endpoint",
+                        "type": "string",
+                        "hint": "Shipyard 服务的 API 访问地址。",
+                        "condition": {
+                            "provider_settings.sandbox.enable": True,
+                            "provider_settings.sandbox.booter": "shipyard",
+                        },
+                        "_special": "check_shipyard_connection",
+                    },
+                    "provider_settings.sandbox.shipyard_access_token": {
+                        "description": "Shipyard Access Token",
+                        "type": "string",
+                        "hint": "用于访问 Shipyard 服务的访问令牌。",
+                        "condition": {
+                            "provider_settings.sandbox.enable": True,
+                            "provider_settings.sandbox.booter": "shipyard",
+                        },
+                    },
+                    "provider_settings.sandbox.shipyard_ttl": {
+                        "description": "Shipyard Session TTL",
+                        "type": "int",
+                        "hint": "Shipyard 会话的生存时间（秒）。",
+                        "condition": {
+                            "provider_settings.sandbox.enable": True,
+                            "provider_settings.sandbox.booter": "shipyard",
+                        },
+                    },
+                    "provider_settings.sandbox.shipyard_max_sessions": {
+                        "description": "Shipyard Max Sessions",
+                        "type": "int",
+                        "hint": "Shipyard 最大会话数量。",
+                        "condition": {
+                            "provider_settings.sandbox.enable": True,
+                            "provider_settings.sandbox.booter": "shipyard",
+                        },
+                    },
+                },
+            },
             "truncate_and_compress": {
                 "description": "上下文管理策略",
                 "type": "object",

{astrbot-4.11.3 → astrbot-4.12.0}/astrbot/core/db/__init__.py

@@ -9,6 +9,7 @@ from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker, create_asyn
 
 from astrbot.core.db.po import (
     Attachment,
+    ChatUIProject,
     CommandConfig,
     CommandConflict,
     ConversationV2,
@@ -17,6 +18,7 @@ from astrbot.core.db.po import (
     PlatformSession,
     PlatformStat,
     Preference,
+    SessionProjectRelation,
     Stats,
 )
 
@@ -446,8 +448,11 @@ class BaseDatabase(abc.ABC):
         platform_id: str | None = None,
         page: int = 1,
         page_size: int = 20,
-    ) -> list[PlatformSession]:
-        """Get all Platform sessions for a specific creator (username) and optionally platform."""
+    ) -> list[dict]:
+        """Get all Platform sessions for a specific creator (username) and optionally platform.
+
+        Returns a list of dicts containing session info and project info (if session belongs to a project).
+        """
         ...
 
     @abc.abstractmethod
@@ -463,3 +468,80 @@ class BaseDatabase(abc.ABC):
     async def delete_platform_session(self, session_id: str) -> None:
         """Delete a Platform session by its ID."""
         ...
+
+    # ====
+    # ChatUI Project Management
+    # ====
+
+    @abc.abstractmethod
+    async def create_chatui_project(
+        self,
+        creator: str,
+        title: str,
+        emoji: str | None = "📁",
+        description: str | None = None,
+    ) -> ChatUIProject:
+        """Create a new ChatUI project."""
+        ...
+
+    @abc.abstractmethod
+    async def get_chatui_project_by_id(self, project_id: str) -> ChatUIProject | None:
+        """Get a ChatUI project by its ID."""
+        ...
+
+    @abc.abstractmethod
+    async def get_chatui_projects_by_creator(
+        self,
+        creator: str,
+        page: int = 1,
+        page_size: int = 100,
+    ) -> list[ChatUIProject]:
+        """Get all ChatUI projects for a specific creator."""
+        ...
+
+    @abc.abstractmethod
+    async def update_chatui_project(
+        self,
+        project_id: str,
+        title: str | None = None,
+        emoji: str | None = None,
+        description: str | None = None,
+    ) -> None:
+        """Update a ChatUI project."""
+        ...
+
+    @abc.abstractmethod
+    async def delete_chatui_project(self, project_id: str) -> None:
+        """Delete a ChatUI project by its ID."""
+        ...
+
+    @abc.abstractmethod
+    async def add_session_to_project(
+        self,
+        session_id: str,
+        project_id: str,
+    ) -> SessionProjectRelation:
+        """Add a session to a project."""
+        ...
+
+    @abc.abstractmethod
+    async def remove_session_from_project(self, session_id: str) -> None:
+        """Remove a session from its project."""
+        ...
+
+    @abc.abstractmethod
+    async def get_project_sessions(
+        self,
+        project_id: str,
+        page: int = 1,
+        page_size: int = 100,
+    ) -> list[PlatformSession]:
+        """Get all sessions in a project."""
+        ...
+
+    @abc.abstractmethod
+    async def get_project_by_session(
+        self, session_id: str, creator: str
+    ) -> ChatUIProject | None:
+        """Get the project that a session belongs to."""
+        ...