\r \r

社媒自动化工具构建 Skill v1.1.0\r

\r

目标\r

把“新自动化工具”的制作过程标准化，并在 v1.0.0 基础上新增多平台适配能力：\r

• Python + Playwright（persistent_context）\r
• 本地 Ollama（意图识别 + 回复生成）\r
• 规则过滤 + AI 生成混合策略\r
• 先 dry-run 再真实发送\r
• 参数化运行 + Windows EXE 打包\r
• 小红书 / 抖音 / 快手选择器映射模板\r \r ---\r \r

先决输入（必须确认）\r

1. 目标平台（xiaohongshu / douyin / kuaishou）\r
2. 入口 URL（通知页/消息页）\r
3. 已回复判定规则（例如“作者”）\r
4. 发送成功信号（toast 或状态文本）\r
5. 时间窗口与轮询间隔\r
6. 单轮最多处理条数\r \r 默认值（信息不全时）：\r

• interval-minutes=5\r
• recent-hours=1\r
• max-replies=0\r
• 先 --once dry-run\r \r ---\r \r

多平台选择器映射模板（核心）\r

\r 在主程序中维护一个映射表（先填模板，后按真实 DOM 覆盖）：\r \r

SELECTOR_MAP = {\r
    "xiaohongshu": {\r
        "url": "https://www.xiaohongshu.com/notification",\r
        "comment_item": ".interaction-item, .comment-item",\r
        "comment_text": ".interaction-content, .comment-text, .content",\r
        "reply_trigger": "button:has(svg.reply-icon), svg.reply-icon, .reply-btn",\r
        "input": "p#content-textarea.content-input, [contenteditable='true'].content-input, textarea.comment-input",\r
        "submit": "button.submit, button:has-text('发送')",\r
        "success": "text=评论成功",\r
        "replied_marker": "作者"\r
    },\r
    "douyin": {\r
        "url": "\x3CTO_FILL_DOUYIN_URL>",\r
        "comment_item": "\x3CTO_FILL>",\r
        "comment_text": "\x3CTO_FILL>",\r
        "reply_trigger": "\x3CTO_FILL>",\r
        "input": "\x3CTO_FILL>",\r
        "submit": "\x3CTO_FILL>",\r
        "success": "\x3CTO_FILL_SUCCESS_TEXT>",\r
        "replied_marker": "\x3CTO_FILL_MARKER>"\r
    },\r
    "kuaishou": {\r
        "url": "\x3CTO_FILL_KUAISHOU_URL>",\r
        "comment_item": "\x3CTO_FILL>",\r
        "comment_text": "\x3CTO_FILL>",\r
        "reply_trigger": "\x3CTO_FILL>",\r
        "input": "\x3CTO_FILL>",\r
        "submit": "\x3CTO_FILL>",\r
        "success": "\x3CTO_FILL_SUCCESS_TEXT>",\r
        "replied_marker": "\x3CTO_FILL_MARKER>"\r
    }\r
}\r
```\r
\r
适配规则：\r
- 先读平台映射，再执行统一流程。\r
- 每个关键 selector 至少保留 1 个 fallback。\r
- 任何平台都先跑 dry-run 列候选，再启用真实发送。\r
\r
---\r
\r
## 标准流程（6 Phase）\r
\r
### Phase 1：骨架搭建\r
- 主程序拆分：AI 客户端、自动化模块、参数解析。\r
- 支持参数：\r
  - `--platform`\r
  - `--interval-minutes`\r
  - `--recent-hours`\r
  - `--max-replies`\r
  - `--once`\r
  - `--interactive`\r
\r
### Phase 2：平台映射接入\r
- 将平台 selector 映射注入 `Automation`。\r
- URL、评论列表、输入框、发送按钮、成功信号全部来自映射。\r
\r
### Phase 3：真实 DOM 校准\r
- 让用户提供截图/DOM 片段，增量修正映射。\r
- 每次只改一个动作链路（打开弹窗、输入、发送）。\r
\r
### Phase 4：安全与准确\r
- 已回复过滤（marker）\r
- 时间窗口过滤（recent-hours）\r
- 去重（`(text, age)`）\r
- 2-5 秒随机延迟\r
\r
### Phase 5：验证\r
- dry-run：列出候选不发送\r
- 用户确认后真实发送\r
- 必须等待成功信号\r
\r
### Phase 6：交付\r
- EXE 打包（含 Playwright 浏览器路径兼容）\r
- QUICK_START + FAQ\r
- Git 提交与推送\r
\r
---\r
\r
## 质量闸门（必须通过）\r
1. `python -m py_compile auto_responder_production.py`\r
2. `--once` 模式可运行\r
3. dry-run 候选与人工预期一致\r
4. 至少 1 条真实发送成功信号\r
5. EXE 参数模式可运行\r
6. EXE 交互模式可运行\r
\r
---\r
\r
## Windows 命令模板\r
\r
```powershell\r
# 安装依赖\r
pip install -r requirements.txt\r
python -m playwright install chromium\r
\r
# 本地模型检查\r
python -c "import requests;print(requests.get('http://127.0.0.1:11434/api/tags',timeout=5).status_code)"\r
\r
# 单轮 dry-run\r
python auto_responder_production.py --platform xiaohongshu --once --recent-hours 1 --max-replies 3\r
\r
# 构建 EXE\r
powershell -ExecutionPolicy Bypass -File .\build_exe.ps1\r
\r
# EXE 参数模式\r
.\dist\auto_responder.exe --platform xiaohongshu --interval-minutes 5 --recent-hours 2 --max-replies 3\r
\r
# EXE 交互模式\r
.\dist\auto_responder.exe --interactive\r
```\r
\r
---\r
\r
## 可复用 Prompt（新项目直接用）\r
\r
```text\r
按 social-auto-tool-builder v1.1.0 的流程，帮我做一个【平台名】自动化工具。\r
要求：\r
1) Python + Playwright + 本地 Ollama\r
2) 用 persistent_context 保存登录状态\r
3) 先 dry-run 列候选，再真实发送\r
4) 支持 --platform --interval-minutes --recent-hours --max-replies --once --interactive\r
5) 用多平台选择器映射模板实现，允许按我提供的DOM增量修正\r
6) 最后打包EXE并给 QUICK_START\r
```\r
\r
---\r
\r
## 输出物检查清单\r
- [ ] `skill.yaml` 与 `SKILL.md` 完整\r
- [ ] 选择器映射模板已建立\r
- [ ] 平台参数化设计明确\r
- [ ] 验证与交付步骤可执行\r