xoperator 定制指南

English | 简体中文

核心理念

xoperator 是为高质量回复设计的 Twitter 运营工具，不适合：

批量营销和刷屏
低质量自动回复
无差别互动

适合你，如果你：

有明确的人设定位和话题方向
愿意投入时间筛选候选和打磨写作
追求质量而非数量（宁缺毋滥）

快速定制路径

1. 人设与话题定位（最重要，必做）

文件位置：PROJECT.md §1（账号定位与质量闸）

这是整个运营策略的基础，直接决定你的内容风格和受众定位。

当前默认配置

- 人设：第一人称，年轻技术从业者；英语/日语随原帖语言切换；语气自然、带行动力。
- 内容范围：围绕能吸引用户的热点话题给出高价值洞见；多关注AI，科技，社会现象，人生哲理鸡汤等领域（既安全又有流量）。避开政治、经济、八卦、低俗、不可证的传闻等敏感低端话题；同时也避开除AI领域外的专业技术理论的话题（因为没有流量）。

定制示例

案例1：Web3 创始人视角

- 人设：第一人称，Web3创始人；英语为主；语气务实、批判性思考。
- 内容范围：专注DeFi/DAO/NFT实践案例；关注加密经济机制设计、社区治理、代币经济学。避开纯投机话题、空投猎手内容、政治立场。

案例2：日语母语创作者

- 人设：第一人称，日本技术观察者；日语为主，偶尔英文；语气温和、细腻。
- 内容范围：日本科技产业、AI在日本的应用、东西方技术文化对比。避开政治敏感话题、欧美中心的讨论。

案例3：产品经理视角

- 人设：第一人称，B2B SaaS产品经理；英语；语气分析性、数据驱动。
- 内容范围：产品设计方法论、用户研究、增长策略、PLG模式。避开纯技术实现细节、创业鸡汤、未验证的理论。

如何修改

打开 PROJECT.md
搜索 ## 1. 账号定位与质量闸 或导航到 §1
修改 人设 和 内容范围 两项
保存文件

提示： 这两行会被 PEERB 用于判断候选是否符合你的定位，也会被用于写作时的风格指引。

2. 技术阈值调整（可选）

文件位置：CONFIG.json

这些参数控制候选筛选的技术门槛，修改后工具会自动读取。

关键参数说明

{
  "candidate_search": {
    "baseline": {
      "min_followers": 20000,       // 作者最小粉丝数（硬底线）
      "max_age_hours": 12,          // 推文最大年龄（小时）
      "min_comments": 5,            // 最小评论数（防无互动）
      "max_comments": 100,          // 最大评论数（防被淹没）
      "min_views": 20000            // 最小观看量（需要有曝光）
    },
    "sweep_strategy": {
      "follower_steps": [20000, 30000, 40000, 50000],  // 梯度扫描范围
      "age_steps": [12, 10, 8, 6],                     // 时间窗口收紧
      "views_steps": [20000, 50000, 80000]             // 观看量提升
    }
  }
}

定制示例

降低门槛（获取更多候选）：

{
  "baseline": {
    "min_followers": 10000,   // 从20k降到10k
    "max_age_hours": 12,      // ⚠️ 固定12h（热推时效性至关重要）
    "min_comments": 3,        // 从5降到3
    "max_comments": 100,      // 保持100（防淹没）
    "min_views": 10000        // 从20k降到10k
  }
}

提高门槛（更严格筛选）：

{
  "baseline": {
    "min_followers": 50000,   // 只关注大V
    "max_age_hours": 6,       // 只要最新鲜的
    "min_comments": 10,       // 要有一定互动
    "max_comments": 50,       // 更严格防淹没
    "min_views": 50000        // 要高曝光
  }
}

⚠️ 注意：

max_comments: 100 是防淹没的关键，建议保持
梯度扫描会从 baseline 逐步收紧到 sweep_strategy 的上限
最小候选数 floor_min_rows: 2，不足2条会提示"样本偏冷"

3. 质量框架调整（高级）

文件位置：PROJECT.md §6.0（写作原则）

默认质量框架较为复杂，包含：

S4 标准：Sharp（锐利）/ Surprising（意外）/ Supported（有据）/ Significant（有意义）
洞见楔子：Frame-Shift / Trade-off / Why-Now / Synthesis / Name-It / Exit
Hook / Proof / H2H：三问必答检查

