By following this guide, you can establish a private, efficient AI workflow using Ollama while maintaining full control over your data and processes.
# Changelog
Source: https://docs.blinko.space/en/changelog
Complete version history of Blinko
# Blinko Changelog
```
## How to Enable
1. Open Settings → Desktop & Hotkeys
2. Toggle "Autostart" switch on
3. Grant authorization if prompted
## How it Works
* Starts in background, no popup
* Shows icon in system tray
* Hotkeys automatically active
## System Support
* ✅ Windows
* ✅ macOS
* ✅ Linux
## How to Disable
Turn off the switch in Blinko settings, or disable in system startup items management.
# Quick AI
Source: https://docs.blinko.space/en/desktop/quick-ai
Quickly launch AI assistant from anywhere
## Default Hotkey
**`Alt + Space`** - Quickly open AI chat window
## How to Setup
1. Open Settings → Desktop & Hotkeys
2. Enable "Enable Quick AI"
3. Customize hotkey:
* Click the AI hotkey input field
* Click "Record" button
* Press your desired key combination
* Click "Stop" to save
## How to Use
1. Press `Alt + Space` in any application
2. Type your question or request
3. AI will answer based on your note content
## AI Features
* **Smart Conversations**: Personalized answers based on your note library
* **Context Understanding**: Understands your question background
* **Multiple Uses**:
* Explain concepts and ideas
* Summarize note content
* Answer questions
* Provide suggestions
## Use Cases
* **Learning Assistant**: Ask about learned topics
* **Work Helper**: Get suggestions based on work notes
* **Creative Inspiration**: Expand ideas from existing thoughts
* **Quick Search**: Find related note content
## FAQ
**AI not responding?**
1. Check if AI configuration is correct
2. Verify network connection
3. Restart Blinko application
**Inaccurate answers?**
AI answers based on your note content - richer notes lead to better answers
**Reset hotkey**
Click the refresh button next to AI hotkey setting
# Quick Note
Source: https://docs.blinko.space/en/desktop/quick-note
Quickly open Blinko from anywhere to capture ideas
## Default Hotkey
**`Shift + Space`** - Quickly open new note window
## How to Setup
1. Open Settings → Desktop & Hotkeys
2. Enable "Enable Global Hotkey"
3. Customize hotkey:
* Click the hotkey input field
* Click "Record" button
* Press your desired key combination
* Click "Stop" to save
## How to Use
1. Press `Shift + Space` in any application
2. Type your thoughts or notes
3. Press `Ctrl + Enter` to save
## Supported Keys
* **Modifiers**: Ctrl/Cmd, Alt, Shift
* **Letters/Numbers**: A-Z, 0-9
* **Function Keys**: F1-F12
* **Special Keys**: Space, Tab, Esc
## FAQ
**Hotkey not working?**
1. Check if enabled
2. Restart Blinko
3. Check for software conflicts
4. Try different key combination
**Reset to default**
Click the refresh button next to hotkey setting
# Text Selection Toolbar
Source: https://docs.blinko.space/en/desktop/text-selection
Translate, ask AI, and bookmark any selected text
## How to Use
1. Select text in any application
2. Press \`Ctrl + \`\` (or your set hotkey)
3. Click the function button you need
## Main Features
* **Translation**: Multi-language translation
* **Copy**: Smart text copying
* **Q\&A**: Ask AI about selected text
* **Bookmark**: Save as Blinko notes
## Setup
1. Open Settings → Text Selection Toolbar
2. Enable the feature toggle
3. Choose trigger hotkey:
* \`Ctrl + \`\` (recommended)
* \`Shift + \`\`
* \`Alt + \`\`
## Translation Settings
Set language pairs:
* Auto-detect → English
* Chinese → English
* English → Chinese
## Supported Apps
Works with almost all desktop apps: browsers, Office, code editors, PDF readers, etc.
## FAQ
**Toolbar not showing?**
1. Check if feature is enabled
2. Restart Blinko
3. Check app permissions
# Blinko Hub
Source: https://docs.blinko.space/en/ecosystem/blinko-hub
A decentralized network for Blinko instances
# Blinko Hub: The Decentralized Knowledge Network
Blinko Hub is a revolutionary platform that transforms individual Blinko instances into an interconnected knowledge ecosystem. It serves as a decentralized discovery and collaboration network for Blinko users worldwide.
## Getting Started
### 1. Register Your Instance [github/blinko-hub](https://github.com/blinko-space/blinko-hub)
```yaml
# Example site configuration
title: "Your Site Name"
url: "https://your-blinko.example.com"
tags:
- english # language tag
- research # content focus
- tech # topic area
created_at: "2024-01-14"
```
### 2. Enable Hub Features
* Configure Hub settings in your Blinko instance
* Set visibility preferences
### 3. Join the Network
* Share public blinko
* Connect with other instances
* Start following interesting sites
* Share your knowledge globally
## Core Features
### 🌐 Decentralized Site Discovery
* **Global Directory**: Browse and discover Blinko instances from around the world
* **P2P Connection**: Direct peer-to-peer connections between Blinko instances
* **Site Verification**: Automated verification of Blinko instances for authenticity
{/* ### 🔄 Cross-Instance Interaction
* **Follow System**: Subscribe to updates from other Blinko instances
* **Activity Feed**: Real-time updates from followed instances
* **Webmention Support**: Send and receive cross-site interactions and mentions */}
### 🤝 Community Engagement
* **Site Showcase**: Highlight your Blinko instance to the global community
* **Tag-based Discovery**: Find instances based on interests, languages, and topics
* **Community Rankings**: Discover trending and popular Blinko instances
### 🔗 Link Exchange Network
* **Automated Backlinks**: Smart backlink management between instances
* **Link Verification**: Automatic validation of reciprocal links
* **Link Analytics**: Track and analyze cross-instance connections
## Technical Architecture
### 📡 P2P Infrastructure
* **Distributed Network**: No central server dependency
* **Data Replication**: Efficient peer-to-peer data synchronization
## Benefits
### For Individual Users
* Discover diverse knowledge sources
* Build connections with like-minded individuals
* Expand your knowledge network organically
### For Communities
* Create topic-focused networks
* Foster collaborative learning environments
* Build knowledge-sharing ecosystems
### For Organizations
* Establish private knowledge networks
* Facilitate cross-team collaboration
* Maintain secure information sharing
Join Blinko Hub today and become part of a growing, decentralized knowledge network that respects privacy while fostering global collaboration.
# Blinko Plugin
Source: https://docs.blinko.space/en/ecosystem/blinko-plugin
Blinko plugins extend the functionality of your note-taking experience. This guide will help you discover, install, and manage plugins.
### Plugin Marketplace
1. Open Blinko and go to Settings
2. Click on "Plugin Setting"
3. Browse the available plugins in the marketplace
4. Click on a plugin to view its details, including:
* Description
* Author
* Version
* Documentation
## Installing Plugins
1. Find the plugin you want to install
2. Click the "Install" button
3. Review the permissions requested by the plugin
4. Click "Confirm" to install
## Managing Plugins
### Plugin Settings
Most plugins provide customization options:
1. Go to Settings > Plugin Setting
2. Find the installed plugin
3. Click the settings icon (⚙️)
4. Adjust the available options
5. Save your changes
### Removing Plugins
If you need to disable or remove a plugin:
1. Go to Settings > Plugin Setting
2. Find the plugin you want to manage
3. Or click the "Uninstall" button to remove
## Development
Interested in creating your own plugin?
* Check out our [Plugin Development Guide](/en/plugins/get-started)
* Join our [Developer Community](/community/community)
* Browse the [API Reference](/en/plugins/api-reference)
# Wechat Bot
Source: https://docs.blinko.space/en/ecosystem/wechat-bot
Quickly save notes via WeChat Bot
# Wechat Bot
# AI Emoji Generator
The AI emoji feature allows you to generate relevant emojis based on text descriptions. This is useful for quickly finding the perfect emoji for your messages or content.
# AI Post Processing
Source: https://docs.blinko.space/en/how-to-use/ai/ai-post-processing
Automatically process newly created note content
# AI Post Processing
AI post-processing automatically analyzes note content using AI after creation or updates, generating summaries, tags, or performing other analysis operations.
## How to Enable
1. Open Settings → AI Settings
2. Find "AI Post Processing" section
3. Enable "Enable AI Post Processing" toggle
## Processing Modes
### Add as Comment
* AI analysis results are added as comments below the note
* Original note content remains unchanged
* View AI's analysis process and results
### Auto Add Tags
* AI automatically recommends and adds relevant tags based on content
* Helps better organize and categorize notes
* Improves search and discovery efficiency
### Both
* Generates both comments and adds tags simultaneously
* Most comprehensive AI processing approach
## Custom Prompts
### Post Processing Prompt
Set the prompt used by AI when analyzing notes:
```
Analyze the following note content and suggest appropriate tags and provide a brief summary
```
### Tags Prompt
Dedicated prompt for generating tags:
```
Recommend 3-5 relevant tags for the following content
```
## Workflow
1. **Create Note** - User creates a new note
2. **Trigger Processing** - System automatically detects new note
3. **AI Analysis** - Analyzes content using configured prompts
4. **Generate Results** - Adds comments or tags based on processing mode
5. **Notify User** - Sends notification when AI processing is complete
## Use Cases
### Content Analysis
* Automatically summarize long text content
* Extract key information and points
* Analyze sentiment and themes
### Smart Tagging
* Automatically categorize content
* Identify professional domains and topics
* Build consistent tagging systems
### Workflow Integration
* Automatically process meeting notes
* Intelligently organize study notes
* Classify and manage project documentation
## Important Notes
* Processing runs asynchronously in the background without affecting note creation speed
* AI analysis quality depends on selected model and prompt settings
* Can be disabled at any time without affecting already processed content
* Supports custom prompts to adapt to different use cases
## Configuration Tips
### Prompt Optimization
* Adjust prompts based on personal needs
* Clearly specify expected output format
* Include relevant contextual information
### Mode Selection
* New users recommended to start with "Add as Comment" mode
* Switch to "Both" for best results after familiarization
* Use only "Auto Add Tags" if tag management is well-organized
## Usage Methods
### Hotkey Search
* Press `Ctrl + K` to quickly open search
* Enter natural language queries
* Real-time display of relevant notes
### AI Chat Search
* Automatically enables knowledge base retrieval during AI conversations
* Answers questions based on note content
* No manual searching required
## Search Features
* Semantic search that understands query intent
* Supports text, PDF, and attachment content
* Supports image content (requires multimodal models)
* Relevance scoring and intelligent ranking
## Parameter Settings
Adjust search parameters in AI settings:
* **Embedding Top K**: Initial search result count
* **Embedding Score**: Similarity threshold
* **Reranking**: Uses large language models to optimize results
# Setting
Source: https://docs.blinko.space/en/how-to-use/ai/ai-setting
Guide to Setting AI
## Basic Settings
ai can help you summarize the current note, generate multiple tags, and select the tags you like to add.
# AI Writing
Source: https://docs.blinko.space/en/how-to-use/ai/ai-writing
Guide to AI Writing
Click [AI Writing button](/how-to-use/toolbar#bottom-toolbar) in the bottom toolbar to start using AI writing.
## Tell AI what you want to write
you can click **Accept** to use the AI writing result, or **Reject** to reject it.
## AI Expand
AI can assist you in expanding your writing by generating additional content, filling in gaps, or exploring ideas in greater depth. Whether you are drafting an article, creating a report, or writing fiction, AI can analyze your existing text and suggest relevant details, examples, or arguments that enrich your work. For example, if you have a short outline, AI can transform it into a fully developed piece by adding descriptions, explanations, and supporting information. This capability is particularly useful when you need to elaborate on complex topics or meet word count requirements without compromising the quality of your writing.
## AI Polishing
AI excels at polishing your writing to make it clearer, more concise, and professional. It can identify grammatical errors, awkward phrasing, and inconsistencies in tone or style. Beyond basic proofreading, AI tools can suggest rephrased sentences, enhance vocabulary, and align your writing with a specific audience or purpose. For instance, if you're drafting an email, AI can refine it to sound more formal or persuasive. Similarly, it can adjust academic papers for precision and consistency or make creative pieces more engaging. With AI, you can ensure that your writing is polished and ready for publication or presentation.
# Blinko vs Note
Source: https://docs.blinko.space/en/how-to-use/blinko-or-note
Understanding the differences between Blinko and Note
{/* 
*/}
## Overview
Blinko comes with an elegant global music player that transforms your note-taking environment into a more immersive experience. Whether you're brainstorming, writing, or reviewing notes, having the right music can boost your creativity and productivity.
## Features
2. Upload your MP3 files using the upload button in the bottom toolbar
3. Blinko will automatically:
* Process your audio files
* Fetch metadata and cover art
* Create a beautiful player interface
## Usage Tips
* Create themed playlists for different types of notes
* Use tags like `#music` to organize your audio content
* Add music files to specific notes for context-relevant soundtracks
## Feed Availability
Blinko And Notes will be automatically included in the RSS feed if they meet the following criteria:
* Set to public
* Has no password protection
## Feed Formats
Blinko supports two standard RSS feed formats:
### 1. Atom Feed
```
/api/rss/{userId}/atom?row=20
```
### 2. RSS Feed
```
/api/rss/{userId}/rss?row=20
```
## Parameters
* `row`: Number of items to return in the feed (default: 20)
* Example: `row=50` will return the 50 most recent notes
* You can adjust this value based on your needs
## Usage Examples
1. **Default Feed (20 items)**
```
http://your-domain/api/rss/1/atom
http://your-domain/api/rss/1/rss
```
2. **Custom Number of Items**
```
http://your-domain/api/rss/1/atom?row=50
http://your-domain/api/rss/1/rss?row=100
```
## Feed Reader Integration
1. Copy the desired feed URL
2. Add it to your RSS reader
3. Your reader will automatically fetch new public notes as they are created
## Note Privacy
Remember:
* Only public notes will appear in the RSS feed
* Private notes and password-protected notes are excluded
* Changing a note's privacy settings will affect its availability in the feed
# Share Your Note
Source: https://docs.blinko.space/en/how-to-use/share-your-note
Guide to Share Your Note
# Share Your Note
Blinko provides flexible options to share your notes with others. This guide will help you understand how to use the sharing features effectively.
## Creating a Share Link
1. Click the share button in your note
2. Configure sharing options:
* **Expiry Time**: Set when the share link will expire
* **Access Password**: Optional protection for your shared content
* **Clean URL**: Generate a clean, shareable URL
## Share Settings
### Expiry Time
* Choose when the share link expires
* Default: 7 days
* Link automatically deactivates after expiry
### Access Protection
* Toggle password protection
* Set a custom numeric password
* Recipients need the password to view content
* Enhance security for sensitive information
## Share Page Preview
Blinko generates a beautiful, responsive sharing page that:
* Maintains your note's formatting
* Supports all media content
* Adapts to different devices
* Includes your custom theme if set
## Managing Shared Notes
### View Active Shares
* See all your currently shared notes
* Check remaining time until expiry
* Monitor access statistics
### Modify Share Settings
* Update expiry time
* Change access password
* Revoke access anytime
## Best Practices
1. **Security**
* Use passwords for sensitive content
* Set appropriate expiry times
* Regularly review active shares
2. **Sharing**
* Test the link before sharing
* Include password in separate communication
* Consider recipient's timezone for expiry
## Creating Tag Hierarchies
With Blinko's multi-level tags, you can create hierarchies that reflect the relationships between your inspirations. For example, you can have top-level tags such as "Work," "Personal," or "Hobbies," and then further subdivide them into more specific tags like "Project A," "Project B," "Travel," or "Art." This hierarchical organization enables you to navigate through your inspirations with ease and quickly locate the information you need.
# Toolbar
Source: https://docs.blinko.space/en/how-to-use/toolbar
Blinko uses markdown to format your notes. Here are the icons and what they do.
Blinko is an **innovative** open-source project designed for individuals who want to quickly capture and organize their fleeting thoughts. Blinko allows users to seamlessly jot down ideas the moment they strike, ensuring that no spark of creativity is lost.
## Feature
1. Visit our [Blinko Plugin Template on CodeSandbox](https://codesandbox.io/p/github/blinko-space/blinko-plugin-template/main)
2. Click "Fork" to create your own copy
3. The development server will start automatically
4. You'll see the connection instructions at `http://localhost:3000` showing:
* External Access: `ws://
If the connection is successful, you'll see your plugin listed as "Local Plugin" with a green status indicator.
### Troubleshooting Connection Issues
If you can't connect to your plugin:
1. Make sure your development server is running (`bun dev`)
2. Check that the WebSocket URL is correct
3. If using a local network URL, ensure you're on the same network
4. For ngrok connections, make sure to use the `wss://` URL provided by ngrok
## Additional Resources
* Publish plugin to Blinko Plugin Marketplace [Publish plugin](/en/plugins/publish-plugin)
* Check out the [API Reference](/en/plugins/api-reference) to learn about available APIs
* Join our [community](/en/community/community) to get help and share your plugins
# Publishing Your Plugin
Source: https://docs.blinko.space/en/plugins/publish-plugin
When your plugin is ready for release, you can publish it to the Blinko Plugin Marketplace. This guide will walk you through the process of preparing and publishing your plugin.
## Prerequisites
Before publishing, ensure you have:
* A complete and tested plugin
* A public GitHub repository
* A valid GitHub account
* Github Cli installed [Github Cli](https://cli.github.com/)
## Publishing Process
### 1. Prepare Your Plugin
Before publishing, make sure your plugin meets all requirements:
1. Update your `plugin.json` with the latest version number
2. Ensure all required fields in `plugin.json` are filled:
```json
{
"name": "your-plugin-name",
"author": "your-name",
"url": "https://github.com/your-username/your-plugin",
"version": "1.0.0",
"minAppVersion": "0.0.0",
"displayName": {
"default": "Your Plugin Name",
"zh": "你的插件名称"
},
"description": {
"default": "Your plugin description",
"zh": "你的插件描述"
}
}
```
3. Test your plugin thoroughly
4. Commit and push all changes to GitHub
### 2. Run the Publish Command
The template provides a simple command to handle the release process:
```bash
bun release:publish
```
This command will:
1. Build your plugin for production
2. Create a release package (`release.zip`)
3. Create a GitHub release with the package
4. Submit your plugin to the [Blinko Plugin Marketplace](https://github.com/blinko-space/blinko-plugin-marketplace)
### 3. Behind the Scenes
The `release:publish` command uses [blinko-cli](https://github.com/blinko-space/blinko-cli) to handle the release process. Here's what happens:
1. The CLI validates your `plugin.json` and ensures all required fields are present
2. It packages your plugin's `release` directory into a ZIP file
3. Using GitHub's API, it creates a new release with your version number
4. The release package is uploaded to the GitHub release
5. An issue is created in the Blinko Plugin Marketplace repository to request publication
### 4. After Publishing
After running the publish command:
1. A new issue will be created in the [Blinko Plugin Marketplace](https://github.com/blinko-space/blinko-plugin-marketplace)
2. The Blinko team will review your plugin
3. Once approved, your plugin will be available in the marketplace
4. You can track the status of your submission through the GitHub issue
## Troubleshooting
### Common Issues
1. GitHub Authentication
* Ensure you have proper GitHub credentials configured
* Check your repository permissions
2. Version Number Issues
* Make sure your version follows semantic versioning (e.g., 1.0.0)
* Version number must be higher than previous releases
3. Release Package Problems
* Verify your release directory contains all necessary files
* Check that the ZIP file was created successfully
4. Repository Access
* Confirm your repository is public
* Verify the repository URL in `plugin.json` is correct
## Need Help?
If you encounter any issues or need assistance:
* Check our [community forums](/community/community)
* Open an issue in the [blinko-cli repository](https://github.com/blinko-space/blinko-cli)
* Review existing issues in the [marketplace repository](https://github.com/blinko-space/blinko-plugin-marketplace)
# Plugin Settings Panel
Source: https://docs.blinko.space/en/plugins/setting-panel
Each Blinko plugin can have its own settings panel that allows users to customize the plugins behavior.
# Plugin Settings Panel
## Enable Settings Panel
Set `withSettingPanel = true` in your plugin class to enable the settings panel:
```typescript
export class MyPlugin extends BasePlugin {
// Enable settings panel
withSettingPanel = true;
// Render settings panel
renderSettingPanel = () => {
const container = document.createElement('div');
render(
## Theme Settings
#### 1. **Schedule Back Up**
* **Toggle**: If toggled on, backups are scheduled based on the defined interval.
* **Schedule Interval**: The interval is set to 5 days in this case, indicating backups will occur every 5 days.
#### 2. **Schedule Archive Blinko**
* **Toggle**: Enable or disable the automatic archiving of "Blinko" data.
* **Archive Frequency**: Linked to the interval setting above, the system automatically archives data every defined interval.
***
### Table Details
The table provides a summary of scheduled tasks:
#### Columns:
1. **Name**: The specific name of the task.
* **Backup Database**: Indicates the database backup process.
* **Auto Archive Blinko**: Refers to the automatic archiving of Blinko-related data.
2. **Schedule**: The frequency of the task.
* Both tasks are scheduled to run "Every week" in this example.
3. **Last Run**: The time when the task was last executed.
* **Backup Database**: Last ran 13 days ago.
* **Auto Archive Blinko**: Executed "a few seconds ago," indicating it has just completed.
4. **Backup File**: The file path of the saved backup or archive.
* Example: `.blinko/files/blinko_export.bko`
* A download icon is available to retrieve the backup file.
5. **Status**: Indicates the current status of the task.
* **Running**: Both tasks are currently active and functioning as expected.
***
### Functionality
1. **Task Automation**:
* Backups and archiving are handled automatically based on the defined schedule.
* This reduces the need for manual intervention and ensures data is consistently preserved.
2. **File Accessibility**:
* Users can easily access and download the generated backup files from the "Backup File" column.
3. **Real-Time Monitoring**:
* The status column helps monitor whether tasks are actively running or paused.
4. **Customizable Frequency**:
* Users can adjust the interval to fit their needs, e.g., daily, weekly, or custom intervals like "5 days."
***
### Suggested Actions
1. **Ensure Regular Backups**:
* Review the "Last Run" column and adjust the schedule to ensure backups are not too far apart.
2. **Verify Backup Files**:
* Regularly download and verify backup files for integrity and usability.
3. **Monitor Status**:
* Check the "Status" column periodically to confirm that tasks are running smoothly.
# Webhook Settings
Source: https://docs.blinko.space/en/settings/webhook
Configure and manage webhooks for real-time notifications
## Overview
Webhooks allow you to receive real-time notifications when specific events occur in your application. This guide explains how to configure and manage webhooks effectively.
## Setting Up Webhooks
通过遵循本指南，您可以建立一个私有、高效的AI工作流程，同时保持对数据和流程的完全控制。
# 更新日志
Source: https://docs.blinko.space/zh/changelog
Blinko的完整版本历史
# Blinko 更新日志
```
## 启用方法
1. 打开设置 → Desktop & Hotkeys
2. 开启"Autostart"开关
3. 授权（如系统提示）
## 运行方式
* 后台启动，不弹窗
* 系统托盘显示图标
* 快捷键自动生效
## 系统支持
* ✅ Windows
* ✅ macOS
* ✅ Linux
## 关闭方法
在Blinko设置中关闭开关，或在系统启动项管理中禁用。
# 快速AI
Source: https://docs.blinko.space/zh/desktop/quick-ai
在任何地方快速启动AI助手对话
## 默认快捷键
**`Alt + Space`** - 快速打开AI对话窗口
## 如何设置
1. 打开设置 → Desktop & Hotkeys
2. 开启"Enable Quick AI"
3. 自定义快捷键：
* 点击AI快捷键输入框
* 点击"记录"按钮
* 按下想要的组合键
* 点击"停止"保存
## 使用方法
1. 在任何应用中按 `Alt + Space`
2. 输入你的问题或请求
3. AI会基于你的笔记内容回答
## AI功能特性
* **智能对话**：基于你的笔记库提供个性化回答
* **上下文理解**：理解你的问题背景
* **多种用途**：
* 解释概念和想法
* 总结笔记内容
* 回答问题
* 提供建议
## 使用场景
* **学习辅助**：询问已学知识点
* **工作助手**：基于工作笔记提供建议
* **创意启发**：根据已有想法扩展思路
* **快速查询**：搜索相关笔记内容
## 常见问题
**AI不回应？**
1. 检查AI配置是否正确
2. 确认网络连接正常
3. 重启Blinko应用
**回答不准确？**
AI基于你的笔记内容回答，笔记越丰富回答越准确
**重置快捷键**
点击设置中AI快捷键右侧的刷新按钮
# 快速笔记
Source: https://docs.blinko.space/zh/desktop/quick-note
在任何地方快速打开Blinko记录想法
## 默认快捷键
**`Shift + Space`** - 快速打开新建笔记窗口
## 如何设置
1. 打开设置 → Desktop & Hotkeys
2. 开启"启用全局快捷键"
3. 自定义快捷键：
* 点击快捷键输入框
* 点击"记录"按钮
* 按下想要的组合键
* 点击"停止"保存
## 使用方法
1. 在任何应用中按 `Shift + Space`
2. 输入你的想法或笔记
3. 按 `Ctrl + Enter` 保存
## 支持的按键
* **修饰键**：Ctrl/Cmd, Alt, Shift
* **字母数字**：A-Z, 0-9
* **功能键**：F1-F12
* **特殊键**：Space, Tab, Esc
## 常见问题
**快捷键不工作？**
1. 检查是否已启用
2. 重启Blinko
3. 检查与其他软件冲突
4. 尝试更换快捷键组合
**重置为默认**
点击设置中快捷键右侧的刷新按钮
# 文本选择工具栏
Source: https://docs.blinko.space/zh/desktop/text-selection
选择任意文本后快速翻译、问答、收藏
## 如何使用
1. 在任意应用中选择文本
2. 按 \`Ctrl + \`\` （或设置的快捷键）
3. 点击需要的功能按钮
## 主要功能
* **翻译**：多语言互译
* **复制**：智能复制文本
* **问答**：向AI询问相关问题
* **收藏**：保存为Blinko笔记
## 设置方法
1. 打开设置 → Text Selection Toolbar
2. 开启功能开关
3. 选择触发快捷键：
* \`Ctrl + \`\` （推荐）
* \`Shift + \`\`
* \`Alt + \`\`
## 翻译设置
设置翻译语言对：
* 自动检测 → 中文
* 英文 → 中文
* 中文 → 英文
## 支持应用
几乎所有桌面应用：浏览器、Office、代码编辑器、PDF阅读器等。
## 常见问题
**工具栏不显示？**
1. 检查功能是否启用
2. 重启Blinko
3. 检查应用权限
# Blinko Hub
Source: https://docs.blinko.space/zh/ecosystem/blinko-hub
Blinko实例的去中心化网络
# Blinko Hub: 去中心化知识网络
Blinko Hub是一个革命性平台，将各个Blinko实例转变为相互连接的知识生态系统。它作为全球Blinko用户的去中心化发现和协作网络。
## 开始使用
### 1. 注册您的实例 [github/blinko-hub](https://github.com/blinko-space/blinko-hub)
```yaml
# 示例站点配置
title: "您的站点名称"
url: "https://your-blinko.example.com"
tags:
- english # 语言标签
- research # 内容焦点
- tech # 主题领域
created_at: "2024-01-14"
```
### 2. 启用Hub功能
* 在您的Blinko实例中配置Hub设置
* 设置可见性偏好
### 3. 加入网络
* 分享公共blinko
* 与其他实例连接
* 开始关注有趣的站点
* 全球分享您的知识
## 核心功能
### 🌐 去中心化站点发现
* **全球目录**：浏览和发现来自世界各地的Blinko实例
* **P2P连接**：Blinko实例之间的直接点对点连接
* **站点验证**：Blinko实例的自动验证以确保真实性
{/* ### 🔄 跨实例交互
* **关注系统**：订阅来自其他Blinko实例的更新
* **活动源**：来自已关注实例的实时更新
* **Webmention支持**：发送和接收跨站点交互和提及 */}
### 🤝 社区参与
* **站点展示**：向全球社区展示您的Blinko实例
* **基于标签的发现**：根据兴趣、语言和主题找到实例
* **社区排名**：发现趋势和流行的Blinko实例
### 🔗 链接交换网络
* **自动反向链接**：实例之间的智能反向链接管理
* **链接验证**：自动验证互惠链接
* **链接分析**：跟踪和分析跨实例连接
## 技术架构
### 📡 P2P基础设施
* **分布式网络**：无中央服务器依赖
* **数据复制**：高效的点对点数据同步
## 好处
### 对个人用户
* 发现多样化的知识来源
* 与志同道合的个人建立联系
* 有机地扩展您的知识网络
### 对社区
* 创建以主题为中心的网络
* 培养协作学习环境
* 构建知识共享生态系统
### 对组织
* 建立私人知识网络
* 促进跨团队协作
* 维护安全的信息共享
今天就加入Blinko Hub，成为尊重隐私同时促进全球协作的不断增长的去中心化知识网络的一部分。
# Blinko插件
Source: https://docs.blinko.space/zh/ecosystem/blinko-plugin
Blinko插件扩展了您的笔记体验功能。本指南将帮助您发现、安装和管理插件。
### 插件市场
1. 打开Blinko并进入设置
2. 点击"插件设置"
3. 浏览市场中可用的插件
4. 点击插件查看其详细信息，包括：
* 描述
* 作者
* 版本
* 文档
## 安装插件
1. 找到您想安装的插件
2. 点击"安装"按钮
3. 查看插件请求的权限
4. 点击"确认"进行安装
## 管理插件
### 插件设置
大多数插件提供自定义选项：
1. 进入设置 > 插件设置
2. 找到已安装的插件
3. 点击设置图标(⚙️)
4. 调整可用选项
5. 保存您的更改
### 移除插件
如果您需要禁用或移除插件：
1. 进入设置 > 插件设置
2. 找到您想管理的插件
3. 或点击"卸载"按钮进行移除
## 开发
有兴趣创建您自己的插件？
* 查看我们的[插件开发指南](/zh/plugins/get-started)
* 加入我们的[开发者社区](/community/community)
* 浏览[API参考](/zh/plugins/api-reference)
# 微信机器人
Source: https://docs.blinko.space/zh/ecosystem/wechat-bot
通过微信机器人快速保存笔记
# 微信机器人
扫描并且关注微信机器人
# 开始
1. 首次使用时，发送任意消息，机器人会提示配置 Blinko endpoint 和 token
2. 按照提示配置完成后，即可开始使用保存笔记功能
# 聊天
Source: https://docs.blinko.space/zh/how-to-use/ai/ai-chat
AI聊天使用指南
# AI聊天
与基于您笔记库的智能AI助手进行对话，获得个性化和上下文相关的回答。
**\[需要AI聊天界面截图]**
## 启动聊天
### 全局AI聊天
* 点击右下角的AI图标
* 或使用快捷键 `Alt + Space`（桌面版）
* AI将基于您的整个笔记库回答问题
### 笔记相关聊天
* 在特定笔记页面点击AI图标
* AI将重点关注该笔记内容
* 提供更精准的上下文回答
## RAG知识库
Blinko使用RAG（检索增强生成）技术，让AI基于您的笔记内容提供准确回答。
### 支持的内容类型
# AI表情符号生成器
AI表情符号功能允许您根据文本描述生成相关的表情符号。这对于快速找到适合您的消息或内容的完美表情符号非常有用。
# AI后处理
Source: https://docs.blinko.space/zh/how-to-use/ai/ai-post-processing
自动处理新创建的笔记内容
# AI后处理
AI后处理功能可以在创建或更新笔记后自动使用AI分析内容，生成摘要、标签或执行其他分析操作。
## 启用方法
1. 打开设置 → AI Settings
2. 找到"AI后处理"部分
3. 开启"启用AI后处理"开关
## 处理模式
### 添加为评论
* AI分析结果以评论形式添加到笔记下方
* 不会修改原始笔记内容
* 可以查看AI的分析过程和结果
### 自动添加标签
* AI根据内容自动推荐和添加相关标签
* 帮助更好地组织和分类笔记
* 提高搜索和查找效率
### 两者都执行
* 同时生成评论和添加标签
* 最全面的AI处理方式
## 自定义提示词
### 后处理提示词
设置AI分析笔记时使用的提示词：
```
分析以下笔记内容，推荐合适的标签并提供简短摘要
```
### 标签提示词
专门用于生成标签的提示词：
```
为以下内容推荐3-5个相关标签
```
## 工作流程
1. **创建笔记** - 用户创建新笔记
2. **触发处理** - 系统自动检测到新笔记
3. **AI分析** - 使用配置的提示词分析内容
4. **生成结果** - 根据处理模式添加评论或标签
5. **通知用户** - 发送AI处理完成的通知
## 使用场景
### 内容分析
* 自动总结长文本内容
* 提取关键信息和要点
* 分析情感和主题
### 智能标签
* 根据内容自动分类
* 识别专业领域和话题
* 建立一致的标签体系
### 工作流集成
* 会议记录自动处理
* 学习笔记智能整理
* 项目文档分类管理
## 注意事项
* 处理过程在后台异步执行，不会影响笔记创建速度
* AI分析质量取决于所选模型和提示词设置
* 可以随时关闭功能，已处理的内容不会受影响
* 支持自定义提示词以适应不同使用场景
## 配置建议
### 提示词优化
* 根据个人需求调整提示词
* 明确指定期望的输出格式
* 包含相关的上下文信息
### 模式选择
* 新用户推荐先使用"添加为评论"模式
* 熟悉后可切换到"两者都执行"获得最佳效果
* 标签管理规范的可只使用"自动添加标签"
## 使用方式
### 快捷键搜索
* 按 `Ctrl + K` 快速打开搜索
* 输入自然语言查询
* 实时显示相关笔记
### AI问答搜索
* AI对话时自动开启知识库检索
* 基于笔记内容回答问题
* 无需手动搜索
## 搜索功能
* 语义搜索，理解查询意图
* 支持文本、PDF、附件内容
* 支持图片内容（需要多模态模型）
* 相关性评分和智能排序
## 参数设置
在AI设置中调整搜索参数：
* **Embedding Top K**：初始搜索结果数量
* **Embedding Score**：相似度阈值
* **重排序**：使用大语言模型优化结果
# 设置
Source: https://docs.blinko.space/zh/how-to-use/ai/ai-setting
AI设置指南
## 基础设置
AI可以帮助您总结当前笔记，生成多个标签，并选择您喜欢的标签添加。
# AI写作
Source: https://docs.blinko.space/zh/how-to-use/ai/ai-writing
AI写作指南
点击底部工具栏中的[AI写作按钮](/how-to-use/toolbar#bottom-toolbar)开始使用AI写作。
## 告诉AI您想要写什么
您可以点击**接受**使用AI写作结果，或**拒绝**来拒绝它。
## AI扩展
AI可以通过生成额外内容、填补空白或更深入地探索想法来帮助您扩展写作。无论您是在起草文章、创建报告还是写小说，AI都可以分析您现有的文本并建议相关的细节、示例或论点来丰富您的作品。例如，如果您有一个简短的大纲，AI可以通过添加描述、解释和支持信息将其转变为一个完全展开的作品。当您需要详细阐述复杂主题或在不影响写作质量的情况下满足字数要求时，这一功能特别有用。
## AI润色
AI擅长润色您的写作，使其更清晰、更简洁和更专业。它可以识别语法错误、笨拙的表达和语调或风格的不一致。除了基本的校对外，AI工具还可以建议重新表述的句子、丰富词汇，并使您的写作与特定受众或目的保持一致。例如，如果您正在起草一封电子邮件，AI可以将其完善得更正式或更有说服力。同样，它可以调整学术论文以提高精确性和一致性，或使创意作品更吸引人。借助AI，您可以确保您的写作经过润色，并准备好发表或展示。
# Blinko与Note对比
Source: https://docs.blinko.space/zh/how-to-use/blinko-or-note
了解Blinko和Note之间的区别
{/* */}
## 概述
Blinko配备了一个优雅的全局音乐播放器，将您的笔记环境转变为更加沉浸式的体验。无论您是在头脑风暴、写作还是复习笔记，适合的音乐都能提升您的创造力和生产力。
## 功能
2. 使用底部工具栏中的上传按钮上传您的MP3文件
3. Blinko将自动：
* 处理您的音频文件
* 获取元数据和封面艺术
* 创建美观的播放器界面
## 使用技巧
* 为不同类型的笔记创建主题播放列表
* 使用标签如`#music`组织您的音频内容
* 为特定笔记添加音乐文件，提供与上下文相关的背景音乐
## 订阅源可用性
Blinko和笔记将在满足以下条件时自动包含在RSS订阅源中：
* 设置为公开
* 没有密码保护
## 订阅源格式
Blinko支持两种标准RSS订阅格式：
### 1. Atom订阅源
```
/api/rss/{userId}/atom?row=20
```
### 2. RSS订阅源
```
/api/rss/{userId}/rss?row=20
```
## 参数
* `row`：在订阅源中返回的项目数量（默认：20）
* 示例：`row=50`将返回50条最新笔记
* 您可以根据需要调整此值
## 使用示例
1. **默认订阅源（20个项目）**
```
http://your-domain/api/rss/1/atom
http://your-domain/api/rss/1/rss
```
2. **自定义项目数量**
```
http://your-domain/api/rss/1/atom?row=50
http://your-domain/api/rss/1/rss?row=100
```
## 订阅阅读器集成
1. 复制所需的订阅源URL
2. 将其添加到您的RSS阅读器
3. 您的阅读器将自动获取新创建的公开笔记
## 笔记隐私
请记住：
* 只有公开笔记会出现在RSS订阅源中
* 私人笔记和受密码保护的笔记将被排除
* 更改笔记的隐私设置将影响其在订阅源中的可用性
# 分享您的笔记
Source: https://docs.blinko.space/zh/how-to-use/share-your-note
分享笔记指南
# 分享您的笔记
Blinko提供灵活的选项来与他人分享您的笔记。本指南将帮助您了解如何有效使用分享功能。
## 创建分享链接
1. 点击笔记中的分享按钮
2. 配置分享选项：
* **过期时间**：设置分享链接的过期时间
* **访问密码**：可选的分享内容保护
* **干净URL**：生成简洁可分享的URL
## 分享设置
### 过期时间
* 选择分享链接何时过期
* 默认：7天
* 链接在过期后自动失效
### 访问保护
* 切换密码保护
* 设置自定义数字密码
* 接收者需要密码才能查看内容
* 增强敏感信息的安全性
## 分享页面预览
Blinko生成美观、响应式的分享页面，它：
* 保持您笔记的格式
* 支持所有媒体内容
* 适应不同设备
* 如果设置了，包含您的自定义主题
## 管理已分享的笔记
### 查看活动分享
* 查看您当前所有已分享的笔记
* 检查距离过期的剩余时间
* 监控访问统计
### 修改分享设置
* 更新过期时间
* 更改访问密码
* 随时撤销访问权限
## 最佳实践
1. **安全性**
* 为敏感内容使用密码
* 设置适当的过期时间
* 定期审查活动分享
2. **分享**
* 分享前测试链接
* 在单独的通信中包含密码
* 考虑接收者的时区设置过期时间
## 创建标签层次结构
使用Blinko的多级标签功能，您可以创建反映灵感之间关系的层次结构。例如，您可以设置顶级标签如"工作"、"个人"或"爱好"，然后进一步细分为更具体的标签，如"项目A"、"项目B"、"旅行"或"艺术"。这种层次化组织使您能够轻松浏览灵感，并快速定位所需信息。
# 工具栏
Source: https://docs.blinko.space/zh/how-to-use/toolbar
Blinko使用markdown格式化您的笔记。以下是图标及其功能。
Blinko是一个**创新**的开源项目，专为那些希望快速捕捉和组织转瞬即逝想法的个人设计。Blinko允许用户在灵感出现的瞬间无缝记录想法，确保不会错过任何创意的火花。
## 功能
1. 访问我们的[Blinko插件模板在CodeSandbox](https://codesandbox.io/p/github/blinko-space/blinko-plugin-template/main)
2. 点击"Fork"创建您自己的副本
3. 开发服务器将自动启动
4. 您将在`http://localhost:3000`看到连接说明：
* 外部访问：`ws://
如果连接成功，您将看到您的插件列为"本地插件"，旁边有一个绿色状态指示器。
### 连接问题故障排除
如果您无法连接到您的插件：
1. 确保您的开发服务器正在运行（`bun dev`）
2. 检查WebSocket URL是否正确
3. 如果使用本地网络URL，确保您在同一网络上
4. 对于ngrok连接，确保使用ngrok提供的`wss://` URL
## 其他资源
* 发布插件到Blinko插件市场[发布插件](/plugins/publish-plugin)
* 查看[API参考](/plugins/api-reference)了解可用的API
* 加入我们的[社区](/community/community)获取帮助并分享您的插件
# 发布您的插件
Source: https://docs.blinko.space/zh/plugins/publish-plugin
当您的插件准备好发布时，您可以将其发布到Blinko插件市场。本指南将引导您完成准备和发布插件的过程。
## 先决条件
发布前，请确保您已准备：
* 一个完整且经过测试的插件
* 一个公开的GitHub仓库
* 一个有效的GitHub账户
* 已安装Github Cli [Github Cli](https://cli.github.com/)
## 发布流程
### 1. 准备您的插件
发布前，请确保您的插件满足所有要求：
1. 更新您的`plugin.json`中的最新版本号
2. 确保`plugin.json`中所有必填字段都已填写：
```json
{
"name": "your-plugin-name",
"author": "your-name",
"url": "https://github.com/your-username/your-plugin",
"version": "1.0.0",
"minAppVersion": "0.0.0",
"displayName": {
"default": "Your Plugin Name",
"zh": "你的插件名称"
},
"description": {
"default": "Your plugin description",
"zh": "你的插件描述"
}
}
```
3. 彻底测试您的插件
4. 提交并推送所有更改到GitHub
### 2. 运行发布命令
模板提供了一个简单的命令来处理发布过程：
```bash
bun release:publish
```
此命令将：
1. 为生产环境构建您的插件
2. 创建发布包（`release.zip`）
3. 使用该包创建GitHub发布
4. 将您的插件提交到[Blinko插件市场](https://github.com/blinko-space/blinko-plugin-marketplace)
### 3. 幕后过程
`release:publish`命令使用[blinko-cli](https://github.com/blinko-space/blinko-cli)处理发布过程。以下是具体流程：
1. CLI验证您的`plugin.json`并确保所有必填字段都存在
2. 将您插件的`release`目录打包成ZIP文件
3. 使用GitHub的API，以您的版本号创建新的发布
4. 发布包被上传到GitHub发布中
5. 在Blinko插件市场仓库中创建一个问题请求发布
### 4. 发布后
运行发布命令后：
1. 将在[Blinko插件市场](https://github.com/blinko-space/blinko-plugin-marketplace)中创建一个新问题
2. Blinko团队将审核您的插件
3. 一旦获得批准，您的插件将在市场中可用
4. 您可以通过GitHub问题跟踪您的提交状态
## 故障排除
### 常见问题
1. GitHub身份验证
* 确保您已配置正确的GitHub凭据
* 检查您的仓库权限
2. 版本号问题
* 确保您的版本遵循语义化版本控制（例如，1.0.0）
* 版本号必须高于先前的发布版本
3. 发布包问题
* 验证您的发布目录包含所有必要的文件
* 检查ZIP文件是否成功创建
4. 仓库访问
* 确认您的仓库是公开的
* 验证`plugin.json`中的仓库URL是否正确
## 需要帮助？
如果您遇到任何问题或需要帮助：
* 查看我们的[社区论坛](/community/community)
* 在[blinko-cli仓库](https://github.com/blinko-space/blinko-cli)中提出问题
* 查看[市场仓库](https://github.com/blinko-space/blinko-plugin-marketplace)中的现有问题
# 插件设置面板
Source: https://docs.blinko.space/zh/plugins/setting-panel
每个Blinko插件都可以拥有自己的设置面板，允许用户自定义插件行为。
# 插件设置面板
## 启用设置面板
在您的插件类中设置`withSettingPanel = true`来启用设置面板：
```typescript
export class MyPlugin extends BasePlugin {
// Enable settings panel
withSettingPanel = true;
// Render settings panel
renderSettingPanel = () => {
const container = document.createElement('div');
render(
## 主题设置
#### 1. **定时备份**
* **切换**：如果开启，备份将按照定义的间隔进行调度。
* **调度间隔**：在本例中，间隔设置为5天，表示备份将每5天进行一次。
#### 2. **定时归档Blinko**
* **切换**：启用或禁用"Blinko"数据的自动归档。
* **归档频率**：与上面的间隔设置相关联，系统会按照定义的间隔自动归档数据。
***
### 表格详情
表格提供了定时任务的摘要：
#### 列：
1. **名称**：任务的具体名称。
* **备份数据库**：表示数据库备份流程。
* **自动归档Blinko**：指的是Blinko相关数据的自动归档。
2. **调度**：任务的频率。
* 在本例中，两个任务都设置为"每周"运行。
3. **上次运行**：任务上次执行的时间。
* **备份数据库**：13天前最后运行。
* **自动归档Blinko**：在"几秒钟前"执行，表示刚刚完成。
4. **备份文件**：保存的备份或归档的文件路径。
* 示例：`.blinko/files/blinko_export.bko`
* 提供下载图标可获取备份文件。
5. **状态**：表示任务的当前状态。
* **运行中**：两个任务当前都处于活动状态并按预期运行。
***
### 功能
1. **任务自动化**：
* 备份和归档根据定义的计划自动处理。
* 这减少了人工干预的需要，并确保数据得到持续保存。
2. **文件可访问性**：
* 用户可以从"备份文件"列轻松访问和下载生成的备份文件。
3. **实时监控**：
* 状态列帮助监控任务是否处于活动状态或暂停状态。
4. **可自定义频率**：
* 用户可以调整间隔以满足他们的需求，例如，每天、每周或自定义间隔如"5天"。
***
### 建议的操作
1. **确保定期备份**：
* 查看"上次运行"列并调整计划，确保备份之间的间隔不会太长。
2. **验证备份文件**：
* 定期下载并验证备份文件的完整性和可用性。
3. **监控状态**：
* 定期检查"状态"列，确认任务运行正常。
# Webhook设置
Source: https://docs.blinko.space/zh/settings/webhook
配置和管理用于实时通知的webhooks
## 概述
Webhooks允许您在应用程序中发生特定事件时接收实时通知。本指南解释如何有效配置和管理webhooks。
## 设置Webhooks