getnotes-cli 0.1.0__tar.gz

getnotes_cli-0.1.0/.agent/workflows/release.md

@@ -0,0 +1,71 @@
+---
+description: How to automate the release of getnotes-cli to PyPI
+---
+
+# Release Process
+
+// turbo-all
+
+## Steps
+
+1. Configure Python path and UV
+```bash
+export PATH="$HOME/.cargo/bin:$PATH"
+```
+
+2. Read the current version from pyproject.toml
+```bash
+CURRENT_VERSION=$(grep -m 1 '^version = ' pyproject.toml | cut -d '"' -f 2)
+echo "Current version is: $CURRENT_VERSION"
+```
+
+3. Ensure you're on the main branch and it's up to date
+```bash
+git checkout main
+git pull origin main
+```
+
+4. Ask the user for the new version number
+```bash
+# INTERACTIVE: Ask user for the new version number (e.g., 0.1.1)
+# Note: You can skip modifying the version and just use the CURRENT_VERSION
+```
+
+5. Bump version in pyproject.toml
+```bash
+# ONLY RUN THIS if the user provided a NEW_VERSION. Skip if using CURRENT_VERSION.
+# Replace NEW_VERSION with the version provided by the user
+NEW_VERSION="WAITING_FOR_USER"
+sed -i '' "s/version = \"$CURRENT_VERSION\"/version = \"$NEW_VERSION\"/" pyproject.toml
+```
+
+6. Update `CHANGELOG.md` with the new version entry (ask user for details if needed)
+
+7. Commit all changes:
+```bash
+# Set TARGET_VERSION based on user's choice
+# TARGET_VERSION=$NEW_VERSION or TARGET_VERSION=$CURRENT_VERSION
+TARGET_VERSION="WAITING_FOR_USER"
+git add pyproject.toml CHANGELOG.md
+git commit -m "chore: release v$TARGET_VERSION"
+```
+
+8. Push and tag:
+```bash
+git tag "v$TARGET_VERSION"
+git push origin main
+git push origin "v$TARGET_VERSION"
+```
+
+9. Create a GitHub release to trigger PyPI publish:
+```bash
+gh release create "v$TARGET_VERSION" --title "v$TARGET_VERSION" --generate-notes
+```
+
+## Checklist
+
+- [ ] Version bumped in `pyproject.toml` (if requested)
+- [ ] CHANGELOG updated
+- [ ] Committed and pushed
+- [ ] Tagged and pushed tag
+- [ ] GitHub release created (triggers PyPI publish via publish.yml)

getnotes_cli-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,31 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published] # 监听 GitHub Release 发布事件
+
+jobs:
+  pypi-publish:
+    name: Build & Publish Release to PyPI
+    runs-on: ubuntu-latest
+    
+    # 获取 OIDC Token 的必要权限，用于免密认证 PyPI
+    permissions:
+      id-token: write
+      contents: read
+    
+    steps:
+      - name: Checkout target repository
+        uses: actions/checkout@v4
+      
+      # 使用官方 action 安装最新版的 uv
+      - name: Install the latest version of uv
+        uses: astral-sh/setup-uv@v5
+
+      # 使用 uv 构建发版文件 (生成 .tar.gz 源码包和 .whl 二进制包)
+      - name: Build package
+        run: uv build
+
+      # 使用 PyPA 官方 action 发布到 PyPI
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

getnotes_cli-0.1.0/.gitignore

@@ -0,0 +1,16 @@
+# 缓存
+cache_manifest.json
+__pycache__/
+*.pyc
+
+# 环境
+.env
+.venv/
+venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store

getnotes_cli-0.1.0/CHANGELOG.md

