dsh-macro-memory 0.0.0-stage → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +506 -2
- package/cordis.patch.yml +6 -0
- package/lib/client.js +3623 -0
- package/lib/index.js +502 -0
- package/lib/macro/brand.js +82 -0
- package/lib/macro/bridge.js +158 -0
- package/lib/macro/chain.js +206 -0
- package/lib/macro/contract.js +471 -0
- package/lib/macro/cost.js +164 -0
- package/lib/macro/defs/admin.js +442 -0
- package/lib/macro/defs/dream.js +24 -0
- package/lib/macro/defs/link.js +257 -0
- package/lib/macro/defs/project.js +25 -0
- package/lib/macro/defs/read.js +160 -0
- package/lib/macro/defs/remember.js +411 -0
- package/lib/macro/defs/search.js +871 -0
- package/lib/macro/defs/update.js +161 -0
- package/lib/macro/dreamledger.js +1398 -0
- package/lib/macro/facade.js +135 -0
- package/lib/macro/fusion.js +182 -0
- package/lib/macro/linkflow.js +391 -0
- package/lib/macro/links.js +448 -0
- package/lib/macro/neighbor.js +209 -0
- package/lib/macro/panel.js +96 -0
- package/lib/macro/prompt.js +139 -0
- package/lib/macro/provenance.js +148 -0
- package/lib/macro/render.js +35 -0
- package/lib/macro/revisions.js +253 -0
- package/lib/macro/shared.js +113 -0
- package/lib/macro/store.js +103 -0
- package/lib/macro/supersede.js +197 -0
- package/lib/macro/tokencost.js +90 -0
- package/lib/macro/tools.js +67 -0
- package/package.json +54 -4
- package/vendor/VENDOR.json +23 -0
- package/vendor/dsh-memory-nebula/CONTRIBUTING.md +48 -0
- package/vendor/dsh-memory-nebula/LICENSE +21 -0
- package/vendor/dsh-memory-nebula/README.en.md +203 -0
- package/vendor/dsh-memory-nebula/README.md +253 -0
- package/vendor/dsh-memory-nebula/SECURITY.md +43 -0
- package/vendor/dsh-memory-nebula/SUPPORT.md +33 -0
- package/vendor/dsh-memory-nebula/cordis.patch.yml +4 -0
- package/vendor/dsh-memory-nebula/lib/client.js +105 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/index.js +279 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/ingest.js +230 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/meow.js +320 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/notes.js +305 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/sqlite.js +287 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/util.js +231 -0
- package/vendor/dsh-memory-nebula/lib/host/bridge.js +351 -0
- package/vendor/dsh-memory-nebula/lib/host/compress.js +97 -0
- package/vendor/dsh-memory-nebula/lib/host/demo.js +357 -0
- package/vendor/dsh-memory-nebula/lib/host/diagnostics.js +125 -0
- package/vendor/dsh-memory-nebula/lib/host/doctor.js +270 -0
- package/vendor/dsh-memory-nebula/lib/host/entities.js +230 -0
- package/vendor/dsh-memory-nebula/lib/host/graph.js +1762 -0
- package/vendor/dsh-memory-nebula/lib/host/graphcache.js +290 -0
- package/vendor/dsh-memory-nebula/lib/host/http.js +993 -0
- package/vendor/dsh-memory-nebula/lib/host/injectcfg.js +95 -0
- package/vendor/dsh-memory-nebula/lib/host/ledger.js +175 -0
- package/vendor/dsh-memory-nebula/lib/host/live.js +204 -0
- package/vendor/dsh-memory-nebula/lib/host/nebula.js +2105 -0
- package/vendor/dsh-memory-nebula/lib/host/page.js +75 -0
- package/vendor/dsh-memory-nebula/lib/host/path.js +83 -0
- package/vendor/dsh-memory-nebula/lib/host/recall.js +524 -0
- package/vendor/dsh-memory-nebula/lib/host/share.js +633 -0
- package/vendor/dsh-memory-nebula/lib/host/sources.js +266 -0
- package/vendor/dsh-memory-nebula/lib/host/store.js +333 -0
- package/vendor/dsh-memory-nebula/lib/host/text.js +410 -0
- package/vendor/dsh-memory-nebula/lib/host/transcripts.js +396 -0
- package/vendor/dsh-memory-nebula/lib/index.js +782 -0
- package/vendor/dsh-memory-nebula/lib/standalone.mjs +315 -0
- package/vendor/dsh-memory-nebula/lib/web/api.js +426 -0
- package/vendor/dsh-memory-nebula/lib/web/app.js +4172 -0
- package/vendor/dsh-memory-nebula/lib/web/i18n.js +580 -0
- package/vendor/dsh-memory-nebula/lib/web/index.html +174 -0
- package/vendor/dsh-memory-nebula/lib/web/nav.js +132 -0
- package/vendor/dsh-memory-nebula/lib/web/render.js +1890 -0
- package/vendor/dsh-memory-nebula/lib/web/space3d.js +1883 -0
- package/vendor/dsh-memory-nebula/lib/web/style.css +1402 -0
- package/vendor/dsh-memory-nebula/locale/en.json +7 -0
- package/vendor/dsh-memory-nebula/locale/zh.json +7 -0
- package/vendor/dsh-memory-nebula/market/assets/icon-180.png +0 -0
- package/vendor/dsh-memory-nebula/market/assets/icon.svg +40 -0
- package/vendor/dsh-memory-nebula/market/index.json +101 -0
- package/vendor/dsh-memory-nebula/package.json +87 -0
- package/vendor/dsh-memory-nebula/sidecar.ps1 +119 -0
- package/vendor/meow-memory/LICENSE +21 -0
- package/vendor/meow-memory/README.en.md +192 -0
- package/vendor/meow-memory/README.md +174 -0
- package/vendor/meow-memory/README.pt-br.md +180 -0
- package/vendor/meow-memory/cordis.patch.yml +7 -0
- package/vendor/meow-memory/lib/client.js +3344 -0
- package/vendor/meow-memory/lib/client.js.map +7 -0
- package/vendor/meow-memory/lib/index.js +9802 -0
- package/vendor/meow-memory/lib/index.js.map +7 -0
- package/vendor/meow-memory/lib/prompts/README.md +65 -0
- package/vendor/meow-memory/lib/prompts/en/dream-atomic.md +36 -0
- package/vendor/meow-memory/lib/prompts/en/dream-header.md +9 -0
- package/vendor/meow-memory/lib/prompts/en/dream-project-summary.md +12 -0
- package/vendor/meow-memory/lib/prompts/en/dream-topic.md +27 -0
- package/vendor/meow-memory/lib/prompts/en/external-memory-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/en/first-create-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/en/labels.md +98 -0
- package/vendor/meow-memory/lib/prompts/en/reflect.md +31 -0
- package/vendor/meow-memory/lib/prompts/en/system-guide.md +121 -0
- package/vendor/meow-memory/lib/prompts/en/tools.md +83 -0
- package/vendor/meow-memory/lib/prompts/en/welcome-guide.md +12 -0
- package/vendor/meow-memory/lib/prompts/pt-br/dream-atomic.md +36 -0
- package/vendor/meow-memory/lib/prompts/pt-br/dream-header.md +9 -0
- package/vendor/meow-memory/lib/prompts/pt-br/dream-project-summary.md +12 -0
- package/vendor/meow-memory/lib/prompts/pt-br/dream-topic.md +27 -0
- package/vendor/meow-memory/lib/prompts/pt-br/external-memory-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/pt-br/first-create-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/pt-br/labels.md +98 -0
- package/vendor/meow-memory/lib/prompts/pt-br/reflect.md +31 -0
- package/vendor/meow-memory/lib/prompts/pt-br/system-guide.md +121 -0
- package/vendor/meow-memory/lib/prompts/pt-br/tools.md +83 -0
- package/vendor/meow-memory/lib/prompts/pt-br/welcome-guide.md +12 -0
- package/vendor/meow-memory/lib/prompts/zh/dream-atomic.md +36 -0
- package/vendor/meow-memory/lib/prompts/zh/dream-header.md +9 -0
- package/vendor/meow-memory/lib/prompts/zh/dream-project-summary.md +19 -0
- package/vendor/meow-memory/lib/prompts/zh/dream-topic.md +27 -0
- package/vendor/meow-memory/lib/prompts/zh/external-memory-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/zh/first-create-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/zh/labels.md +98 -0
- package/vendor/meow-memory/lib/prompts/zh/reflect.md +30 -0
- package/vendor/meow-memory/lib/prompts/zh/system-guide.md +119 -0
- package/vendor/meow-memory/lib/prompts/zh/tools.md +83 -0
- package/vendor/meow-memory/lib/prompts/zh/welcome-guide.md +12 -0
- package/vendor/meow-memory/package.json +64 -0
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
[Entradas neste grupo]: {list}
|
|
2
|
+
|
|
3
|
+
A lista [Entradas neste grupo] acima é todo o escopo desta rodada: as entradas que você mesmo criou, mais as que você viu nesta janela por injeção, busca ou memory_read. O escopo termina aí — não tente recordar entradas que você "viu mas que não estão listadas".
|
|
4
|
+
Há aqui algo que você acha que deveria ser arrumado ou atualizado? Se sim, atualize.
|
|
5
|
+
|
|
6
|
+
## Como decidir que algo precisa de atualização — percorra a lista acima entrada por entrada e se pergunte:
|
|
7
|
+
1. Algo foi registrado de forma errada ou unilateral, ficou desatualizado, precisa de informação nova, o usuário mudou de ideia, houve progresso novo? -> Atualize o content prontamente; o armazenamento de memória deve corresponder ao estado mais recente do projeto.
|
|
8
|
+
2. Algum design ou informação foi derrubado, mudado ou provou não funcionar? -> Defina status=archived. Nunca deixe esses como active ou stale. stale significa apenas "finalizado" (um todo concluído, um topic que atingiu seu objetivo), não "inválido"; abordagens e conclusões substituídas que ficam no armazenamento só vão enganar sessões futuras.
|
|
9
|
+
3. Existem entradas todo concluídas? -> Defina status=stale (que significa done);
|
|
10
|
+
4. Existem entradas erradas, triviais demais, ou que você agora acha que não importam em nada? -> Defina status=archived;
|
|
11
|
+
5. Bugs foram corrigidos, ou lessons deixaram de se aplicar? -> Mude o content, ou defina status=archived;
|
|
12
|
+
6. Você encontrou entradas que se contradizem? -> Corrija-as de acordo com o que você sabe ser verdade. Mantenha o fato mais novo, arquive a versão mais antiga;
|
|
13
|
+
7. Olhando para trás agora, a importance de cada entrada está certa (confira com as regras de importance do sistema de memória)? Observação: não marque coisas como importantes de leve — entradas em andamento geralmente são 1, no máximo 2; só algo sério merece 3. Onde estiver inflada, diminua;
|
|
14
|
+
8. Alguma entrada está longa demais, carregando demais? -> Divida-a em várias, usando update para reescrever e remember para criar as novas.
|
|
15
|
+
9. As palavras-chave estão precisas? -> Se estiverem, deixe o parâmetro keywords de fora; se você achar que estão erradas, corrija-as com o parâmetro keywords do memory_update — quando o prompt do usuário acerta as palavras-chave de uma entrada, essa entrada é trazida. Então pense ao contrário: "quais palavras no prompt de um usuário deveriam fazer esta memória aparecer?" Esse é o seu critério. Não use o nome do projeto como palavra-chave; use palavras específicas da entrada. Prefira entidades centrais, o centro semântico, nomes próprios. Forma dicionarizada simples — o tokenizador faz stemming das palavras em inglês, então um singular já casa com seu plural, e stopwords não recuperam nada. De 8 a 13 delas.
|
|
16
|
+
10. Os rótulos de projeto estão certos? Algo está rotulado com um projeto quando na verdade é informação global? Então o rótulo de projeto deve sair. Algo claramente pertence a um projeto mas não carrega informação de projeto? Então adicione.
|
|
17
|
+
11. Aprendizado sem reflexão é desperdício — generalize mais:
|
|
18
|
+
- Este é um excelente momento para abstrair e consolidar. Há regras gerais que valha a pena destilar? Adicione-as como novas memórias.
|
|
19
|
+
- Você agora pode entender algumas entradas melhor e mais profundamente do que quando as escreveu. Atualize-as.
|
|
20
|
+
12. Olhe para o que é injetado no primeiro turno. Você ainda acha que tudo aquilo importa? Realmente precisa ser injetado no início de toda sessão? O que não precisar, você pode baixar de importance ou mover para outro level (fact, por exemplo).
|
|
21
|
+
O primeiro turno injeta apenas: soul (a própria IA) / user (as preferências do usuário) / regras globais (importance>=2). Para colocar algo no primeiro turno: uma regra global -> mova para rules com importance>=2 (project "global"); algo sobre o usuário -> mova para user; algo sobre você -> mova para soul.
|
|
22
|
+
13. memory_project mostra entradas de nível de projeto (todos concluídos, apenas os 5 mais recentes) mais regras específicas do projeto; as verificações acima também valem lá (todos concluídos vão para stale, entradas desatualizadas vão para archived, rótulos de projeto permanecem precisos).
|
|
23
|
+
14. [Isenção de arquivamento] entradas de projeto com subcategoria decisions, entradas de nível rules e conclusões de longa duração entre facts/lessons: **sem evidência de sucessão (não substituída, derrubada ou mesclada por uma entrada mais nova) elas NÃO são arquivadas**, mesmo se parecerem antigas — o critério para arquivar é "existe um fato sucessor?", não "o conteúdo parece velho?". Arquive como de costume apenas quando qualquer um destes se aplicar: uma entrada mais recente do mesmo tema a substituiu; o texto traz um prazo explícito ("atualmente", "até X", "por enquanto"); ou o usuário a derrubou explicitamente.
|
|
24
|
+
|
|
25
|
+
Observações:
|
|
26
|
+
Importante: percorra uma por uma e arquive ou conserte as memórias desatualizadas ou que te induzem ao erro — prefira arquivar.
|
|
27
|
+
Para uma memória que você considera muito importante, se estiver em dúvida sobre qual é a verdade, vá ler os arquivos do projeto e confira. Apenas para memórias que realmente importam.
|
|
28
|
+
15. Se um bloco [pares duplicados literalmente] estiver listado: essas duas entradas coincidem em ≥80% no texto (a mesma régua que memory_remember usa para duplicados) — uma frase guardada em duas camadas. Mantenha a que tem mais informação e a camada mais adequada, e marque a outra como status=archived via memory_update; entradas que apenas parecem iguais e não estão listadas não são duplicadas (similaridade significa mesmo assunto, repeat significa mesma frase).Uma marcada como "(outra rodada)" significa que a outra metade não está nesta lista (ela é revisada em outra rodada — fatos e topics são revisados separadamente). Trate do mesmo jeito, e trate o par uma única vez: não pule só porque não consegue ver a outra entrada.
|
|
29
|
+
16. Se um bloco [redações duplicadas] estiver listado: um resumo curto e uma redação longa dizem a mesma coisa — a repetição literal é baixa (um é o resumo, o outro o texto completo), então o critério é cobertura (o resumo inteiro cabe na versão longa). O que fazer: junte em um só — leve para a versão longa o que só o resumo tem, mantenha a entrada mais completa e marque a outra como status=archived via memory_update. Não as mantenha como dois fatos só porque o repeat do memory_search é baixo: o mesmo conhecimento em duas camadas custa duas vezes na injeção da primeira rodada.
|
|
30
|
+
Abaixo de cada par há também uma linha de receita nomeando as palavras que o resumo tem e a versão longa não tem: são exatamente as que uma fusão costuma perder, então absorva-as literalmente antes de arquivar o resumo. Se a receita disser que o resumo não tem palavras ausentes na versão longa, a fusão é sem perda — mantenha a versão longa, arquive o resumo e não reescreva o texto.
|
|
31
|
+
13. As três réguas cobrem casos distintos: repetição literal ≥80% (Jaccard — "a mesma frase guardada duas vezes"), cobertura ≥90% ("resumo + texto completo") e o "similar N" da verificação de saúde mais memory_search mode="similar" (assinatura de palavras raras — "duas frases diferentes sobre o mesmo assunto"). As duas primeiras significam duplicata: junte em uma e arquive a outra. A terceira significa semelhança: nunca junte duas afirmações diferentes sobre um mesmo assunto, no máximo acrescente um ponteiro ("veja xxx"). Se um "similar N" alto não aparece em nenhum dos dois blocos acima, é o sistema dizendo que são duas coisas — não force a fusão.
|
|
32
|
+
14. Se um bloco [conflitos prováveis] aparecer: duas entradas no mesmo assunto (pelo menos 2 palavras-chave em comum) mas com números ou versões diferentes — a terceira doença, nem duplicata nem semelhança. **Não junte as duas em uma e não arquive uma só porque "parece velha"**: duplicata é uma frase guardada duas vezes, conflito é o mesmo fato com duas versões, e fundir apaga uma delas. Faça três coisas por par: (1) o tempo primeiro — a linha termina dizendo qual é mais nova; tome a mais nova como atual e reescreva a antiga como "(substituída: …)" ou ponha status=stale, nunca apague direto; (2) depois a diferença — os números que cada lado "tem sozinho" costumam ser fatos diferentes (um é versão, outro é contagem); nesse caso mantenha os dois e deixe o texto dizer a que cada número pertence, em vez de forçar uma entrada só; (3) se estiver em dúvida, confira os arquivos do projeto — se nenhum dos números for confiável, não chute. Deixe rastro: escreva uma frase na entrada alterada dizendo por que resolveu assim, para a próxima rodada não ter de adivinhar de novo. Uma entrada arquivada nunca aparece aqui (arquivar já é o desfecho), então estar listada significa que ela continua valendo no acervo.
|
|
33
|
+
|
|
34
|
+
Quando terminar, responda diretamente; a primeira linha da resposta deve conter o marcador de grupo {groupMarker} literalmente (copie caractere por caractere, sem alterações), seguida por "este grupo está consolidado" e o resumo a partir da segunda linha. Não chame nenhuma outra ferramenta.
|
|
35
|
+
|
|
36
|
+
Você pode chamar várias ferramentas em um turno — por favor, conclua todas as chamadas de ferramenta desta tarefa em uma única resposta.
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
As memórias desta janela foram seladas em: {timestamp}
|
|
2
|
+
Se outra janela fez progresso depois desse timestamp, você não tem como saber. Então, quando uma memória conflitar com o que você sabe pelo contexto, use o timestamp para descobrir qual é o caso — a memória estar errada, ou você estar atrasado — antes de decidir se deve mudá-la.
|
|
3
|
+
|
|
4
|
+
Regras de timestamp:
|
|
5
|
+
Todo timestamp mostrado a você é o timestamp de **última atualização** daquela memória.
|
|
6
|
+
Como o que você está vendo agora é um trecho muito longo de contexto, um timestamp relativo como "3 horas atrás" fica mudando e não vale a pena confiar nele. Leia o timestamp absoluto para julgar a idade de uma memória.
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
Grupo {idx}/{total} - {roundKind}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
Para os projetos em que você vem trabalhando, chame memory_project de novo, dê outra olhada em como a memória os descreve e então condense isso.
|
|
2
|
+
Projetos neste grupo: {projects}
|
|
3
|
+
|
|
4
|
+
# Como resumir um projeto
|
|
5
|
+
1. O que o memory_project retorna pode ser prolixo demais. Se estiver realmente inchado, você deve condensá-lo em entradas novas e mais enxutas (memory_remember, level=project); se já estiver enxuto, deixe como está.
|
|
6
|
+
2. Quantas entradas escrever é decisão sua — resuma apenas o que realmente importa.
|
|
7
|
+
3. Entenda o que está em jogo: seu resumo se torna a memória de longo prazo deste projeto. Sempre que outra janela trabalhar neste projeto, isto é a primeira coisa que ela vê. Então escreva algo que realmente vá orientá-la — o suficiente para entender rápido o que o usuário quer, para que serve o projeto, qual é o seu panorama geral e quais partes da arquitetura e do pensamento de design importam.
|
|
8
|
+
4. Ainda assim, escreva entrada por entrada, um ponto por entrada; escolha a subcategoria certa para cada uma (overview=o panorama geral / structure=arquitetura / decisions=decisões de design / ops=implantação e dados / todo=pendente), de 8 a 13 palavras-chave, e não infle a importance.
|
|
9
|
+
5. Quando terminar, arquive as entradas antigas que o memory_project retornou e que seu novo resumo substituiu (memory_update com status=archived) — não deixe duas descrições da mesma coisa lado a lado. Entradas que seu resumo não cobre e que ainda se sustentam sozinhas (um todo inacabado, uma lesson marcante, decisões de longa duração na subcategoria decisions) ficam onde estão; não arquive só por arquivar — uma entrada decisions só é arquivada quando suas conclusões foram de fato absorvidas pelo seu novo resumo; uma decisão de longa duração que não foi absorvida fica, mesmo se parecer antiga.
|
|
10
|
+
6. Quando terminar, responda diretamente; a primeira linha da resposta deve conter o marcador de grupo {groupMarker} preenchido acima (copie caractere por caractere, sem alterações), seguida por "este grupo está consolidado" e o resumo a partir da segunda linha. Não chame nenhuma outra ferramenta.
|
|
11
|
+
|
|
12
|
+
Você pode chamar várias ferramentas em um turno — por favor, conclua todas as chamadas de ferramenta desta tarefa em uma única resposta.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
topic é um tipo especial de memória: ele acompanha o que causou algo, como se desenvolveu e onde terminou, dando à IA a visão mais ampla de como os acontecimentos se desenrolaram.
|
|
2
|
+
Um topic cobre o arco de uma coisa, e a informação deve permanecer focada nessa única coisa — sem desvios.
|
|
3
|
+
Se a cadeia de acontecimentos de um topic ficar longa ou detalhada demais, você pode dividi-la em acontecimentos menores.
|
|
4
|
+
Se você encontrar várias entradas topic descrevendo a mesma coisa, mescle-as.
|
|
5
|
+
Se você encontrar topics bagunçados — a causa de algo no topic A, o resultado no topic B, enquanto A e B carregam cada um outro material sem relação — pense em como essas coisas realmente se desenvolveram e organize-as. Quebre a informação no conjunto mais claro e sensato de coisas e linhas narrativas separadas: um topic por coisa.
|
|
6
|
+
|
|
7
|
+
[Entradas neste grupo]: {list}
|
|
8
|
+
|
|
9
|
+
# Como atualizar memórias topic
|
|
10
|
+
1. Julgue pela informação mais recente: as coisas que esses topics descrevem evoluíram, há informação nova importante? Atualize-os. Você pode reescrever um topic para incorporar o novo progresso e cortar pontos antigos que você não considera mais importantes.
|
|
11
|
+
2. Reveja a conversa: há um novo topic que valha a pena guardar? Se sim, crie-o. Se sua tarefa não rendeu nenhuma memória topic, isso muito provavelmente é um novo topic.
|
|
12
|
+
3. Algum topic está disperso ou fora do trilho? Se um cobre várias coisas e você acha que deveria ser dividido, quebre o topic grande em sub-topics (crie novos).
|
|
13
|
+
4. Vários topics estão na verdade descrevendo a mesma coisa e precisam ser mesclados? Mescle-os.
|
|
14
|
+
5. Vários topics estão emaranhados, de modo que a separação limpa só sai da mesclagem das informações deles e de uma nova divisão? Reescreva-os.
|
|
15
|
+
6. Quando você atualizar um topic, pense ao contrário de novo: "que informação estou escrevendo neste topic para fornecer? Quem o ler vai entender como este assunto realmente se desenvolveu?"
|
|
16
|
+
7. Sempre que você escrever ou mudar um topic, resuma também suas palavras-chave (de 8 a 13 palavras de conteúdo para recuperação; "quais palavras deveriam fazer a IA ver esta memória quando o usuário as mencionar?").
|
|
17
|
+
8. Registre o project (um nome de projeto, ou global) e a importance.
|
|
18
|
+
9. Para um topic que você considera muito importante, se estiver em dúvida sobre qual é a verdade, vá ler os arquivos do projeto e confira. Apenas para memórias que realmente importam.
|
|
19
|
+
10. Importante: verifique nestes topics qualquer coisa desatualizada, derrubada, provada errada ou enganosa — arquive-a (status=archived) ou reescreva-a (prefira arquivar). Nunca deixe isso como active. E não infle a importance: progresso comum em um assunto é 1, no máximo 2; só algo sério merece 3.
|
|
20
|
+
11. Se um bloco [pares duplicados literalmente] estiver listado: essas duas entradas coincidem em ≥80% no texto (a mesma régua que memory_remember usa para duplicados) — uma frase guardada em duas camadas. Mantenha a que tem mais informação e a camada mais adequada, e marque a outra como status=archived via memory_update; entradas que apenas parecem iguais e não estão listadas não são duplicadas (similaridade significa mesmo assunto, repeat significa mesma frase).Uma marcada como "(outra rodada)" significa que a outra metade não está nesta lista (ela é revisada em outra rodada — fatos e topics são revisados separadamente). Trate do mesmo jeito, e trate o par uma única vez: não pule só porque não consegue ver a outra entrada.
|
|
21
|
+
12. Se [redações duplicadas] listar um par: um resumo curto e uma redação longa dizem a mesma coisa — a repetição literal é baixa (um é o resumo, o outro o texto completo), então o critério é cobertura (o resumo inteiro cabe na versão longa). O que fazer: junte em um só — leve para a versão longa o que só o resumo tem, mantenha a entrada mais completa e marque a outra como status=archived via memory_update. Um par marcado [outra rodada] significa que a outra metade está em outra rodada de arrumação; trate igual, uma vez por par. Não as mantenha como dois fatos só porque o repeat é baixo.
|
|
22
|
+
Abaixo de cada par há também uma linha de receita nomeando as palavras que o resumo tem e a versão longa não tem: são exatamente as que uma fusão costuma perder, então absorva-as literalmente antes de arquivar o resumo. Se a receita disser que o resumo não tem palavras ausentes na versão longa, a fusão é sem perda — mantenha a versão longa, arquive o resumo e não reescreva o texto.
|
|
23
|
+
14. As três réguas cobrem casos distintos: repetição literal ≥80% (Jaccard — "a mesma frase guardada duas vezes"), cobertura ≥90% ("resumo + texto completo") e o "similar N" da verificação de saúde mais memory_search mode="similar" (assinatura de palavras raras — "duas frases diferentes sobre o mesmo assunto"). As duas primeiras significam duplicata: junte em uma e arquive a outra. A terceira significa semelhança: nunca junte duas afirmações diferentes sobre um mesmo assunto, no máximo acrescente um ponteiro ("veja xxx"). Se um "similar N" alto não aparece em nenhum dos dois blocos acima, é o sistema dizendo que são duas coisas — não force a fusão.
|
|
24
|
+
14. Se [conflitos prováveis] listar um par: mesmo assunto com números ou versões diferentes — a terceira doença, nem duplicata nem semelhança. **Não junte as duas em uma e não arquive uma só porque "parece velha"**: fundir apaga uma das versões. Faça três coisas: (1) o tempo primeiro — a linha termina dizendo qual é mais nova; tome a mais nova como atual e reescreva a antiga como "(substituída: …)" ou ponha status=stale, nunca apague direto; (2) a diferença depois — os números que cada lado tem sozinho costumam ser fatos diferentes; nesse caso mantenha os dois e deixe o texto dizer a que cada número pertence; (3) se estiver em dúvida, confira os arquivos do projeto. Deixe rastro: escreva na entrada alterada por que resolveu assim.
|
|
25
|
+
15. Quando terminar, responda diretamente; a primeira linha da resposta deve conter o marcador de grupo {groupMarker} preenchido acima (copie caractere por caractere, sem alterações), seguida por "este grupo está consolidado" e o resumo a partir da segunda linha. Não chame nenhuma outra ferramenta.
|
|
26
|
+
|
|
27
|
+
Você pode chamar várias ferramentas em um turno — por favor, conclua todas as chamadas de ferramenta desta tarefa em uma única resposta.
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
【meow-memory aviso de memória externa】
|
|
2
|
+
Este workspace contém uma biblioteca de memória que não foi criada nesta máquina (.dsh-meow/). Para evitar que conteúdo pré-configurado no repositório seja injetado como memória de longo prazo do próprio usuário, o meow-memory está pausado neste workspace: sem injeção, sem busca, sem consolidação dream, sem escrita, e as ferramentas memory estão desativadas.
|
|
3
|
+
|
|
4
|
+
- Isso normalmente acontece ao clonar um repositório externo que traz seu próprio .dsh-meow/ (a injeção sem interação é projetada para memórias locais; para bibliotecas pré-configuradas é um risco de segurança, issue #64).
|
|
5
|
+
- Se for um projeto do próprio usuário (máquina nova / backup restaurado / diretório copiado), basta executar /meow-trust no composer para reativar — efeito imediato, sem reiniciar.
|
|
6
|
+
- Se o usuário não reconhecer esta biblioteca, basta mantê-la pausada; o workspace também pode ser adicionado à lista disabledWorkspaces.
|
|
7
|
+
|
|
8
|
+
Este aviso aparece apenas uma vez e não exige resposta; se o usuário perguntar por que a memória "desapareceu", os pontos acima são a resposta.
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
【meow-memory 首次建库提示】
|
|
2
|
+
记忆库刚刚在当前工作区创建:{dbPath}。
|
|
3
|
+
|
|
4
|
+
两点须知:
|
|
5
|
+
1. 这个文件在工作区的隐藏目录里,**误删无法恢复**(默认不进 git,也没有回收站)。请把它加入 .gitignore,避免意外提交或清理。
|
|
6
|
+
2. 想把数据放到更安全的位置(工作区之外),可以对 AI 说"把记忆目录迁移到 dsh-storage"(memory_home 工具);也可以在设置页开启自动备份(backup.enabled),每次整理收尾自动生成 memory.db.bak 快照。
|
|
7
|
+
|
|
8
|
+
本提示只出现一次,无需回复;如用户问到记忆数据的存放或安全,以上是要点。
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
# palavras curtas de estrutura do meow-memory (linhas chave-valor: `- key: value`; o primeiro dois-pontos ASCII + espaço é o separador, o valor é mantido literalmente; uma linha que começa com dois espaços continua o valor anterior; os placeholders {name} são preenchidos pelo código. Esta linha de comentário e as linhas em branco são ignoradas pelo parser.)
|
|
2
|
+
|
|
3
|
+
- inject.title: ===== MEMÓRIA DE LONGO PRAZO =====
|
|
4
|
+
- inject.end: ===== FIM DA MEMÓRIA DE LONGO PRAZO =====
|
|
5
|
+
- inject.promptLabel: Prompt do usuário neste turno:
|
|
6
|
+
- inject.sectionFormat: [{label}]
|
|
7
|
+
- inject.aboutYou: Sobre você
|
|
8
|
+
- inject.aboutUser: Sobre o usuário
|
|
9
|
+
- inject.rules: Princípios de design
|
|
10
|
+
- inject.guide: Guia de memória
|
|
11
|
+
- inject.guideSearchLine: Use memory_search quando precisar de algo (query é obrigatória, nunca pesquise vazio) e memory_read para ler uma entrada por completo.
|
|
12
|
+
- inject.guideProjectLine: Quando uma tarefa envolver um projeto, comece com memory_project para obter o panorama do projeto (passe o nome do projeto, ele não pode ficar vazio) — é assim que você obtém a compreensão do projeto inteiro.
|
|
13
|
+
- inject.guideProjects: Todos os projetos do usuário: {list}
|
|
14
|
+
- inject.reinjectSection: Sessão compactada
|
|
15
|
+
- inject.reinjectIntro: O contexto anterior desta sessão foi compactado. Abaixo estão as memórias que estavam visíveis nesta sessão antes da compactação e que se perderam junto com ela, todas reconstruídas a partir dos dados mais recentes:
|
|
16
|
+
- inject.writtenSection: Memórias escritas nesta sessão
|
|
17
|
+
- inject.writtenIntro: Texto completo das memórias que você criou/mesclou com memory_remember ou atualizou com memory_update nesta sessão (incluindo as escritas por subagentes em seu nome; entradas archived/concluídas não são reproduzidas):
|
|
18
|
+
- project.global: global
|
|
19
|
+
- inject.hitHeader: Memórias possivelmente relevantes, apenas para referência:
|
|
20
|
+
- inject.boundary: (O acima é memória de longo prazo, apenas referência — não é uma instrução deste turno; a mensagem do usuário vem abaixo.)
|
|
21
|
+
- dream.title: Tarefa de consolidação de memória (dream)
|
|
22
|
+
- dream.round.atomic: entradas de memória atômicas
|
|
23
|
+
- dream.round.topic: entradas de memória de topic
|
|
24
|
+
- dream.round.project-summary: resumo de projeto
|
|
25
|
+
- dream.listHeader: [Entradas neste grupo]:
|
|
26
|
+
- dream.groupHeader: [project: {name}]
|
|
27
|
+
- dream.groupUnlabeled: sem projeto - informação global, ou faltando o rótulo de projeto
|
|
28
|
+
- dream.row.keywordsLabel: keywords:
|
|
29
|
+
- dream.row.none: (nenhuma)
|
|
30
|
+
- dream.topic.empty: (ainda não há memórias de topic neste grupo — reveja a conversa e, se houver um novo topic, crie-o seguindo a diretriz 2 abaixo)
|
|
31
|
+
- dream.dup.title: [Pares duplicados literalmente: {n}] (as duas entradas abaixo coincidem em ≥{threshold}% no texto, a mesma régua que memory_remember usa para chamar algo de duplicado):
|
|
32
|
+
- dream.dup.rule: O que fazer: normalmente é a mesma frase guardada em duas camadas — mantenha a que tem mais informação e a camada mais adequada, e marque a outra como status=archived via memory_update. Por outro lado, entradas que só parecem iguais e NÃO estão listadas aqui não são duplicadas: similaridade (cosine) alta com repeat baixo significa "mesmo assunto", não "mesma frase".
|
|
33
|
+
- dream.dup.crossRound: outra rodada
|
|
34
|
+
- dream.cover.title: [Redações duplicadas: {n}] (em cada par o item da esquerda cabe inteiro dentro do da direita — a repetição literal é de poucas dezenas por cento, porque um é um resumo curto e o outro a versão completa, mas dizem a mesma coisa; o critério é cobertura ≥{contain}%):
|
|
35
|
+
- dream.cover.rule: O que fazer: junte em um só — leve para a versão completa o que só o resumo tem, mantenha a entrada mais completa e marque a outra como status=archived via memory_update. Não as trate como dois fatos só porque o repeat é baixo: o mesmo conhecimento guardado duas vezes custa duas vezes na injeção da primeira rodada.
|
|
36
|
+
- dream.cover.keep: Receita: fique com a versão completa e absorva estas {n} palavras do resumo ({words}) — se ficarem de fora, a fusão as perde.
|
|
37
|
+
- dream.cover.keepNone: Receita: o resumo não tem nenhuma palavra que a versão completa não tenha, então não há nada a absorver — mantenha a versão completa, marque o resumo como archived e não reescreva o texto.
|
|
38
|
+
- dream.plan: [esta rodada vê {rounds} rodadas / {rows} entradas · {dup} pares repetidos ao pé da letra · {cover} pares de redações duplicadas] — os números saem da própria lista; no fim, os mesmos números vão para o registro do dream.
|
|
39
|
+
- dream.plan.missing: Nesses pares de redações duplicadas, {missing} palavras vivem só no resumo, então precisam ser absorvidas na fusão (cada par as nomeia na linha de receita).
|
|
40
|
+
- dream.conflict.title: [conflitos prováveis: {n}] (cada par abaixo está no mesmo assunto — pelo menos {keys} palavras-chave em comum — mas afirma números ou versões diferentes; não são duplicatas, duplicatas ficam acima. As duas versões aparecem lado a lado, sem veredito):
|
|
41
|
+
- dream.conflict.keywords: palavras-chave em comum: {words}{more}
|
|
42
|
+
- dream.conflict.only: {id} tem sozinho {nums}{more}
|
|
43
|
+
- dream.conflict.more: ({n} no total)
|
|
44
|
+
- dream.conflict.newer: -> {id} é mais novo ({time}): vale a versão mais nova — ou reescreva a antiga para bater, ou ponha status stale com memory_update
|
|
45
|
+
- dream.conflict.same: -> as duas têm exatamente o mesmo horário de atualização ({time}), então nenhuma é mais nova — leia os textos e decida você mesmo
|
|
46
|
+
- dream.conflict.rule: Régua — mesmo assunto + números/versões diferentes + nem duplicata literal nem resumo-com-redação. Redação diferente com números idênticos **não** conta como conflito (é reescrita); entrada arquivada também não é reportada (arquivar já é o desfecho). Como quer que resolva, deixe na entrada alterada um rastro do porquê.
|
|
47
|
+
- dream.plan.conflicts: mais {n} conflitos prováveis (mesmo assunto, números/versões diferentes — nomeados na lista).
|
|
48
|
+
- dream.chain.title: 【{n} cadeias de sucessão quebradas】(estas entradas dizem "substituída por <id8>", mas essa sucessora não está mais no acervo, ou os 8 primeiros caracteres colidem com várias entradas e não dá para saber qual — os blocos acima comparam redação, o que não pega este caso):
|
|
49
|
+
- dream.chain.absent: diz que {who} assumiu ({day}), mas essa entrada não está mais no acervo (apagada ou movida) — ou esta entrada é a conclusão atual (volte para active), ou reescreva uma vez com supersedes para uma nova entrada assumir.
|
|
50
|
+
- dream.chain.ambiguous: diz que {who} assumiu ({day}), mas esse prefixo casa com {hits} entradas do acervo (entradas gravadas no mesmo segundo sempre compartilham os 8 primeiros caracteres) — confira você mesmo o início「{head}」e escolha a certa; não edite a entrada errada só pelo prefixo.
|
|
51
|
+
- dream.chain.more: mais {n} quebradas do mesmo jeito; resolva as de cima primeiro.
|
|
52
|
+
- dream.chain.rule: Régua — o corpo traz uma linha de sucessão, e o prefixo casa com 0 entradas (absent) ou ≥2 sem casar o início (ambiguous). Uma única correspondência, ou colisão cujo início casa, não é reportada (a cadeia está boa). Nenhum dos dois casos é "precisa organizar": é "já foi organizado errado" — ou reescreva a sucessão uma vez, ou diga o que esta entrada é agora; não deixe uma linhagem apontando para o vazio.
|
|
53
|
+
- dream.repeat.title: O que esta rodada escreveu já existe na biblioteca ({n} entradas) — isso não é conhecimento novo:
|
|
54
|
+
- dream.repeat.line: {id} · {level} ⇔ {oid} · {olevel} ({day}, {status}) sobreposição {pct}%
|
|
55
|
+
- dream.repeat.keep: A outra continua ativa: mescle este conteúdo em {oid} (união, não sobrescreva), marque esta como stale e escreva "substituída por {oid}" — não deixe duas entradas paralelas.
|
|
56
|
+
- dream.repeat.revive: {oid} foi aposentada e esta rodada escreveu quase a mesma coisa: decida se é um retorno (volte {oid} para active e mescle) ou uma conclusão nova (explique a diferença em vez de reescrever).
|
|
57
|
+
- dream.repeat.more: mais {n} do mesmo tipo não listadas (ordenadas por sobreposição).
|
|
58
|
+
- dream.repeat.rule: Das duplicatas fica uma: mescle primeiro, depois aponte para ela com supersedes; "já escrito" não quer dizer "escrever de novo fica mais claro".
|
|
59
|
+
- project.unlabeled: sem rótulo
|
|
60
|
+
- project.header: [project: {name}]
|
|
61
|
+
- project.empty: [project: {name}] Ainda não há entradas de memória para este projeto.
|
|
62
|
+
- project.section.overview: Visão geral
|
|
63
|
+
- project.section.structure: Estrutura
|
|
64
|
+
- project.section.decisions: Decisões técnicas
|
|
65
|
+
- project.section.quotes: As palavras do próprio usuário
|
|
66
|
+
- project.section.ops: Implantação e dados
|
|
67
|
+
- project.section.todo: Progresso do projeto
|
|
68
|
+
- project.todoDone: Concluído:
|
|
69
|
+
- project.todoOpen: Lista de tarefas:
|
|
70
|
+
- time.none: sem timestamp
|
|
71
|
+
- time.justNow: agora mesmo
|
|
72
|
+
- time.minutes: há {n} min
|
|
73
|
+
- time.hours: há {n} h
|
|
74
|
+
- time.days: há {n} d
|
|
75
|
+
- reflect.noProjects: (nenhum ainda)
|
|
76
|
+
- reflect.incidentHead: ⚠️ Algo quebrou nesta rodada, então o plugin chamou esta reflexão por conta própria (não é cadência de passos):
|
|
77
|
+
- reflect.incidentTools: · {count} falha(s) de ferramenta{detail}
|
|
78
|
+
- reflect.incidentDetail: ({detail})
|
|
79
|
+
- reflect.incidentTurnError: · A rodada terminou em erro.
|
|
80
|
+
- reflect.incidentCue: · O usuário usou tom de correção ou de incidente — algo que ele não quer ver de novo pode ter acabado de acontecer.
|
|
81
|
+
- reflect.incidentAsk: Decida primeiro: incidente real ou oscilação que se recuperou sozinha? Incidente real vira lesson (sintoma → causa raiz → correção → como perceber antes da próxima vez); oscilação entra numa entrada existente, sem virar ruído novo.
|
|
82
|
+
- reflect.incidentRepeat: · Não é a primeira vez: {detail}. Uma oscilação isolada não explica isso — escreva uma lesson (sintoma → causa raiz → correção → como perceber antes da próxima vez) em vez de mais uma frase solta.
|
|
83
|
+
- reflect.incidentNoFollowup: · Você já refletiu antes e não escreveu nada na memória depois ({count} vez(es) no registro) — aquela reflexão foi perdida; não pare em impressões desta vez.
|
|
84
|
+
- reflect.unknownTool: uma ferramenta
|
|
85
|
+
- conflict.kindVersion: versão
|
|
86
|
+
- conflict.kindDate: data
|
|
87
|
+
- conflict.join: ;
|
|
88
|
+
- conflict.item: {level} {id} ({kind}: ele diz {theirs}, você acabou de escrever {mine})
|
|
89
|
+
- search.statusDown: {n} destes resultados não estão em uso (stale = concluído ou substituído, archived = anulado): foram rebaixados para {stale} / {arch} e ordenados depois — não os trate como conclusão atual; use status:"active" para ver só os vigentes.
|
|
90
|
+
- search.dedupeKept: outros {n} registros são quase idênticos (sobreposição ≥{th}%) e não foram repetidos: mantido {kept} (escolhido por em uso → mais novo → maior nota), descartados {dropped}. Use dedupe: false para ver tudo.
|
|
91
|
+
- search.floorLift: mais {n} ficaram abaixo de {pct}% do topo, mas são as entradas sucessoras nomeadas por alguma acima ({ids}), então também são mostradas — não trate a entrada substituída acima como conclusão.
|
|
92
|
+
- conflict.head: ⚠️ O acervo já diz a mesma coisa de outro jeito: {items}. Esta entrada foi gravada mesmo assim — mas se a antiga foi substituída por esta, o correto é passar supersedes (ou marcar status=stale via memory_update: nada é apagado, dá para voltar atrás), em vez de deixar duas versões lado a lado; ignore se forem coisas diferentes.
|
|
93
|
+
- conflict.headUpdate: ⚠️ Depois desta edição o acervo ainda diz a mesma coisa de outro jeito: {items}. A edição foi aplicada mesmo assim — mas duas versões lado a lado fazem a próxima busca não saber em qual confiar: se aquelas entradas foram substituídas por esta edição, marque status=stale nelas (nada é apagado, dá para voltar atrás; uma nova gravação também resolve em um passo com supersedes), em vez de deixar as duas; ignore se forem coisas diferentes.
|
|
94
|
+
- remember.error.content: memory_remember: content é obrigatório — acrescente o que você quer lembrar e tente de novo
|
|
95
|
+
- remember.error.project: memory_remember: project é obrigatório — use "{global}" para informações aplicáveis globalmente, ou o nome do projeto (separe vários projetos por vírgula) — acrescente e tente de novo
|
|
96
|
+
- remember.error.keywords: memory_remember: keywords é obrigatório — dê de 8 a 13 palavras-chave de conteúdo para a recuperação (não use o nome do projeto como palavra-chave) — acrescente-as e tente de novo
|
|
97
|
+
- remember.error.keywordsEmpty: memory_remember: keywords chegou, mas não deu para extrair nenhuma palavra-chave dele (recebido {received}) — passe um array de strings, ou o texto das palavras-chave separadas por vírgula, e tente de novo
|
|
98
|
+
- remember.error.importance: memory_remember: importance é obrigatório — avalie: 4=linha vermelha fatal / saúde e segurança, 3=enfatizado pelo usuário / aplicável globalmente, 2=uma decisão do usuário ou uma conclusão abstrata, 1=trivialidade — acrescente e tente de novo
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
Tarefa de reflexão de memória
|
|
2
|
+
Reveja seu histórico de conversa.
|
|
3
|
+
|
|
4
|
+
[1] Desde a última [Tarefa de reflexão de memória], ao longo de todos aqueles turnos, há algo novo que valha a pena lembrar entre sessões? Use memory_remember para adicioná-lo.
|
|
5
|
+
1. Projetos já no armazenamento de memória: {projectList}. Você acha que um novo projeto deveria ser adicionado? -> Adicione uma memória para o novo projeto.
|
|
6
|
+
2. Você foi corrigido pelo usuário? Foi elogiado? Caiu em alguma armadilha, e como a resolveu no fim? Guarde isso como memórias lesson.
|
|
7
|
+
- Registre seus erros, mas também seus próprios desempenhos excelentes, as armadilhas em que caiu e como você resolveu os problemas com esperteza no fim.
|
|
8
|
+
- Se for algo que o usuário corrigiu, mantenha a flag corrected;
|
|
9
|
+
3. Adicione entradas a seu critério quando qualquer um destes casos se aplicar:
|
|
10
|
+
- O usuário declarou uma preferência de comunicação / de trabalho / de código? -> Preferências globais vão em user; as específicas de projeto vão em project.
|
|
11
|
+
- O usuário estabeleceu um princípio de design ou uma regra de comportamento? -> Registre em rules.
|
|
12
|
+
- O usuário disse algo ao explicar o pensamento de design do projeto, o framework ou o raciocínio? -> Preserve as palavras dele, no level certo.
|
|
13
|
+
- Algum fato, conclusão ou decisão importante?
|
|
14
|
+
|
|
15
|
+
[2] Reveja cada memória injetada neste contexto, pese-a contra seu progresso mais recente e decida: algo precisa de atualização?
|
|
16
|
+
1. Há alguma entrada que você agora tem certeza que está desatualizada (o próprio usuário disse, ou mudou de ideia)? -> Atualize o content dela; não a deixe parada lá.
|
|
17
|
+
2. Você encontrou uma entrada errada, ou que te induziu ativamente ao erro? -> Corrija-a, ou marque-a como archived (que significa excluir);
|
|
18
|
+
3. Algum todo ou topic foi concluído? -> Marque-os como stale (que significa done);
|
|
19
|
+
4. Alguma entrada foi injetada em um momento completamente irrazoável, sem relação com a tarefa em questão? -> Isso significa que as palavras-chave dela estão erradas; atualize-as;
|
|
20
|
+
|
|
21
|
+
[3] Requisitos gerais ao escrever memórias
|
|
22
|
+
1. As regras para escrever memórias estão no system prompt. Coloque cada memória no level certo e sob o rótulo certo.
|
|
23
|
+
2. Vale repetir, o critério para palavras-chave:
|
|
24
|
+
- Extraia de 8 a 13 palavras-chave para a recuperação
|
|
25
|
+
- Pense ao contrário: "quais palavras no prompt de um usuário deveriam fazer esta memória aparecer?"
|
|
26
|
+
- Não o nome do projeto — detalhes específicos da própria memória.
|
|
27
|
+
- Prefira entidades centrais, o centro semântico, nomes próprios.
|
|
28
|
+
- Forma dicionarizada simples: o tokenizador faz stemming das palavras em inglês, então um substantivo no singular já casa com seu plural; pule stopwords, elas não recuperam nada.
|
|
29
|
+
3. Se você acha que não há nada importante e nada a adicionar ou atualizar, responda apenas "nenhuma memória necessária" e não chame ferramenta nenhuma.
|
|
30
|
+
|
|
31
|
+
Você pode chamar várias ferramentas em um turno — por favor, conclua todas as chamadas de ferramenta desta tarefa em uma única resposta.
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
[Sistema de memória] O meow-memory te dá memória entre sessões.
|
|
2
|
+
|
|
3
|
+
I. O que o armazenamento de memória contém
|
|
4
|
+
1. Níveis de memória:
|
|
5
|
+
- soul = sobre você, a IA;
|
|
6
|
+
- user = fatos básicos do usuário, preferências de base, ambiente importante de dispositivo/rede, coisas que importam sobre o próprio usuário. Injetado em toda sessão, então mantenha enxuto — só o que realmente importa.
|
|
7
|
+
- rules = princípios de design / diretrizes de comportamento. Regras globais usam project "global"; regras específicas de projeto usam o nome desse projeto;
|
|
8
|
+
- fact = fatos atômicos pequenos (uma frase simples, ≤30 palavras);
|
|
9
|
+
- lesson = o que você aprendeu, sua própria experiência;
|
|
10
|
+
- topic = um assunto: o que causou algo, como se desenvolveu, onde está agora. Te dá a visão mais ampla de como os acontecimentos se desenrolaram. Atualize-o conforme a história avança.
|
|
11
|
+
- project = um projeto. As memórias de project têm subcategorias:
|
|
12
|
+
overview: o propósito do projeto, resumo, metainformação, introdução geral.
|
|
13
|
+
structure: qualquer coisa sobre a arquitetura do projeto.
|
|
14
|
+
decisions: decisões de design importantes.
|
|
15
|
+
quotes: as palavras do próprio usuário, quando você julgar que são importantes.
|
|
16
|
+
ops: implantação e dados (portas / caminhos / como iniciar / onde fica o banco de dados / passos operacionais).
|
|
17
|
+
todo: a lista de tarefas sua e do usuário — tarefas que você acha que estão por vir.
|
|
18
|
+
|
|
19
|
+
2. Estrutura e requisitos:
|
|
20
|
+
- As memórias são armazenadas como entradas separadas em um banco de dados. Nenhuma entrada deve ser longa demais (exceto entradas topic).
|
|
21
|
+
- Cada entrada deve tratar de uma coisa ou de um fato. Se houver muitos fatos, divida-os em várias entradas.
|
|
22
|
+
- Toda entrada precisa ter palavras-chave.
|
|
23
|
+
- As entradas topic são um caso especial: podem ser mais longas, mas continuam em um só assunto — nunca misture várias linhas narrativas em uma.
|
|
24
|
+
- Se você notar uma entrada carregando informação demais, divida-a por iniciativa própria.
|
|
25
|
+
- As memórias devem se manter atuais. Quando um fato ou o estado de um projeto mudar, atualize o content ou mude o status da entrada prontamente.
|
|
26
|
+
|
|
27
|
+
3. Como as memórias chegam até você
|
|
28
|
+
- Memórias relevantes são injetadas automaticamente (memória de longo prazo no primeiro turno + acertos de palavras-chave em cada mensagem). Você não precisa fazer nada;
|
|
29
|
+
- As memórias injetadas são apenas para referência:
|
|
30
|
+
Elas podem ser ou não relevantes para a tarefa em questão — se uma injeção não tiver nada a ver com o assunto atual, suas palavras-chave geralmente estão erradas, então atualize-as.
|
|
31
|
+
Elas podem estar corretas, obsoletas ou simplesmente erradas — se você encontrar uma entrada incompleta, que contradiz a realidade ou desatualizada, atualize-a.
|
|
32
|
+
- As memórias são ordenadas pelo timestamp de "última atualização". Em conflito, a mais nova vence; as mais antigas ainda podem ser lidas como histórico.
|
|
33
|
+
- Um recibo incompleto não é ausência: quando a busca cobre só parte da pergunta — ou não retorna nada — responda com o fato mais provável a partir do acerto mais próximo; diga que não sabe apenas quando o material for de fato sem relação. Medido em 1.193 perguntas do LoCoMo com material idêntico: 45,9% → 54,2% de acerto e as respostas "não sei" caíram de 25,6% para 0,3%.
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
II. As ferramentas de memória que você tem
|
|
37
|
+
|
|
38
|
+
[Escrevendo memória]
|
|
39
|
+
|
|
40
|
+
1. Adicionar uma nova memória: memory_remember
|
|
41
|
+
- Obrigatórios: content / project / keywords (8 a 13 palavras-chave de recuperação) / importance.
|
|
42
|
+
- Se ela se sobrepõe muito a uma entrada existente, mescle com update em vez de adicionar uma nova.
|
|
43
|
+
- Se uma entrada existente está sobrecarregada e precisa ser dividida, dê memory_remember nas partes.
|
|
44
|
+
|
|
45
|
+
2. Atualizar uma entrada existente: memory_update
|
|
46
|
+
- Exige o id da memória, para apontar para exatamente uma entrada.
|
|
47
|
+
- Se keywords/content/project/importance/status parecerem errados, atualize-os com o parâmetro correspondente.
|
|
48
|
+
- Uma chamada de update pode mudar vários campos de uma vez.
|
|
49
|
+
- Passe apenas o que você quer mudar; deixe o resto de fora.
|
|
50
|
+
|
|
51
|
+
[Lendo memória]
|
|
52
|
+
|
|
53
|
+
3. Ver um projeto inteiro: memory_project
|
|
54
|
+
- Qual projeto você quer olhar? O nome do projeto é obrigatório.
|
|
55
|
+
- Te dá o panorama do projeto para você se atualizar rápido.
|
|
56
|
+
- Inclui histórico de design, decisões técnicas, as palavras do próprio usuário, progresso do projeto.
|
|
57
|
+
|
|
58
|
+
4. Pesquisar memória: memory_search
|
|
59
|
+
- query é obrigatória: passe palavras-chave ou uma frase (ex.: "implantação do plugin de memória"). Nunca pesquise com query vazia.
|
|
60
|
+
- Retorna uma visão de metadados, não o texto completo; use as palavras-chave para julgar qual entrada tem o que você precisa, depois leia a entrada inteira com memory_read.
|
|
61
|
+
- Top 10 padrão = as 5 primeiras puramente por relevância (nada excluído, incluindo entradas já injetadas/pesquisadas/criadas nesta sessão) + 5 mais que pulam entradas já injetadas/já pesquisadas.
|
|
62
|
+
- Pesquisa fact/lesson/topic/rules/user por padrão (o level user guarda as preferências e o ambiente do dono);
|
|
63
|
+
- Você pode restringi-la a um level/project/status (múltipla escolha, separados por vírgula).
|
|
64
|
+
- Você pode restringir por tempo, ex.: days: 30 = apenas entradas criadas nos últimos 30 dias.
|
|
65
|
+
- Top k padrão = 10; k pode ser 1-50.
|
|
66
|
+
|
|
67
|
+
5. Ler uma entrada específica: memory_read
|
|
68
|
+
- Lê o content completo pelo id da memória (incluindo os metadados keywords/importance/status).
|
|
69
|
+
|
|
70
|
+
6. Encontrar duplicatas e conflitos: memory_find_similar
|
|
71
|
+
- Encontra entradas semelhantes a um dado id de memória.
|
|
72
|
+
|
|
73
|
+
7. Arquivos-fonte pesquisáveis
|
|
74
|
+
- As memórias ficam em SQLite (o caminho é impresso no fim da saída de memory_project); quando o memory_search não bastar, você pode consultar o banco de dados diretamente.
|
|
75
|
+
- Quando o armazenamento de memória não tiver nada, pesquise nos logs brutos de conversa.
|
|
76
|
+
Logs brutos de conversa: $DSH_HOME/sessions/<workspace>/<session id>/session.jsonl.zstd — JSONL comprimido com Zstandard;
|
|
77
|
+
comando de uma linha com node:zlib no Node >= 22.13:
|
|
78
|
+
node -e "console.log(require('node:zlib').zstdDecompressSync(require('fs').readFileSync(process.argv[1])).toString())" <file>
|
|
79
|
+
- Em particular, quando o usuário perguntar sobre um detalhe que a busca de memória não consegue encontrar, pegue a descrição do usuário mais quaisquer pistas relacionadas que você encontrou e vá pesquisar nos logs brutos de conversa.
|
|
80
|
+
|
|
81
|
+
[Consolidando memória]
|
|
82
|
+
|
|
83
|
+
8. Consolidar as memórias desta janela: memory_dream
|
|
84
|
+
- Dispara automaticamente após 3+ horas de ociosidade da janela (suprimido nos horários de pico, 09:00-12:00 e 14:00-18:00 no horário de Pequim, mais os 15 minutos antes de cada um). Você também pode chamá-lo manualmente.
|
|
85
|
+
|
|
86
|
+
|
|
87
|
+
III. Padrões de escrita (valem tanto para memórias novas quanto atualizadas):
|
|
88
|
+
1. content
|
|
89
|
+
- Mantenha curto. Se ficar longo, divida em várias entradas.
|
|
90
|
+
- Alta densidade de informação, sem enrolação.
|
|
91
|
+
- Quando o usuário descreve um projeto, preserve a redação dele sempre que puder — o jeito de falar dele carrega o raciocínio dele, e isso é valioso.
|
|
92
|
+
- Mantenha atual. No momento em que encontrar algo errado ou desatualizado, corrija o content ou arquive a entrada. Nunca deixe uma memória errada ou obsoleta com status active.
|
|
93
|
+
|
|
94
|
+
2. keywords
|
|
95
|
+
- Entenda para que servem as palavras-chave: o sistema de memória recupera por elas. Quando o prompt do usuário acerta as palavras-chave de uma entrada, essa entrada é trazida.
|
|
96
|
+
- Então pense ao contrário: "quais palavras no prompt de um usuário deveriam fazer esta memória aparecer?" Esse é o seu critério para escrever palavras-chave.
|
|
97
|
+
- Extraia de 8 a 13 palavras-chave por entrada.
|
|
98
|
+
- Não use o nome do projeto como palavra-chave; use palavras específicas desta entrada.
|
|
99
|
+
- Prefira entidades centrais, o centro semântico, nomes próprios.
|
|
100
|
+
- Escreva as palavras-chave na forma dicionarizada simples — o tokenizador faz stemming das palavras em inglês (running/ran -> run, caches -> cach), então um substantivo no singular já casa com seu plural. Não gaste espaços com as duas formas; gaste-os com conceitos distintos.
|
|
101
|
+
- Pule as stopwords (the, and, is, with, ...) — o tokenizador as descarta, então elas não recuperam nada.
|
|
102
|
+
- Se uma entrada está sendo injetada no momento errado, sem relação com o que você está discutindo, suas palavras-chave foram mal escolhidas. Atualize-as.
|
|
103
|
+
|
|
104
|
+
3. importance
|
|
105
|
+
- Decisões críticas e perigosas, em que errar machuca / linhas vermelhas / lessons, e qualquer coisa sobre saúde ou segurança -> 4;
|
|
106
|
+
- Coisas que o usuário enfatizou, coisas que o usuário considera importantes, regras aplicáveis globalmente, informações gerais aplicáveis globalmente -> 3;
|
|
107
|
+
- Decisões do usuário, conclusões abstratas que atravessam vários arquivos e são difíceis de verificar -> 2;
|
|
108
|
+
- Detalhes atômicos triviais, informações de aplicação restrita, pequenas notas que valem o registro -> 1.
|
|
109
|
+
|
|
110
|
+
4. status
|
|
111
|
+
- Memórias novas são active por padrão. memory_update muda o status.
|
|
112
|
+
- stale = finalizado (um todo concluído -> stale significa done);
|
|
113
|
+
- archived = excluído (desatualizado, inválido, duplicado, substituído por uma versão mais nova);
|
|
114
|
+
- Caso contrário, deixe como active.
|
|
115
|
+
|
|
116
|
+
5. project
|
|
117
|
+
- Se o usuário começar a falar de um projeto totalmente novo, crie esse projeto.
|
|
118
|
+
- Se a informação se aplica a um projeto específico, escreva o nome desse projeto ao lembrá-la.
|
|
119
|
+
- Se ela se aplica globalmente, e não a um único projeto, defina project como "global".
|
|
120
|
+
- Se não for global, mas se aplicar a vários projetos, liste os nomes dos projetos separados por vírgulas (ex.: "dsh, femwa").
|
|
121
|
+
- Se o campo project de uma entrada estiver errado ou incompleto, atualize-o.
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
# textos das ferramentas do meow-memory (linhas chave-valor: `- key: value`; o primeiro dois-pontos ASCII + espaço é o separador, o valor é mantido literalmente; uma linha que começa com dois espaços continua o valor anterior. Os títulos `###` são apenas para leitura e são ignorados pelo parser.
|
|
2
|
+
# Convenção de chaves: <tool>.description / <tool>.param.<name> / <tool>.out.<path>. Uma chave ausente gera erro; chaves novas precisam ser espelhadas em src/tools.ts.)
|
|
3
|
+
|
|
4
|
+
### memory_remember
|
|
5
|
+
|
|
6
|
+
- memory_remember.description: Escreva algo que valha a pena lembrar entre sessões no armazenamento de memória deste workspace (SQLite, uma tabela por level). Obrigatórios: content / project ("global", ou um nome de projeto; separe vários por vírgula) / keywords (8 a 13 palavras-chave de recuperação) / importance. Omitir um deles gera um erro pedindo que você o preencha. Levels: soul=a própria IA (use com parcimônia); user=fatos básicos e preferências de base do usuário; project=um projeto (ex.: femwa/meow-memory/meow-eyes/dsh); rules=princípios de design / diretrizes de comportamento (uma regra global usa project "global" e, com importance>=2, é injetada por completo no primeiro turno; uma regra específica de projeto usa o nome desse projeto e é injetada com memory_project; todo o resto aparece pela busca); fact=fatos atômicos pequenos (uma frase simples, <=30 palavras); lesson=o que você aprendeu, sua própria experiência (tudo em que você foi corrigido entra aqui); topic=um assunto (dê a ele uma frase de objetivo; recuperado por palavras-chave). Regra rígida: quando o usuário explica o pensamento de design de um projeto, o framework ou o raciocínio por trás de uma decisão, o content deve preservar as palavras do próprio usuário — não parafraseie nem resuma isso. Entradas que se sobrepõem muito a uma existente são mescladas automaticamente (atualizadas, não duplicadas). A ferramenta confirma em caso de sucesso — não é preciso chamá-la de novo.
|
|
7
|
+
- memory_remember.param.content: O que lembrar; fact/lesson uma frase <=30 palavras; topic <=180 palavras; onde as palavras do próprio usuário estiverem envolvidas, mantenha a redação dele.
|
|
8
|
+
- memory_remember.param.level: Nível de memória, padrão fact.
|
|
9
|
+
- memory_remember.param.project: Obrigatório. Nome do projeto (deve ser um nome concreto de projeto quando level=project); use "global" para informações aplicáveis globalmente; separe vários projetos por vírgula, ex.: "dsh,femwa".
|
|
10
|
+
- memory_remember.param.subcategory: subcategoria de project: overview=propósito e resumo / structure=arquitetura / decisions=decisões técnicas / quotes=as palavras do próprio usuário / ops=implantação e dados / todo=em andamento.
|
|
11
|
+
- memory_remember.param.goal: A frase de objetivo do topic (recomendada quando level=topic, ex.: "fazer a integração do femGen funcionar").
|
|
12
|
+
- memory_remember.param.importance: Importância (qualquer número, sem limite superior; orientação suave 1-4: 4=linha vermelha fatal / saúde e segurança, 3=enfatizado pelo usuário / aplicável globalmente, 2=uma decisão do usuário ou uma conclusão abstrata, 1=trivialidade).
|
|
13
|
+
- memory_remember.param.corrected: Se isto é algo que o usuário corrigiu (para level=lesson).
|
|
14
|
+
- memory_remember.param.keywords: Palavras-chave que você escolhe (as rodadas de reflection/dream pedem de 8 a 13 palavras de conteúdo; omita e elas são extraídas automaticamente).
|
|
15
|
+
- memory_remember.param.overwrite: Se uma fusão pode substituir o conteúdo antigo por este (padrão false). Por padrão a fusão recusa trocar por um conteúdo mais curto e não literal porque isso come detalhes antigos; passe true quando quiser mesmo comprimir.
|
|
16
|
+
- memory_remember.out.keywords: As palavras-chave realmente armazenadas (extraídas automaticamente; após uma mesclagem, o valor mais recente).
|
|
17
|
+
- memory_remember.out.project: O projeto realmente registrado (se houver).
|
|
18
|
+
|
|
19
|
+
### memory_search
|
|
20
|
+
|
|
21
|
+
- memory_search.description: Pesquisa no armazenamento de memória deste workspace (BM25 x peso de recência). query é obrigatória e não pode ficar vazia — passe as palavras-chave ou a frase que você procura, ex.: memory_search({query: "implantação do plugin de memória"}); para navegar um projeto inteiro use memory_project (não precisa de query), não chame esta ferramenta com query vazia. O que volta (decisão do usuário): top 10 padrão = as 5 primeiras direto do ranking de relevância (nada excluído, incluindo entradas já injetadas/pesquisadas/criadas nesta sessão) + 5 mais tiradas de mais abaixo no ranking, pulando entradas já injetadas/já pesquisadas (assim você recebe material novo). Escopo padrão = fact+lesson+topic+rules; level aceita uma lista separada por vírgulas (ex.: fact,lesson); passe level=project para a visão do projeto inteiro. Os resultados são pegos por top-k de relevância e depois reordenados pelo timestamp da memória (antigo -> novo), para você ver como as coisas evoluíram e qual de duas entradas conflitantes é mais nova.
|
|
22
|
+
- memory_search.param.query: Palavras-chave ou frase de busca (obrigatória, não pode ficar vazia; ex.: "implantação do plugin de memória").
|
|
23
|
+
- memory_search.param.level: Restringe a levels, separados por vírgula: fact/lesson/topic/rules/project/soul/user (padrão fact,lesson,topic,rules,user — o level user guarda as preferências e o ambiente do dono, então "como eu costumo gostar disso" precisa ser alcançável; soul e project não são pesquisados por padrão, passe-os explicitamente).
|
|
24
|
+
- memory_search.param.project: Filtra por nome de projeto (separados por vírgula, semântica OR, ex.: "dsh,femwa"; entradas "global" e sem rótulo são sempre incluídas).
|
|
25
|
+
- memory_search.param.status: Filtra por status (separados por vírgula: active/archived/stale/all; padrão active, em que um todo stale conta como concluído e ainda participa; incluir all = sem filtro).
|
|
26
|
+
- memory_search.param.days: Apenas entradas criadas nos últimos N dias (por tempo de criação).
|
|
27
|
+
- memory_search.param.k: Número máximo de resultados.
|
|
28
|
+
- memory_search.param.content_max: Trunca o content de cada entrada neste comprimento, 0=texto completo.
|
|
29
|
+
- memory_search.param.context: chave de contexto adjacente (padrão 0 = desligado): anexa até N (1-3) linhas vizinhas de cada lado de cada acerto. Ligue (1-2) quando a pergunta for sobre *quando*, sobre ordem, ou quando um acerto sozinho não resolve (multi-hop): em 1.193 perguntas do LoCoMo a comparação pareada rendeu +8,0 pontos de acurácia (26,9% → 34,9%), ao custo de o recibo ir de ~1,4k para ~3,5k caracteres. As linhas vizinhas são limitadas a 24 por recibo; quando corta, uma linha diz quantas ficaram de fora e memory_read traz o texto completo.
|
|
30
|
+
- memory_search.param.min_rel: Piso de relevancia (0-1, padrao 0.30): so expande entradas com pontuacao de pelo menos essa fracao do topo; a cauda mais fraca e descartada e o total com a melhor pontuacao e informado. Passe 0 para ver tudo.
|
|
31
|
+
- memory_search.param.dedupe: Dobra de quase-duplicatas (padrao ativo): entradas com conteudo praticamente igual (sobreposicao literal ≥80%) aparecem uma vez so, mantendo a de maior pontuacao, e o total dobrado e informado; o caso tipico e a mesma frase gravada em fact e em lesson. Passe false para listar todas.
|
|
32
|
+
- memory_search.param.explain: Interruptor de recuperação explicável (padrão desativado). Com true, cada hit traz uma decomposição de pontuação em explain (pontuação bm25 de palavras-chave, importance, peso recencyWeight de Ebbinghaus, status), para depurar "por que não foi recuperado / por que foi recuperado"; a ordem não muda.
|
|
33
|
+
- memory_search.out.note: Nota de conflito.
|
|
34
|
+
- memory_search.out.timeline: Linha do tempo, do mais antigo ao mais recente: so quando a query pergunta sobre tempo (when / before / after / ...) e houve pelo menos 3 acertos; no maximo 8 entradas, como `[3] 2023-05-08 13:56 · [1] ...`, em que o numero e o mesmo [k] do cabecalho do acerto.
|
|
35
|
+
- memory_search.out.hits.id: id completo da memória (passe-o para memory_read/memory_update/memory_find_similar).
|
|
36
|
+
- memory_search.out.hits.keywords: As palavras-chave da entrada (extraídas por um LLM ou automaticamente).
|
|
37
|
+
- memory_search.out.hits.project: Projeto ao qual a entrada pertence; ""=sem rótulo; entradas aplicáveis globalmente mostram "global".
|
|
38
|
+
- memory_search.out.hits.updated_at: Timestamp da memória (última atualização, em milissegundos).
|
|
39
|
+
- memory_search.out.hits.truncated: Se o content foi cortado em content_max; true significa que o original é maior — leia o texto completo com memory_read.
|
|
40
|
+
- memory_search.out.hits.day: O horário da entrada: a palavra-chave YYYY-MM-DD quando existe, senão o horário de escrita com minutos (`YYYY-MM-DD HH:MM`; só a data quando é exatamente meia-noite). As ocorrências vão até o minuto; os vizinhos (context) só até o dia.
|
|
41
|
+
- memory_search.out.hits.context: memórias adjacentes {before, after} (no máximo 200 caracteres cada, só linhas active); aparece apenas quando context foi pedido.
|
|
42
|
+
- memory_search.out.hits.explain: Pontuação bruta BM25 de palavras-chave (importance/recencyWeight/status voltam juntos no mesmo objeto).
|
|
43
|
+
|
|
44
|
+
### memory_find_similar
|
|
45
|
+
|
|
46
|
+
- memory_find_similar.description: Encontra entradas semelhantes a um dado id de memória (cosseno sobre vetores de frequência de termos, calculado sobre título + conteúdo + palavras-chave tanto na base quanto nos candidatos — a mesma régua para os dois lados) — para detectar duplicatas, encontrar conflitos e verificar se já existe algo próximo desta entrada. Os candidatos incluem entradas escritas nesta mesma sessão (perguntar "a que isto se parece" logo depois de escrever é o caso comum); o que já foi mostrado nesta rodada (injetado ou pesquisado) continua excluído, para não repetir o mesmo texto.
|
|
47
|
+
- memory_find_similar.param.id: O id de memória de referência (o id completo dos resultados de memory_read/search, ou seus 12 primeiros caracteres).
|
|
48
|
+
- memory_find_similar.param.k: Número de resultados.
|
|
49
|
+
- memory_find_similar.param.content_max: Trunca o content de cada entrada neste comprimento, 0=texto completo.
|
|
50
|
+
- memory_find_similar.out.hits.similarity: Similaridade de cosseno 0-1; quanto maior, mais próxima.
|
|
51
|
+
- memory_find_similar.out.hits.repeat: Repetição literal 0-1 (Jaccard de conjuntos de tokens, só o corpo — a mesma entrada e a mesma régua que o memory_remember usa ao fundir; ≥0.8 significa que a escrita considera duplicado). Leia separado do cosseno: cosseno alto + repetição baixa = mesmo assunto, ou uma frase embutida num texto longo — não a mesma frase; repetição alta = a mesma frase.
|
|
52
|
+
|
|
53
|
+
### memory_read
|
|
54
|
+
|
|
55
|
+
- memory_read.description: Lê uma memória por completo (incluindo os metadados title/keywords/importance/status).
|
|
56
|
+
- memory_read.param.id: id da memória (do bloco de injeção ou de um resultado de memory_search).
|
|
57
|
+
|
|
58
|
+
### memory_update
|
|
59
|
+
|
|
60
|
+
- memory_update.description: Atualiza uma memória (content / importance / status / project / frase de objetivo do topic / keywords, ...). Valores de status: active / stale (finalizado: um todo concluído, um topic que atingiu seu objetivo -> stale significa done) / archived (excluído: entradas desatualizadas, inválidas, duplicadas ou substituídas).
|
|
61
|
+
- memory_update.param.id: id da memória.
|
|
62
|
+
- memory_update.param.content: Novo content (ao reescrever um topic: causa, percurso, desenvolvimento, resultado, <=180 palavras).
|
|
63
|
+
- memory_update.param.status: Novo status.
|
|
64
|
+
- memory_update.param.importance: Nova importância (qualquer número, sem limite superior; orientação suave 1-4: 4=linha vermelha fatal / saúde e segurança, 3=enfatizado pelo usuário / aplicável globalmente, 2=uma decisão do usuário ou uma conclusão abstrata, 1=trivialidade).
|
|
65
|
+
- memory_update.param.goal: Nova frase de objetivo (topic).
|
|
66
|
+
- memory_update.param.project: Novo nome de projeto (project/fact/lesson/rules/topic); use "global" para informações aplicáveis globalmente; separe vários projetos por vírgula; uma string vazia limpa o campo (sem rótulo).
|
|
67
|
+
- memory_update.param.keywords: Palavras-chave que você escolhe (corrija-as ou amplie-as sempre que notar que estão erradas; omitir o parâmetro ou passar um array vazio deixa as palavras-chave intactas).
|
|
68
|
+
|
|
69
|
+
### memory_project
|
|
70
|
+
|
|
71
|
+
- memory_project.description: Recupera do armazenamento de memória o bloco de injeção completo de um projeto (texto puro, agrupado por subcategoria, todas as entradas que não estão desatualizadas de uma vez). project é obrigatório: qual projeto você quer ver? Chamar sem ele gera um erro, então defina o nome do projeto primeiro. Chame-a quando o usuário mencionar um projeto (femwa/meow-memory/meow-eyes/dsh, ...) e perguntar sobre seu histórico de design, decisões técnicas, suas próprias palavras passadas ou onde ele está; também sempre que você precisar do panorama do projeto antes de responder. Regras: dentro de um grupo, as entradas vão de antigas -> novas pelo timestamp da memória; a subcategoria todo imprime "Concluído:" (as 5 concluídas mais recentemente) seguido de "Lista de tarefas:"; cada entrada traz seu id completo, seu timestamp de última atualização e seu texto.
|
|
72
|
+
- memory_project.param.project: Nome do projeto (o guia de memória no início da sessão lista todos os projetos que o usuário tem — escolha a partir dele).
|
|
73
|
+
- memory_project.out.text: O bloco de memória do projeto, agrupado por subcategoria (texto puro).
|
|
74
|
+
|
|
75
|
+
### memory_dream
|
|
76
|
+
|
|
77
|
+
- memory_dream.description: Agenda agora mesmo uma consolidação de memória (dream) para esta janela: tudo que esta janela criou ou trouxe à tona é enviado ao agente principal rodada a rodada para ser arrumado e guardado (rodada 1 = memórias atômicas, project/fact/lesson/rules/soul/user; rodada 2 = memórias de topic; rodada 3 = resumo de projeto, acrescentado apenas quando esta janela realmente mexeu com um projeto). Ela dispara automaticamente após 3+ horas de ociosidade da janela (suprimida nos horários de pico, 09:00-12:00 e 14:00-18:00 no horário de Pequim, mais os 15 minutos antes de cada um); esta ferramenta é o gatilho manual.
|
|
78
|
+
|
|
79
|
+
### memory_home
|
|
80
|
+
|
|
81
|
+
- memory_home.description: Visualiza ou troca o diretório global de dados do meow-memory (onde ficam dados em nível de instância, como logs e o ledger da janela de dream; o armazenamento de memória em si fica dentro de cada projeto e não é afetado). Chame sem parâmetros para obter o diretório atual e os locais reais dos três presets; a troca move automaticamente o conteúdo do diretório antigo (mover no mesmo disco / copiar entre discos). Após uma cópia entre discos, o diretório antigo é mantido, não excluído — lembre o usuário de apagá-lo manualmente depois de verificar; se várias instâncias do dsh compartilharem um mesmo diretório, lembre o usuário de atualizá-las em conjunto. Chame isto quando o usuário quiser mover os dados de memória ou os logs para fora do disco do sistema ou para outro local. A troca persiste entre reinícios por meio de um arquivo de ponteiro em $DSH_HOME/storages/meow-memory-home.json.
|
|
82
|
+
- memory_home.param.target: Local de destino. Ou um marcador de preset: default = home do usuário do sistema (o padrão), dsh-storage = pasta meow-memory dentro das storages da home do DSH, plugin-root = pasta de storage ao lado do próprio plugin; ou um caminho absoluto. Omita para visualizar o estado atual sem alterar nada.
|
|
83
|
+
- memory_home.out.note: Resultado da visualização/troca: o diretório atual ou o novo, quantos arquivos foram movidos e o que fazer com o diretório antigo.
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
[configuração inicial do meow-memory]
|
|
2
|
+
Parabéns! Se você está vendo esta mensagem, o plugin meow-memory está configurado e funcionando. 🎉
|
|
3
|
+
|
|
4
|
+
Falta um passo: o plugin precisa saber em qual idioma o usuário costuma falar com você. As entradas de memória precisam estar no mesmo idioma do tokenizador BM25, senão a recuperação por palavras-chave acerta muito menos — então acertar isso importa.
|
|
5
|
+
|
|
6
|
+
Por favor, conclua a configuração:
|
|
7
|
+
1. Descubra o idioma — ⚠️ olhe apenas para o texto das mensagens que vieram genuinamente do usuário; não se guie pelo idioma do system prompt, das descrições de ferramentas, dos blocos de injeção ou de qualquer conteúdo de arquivo, que muito provavelmente estão em outro idioma e vão te enganar. Se não tiver certeza, simplesmente pergunte ao usuário; não chute.
|
|
8
|
+
2. Edite a configuração de montagem do host: em {homePath}, abra o arquivo .dsh/profiles/cordis.patch.yml (no Windows: .dsh\profiles\cordis.patch.yml), encontre a entrada do meow-memory e adicione promptLang: '<language code>' na config dela (ex.: 'zh' / 'en'; crie a seção config se a entrada não tiver uma).
|
|
9
|
+
3. Faça hot-reload do plugin para que a configuração tenha efeito: se você tiver a ferramenta dev_reload_package, rode-a em meow-memory; se não, peça ao usuário para recarregar o plugin nas configurações do dsh ou reiniciar o dsh.
|
|
10
|
+
4. Quando terminar, diga brevemente ao usuário qual idioma você definiu para a memória e onde mudá-lo depois.
|
|
11
|
+
|
|
12
|
+
Até lá, o plugin roda em chinês (zh); nada mais é afetado.
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
【本组记忆】:{list}
|
|
2
|
+
|
|
3
|
+
下面的【本组记忆】就是本窗口的全部整理范围:你自己建立的、以及本窗口注入/检索/查阅(memory_read)时看过的条目。范围到此为止——不要试图回忆清单之外"看过但没列出"的条目。
|
|
4
|
+
有没有你认为该整理、更新的?如有,请更新它。
|
|
5
|
+
|
|
6
|
+
## 如何判断该更新——逐条核查上面的清单,你现在觉得:
|
|
7
|
+
1. 有没有当时记录错误或片面、过时、信息需要更新、用户改变决定、已有新进展的条目? → 请及时更新内容,记忆库的信息应该吻合project进展的最新状态。
|
|
8
|
+
2. 有没有被推翻的、被改掉的、被证明无效的设计和信息? → 应设 status=archived 归档,绝不要让它们保持active或stale。stale只表示「完结」(todo做完、话题达成目标),不是「作废」;已被替代的旧方案旧结论继续留在库里,只会误导之后的会话。
|
|
9
|
+
3. 有没有已完成的 todo 条目? → 设 status = stale(视为done);
|
|
10
|
+
4. 有没有错误的、过于琐碎、你现在看它根本不重要的条目? → 设 status=archived;
|
|
11
|
+
5. 有没有曾经的bug已被修复,曾经的lesson已不再适用? → 修改内容,或者设 status=archived;
|
|
12
|
+
6. 有没有发现互相矛盾的条目? → 按你所知道的事实修改。保留最新事实,旧版本设 status=archived;
|
|
13
|
+
7. 现在回头去看,那些记忆的 importance 标记是否正确(按记忆系统 importance 准则核查)?注意:不要轻易将信息标记为高重要性——工作进展类的重要性一般是1,最多只到2,很严重的事情才能用3;发现虚标的应调低;
|
|
14
|
+
8. 有没有哪条记忆太长,信息太多?→ 拆分成多条,可用update修改,或remember新建新条目。
|
|
15
|
+
9. 记忆的关键词是否准确?→ 如果准确就不使用keywords参数,如果你觉得关键词不准,请使用memory_update的keywords参数更新它——当用户prompt命中某条记忆的关键词,它就会被提取。所以你需要反向思考,"你希望在用户prompt提及哪些词的时候,这条记忆被检索到?"以此作为关键词的写入标准。不要用项目名当关键词,用更加针对这条记忆本身的信息作为关键词。优先提取核心实体、语义中心、专有名词。8-13个。
|
|
16
|
+
10. project标签是否准确?是否有些信息应该是全局信息但被错误的标记了project?那应该删去project标记。是否有些信息明明属于某个project,却没写project信息?那应该加上。
|
|
17
|
+
11. 学而不思则罔,更多抽象泛化:
|
|
18
|
+
- 这是总结抽象框架的极好时机,你看看有没有可以总结沉淀的通用规则?可添加新记忆。
|
|
19
|
+
- 你现在对某些记忆条目可能有更好更深刻地理解,你可以更新他们。
|
|
20
|
+
12. 看一下首轮注入的内容,你现在觉得那些内容都重要吗?有必要每个session首轮注入吗?如果有不重要的,你可以降低他们的importance或者将他们移动到其他level(比如fact)。
|
|
21
|
+
首轮只注入:soul(AI 自身)/ user(用户偏好)/ 全局 rules(importance≥2)。想加入首轮:全局规则类 → 移入 rules 且 importance≥2(project 填"全局");用户相关 → 移入 user;AI 自身 → 移入 soul。
|
|
22
|
+
13. memory_project 展示的是 project 层条目(todo 已完成只列最近 5 条)+ 项目特定 rules;上面的检查同样适用(todo 完成标 stale、过时标 archived、project 标签准确)。
|
|
23
|
+
14. 【归档豁免】decisions 子类的 project 条目、rules 层条目、以及事实/教训类的长期结论:**没有后继证据(未被新条目取代、推翻或合并)就不归档**,哪怕内容看起来旧——归档的判据是「有没有后继事实」,不是「内容旧不旧」。仅当出现以下任一情形才照常归档:已被同主题更新的一条取代;正文带有明确时效(如「当前」「截至X」「这次先这样」);被用户明确推翻。
|
|
24
|
+
|
|
25
|
+
说明:
|
|
26
|
+
重要:务必逐条检查,把过时记忆、误导你的记忆归档,或者修改——两者优先选择归档。
|
|
27
|
+
对于你认为非常重要的记忆,如果不确定事实到底如何,你可以直接翻项目文件来核实。仅对非常重要的记忆使用。
|
|
28
|
+
15. 【逐字重复对】里若列了对子:那是本组正文逐字重复度 ≥80% 的两条(与 memory_remember 判重复同一把尺子)——同一句话分别存进了两层。保留信息更全、层级更合适的那条,另一条用 memory_update 设 status=archived;只是相似度高、没被列进重复对的不要当重复处理(相似是同一话题,重复才是同一句)。标着「(另一组)」的,说明配对的另一条不在本组清单里(它在另一轮整理里,fact/topic 是分两次看的),照样按上面处置——同一对只处置一次,别因为看不见对方就当没这回事。
|
|
29
|
+
16. 【重复详写对】里若列了对子:那是「一条短摘录 + 一条长详写」在说同一件事——逐字重复度很低(一条是摘要、一条是全文),判据是覆盖度(短的那条几乎整句都落在长的那条里)。处置:合成一条,把短摘录里有、长文里没有的细节补进长文,保留信息更全的那条,另一条用 memory_update 设 status=archived。别因为 memory_search 的 repeat 低就把它们当两件事分别留着——同一个知识点存两层,首轮注入要多付一份钱。
|
|
30
|
+
每对下面还有一行处方,写着短条里长条没有的词:那些词就是合并时最容易漏掉的部分,逐字补进长条再归档短条;处方写着「没有长条之外的词」的,说明这次合并是无损的,保留长条、归档短条就行,正文不用改写。
|
|
31
|
+
17. 【三把尺子各管一段】逐字重复 ≥80%(Jaccard,量「同一句话存了两个副本」)、覆盖度 ≥90%(量「摘要 + 全文」)、体检里的「相似 N」与 memory_search 的 mode="similar"(稀有词签名,量「同一话题的不同说法」)。前两把是「重复」——该合并成一条、归档另一条;第三把是「相似」——同一话题的两句不同的话,不许合并,最多互相补一句指针("见 xxx")。看到「相似 N」很高却没被列进上面两块,就是在告诉你:这是两件事,别硬合。
|
|
32
|
+
18. 【疑似冲突】里若列了对子:那是**同一主题(关键词至少 2 个相同)、数字或版本却彼此不同**的两条——第三种病,既不是重复也不是相似。**别合并成一条,也别因为「看起来旧」就归档**:重复是同一句存了两份,冲突是同一件事有两个人说法,合并会把其中一份事实抹掉。逐对做三件事:①先认时间:行尾点了「谁更新」的,默认更新的那条是对的,把旧的那条改成「(已被取代:…)」或设 status=stale,别直接删;②再认差异:`独有` 那几个数字常常根本是两件事(一条讲版本号、一条讲端口号、一条讲条数),那样各留各的,只在正文里把数字的归属写清,别把两条硬凑成一条;③拿不准就翻项目文件核实——两个数字都不可信时别硬改,先核实再动。改完留痕迹:在被改的那条正文里写一句为什么这么定(例:「0.2.113 起路径改为 D 盘」),下一轮整理才不用重新猜。归档的那条不进这一块(归档本身就是处置),所以被列出来就说明它还在库里生效。
|
|
33
|
+
|
|
34
|
+
完成后直接回复,回复的第一行必须原样包含组标记 {groupMarker}(逐字复制,不要改动任何字符或增删内容),从第二行起才是"本组整理完成"与本组总结。不要调用其他工具。
|
|
35
|
+
|
|
36
|
+
一轮可调用多个工具,请你尽量在一次输出中完成本任务所有的工具调用。
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
本窗口记忆封存时间戳:{timestamp}
|
|
2
|
+
如果其他窗口在此时间戳之后有新进展,你是不知道的。所以如果遇到记忆和你所知的上下文冲突,你需要根据时间戳来判断,是那条记忆错了,还是你信息落后了,来考虑要不要修改它。
|
|
3
|
+
|
|
4
|
+
时间戳规则:
|
|
5
|
+
所有展示给你的时间戳,都是那条记忆的**最后更新**时间戳。
|
|
6
|
+
因为你现在看到的是很长时间的完整上下文,所以"几小时前"这种相对时间戳其实一直在变,不值得参考。此时你需要看的是绝对时间戳来判断记忆信息的新旧。
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
第 {idx}/{total} 组 - {roundKind}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
对于你一直在进行的项目,请再次使用 memory\_project 工具,再看一眼记忆对项目的描述,然后请你精简它们。
|
|
2
|
+
本组涉及的项目:{projects}
|
|
3
|
+
|
|
4
|
+
# 项目总结指导——
|
|
5
|
+
|
|
6
|
+
1. memory\_project 返回的内容太多太长了。总长度应在5000字以下。
|
|
7
|
+
2. 你需要做的是:归档过时或不重要的旧条目,或者把很多旧条目总结抽象为一两条精简的新条目。(用 memory\_remember 新建,level=project)
|
|
8
|
+
3. 具体总结多少条由你决定,只总结你认为真正重要的东西。
|
|
9
|
+
4. 要明白:你总结的记忆会成为这个项目的长期记忆,以后其他窗口做这个项目时,他们会首先看到这一段。所以你的总结应对他们有指导意义——能帮助他们快速明白用户的要求。
|
|
10
|
+
5. 只保留这些记忆:这个项目是要干什么、概况是什么、重要的架构和设计理念是什么。项目目录架构是什么,每一块大概管什么事儿,相关目录的path索引。近期完成的,稍后todo的。
|
|
11
|
+
6. 只有手头正在做、还未完成的事可以保留少量细节。
|
|
12
|
+
7. 近期已经干完的事儿就不需要细节了,最多一句话带过。
|
|
13
|
+
8. 远期已经干完的事儿应归档,不要让他们浪费token。
|
|
14
|
+
9. 你依然应该总结成一条一条的记忆,每一条里面只讲一个要点;为每条选合适的 subcategory(overview=概况 / structure=架构 / decisions=设计决策 / ops=部署数据 / todo=待办),关键词 8-13 个,importance 不要虚标。
|
|
15
|
+
10. 总结完成后,你需要将 memory\_project 返回的、已被你的新总结取代的旧记忆归档(memory\_update 设 status=archived),不要让新旧两套描述并存。没有被你的总结覆盖、仍有独立价值的条目(例如还没做完的 todo、独特的教训、decisions 子类的长期决策)保留不动,不要为了归档而归档——decisions 条目只有在其结论确实被你的新总结吸收后才归档,没被吸收的长期决策哪怕看起来旧也保留。
|
|
16
|
+
11. 完成后直接回复,回复的第一行必须原样包含组标记 {groupMarker}(逐字复制,不要改动任何字符或增删内容),从第二行起才是"本组整理完成"与本组总结。不要调用其他工具。
|
|
17
|
+
|
|
18
|
+
一轮可调用多个工具,请你尽量在一次输出中完成本任务所有的工具调用。
|
|
19
|
+
|