简化版本（适合初学者）

如果觉得太复杂，可以简化为：

打开 PROJECT.md
找到 §6.0 写作原则 章节

将重点简化为：

只做三件事：
1) 贴身回应：提及原帖的核心内容
2) 一条真洞见：给出新角度或观察
3) 清爽表达：≤240字、无emoji、无CTA

可选： 注释掉 §6.6 的 Hook/Proof/H2H 强制检查

⚠️ 注意： 质量框架是防止输出流于平庸的关键，简化需谨慎。

4. 运营节奏调整

文件位置：PROJECT.md §3（心跳回路）+ CONFIG.json

发布频率限制

在 PROJECT.md §0+（一页执行卡）修改：

- microtopic 12h ≤2        # 同一话题12小时内最多2条
- 同作者 60min ≤1          # 同一作者60分钟内最多回复1次
- 外发最小间隔 10min       # 发布间隔最少10分钟
- 滚动 60min 对外 ≤6 条    # 每小时最多发6条

可根据需要调整这些数字。

Heartbeat 节奏

在 PROJECT.md §3（心跳回路）修改：

Heartbeat = 30 分钟/拍，拆成三个 10 分钟 Time Box

可调整为更快或更慢的节奏，如：

快节奏：Heartbeat = 20分钟（补货7分/共识6分/写作7分）
慢节奏：Heartbeat = 60分钟（补货20分/共识20分/写作20分）

5. 内容类型比例

文件位置：PROJECT.md §4.2（内容倾向）和 §10（运行即生效的默认参数）

当前配置：

Reply 为主，Original 需明确授权

可调整为：

100% Reply：专注回复，不做原创
70% Reply / 30% Original：增加原创比例
50/30/20/0：Reply/Original/InboxCare，不做Curate

⚠️ 注意： 目前这个比例主要是文档说明，工具层面没有强制执行。

6. 语言配置

文件位置：CONFIG.json

{
  "allow_lang": ["en", "ja"]  // 允许的语言
}

可修改为：

["en"] - 仅英文
["ja"] - 仅日文
["en", "ja", "zh"] - 支持中文（需同步修改 PROJECT.md 中的语言说明）

高级定制

Influencer 池定制

文件位置：INFLUENCER_POOL.json

默认包含273个账号（平均40万粉丝，来自influx项目）。

自定义Influencer池

方式1：从现有池派生

# 编辑 INFLUENCER_POOL.jsonl（源数据）
# 然后重新生成
python3 tools/xop-influencer-derive.py

方式2：手动编辑

[
  {
    "handle": "@yourTargetAccount",
    "author_id": "123456789",
    "followers_count": 500000,
    "lang_primary": "en",
    "topic_tags": ["AI", "Tech"],
    "score": 90.0,
    "banned": false,
    "note": "Your note"
  }
]

黑名单管理

文件位置：BANNED_HANDLES.txt 和 BANNED_PHRASES.txt

BANNED_HANDLES.txt：每行一个 @handle，这些账号会被过滤
BANNED_PHRASES.txt：每行一个短语（不区分大小写），包含这些短语的推文会被过滤

使用工具快速添加：

python3 tools/xop-ban.py --handle @spammer_account

写作风格定制

文件位置：PROJECT.md §6.3（写作示例）

这里提供了英文/日文的写作示例，体现了特定的风格特征：

简洁锐利
技术导向
观察性而非说教性

你可以：

替换这些示例为你自己的风格
增加更多示例供参考
在 PEERB 审核时以这些示例为标准

提示： 这些示例主要用于人工/Aux参考，不是硬性模板。

不建议定制的部分

以下部分是核心质量保障机制，不建议修改：

🚫 不要修改

§0 RED FLAGS（生产级严肃性声明）
- 评论≥100必停 - 防止被淹没
- 禁止reply-of-reply - 保持内容质量
- 发布时间>12h基线 - 保证时效性
Provenance验证逻辑
- 所有候选必须来自真实抓取
- 禁止手工填表 - 防止数据造假
- xop-lint.py 的校验规则
数据完整性检查
- 10个slice文件的完整性要求
- DQF（Data Quality Firewall）
- 样本统计审计

这些是项目的核心设计原则，修改可能导致质量下降或系统失效。

定制检查清单

完成定制后，运行以下检查确保配置正确：

