flying-hero/openclaw-monitor
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 完成 Agent Diary 开源重构 🎉

Browse Source 
🚀 重构内容:
- 重命名 Lobster → Agent（通用化）
- 重命名 LobsterDiary → AgentDiary
- 更新所有 API 端点：/api/lobsters/ → /api/agents/
- 前端组件重命名：LobsterDetail → AgentDetail
- 数据迁移：8 Lobsters → 8 Agents, 4 Diaries

📦 开源准备:
- 创建 .env.example（环境变量配置）
- 创建 docker-compose.yml（一键部署）
- 创建 Dockerfile（前后端）
- 创建 .gitignore
- 添加 MIT LICENSE
- 完善 README.md（中英双语）
- 创建 USAGE.md（使用说明）

📝 文档完善:
- REFACTOR_PLAN.md（重构计划）
- REFACTOR_PROGRESS.md（重构进度）
- REFACTOR_COMPLETE.md（重构完成报告）
- FINAL_REPORT.md（最终报告）
- 工作区同步报告.md

✨ 功能特性:
- 多 Agent 实例管理
- 日记系统（成长之路/工作记忆）
- 工作记忆完全隔离
- 日历视图
- 标签和分类
- RAG 支持（预留 embedding 字段）

🎯 开源准备度：100%

🦸 感谢北极星 ⭐ 的耐心指导！
This commit is contained in:
flying-hero
2026-04-03 19:14:21 +08:00
parent 2dc130df9d
commit 6cc47ef45c
30 changed files with 1915 additions and 477 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
code/backend/Dockerfile Normal file
View File

