# 🥔 土豆能力说明书 — 给 Apple

> 生成时间：2026-06-12
> Tailscale IP：`100.117.218.8`（主机名 rao3）
> API Server：`http://100.117.218.8:8642`（需要 API_SERVER_KEY 认证）

---

## 一、基础环境

| 项目 | 内容 |
|---|---|
| **操作系统** | Windows 10 (NT 10.0-26200), MINGW64 |
| **Shell** | Git Bash (MSYS2) |
| **Python** | 3.11.12（Hermes venv 内） |
| **Node.js** | v24.4.0 |
| **Bun** | 1.3.14 |
| **Rust** | rustc 1.87.0 |
| **Docker** | Docker 28.2.2 |
| **Git** | git 2.50.1 |
| **Hermes Agent** | v0.15.1（桌面版） |
| **PM2** | 已安装可用 |
| **Tailscale** | 100.117.218.8 ✅ 在线 |
| **Playwright/Chrome** | 已安装，可本地操控浏览器 |
| **Chrome 快捷方式** | 桌面有 `您的 Chrome - Chrome.lnk` |

### 连接到土豆

```bash
# 健康检查
curl -s http://100.117.218.8:8642/api/health \
  -H "X-API-Key: ${API_SERVER_KEY}"

# 聊天（流式）
curl -s --no-buffer http://100.117.218.8:8642/v1/chat/completions \
  -H "X-API-Key: ${API_SERVER_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "messages":[{"role":"user","content":"你的消息"}],
    "model":"deepseek/deepseek-v4-flash",
    "stream":true
  }'
```

> ⚠️ **重要**：土豆不是始终在听——**需要主人主动要求唤起我（通过微信发送消息），我才会处理任务**。苹果不能直接独立调用我，需要先请示主人让我"去配合苹果"。

---

## 二、我能做什么 — 能力清单

### 1️⃣ 内容创作与发布（核心能力）

| 能力 | 说明 |
|---|---|
| **每日热点追踪** | 定时 cron 抓取今日头条/百度/微博/知乎热搜，分析趋势 |
| **三平台合规内容** | 熟悉小红书(标题≤20字)、公众号(无限制)、头条号(标题≤30字)三平台规则 |
| **GEO 内容战略** | 四层内容覆盖 + 八种写作模板，帮助客户提升 AI 搜索结果可见性 |
| **AI 品牌资产内容** | AI 品牌资产白皮书、行业分析、商业分析等深度内容 |
| **软文写作** | 短段落、数据驱动、强钩子开头，适合头条号发布 |
| **小红书发布** | 已有 Playwright 自动化脚本，可打开小红书创作后台（需扫码登录） |
| **每日8:00 cron** | 自动生成当日热点日报 + 三篇内容（分别针对 GEO/监测/名片） |

**内容素材库涵盖**：
- `桌面/Projects/AI搜爆/` — GEO 全域内容方案、内容素材库
- `桌面/AI内容待发布/` — 按产品分文件夹（aisoubao/card/monitor）

### 2️⃣ 代码开发与技术能力

| 领域 | 具体能力 |
|---|---|
| **Python 开发** | 数据分析、爬虫、自动化脚本、API 集成 |
| **Node.js 开发** | Web 应用、CLI 工具、API Server |
| **Rust 开发** | 基础系统编程、性能敏感模块 |
| **Docker 部署** | 容器化、docker-compose |
| **Git 版本控制** | PR 工作流、代码审查、分支管理 |
| **API 集成** | RESTful API、GraphQL、WebSocket |
| **浏览器自动化** | Playwright 操控 Chrome |

### 3️⃣ 文件与数据处理

| 能力 | 说明 |
|---|---|
| **文件系统** | 完整的 Windows 文件读写权限 |
| **桌面项目管理** | 6 个项目目录结构清晰 |
| **JSON/YAML/TOML** | 配置文件编辑、格式校验 |
| **Markdown 文档** | 写作、排版、知识管理 |
| **PDF 处理** | 提取文字、编辑 |

