diff --git a/README.md b/README.md index 67a46fc..2097a94 100644 --- a/README.md +++ b/README.md @@ -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 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | | 抖音 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 当前主线重构最完整 | @@ -58,23 +32,26 @@ | 百家号 | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | 浏览器自动化 | | 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 完全同步。 -## 💾安装指南 - -安装、更新、环境准备不再在首页重复展开,统一收敛到文档里: - -- 人类用户优先看:[安装说明](./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/) ## 🐾交流与支持