6.74.0 • Published 6d agoCLI

knowly

Licence

MIT

Version

6.74.0

Deps

Size

60.4 MB

Vulns

Weekly

2.0K

Install scriptsThis package runs scripts during installation (preinstall/install/postinstall)

Summary Dependency Versions

knowly (Knowledge Async)

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

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

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

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

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

什么是 K.N.O.W.L.Y.？

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

官方正解（原名）

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

哲学层（对抗熵增）

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

架构层（技术本质）

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

产品层（用户体验）

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

价值观层（数据主权）

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

彩蛋（趣味向）

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

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

功能特点

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

安装

# 全局安装
npm install -g knowly

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

快速开始

1. 初始化配置

knowly init

交互式配置：

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

2. 启动守护进程

knowly start

3. 查看状态

knowly status

4. 查看日志

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

命令

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

macOS 系统服务

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

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

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

# 查看状态
launchctl list | grep knowly

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

配置文件

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

{
  "ssh": {
    "host": "your-server.com",
    "port": "22",
    "user": "root",
    "key_path": "~/.ssh/id_rsa",
    "base_path": "~/knowly_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_knowly_已成功运行.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/knowly.git
cd knowly

# 安装 Go 依赖
go mod tidy

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

# 运行
./knowly init
./knowly start

注意事项

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

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

示例

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

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

Keywords

clipboard sync ssh knowledge automation productivity backup macos