style: 项目重构

1.项目改名为kilostar（千星） 2.后端部分进行大规模重构 3.node功能进行大规模重新设计
2026-05-11 15:29:16 +00:00
parent 2d8571dee3
commit ee9bbbf676
134 changed files with 2190 additions and 2503 deletions
@@ -0,0 +1,13 @@
+#  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.
@@ -0,0 +1,17 @@
+#  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.
+
+from .approval import ApprovalToolData, approval
+
+__all__ = ["ApprovalToolData", "approval"]
@@ -0,0 +1,51 @@
+#  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.
+
+from kilostar.plugin.tool_plugin.base_tool import BaseToolData
+from kilostar.utils.ray_hook import ray_actor_hook
+from typing import List, Literal, Dict
+
+
+class ApprovalToolData(BaseToolData):
+    """ApprovalToolData 核心组件类。
+    这是一个可被智能体动态调用的外部工具组件类。它定义了清晰的输入参数 Schema 与执行契约，赋予智能体与外界真实系统（如文件、网页、API）进行交互的能力。"""
+
+    is_system: bool = True
+    action_scope: List[
+        Literal[
+            "control_node",
+            "consciousness_node",
+            "regulatory_node",
+            "growth_node",
+            "",
+            "",
+        ]
+    ] = ["control_node", "consciousness_node"]
+    config_args: Dict[str, str] = {}
+
+
+async def approval(message: str, trace_id: str) -> str:
+    """
+    当任务存在某些高风险操作或者计划需要让用户审批，发送请求给用户等待用户审批
+    Args:
+        message: 发送给用户的请求
+        trace_id:
+
+    Returns:
+        用户的审批结果
+    """
+    actor_list = ray_actor_hook("global_state_machine")
+    await actor_list.global_state_machine.put_pending.remote(trace_id, message)
+    reply = await actor_list.global_state_machine.get_received.remote(trace_id)
+    return reply
@@ -0,0 +1,2 @@
+{
+}
@@ -0,0 +1,36 @@
+#  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.
+
+from pydantic import BaseModel
+from typing import List, Literal, Dict
+from pydantic import ConfigDict
+
+
+class BaseToolData(BaseModel):
+    """BaseToolData 核心组件类。
+    这是一个可被智能体动态调用的外部工具组件类。它定义了清晰的输入参数 Schema 与执行契约，赋予智能体与外界真实系统（如文件、网页、API）进行交互的能力。"""
+
+    model_config = ConfigDict(extra="allow")
+    is_system: bool
+    action_scope: List[
+        Literal[
+            "control_node",
+            "consciousness_node",
+            "regulatory_node",
+            "growth_node",
+            "",
+            "",
+        ]
+    ] = []
+    config_args: Dict[str, str] = {}
@@ -0,0 +1,17 @@
+#  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.
+
+from .file_reader import FileReaderData, file_reader
+
+__all__ = ["FileReaderData", "file_reader"]
@@ -0,0 +1,48 @@
+#  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.
+
+from pydantic_ai import RunContext
+from kilostar.plugin.tool_plugin.base_tool import BaseToolData
+import os
+
+
+class FileReaderData(BaseToolData):
+    """FileReaderData 核心组件类。
+    这是一个领域数据模型或功能封装类，承载了 FileReaderData 相关的内聚属性定义与状态维护。它的存在隔离了局部的业务复杂性，并对外提供了类型安全的访问接口。"""
+
+    is_system: bool = True
+    name: str = "file_reader"
+    description: str = "读取本地文件的内容"
+
+
+def file_reader(ctx: RunContext, filepath: str) -> str:
+    """读取本地文件内容的工具。
+
+    Args:
+        filepath: 目标文件的绝对路径或相对路径。
+
+    Returns:
+        如果文件存在并可读，返回文件内容；否则返回错误信息。
+    """
+    if not os.path.exists(filepath):
+        return f"Error: 文件 {filepath} 不存在。"
+    if not os.path.isfile(filepath):
+        return f"Error: {filepath} 不是一个文件。"
+
+    try:
+        with open(filepath, "r", encoding="utf-8") as f:
+            content = f.read()
+        return content
+    except Exception as e:
+        return f"Error: 读取文件失败，原因：{str(e)}"