# hm_basic

**Repository Path**: zaijianlixiang1995/hm_basic

## Basic Information

- **Project Name**: hm_basic
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-23
- **Last Updated**: 2026-10-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 黑猫@基础设置

一组通用的日常辅助：自动回血、自动回蓝，以及若干常见的自动确认开关。

## 功能

- **自动回血**：血量低于阈值时自动使用选定物品；
- **自动回蓝**：气量低于阈值时自动使用选定物品；
- **自动出窍**：死亡后自动点击「出窍」；
- **丢弃确认**：销毁物品时自动确认；
- **接收组队跟随**：收到队伍跟随邀请时自动同意；
- **自动升级**：经验满时自动确认升级；
- **传送跟随**：收到传送符时自动确认；
- **上坐骑跟随**：队长上坐骑时自动跟随。

## 使用方式

1. 在控制台左侧任务列表中选中并启动本任务；
2. 打开界面，勾选需要的功能并填写阈值 / 选择物品，点击保存；
3. 任务会按配置自动运行，可在日志面板查看输出。

## 配置项

| 字段 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| `restoreHpEnable` | boolean | `false` | 开启自动回血 |
| `hpPercent` | number | `80` | 回血触发血量（%） |
| `hpUseItem` | string | `""` | 回血物品名（来自背包） |
| `restoreMpEnable` | boolean | `false` | 开启自动回蓝 |
| `mpPercent` | number | `80` | 回蓝触发气量（%） |
| `mpUseItem` | string | `""` | 回蓝物品名（来自背包） |
| `autoOutOfBodyEnable` | boolean | `false` | 自动出窍 |
| `autoDropConfirm` | boolean | `false` | 丢弃确认 |
| `allowTeamFollow` | boolean | `false` | 接收组队跟随 |
| `autoLevelUpEnable` | boolean | `false` | 自动升级 |
| `autoTeleportFollow` | boolean | `false` | 传送跟随 |
| `mountInviteFollowEnable` | boolean | `false` | 上坐骑跟随 |

> 字段名需与 `ui/index.html` 的默认值、`index.lua` 中读取的配置保持一致。
> 回血 / 回蓝物品下拉来自当前背包，需先进入游戏才能读取。

## 目录结构

```text
黑猫@基础设置/
├── .hm.json          # 脚本清单
├── index.lua         # 任务入口：CheckTime / Check() / Main()
└── ui/
    ├── index.lua     # Init()，注册界面请求处理器
    ├── requests.lua  # 界面后端：RegisterUIRequest 处理器
    ├── index.html    # 界面本身（iframe 加载，经 /appui/sdk.js 与 Lua 通信）
    ├── app.js        # 界面公共辅助
    └── style.css     # 界面样式
```

## 开发说明

- 任务入口必须定义 `CheckTime`、`Check()`、`Main()` 三个约定，详见「运行机制」文档；
- `Main()` 每轮通过 `GetRoleSettings(CurrentTaskName)` 读取最新配置，界面保存后即时生效；
- 物品下拉由界面请求处理器 `GetUseItems` 通过 `hmPackage.getList(1)` 读取。

## 依赖

| 脚本（全名） | 版本 |
| --- | --- |
| `黑猫@基础库` | v1.0 |