getnotes-cli 0.1.0__tar.gz → 0.1.1__tar.gz

{getnotes_cli-0.1.0 → getnotes_cli-0.1.1}/CHANGELOG.md

@@ -5,6 +5,13 @@
 此文件的格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
 并且本项目遵循 [语义化版本规范 (Semantic Versioning)](https://semver.org/spec/v2.0.0.html)。
 
+## [0.1.1] - 2026-02-27
+
+### 新增 (Added)
+- **创建笔记功能**：实现创建新笔记功能，支持图片上传并自动转换链接。提供 CLI 命令集成支持本地直接新建笔记。
+- **文档完善**：新增了有关知识库 (notebooks)、笔记 (notes) 以及 Agent 工作流 (AGENT.md) 的使用说明；添加了 GitHub 评论操作文档指南。
+- **发布配置更新**：优化与新增部分 GitHub Workflow 以支持自动化部署与评论。
+
 ## [0.1.0] - 2026-02-27
 
 这是 `getnotes-cli` 的首次发布版本，包含以下核心功能集锦：

getnotes_cli-0.1.0/README.md → getnotes_cli-0.1.1/PKG-INFO

@@ -1,3 +1,20 @@
+Metadata-Version: 2.4
+Name: getnotes-cli
+Version: 0.1.1
+Summary: Get 笔记 CLI 下载工具 — 自动登录、批量下载、Markdown 导出
+Author: Han Zhang
+License: MIT
+License-File: LICENSE
+Keywords: cli,download,getnotes,markdown,得到笔记
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: requests-toolbelt>=1.0.0
+Requires-Dist: requests>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: websocket-client>=1.6.0
+Description-Content-Type: text/markdown
+
 # getnotes-cli 🗂️
 
 > Get笔记 CLI 下载工具 — 自动登录、批量下载、知识库管理、Markdown 导出、录音图片等附件下载
@@ -9,6 +26,7 @@
 
 - 🔐 **自动登录** — 通过 Chrome DevTools Protocol 自动获取 Bearer token，无需手动抓包
 - 📥 **批量下载** — 分页拉取全部笔记，支持指定数量
+- 📤 **新建笔记** — 支持通过本地 Markdown 或文本文件创建笔记，并支持自动上传内嵌图片
 - 📚 **知识库管理** — 查看、下载我的知识库与订阅知识库
 - 📝 **Markdown 导出** — 每条笔记保存为 Markdown，包含元信息、标签、正文、引用内容
 - 🔊 **附件下载** — 自动下载音频、图片附件，并在 Markdown 中内嵌链接
@@ -40,6 +58,19 @@ getnotes login
 getnotes login --token "Bearer eyJhbGci..."
 ```
 
+### 新建笔记
+
+```bash
+# 从本地 Markdown 或文本文件创建得到笔记
+getnotes create --file my_note.md
+
+# 创建笔记并附带一张图片（图片将自动上传并追加到正文末尾）
+getnotes create -f my_note.md --image cover.jpg
+
+# 创建笔记并附带多张图片（多次指定 -i 或 --image 选项）
+getnotes create -f my_note.md -i img1.png -i img2.jpg
+```
+
 ### 下载笔记
 
 ```bash
@@ -162,6 +193,7 @@ getnotes --version
 
 # 查看帮助
 getnotes --help
+getnotes create --help
 getnotes download --help
 getnotes notebook --help
 getnotes subscribe --help
@@ -225,3 +257,7 @@ getnotes_export/
 - 已下载的附件不会重复下载（自动跳过）
 - 默认下载前 100 条用于调试，确认无误后使用 `--all` 下载全部
 - 知识库下载按知识库名称创建子目录，统一保存在 `notebooks/` 下
+
+## 🙏 致谢
+
+- 部分登录逻辑及设计参考自 [notebooklm-mcp-cli](https://github.com/jacob-bd/notebooklm-mcp-cli)。

getnotes_cli-0.1.0/PKG-INFO → getnotes_cli-0.1.1/README.md

@@ -1,18 +1,3 @@
-Metadata-Version: 2.4
-Name: getnotes-cli
-Version: 0.1.0
-Summary: 得到笔记 (GetNotes) CLI 下载工具 — 自动登录、批量下载、Markdown 导出
-Author: Han Zhang
-License: MIT
-License-File: LICENSE
-Keywords: cli,download,getnotes,markdown,得到笔记
-Requires-Python: >=3.10
-Requires-Dist: httpx>=0.27.0
-Requires-Dist: rich>=13.0.0
-Requires-Dist: typer>=0.9.0
-Requires-Dist: websocket-client>=1.6.0
-Description-Content-Type: text/markdown
-
 # getnotes-cli 🗂️
 
 > Get笔记 CLI 下载工具 — 自动登录、批量下载、知识库管理、Markdown 导出、录音图片等附件下载
@@ -24,6 +9,7 @@ Description-Content-Type: text/markdown
 
 - 🔐 **自动登录** — 通过 Chrome DevTools Protocol 自动获取 Bearer token，无需手动抓包
 - 📥 **批量下载** — 分页拉取全部笔记，支持指定数量
+- 📤 **新建笔记** — 支持通过本地 Markdown 或文本文件创建笔记，并支持自动上传内嵌图片
 - 📚 **知识库管理** — 查看、下载我的知识库与订阅知识库
 - 📝 **Markdown 导出** — 每条笔记保存为 Markdown，包含元信息、标签、正文、引用内容
 - 🔊 **附件下载** — 自动下载音频、图片附件，并在 Markdown 中内嵌链接
@@ -55,6 +41,19 @@ getnotes login
 getnotes login --token "Bearer eyJhbGci..."
 ```
 
+### 新建笔记
+
+```bash
+# 从本地 Markdown 或文本文件创建得到笔记
+getnotes create --file my_note.md
+
+# 创建笔记并附带一张图片（图片将自动上传并追加到正文末尾）
+getnotes create -f my_note.md --image cover.jpg
+
+# 创建笔记并附带多张图片（多次指定 -i 或 --image 选项）
+getnotes create -f my_note.md -i img1.png -i img2.jpg
+```
+
 ### 下载笔记
 
 ```bash
@@ -177,6 +176,7 @@ getnotes --version
 
 # 查看帮助
 getnotes --help
+getnotes create --help
 getnotes download --help
 getnotes notebook --help
 getnotes subscribe --help
@@ -240,3 +240,7 @@ getnotes_export/
 - 已下载的附件不会重复下载（自动跳过）
 - 默认下载前 100 条用于调试，确认无误后使用 `--all` 下载全部
 - 知识库下载按知识库名称创建子目录，统一保存在 `notebooks/` 下
+
+## 🙏 致谢
+
+- 部分登录逻辑及设计参考自 [notebooklm-mcp-cli](https://github.com/jacob-bd/notebooklm-mcp-cli)。

{getnotes_cli-0.1.0 → getnotes_cli-0.1.1}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "getnotes-cli"
-version = "0.1.0"
-description = "得到笔记 (GetNotes) CLI 下载工具 — 自动登录、批量下载、Markdown 导出"
+version = "0.1.1"
+description = "Get 笔记 CLI 下载工具 — 自动登录、批量下载、Markdown 导出"
 readme = "README.md"
 license = {text = "MIT"}
 requires-python = ">=3.10"
@@ -19,6 +19,8 @@ dependencies = [
     "rich>=13.0.0",
     "httpx>=0.27.0",
     "websocket-client>=1.6.0",
+    "requests-toolbelt>=1.0.0",
+    "requests>=2.0.0",
 ]
 
 [project.scripts]

{getnotes_cli-0.1.0 → getnotes_cli-0.1.1}/src/getnotes_cli/cli.py

@@ -58,6 +58,60 @@ def login(
         raise typer.Exit(1)
 
 
+# ========================================================================
+# create 命令
+# ========================================================================
+
+
+@app.command()
+def create(
+    file: Path = typer.Option(
+        ..., "--file", "-f",
+        exists=True, dir_okay=False, readable=True, resolve_path=True,
+        help="要创建为得到笔记的 Markdown 文件或文本文件",
+    ),
+    images: Optional[list[Path]] = typer.Option(
+        None, "--image", "-i",
+        exists=True, dir_okay=False, readable=True, resolve_path=True,
+        help="要上传并插入的图片文件（可多次指定），将追加到文本末尾",
+    ),
+    token: Optional[str] = typer.Option(
+        None, "--token", "-t",
+        help="直接传入 Bearer token（跳过缓存检查）",
+    ),
+) -> None:
+    """📝 创建笔记 — 从本地文件与图片发布得到笔记"""
+    from getnotes_cli.auth import get_or_refresh_token, login_with_token
+    from getnotes_cli.creator import NoteCreator
+
+    # 获取 token
+    if token:
+        auth = login_with_token(token)
+    else:
+        try:
+            auth = get_or_refresh_token()
+        except RuntimeError as e:
+            console.print(f"\n[red]✗[/red] {e}")
+            console.print("[dim]请先运行 `getnotes login` 登录。[/dim]")
+            raise typer.Exit(1)
+
+    text = file.read_text(encoding="utf-8")
+    creator = NoteCreator(auth)
+
+    console.print(f"[bold]📝 正在创建笔记: {file.name}[/bold]")
+    if images:
+        console.print(f"[dim]包含 {len(images)} 张图片待上传...[/dim]")
+
+    try:
+        data = creator.create_note(text, images)
+        console.print(f"\n[green]✓[/green] 创建笔记成功！")
+        console.print(f"  ID: {data.get('note_id', '')}")
+        console.print(f"  时间: {data.get('created_at', '')}")
+    except Exception as e:
+        console.print(f"\n[red]✗[/red] 创建失败: {e}")
+        raise typer.Exit(1)
+
+
 # ========================================================================
 # download 命令
 # ========================================================================

{getnotes_cli-0.1.0 → getnotes_cli-0.1.1}/src/getnotes_cli/config.py

@@ -12,6 +12,12 @@ NOTES_API_URL = "https://get-notes.luojilab.com/voicenotes/web/notes"
 # 知识库列表 API
 NOTEBOOKS_API_URL = "https://knowledge-api.trytalks.com/v1/web/topic/mine/list"
 
+# 创建笔记 API
+NOTE_CREATE_API_URL = "https://get-notes.luojilab.com/voicenotes/web/notes"
+
+# 获取图片上传 Token API
+IMAGE_TOKEN_API_URL = "https://get-notes.luojilab.com/voicenotes/web/token/image"
+
 # 订阅知识库列表 API
 SUBSCRIBE_NOTEBOOKS_API_URL = "https://knowledge-api.trytalks.com/v1/web/subscribe/topic/list"
 

getnotes_cli-0.1.1/src/getnotes_cli/creator.py

@@ -0,0 +1,178 @@
+"""笔记创建模块 — 处理图片上传与笔记发布"""
+
+import json
+from pathlib import Path
+from typing import Any
+
+import requests
+from requests_toolbelt.multipart.encoder import MultipartEncoder
+
+from getnotes_cli.auth import AuthToken
+from getnotes_cli.config import IMAGE_TOKEN_API_URL, NOTE_CREATE_API_URL
+
+class NoteCreator:
+    """笔记创建器，处理图片上传和笔记创建"""
+
+    def __init__(self, token: AuthToken):
+        self.token = token
+        self.headers = token.get_headers()
+
+    def _get_image_token(self, ext: str) -> dict[str, Any]:
+        """获取阿里云 OSS 上传凭证"""
+        payload = {"source": "web", "type": ext.lstrip(".")}
+        resp = requests.post(
+            IMAGE_TOKEN_API_URL,
+            headers=self.headers,
+            json=payload,
+            timeout=10,
+        )
+        resp.raise_for_status()
+        data = resp.json()
+        if data.get("h", {}).get("c") != 0:
+            raise RuntimeError(f"获取上传凭证失败: {data}")
+        # 返回第一条凭证
+        return data.get("c", [])[0]
+
+    def upload_image(self, image_path: Path) -> dict[str, Any]:
+        """上传图片到阿里云 OSS，返回图片信息（包含 access_url）"""
+        if not image_path.exists():
+            raise FileNotFoundError(f"图片不存在: {image_path}")
+
+        ext = image_path.suffix.lower()
+        if ext not in (".png", ".jpg", ".jpeg", ".gif", ".webp"):
+            raise ValueError(f"不支持的图片格式: {ext}")
+
+        # 1. 获取上传凭证
+        token_info = self._get_image_token(ext)
+        
+        # 2. 组装表单数据
+        # 阿里云 OSS 要求表单字段顺序：前面的参数，最后是 file
+        fields = {
+            "OSSAccessKeyId": token_info["accessid"],
+            "policy": token_info["policy"],
+            "Signature": token_info["signature"],
+            "key": token_info["object_key"],
+            "callback": token_info["callback"],
+            "success_action_status": "201",
+            "file": (image_path.name, open(image_path, "rb"), token_info.get("oss_content_type", f"image/{ext.lstrip('.')}")),
+        }
+
+        encoder = MultipartEncoder(fields=fields)
+        upload_headers = {
+            "Accept": "application/json, text/plain, */*",
+            "Content-Type": encoder.content_type,
+            "User-Agent": self.headers.get("User-Agent", ""),
+            "Origin": self.headers.get("Origin", ""),
+            "Referer": self.headers.get("Referer", ""),
+        }
+
+        # 3. 上传到 OSS
+        resp = requests.post(
+            token_info["host"],
+            headers=upload_headers,
+            data=encoder,
+            timeout=30,
+        )
+        resp.raise_for_status()
+        
+        # 得到笔记的 callback 返回的是 json
+        try:
+            callback_data = resp.json()
+            if callback_data.get("h", {}).get("c") != 0:
+                 raise RuntimeError(f"图片上传回调失败: {callback_data}")
+        except json.JSONDecodeError:
+             pass # 有时不会返回标准 json
+
+        return token_info
+
+    def _build_json_content(self, text: str, images: list[dict[str, Any]]) -> str:
+        """根据文本和图片构建 ProseMirror json_content"""
+        content_nodes = []
+        
+        # 文本段落
+        if text:
+            for paragraph in text.split("\\n"):
+                content_nodes.append({
+                    "type": "paragraph",
+                    "attrs": {"lineHeight": "100%", "textAlign": None, "class": "", "indent": 0},
+                    "content": [{"type": "text", "text": paragraph}] if paragraph else []
+                })
+        else:
+             content_nodes.append({
+                    "type": "paragraph",
+                    "attrs": {"lineHeight": "100%", "textAlign": None, "class": "", "indent": 0},
+             })
+             
+        # 图片节点
+        for img in images:
+            content_nodes.append({
+                "type": "image",
+                "attrs": {
+                    "commentIds": None,
+                    "class": "",
+                    "src": img["access_url"],
+                    "alt": "",
+                    "title": "",
+                    "width": 350,
+                    "height": "auto",
+                    "align": "left",
+                    "href": None,
+                    "target": None,
+                    "data-src": None,
+                    "loading": None
+                }
+            })
+            
+            # 图片后跟一个空段落
+            content_nodes.append({
+                "type": "paragraph",
+                "attrs": {"lineHeight": "100%", "textAlign": None, "class": None, "indent": 0}
+            })
+
+        json_content = {
+            "type": "doc",
+            "content": content_nodes
+        }
+        return json.dumps(json_content, ensure_ascii=False)
+
+    def create_note(self, text: str, image_paths: list[Path] = None) -> dict[str, Any]:
+        """创建笔记"""
+        image_paths = image_paths or []
+        uploaded_images = []
+        
+        # 1. 上传所有图片
+        for img_path in image_paths:
+            img_info = self.upload_image(img_path)
+            uploaded_images.append(img_info)
+
+        # 2. 组装纯文本 content（末尾添加图片 markdown 语法）
+        content = text
+        if uploaded_images:
+            content += "\\n\\n" + "\\n".join([f"![]({img['access_url']})" for img in uploaded_images])
+
+        # 3. 组装 json_content
+        json_content_str = self._build_json_content(text, uploaded_images)
+
+        # 4. 发送创建请求
+        payload = {
+            "title": "",
+            "content": content,
+            "json_content": json_content_str,
+            "entry_type": "manual",
+            "note_type": "plain_text",
+            "source": "web",
+            "tags": []
+        }
+
+        resp = requests.post(
+            NOTE_CREATE_API_URL,
+            headers=self.headers,
+            json=payload,
+            timeout=10,
+        )
+        resp.raise_for_status()
+        data = resp.json()
+        if data.get("h", {}).get("c") != 0:
+            raise RuntimeError(f"创建笔记失败: {data}")
+            
+        return data.get("c", {})