zhaoxi
80174acaae
为所有工具插件添加沙箱拦截层，防止危险的文件访问、Shell命令和Python代码执行。 包含配置文件、核心校验逻辑及31个单元测试。 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
64 lines
1.8 KiB
Python
64 lines
1.8 KiB
Python
# Copyright 2026 zhaoxi826
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
"""File Reader Tool Plugin for KiloStar.
|
|
|
|
Reads the contents of a file from the local filesystem.
|
|
"""
|
|
|
|
from kilostar.plugin.tool_plugin.base_tool import BaseToolData
|
|
from typing import List, Literal, Dict
|
|
|
|
|
|
class FileReaderToolData(BaseToolData):
|
|
"""``file_reader`` 工具的元数据。"""
|
|
|
|
is_system: bool = True
|
|
action_scope: List[
|
|
Literal[
|
|
"control_node",
|
|
"consciousness_node",
|
|
"regulatory_node",
|
|
"growth_node",
|
|
"",
|
|
]
|
|
] = []
|
|
config_args: Dict[str, str] = {}
|
|
category: str = "system"
|
|
|
|
|
|
async def file_reader(file_path: str) -> str:
|
|
"""读取本地文件的内容。
|
|
|
|
Args:
|
|
file_path: 文件的绝对路径或相对路径
|
|
|
|
Returns:
|
|
文件内容文本，若文件不存在则返回错误信息
|
|
"""
|
|
from kilostar.utils.sandbox import validate_path, PathViolation
|
|
|
|
try:
|
|
file_path = validate_path(file_path, write=False)
|
|
except PathViolation as e:
|
|
return f"[Sandbox] {e}"
|
|
|
|
try:
|
|
with open(file_path, "r", encoding="utf-8") as f:
|
|
return f.read()
|
|
except FileNotFoundError:
|
|
return f"[Error] File not found: {file_path}"
|
|
except Exception as e:
|
|
return f"[Error] Failed to read file: {str(e)}"
|