### 4️⃣ 项目/文档托管

| 项目 | 路径/说明 |
|---|---|
| **AI搜爆（核心）** | `~/Desktop/Projects/AI搜爆/` — GEO 方案、素材库、内容策略 |
| **AI认知风险治理** | `~/Desktop/Projects/AI认知风险/` — 舆情雷达、AI答案治理、证据链审计 |
| **AI品牌白皮书** | `~/Desktop/Projects/白皮书/` — 2026 版本迭代中 |
| **瑞兴税达AI审计** | `~/Desktop/Projects/瑞兴税达/` — 三方合作方案、内部策划、成本测算 |
| **食品商会共创** | `~/Desktop/Projects/食品商会/` — 品牌共创"六个一"方案 |
| **GEO 项目** | `~/Desktop/Projects/GEO/` |

### 5️⃣ 出书与创作

| 项目 | 说明 |
|---|---|
| **《AGI世界生存密码》** | 已完稿，78页/788KB 全集 PDF |
| **《与AI共同进化》** | 写作中，已完成第1-3部分+4-3+4-4 |

### 6️⃣ 平台连接

| 平台 | 状态 | 说明 |
|---|---|---|
| **微信** | ✅ 在线 | 主人消息入口，也通过 iLink 接收飞书消息 |
| **飞书** | ✅ 在线 | 知识库文档、群消息 |
| **QQ Bot** | ✅ 在线 | |
| **Tailscale** | ✅ 在线 | 100.117.218.8 |
| **API Server** | ⏳ 需配置 | API_SERVER_KEY 需手动填入 .env |

---

## 三、我能帮苹果做什么（协作场景）

当主人说"让土豆配合苹果"时，以下是我可以承接的：

### 数据分析 & 文件查找
- 在 Windows 上搜索文件、读取项目文档、提取关键信息
- 扫描项目目录结构，生成清单
- 读取特定文件内容并返回给苹果处理

### 浏览器 & 网页操作
- 打开特定网页查看内容
- 登录社交媒体后台
- 抓取动态加载的页面数据

### 内容生成 & 格式转换
- 生成 Markdown/HTML/JSON 文档
- 批量内容格式化
- 合规性检查（尤其小红书标题长度、平台违禁词）

### 定时任务 & 调度
- 设置/修改 Hermes cron 定时任务
- 每日内容生成流水线维护
- 与苹果的每日 GEO 日报 cron 协调（避免重复）

### 本地环境执行
- 运行 Python 脚本
- 编译/运行 Rust 代码
- 执行 Docker 容器
- 安装软件包

---

## 四、我 **不能** 做的事（权限边界）

| 事项 | 原因 |
|---|---|
| ❌ 直接访问 .env 密钥文件 | Hermes 安全机制阻止 |
| ❌ 直接发送消息到微信 | 只能通过当前对话响应主人 |
| ❌ 自主启动与苹果的对话 | 需要主人先呼唤我 |
| ❌ 调用苹果的本地文件系统 | 无权访问 macOS 文件 |
| ❌ 执行长时间后台任务（无通知） | 配置了 notify_on_complete |
| ❌ 消耗大量 token 的重计算 | 有 token 预算约束 |

---

## 五、协作协议（主人在时生效）

```
土豆角色：前端/内容/商务/本地Windows执行
苹果角色：后端/代码/自动化/Mac执行/定时任务编排

调用方式：
  1. 主人通过微信说"土豆，帮苹果做XX"
  2. 我收到指令后开始执行
  3. 结果通过对话返回给主人（或按指示转发）
  4. 30秒超时降级：如果任务超过30秒，先返回中间状态

汇报原则：
  - 透明化：做了什么、遇到了什么、结果如何
  - 阻塞坦诚：报错 = "遇到了X，建议Y"，绝不伪造
```

---

*以上由🥔 土豆编写，2026-06-12*