TindalosKorone/dsh-cheatengine

DSH插件,将DeepSeek Harness代理桥接到Cheat Engine:通过ce_*工具实现动态调试、内存扫描、指针分析、断点以及游戏内存修改。

Project Overview项目介绍

This is a native DSH plugin that enables DSH Agent to directly interact with Cheat Engine for dynamic debugging of local single-player games. To install the plugin, you can run the dsh plugin add command to get it from npm or GitHub, or inject it from your local file system if you are doing development work. Before you start using the plugin, you need to set up the TCP bridge on your Windows Cheat Engine side, which can be done manually following the guide or automatically via a built-in Agent tool call. It supports a wide range of functions from memory scanning and editing to pointer scanning, address locking, and anti-cheat detection.

This plugin is designed specifically for single-user, low-concurrency local debugging scenarios. Typically, you only attach one target game process at a time and complete all your debugging work within a single DSH session. If you run multiple DSH sessions debugging CE at the same time, the plugin status and floating status panel will only display content for the most recently active session. High-concurrency scenarios that require multiple agents to debug CE simultaneously are not recommended for use with this plugin. To avoid unnecessary token consumption, only core tools are exposed by default, you can unlock more tools as your needs arise.

The plugin enables an optional floating status panel by default, which shows current debugging phase, number of calls, scans, locks and other information in the bottom right corner of your screen. You can close it by clicking the X button, and it will become a small button that you can click to reopen it any time. The panel itself does not consume LLM tokens, though the plugin tools do add some token usage per request. The plugin is licensed under MIT, and you should only use it on single-player games you have permission to debug, and never use it on untrusted or remote networks.

这是一个专为 DeepSeek Harness 开发的原生插件,允许 DSH Agent 直接操作 Cheat Engine 完成单机游戏的动态调试,支持内存扫描过滤读写、反汇编断点、指针扫描基址验证、地址锁定、AOB搜索、CT表操作、反作弊检测、会话统计快照等功能。用户可通过 dsh 插件命令从 npm 或 GitHub 安装,也支持本地开发注入,使用前需要先配置好 CE 端的 TCP 桥接。

本插件面向单用户低并发的本地单机调试场景,通常一次仅附加一个目标进程,在一个 DSH 会话内完成调试操作。多会话同时调试时,状态和悬浮面板以最近活动的会话为准,不推荐需要高并发、多 Agent 同时调试 CE 的场景使用本插件。插件默认只暴露核心工具,避免一次性全开增加 Token 消耗,用户可按需解锁对应工具。

使用前需要先在 Windows 端的 Cheat Engine 配置好 TCP 桥接,可手动配置也可让 Agent 调用工具自动完成。插件默认开启右下角悬浮状态面板,显示阶段、调用数等信息,可关闭和重新打开,面板本身不消耗 LLM Token。本插件采用 MIT 许可证,仅允许用于有权限的单机调试环境,不要用于远程或不信任网络。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
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 add @tindalosko/dsh-cheatengine

把 TindalosKorone/dsh-cheatengine 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

@tindalosko/dsh-cheatengine

English | 简体中文

让 DSH Agent 直接操作 Cheat Engine,做单机游戏动态调试:找数值、找基址、锁定资源、分析写入者等。

⚠️ Token 提示:本插件会注册大量 ce_* 工具,增加每次请求的 token 消耗。默认只暴露 ce_status、ce_connect、ce_tool_search、ce_playbook、ce_mission,请按需解锁,不要一次性全开。

适用场景

本插件面向单用户 / 低并发的本地单机调试:一次主要附加一个目标进程,一个 DSH 会话进行调试。多会话同时调试时,状态与悬浮面板以最近活动会话为准;需要高并发 / 多 agent 同时调试 CE 的场景不建议使用本插件。

功能

  • 内存扫描 / 过滤 / 读取 / 写入
  • 反汇编、断点、寄存器、找写入者
  • 指针扫描与基址验证
  • 锁定地址(无限资源)
  • AOB 搜索 / 生成、模块转储、变速、CT 表
  • 反作弊 / 保护模块检测
  • 会话统计、假设 / 证据、审计 / 撤销、快照、风险分级
  • 统一内存读写 / 会话工具(ce_memory_read、ce_memory_write、ce_session),旧工具名保留兼容
  • 可选悬浮状态面板(右下角,可关闭 / 重新打开)

快速开始

1. CE 端(Windows)

  1. 从 cheatengine-mcp-tcp-bridge 获取 ce_mcp_bridge.lua 和 ce_mcp_tcp_x64.dll(32 位 CE 用 x86)。
  2. 把 DLL 放入 CE 安装目录。
  3. 打开 CE 并附加目标进程。
  4. 执行 ce_mcp_bridge.lua,看到 Bridge started on port 17171 即成功。

也可以让 Agent 调用 install_ce_bridge 自动完成。

2. DSH 端

推荐从 npm 安装:

dsh plugin add @tindalosko/dsh-cheatengine

或从 GitHub 安装:

dsh plugin add github:TindalosKorone/dsh-cheatengine

或本地注入:

dev_inject_plugin {"dir": "/绝对路径/dsh-cheatengine"}

默认连接 127.0.0.1:17171,可用 ce_connect 修改。

怎么用

  1. 先 ce_status / ce_connect 确认连接。
  2. 用 ce_tool_search 搜索并按任务包解锁需要的工具,例如 ce_tool_search({"packs": ["scan", "memory"]});内存读写优先使用 ce_memory_read / ce_memory_write。
  3. 常见调试流程可让 Agent 调用 ce_playbook / ce_mission 获取建议。

完整工具列表与 Agent 使用规范见 AGENTS.md。

悬浮面板

  • 默认开启,右下角显示阶段、调用数、扫描数、锁定数、总结。
  • 点 × 关闭;关闭后会变成小按钮 🧊 CE,点击可重新打开。
  • 面板只读取本地 /ce-status/api,本身不消耗 LLM token;但插件工具会。

构建与自检

仓库自带 lib/,clone 后不构建也能直接注入。需要从源码编译时:

npm run build:all   # 编译 host + client
npm run typecheck
node scripts/self-check.mjs
node --test test/tools.test.mjs

安全

  • 只用于你有权限的单机 / 调试环境。
  • 危险工具会修改内存或执行脚本,解锁前三思。
  • 默认仅连接本机 127.0.0.1:17171,不要用于远程 / 不信任网络。

链接

← 上一个 Prev dsh-image-preview 下一个 Next dsh-naiwa-theme →