зеркало из
https://github.com/docxology/cognitive.git
synced 2025-10-30 20:56:04 +02:00
177 строки
3.6 KiB
Markdown
177 строки
3.6 KiB
Markdown
# Obsidian Usage Guide
|
|
|
|
## Overview
|
|
Obsidian serves as our knowledge management system, providing powerful linking and visualization capabilities for cognitive modeling networks.
|
|
|
|
## Vault Structure
|
|
|
|
### Core Directories
|
|
```
|
|
📁 knowledge_base/ # Main knowledge repository
|
|
├── agents/ # Agent definitions
|
|
├── beliefs/ # Belief networks
|
|
├── goals/ # Goal hierarchies
|
|
├── actions/ # Action repertoires
|
|
├── observations/ # Observation patterns
|
|
└── relationships/ # Node relationships
|
|
|
|
📁 templates/ # Template definitions
|
|
└── node_templates/ # Node type templates
|
|
|
|
📁 docs/ # Documentation
|
|
```
|
|
|
|
## Node Types and Templates
|
|
|
|
### Core Node Types
|
|
- [[agent_template]] - Agent definitions
|
|
- [[belief_template]] - Belief structures
|
|
- [[goal_template]] - Goal definitions
|
|
- [[action_template]] - Action patterns
|
|
- [[observation_template]] - Observation models
|
|
- [[relationship_template]] - Node relationships
|
|
|
|
See [[node_types]] for detailed specifications.
|
|
|
|
## Linking Patterns
|
|
|
|
### Internal Links
|
|
- Use `[[filename]]` for direct links
|
|
- Use `[[filename|alias]]` for custom link text
|
|
- Reference [[linking_patterns]] for conventions
|
|
|
|
### Backlinks
|
|
- Automatically tracked by Obsidian
|
|
- View in right sidebar
|
|
- Essential for [[network_analysis]]
|
|
|
|
## Knowledge Organization
|
|
|
|
### Tags
|
|
Common tags:
|
|
- #agent
|
|
- #belief
|
|
- #goal
|
|
- #action
|
|
- #observation
|
|
- #relationship
|
|
|
|
See [[tagging_guide]] for conventions.
|
|
|
|
### YAML Frontmatter
|
|
```yaml
|
|
---
|
|
type: agent
|
|
id: "agent_001"
|
|
created: 2024-02-05
|
|
modified: 2024-02-05
|
|
tags: [agent, cognitive-model]
|
|
aliases: []
|
|
---
|
|
```
|
|
|
|
## Visualization
|
|
|
|
### Graph View
|
|
- Access via Graph View button
|
|
- Shows knowledge network structure
|
|
- Color-coded by [[node_types]]
|
|
- Configurable layouts
|
|
|
|
### Filters
|
|
- Filter by node type
|
|
- Filter by tags
|
|
- Filter by relationships
|
|
- See [[visualization_guide]]
|
|
|
|
## Integration Features
|
|
|
|
### With Cursor
|
|
- Markdown preview
|
|
- Code block syntax highlighting
|
|
- Integration with [[cursor_integration]]
|
|
|
|
### With Git
|
|
- Version control integration
|
|
- Collaboration features
|
|
- See [[git_workflow]]
|
|
|
|
## Workflows
|
|
|
|
### Creating New Nodes
|
|
1. Use template hotkeys
|
|
2. Fill in frontmatter
|
|
3. Add content
|
|
4. Establish links
|
|
See [[workflow_guides]] for details.
|
|
|
|
### Maintaining Networks
|
|
- Regular updates
|
|
- Link verification
|
|
- Network analysis
|
|
- See [[maintenance_guide]]
|
|
|
|
## Plugins and Extensions
|
|
|
|
### Core Plugins
|
|
- Graph View
|
|
- Backlinks
|
|
- Tags
|
|
- Templates
|
|
|
|
### Community Plugins
|
|
- Dataview (for queries)
|
|
- Calendar (for temporal tracking)
|
|
- Mind Map (for hierarchies)
|
|
|
|
## Best Practices
|
|
|
|
### Organization
|
|
- Use consistent naming
|
|
- Maintain clean hierarchy
|
|
- Follow [[template_guide]]
|
|
- Regular [[maintenance_guide]]
|
|
|
|
### Linking
|
|
- Be specific with links
|
|
- Use bidirectional linking
|
|
- Maintain link context
|
|
- Follow [[linking_patterns]]
|
|
|
|
### Documentation
|
|
- Keep notes updated
|
|
- Use templates consistently
|
|
- Follow [[documentation_guide]]
|
|
|
|
## Tips and Tricks
|
|
|
|
### Keyboard Shortcuts
|
|
- `Ctrl/Cmd + O` - Quick switcher
|
|
- `Ctrl/Cmd + E` - Toggle edit/preview
|
|
- `[[` - Create link
|
|
- See [[shortcuts_guide]]
|
|
|
|
### Search
|
|
- Use tags for categorization
|
|
- Use frontmatter for metadata
|
|
- Full-text search available
|
|
- See [[search_guide]]
|
|
|
|
## Troubleshooting
|
|
|
|
### Common Issues
|
|
- Broken links
|
|
- Template issues
|
|
- Plugin conflicts
|
|
See [[troubleshooting]] for solutions.
|
|
|
|
## Related Guides
|
|
- [[getting_started]]
|
|
- [[template_guide]]
|
|
- [[network_analysis]]
|
|
- [[maintenance_guide]]
|
|
|
|
## References
|
|
- [Obsidian Documentation](https://help.obsidian.md)
|
|
- [[code_organization]]
|
|
- [[contribution_guide]] |