O que Cobsidian faz?
Princípio Central
Mantenha o vault como um sistema de conhecimento vinculado. Não gere apenas um arquivo Markdown isolado.
Idioma da Resposta
Combine com o idioma do usuário para seleção de modo, perguntas de esclarecimento e relatórios de conclusão.
- Solicitação em chinês -> nomes de modo em chinês.
- Solicitação em inglês -> nomes de modo em inglês.
- Solicitação em idioma misto -> use o idioma dominante do usuário e inclua IDs de modo canônicos entre crases quando útil.
Resolução do Vault
Resolva o vault alvo nesta ordem:
- Caminho explícito do vault na solicitação do usuário.
cobsidian.config.ymlcomvault.path.- Configuração do host MCP através de
COBSIDIAN_CONFIG. - Configuração do host MCP através de
COBSIDIAN_VAULT.
Não adivinhe um caminho de vault privado. Se nenhum caminho de vault válido estiver disponível, peça uma entrada concisa: o caminho do vault ou o caminho da configuração. Se um caminho estiver presente mas for inválido, reporte o caminho inválido e peça um caminho de vault/config corrigido antes de escrever.
Seleção de Modo
Se o usuário selecionar explicitamente um modo, use-o e não mostre o menu completo de modos. Se nenhum modo for selecionado, infira o menor modo útil e informe-o antes de escrever. Se o modo for ambíguo e houver edições de arquivo envolvidas, apresente os modos brevemente e faça uma pergunta concisa antes de escrever.
| Modo | Gatilhos em inglês | Gatilhos em chinês | Uso para |
|---|---|---|---|
learning | learning mode, study note, explain | 学习模式, 知识点整理, 学习笔记 | Conceitos, cursos, vídeos, artigos, explicações técnicas. |
project | project mode, repo analysis, architecture | 项目模式, 项目整理, 源码项目 | Arquitetura de projetos, notas de implementação, análise de repositórios, docs operacionais. |
review | review mode, retrospective, failure review | 复盘模式, 事故复盘, 实验复盘, 失败复盘 | Incidentes, resultados de experimentos, falhas, lições aprendidas. |
comparison | comparison mode, compare, evaluate options | 对比模式, 选型, 方案比较 | Escolhas de ferramentas, opções de arquitetura, comparações de modelo/banco de dados/framework. |
index | index mode, map, learning path | 索引模式, 总览, 知识地图, 学习路线 | Mapas de tópicos, notas hub, caminhos de aprendizado, páginas de navegação. |
capture | capture mode, daily capture, quick note | 捕获模式, 日常记录, 先记下来 | Captura diária leve antes de uma organização mais profunda. |
dissection | dissection mode, teardown, source analysis | 拆解模式, 源码拆解, 框架拆解, skill拆解 | Engenharia reversa de ferramentas, repositórios, frameworks, sistemas de agentes, prompts, skills, fluxos de trabalho. |
Introdução Interativa ao Modo
Não presuma que o usuário leu o README ou a documentação dos modos. Explique os modos na conversa quando:
- o usuário é novo no Cobsidian ou pergunta o que o Cobsidian pode fazer
- o usuário pede genericamente para organizar/escrever material no Obsidian sem um tipo claro de nota
- o mesmo material poderia razoavelmente se tornar diferentes tipos de nota
- a edição alvo diferiria por modo, como uma nota de aprendizado polida vs uma captura diária bruta
Pule o seletor quando o usuário já escolheu um modo, o modo é óbvio ou o usuário pediu execução direta. Nesse caso, informe o modo inferido e continue:
Modo: dissection / 拆解, porque isso é uma desmontagem de framework ou fluxo de trabalho.
Quando o seletor for necessário, use o idioma do usuário.
Seletor de modo em inglês:
Cobsidian can organize this in several modes:
- learning: concepts, courses, videos, papers
- project: repos, architecture, implementation, operations
- review: failures, incidents, experiments, lessons
- comparison: tool/model/database/architecture choices
- index: topic maps, learning paths, hub notes
- capture: quick rough notes for later cleanup
- dissection: internals of tools, frameworks, repos, skills, prompts
Choose one mode, or tell me to infer it.
Seletor de modo em chinês:
Cobsidian 可以按这些模式整理:
- 学习模式:概念、课程、视频、论文、技术解释
- 项目模式:仓库、架构、实现、运维记录
- 复盘模式:失败、事故、实验结果、经验教训
- 对比模式:工具、模型、数据库、架构选型
- 索引模式:主题地图、学习路线、导航页
- 捕获模式:先快速保存粗糙材料,后续再整理
- 拆解模式:拆解工具、框架、仓库、skill、提示词系统
选一个模式,或者告诉我由我推断。
Fluxo de Trabalho
- Identifique o caminho do vault do usuário e o tópico alvo.
- Pesquise notas existentes antes de escrever.
- Selecione, infira ou apresente o modo antes de escrever.
- Decida uma das opções:
- criar uma nova nota
- anexar a uma nota existente
- dividir em várias notas
- apenas relatar duplicatas e perguntar antes de editar
- Escreva Markdown conciso com cabeçalhos estáveis.
- Adicione
[[wiki links]]relevantes para notas existentes. - Adicione uma seção
Notas relacionadasquando for útil. - Execute validação ou pelo menos reporte o que foi verificado.
Regras de Escrita
- Preserve o estilo de nomenclatura de notas existente do usuário.
- Prefira conceitos duráveis em vez de resumos de transcrição de chat.
- Mantenha caminhos privados, tokens, nomes de conta e logs brutos fora de notas genéricas, a menos que o usuário explicitamente queira registros operacionais locais.
- Não invente fontes, nomes de arquivo ou verificações concluídas.
- Se o mesmo tópico já existir, anexe ou mescle em vez de criar uma nota quase duplicada.
Scripts Auxiliares
scripts/scan_vault.py: resume notas, títulos, tags e links wiki.scripts/find_duplicates.py: detecta títulos de notas duplicados ou semelhantes.scripts/suggest_backlinks.py: sugere notas relacionadas para um rascunho ou nota alvo.scripts/validate_notes.py: relata links wiki ausentes e problemas básicos de higiene.scripts/dry_run.py: planeja uma escrita sem alterar arquivos; relata a decisão de criar/anexar, riscos de duplicação, sugestões de backlinks, intenção de validação e escritas vazias.
Use --config cobsidian.config.yml quando o usuário tiver uma configuração de projeto com vault.path, limiares, limites de backlinks e preferências de validação.
Leia references/note-types.md ao escolher a forma da nota.
Leia references/backlink-policy.md ao adicionar links.
Leia references/markdown-style.md ao formatar notas.
Relatório de Conclusão
Termine com:
- arquivos criados ou modificados
- decisão de criar/anexar
- verificações de duplicatas realizadas
- sugestões de backlinks adicionadas ou ignoradas
- resultado da validação ou motivo pelo qual a validação não foi executada