import { useEffect, useRef, useState } from 'react'; import type { FormEvent } from 'react'; import { Archive, Brain, CircleHelp, LoaderCircle, Plus, RefreshCw, ShieldCheck } from 'lucide-react'; import type { Project, ProjectMemory, ProjectMemoryView, Session } from './types'; import { api } from './api'; import './ProjectMemory.css'; const statusLabel: Record = { current: '当前', unverified: '扫描不完整', expired: '已过期', archived: '已归档' }; export function ProjectMemoryPanel({ project, session }: { project: Project; session: Session | null }) { const [view, setView] = useState(null); const [loading, setLoading] = useState(false); const [working, setWorking] = useState(false); const [notice, setNotice] = useState(''); const [error, setError] = useState(''); const [draft, setDraft] = useState({ title: '', content: '', sourcePath: '', tags: '', expiresAt: '' }); const alive = useRef(true); const load = async () => { setLoading(true); setError(''); try { const result = await api('/projects/' + project.id + '/memories'); if (alive.current) setView(result); } catch (cause) { if (alive.current) setError(cause instanceof Error ? cause.message : '项目记忆读取失败。'); } finally { if (alive.current) setLoading(false); } }; useEffect(() => { alive.current = true; void load(); return () => { alive.current = false; }; }, [project.id]); const create = async (event: FormEvent) => { event.preventDefault(); if (!session || !draft.content.trim()) return; setWorking(true); setError(''); setNotice(''); try { await api('/sessions/' + session.id + '/memories', { title: draft.title || '未命名记忆', content: draft.content, tags: draft.tags.split(',').map(value => value.trim()).filter(Boolean), ...(draft.sourcePath.trim() ? { source: { kind: 'file', path: draft.sourcePath.trim() } } : {}), ...(draft.expiresAt ? { expiresAt: new Date(draft.expiresAt).toISOString() } : {}) }); if (alive.current) { setDraft({ title: '', content: '', sourcePath: '', tags: '', expiresAt: '' }); setNotice('记忆已保存,并绑定当前源码指纹。'); await load(); } } catch (cause) { if (alive.current) setError(cause instanceof Error ? cause.message : '项目记忆保存失败。'); } finally { if (alive.current) setWorking(false); } }; const archive = async (memory: ProjectMemory) => { if (!session) return; setWorking(true); setError(''); try { await api('/sessions/' + session.id + '/memories/' + memory.id + '/archive', {}); if (alive.current) { setNotice('已归档这条记忆。'); await load(); } } catch (cause) { if (alive.current) setError(cause instanceof Error ? cause.message : '项目记忆归档失败。'); } finally { if (alive.current) setWorking(false); } }; const memories = view?.memories ?? []; return
PROJECT MEMORY

项目记忆

当前记忆按预算提供给本项目后续任务;来源匹配后仍需结合实际代码核对内容。

{notice &&

{notice}

} {error &&

{error}

} {view &&
{view.summary.current} 条当前记忆{(view.summary.unverified ?? 0) > 0 && {view.summary.unverified} 条未能验证}{view.summary.expired} 条需重新核对源码 {view.sourceFingerprint.slice(0, 12)}
} {view && !view.scope.complete &&

本次源码扫描未覆盖完整工程(已扫描 {view.scope.scannedFiles} 个文件,{view.scope.bytes.toLocaleString()} 字节);现有记忆暂标为“扫描不完整”,不会作为当前事实。请缩小项目范围或排除超预算文件后重新核对。

} {!memories.length && !loading &&
这个项目还没有记忆

保存架构决策、约束和经过核对的工程事实,后续任务可以直接查看来源。

}
{memories.map(memory =>
{statusLabel[memory.status] || memory.status}

{memory.title}

{memory.content}

来源:{memory.source.kind === 'file' ? memory.source.path : memory.source.label || memory.source.kind}{memory.source.sha256 && 来源 SHA {memory.source.sha256.slice(0, 12)}}工程 {memory.sourceFingerprint.slice(0, 12)}{memory.tags.map(tag => {tag})}
{memory.expiredReason &&

{memory.expiredReason}

}{memory.status !== 'archived' && }
)}

保存一条项目记忆

来源默认绑定当前会话;填写文件路径后会额外保存文件 SHA256。