# 1. 语法检查
make test

# 2. 配置诊断
make diagnose

# 3. 完整系统诊断
python3 tools/xop-preflight.py --diagnose

# 4. Lint 检查（如果已有候选列表）
python3 tools/xop-lint.py

实际案例：完整定制流程

案例：从默认配置改为"产品经理 + SaaS领域"

Step 1: 修改人设（PROJECT.md §1）

- 人设：第一人称，B2B SaaS 产品经理；英语；语气分析性、数据驱动。
- 内容范围：产品设计、用户研究、PLG增长、SaaS指标分析。避开纯技术实现、未验证理论、创业鸡汤。

Step 2: 调整Influencer池（聚焦SaaS领域）

编辑 INFLUENCER_POOL.json，保留/添加SaaS相关账号：

@lennysan (Lenny's Newsletter)
@joulee (Julie Zhuo)
@shreyas (Shreyas Doshi)
@gokulrajaram (Gokul Rajaram)
等等

Step 3: 调整阈值（可选，保持默认即可）

{
  "baseline": {
    "min_followers": 30000,  // SaaS圈子相对小众，可稍微提高
    "max_age_hours": 12,
    "min_comments": 5,
    "max_comments": 100,
    "min_views": 20000
  }
}

Step 4: 更新写作示例（PROJECT.md §6.3）

添加产品经理风格的示例：

- 英语示例（产品）：
  "Retention isn't a feature problem—it's an onboarding promise problem. If your D7 falls off a cliff, audit what you showed vs. what you delivered in Week 1."

Step 5: 验证

make diagnose
python3 tools/xop-setup.py --check

常见定制问题

Q: 我想要中文运营，怎么改？

A: 需要修改多处：

CONFIG.json: "allow_lang": ["zh"]
PROJECT.md §1: 修改人设中的语言说明
PROJECT.md §6.1: 添加中文的 lint 规则
准备中文的 Influencer 池

Q: 如何完全禁用质量框架，只做简单回复？

A: 不推荐，但如果确实需要：

注释掉 PROJECT.md §6.6 的检查规则
简化 §6.0 为最基本的"贴身+洞见+清爽"
风险：容易产生低质量内容

Q: 能否调整为每小时发10条？

A: 可以，但不推荐：

修改 PROJECT.md §0+ 的限频规则
风险：高频发布容易被认为是bot，影响账号安全

Q: 配置文件格式错了怎么办？

A: 运行诊断工具：

make diagnose  # 会检查JSON格式和关键字段

获取帮助

文档：详见 PROJECT.md（运营宪法）和 README.md（快速上手）
问题：提交 GitHub Issue
社区：目前处于早期阶段，暂无专门社区

最后提醒：

xoperator 的核心价值在于"宁缺毋滥"的质量控制。定制时建议保持这个原则：

✅ 根据你的领域和人设调整话题方向
✅ 根据目标受众调整阈值
⚠️ 谨慎修改质量框架
❌ 不要为了"多发"而降低标准

高质量的少量内容 >> 低质量的大量内容

FilesExpand file tree

CUSTOMIZATION.zh-CN.md

Latest commit

History

CUSTOMIZATION.zh-CN.md

File metadata and controls

xoperator 定制指南

核心理念

快速定制路径

1. 人设与话题定位（最重要，必做）

当前默认配置

定制示例

如何修改

2. 技术阈值调整（可选）

关键参数说明

定制示例

3. 质量框架调整（高级）

简化版本（适合初学者）

4. 运营节奏调整

发布频率限制

Heartbeat 节奏

5. 内容类型比例

6. 语言配置

高级定制

Influencer 池定制

自定义Influencer池

黑名单管理

写作风格定制

不建议定制的部分

🚫 不要修改

定制检查清单

实际案例：完整定制流程

案例：从默认配置改为"产品经理 + SaaS领域"

Step 1: 修改人设（PROJECT.md §1）

Step 2: 调整Influencer池（聚焦SaaS领域）

Step 3: 调整阈值（可选，保持默认即可）

Step 4: 更新写作示例（PROJECT.md §6.3）

Step 5: 验证

常见定制问题

Q: 我想要中文运营，怎么改？

Q: 如何完全禁用质量框架，只做简单回复？

Q: 能否调整为每小时发10条？

Q: 配置文件格式错了怎么办？

获取帮助