@getnote/cli 1.0.16 → 1.1.1

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/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 iswalle
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@getnote/cli",
3
- "version": "1.0.16",
3
+ "version": "1.1.1",
4
4
  "description": "CLI tool for Get笔记 — manage notes and knowledge bases from the terminal",
5
5
  "keywords": [
6
6
  "getnote",
@@ -193,6 +193,25 @@ getnote kb live vnrOAaGY live_abc123 -o json
193
193
 
194
194
  ---
195
195
 
196
+ ### Follow a live channel in a knowledge base
197
+
198
+ ```
199
+ getnote kb live-follow <topic_id> <link> [--platform <platform>]
200
+ ```
201
+
202
+ Subscribes a Dedao live channel to a knowledge base. Once the live session ends and is AI-processed, it will appear in `kb lives`.
203
+
204
+ > ⚠️ Currently only Dedao App live links are supported.
205
+
206
+ ```bash
207
+ getnote kb live-follow vnrOAaGY https://m.dedao.cn/live/xxxxx
208
+ getnote kb live-follow vnrOAaGY https://m.dedao.cn/live/xxxxx -o json
209
+ ```
210
+
211
+ Returns: `follow_id`, `url`, `platform`, `type`, `created_at`.
212
+
213
+ ---
214
+
196
215
  ### Show API quota usage
197
216
 
198
217
  ```
@@ -217,5 +236,6 @@ getnote quota -o json
217
236
  - **Subscribed KBs are read-only** unless the user is an admin of that KB. `kb add` / `kb remove` will return an API error on subscribed KBs owned by others. Use `getnote kbs` (owned) vs `getnote kbs-sub` (subscribed) to distinguish.
218
237
  - `kb bloggers` → get `follow_id` → `kb blogger-contents` → get `post_id_alias` → `kb blogger-content` for full text.
219
238
  - `kb lives` → get `live_id` → `kb live` for AI summary + transcript.
239
+ - `kb live-follow <topic_id> <link>` to subscribe a live channel; newly finished lives will appear in `kb lives`.
220
240
  - `quota -o json` returns `{"success":true,"data":{"read":{"daily":{limit,used,remaining,reset_at},"monthly":{...}},"write":{...},"write_note":{...}}}`
221
241
  - Exit code `0` = success; non-zero = error. Error details go to stderr.
@@ -25,7 +25,10 @@ getnote save <url|text|image_path> [--title <title>] [--tag <tag>]...
25
25
  | `--title` | Optional title |
26
26
  | `--tag` | Tag to apply; may be repeated |
27
27
 
28
- - URL (`http://` or `https://`) → link note (async, auto-polls until done)
28
+ - URL (`http://` or `https://`) → link note:
29
+ - **Share link** (`biji.com/note/share_note/*` or `d.biji.com/*` short link) → **sync**, returns `note_id` directly, no polling needed
30
+ - **Internal note link** (`biji.com/note/{note_id}`) → this is the format for linking to another note inside note content; use it in `content` field when referencing other notes. If the current note will be shared publicly, prefer using the referenced note's share link (`getnote note share <id>`) instead of the internal link format
31
+ - **Other URLs** → async, auto-polls until done
29
32
  - Local image path → image note (async, auto-polls until done)
30
33
  - Otherwise → text note (sync)
31
34
 
@@ -143,12 +146,31 @@ getnote note delete 1234567890 -y
143
146
 
144
147
  ---
145
148
 
149
+ ### Share a note
150
+
151
+ ```
152
+ getnote note share <id> [--exclude-audio]
153
+ ```
154
+
155
+ Generates a public share link for a note. Idempotent — calling multiple times returns the same URL.
156
+
157
+ ```bash
158
+ getnote note share 1234567890
159
+ getnote note share 1234567890 --exclude-audio
160
+ getnote note share 1234567890 -o json
161
+ ```
162
+
163
+ Returns: `share_url` (e.g. `https://biji.com/note/share_note/rBzdMlXrzgYVM`)
164
+
165
+ ---
166
+
146
167
  ## Agent Usage Notes
147
168
 
148
169
  - Use `-o json` when parsing responses programmatically.
149
170
  - All JSON responses follow `{"success":true,"data":{...}}` structure, **except**:
150
171
  - `save` (text): returns `{"note_id":"..."}` directly
151
- - `save` (link/image): returns `{"data":{"tasks":[{"task_id":"..."}],...}}`
172
+ - `save` (share link): returns `{"note_id":"...","title":"...","created_at":"...","updated_at":"..."}` directly
173
+ - `save` (regular link/image): returns `{"data":{"tasks":[{"task_id":"..."}],...}}`
152
174
  - `task`: returns `{"success":true,"data":{"status":"...","note_id":"..."}}`
153
175
  - `notes` list returns **20 per page** (no `--limit`); paginate with `--since-id`.
154
176
  - Note IDs are int64 — always handle as strings to avoid precision loss in JavaScript.