Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Architecture-quality audit notes from hermescheck

Abierto
  • ¿Algo no está bien?
#911 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
25/100
Tipo de issue
Refactorización
Claridad
Necesita aclaración
Estado de actividad
Tranquilo
Stack tecnológico
python
Área
ai, backend

Línea de trabajo

Empieza leyendo ms_agent/utils/utils.py, ms_agent/llm/openai_llm.py, webui/backend/session_manager.py, webui/backend/websocket_handler.py y los archivos bajo ms_agent/memory/. La auditoría identifica posibles problemas de recuperación, durabilidad de la sesión y actualización de la memoria, pero no proporciona ninguna prueba fallida, ningún cambio concreto, criterios de aceptación ni una definición de hecho.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Hi maintainers — this is a friendly architecture-quality audit note, not a security report.

I’ve been building hermescheck, a small open-source scanner that reviews AI agent runtimes for state recovery, memory drift, tool boundaries, scheduler behavior, and other long-running agent failure modes. I ran it against modelscope/ms-agent because this repo is an active agent runtime/framework with real CLI, web UI, workflow, memory, and tool-execution surfaces.

Three runtime/architecture notes that looked worth sharing:

  1. Recovery currently looks transcript-heavy rather than fully resumable.
    ms_agent/utils/utils.py persists config + message history, and ms_agent/llm/openai_llm.py continues long generations, but I didn’t see the same level of durable environment / side-effect / restart contract around those flows. That can make interrupted work harder to resume deterministically.

  2. Web UI session state appears in-memory and explicit-delete driven.
    webui/backend/session_manager.py keeps sessions, messages, and deep-research events in process memory, and webui/backend/websocket_handler.py mainly cleans up task/runner references on stop or completion. This felt a bit fragile for server restarts or abandoned sessions if the goal is durable operator-facing workflows.

  3. Memory surfaces look split across several layers without one obvious freshness contract.
    I saw cache/history handling in ms_agent/utils/utils.py, long-term memory logic in ms_agent/memory/default_memory.py, and separate condenser/default-memory surfaces under ms_agent/memory/. The architecture may benefit from a clearer “authoritative current memory vs derived/archive/cache layers” rule.

None of the above is meant as “you must change this”; it just looked like a useful maintainer-facing architecture snapshot from an external pass.

Repo for the tool: https://github.com/huangrichao2020/hermescheck

If this isn’t useful, feel free to close and I won’t take it personally.

Lenguaje dominante
Python
Estrellas
4.4k
Forks
532
Merge medio
18 h 26 min
PR fusionados (30 d)
10

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de modelscope/ms-agent

Todos los issues de modelscope/ms-agent

Issues similares

Más issues de Python

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.