c1overzz/dsh-bili-scroll

dsh‑bili‑scroll – 자동 B站 스크래핑

개요

• DSH(Dynamic Shell) 플랫폼용 플러그인으로, 하루에 한 번 실행되어 키워드를 기반으로 최근 B站(bilibili.com) 동영상을 검색하고, 자막(또는 로컬로 전사된 음성)을 읽고, 주목할 만한 동영상을 판단하여 Markdown 보고서를 작성합니다. 선택한 동영상에 댓글을 게시하고 사용자에게 @멘션할 수도 있습니다.

주요 기능

• 키워드 기반 검색 – 사용자 정의 목록 또는 기본 제공 목록 사용.
• 자막 우선 필터링 – 자막이 없는 동영상은 선택적 로컬 전사(Whisper 모델 약 538MB)를 활성화하지 않는 한 건너뜁니다.
• Markdown 보고서 – out/<date>.md에 저장되며, 각 동영상에 대한 간단한 이유와 한 문장 요약이 포함되고 ### BVxxxx 접두사가 붙습니다.
• 자동 댓글 – 선택적으로 실행당 최대 20개의 댓글을 게시하며, 각각 사용자에게 @멘션합니다.
• 피크/오프피크 스케줄링 – DeepSeek의 저렴한 토큰 시간대에 실행.
• 자체 포함 종속성 – 플러그인은 작은 uv 바이너리(약 15MB)를 다운로드하여 격리된 Python 3.10+ 가상 환경을 만들 수 있으므로 관리자 권한이 필요 없습니다.

설치 단계

1. 사전 요구 사항 – 머신에 Python 3.10+ 또는 uv 설치 프로그램이 있어야 합니다. 둘 다 없으면 플러그인이 uv를 다운로드합니다.
2. DSH 명령 실행:

   dsh plugin --profile web add github:c1overzz/dsh-bili-scroll
   

   (또는 npm 계정이 복원되면 npm 이름 사용).
3. DSH 재시작 – 번들 레이어는 재시작 후에만 로드됩니다.
4. 설정 → 刷B站을 열고 装主依赖를 클릭하여 4개의 Python 패키지(bilibili-api-python, aiohttp, qrcode, mcp<2)를 설치합니다.
5. 扫码登录을 클릭하고 B站 모바일 앱으로 QR 코드를 스캔합니다(“记住我 / 长期” 선택).

첫 실행 워크플로우

• 플러그인은 <DSH_HOME>/bili-duty 아래에 개인 가상 환경을 생성합니다.
• 本地转写(로컬 전사)를 활성화하면 Whisper 모델을 다운로드합니다.
• 헤드리스 DSH 세션이 prompts/duty.md를 실행합니다. 이 파일에는 기본 bilibili‑mcp 모델에 검색, 자막 읽기, 보고서 생성 방법을 지시하는 프롬프트가 포함되어 있습니다.
• 결과는 日常 탭과 out/의 Markdown 파일로 표시됩니다.

구성 하이라이트

탭	컨트롤
日常	피크/오프피크 자동 실행 활성화, 일일 최대 항목 설정, 처리된 동영상 보기.
偏好	페르소나 프롬프트, 키워드 목록, 대상 즐겨찾기 폴더, 보고서 세부 수준 설정.
互动	자동 댓글/@멘션, 답글 모드, 전달 방법(비공개 메시지 또는 댓글), 대상 UID 전환.
高级	종속성 설치/확인, 진단 실행, 플러그인 홈 디렉터리 보기.

안전 “레드라인”(프롬프트에 하드코딩)

• 댓글에서 개인 데이터(계정, 파일 경로, 대화 기록)를 절대 유출하지 마세요.
• 실행당 댓글 제한을 준수하세요. 각 동영상에는 최대 하나의 댓글만 허용됩니다.
• 플러그인이 가치를 판단할 수 없으면 “没查到”로 기록하고 날조하지 마세요.

문제 해결 팁

• 데스크톱 전용 DSH(NEXT/0.2.x)는 플러그인 버전 ≥ 0.1.4가 필요합니다. 이전 버전은 조용히 실패합니다.
• 종속성 설치가 멈추면 이전 0.1.0 빌드를 사용 중일 수 있습니다 – add를 다시 실행하여 업그레이드하세요.
• uv를 다운로드할 수 없으면 미리 다운로드한 uv.exe를 <home>\.dsh\bili-duty\bin\에 넣으세요.
• 本地转写를 활성화하려면 装转写依赖 버튼도 클릭하세요. 그렇지 않으면 자막이 없는 동영상은 건너뜁니다.

로드맵

• v2.0.0(현재)은 더 풍부한 UI, 양방향 비공개 메시지 상호작용, 동영상별 메모, 진단 도구를 추가합니다.
• 향후 작업은 검색/자막 파이프라인을 JavaScript로 재작성하여 Python 런타임을 완전히 제거하는 것을 목표로 합니다.

라이선스

• 플러그인 자체는 MIT입니다. 번들된 bilibili-mcp 구성 요소는 자체 MIT 라이선스를 보유합니다.

커뮤니티

• 빠른 도움을 위한 QQ 그룹 1128547307.
• 이슈와 PR을 환영합니다. DSH 버전, 플러그인 버전, 시스템 유형, 관련 로그 발췌문을 포함하세요.

---

이 요약은 저장소의 README에만 기반합니다.