This commit is contained in:
home-dev-pookz
2026-03-24 23:15:24 +08:00
parent 90845f50ad
commit 246de71ccf
+17 -54
View File
@@ -9,8 +9,6 @@
## 目录 ## 目录
- [💡 功能特性](#💡功能特性) - [💡 功能特性](#💡功能特性)
- [🚀 当前主线](#🚀当前主线)
- [📊 平台能力矩阵](#📊平台能力矩阵)
- [💾 安装指南](#💾安装指南) - [💾 安装指南](#💾安装指南)
- [🏁 快速开始](#🏁快速开始) - [🏁 快速开始](#🏁快速开始)
- [🗂️ 重构计划](#🗂️重构计划) - [🗂️ 重构计划](#🗂️重构计划)
@@ -24,30 +22,6 @@
## 💡功能特性 ## 💡功能特性
这个项目不是在和 agent 抢活,而是在补 AI 自媒体最后一公里里最容易翻车的那一段。
- `social-auto-upload` 更偏向“经过大量验证的脚本化、程序化执行”
- agent 更擅长“理解任务、编排流程、生成内容、调用工具”
- 两者结合,通常比单纯依赖 agent 直接操作浏览器更稳
为什么 agent 已经能操作浏览器了,还是需要这个项目?
- agent 直接操作浏览器,很多时候要反复解析网页、读 DOM、截图理解、再决定下一步动作
- 这类流程每次执行路径都可能不太一样,稳定性依赖当下页面状态、模型判断和上下文质量
- 对上传、登录、定时发布这类高重复动作来说,这会额外消耗大量 token、算力和执行时间
- 一旦平台页面有轻微波动,agent 还可能重新理解、重新试错,成本会继续上升
这个项目的价值就在这里:
- 把高频、重复、已经跑通过很多次的平台动作,沉淀成稳定的 uploader / CLI / skill
- 把“理解网页并临场决策”的不确定性,尽量收敛成“直接调用一个被验证过的能力”
- 让 agent 少走弯路,少烧 token,把算力留给更适合 AI 的环节,比如选题、写文案、排流程、调度任务
- 让整条链路更接近真正可持续的生产化,而不是每次都从零开始看页面、猜按钮、试流程
## 📊平台能力矩阵
下表描述的是当前仓库内“实际已有实现”的能力,不代表都已经完成 CLI 化或 skill 化。
| 平台 | 登录/账号准备 | 视频上传 | 图文上传 | 定时发布 | CLI | Skill | 说明 | | 平台 | 登录/账号准备 | 视频上传 | 图文上传 | 定时发布 | CLI | Skill | 说明 |
| --- | --- | --- | --- | --- | --- | --- | --- | | --- | --- | --- | --- | --- | --- | --- | --- |
| 抖音 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 当前主线重构最完整 | | 抖音 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 当前主线重构最完整 |
@@ -58,23 +32,26 @@
| 百家号 | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | 浏览器自动化 | | 百家号 | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | 浏览器自动化 |
| TikTok | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | 当前示例走 Chrome 版实现 | | TikTok | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | 当前示例走 Chrome 版实现 |
### AI这么强,为什么还需要这个项目
在你使用AI的能力,browser agent等等,每次都让 agent 重新解析网页、截图理解, 临场判断
该项目经过大量验证,上传这种 高频,重复,无聊的工作交给脚本和程序去执行
## 🚀当前主线
当前仓库这轮重构的主线很明确: ## 💾安装指南
- 先把抖音链路打磨完整,作为 uploader / CLI / skill 的样板 安装、更新、环境准备已经统一收敛到文档:
- 逐步把其他平台往统一结构上收敛
- 默认围绕 `uv`、`patchright`、无头模式、CLI 化、Skill 化推进
- Web 相关代码目前保留为历史版本,不是当前主要维护方向
如果你是第一次使用这个项目: - [安装说明](./docs/install.md)
- [更新说明](./docs/update.md)
补充说明:
- CLI 使用请看:[CLI 使用说明](./docs/CLI.md)
- agent / skill 请看:[Douyin Upload Skill](./skills/douyin-upload/SKILL.md)
- 历史 Web 说明请看:[历史 Web 版本说明](./docs/legacy-web.md)
- 其他单平台 skill 与整合型 skill 仍在开发中
- `requirements.txt` 目前主要用于历史兼容路径,普通用户不需要优先使用它
- 安装看:[安装说明](./docs/install.md)
- 更新看:[更新说明](./docs/update.md)
- CLI 看:[CLI 使用说明](./docs/CLI.md)
- agent / skill 看:[Douyin Upload Skill](./skills/douyin-upload/SKILL.md)
- 历史 Web 说明看:[历史 Web 版本说明](./docs/legacy-web.md)
## 📣近况说明 ## 📣近况说明
@@ -109,22 +86,6 @@
Web 端相关代码仍然保留,但已经不是当前主线,不保证可直接运行,也不保证与当前 uploader/CLI 完全同步。 Web 端相关代码仍然保留,但已经不是当前主线,不保证可直接运行,也不保证与当前 uploader/CLI 完全同步。
## 💾安装指南
安装、更新、环境准备不再在首页重复展开,统一收敛到文档里:
- 人类用户优先看:[安装说明](./docs/install.md)
- 需要更新仓库时看:[更新说明](./docs/update.md)
- 如果你是 CLI 用户,再配合看:[CLI 使用说明](./docs/CLI.md)
当前主线默认使用:
- `uv` 管理环境
- `pyproject.toml` 管理依赖
- `patchright` 作为浏览器驱动
- `sau` 作为 CLI 入口
`requirements.txt` 目前主要用于历史兼容路径,普通用户不需要优先使用它。
## 🏁快速开始 ## 🏁快速开始
@@ -158,6 +119,8 @@ sau douyin upload-video --account creator --file videos/demo.mp4 --title "示例
## 📃详细文档 ## 📃详细文档
已落后,目前在快速重构该项目,当下,你需要做的是把这个仓库,发给你的AI agent:qwen code,codex cc,openclaw等等,让他们帮你安装和使用
更详细的文档和说明,请查看:[social-auto-upload 官方文档](https://sap-doc.nasdaddy.com/) 更详细的文档和说明,请查看:[social-auto-upload 官方文档](https://sap-doc.nasdaddy.com/)
## 🐾交流与支持 ## 🐾交流与支持