zmh2000829/dsh-x-connect
Project Overview项目介绍
dsh-x-connect is an X (formerly Twitter) API v2 connector plugin built specifically for DeepSeek Harness, binding a single X account to a local DSH instance through OAuth 2.0 Authorization Code with PKCE for a public/native client. Installation is performed with the shell command dsh plugin --profile web add dsh-x-connect, after which dsh web is restarted and the X Connect card under Settings → Plugins accepts the OAuth 2.0 Client ID minted in the X Developer Console, with the loopback callback registered as http://127.0.0.1:56130/callback. No client secret is ever transmitted, because public-client PKCE only needs the Client ID, and the loopback listener only runs while an authorization is pending rather than as a permanent service.
Eight agent tools are exposed to the active DSH model so it can search, read, and publish on X without an extra paid LLM summarizer: x_status reports local scopes and usage, x_connect and x_disconnect manage the credential, x_me reads the bound profile, x_search queries recent posts, x_user_tweets reads a timeline starting at five posts, x_tweet fetches one post by URL or ID, x_post publishes after one-time DSH approval, and x_activity_log inspects or clears the local audit trail with that same approval gate.
The plugin depends only on Node and the metered X Developer API, so users must configure scopes tweet.read, users.read, and offline.access and add tweet.write for posting; current public rates shown in the README are $0.005 per Post read, $0.010 per User read, $0.015 per plain-text create, $0.200 per URL-bearing create, and $0.001 for eligible owned reads. Credentials are stored at ~/.dsh/x-connect/credentials.json with file mode 0600 and never returned to the browser card or model, publishing and log deletion fail closed without an interactive approver, development uses npm ci && npm run check && npm pack --dry-run, and the project is released under the MIT license.
dsh-x-connect 是一款为 DeepSeek Harness(DSH) 量身打造的 X(原 Twitter)API v2 连接插件,通过 OAuth 2.0 授权码加 PKCE 公共客户端流程,把单个 X 账号绑定到本地 DSH 实例。安装方式为 dsh plugin --profile web add dsh-x-connect,随后重启 dsh web 并在「设置 → 插件 → X Connect」中输入 X 开发者后台创建的 Client ID,本地仅在授权期间启动 127.0.0.1 的回环监听。
插件向当前 DSH 模型暴露八组工具,涵盖 x_status、x_connect/x_disconnect、x_me、x_search、x_user_tweets、x_tweet、x_post 与 x_activity_log,可读取、检索账号时间线并按用户一次性确认后发文或回帖,避免重复接入收费 LLM 做摘要。
依赖仅 Node 与官方 X API 计费,凭据以 0600 权限写入 ~/.dsh/x-connect/credentials.json,不向浏览器或模型回传。X 按次收费,插件显示保守估价但以开发者控制台账单为准;许可证 MIT,日常推送建议 maxResults: 5 起,并优先使用已知 URL 的 x_tweet。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:dsh-x-connect(zmh2000829/dsh-x-connect)
仓库:https://github.com/zmh2000829/dsh-x-connect
本站详情页:https://www.yhbd.top/plugins/zmh2000829-dsh-x-connect/
本站登记:类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 2 · 最近提交 2026-08-26 · 主语言 TypeScript
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项
Compatibility兼容性
- DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
- External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
- Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册
Security安全性
- Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
- Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
- curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
- Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
- Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
- Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式
Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。
Or use CLI install (for developers)或使用命令行安装(适合开发者)
CLI Install命令行安装
dsh plugin --profile web add dsh-x-connect
把 zmh2000829/dsh-x-connect 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
dsh-x-connect
An X API v2 connector for DeepSeek Harness. It binds one X account through OAuth 2.0 Authorization Code with PKCE and gives the agent tools to search, read, summarize, and publish posts.
Features
- Configure and bind an account in Settings → Plugins → X Connect.
- Test the saved account connection from the settings card.
- Search recent posts, read a post or a user's timeline, and return structured content for the active DSH model to summarize.
- Publish posts and replies only after DSH asks the user for one-time approval by default.
- Refresh OAuth tokens locally and keep an action/cost audit log.
- Never sends an OAuth client secret: X public-client PKCE needs only a Client ID.
Install
dsh plugin --profile web add dsh-x-connect
Restart dsh web, then open Settings → Plugins → X Connect. For local development, pass the repository's absolute path instead of the package name.
X application setup
- Create a project and app in the X Developer Console.
- Enable OAuth 2.0 and configure a public/native client with Authorization Code + PKCE.
- Register
http://127.0.0.1:56130/callbackas a callback URI, or enter another loopback HTTP URI with an explicit port in both X and the plugin. - In DSH settings, enter the OAuth 2.0 Client ID and save.
- Keep
tweet.read,users.read, andoffline.access; enabletweet.writefor publishing. - Select Generate authorization link, authorize in X, return to DSH, and select Test connection.
The callback listener starts only while an authorization is pending. It is not a permanent web service and is not exposed beyond the local loopback interface.
Agent tools
| Tool | Capability |
|---|---|
x_status |
Account, scopes, callback and estimated usage status |
x_connect / x_disconnect |
Bind or remove the local OAuth credential |
x_me |
Read the bound account profile |
x_search |
Search recent X posts |
x_user_tweets |
Read recent posts from an account |
x_tweet |
Read one post by ID or URL |
x_post |
Publish a post or reply after user approval |
x_activity_log |
Inspect or, after approval, clear local activity |
Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →
extracurricular-ai/dsh-filesnap
SenmuuuuW/dsh-whale-report
SnowCrescenter-tech/dsh-milestone
PerryLink/dsh-checkpoint-rewind
XieZongChen/dsh-md-notes
TencentCloud/tencentcloud-agentobs-sdk-dsh