Silverbullet - 开源笔记与知识管理工具,TypeScript+Deno开发,Markdown增强语法,模板与查询,实时协作

# 项目笔记

请参见 [[另一个笔记]] 了解更多信息。
你也可以指定别名：[[另一个笔记|这个别名]]

这是一个带标签的句子 #编程 #Go

# 标签语法示例
- 使用 #个人/家庭 分类到个人命名空间下的家庭标签

---
title: 我的项目计划
date: 2024-06-20
status: active
tags: ["项目", "工作"]
priority: high
---

# 项目计划

正文内容...

# 今日任务

- [ ] 撰写技术文档
- [x] 完成代码审查
- [ ] 优先级任务 ⏰ 2024-06-22
- [ ] 需要进一步讨论 👉 需要讨论

<!-- template/daily.md -->

# {{today}} 每日笔记

## 今日计划
- [ ] 

## 今日学习
- {{today}} 学习内容

## 标签
#每日笔记

<!-- 在笔记中输入 slash command 或模板插入语法 -->

# 在任何笔记中运行 template/daily 模板即可插入每日笔记

<!-- 查询所有带 #编程 标签的页面 -->

```query
page select name where tags = "编程" render [[template/page-link]]

<!-- 查询所有未完成的任务 -->

```query
task where done = false order by created desc render "task"

<!-- 查询所有标记为 active 的项目页面 -->

```query
page select name, status, date where status = "active" render "table"

[用户浏览器（Preact UI）]
         │
         │ WebSocket 实时同步 + HTTP API
         ▼
[Silverbullet Server（TypeScript / Deno 运行时）
    │
    ▼
[可插拔 Storage 后端]
    ├── Local 文件系统（默认）
    ├── S3 存储（对象存储）
    ├── DenoKV（键值存储）
    └── Git 存储（Git 后端）

docker run -d \
  --name silverbullet \
  -p 3000:3000 \
  -e SB_USER=admin:your-password \
  -v ./space:/space \
  --restart=unless-stopped \
  zefhemel/silverbullet:latest

version: "3.8"

services:
  silverbullet:
    image: zefhemel/silverbullet:latest
    container_name: silverbullet
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - SB_AUTH=true
      - SB_USER=admin:your-strong-password
      - SB_AUTH_TOKEN=your-secret-token-for-api
      - TZ=Asia/Shanghai
    volumes:
      - ./space:/space

docker compose up -d
docker compose logs -f

# macOS/Linux
curl -fsSL https://deno.land/x/install/install.sh | sh

# Windows (PowerShell)
iwr https://deno.land/x/install/install.ps1 -useb | iex

# 安装
deno install -f -A --unstable -n silverbullet https://get.silverbullet.md

# 创建笔记目录
mkdir -p ~/Notes
cd ~/Notes

# 启动服务
silverbullet --user admin:your-password .

silverbullet upgrade

# 克隆仓库
git clone https://github.com/silverbulletmd/silverbullet.git
cd silverbullet

# 安装依赖并构建
deno task build:web

# 运行
deno task server ~/Notes --user admin:password

# 项目文档

参见 [[技术架构]] 了解系统架构。
点击 [[项目计划|项目计划页面]] 查看详细计划。
支持目录链接：[[projects/projectA/README]]

# 分类系统

支持多级标签：#项目/前端/React
多个标签可在同一页面使用：#学习 #笔记

---
title: 项目计划
created: 2024-06-20
status: active
priority: high
tags: ["项目", "工作"]
---

# 项目计划正文

...

# 任务列表

- [ ] 未完成任务
- [x] 已完成任务
- [ ] 带截止日期的任务 ⏰ 2024-06-25
- [ ] 需要讨论 👉 讨论笔记

page select name where tags = "项目" render "[[{{name}}]]"

task where done = false and tags = "工作" order by created desc render "task"

page select name, status, date where status = "active" render "table"

<!-- 嵌入某个页面的全文 -->

{{[[另一个页面]]}}

# {{today}} 每日笔记

## 今日计划
- [ ] 

## 学习与总结
- 

## 会议记录
- 

## 标签
#每日笔记

// 在 .space/scripts/my-script.js 中创建脚本

export function helloWorld() {
  return "Hello, Silverbullet!";
}

export function getRecentNotes(count = 10) {
  return syscall("space.listPages")
    .then(pages => pages
      .sort((a, b) => b.lastModified - a.lastModified)
      .slice(0, count));
}

{{helloWorld()}}

export function renderGreeting(name) {
  return `<div style="color: #4a90e2; font-size: 18px;">Hello, ${name}!</div>`;
}

在 UI 中进入 Settings → Plugs → Add plug

# 设置 API Token
export SB_TOKEN="your-secret-token"

# 列出所有页面
curl -H "Authorization: Bearer $SB_TOKEN" http://127.0.0.1:3000/.pages.json

# 获取指定页面内容
curl -H "Authorization: Bearer $SB_TOKEN" http://127.0.0.1:3000/%E4%B8%AD%E6%96%87%E9%A1%B5%E9%9D%A2.md

# 创建/更新页面
curl -X PUT -H "Authorization: Bearer $SB_TOKEN" \
  -H "Content-Type: text/markdown" \
  --data-binary "# 新页面\n\n内容" \
  http://127.0.0.1:3000/new-page.md

// JavaScript 示例
const socket = new WebSocket("ws://127.0.0.1:3000/.ws");
socket.onopen = () => {
  console.log("WebSocket 已连接");
};
socket.onmessage = (e) => {
  const data = JSON.parse(e.data);
  console.log("收到消息:", data);
};

# 在 space 目录初始化 Git
cd /path/to/space
git init
git add .
git commit -m "initial"

# 设置定时任务（每 5 分钟提交一次）
*/5 * * * * cd /path/to/space && git add -A && git commit -m "auto sync" && git push

server {
    listen 443 ssl http2;
    server_name notes.example.com;

    ssl_certificate     /etc/ssl/cert.pem;
    ssl_certificate_key /etc/ssl/key.pem;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

# 备份 space 目录
tar czf silverbullet-backup-$(date +%Y%m%d).tar.gz /path/to/space

# 使用 Git 做版本控制
cd /path/to/space
git add -A
git commit -m "backup $(date)"

docker pull zefhemel/silverbullet:latest
docker stop silverbullet
docker rm silverbullet
# 重新创建容器