knowly 6.12.0 → 6.13.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +45 -45
- package/bin/knas-darwin +0 -0
- package/bin/knas-darwin-arm64 +0 -0
- package/bin/knas-linux +0 -0
- package/bin/knowly-darwin +0 -0
- package/bin/knowly-darwin-arm64 +0 -0
- package/bin/knowly-linux +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,18 +1,18 @@
|
|
|
1
|
-
#
|
|
1
|
+
# knowly (Knowledge Async)
|
|
2
2
|
|
|
3
3
|
🚀 让每一次复制,都成为知识复利。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Knowly (Knowledge Async) 不是另一个剪贴板工具。它是你的 私有知识管道。
|
|
6
6
|
|
|
7
|
-
你在 Mac 上复制一段文字、一张截图、一个链接——
|
|
7
|
+
你在 Mac 上复制一段文字、一张截图、一个链接——Knowly 在后台静默捕获,通过 SSH 安全地存入你的私有 NAS,按日期归档为 Markdown。你手机上的灵感,也能通过公网中继自动汇入。
|
|
8
8
|
|
|
9
9
|
捕获时零摩擦,沉淀时零丢失。 从此,每一次 Cmd+C 都是在为你的第二大脑添砖加瓦。配合内置的 Blog/Podcast/IMA 发布引擎,一次输入,三重输出。
|
|
10
10
|
|
|
11
11
|
对抗遗忘,积累复利。让知识管理,从“复制”这一步开始。
|
|
12
12
|
|
|
13
|
-
📖 什么是 K.N.
|
|
13
|
+
📖 什么是 K.N.O.W.L.Y.?
|
|
14
14
|
|
|
15
|
-
从“Knowledge Async”出发,
|
|
15
|
+
从“Knowledge Async”出发,knowly 这个名字完全可以生长出一组丰富的内涵。以下是根据项目核心理念,为 K.N.O.W.L.Y. 四个字母赋予的多重联想,每一个都对应着 knowly 的一个侧面:
|
|
16
16
|
|
|
17
17
|
🧠 官方正解(原名)
|
|
18
18
|
|
|
@@ -22,7 +22,7 @@ Knas (Knowledge Async) 不是另一个剪贴板工具。它是你的 私有知
|
|
|
22
22
|
🏛️ 哲学层(对抗熵增)
|
|
23
23
|
|
|
24
24
|
· Keep Notions Always Saved
|
|
25
|
-
让一切念头永不丢失。对抗遗忘,对抗数字熵增,这是
|
|
25
|
+
让一切念头永不丢失。对抗遗忘,对抗数字熵增,这是 knowly 的终极使命。
|
|
26
26
|
· Knowledge Never Accidentally Sinks
|
|
27
27
|
知识永不意外沉没。每一条碎片都被打捞,放进你的私人知识方舟。
|
|
28
28
|
|
|
@@ -31,7 +31,7 @@ Knas (Knowledge Async) 不是另一个剪贴板工具。它是你的 私有知
|
|
|
31
31
|
· Kernel for Networked Archival Sync
|
|
32
32
|
网络归档同步的内核。一个轻量、专注的守护进程,像操作系统内核一样可靠。
|
|
33
33
|
· Kapture, Normalize, Archive, Syndicate
|
|
34
|
-
捕获、标准化、归档、分发。这是
|
|
34
|
+
捕获、标准化、归档、分发。这是 knowly 数据流四部曲的精确描述。
|
|
35
35
|
|
|
36
36
|
🌊 产品层(用户体验)
|
|
37
37
|
|
|
@@ -48,7 +48,7 @@ Knas (Knowledge Async) 不是另一个剪贴板工具。它是你的 私有知
|
|
|
48
48
|
🎁 彩蛋(趣味向)
|
|
49
49
|
|
|
50
50
|
· Kitchen Never Asks Silly
|
|
51
|
-
厨房从不多问。把
|
|
51
|
+
厨房从不多问。把 knowly 比作一个沉默的厨房帮工,你扔进去食材(碎片),它默默处理成菜肴(知识),从不抱怨。
|
|
52
52
|
· Knowledge Not Another Silo
|
|
53
53
|
知识不再是孤岛。打破 App 之间的壁垒,让剪贴板成为统一入口。
|
|
54
54
|
|
|
@@ -66,18 +66,18 @@ Knas (Knowledge Async) 不是另一个剪贴板工具。它是你的 私有知
|
|
|
66
66
|
- 🎯 **智能过滤**: 支持敏感词过滤,避免同步密码等敏感信息
|
|
67
67
|
- 📁 **自动归档**: 按日期自动归档到 `YYYY/MM/DD/` 目录结构
|
|
68
68
|
- 🔄 **高韧性重试**: 指数退避重试机制(Exponential Backoff + Jitter),网络抖动自动抚平
|
|
69
|
-
- ⏪ **历史回溯**: `
|
|
69
|
+
- ⏪ **历史回溯**: `knowly history` 查看最近同步记录,`knowly restore <id>` 一键找回被覆盖的内容
|
|
70
70
|
- 🚀 **后台运行**: 支持 macOS LaunchAgent,开机自启动
|
|
71
71
|
|
|
72
72
|
## 安装
|
|
73
73
|
|
|
74
74
|
```bash
|
|
75
75
|
# 全局安装
|
|
76
|
-
npm install -g
|
|
76
|
+
npm install -g knowly
|
|
77
77
|
|
|
78
78
|
# 或从源码安装
|
|
79
|
-
git clone https://github.com/yuanguangshan/
|
|
80
|
-
cd
|
|
79
|
+
git clone https://github.com/yuanguangshan/knowly.git
|
|
80
|
+
cd knowly
|
|
81
81
|
npm install
|
|
82
82
|
npm run build
|
|
83
83
|
npm link
|
|
@@ -88,7 +88,7 @@ npm link
|
|
|
88
88
|
### 1. 初始化配置
|
|
89
89
|
|
|
90
90
|
```bash
|
|
91
|
-
|
|
91
|
+
knowly init
|
|
92
92
|
```
|
|
93
93
|
|
|
94
94
|
交互式配置:
|
|
@@ -96,64 +96,64 @@ knas init
|
|
|
96
96
|
- SSH 端口(默认 22)
|
|
97
97
|
- SSH 用户名(默认 root)
|
|
98
98
|
- SSH 密钥路径(默认 ~/.ssh/id_rsa)
|
|
99
|
-
- 远程存储路径(默认 ~/
|
|
99
|
+
- 远程存储路径(默认 ~/knowly_archive)
|
|
100
100
|
- 最小同步长度(默认 100 字符)
|
|
101
101
|
|
|
102
102
|
### 2. 启动守护进程
|
|
103
103
|
|
|
104
104
|
```bash
|
|
105
|
-
|
|
105
|
+
knowly start
|
|
106
106
|
```
|
|
107
107
|
|
|
108
108
|
### 3. 查看状态
|
|
109
109
|
|
|
110
110
|
```bash
|
|
111
|
-
|
|
111
|
+
knowly status
|
|
112
112
|
```
|
|
113
113
|
|
|
114
114
|
### 4. 查看日志
|
|
115
115
|
|
|
116
116
|
```bash
|
|
117
|
-
|
|
118
|
-
|
|
117
|
+
knowly log # 查看日志
|
|
118
|
+
knowly log -f # 实时跟踪日志
|
|
119
119
|
```
|
|
120
120
|
|
|
121
121
|
## 命令
|
|
122
122
|
|
|
123
123
|
| 命令 | 说明 |
|
|
124
124
|
|------|------|
|
|
125
|
-
| `
|
|
126
|
-
| `
|
|
127
|
-
| `
|
|
128
|
-
| `
|
|
129
|
-
| `
|
|
130
|
-
| `
|
|
131
|
-
| `
|
|
132
|
-
| `
|
|
133
|
-
| `
|
|
125
|
+
| `knowly init` | 初始化配置 |
|
|
126
|
+
| `knowly start` | 启动守护进程 |
|
|
127
|
+
| `knowly stop` | 停止守护进程 |
|
|
128
|
+
| `knowly status` | 查看运行状态 |
|
|
129
|
+
| `knowly log` | 查看日志 |
|
|
130
|
+
| `knowly config` | 查看/编辑配置 |
|
|
131
|
+
| `knowly history [n]` | 查看最近 n 条同步记录(默认 20) |
|
|
132
|
+
| `knowly restore <id>` | 将指定记录回填到剪贴板 |
|
|
133
|
+
| `knowly service install` | 安装为 macOS 系统服务 |
|
|
134
134
|
|
|
135
135
|
## macOS 系统服务
|
|
136
136
|
|
|
137
|
-
安装为 LaunchAgent 后,
|
|
137
|
+
安装为 LaunchAgent 后,knowly 会在登录时自动启动,崩溃自动重启:
|
|
138
138
|
|
|
139
139
|
```bash
|
|
140
140
|
# 停止服务
|
|
141
|
-
launchctl unload ~/Library/LaunchAgents/com.
|
|
141
|
+
launchctl unload ~/Library/LaunchAgents/com.knowly.daemon.plist
|
|
142
142
|
|
|
143
143
|
# 启动服务
|
|
144
|
-
launchctl load ~/Library/LaunchAgents/com.
|
|
144
|
+
launchctl load ~/Library/LaunchAgents/com.knowly.daemon.plist
|
|
145
145
|
|
|
146
146
|
# 查看状态
|
|
147
|
-
launchctl list | grep
|
|
147
|
+
launchctl list | grep knowly
|
|
148
148
|
|
|
149
149
|
# 卸载服务(不再开机自启)
|
|
150
|
-
launchctl unload ~/Library/LaunchAgents/com.
|
|
151
|
-
rm ~/Library/LaunchAgents/com.
|
|
150
|
+
launchctl unload ~/Library/LaunchAgents/com.knowly.daemon.plist
|
|
151
|
+
rm ~/Library/LaunchAgents/com.knowly.daemon.plist
|
|
152
152
|
```
|
|
153
153
|
|
|
154
154
|
## 配置文件
|
|
155
155
|
|
|
156
|
-
配置文件位于 `~/.
|
|
156
|
+
配置文件位于 `~/.knowly/config.json`:
|
|
157
157
|
|
|
158
158
|
```json
|
|
159
159
|
{
|
|
@@ -162,7 +162,7 @@ rm ~/Library/LaunchAgents/com.knas.daemon.plist
|
|
|
162
162
|
"port": "22",
|
|
163
163
|
"user": "root",
|
|
164
164
|
"key_path": "~/.ssh/id_rsa",
|
|
165
|
-
"base_path": "~/
|
|
165
|
+
"base_path": "~/knowly_archive"
|
|
166
166
|
},
|
|
167
167
|
"clipboard": {
|
|
168
168
|
"min_length": 100,
|
|
@@ -181,11 +181,11 @@ rm ~/Library/LaunchAgents/com.knas.daemon.plist
|
|
|
181
181
|
|
|
182
182
|
同步的文件按以下结构存储:
|
|
183
183
|
|
|
184
|
-
```~/
|
|
184
|
+
```~/knowly_archive/
|
|
185
185
|
├── 2026/
|
|
186
186
|
│ ├── 04/
|
|
187
187
|
│ │ ├── 18/
|
|
188
|
-
│ │ │ ├──
|
|
188
|
+
│ │ │ ├── 133119_knowly_已成功运行.md <-- 语义化后缀
|
|
189
189
|
│ │ │ ├── 142545_关于量化交易的思.md
|
|
190
190
|
│ │ │ ├── 150405_image.png <-- 自动归档的截图
|
|
191
191
|
│ │ │ └── ...
|
|
@@ -235,18 +235,18 @@ source: clipboard
|
|
|
235
235
|
|
|
236
236
|
```bash
|
|
237
237
|
# 克隆仓库
|
|
238
|
-
git clone https://github.com/yuanguangshan/
|
|
239
|
-
cd
|
|
238
|
+
git clone https://github.com/yuanguangshan/knowly.git
|
|
239
|
+
cd knowly
|
|
240
240
|
|
|
241
241
|
# 安装 Go 依赖
|
|
242
242
|
go mod tidy
|
|
243
243
|
|
|
244
244
|
# 构建二进制文件
|
|
245
|
-
go build -o
|
|
245
|
+
go build -o knowly ./cmd/knowly
|
|
246
246
|
|
|
247
247
|
# 运行
|
|
248
|
-
./
|
|
249
|
-
./
|
|
248
|
+
./knowly init
|
|
249
|
+
./knowly start
|
|
250
250
|
```
|
|
251
251
|
|
|
252
252
|
## 注意事项
|
|
@@ -271,12 +271,12 @@ MIT
|
|
|
271
271
|
### 示例
|
|
272
272
|
```bash
|
|
273
273
|
# 查看最近 20 条同步记录
|
|
274
|
-
$
|
|
274
|
+
$ knowly history
|
|
275
275
|
[20260418184501_a1b2c3d4] (text) 关于量化交易的思考...
|
|
276
276
|
[20260418184430_e5f6g7h8] (image) [IMAGE] 102400 bytes
|
|
277
|
-
[20260418184315_i9j0k1l2] (text) https://github.com/yuanguangshan/
|
|
277
|
+
[20260418184315_i9j0k1l2] (text) https://github.com/yuanguangshan/knowly
|
|
278
278
|
|
|
279
279
|
# 找回被覆盖的文本
|
|
280
|
-
$
|
|
280
|
+
$ knowly restore 20260418184501_a1b2c3d4
|
|
281
281
|
✓ 已将记录 20260418184501_a1b2c3d4 恢复到剪贴板
|
|
282
282
|
```
|
package/bin/knas-darwin
ADDED
|
Binary file
|
|
Binary file
|
package/bin/knas-linux
ADDED
|
Binary file
|
package/bin/knowly-darwin
CHANGED
|
Binary file
|
package/bin/knowly-darwin-arm64
CHANGED
|
Binary file
|
package/bin/knowly-linux
CHANGED
|
Binary file
|