feat(frontend):优化前端页面设计

kilostar/core/postgres_database/module/individual.py

@@ -32,8 +32,7 @@ _AGENT_TYPE_MODEL_MAP = {
 
 
 class IndividualDatabase:
-    """IndividualDatabase 核心组件类。
-    这是一个数据库操作层 (DAO/Repository) 封装类，专注于处理实体模型与关系型数据库表之间的映射。它将复杂的 SQL 查询、跨表 Join 和事务回滚逻辑进行了高级抽象，向上层服务暴露简洁的数据读写接口。"""
+    """Individual 表族（Base/Specialist/Ordinary/Special）的 DAO，按 agent_type 选择具体子表。"""
 
     def __init__(self, async_session_maker):
         self.async_session_maker = async_session_maker
@@ -44,8 +43,7 @@ class IndividualDatabase:
 
     @database_exception
     async def add_worker_individual(self, **kwargs):
-        """创建并持久化新的 worker individual 实体。
-        接收构建参数，执行必要的数据校验与默认值填充后，将新记录安全地写入底层存储或系统注册表中。"""
+        """新建一个 Worker Individual：自动生成 ULID，按 ``agent_type`` 选择对应子表写入。"""
         async with self.async_session_maker() as session:
             agent_id = str(ULID())
             agent_type = kwargs.get("agent_type", "base")
@@ -58,7 +56,7 @@ class IndividualDatabase:
 
     @database_exception
     async def get_worker_individual(self, agent_id: str):
-        """检索并获取特定的 worker individual 数据集合或实例对象。"""
+        """按 agent_id 取单个 Individual；不存在返回 None。"""
         async with self.async_session_maker() as session:
             statement = select(BaseIndividualModel).where(
                 BaseIndividualModel.agent_id == agent_id
@@ -68,7 +66,7 @@ class IndividualDatabase:
 
     @database_exception
     async def get_worker_individual_list(self, owner_id: str):
-        """检索并获取特定的 worker individual list 数据集合或实例对象。"""
+        """读取某用户名下的所有 Individual。"""
         async with self.async_session_maker() as session:
             statement = select(BaseIndividualModel).where(
                 BaseIndividualModel.owner_id == owner_id
@@ -78,7 +76,7 @@ class IndividualDatabase:
 
     @database_exception
     async def update_worker_individual(self, agent_id: str, **kwargs):
-        """对现有的 worker individual 进行状态更新或属性覆盖。"""
+        """部分更新 Individual：只覆盖 kwargs 中非 None 的字段；找不到返回 None。"""
         async with self.async_session_maker() as session:
             statement = select(BaseIndividualModel).where(
                 BaseIndividualModel.agent_id == agent_id
@@ -97,7 +95,7 @@ class IndividualDatabase:
 
     @database_exception
     async def delete_worker_individual(self, agent_id: str) -> bool:
-        """安全地移除或注销 worker individual。"""
+        """删除 Individual；不存在返回 False，删除成功返回 True。"""
         async with self.async_session_maker() as session:
             statement = select(BaseIndividualModel).where(
                 BaseIndividualModel.agent_id == agent_id
@@ -112,7 +110,7 @@ class IndividualDatabase:
 
     @database_exception
     async def get_all_worker_individual(self):
-        """检索并获取特定的 all worker individual 数据集合或实例对象。"""
+        """返回数据库中全部 Individual。"""
         async with self.async_session_maker() as session:
             statement = select(BaseIndividualModel)
             results = await session.execute(statement)