Appearance
Lingshi 零食站
灵感拾取，知识管理 - 您的大脑外挂，支持 Markdown 渲染与毫秒级搜索
简介
Lingshi（零食站）是一个高性能的本地知识库管理插件，帮助您捕捉灵感、整理知识、快速检索。它不仅仅是笔记工具，更是您的第二大脑。
核心特性
- 快速拾取 - 一键捕捉任何内容，支持文本、图片、链接
- Markdown 渲染 - 原生支持 Markdown 语法，实时预览
- 毫秒级搜索 - 基于 inverted index 的全文检索引擎
- 标签系统 - 灵活的标签分类，支持多级标签
- 知识图谱 - 自动关联相关笔记，构建知识网络
- 双向链接 - 支持
[[wiki-link]]语法，连接相关内容
安装
Spark 插件市场安装
- 打开 Spark 应用
- 进入插件市场
- 搜索 "Lingshi" 或 "零食站"
- 点击安装
命令行安装
bash
spark install spark-plugin-ui--lingshi快速开始
创建第一条笔记
typescript
import { Lingshi } from '@spark-center/lingshi'
const lingshi = new Lingshi()
// 创建笔记
const note = await lingshi.create({
title: '我的第一条笔记',
content: '# Hello Lingshi\n\n这是我的第一条笔记，支持 **Markdown** 语法。',
tags: ['welcome', 'first-note']
})
console.log('笔记已创建:', note.id)快速拾取
typescript
// 从剪贴板拾取
const clipboard = await lingshi.captureFromClipboard()
// 拾取选中文本
const selection = await lingshi.captureSelection()
// 拾取整个页面
const page = await lingshi.capturePage({
format: 'markdown',
includeImages: true
})Markdown 支持
Lingshi 支持完整的 Markdown 语法，包括：
基础语法
markdown
# 标题 1
## 标题 2
### 标题 3
**粗体** 和 *斜体*
- 无序列表项 1
- 无序列表项 2
1. 有序列表项 1
2. 有序列表项 2
[链接文字](https://spark.center)
`行内代码`
\`\`\`javascript
// 代码块
function hello() {
console.log('Hello Spark')
}
\`\`\`
> 引用文字
---
水平分隔线扩展语法
markdown
==高亮文本==
=={red}红色高亮==
^^上标^^和~~下标~~
[[双向链接到其他笔记]]
![toc] 目录
[任务列表]
- [x] 已完成任务
- [ ] 未完成任务搜索功能
Lingshi 提供强大的全文搜索能力。
基础搜索
typescript
// 搜索关键词
const results = await lingshi.search('Spark 插件')
// 搜索结果按相关性排序
console.log(results)
// [
// { id: '1', title: 'Spark 插件开发', score: 0.95 },
// { id: '2', title: '插件生态', score: 0.87 }
// ]高级搜索
typescript
// 标签搜索
const taggedNotes = await lingshi.search({
tags: ['development', 'spark']
})
// 日期范围搜索
const dateFiltered = await lingshi.search({
startDate: '2024-01-01',
endDate: '2024-12-31'
})
// 组合搜索
const combined = await lingshi.search({
query: 'API',
tags: ['reference'],
limit: 10
})搜索语法
# 标题搜索
title:Spark
# 标签搜索
tag:development
# 排除关键词
Spark -plugin
# 精确匹配
"Spark 插件开发"
# OR 搜索
Spark OR Telescope
# 组合搜索
title:API tag:reference -deprecated标签系统
标签操作
typescript
// 添加标签
await lingshi.addTags(noteId, ['important', 'todo'])
// 移除标签
await lingshi.removeTags(noteId, ['todo'])
// 获取所有标签
const tags = await lingshi.getAllTags()
// 按标签筛选笔记
const notes = await lingshi.getByTag('important')多级标签
Lingshi 支持多级标签，用 / 分隔：
typescript
// 创建多级标签
await lingshi.addTags(noteId, [
'project/spark',
'project/plugin',
'status/active'
])
// 搜索父级标签会包含所有子级
const sparkNotes = await lingshi.getByTag('project/spark')
// 返回包含 'project/plugin' 的笔记知识图谱
自动关联
Lingshi 会自动分析笔记内容，发现潜在的关联：
typescript
// 获取相关笔记
const related = await lingshi.getRelated(noteId, {
limit: 5,
minSimilarity: 0.3
})
// related 返回与当前笔记相关的其他笔记双向链接
使用 [[链接标题]] 语法创建笔记之间的链接：
markdown
# Spark 插件开发
开发插件时需要了解 [[Telescope-X]] 的功能，它与 [[Flytrap]] 配合使用效果最佳。反向链接
查看哪些笔记链接到了当前笔记：
typescript
const backlinks = await lingshi.getBacklinks(noteId)
// 返回所有链接到当前笔记的笔记列表数据导出
导出格式
typescript
// 导出为 Markdown
const md = await lingshi.exportNote(noteId, 'markdown')
// 导出为 PDF
const pdf = await lingshi.exportNote(noteId, 'pdf')
// 导出为 HTML
const html = await lingshi.exportNote(noteId, 'html')
// 批量导出
const zip = await lingshi.exportAll({
format: 'markdown',
includeAttachments: true
})数据备份
typescript
// 创建备份
const backup = await lingshi.createBackup({
includeAttachments: true,
compression: true
})
// 恢复备份
await lingshi.restoreBackup(backupFile)快捷键
| 快捷键 | 功能 |
|---|---|
Cmd/Ctrl + N | 新建笔记 |
Cmd/Ctrl + Shift + N | 从剪贴板新建 |
Cmd/Ctrl + F | 搜索笔记 |
Cmd/Ctrl + S | 保存笔记 |
Cmd/Ctrl + Shift + T | 快速添加标签 |
Cmd/Ctrl + / | 显示所有快捷键 |
最佳实践
- 每日回顾 - 每天结束时回顾今天的笔记，整理知识点
- 定期归档 - 将完成的项目笔记归档，保持工作区清爽
- 建立模板 - 为常见笔记类型创建模板，提高效率
- 善用标签 - 建立自己的标签体系，便于分类和检索
- 坚持记录 - 养成随时记录灵感的习惯
常见问题
笔记存储在哪里？
所有笔记都存储在本地，位于 ~/Library/Application Support/Spark/Lingshi/ (macOS) 或 %APPDATA%/Spark/Lingshi/ (Windows)。
支持云同步吗？
支持。Lingshi 可以通过 Spark 的云同步服务在多个设备间同步笔记。在设置中启用云同步即可。
如何导入 Evernote/Notion 笔记？
Lingshi 提供了导入工具，支持从 Evernote、Notion、Obsidian 等平台导入数据。
bash
lingshi import --format evernote --file backup.enex支持数学公式吗？
支持。使用 LaTeX 语法即可渲染数学公式：
$$
E = mc^2
$$