Knowledge Work Plugins: tareas y memoria compartidas con el asistente
Lea el parser Markdown antes de confiar en un guardado
Examine identificadores de sección, casillas y condiciones de guardado en dashboard.html, incluidos encabezados que se pierden o colisionan.
Qué aprenderás
- Normalización de encabezados
- Un esquema específico
- Guardado y observación
Antes de empezar
- Lectura básica de comandos y configuración
- Entorno de ensayo desechable y autorizado
Diseñe un visor independiente que muestre líneas no admitidas, colisiones y diferencias antes de guardar tareas.
Conclusiones clave
- La normalización puede omitir o unir secciones.
- El formato no conserva Markdown arbitrario.
- Los controles de guardado no prueban ausencia de conflictos.
Normalización de encabezados
taskSectionId convierte a minúsculas y sustituye secuencias ajenas a letras y números ASCII por guiones. parseTaskMarkdown necesita un identificador válido para recoger tareas. Un encabezado compuesto solo por caracteres chinos puede quedar vacío y perder sus tareas en la representación.
Dos nombres distintos también pueden producir el mismo identificador; el parser reutiliza entonces la lista existente. Conserve las secciones inglesas de la plantilla al empezar y pruebe nombres localizados sobre una copia.
Un esquema específico
El parser reconoce encabezados de segundo nivel, casillas, títulos en negrita, notas y subtareas con casillas. toMarkdown reconstruye esos campos. Otros párrafos o estructuras Markdown no tienen garantizada su conservación.
Los identificadores de tarjetas usan tiempo y aleatoriedad. No deben interpretarse como identidades persistentes entre dispositivos. Una integración que necesite esa propiedad debe definir y probar un formato estable.
Guardado y observación
markChanged programa autoSave tras 500 milisegundos. autoSave comprueba el archivo, cambios pendientes y estado de guardado. checkForExternalChanges compara la modificación del archivo, pero retorna durante cambios locales o guardados.
Estas condiciones evitan interrumpir ciertas ediciones, pero no demuestran resolución de conflictos concurrentes. Las conclusiones proceden de inspección; no ejecutamos una prueba de carrera en navegador. Los casos siguientes son un plan de aceptación.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Lea normalización, parser y serializador juntos.
- 2
Pruebe encabezados ASCII, chinos y colisiones.
- 3
Compare todo el archivo original con el resultado.
Ejemplo para copiar
{
"proposedCases": [
"Active",
"待办",
"A B / A-B",
"free paragraph before task"
],
"assertions": [
"section identity",
"task retention",
"round-trip diff"
],
"browserRaceTested": false
}Preguntas frecuentes
¿Puedo traducir todos los encabezados?
Pruebe primero: el identificador inspeccionado conserva solo letras y números ASCII.
¿Guardar correctamente conserva cada línea?
No necesariamente. El serializador reconstruye el esquema admitido.
Fuentes
- Knowledge Work Plugins / productivity/skills/dashboard.htmlFuente verificada 2026-09-18
- Knowledge Work Plugins / productivity/skills/task-management/SKILL.mdFuente verificada 2026-09-18