feat: 完成 Agent Diary 开源重构 🎉

🚀 重构内容:
- 重命名 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:
2026-04-03 19:14:21 +08:00
parent 2dc130df9d
commit 6cc47ef45c
30 changed files with 1915 additions and 477 deletions

View File

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

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 管理'

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()}')

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"),
),
]

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] + '...'