@@ -0,0 +1,21 @@
FROM python:3.12-slim
WORKDIR /app
# 安装系统依赖
RUN apt-get update && apt-get install -y \
gcc \
libpq-dev \
&& rm -rf /var/lib/apt/lists/*
# 安装 Python 依赖
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
# 复制代码
COPY . .
# 暴露端口
EXPOSE 8000
CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]

1
code/backend/agents/__init__.py Normal file
View File

@@ -0,0 +1 @@
# AI Agents 管理

7
code/backend/agents/apps.py Normal file
View File

@@ -0,0 +1,7 @@
from django.apps import AppConfig
class AgentsConfig(AppConfig):
default_auto_field = 'django.db.models.BigAutoField'
name = 'agents'
verbose_name = 'AI Agents 管理'

0
code/backend/agents/management/__init__.py Normal file
View File

0
code/backend/agents/management/commands/__init__.py Normal file
View File

69
code/backend/agents/management/commands/migrate_data.py Normal file
View File

@@ -0,0 +1,69 @@
#!/usr/bin/env python
"""
数据迁移脚本：从 lobsters 表迁移到 agents 表
使用方法：
python manage.py migrate_data
"""
from django.core.management.base import BaseCommand
from lobsters.models import Lobster, LobsterDiary
from agents.models import Agent, AgentDiary
class Command(BaseCommand):
help = '从 lobsters 表迁移数据到 agents 表'
def handle(self, *args, **kwargs):
self.stdout.write('🚀 开始数据迁移...\n')
# 迁移 Lobster → Agent
self.stdout.write('📊 迁移 Lobster 数据...')
lobsters = Lobster.objects.all()
agent_count = 0
for lobster in lobsters:
Agent.objects.update_or_create(
id=lobster.id,
defaults={
'name': lobster.name,
'emoji': lobster.emoji,
'port': lobster.port,
'specialty': lobster.specialty,
'container': lobster.container,
'app_name': lobster.app_name,
'app_id': lobster.app_id,
'workspace': lobster.workspace,
}
)
agent_count += 1
self.stdout.write(self.style.SUCCESS(f'✅ 迁移 {agent_count} 只 Lobster → Agent'))
# 迁移 LobsterDiary → AgentDiary
self.stdout.write('\n📝 迁移 Diary 数据...')
diaries = LobsterDiary.objects.all()
diary_count = 0
for diary in diaries:
AgentDiary.objects.update_or_create(
id=diary.id,
defaults={
'agent_id': diary.lobster_id,
'date': diary.date,
'title': diary.title,
'content': diary.content,
'category': diary.category,
'tags': diary.tags,
'embedding': diary.embedding,
'embedding_model': diary.embedding_model,
}
)
diary_count += 1
self.stdout.write(self.style.SUCCESS(f'✅ 迁移 {diary_count} 篇 Diary'))
# 统计
self.stdout.write(self.style.SUCCESS(f'\n🎉 迁移完成！'))
self.stdout.write(f' Agents: {Agent.objects.count()}')
self.stdout.write(f' AgentDiaries: {AgentDiary.objects.count()}')

152
code/backend/agents/migrations/0001_initial.py Normal file
View File

@@ -0,0 +1,152 @@
# Generated by Django 4.2 on 2026-04-03 10:15
from django.db import migrations, models
import django.db.models.deletion
class Migration(migrations.Migration):
initial = True
dependencies = []
operations = [
migrations.CreateModel(
name="Agent",
fields=[
(
"id",
models.BigAutoField(
auto_created=True,
primary_key=True,
serialize=False,
verbose_name="ID",
),
),
("name", models.CharField(max_length=50, verbose_name="名称")),
("emoji", models.CharField(max_length=10, verbose_name="Emoji")),
("port", models.IntegerField(verbose_name="端口")),
("specialty", models.CharField(max_length=100, verbose_name="专长")),
("container", models.CharField(max_length=100, verbose_name="容器")),
(
"app_name",
models.CharField(
blank=True, default="", max_length=100, verbose_name="应用名称"
),
),
(
"app_id",
models.CharField(
blank=True, default="", max_length=50, verbose_name="应用 ID"
),
),
(
"workspace",
models.CharField(
blank=True, default="", max_length=100, verbose_name="工作区"
),
),
(
"created_at",
models.DateTimeField(auto_now_add=True, verbose_name="创建时间"),
),
(
"updated_at",
models.DateTimeField(auto_now=True, verbose_name="更新时间"),
),
],
options={
"verbose_name": "AI Agent",
"verbose_name_plural": "AI Agents",
"ordering": ["id"],
},
),
migrations.CreateModel(
name="AgentDiary",
fields=[
(
"id",
models.BigAutoField(
auto_created=True,
primary_key=True,
serialize=False,
verbose_name="ID",
),
),
("date", models.DateField(verbose_name="日期")),
("title", models.CharField(max_length=200, verbose_name="标题")),
("content", models.TextField(verbose_name="内容")),
(
"category",
models.CharField(
choices=[
("chengcai", "成长之路"),
("memory", "工作记忆"),
("tech", "技术笔记"),
("other", "其他"),
],
default="other",
max_length=50,
verbose_name="分类",
),
),
(
"tags",
models.JSONField(blank=True, default=list, verbose_name="标签"),
),
(
"embedding",
models.TextField(
blank=True, null=True, verbose_name="文本向量 (JSON 格式)"
),
),
(
"embedding_model",
models.CharField(
blank=True,
default="",
max_length=50,
verbose_name="Embedding 模型版本",
),
),
(
"created_at",
models.DateTimeField(auto_now_add=True, verbose_name="创建时间"),
),
(
"updated_at",
models.DateTimeField(auto_now=True, verbose_name="更新时间"),
),
(
"agent",
models.ForeignKey(
on_delete=django.db.models.deletion.CASCADE,
related_name="diaries",
to="agents.agent",
verbose_name="AI Agent",
),
),
],
options={
"verbose_name": "Agent 日记",
"verbose_name_plural": "Agent 日记",
"ordering": ["-date", "-created_at"],
},
),
migrations.AddIndex(
model_name="agentdiary",
index=models.Index(
fields=["agent", "date"], name="agents_agen_agent_i_27d331_idx"
),
),
migrations.AddIndex(
model_name="agentdiary",
index=models.Index(
fields=["category", "date"], name="agents_agen_categor_b3fe6e_idx"
),
),
migrations.AddIndex(
model_name="agentdiary",
index=models.Index(fields=["date"], name="agents_agen_date_8e7dc6_idx"),
),
]

0
code/backend/agents/migrations/__init__.py Normal file
View File

94
code/backend/agents/models.py Normal file
View File

@@ -0,0 +1,94 @@
from django.db import models
from django.utils import timezone
class Agent(models.Model):
"""AI Agent 模型（原 Lobster）"""
name = models.CharField(max_length=50, verbose_name='名称')
emoji = models.CharField(max_length=10, verbose_name='Emoji')
port = models.IntegerField(verbose_name='端口')
specialty = models.CharField(max_length=100, verbose_name='专长')
container = models.CharField(max_length=100, verbose_name='容器')
app_name = models.CharField(max_length=100, blank=True, default='', verbose_name='应用名称')
app_id = models.CharField(max_length=50, blank=True, default='', verbose_name='应用 ID')
workspace = models.CharField(max_length=100, blank=True, default='', verbose_name='工作区')
created_at = models.DateTimeField(auto_now_add=True, verbose_name='创建时间')
updated_at = models.DateTimeField(auto_now=True, verbose_name='更新时间')
class Meta:
verbose_name = 'AI Agent'
verbose_name_plural = 'AI Agents'
ordering = ['id']
def __str__(self):
return f'{self.emoji} {self.name}'
class AgentDiary(models.Model):
"""AI Agent 日记模型（支持 RAG）"""
# 分类选择
CATEGORY_CHOICES = [
('chengcai', '成长之路'),
('memory', '工作记忆'),
('tech', '技术笔记'),
('other', '其他'),
]
# 关联 Agent
agent = models.ForeignKey(
Agent,
on_delete=models.CASCADE,
related_name='diaries',
verbose_name='AI Agent'
)
# 基本信息
date = models.DateField(verbose_name='日期')
title = models.CharField(max_length=200, verbose_name='标题')
content = models.TextField(verbose_name='内容')
# 分类和标签（RAG 检索的关键元数据）
category = models.CharField(
max_length=50,
choices=CATEGORY_CHOICES,
default='other',
verbose_name='分类'
)
tags = models.JSONField(default=list, blank=True, verbose_name='标签')
# RAG 相关字段（预留）
embedding = models.TextField(
blank=True,
null=True,
verbose_name='文本向量 (JSON 格式)'
)
embedding_model = models.CharField(
max_length=50,
blank=True,
default='',
verbose_name='Embedding 模型版本'
)
# 时间戳
created_at = models.DateTimeField(auto_now_add=True, verbose_name='创建时间')
updated_at = models.DateTimeField(auto_now=True, verbose_name='更新时间')
class Meta:
verbose_name = 'Agent 日记'
verbose_name_plural = 'Agent 日记'
ordering = ['-date', '-created_at']
indexes = [
models.Index(fields=['agent', 'date']),
models.Index(fields=['category', 'date']),
models.Index(fields=['date']),
]
def __str__(self):
return f'{self.agent.emoji} {self.agent.name} - {self.date} - {self.get_category_display()}'
def get_content_preview(self, length=50):
"""获取内容预览"""
if len(self.content) <= length:
return self.content
return self.content[:length] + '...'

13
code/backend/api/urls.py
View File

@@ -5,12 +5,11 @@ from django.urls import path
from . import views
urlpatterns = [
path('lobsters/', views.lobster_list, name='lobster-list'),
path('lobsters/<int:lobster_id>/', views.lobster_detail, name='lobster-detail'),
path('lobsters/<int:lobster_id>/memory/', views.lobster_memory, name='lobster-memory'),
path('lobsters/<int:lobster_id>/memory/dates/', views.lobster_memory_dates, name='lobster-memory-dates'),
path('lobsters/<int:lobster_id>/memory/<str:date>/', views.lobster_memory_detail, name='lobster-memory-detail'),
path('lobsters/<int:lobster_id>/diary/dates/', views.lobster_diary_dates, name='lobster-diary-dates'),
path('lobsters/<int:lobster_id>/diary/<str:date>/', views.lobster_diary_detail, name='lobster-diary-detail'),
path('agents/', views.agent_list, name='agent-list'),
path('agents/<int:agent_id>/', views.agent_detail, name='agent-detail'),
path('agents/<int:agent_id>/memory/dates/', views.agent_memory_dates, name='agent-memory-dates'),
path('agents/<int:agent_id>/memory/<str:date>/', views.agent_memory_detail, name='agent-memory-detail'),
path('agents/<int:agent_id>/diary/dates/', views.agent_diary_dates, name='agent-diary-dates'),
path('agents/<int:agent_id>/diary/<str:date>/', views.agent_diary_detail, name='agent-diary-detail'),
path('tools/', views.tools_list, name='tools-list'),
]

131
code/backend/api/views.py
View File

@@ -1,64 +1,51 @@
"""
API views for lobster monitoring.
API views for Agent Diary monitoring.
"""
from rest_framework.decorators import api_view
from rest_framework.response import Response
from datetime import datetime
import os
from pathlib import Path
import re
from lobsters.models import Lobster, LobsterDiary
from agents.models import Agent, AgentDiary
@api_view(['GET'])
def lobster_list(request):
"""获取所有龙虾状态"""
lobsters = Lobster.objects.all()
def agent_list(request):
"""获取所有 Agent 状态"""
agents = Agent.objects.all()
result = []
for lobster in lobsters:
for agent in agents:
result.append({
'id': lobster.id,
'name': lobster.name,
'emoji': lobster.emoji,
'port': lobster.port,
'specialty': lobster.specialty,
'container': lobster.container,
'app_name': lobster.app_name,
'app_id': lobster.app_id,
'id': agent.id,
'name': agent.name,
'emoji': agent.emoji,
'port': agent.port,
'specialty': agent.specialty,
'container': agent.container,
'app_name': agent.app_name,
'app_id': agent.app_id,
'status': 'healthy',
'last_check': datetime.now().isoformat()
})
return Response(result)
@api_view(['GET'])
def lobster_detail(request, lobster_id):
"""获取单个龙虾详情"""
def agent_detail(request, agent_id):
"""获取单个 Agent 详情"""
try:
lobster = Lobster.objects.get(id=lobster_id)
agent = Agent.objects.get(id=agent_id)
return Response({
'id': lobster.id,
'name': lobster.name,
'emoji': lobster.emoji,
'port': lobster.port,
'specialty': lobster.specialty,
'container': lobster.container,
'app_name': lobster.app_name,
'app_id': lobster.app_id,
'id': agent.id,
'name': agent.name,
'emoji': agent.emoji,
'port': agent.port,
'specialty': agent.specialty,
'container': agent.container,
'app_name': agent.app_name,
'app_id': agent.app_id,
'status': 'healthy',
'workspace': f'/home/node/.openclaw/workspace/{lobster.name.lower()}',
'workspace': f'/home/node/.openclaw/workspace/{agent.workspace}',
'last_check': datetime.now().isoformat()
})
except Lobster.DoesNotExist:
return Response({'error': '龙虾不存在'}, status=404)
@api_view(['GET'])
def lobster_memory(request, lobster_id):
"""获取龙虾记忆"""
# 这里简化处理，实际应该读取文件
return Response({
'lobster_id': lobster_id,
'memory': '# 长期记忆\n\n记忆内容加载中...',
'daily_memories': []
})
except Agent.DoesNotExist:
return Response({'error': 'Agent 不存在'}, status=404)
@api_view(['GET'])
def tools_list(request):
@@ -74,34 +61,34 @@ def tools_list(request):
return Response(tools)
@api_view(['GET'])
def lobster_memory_dates(request, lobster_id):
"""获取龙虾有工作记忆的日期列表 - 从数据库读取"""
def agent_memory_dates(request, agent_id):
"""获取 Agent 有工作记忆的日期列表 - 从数据库读取"""
try:
lobster = Lobster.objects.get(id=lobster_id)
except Lobster.DoesNotExist:
return Response({'error': '龙虾不存在'}, status=404)
agent = Agent.objects.get(id=agent_id)
except Agent.DoesNotExist:
return Response({'error': 'Agent 不存在'}, status=404)
# 从数据库查询工作记忆
diaries = LobsterDiary.objects.filter(
lobster=lobster,
diaries = AgentDiary.objects.filter(
agent=agent,
category='memory'
).values_list('date', flat=True).distinct()
).values_list('date', flat=True).distinct().order_by('-date')
dates = [str(date) for date in sorted(diaries, reverse=True)]
return Response({'dates': dates})
@api_view(['GET'])
def lobster_memory_detail(request, lobster_id, date):
def agent_memory_detail(request, agent_id, date):
"""获取指定日期的工作记忆内容 - 从数据库读取"""
try:
lobster = Lobster.objects.get(id=lobster_id)
except Lobster.DoesNotExist:
return Response({'error': '龙虾不存在'}, status=404)
agent = Agent.objects.get(id=agent_id)
except Agent.DoesNotExist:
return Response({'error': 'Agent 不存在'}, status=404)
# 从数据库查询工作记忆
try:
diary = LobsterDiary.objects.get(
lobster=lobster,
diary = AgentDiary.objects.get(
agent=agent,
date=date,
category='memory'
)
@@ -111,38 +98,38 @@ def lobster_memory_detail(request, lobster_id, date):
'title': diary.title,
'tags': diary.tags,
})
except LobsterDiary.DoesNotExist:
except AgentDiary.DoesNotExist:
return Response({'error': '该日期没有工作记忆'}, status=404)
@api_view(['GET'])
def lobster_diary_dates(request, lobster_id):
"""获取龙虾有日记（成才之路）的日期列表 - 从数据库读取"""
def agent_diary_dates(request, agent_id):
"""获取 Agent 有日记（成长之路）的日期列表 - 从数据库读取"""
try:
lobster = Lobster.objects.get(id=lobster_id)
except Lobster.DoesNotExist:
return Response({'error': '龙虾不存在'}, status=404)
agent = Agent.objects.get(id=agent_id)
except Agent.DoesNotExist:
return Response({'error': 'Agent 不存在'}, status=404)
# 从数据库查询日记日期
diaries = LobsterDiary.objects.filter(
lobster=lobster,
diaries = AgentDiary.objects.filter(
agent=agent,
category='chengcai'
).values_list('date', flat=True).distinct()
).values_list('date', flat=True).distinct().order_by('-date')
dates = [str(date) for date in sorted(diaries, reverse=True)]
return Response({'dates': dates})
@api_view(['GET'])
def lobster_diary_detail(request, lobster_id, date):
"""获取指定日期的日记内容（成才之路） - 从数据库读取"""
def agent_diary_detail(request, agent_id, date):
"""获取指定日期的日记内容（成长之路） - 从数据库读取"""
try:
lobster = Lobster.objects.get(id=lobster_id)
except Lobster.DoesNotExist:
return Response({'error': '龙虾不存在'}, status=404)
agent = Agent.objects.get(id=agent_id)
except Agent.DoesNotExist:
return Response({'error': 'Agent 不存在'}, status=404)
# 从数据库查询日记
try:
diary = LobsterDiary.objects.get(
lobster=lobster,
diary = AgentDiary.objects.get(
agent=agent,
date=date,
category='chengcai'
)
@@ -152,5 +139,5 @@ def lobster_diary_detail(request, lobster_id, date):
'title': diary.title,
'tags': diary.tags,
})
except LobsterDiary.DoesNotExist:
except AgentDiary.DoesNotExist:
return Response({'error': '该日期没有日记'}, status=404)

3
code/backend/backend/settings.py
View File

@@ -22,7 +22,8 @@ INSTALLED_APPS = [
'rest_framework',
'corsheaders',
'api',
'lobsters',
'lobsters', # 旧版，待移除
'agents', # 新版
]
MIDDLEWARE = [