# 安装检查表

[English installation checklist](INSTALL.en.md)

第一次安装建议先阅读[新手教程](plugins/little-mouse-pointer/docs/getting-started.md)，再用本页逐项核对环境和工具发现结果。本页中的路径均以 GitHub 仓库根目录为基准。

## Codex

1. 使用 Codex `0.147.0` 或更新版本。
2. 在 GitHub 仓库根目录执行：

   ```powershell
   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：

   ```powershell
   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. 启动后应发现：

   ```text
   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` 后，在控制小窗中完成选取、预览和确认；超时后重新调用即可。

详细步骤见[新手教程](plugins/little-mouse-pointer/docs/getting-started.md)。

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

## 继续阅读

- [插件完整 README](plugins/little-mouse-pointer/README.md)
- [新手教程](plugins/little-mouse-pointer/docs/getting-started.md)
- [运行时说明](plugins/little-mouse-pointer/docs/runtime.md)
- [DeepSeek Harness 手工配置](plugins/little-mouse-pointer/docs/deepseek-harness.md)