knas (Knowledge Async)

🚀 让每一次复制，都成为知识复利。

Knas (Knowledge Async) 不是另一个剪贴板工具。它是你的 私有知识管道。

你在 Mac 上复制一段文字、一张截图、一个链接——Knas 在后台静默捕获，通过 SSH 安全地存入你的私有 NAS，按日期归档为 Markdown。你手机上的灵感，也能通过公网中继自动汇入。

捕获时零摩擦，沉淀时零丢失。 从此，每一次 Cmd+C 都是在为你的第二大脑添砖加瓦。配合内置的 Blog/Podcast/IMA 发布引擎，一次输入，三重输出。

对抗遗忘，积累复利。让知识管理，从“复制”这一步开始。

📖 什么是 K.N.A.S.？

从“Knowledge Async”出发，knas 这个名字完全可以生长出一组丰富的内涵。以下是根据项目核心理念，为 K.N.A.S. 四个字母赋予的多重联想，每一个都对应着 knas 的一个侧面：

🧠 官方正解（原名）

· Knowledge Async 知识的异步传输。这是名字的起点，强调了“不打断心流、后台静默运行”的核心特征。

🏛️ 哲学层（对抗熵增）

· Keep Notions Always Saved 让一切念头永不丢失。对抗遗忘，对抗数字熵增，这是 knas 的终极使命。 · Knowledge Never Accidentally Sinks 知识永不意外沉没。每一条碎片都被打捞，放进你的私人知识方舟。

⚙️ 架构层（技术本质）

· Kernel for Networked Archival Sync 网络归档同步的内核。一个轻量、专注的守护进程，像操作系统内核一样可靠。 · Kapture, Normalize, Archive, Syndicate 捕获、标准化、归档、分发。这是 knas 数据流四部曲的精确描述。

🌊 产品层（用户体验）

· Kindle Notes Auto Sync 灵感笔记自动同步。这里的“Kindle”作动词，意为“点燃灵感”，每次复制都是一次火花的捕捉。 · Knowledge Nirvana Automation System 知识涅槃自动化系统。有点中二，但精准表达了从碎片到复利的质变过程。

🔒 价值观层（数据主权）

· Keep Nas As Sanctuary 让 NAS 成为知识圣殿。强调私有化、自主可控的存储哲学。

🎁 彩蛋（趣味向）

· Kitchen Never Asks Silly 厨房从不多问。把 knas 比作一个沉默的厨房帮工，你扔进去食材（碎片），它默默处理成菜肴（知识），从不抱怨。 · Knowledge Not Another Silo 知识不再是孤岛。打破 App 之间的壁垒，让剪贴板成为统一入口。

剪切板自动同步工具 - 在 Mac 本机监听剪切板并同步到 Ubuntu 服务器。

功能特点

• 🔔 实时监听: 500ms 轮询剪切板变化，CPU 占用极低
• 🖼️ 多模态支持: 自动识别并归档截图（PNG），实现图文同档
• 🔒 安全传输: 通过 SSH 协议加密传输，无需在服务器安装接收端
• 🧠 智能识别: 自动识别 URL 并抓取网页标题
• 🎯 智能过滤: 支持敏感词过滤，避免同步密码等敏感信息
• 📁 自动归档: 按日期自动归档到 YYYY/MM/DD/ 目录结构
• 🔄 高韧性重试: 指数退避重试机制（Exponential Backoff + Jitter），网络抖动自动抚平
• ⏪ 历史回溯: knas history 查看最近同步记录，knas restore <id> 一键找回被覆盖的内容
• 🚀 后台运行: 支持 macOS LaunchAgent，开机自启动

安装

# 全局安装
npm install -g knas

# 或从源码安装
git clone https://github.com/yuanguangshan/knas.git
cd knas
npm install
npm run build
npm link

快速开始

1. 初始化配置

knas init

交互式配置：

• SSH 服务器地址
• SSH 端口（默认 22）
• SSH 用户名（默认 root）
• SSH 密钥路径（默认 ~/.ssh/id_rsa）
• 远程存储路径（默认 ~/knas_archive）
• 最小同步长度（默认 100 字符）

2. 启动守护进程

knas start

3. 查看状态

knas status

4. 查看日志

knas log          # 查看日志
knas log -f       # 实时跟踪日志

