X（Twitter）

用对话操作你的 X 账号：发帖与串帖、搜索、时间线与提及、点赞 / 转发 / 书签 / 关注，以及本机排程队列。数据只在本机处理；发帖用你自己账号的 Access Token，不会替别人发帖。

密钥由你在 X Developer Portal 自行申请并填入插件设置。免费 API 档额度很紧；搜索 / 时间线 / 趋势等读接口通常需要付费档。

工作原理

Harness 对话
    ↓ MCP
dsh-twitter 插件（本机 Node 桥接服务）
    ↓ HTTPS（twitter-api-v2）
X API v2 / v1.1

在 X 平台获取密钥

1. 开通 Developer

1. 打开 https://developer.x.com（旧入口 https://console.x.com 仍可用），用你将来要发帖的那个 X 账号登录
2. 同意开发者条款，按需完成邮箱 / 手机号验证
3. 免费档即可开通；额度问题见下节

2. 填写使用场景

控制台会要求说明使用场景。用英文、就事论事地写，示例：

I run a small personal automation on my own computer. It posts my account's own content using the Twitter API v2, with an Access Token tied to my account only. The tool is personal, non-commercial, and does not provide any public service. It does not post on behalf of others, and it does not send bulk or promotional messages.

要点：个人使用、本机运行、只操作自己账号、不对外提供服务、不群发。写得太像营销 / 群发工具会被拒绝或限流。

3. 创建 Project 与 App，拿到五组密钥

1. 控制台里 Create Project（如已有项目可复用），再 Create App
2. App 权限设为 Read and Write（只有 Read 的 App 无法发帖）
3. 在 App 的 Keys and tokens 页生成所需凭据，对照填入插件详情页（见下一节）：

X 控制台字段	插件里对应
API Key	API Key
API Key Secret	API Key Secret
Access Token	Access Token
Access Token Secret	Access Token Secret
Bearer Token	Bearer Token（可选）

发帖实际依赖的是 Access Token + Access Token Secret（绑定你登录的那个账号）。两条容易踩的线：

• 如果 App 权限是后改成 Read and Write 的，必须重新生成 Access Token，旧 Token 发帖会 403
• 密钥只填在插件详情页里，不要在对话里粘贴

安装与配置

dsh-twitter 为单独发布的插件：

1. 在侧栏「插件」面板搜索 dsh-twitter，安装并启用
2. 打开插件详情页，在「X (Twitter)」设置区：
   • 状态显示运行中即可；勾选「随 dsh 服务自动启动」后保存，下次 dsh 服务启动时桥接服务自动运行
   • 端口留空使用默认 39215
   • 在「开发者密钥」一栏按上表填入各字段并保存。已保存的密钥不会回显；某项留空表示保持不变
3. 保存后重启一次 dsh 服务，MCP 工具才会进入会话；然后开新对话使用

改密钥时同样在插件详情页改，不要在对话里反复粘贴。

使用示例

• 帮我发一条推：今天把 Harness 的 Office 桥装好了
• 发一条串帖，3 张图（图路径：…），主题是 …
• 搜一下今天 #AI 话题下点赞最多的 5 条
• 看看最近 24 小时有谁 @ 了我
• 给这条推点赞 / 转发 / 加书签
• 把这条推排程到明天 10:00 发（先存草稿，我确认后再发布）

排程说明

排程队列在本机：schedule_tweet 写入草稿 → 你确认后 schedule_update reviewed:true → schedule_get_publishable 取待发内容 → schedule_publish 真正发出。插件不会自动发布，发出前总有一步需要你确认。

问题及解决方案

现象	先检查
提示未配置密钥	插件详情页「开发者密钥」是否已填全并保存
发帖 403	App 权限是否为 Read and Write；改权限后是否重新生成了 Access Token
429 / 限流	免费档额度极紧，降低频率；读接口需付费档
对话里找不到 X 工具	装插件或改过端口后，是否重启过一次 dsh 服务并开了新会话
服务起不来	插件详情页状态；重新安装插件（会重新拉依赖）