@@ -0,0 +1,22 @@
+# 更新日志 (Changelog)
+
+本项目的所有重要更改都将统一记录在此文件中。
+
+此文件的格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
+并且本项目遵循 [语义化版本规范 (Semantic Versioning)](https://semver.org/spec/v2.0.0.html)。
+
+## [0.1.0] - 2026-02-27
+
+这是 `getnotes-cli` 的首次发布版本，包含以下核心功能集锦：
+
+### 新增 (Added)
+- **核心下载功能**：实现“得到笔记”的自动下载，统一将笔记保存为易于阅读的 Markdown 格式文档，并嵌入本地化保存的附件与图片。
+- **浏览器自动登录**：新增基于浏览器的登录功能，一键自动获取最新的认证请求头（Bearer tokens），无需繁杂的手动配置。
+- **多维度下载命令**：
+  - 支持普通笔记内容的拉取与组织（`download`, `download-all`）。
+  - 支持笔记订阅管理，支持列出已订阅的知识库、下载特定知识库以及一次性下载所有订阅知识库的笔记内容。
+- **配置持久化管理**：引入 CLI 配置模块（基于 `~/.getnotes-cli/config.json` 开发的 `settings.py`），支持对输出目录、请求延迟和单页拉取数量等参数进行个性化和持久化设置。
+- **精细化控制选项**：
+  - 新增 `--save-json` 参数，支持显式保存技术文件（例如，JSON 格式的 API 响应源数据），默认仅保存 Markdown 和相关附件文件以精简空间。
+  - 新增下载限额提示机制，当遭遇接口下载限制时智能提醒用户。
+- **性能优化机制**：内置深度的 API 请求和笔记处理缓存机制 (`cache_manifest.json`)，避免重复拉取和处理相同笔记带来的成本损耗，并同时修复了早期开发版本里本地笔记文件夹比对不准确导致重复下载的问题。

getnotes_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HanZhang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

getnotes_cli-0.1.0/PKG-INFO

@@ -0,0 +1,242 @@
+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 导出、录音图片等附件下载
+
+[![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://python.org)
+[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+## ✨ 功能
+
+- 🔐 **自动登录** — 通过 Chrome DevTools Protocol 自动获取 Bearer token，无需手动抓包
+- 📥 **批量下载** — 分页拉取全部笔记，支持指定数量
+- 📚 **知识库管理** — 查看、下载我的知识库与订阅知识库
+- 📝 **Markdown 导出** — 每条笔记保存为 Markdown，包含元信息、标签、正文、引用内容
+- 🔊 **附件下载** — 自动下载音频、图片附件，并在 Markdown 中内嵌链接
+- 💾 **缓存管理** — 自动跳过已下载且未变化的笔记，支持增量更新
+- 📁 **Markdown-only 模式** — 默认值保存 Markdown 和附件，不保存技术文件，可以通过选项开启
+- ⚙️ **持久化配置** — 通过 `config` 命令保存常用参数，无需每次重复输入
+- ⏱️ **可配置间隔** — 自定义请求间隔，避免频率限制
+- 📊 **自动索引** — 自动生成笔记索引文件 `INDEX.md`
+
+## 📦 安装
+
+```bash
+cd getnotes-cli
+pip install -e .
+```
+
+安装后即可全局使用 `getnotes` 命令。
+
+## 🚀 使用方法
+
+### 登录
+
+```bash
+# 自动浏览器登录（推荐）
+# 会打开 Chrome，导航到得到笔记页面，登录后自动捕获 token
+getnotes login
+
+# 手动输入 token（跳过浏览器）
+getnotes login --token "Bearer eyJhbGci..."
+```
+
+### 下载笔记
+
+```bash
+# 下载前 100 条笔记（默认）
+getnotes download
+
+# 下载全部笔记
+getnotes download --all
+
+# 自定义下载数量
+getnotes download --limit 50
+
+# 保存技术文件（默认不包含 JSON 等原始数据）
+getnotes download --save-json
+
+# 指定输出目录
+getnotes download --output ~/Desktop/my_notes
+
+# 调整请求间隔（秒）
+getnotes download --delay 1.0
+
+# 自定义每页拉取数量
+getnotes download --page-size 50
+
+# 强制重新下载，忽略缓存
+getnotes download --force
+
+# 组合使用
+getnotes download --all --save-json --delay 1.0
+
+# 直接传 token 下载（一步到位，跳过登录缓存）
+getnotes download --token "Bearer eyJhbGci..." --limit 20
+```
+
+### 知识库管理
+
+```bash
+# 查看所有知识库
+getnotes notebook list
+
+# 按名称下载指定知识库（模糊匹配）
+getnotes notebook download --name "读书笔记"
+
+# 按 ID 下载指定知识库
+getnotes notebook download --id abc123
+
+# 下载全部知识库
+getnotes notebook download-all
+
+# 带选项下载
+getnotes notebook download --name "读书" --save-json --delay 1.0
+getnotes notebook download-all --force --output ~/Desktop/notebooks
+```
+
+### 订阅知识库
+
+```bash
+# 查看所有已订阅的知识库
+getnotes subscribe list
+
+# 按名称下载指定订阅知识库
+getnotes subscribe download --name "某知识库"
+
+# 按 ID 下载
+getnotes subscribe download --id xyz789
+
+# 下载全部订阅知识库
+getnotes subscribe download-all
+
+# 带选项下载
+getnotes subscribe download --name "某知识库" --save-json --force
+getnotes subscribe download-all --delay 1.0 --output ~/Desktop/subscribed
+```
+
+### 缓存管理
+
+```bash
+# 查看缓存状态
+getnotes cache check
+
+# 清除缓存
+getnotes cache clear
+
+# 跳过确认提示
+getnotes cache clear --confirm
+```
+
+### 配置管理
+
+持久化常用参数，避免每次输入。参数优先级：**命令行参数 > 配置文件 > 默认值**。
+
+```bash
+# 设置默认输出目录
+getnotes config set output ~/Desktop/my_notes
+
+# 设置默认请求间隔
+getnotes config set delay 1.0
+
+# 设置每页拉取数量
+getnotes config set page-size 50
+
+# 查看所有配置
+getnotes config get
+
+# 查看某项配置
+getnotes config get output
+
+# 清除所有配置（恢复默认值）
+getnotes config reset
+
+# 跳过确认提示
+getnotes config reset --confirm
+```
+
+### 其他
+
+```bash
+# 查看版本
+getnotes --version
+
+# 查看帮助
+getnotes --help
+getnotes download --help
+getnotes notebook --help
+getnotes subscribe --help
+getnotes config --help
+```
+
+## 📁 输出目录结构
+
+默认输出到 `~/Downloads/getnotes_export/`：
+
+```
+getnotes_export/
+├── INDEX.md                          # 笔记索引
+├── api_responses/                    # 原始 API 响应 JSON
+│   ├── page_0001.json
+│   └── ...
+├── notes/                            # 个人笔记
+│   ├── 20260226_224958_发芽报告/
+│   │   ├── note.md                   # Markdown 笔记
+│   │   ├── note.json                 # 原始 JSON 数据
+│   │   └── attachments/              # 附件（按需创建）
+│   │       ├── attachment_1.mp3
+│   │       └── image_1.jpg
+│   └── ...
+└── notebooks/                        # 知识库笔记（包含我的知识库和订阅知识库）
+    ├── 读书笔记/                      # 按知识库名称分目录
+    │   ├── INDEX.md
+    │   ├── 20260226_笔记标题/
+    │   │   └── note.md
+    │   └── ...
+    └── 某订阅知识库/
+        ├── INDEX.md
+        └── ...
+```
+
+> 默认不会创建 `api_responses/` 目录和 `note.json` 文件。使用 `--save-json` 选项时才会保存这些技术文件。
+
+## 🔐 Token 管理
+
+- Token 通过 CDP（Chrome DevTools Protocol）自动获取
+- 缓存在 `~/.getnotes-cli/auth.json`
+- 得到 Token 约 30 分钟有效，过期后自动提示重新登录
+- 也支持 `--token` 参数手动传入
+
+## ⚙️ 配置文件
+
+用户配置保存在 `~/.getnotes-cli/config.json`，支持以下配置项：
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| `output` | string | `~/Downloads/getnotes_export` | 默认输出目录 |
+| `delay` | float | `0.5` | 请求间隔（秒） |
+| `page-size` | int | `20` | 每页拉取数量 |
+
+*注：缓存清单文件 `cache_manifest.json` 也会统一保存在此目录。*
+
+## ⚠️ 注意事项
+
+- 首次使用请先运行 `getnotes login` 登录
+- 附件 URL 中的签名有过期时间，建议一次性下载完成
+- 已下载的附件不会重复下载（自动跳过）
+- 默认下载前 100 条用于调试，确认无误后使用 `--all` 下载全部
+- 知识库下载按知识库名称创建子目录，统一保存在 `notebooks/` 下

getnotes_cli-0.1.0/README.md

@@ -0,0 +1,227 @@
+# getnotes-cli 🗂️
+
+> Get笔记 CLI 下载工具 — 自动登录、批量下载、知识库管理、Markdown 导出、录音图片等附件下载
+
+[![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://python.org)
+[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+## ✨ 功能
+
+- 🔐 **自动登录** — 通过 Chrome DevTools Protocol 自动获取 Bearer token，无需手动抓包
+- 📥 **批量下载** — 分页拉取全部笔记，支持指定数量
+- 📚 **知识库管理** — 查看、下载我的知识库与订阅知识库
+- 📝 **Markdown 导出** — 每条笔记保存为 Markdown，包含元信息、标签、正文、引用内容
+- 🔊 **附件下载** — 自动下载音频、图片附件，并在 Markdown 中内嵌链接
+- 💾 **缓存管理** — 自动跳过已下载且未变化的笔记，支持增量更新
+- 📁 **Markdown-only 模式** — 默认值保存 Markdown 和附件，不保存技术文件，可以通过选项开启
+- ⚙️ **持久化配置** — 通过 `config` 命令保存常用参数，无需每次重复输入
+- ⏱️ **可配置间隔** — 自定义请求间隔，避免频率限制
+- 📊 **自动索引** — 自动生成笔记索引文件 `INDEX.md`
+
+## 📦 安装
+
+```bash
+cd getnotes-cli
+pip install -e .
+```
+
+安装后即可全局使用 `getnotes` 命令。
+
+## 🚀 使用方法
+
+### 登录
+
+```bash
+# 自动浏览器登录（推荐）
+# 会打开 Chrome，导航到得到笔记页面，登录后自动捕获 token
+getnotes login
+
+# 手动输入 token（跳过浏览器）
+getnotes login --token "Bearer eyJhbGci..."
+```
+
+### 下载笔记
+
+```bash
+# 下载前 100 条笔记（默认）
+getnotes download
+
+# 下载全部笔记
+getnotes download --all
+
+# 自定义下载数量
+getnotes download --limit 50
+
+# 保存技术文件（默认不包含 JSON 等原始数据）
+getnotes download --save-json
+
+# 指定输出目录
+getnotes download --output ~/Desktop/my_notes
+
+# 调整请求间隔（秒）
+getnotes download --delay 1.0
+
+# 自定义每页拉取数量
+getnotes download --page-size 50
+
+# 强制重新下载，忽略缓存
+getnotes download --force
+
+# 组合使用
+getnotes download --all --save-json --delay 1.0
+
+# 直接传 token 下载（一步到位，跳过登录缓存）
+getnotes download --token "Bearer eyJhbGci..." --limit 20
+```
+
+### 知识库管理
+
+```bash
+# 查看所有知识库
+getnotes notebook list
+
+# 按名称下载指定知识库（模糊匹配）
+getnotes notebook download --name "读书笔记"
+
+# 按 ID 下载指定知识库
+getnotes notebook download --id abc123
+
+# 下载全部知识库
+getnotes notebook download-all
+
+# 带选项下载
+getnotes notebook download --name "读书" --save-json --delay 1.0
+getnotes notebook download-all --force --output ~/Desktop/notebooks
+```
+
+### 订阅知识库
+
+```bash
+# 查看所有已订阅的知识库
+getnotes subscribe list
+
+# 按名称下载指定订阅知识库
+getnotes subscribe download --name "某知识库"
+
+# 按 ID 下载
+getnotes subscribe download --id xyz789
+
+# 下载全部订阅知识库
+getnotes subscribe download-all
+
+# 带选项下载
+getnotes subscribe download --name "某知识库" --save-json --force
+getnotes subscribe download-all --delay 1.0 --output ~/Desktop/subscribed
+```
+
+### 缓存管理
+
+```bash
+# 查看缓存状态
+getnotes cache check
+
+# 清除缓存
+getnotes cache clear
+
+# 跳过确认提示
+getnotes cache clear --confirm
+```
+
+### 配置管理
+
+持久化常用参数，避免每次输入。参数优先级：**命令行参数 > 配置文件 > 默认值**。
+
+```bash
+# 设置默认输出目录
+getnotes config set output ~/Desktop/my_notes
+
+# 设置默认请求间隔
+getnotes config set delay 1.0
+
+# 设置每页拉取数量
+getnotes config set page-size 50
+
+# 查看所有配置
+getnotes config get
+
+# 查看某项配置
+getnotes config get output
+
+# 清除所有配置（恢复默认值）
+getnotes config reset
+
+# 跳过确认提示
+getnotes config reset --confirm
+```
+
+### 其他
+
+```bash
+# 查看版本
+getnotes --version
+
+# 查看帮助
+getnotes --help
+getnotes download --help
+getnotes notebook --help
+getnotes subscribe --help
+getnotes config --help
+```
+
+## 📁 输出目录结构
+
+默认输出到 `~/Downloads/getnotes_export/`：
+
+```
+getnotes_export/
+├── INDEX.md                          # 笔记索引
+├── api_responses/                    # 原始 API 响应 JSON
+│   ├── page_0001.json
+│   └── ...
+├── notes/                            # 个人笔记
+│   ├── 20260226_224958_发芽报告/
+│   │   ├── note.md                   # Markdown 笔记
+│   │   ├── note.json                 # 原始 JSON 数据
+│   │   └── attachments/              # 附件（按需创建）
+│   │       ├── attachment_1.mp3
+│   │       └── image_1.jpg
+│   └── ...
+└── notebooks/                        # 知识库笔记（包含我的知识库和订阅知识库）
+    ├── 读书笔记/                      # 按知识库名称分目录
+    │   ├── INDEX.md
+    │   ├── 20260226_笔记标题/
+    │   │   └── note.md
+    │   └── ...
+    └── 某订阅知识库/
+        ├── INDEX.md
+        └── ...
+```
+
+> 默认不会创建 `api_responses/` 目录和 `note.json` 文件。使用 `--save-json` 选项时才会保存这些技术文件。
+
+## 🔐 Token 管理
+
+- Token 通过 CDP（Chrome DevTools Protocol）自动获取
+- 缓存在 `~/.getnotes-cli/auth.json`
+- 得到 Token 约 30 分钟有效，过期后自动提示重新登录
+- 也支持 `--token` 参数手动传入
+
+## ⚙️ 配置文件
+
+用户配置保存在 `~/.getnotes-cli/config.json`，支持以下配置项：
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| `output` | string | `~/Downloads/getnotes_export` | 默认输出目录 |
+| `delay` | float | `0.5` | 请求间隔（秒） |
+| `page-size` | int | `20` | 每页拉取数量 |
+
+*注：缓存清单文件 `cache_manifest.json` 也会统一保存在此目录。*
+
+## ⚠️ 注意事项
+
+- 首次使用请先运行 `getnotes login` 登录
+- 附件 URL 中的签名有过期时间，建议一次性下载完成
+- 已下载的附件不会重复下载（自动跳过）
+- 默认下载前 100 条用于调试，确认无误后使用 `--all` 下载全部
+- 知识库下载按知识库名称创建子目录，统一保存在 `notebooks/` 下

getnotes_cli-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "getnotes-cli"
+version = "0.1.0"
+description = "得到笔记 (GetNotes) CLI 下载工具 — 自动登录、批量下载、Markdown 导出"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+authors = [
+    { name = "Han Zhang" }
+]
+keywords = ["getnotes", "得到笔记", "cli", "download", "markdown"]
+
+dependencies = [
+    "typer>=0.9.0",
+    "rich>=13.0.0",
+    "httpx>=0.27.0",
+    "websocket-client>=1.6.0",
+]
+
+[project.scripts]
+getnotes = "getnotes_cli.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/getnotes_cli"]

getnotes_cli-0.1.0/src/getnotes_cli/__init__.py

@@ -0,0 +1,3 @@
+"""getnotes-cli — 得到笔记 CLI 下载工具"""
+
+__version__ = "0.1.0"