安装检查表

August 21, 2026 · View on GitHub

English installation checklist

第一次安装建议先阅读新手教程，再用本页逐项核对环境和工具发现结果。本页中的路径均以 GitHub 仓库根目录为基准。

Codex

  1. 使用 Codex 0.147.0 或更新版本。

  2. 在 GitHub 仓库根目录执行：

    codex plugin marketplace add OWNER/REPOSITORY --ref main
codex plugin add little-mouse-pointer@auto-mouse

  3. 用 codex plugin list 确认 little-mouse-pointer@auto-mouse 为 installed, enabled。

  4. 开始新 task，再调用 ui_context_pick。

DeepSeek Harness

  1. 确认 Harness 已安装并提供 @deepseek-ai/dsh-mcp-client。

  2. 推荐直接安装仓库根目录的 Harness bundle：

    dsh plugin --profile demo add github:Fish121380/auto-mouse#v0.1.1
dsh --profile demo --dump-config

    如果使用的 Harness 版本或 profile 不支持该 bundle，再在 cordis.yml、preset 或对应的 Cordis 配置层中使用 plugins/little-mouse-pointer/docs/deepseek-harness.md 的手工配置。

  3. command 直接指向 app/MousePointer.Windows.exe，不要指向 run.ps1。

  4. 保持 cwd、exe 路径、endpoint 和 MOUSE_POINTER_HTTP_PORT 一致。

  5. 启动后应发现：

    mcp__little-mouse-pointer__ui_context_pick
mcp__little-mouse-pointer__ui_context_current
mcp__little-mouse-pointer__ui_context_clear

本机运行

  • Windows 10/11 x64。
  • 不需要安装 .NET SDK 或 .NET Desktop Runtime。
  • 不要删除 app 目录中的运行时文件。
  • 端口占用时同时修改 endpoint 和 MOUSE_POINTER_HTTP_PORT。
  • 手动 GUI 启动使用 run.ps1 或 run.cmd；MCP stdio 使用 self-contained exe。

快速排查

  • 没有发现工具：确认插件已启用，保留完整 app 目录，并让 command 直接指向 app\MousePointer.Windows.exe。
  • 小窗看不见：使用 Alt+Tab 或托盘菜单恢复窗口。全屏 Codex 可能暂时遮挡置顶小窗。
  • 悬停或按钮无反应：关闭旧的 MousePointer.Windows.exe 实例，确认没有复制不完整的运行时目录，再执行 run.ps1 -SelfTest。
  • 选取超时：调用 ui_context_pick 后，在控制小窗中完成选取、预览和确认；超时后重新调用即可。

详细步骤见新手教程。

GitHub 仓库检出时，插件根目录是 Auto_Mouse/plugins/little-mouse-pointer；独立发行版 zip 解压后，插件根目录是直接包含 .codex-plugin 的 little-mouse-pointer 目录。Codex marketplace 命令应指向仓库根目录 Auto_Mouse。Harness bundle 安装命令应指向仓库 URL，而不是嵌套插件目录。

继续阅读