命令

| 命令 | 说明 | |------|------| | knas init | 初始化配置 | | knas start | 启动守护进程 | | knas stop | 停止守护进程 | | knas status | 查看运行状态 | | knas log | 查看日志 | | knas config | 查看/编辑配置 | | knas history [n] | 查看最近 n 条同步记录（默认 20） | | knas restore <id> | 将指定记录回填到剪贴板 | | knas service install | 安装为 macOS 系统服务 |

macOS 系统服务

安装为 LaunchAgent 后，knas 会在登录时自动启动，崩溃自动重启：

# 停止服务
launchctl unload ~/Library/LaunchAgents/com.knas.daemon.plist

# 启动服务
launchctl load ~/Library/LaunchAgents/com.knas.daemon.plist

# 查看状态
launchctl list | grep knas

# 卸载服务（不再开机自启）
launchctl unload ~/Library/LaunchAgents/com.knas.daemon.plist
rm ~/Library/LaunchAgents/com.knas.daemon.plist

配置文件

配置文件位于 ~/.knas/config.json：

{
  "ssh": {
    "host": "your-server.com",
    "port": "22",
    "user": "root",
    "key_path": "~/.ssh/id_rsa",
    "base_path": "~/knas_archive"
  },
  "clipboard": {
    "min_length": 100,
    "poll_interval_ms": 500,
    "exclude_words": ["password", "密码", "token"]
  },
  "sync": {
    "enabled": true,
    "max_retries": 3,
    "retry_delay_ms": 5000
  }
}

远程文件结构

同步的文件按以下结构存储：

├── 2026/
│   ├── 04/
│   │   ├── 18/
│   │   │   ├── 133119_knas_已成功运行.md  <-- 语义化后缀
│   │   │   ├── 142545_关于量化交易的思.md
│   │   │   ├── 150405_image.png          <-- 自动归档的截图
│   │   │   └── ...

每个文件包含：

---
sync_time: 2026-04-18 14:20:30
source: clipboard
---

[剪切板内容]

架构

┌─────────────────┐
│   Mac 本机      │
│                 │
│  ┌───────────┐  │    SSH    ┌─────────────┐
│  │ 剪切板监听 │  │ ────────> │  Ubuntu     │
│  │   (Go)    │  │            │  服务器     │
│  └───────────┘  │            └─────────────┘
│       ↓         │                  │
│  内容处理       │                  ↓
│  (URL标题抓取)  │          文件存储
│       ↓         │          (按日期归档)
│  ┌───────────┐  │
│  │ SSH 同步  │  │
│  └───────────┘  │
└─────────────────┘

技术栈

• 剪切板监听: Go + golang.design/x/clipboard (原生支持 Text + Image)
• 重试机制: Go + internal/retry (指数退避 + Full Jitter)
• SSH 传输: Go + golang.org/x/crypto/ssh
• CLI 工具: Go (纯原生编译，无 Node.js 依赖)
• 系统服务: macOS LaunchAgent

开发

# 克隆仓库
git clone https://github.com/yuanguangshan/knas.git
cd knas

# 安装 Go 依赖
go mod tidy

# 构建二进制文件
go build -o knas ./cmd/knas

# 运行
./knas init
./knas start

注意事项

1. SSH 密钥: 确保 Mac 的 SSH 公钥已添加到服务器的 ~/.ssh/authorized_keys
2. 网络连接: 确保能访问远程服务器
3. 权限: 确保远程路径有写入权限
4. 敏感信息: 默认排除包含 "password"、"密码"、"token" 的内容

许可证

MIT

v1.7.0 新增：历史回溯与找回

使用场景

1. 手滑覆盖：复制了新内容，想找回上一条被覆盖的长文本。
2. 截图归档：确认截图是否已成功同步到 NAS。

示例

# 查看最近 20 条同步记录
$ knas history
[20260418184501_a1b2c3d4] (text) 关于量化交易的思考...
[20260418184430_e5f6g7h8] (image) [IMAGE] 102400 bytes
[20260418184315_i9j0k1l2] (text) https://github.com/yuanguangshan/knas

# 找回被覆盖的文本
$ knas restore 20260418184501_a1b2c3d4
✓ 已将记录 20260418184501_a1b2c3d4 恢复到剪贴板