bilinote-cli 0.1.0__tar.gz → 0.1.2__tar.gz

{bilinote_cli-0.1.0 → bilinote_cli-0.1.2}/.gitignore

@@ -1,5 +1,7 @@
 # macOS
 .DS_Store
+publish.sh
+TODO.md
 
 # Python
 __pycache__/

bilinote_cli-0.1.2/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## \[0.1.1] - 2026-05-15
+
+### Added
+
+- 首次发布至 PyPI
+

{bilinote_cli-0.1.0 → bilinote_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bilinote-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: AI 视频笔记生成 CLI 工具
 License-File: LICENSE
 Requires-Python: >=3.12
@@ -25,7 +25,7 @@ Description-Content-Type: text/markdown
 AI 视频笔记生成工具 - 让 AI 为你的视频做笔记
 
 > **项目说明**：本项目基于 [BiliNote](https://github.com/JefferyHcool/BiliNote) fork 并进行大量重构。  
-> 原项目采用 MIT 许可证，感谢原作者 Jeffery Huang 的杰出工作。
+> 感谢原作者 Jeffery Huang 的杰出工作。
 
 
 ## 功能
@@ -40,8 +40,7 @@ AI 视频笔记生成工具 - 让 AI 为你的视频做笔记
 
 ```bash
 # 安装 CLI
-cd BiliNote-cli
-uv tool install .
+uv tool install bilinote-cli
 
 # 安装 FFmpeg（必需）
 brew install ffmpeg  # macOS
@@ -63,21 +62,14 @@ bilinote config list
 ```
 
 
-非敏感配置在 `~/.bilinote/config.yaml`：
+其他配置在 `~/.bilinote/config.yaml`：
+- windows： `C:\Users\<user_name>\.bilinote\config.yaml`
 ```yaml
 transcriber:
   default_type: "bcut" # 默认音频转写器
   whisper_model_size: "base"
 ```
 
-### 【教程】提取 Safari Cookie
-
-1. 打开 Safari 的开发者模式。
-2. 在浏览器中打开目标网站，按 F12（或 Cmd + Opt + I）打开开发者工具。
-3. 切换到 **Network (网络)** 标签页。
-4. 刷新页面，随便找一个请求，**右键**点击该请求。
-5. 选择 **Copy** -> **Copy as cURL**。
-6. 在你的剪贴板里，你会看到一串完整的命令，其中 `-H 'cookie: ...'` 后面就是该网站的所有 Cookie。
 
 ## 使用
 
@@ -85,6 +77,9 @@ transcriber:
 # 基础用法
 bilinote process "https://www.bilibili.com/video/BV1mQ9jBcEf4"
 
+# 批量处理
+bilinote process "<url1>" "<url2>"
+
 # 带截图和链接
 bilinote process "<url>" --screenshot --link --style 学术风
 
@@ -100,6 +95,21 @@ bilinote search "Python 教程" --platform bilibili
 # 其他命令
 bilinote model-list            # 列出可用模型
 bilinote model-set-default deepseek  # 设置默认模型
+bilinote check # 检查环境（ffmpeg、LLM可用性）
+bilinote install-shortcut # 安装 macOS 快捷指令（推荐）
+```
+
+## 目录结构
+
+```bash
+~/.bilinote/ #windows： C:\Users\<user_name>\.bilinote\
+├── data/
+│   ├── downloads/     # 下载的音频
+│   ├── cache/         # 转写缓存
+│   ├── output/notes/  # 生成的笔记★
+│   └── state/         # 任务状态
+├── config.yaml        # 用户配置★
+└── logs/
 ```
 
 ## 命令说明
@@ -112,6 +122,8 @@ bilinote model-set-default deepseek  # 设置默认模型
 | `model-set-default <model>` | 设置默认模型 |
 | `config set <key> <value>` | 设置密钥 |
 | `config list` | 查看配置状态 |
+| `install-shortcut` |  安装快捷指令（仅限 macOS） |
+| `check` |  环境检查 |
 
 ### process 参数
 
@@ -123,20 +135,26 @@ bilinote model-set-default deepseek  # 设置默认模型
 | `--link` | 插入视频跳转链接 |
 | `--style` | 笔记风格：学术风、口语风等 |
 | `--video-understanding` | 启用多模态理解 |
-| `--output` | 输出文件路径 |
+| `--output-dir` | 输出目录路径 |
 
-## 目录结构
+## 【指南】提取 Safari Cookie
+
+1. 打开 Safari 的开发者模式。
+2. 在浏览器中打开目标网站，按 F12（或 Cmd + Opt + I）打开开发者工具。
+3. 切换到 **Network (网络)** 标签页。
+4. 刷新页面，随便找一个请求，**右键**点击该请求。
+5. 选择 **Copy** -> **Copy as cURL**。
+6. 在你的剪贴板里，你会看到一串完整的命令，其中 `-H 'cookie: ...'` 后面就是该网站的所有 Cookie。
+
+
+## 【指南】使用快捷指令一键运行（仅限 macOS）
+**安装快捷指令**：终端运行 `bilinote install-shortcut`
+
+**使用方式**：
+1. 浏览器内点击网址栏，选择到 B 站视频链接的网址文本。
+2. 点击菜单栏（屏幕左上角）的浏览器 App 名称（如“Safari”）。
+3. 点击【服务】 -> 【BiliNote】 
 
-```bash
-~/.bilinote/ #windows： C:\Users\<user_name>\.bilinote\
-├── data/
-│   ├── downloads/     # 下载的音频
-│   ├── cache/         # 转写缓存
-│   ├── output/notes/  # 生成的笔记★
-│   └── state/         # 任务状态
-├── config.yaml        # 用户配置★
-└── logs/
-```
 
 ## 【指南】配置 whisper-cpp 作为本地音频转写器
 

{bilinote_cli-0.1.0 → bilinote_cli-0.1.2}/README.md

@@ -4,7 +4,7 @@
 AI 视频笔记生成工具 - 让 AI 为你的视频做笔记
 
 > **项目说明**：本项目基于 [BiliNote](https://github.com/JefferyHcool/BiliNote) fork 并进行大量重构。  
-> 原项目采用 MIT 许可证，感谢原作者 Jeffery Huang 的杰出工作。
+> 感谢原作者 Jeffery Huang 的杰出工作。
 
 
 ## 功能
@@ -19,8 +19,7 @@ AI 视频笔记生成工具 - 让 AI 为你的视频做笔记
 
 ```bash
 # 安装 CLI
-cd BiliNote-cli
-uv tool install .
+uv tool install bilinote-cli
 
 # 安装 FFmpeg（必需）
 brew install ffmpeg  # macOS
@@ -42,21 +41,14 @@ bilinote config list
 ```
 
 
-非敏感配置在 `~/.bilinote/config.yaml`：
+其他配置在 `~/.bilinote/config.yaml`：
+- windows： `C:\Users\<user_name>\.bilinote\config.yaml`
 ```yaml
 transcriber:
   default_type: "bcut" # 默认音频转写器
   whisper_model_size: "base"
 ```
 
-### 【教程】提取 Safari Cookie
-
-1. 打开 Safari 的开发者模式。
-2. 在浏览器中打开目标网站，按 F12（或 Cmd + Opt + I）打开开发者工具。
-3. 切换到 **Network (网络)** 标签页。
-4. 刷新页面，随便找一个请求，**右键**点击该请求。
-5. 选择 **Copy** -> **Copy as cURL**。
-6. 在你的剪贴板里，你会看到一串完整的命令，其中 `-H 'cookie: ...'` 后面就是该网站的所有 Cookie。
 
 ## 使用
 
@@ -64,6 +56,9 @@ transcriber:
 # 基础用法
 bilinote process "https://www.bilibili.com/video/BV1mQ9jBcEf4"
 
+# 批量处理
+bilinote process "<url1>" "<url2>"
+
 # 带截图和链接
 bilinote process "<url>" --screenshot --link --style 学术风
 
@@ -79,6 +74,21 @@ bilinote search "Python 教程" --platform bilibili
 # 其他命令
 bilinote model-list            # 列出可用模型
 bilinote model-set-default deepseek  # 设置默认模型
+bilinote check # 检查环境（ffmpeg、LLM可用性）
+bilinote install-shortcut # 安装 macOS 快捷指令（推荐）
+```
+
+## 目录结构
+
+```bash
+~/.bilinote/ #windows： C:\Users\<user_name>\.bilinote\
+├── data/
+│   ├── downloads/     # 下载的音频
+│   ├── cache/         # 转写缓存
+│   ├── output/notes/  # 生成的笔记★
+│   └── state/         # 任务状态
+├── config.yaml        # 用户配置★
+└── logs/
 ```
 
 ## 命令说明
@@ -91,6 +101,8 @@ bilinote model-set-default deepseek  # 设置默认模型
 | `model-set-default <model>` | 设置默认模型 |
 | `config set <key> <value>` | 设置密钥 |
 | `config list` | 查看配置状态 |
+| `install-shortcut` |  安装快捷指令（仅限 macOS） |
+| `check` |  环境检查 |
 
 ### process 参数
 
@@ -102,20 +114,26 @@ bilinote model-set-default deepseek  # 设置默认模型
 | `--link` | 插入视频跳转链接 |
 | `--style` | 笔记风格：学术风、口语风等 |
 | `--video-understanding` | 启用多模态理解 |
-| `--output` | 输出文件路径 |
+| `--output-dir` | 输出目录路径 |
 
-## 目录结构
+## 【指南】提取 Safari Cookie
+
+1. 打开 Safari 的开发者模式。
+2. 在浏览器中打开目标网站，按 F12（或 Cmd + Opt + I）打开开发者工具。
+3. 切换到 **Network (网络)** 标签页。
+4. 刷新页面，随便找一个请求，**右键**点击该请求。
+5. 选择 **Copy** -> **Copy as cURL**。
+6. 在你的剪贴板里，你会看到一串完整的命令，其中 `-H 'cookie: ...'` 后面就是该网站的所有 Cookie。
+
+
+## 【指南】使用快捷指令一键运行（仅限 macOS）
+**安装快捷指令**：终端运行 `bilinote install-shortcut`
+
+**使用方式**：
+1. 浏览器内点击网址栏，选择到 B 站视频链接的网址文本。
+2. 点击菜单栏（屏幕左上角）的浏览器 App 名称（如“Safari”）。
+3. 点击【服务】 -> 【BiliNote】 
 
-```bash
-~/.bilinote/ #windows： C:\Users\<user_name>\.bilinote\
-├── data/
-│   ├── downloads/     # 下载的音频
-│   ├── cache/         # 转写缓存
-│   ├── output/notes/  # 生成的笔记★
-│   └── state/         # 任务状态
-├── config.yaml        # 用户配置★
-└── logs/
-```
 
 ## 【指南】配置 whisper-cpp 作为本地音频转写器
 

bilinote_cli-0.1.2/publish.command

@@ -0,0 +1,72 @@
+set -e
+
+# ---------- 用户配置 ----------
+VERSION="0.1.2"
+
+# CHANGELOG 分类包括：Added Changed Removed Fixed Security
+
+CHANGELOG="### Changed
+- search 指令后的批量记笔记功能，支持并行处理
+"
+
+cd "$(dirname "$0")"
+
+# 检查 CHANGELOG 和版本是否已存在
+if [ -f CHANGELOG.md ]; then
+    if grep -q "^## \[${VERSION}\]" CHANGELOG.md; then
+        echo "版本已存在，跳过"
+        exit 0
+    fi
+else
+    echo "# Changelog" > CHANGELOG.md
+fi
+
+
+# ---------- 自动修改 pyproject.toml ----------
+if [ ! -f pyproject.toml ]; then
+    echo "错误：当前目录没有 pyproject.toml"
+    exit 1
+fi
+
+# 替换 version 字段
+grep -q "^version" pyproject.toml || { echo "Error: 'version' line not found in pyproject.toml" >&2; exit 1; }
+sed -i.bak -E "s/^version.*/version = \"${VERSION}\"/" pyproject.toml
+
+rm -f pyproject.toml.bak  # 删除备份文件
+
+echo "✓ pyproject.toml 版本号已更新为 ${VERSION}"
+
+# ---------- 自动更新 CHANGELOG.md ----------
+DATE=$(date +%Y-%m-%d)
+NEW_ENTRY="## [${VERSION}] - ${DATE}"$'\n'"${CHANGELOG}"
+
+
+# 使用 awk 在第一个 "## [数字" 行之前插入新条目（前后空行）
+awk -v new_entry="$NEW_ENTRY" '
+BEGIN { inserted = 0 }
+/^## \[[0-9]/ && !inserted {
+    # 在匹配行之前先打印新条目（前后加空行）
+    print ""
+    print new_entry
+    print ""
+    inserted = 1
+}
+{ print }
+END {
+    # 如果没有匹配到任何版本标题，则在末尾追加新条目
+    if (!inserted) {
+        print ""
+        print new_entry
+        print ""
+    }
+}' CHANGELOG.md > CHANGELOG.md.tmp && mv CHANGELOG.md.tmp CHANGELOG.md
+
+
+echo "✓ CHANGELOG.md 已添加 ${VERSION} 版本的更新记录"
+
+# ---------- 原有发布流程 ----------
+rm -rf dist/
+uv build
+ls dist/
+export UV_PUBLISH_TOKEN="pypi-AgEIcHlwaS5vcmcCJGM1M2U5NThjLWQ4NTctNDBlNy04NDFhLTUzMTM4NTk0OTU2NwACFFsxLFsiYmlsaW5vdGUtY2xpIl1dAAIsWzIsWyJmN2Y4MzczOC1lMzlkLTQyOTgtODMyMS1mMTkxM2JhMDQxZDYiXV0AAAYg4oFE7cnbCFM5fV6HOB10sNzaBk84MYhbnZ6MWaT7Cu8"
+uv publish

{bilinote_cli-0.1.0 → bilinote_cli-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "bilinote-cli"
-version = "0.1.0"
+version = "0.1.2"
 description = "AI 视频笔记生成 CLI 工具"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -30,6 +30,9 @@ bilinote = "src.cli:main"
 [tool.hatch.build.targets.wheel]
 packages = ["src"]
 
+[tool.hatch.build.targets.wheel.force-include]
+"BiliNote.shortcut" = "src/BiliNote.shortcut"
+
 [dependency-groups]
 dev = [
     "deptry>=0.25.1",

bilinote_cli-0.1.2/src/app/gpt/provider/OpenAI_compatible_provider.py

@@ -0,0 +1,35 @@
+from typing import Optional, Union
+
+from openai import OpenAI
+
+from app.utils.logger import get_logger
+
+logging= get_logger(__name__)
+class OpenAICompatibleProvider:
+    def __init__(self, api_key: str, base_url: str, model: Union[str, None]=None):
+        self.client = OpenAI(api_key=api_key, base_url=base_url)
+        self.model = model
+
+    @property
+    def get_client(self):
+        return self.client
+
+    @staticmethod
+    def test_connection(api_key: str, base_url: str, model_name: str) -> tuple[bool, str]:
+        """
+        轻量级连通性测试：发送一条最小 chat 请求验证 Key/服务/模型名是否有效。
+        返回 (是否成功, 错误描述)。
+        """
+        try:
+            client = OpenAI(api_key=api_key, base_url=base_url)
+            client.chat.completions.create(
+                model=model_name,
+                messages=[{"role": "user", "content": "ok"}],
+                max_tokens=1,
+            )
+            logging.info("连通性测试成功")
+            return True, ""
+        except Exception as e:
+            error_str = str(e)
+            logging.info(f"连通性测试失败：{error_str}")
+            return False, error_str

bilinote_cli-0.1.2/src/app/models/process_config.py

@@ -0,0 +1,52 @@
+"""ProcessConfig - CLI 处理参数配置，统一替代手工参数拆解"""
+
+from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
+
+from app.enmus.note_enums import DownloadQuality
+
+
+class ProcessConfig(BaseModel):
+    """处理参数配置包。
+
+    收拢 CLI ``process`` / ``search`` 子命令的所有共享参数，
+    通过 ``ProcessConfig(**vars(args))`` 一键从 argparse namespace 转换。
+    """
+
+    model_config = ConfigDict(extra="ignore")
+
+    quality: DownloadQuality = Field(default=DownloadQuality.medium)
+    screenshot: bool = False
+    link: bool = False
+    style: str | None = None
+    format: list[str] = Field(default_factory=list)
+    video_understanding: bool = False
+    video_interval: int = 0
+    grid_size: list[int] | None = None
+    no_subtitle: bool = False
+    extras: str | None = None
+
+    @field_validator("quality", mode="before")
+    @classmethod
+    def parse_quality(cls, v: object) -> DownloadQuality:
+        if isinstance(v, DownloadQuality):
+            return v
+        if isinstance(v, str):
+            mapping = {
+                "fast": DownloadQuality.fast,
+                "medium": DownloadQuality.medium,
+                "slow": DownloadQuality.slow,
+            }
+            if v in mapping:
+                return mapping[v]
+        return DownloadQuality.medium
+
+    @model_validator(mode="after")
+    def sync_format_from_flags(self):
+        """将 screenshot/link 布尔标志同步到 format 列表"""
+        fmt = list(self.format) if self.format else []
+        if self.screenshot and "screenshot" not in fmt:
+            fmt.append("screenshot")
+        if self.link and "link" not in fmt:
+            fmt.append("link")
+        self.format = fmt
+        return self

{bilinote_cli-0.1.0 → bilinote_cli-0.1.2}/src/app/services/note.py

@@ -7,6 +7,7 @@ from app.enmus.note_enums import DownloadQuality
 from app.enmus.task_status_enums import TaskStatus
 from app.models.notes_model import NoteResult
 from app.models.pipeline_model import PreparedTask
+from app.models.process_config import ProcessConfig
 from app.services.cache.task_cache import TaskCache
 from app.services.pipeline.ai_processor import AIProcessor
 from app.services.pipeline.preparer import TaskPreparer
@@ -42,19 +43,10 @@ class NoteGenerator:
         self,
         video_url: Union[str, HttpUrl],
         platform: str,
-        quality: DownloadQuality = DownloadQuality.medium,
+        cfg: ProcessConfig,
         task_id: Optional[str] = None,
         model_name: Optional[str] = None,
-        link: bool = False,
-        screenshot: bool = False,
-        _format: Optional[List[str]] = None,
-        style: Optional[str] = None,
-        extras: Optional[str] = None,
         output_path: Optional[str] = None,
-        video_understanding: bool = False,
-        video_interval: int = 0,
-        grid_size: Optional[List[int]] = None,
-        no_subtitle: bool = False,
     ) -> Optional[NoteResult]:
         """
         主流程：按步骤依次下载、转写、GPT 总结、截图/链接处理、存库、返回 NoteResult。
@@ -63,18 +55,9 @@ class NoteGenerator:
             prepared = self.prepare(
                 video_url=video_url,
                 platform=platform,
-                quality=quality,
+                cfg=cfg,
                 task_id=task_id,
-                link=link,
-                screenshot=screenshot,
-                _format=_format,
-                style=style,
-                extras=extras,
                 output_path=output_path,
-                video_understanding=video_understanding,
-                video_interval=video_interval,
-                grid_size=grid_size,
-                no_subtitle=no_subtitle,
             )
             if prepared is None:
                 return None
@@ -88,18 +71,9 @@ class NoteGenerator:
         self,
         video_url: Union[str, HttpUrl],
         platform: str,
-        quality: DownloadQuality = DownloadQuality.medium,
+        cfg: ProcessConfig,
         task_id: Optional[str] = None,
-        link: bool = False,
-        screenshot: bool = False,
-        _format: Optional[List[str]] = None,
-        style: Optional[str] = None,
-        extras: Optional[str] = None,
         output_path: Optional[str] = None,
-        video_understanding: bool = False,
-        video_interval: int = 0,
-        grid_size: Optional[List[int]] = None,
-        no_subtitle: bool = False,
     ) -> Optional[PreparedTask]:
         """
         同步准备阶段：下载、转写、构建 GPTSource。
@@ -108,18 +82,9 @@ class NoteGenerator:
         return self.preparer.prepare(
             video_url=video_url,
             platform=platform,
-            quality=quality,
+            cfg=cfg,
             task_id=task_id,
-            link=link,
-            screenshot=screenshot,
-            _format=_format,
-            style=style,
-            extras=extras,
             output_path=output_path,
-            video_understanding=video_understanding,
-            video_interval=video_interval,
-            grid_size=grid_size,
-            no_subtitle=no_subtitle,
         )
 
     def summarize_and_save(

{bilinote_cli-0.1.0 → bilinote_cli-0.1.2}/src/app/services/pipeline/ai_processor.py

@@ -59,6 +59,7 @@ class AIProcessor:
                 logger.info(f"最终笔记已保存 ({markdown_cache_file})")
 
             # 保存元数据
+            logger.info(f"开始保存笔记 (task_id={task_id})")
             TaskCache.update_status(task_id, TaskStatus.SAVING)
             TaskCache.save_metadata(
                 video_id=prepared.audio_meta.video_id,