opub 0.5.1__tar.gz

opub-0.5.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hgeng
+
+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.

opub-0.5.1/PKG-INFO

@@ -0,0 +1,305 @@
+Metadata-Version: 2.4
+Name: opub
+Version: 0.5.1
+Summary: Social media auto uploader
+Author-email: hgeng <huanggenghg@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/huanggenghg/opub
+Project-URL: Repository, https://github.com/huanggenghg/opub
+Project-URL: Issues, https://github.com/huanggenghg/opub/issues
+Keywords: social-media,auto-upload,video,douyin,xiaohongshu,kuaishou,weibo,opub
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Video
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: loguru==0.7.3
+Requires-Dist: opencv-python>=4.13.0.92
+Requires-Dist: patchright==1.58.2
+Requires-Dist: qrcode==8.2
+Requires-Dist: requests==2.32.3
+Requires-Dist: segno>=1.6.6
+Dynamic: license-file
+
+# opub
+
+`opub` 是一个强大的自动化工具，旨在帮助内容创作者和运营者高效地将视频内容一键发布到多个国内外主流社交媒体平台。
+项目实现了对 `抖音`、`Bilibili`、`小红书`、`快手`、`视频号`、`百家号` 以及 `TikTok` 等平台的视频上传、定时发布等功能。
+当前推荐通过 `publish_config.ini` 配置内容、素材、平台和账号，然后执行 `opub` 完成统一发布流程。
+
+<img src="media/show/tkupload.gif" alt="tiktok show" width="800"/>
+
+## 💎 赞助商
+
+<table width="100%">
+  <tr>
+    <td width="25%" align="center" valign="middle">
+      <a href="http://t.clawpower.vip/1005">
+        <img src="static/clawpower.png" alt="ClawPower Sponsor" width="180">
+      </a>
+    </td>
+    <td width="75%" align="left" valign="middle">
+      ClawPower 是一家稳定可靠 AI 大模型中转服务商，提供 Claude、GPT、Gemini 60+ 大模型接入。无论是 OpenClaw、Hermes 智能体自动化场景，Claude Code、Codex 编程工具接入，还是公众号、小红书内容创作；都能获得稳定、顺滑、可长期使用的模型服务体验。低至官方价格的 30%，点击<a href="http://t.clawpower.vip/1005">免费领取 5 刀现金</a>体验券
+    </td>
+  </tr>
+  <tr>
+    <td width="25%" align="center" valign="middle">
+      <img src="static/wechat.png" alt="Sponsor Contact" width="150">
+    </td>
+    <td width="75%" align="left" valign="middle">
+      <strong>成为赞助商</strong><br>
+      如果您有意赞助本项目，请扫描左侧微信二维码（添加时请注明来意：<strong>赞助</strong>）。
+    </td>
+  </tr>
+</table>
+
+---
+
+
+## 目录
+
+- [💡 功能特性](#💡功能特性)
+- [💾 安装指南](#💾安装指南)
+- [🤖 AI Agent](#🤖ai-agent)
+- [快速开始](#快速开始)
+- [🗂️ 重构计划](#🗂️重构计划)
+- [📣 近况说明](#📣近况说明)
+- [🐇 项目背景](#🐇项目背景)
+- [📃 详细文档](#📃详细文档)
+- [🐾 交流与支持](#🐾交流与支持)
+- [🤝 贡献指南](#🤝贡献指南)
+- [📜 许可证](#📜许可证)
+- [⭐ Star History](#⭐Star-History)
+
+## 💡功能特性
+
+| 平台 | 登录/账号准备 | 视频上传 | 图文上传 | 定时发布 | CLI | Skill | 说明 |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| 抖音 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 当前主线重构最完整 |
+| Bilibili | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | 运行时自动准备 `biliup` |
+| 小红书（浏览器版） | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 浏览器自动化，CLI/Skill 已接入 |
+| 快手 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 浏览器自动化，CLI/Skill 初版已接入 |
+| 视频号 | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | 对应 `tencent_uploader` |
+| 百家号 | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | 浏览器自动化 |
+| TikTok | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | 当前示例走 Chrome 版实现 |
+
+### AI这么强，为什么还需要这个项目
+在你使用AI的能力，browser agent等等，每次都让 agent 重新解析网页、截图理解, 临场判断
+该项目经过大量验证，上传这种 高频，重复，无聊的工作交给脚本和程序去执行
+
+
+## 💾安装指南
+
+### 自己上手使用
+如果你只是普通用户，不准备借助 agent 客户端，直接看
+
+安装、更新、环境准备已经统一收敛到文档：
+
+- [安装说明](./docs/install.md)
+- [更新说明](./docs/update.md)
+
+
+### AGENT 
+
+```
+AI的发展毋庸置疑，希望你遇到这种安装和使用，不要再怯场，而是交给各种AI Agent来协助你
+```
+
+如果你准备把这个仓库直接交给 `OpenClaw`、`Codex`、`Claude Code` 来安装和使用
+
+先把仓库给 agent，再把这份启动提示词一起发给它：
+
+- [Agent Bootstrap Prompt](./docs/agent-bootstrap.md)
+
+这份提示词会引导 agent：
+
+- 优先按当前主线安装项目
+- 优先使用 `uv`、`publish_config.ini` 和 `opub`
+- 先验证统一发布入口是否可用，再按配置完成发布
+
+
+### 补充说明：
+
+- CLI 使用请看：[CLI 使用说明](./docs/CLI.md)
+- 如果你准备在 `OpenClaw`、`Codex`、`Claude Code / cc` 里使用本项目，先看：[Agent Bootstrap Prompt](./docs/agent-bootstrap.md)
+- agent / skill 请看：[opub CLI Skill](./skills/opub-cli/SKILL.md)
+- 不再维护单平台独立 CLI skill，agent 统一走 `opub`
+- `requirements.txt` 目前主要用于历史兼容路径，普通用户不需要优先使用它
+- 本项目不维护国际化文档，当前文档以中文优先。
+
+
+## 📣近况说明
+
+`2026.03.24`
+
+最近我的重心一直都在创业上，而且手里还有一些项目没完全跑通，所以这个仓库前面有很长一段时间，我确实没有办法投入特别多精力去持续维护。
+
+这个项目不知不觉已经 `9k+ star` 了，社群里也已经有 `2000+` 小伙伴了。看到它真的在持续帮到大家，我心里还是挺开心的，也是真的很感谢大家一直以来的支持、反馈。
+
+所以我想，决定先停一下，抽一段时间出来，把这个项目好好重构和优化一轮。
+
+接下来这段时间，这个仓库应该会进入一个相对密集更新的阶段。我现在最想先做的事情主要有这几件：
+
+1. 使用更隐蔽、更稳定的自动化方案，尽量降低平台检测风险
+2. 补齐一些常用平台的图文能力，并逐步完成 CLI 化、Skill 化
+3. 陆续测试并上架到更多 skill 平台，让大家的龙虾、螃蟹、毛毛虫都能打通 AI 自媒体的最后一道关
+
+所以如果你之前觉得这个项目更新有点慢，哈哈哈，后面大概率会快很多。也欢迎大家继续关注，最近应该会是一段持续修、持续更、持续重构的阶段。
+
+## 🗂️重构计划
+
+项目正在进行一轮整体重构，当前重构重点是：
+
+- 各平台 uploader 的结构收敛
+- CLI 统一接入
+- 面向 OpenClaw、Codex、 Claude Code 等工具的 skill 化
+- 更换为 `patchright` 驱动，提升兼容性与隐蔽性
+- 主线优先围绕无头模式推进
+
+“无头模式（headless）”，指的是浏览器在后台运行，不弹出可见窗口，但自动化流程仍然会照常执行。这样更适合 CLI、服务端、自动任务和 agent 场景。
+
+Web 端相关代码仍然保留，但已经不是当前主线，不保证可直接运行，也不保证与当前 uploader/CLI 完全同步。
+
+
+## 快速开始
+
+1. 编辑 `publish_config.ini`，配置内容、素材路径、启用平台和账号文件。
+2. 执行统一发布入口：
+
+```bash
+opub
+```
+
+如需临时覆盖配置：
+
+```bash
+opub --platforms douyin,weibo --video videos/demo.mp4 --title "标题"
+```
+
+`opub` 会自动完成运行环境预检、账号登录校验、发布和结果汇总。
+
+`publish_config.ini` 是主要控制文件，用于配置内容、素材路径、启用平台、账号文件、定时发布和平台元数据。命令行参数只用于临时覆盖本次运行的配置。
+
+### examples
+
+`examples/` 目录里同时存在两类脚本：
+
+- 当前主线 CLI 包装示例
+- 历史直连 uploader 示例
+
+对抖音、快手、小红书、Bilibili 和微博来说，当前主线只推荐使用上面的统一发布入口。
+下面这些脚本主要是历史直连 uploader 示例或调试入口：
+
+- `examples/upload_to_douyin.py`
+- `examples/upload_video_to_bilibili.py`
+- `examples/upload_to_kuaishou.py`
+- `examples/upload_video_to_tencent.py`
+- `examples/upload_video_to_baijiahao.py`
+- `examples/upload_video_to_tiktok.py`
+- `examples/upload_video_to_xiaohongshu.py`
+
+## 🐇项目背景
+
+该项目最初是我个人用于自动化管理社交媒体视频发布的工具。我的主要发布策略是提前一天设置定时发布，因此项目中很多定时发布相关的逻辑是基于“第二天”的时间进行计算的。
+
+如果您需要立即发布或其他定制化的发布策略，欢迎研究源码或在社区提问。
+
+## 📃详细文档
+
+已落后，目前在快速重构该项目，当下，你需要做的是把这个仓库，发给你的AI agent：qwen code，codex cc，openclaw等等，让他们帮你安装和使用
+
+更详细的文档和说明，请查看：[social-auto-upload 官方文档](https://sap-doc.nasdaddy.com/)
+
+## 🐾交流与支持
+
+[☕ Donate as u like](https://www.buymeacoffee.com/hysn2001m) - 如果您觉得这个项目对您有帮助，可以考虑赞助。
+
+如果您也是独立开发者、技术爱好者，对 #技术变现 #AI创业 #跨境电商 #自动化工具 #视频创作 等话题感兴趣，欢迎加入社群交流。
+
+### Creator
+
+<table>
+    <td align="center">
+        <a href="https://sap-doc.nasdaddy.com/">
+            <img src="media/mp.jpg" width="200px" alt="NasDaddy公众号"/>
+            <br />
+            <sub><b>微信公众号</b></sub>
+        </a>
+        <br />
+        <a href="https://github.com/dreammis/social-auto-upload/commits?author=dreammis" title="Code">💻</a>
+        <br />
+        关注公众号，后台回复 `上传` 获取加群方式
+    </td>
+    <td align="center">
+        <a href="https://sap-doc.nasdaddy.com/">
+            <img src="media/QR.png" width="200px" alt="赞赏码/入群引导"/>
+            <br />
+            <sub><b>交流群 (通过公众号获取)</b></sub>
+        </a>
+        <br />
+        <a href="https://sap-doc.nasdaddy.com/" title="Documentation">📖</a>
+        <br />
+        如果您觉得项目有用，可以考虑打赏支持一下
+    </td>
+</table>
+
+### Active Core Team
+
+<table>
+    <td align="center">
+        <a href="https://leedebug.github.io/">
+            <img src="media/edan-qrcode.png" width="200px" alt="Edan Lee"/>
+            <br />
+            <sub><b>Edan Lee</b></sub>
+        </a>
+        <br />
+        <a href="https://github.com/dreammis/social-auto-upload/commits?author=LeeDebug" title="Code">💻</a>
+        <a href="https://leedebug.github.io/" title="Documentation">📖</a>
+        <br />
+        封装了 api 接口和 web 前端管理界面
+        <br />
+        （请注明来意：进群、学习、企业咨询等）
+    </td>
+</table>
+
+## 🤝贡献指南
+
+欢迎各种形式的贡献，包括但不限于：
+
+-   提交 Bug报告 和 Feature请求。
+-   改进代码、文档。
+-   分享使用经验和教程。
+
+如果您希望贡献代码，请遵循以下步骤：
+
+1.  Fork 本仓库。
+2.  创建一个新的分支 (`git checkout -b feature/YourFeature` 或 `bugfix/YourBugfix`)。
+3.  提交您的更改 (`git commit -m 'Add some feature'`)。
+4.  Push到您的分支 (`git push origin feature/YourFeature`)。
+5.  创建一个 Pull Request。
+
+## 🙏致谢
+
+本项目的 Bilibili 上传能力基于开源项目 `biliup` 的能力进行接入与封装。
+感谢 `biliup` 项目及其贡献者提供的基础能力：
+
+- https://github.com/biliup/biliup
+
+## 📜许可证
+
+本项目暂时采用 [MIT License](LICENSE) 开源许可证。
+
+## ⭐Star-History
+
+> 如果这个项目对您有帮助，请给一个 ⭐ Star 以表示支持！
+
+[![Star History Chart](https://api.star-history.com/svg?repos=dreammis/social-auto-upload&type=Date)](https://star-history.com/#dreammis/social-auto-upload&Date)
+
+## Community
+LINUX DO - The New Ideal Community

opub-0.5.1/README.md

@@ -0,0 +1,276 @@
+# opub
+
+`opub` 是一个强大的自动化工具，旨在帮助内容创作者和运营者高效地将视频内容一键发布到多个国内外主流社交媒体平台。
+项目实现了对 `抖音`、`Bilibili`、`小红书`、`快手`、`视频号`、`百家号` 以及 `TikTok` 等平台的视频上传、定时发布等功能。
+当前推荐通过 `publish_config.ini` 配置内容、素材、平台和账号，然后执行 `opub` 完成统一发布流程。
+
+<img src="media/show/tkupload.gif" alt="tiktok show" width="800"/>
+
+## 💎 赞助商
+
+<table width="100%">
+  <tr>
+    <td width="25%" align="center" valign="middle">
+      <a href="http://t.clawpower.vip/1005">
+        <img src="static/clawpower.png" alt="ClawPower Sponsor" width="180">
+      </a>
+    </td>
+    <td width="75%" align="left" valign="middle">
+      ClawPower 是一家稳定可靠 AI 大模型中转服务商，提供 Claude、GPT、Gemini 60+ 大模型接入。无论是 OpenClaw、Hermes 智能体自动化场景，Claude Code、Codex 编程工具接入，还是公众号、小红书内容创作；都能获得稳定、顺滑、可长期使用的模型服务体验。低至官方价格的 30%，点击<a href="http://t.clawpower.vip/1005">免费领取 5 刀现金</a>体验券
+    </td>
+  </tr>
+  <tr>
+    <td width="25%" align="center" valign="middle">
+      <img src="static/wechat.png" alt="Sponsor Contact" width="150">
+    </td>
+    <td width="75%" align="left" valign="middle">
+      <strong>成为赞助商</strong><br>
+      如果您有意赞助本项目，请扫描左侧微信二维码（添加时请注明来意：<strong>赞助</strong>）。
+    </td>
+  </tr>
+</table>
+
+---
+
+
+## 目录
+
+- [💡 功能特性](#💡功能特性)
+- [💾 安装指南](#💾安装指南)
+- [🤖 AI Agent](#🤖ai-agent)
+- [快速开始](#快速开始)
+- [🗂️ 重构计划](#🗂️重构计划)
+- [📣 近况说明](#📣近况说明)
+- [🐇 项目背景](#🐇项目背景)
+- [📃 详细文档](#📃详细文档)
+- [🐾 交流与支持](#🐾交流与支持)
+- [🤝 贡献指南](#🤝贡献指南)
+- [📜 许可证](#📜许可证)
+- [⭐ Star History](#⭐Star-History)
+
+## 💡功能特性
+
+| 平台 | 登录/账号准备 | 视频上传 | 图文上传 | 定时发布 | CLI | Skill | 说明 |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| 抖音 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 当前主线重构最完整 |
+| Bilibili | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | 运行时自动准备 `biliup` |
+| 小红书（浏览器版） | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 浏览器自动化，CLI/Skill 已接入 |
+| 快手 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 浏览器自动化，CLI/Skill 初版已接入 |
+| 视频号 | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | 对应 `tencent_uploader` |
+| 百家号 | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | 浏览器自动化 |
+| TikTok | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | 当前示例走 Chrome 版实现 |
+
+### AI这么强，为什么还需要这个项目
+在你使用AI的能力，browser agent等等，每次都让 agent 重新解析网页、截图理解, 临场判断
+该项目经过大量验证，上传这种 高频，重复，无聊的工作交给脚本和程序去执行
+
+
+## 💾安装指南
+
+### 自己上手使用
+如果你只是普通用户，不准备借助 agent 客户端，直接看
+
+安装、更新、环境准备已经统一收敛到文档：
+
+- [安装说明](./docs/install.md)
+- [更新说明](./docs/update.md)
+
+
+### AGENT 
+
+```
+AI的发展毋庸置疑，希望你遇到这种安装和使用，不要再怯场，而是交给各种AI Agent来协助你
+```
+
+如果你准备把这个仓库直接交给 `OpenClaw`、`Codex`、`Claude Code` 来安装和使用
+
+先把仓库给 agent，再把这份启动提示词一起发给它：
+
+- [Agent Bootstrap Prompt](./docs/agent-bootstrap.md)
+
+这份提示词会引导 agent：
+
+- 优先按当前主线安装项目
+- 优先使用 `uv`、`publish_config.ini` 和 `opub`
+- 先验证统一发布入口是否可用，再按配置完成发布
+
+
+### 补充说明：
+
+- CLI 使用请看：[CLI 使用说明](./docs/CLI.md)
+- 如果你准备在 `OpenClaw`、`Codex`、`Claude Code / cc` 里使用本项目，先看：[Agent Bootstrap Prompt](./docs/agent-bootstrap.md)
+- agent / skill 请看：[opub CLI Skill](./skills/opub-cli/SKILL.md)
+- 不再维护单平台独立 CLI skill，agent 统一走 `opub`
+- `requirements.txt` 目前主要用于历史兼容路径，普通用户不需要优先使用它
+- 本项目不维护国际化文档，当前文档以中文优先。
+
+
+## 📣近况说明
+
+`2026.03.24`
+
+最近我的重心一直都在创业上，而且手里还有一些项目没完全跑通，所以这个仓库前面有很长一段时间，我确实没有办法投入特别多精力去持续维护。
+
+这个项目不知不觉已经 `9k+ star` 了，社群里也已经有 `2000+` 小伙伴了。看到它真的在持续帮到大家，我心里还是挺开心的，也是真的很感谢大家一直以来的支持、反馈。
+
+所以我想，决定先停一下，抽一段时间出来，把这个项目好好重构和优化一轮。
+
+接下来这段时间，这个仓库应该会进入一个相对密集更新的阶段。我现在最想先做的事情主要有这几件：
+
+1. 使用更隐蔽、更稳定的自动化方案，尽量降低平台检测风险
+2. 补齐一些常用平台的图文能力，并逐步完成 CLI 化、Skill 化
+3. 陆续测试并上架到更多 skill 平台，让大家的龙虾、螃蟹、毛毛虫都能打通 AI 自媒体的最后一道关
+
+所以如果你之前觉得这个项目更新有点慢，哈哈哈，后面大概率会快很多。也欢迎大家继续关注，最近应该会是一段持续修、持续更、持续重构的阶段。
+
+## 🗂️重构计划
+
+项目正在进行一轮整体重构，当前重构重点是：
+
+- 各平台 uploader 的结构收敛
+- CLI 统一接入
+- 面向 OpenClaw、Codex、 Claude Code 等工具的 skill 化
+- 更换为 `patchright` 驱动，提升兼容性与隐蔽性
+- 主线优先围绕无头模式推进
+
+“无头模式（headless）”，指的是浏览器在后台运行，不弹出可见窗口，但自动化流程仍然会照常执行。这样更适合 CLI、服务端、自动任务和 agent 场景。
+
+Web 端相关代码仍然保留，但已经不是当前主线，不保证可直接运行，也不保证与当前 uploader/CLI 完全同步。
+
+
+## 快速开始
+
+1. 编辑 `publish_config.ini`，配置内容、素材路径、启用平台和账号文件。
+2. 执行统一发布入口：
+
+```bash
+opub
+```
+
+如需临时覆盖配置：
+
+```bash
+opub --platforms douyin,weibo --video videos/demo.mp4 --title "标题"
+```
+
+`opub` 会自动完成运行环境预检、账号登录校验、发布和结果汇总。
+
+`publish_config.ini` 是主要控制文件，用于配置内容、素材路径、启用平台、账号文件、定时发布和平台元数据。命令行参数只用于临时覆盖本次运行的配置。
+
+### examples
+
+`examples/` 目录里同时存在两类脚本：
+
+- 当前主线 CLI 包装示例
+- 历史直连 uploader 示例
+
+对抖音、快手、小红书、Bilibili 和微博来说，当前主线只推荐使用上面的统一发布入口。
+下面这些脚本主要是历史直连 uploader 示例或调试入口：
+
+- `examples/upload_to_douyin.py`
+- `examples/upload_video_to_bilibili.py`
+- `examples/upload_to_kuaishou.py`
+- `examples/upload_video_to_tencent.py`
+- `examples/upload_video_to_baijiahao.py`
+- `examples/upload_video_to_tiktok.py`
+- `examples/upload_video_to_xiaohongshu.py`
+
+## 🐇项目背景
+
+该项目最初是我个人用于自动化管理社交媒体视频发布的工具。我的主要发布策略是提前一天设置定时发布，因此项目中很多定时发布相关的逻辑是基于“第二天”的时间进行计算的。
+
+如果您需要立即发布或其他定制化的发布策略，欢迎研究源码或在社区提问。
+
+## 📃详细文档
+
+已落后，目前在快速重构该项目，当下，你需要做的是把这个仓库，发给你的AI agent：qwen code，codex cc，openclaw等等，让他们帮你安装和使用
+
+更详细的文档和说明，请查看：[social-auto-upload 官方文档](https://sap-doc.nasdaddy.com/)
+
+## 🐾交流与支持
+
+[☕ Donate as u like](https://www.buymeacoffee.com/hysn2001m) - 如果您觉得这个项目对您有帮助，可以考虑赞助。
+
+如果您也是独立开发者、技术爱好者，对 #技术变现 #AI创业 #跨境电商 #自动化工具 #视频创作 等话题感兴趣，欢迎加入社群交流。
+
+### Creator
+
+<table>
+    <td align="center">
+        <a href="https://sap-doc.nasdaddy.com/">
+            <img src="media/mp.jpg" width="200px" alt="NasDaddy公众号"/>
+            <br />
+            <sub><b>微信公众号</b></sub>
+        </a>
+        <br />
+        <a href="https://github.com/dreammis/social-auto-upload/commits?author=dreammis" title="Code">💻</a>
+        <br />
+        关注公众号，后台回复 `上传` 获取加群方式
+    </td>
+    <td align="center">
+        <a href="https://sap-doc.nasdaddy.com/">
+            <img src="media/QR.png" width="200px" alt="赞赏码/入群引导"/>
+            <br />
+            <sub><b>交流群 (通过公众号获取)</b></sub>
+        </a>
+        <br />
+        <a href="https://sap-doc.nasdaddy.com/" title="Documentation">📖</a>
+        <br />
+        如果您觉得项目有用，可以考虑打赏支持一下
+    </td>
+</table>
+
+### Active Core Team
+
+<table>
+    <td align="center">
+        <a href="https://leedebug.github.io/">
+            <img src="media/edan-qrcode.png" width="200px" alt="Edan Lee"/>
+            <br />
+            <sub><b>Edan Lee</b></sub>
+        </a>
+        <br />
+        <a href="https://github.com/dreammis/social-auto-upload/commits?author=LeeDebug" title="Code">💻</a>
+        <a href="https://leedebug.github.io/" title="Documentation">📖</a>
+        <br />
+        封装了 api 接口和 web 前端管理界面
+        <br />
+        （请注明来意：进群、学习、企业咨询等）
+    </td>
+</table>
+
+## 🤝贡献指南
+
+欢迎各种形式的贡献，包括但不限于：
+
+-   提交 Bug报告 和 Feature请求。
+-   改进代码、文档。
+-   分享使用经验和教程。
+
+如果您希望贡献代码，请遵循以下步骤：
+
+1.  Fork 本仓库。
+2.  创建一个新的分支 (`git checkout -b feature/YourFeature` 或 `bugfix/YourBugfix`)。
+3.  提交您的更改 (`git commit -m 'Add some feature'`)。
+4.  Push到您的分支 (`git push origin feature/YourFeature`)。
+5.  创建一个 Pull Request。
+
+## 🙏致谢
+
+本项目的 Bilibili 上传能力基于开源项目 `biliup` 的能力进行接入与封装。
+感谢 `biliup` 项目及其贡献者提供的基础能力：
+
+- https://github.com/biliup/biliup
+
+## 📜许可证
+
+本项目暂时采用 [MIT License](LICENSE) 开源许可证。
+
+## ⭐Star-History
+
+> 如果这个项目对您有帮助，请给一个 ⭐ Star 以表示支持！
+
+[![Star History Chart](https://api.star-history.com/svg?repos=dreammis/social-auto-upload&type=Date)](https://star-history.com/#dreammis/social-auto-upload&Date)
+
+## Community
+LINUX DO - The New Ideal Community

opub-0.5.1/conf.py

@@ -0,0 +1,50 @@
+from __future__ import annotations
+
+import json
+import os
+from pathlib import Path
+
+_PROJECT_ROOT = Path(__file__).parent.resolve()
+
+
+def _detect_mode() -> Path:
+    """SAU_HOME 环境变量始终优先。
+    开发模式：项目根有 .git 目录 → BASE_DIR = 项目根
+    pip 模式：→ BASE_DIR = ~/.opub/"""
+    sau_home = os.environ.get("SAU_HOME", "").strip()
+    if sau_home:
+        return Path(sau_home).resolve()
+    if (_PROJECT_ROOT / ".git").is_dir():
+        return _PROJECT_ROOT
+    home_dir = Path.home() / ".opub"
+    return home_dir
+
+
+BASE_DIR = _detect_mode()
+
+# 首次运行自动创建数据目录
+try:
+    BASE_DIR.mkdir(parents=True, exist_ok=True)
+    (BASE_DIR / "cookies").mkdir(exist_ok=True)
+except OSError:
+    pass  # 权限不足时静默忽略，后续操作会报具体错误
+
+
+def _load_config() -> dict:
+    config_path = BASE_DIR / "config.json"
+    if config_path.exists():
+        try:
+            with open(config_path) as f:
+                return json.load(f)
+        except (json.JSONDecodeError, OSError):
+            pass  # 配置文件损坏时使用默认值
+    return {}
+
+
+_config = _load_config()
+
+LOCAL_CHROME_HEADLESS = _config.get("chrome_headless", False)
+LOCAL_CHROME_PATH = _config.get("chrome_path", "")
+DEBUG_MODE = _config.get("debug", False)
+ZHIPU_API_KEY = _config.get("zhipu_api_key", "")
+ZHIPU_VISION_MODEL = _config.get("zhipu_vision_model", "glm-4v-plus")