🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI

方舟日常助手 nhyo/dsh-maa-cli

DeepSeek Harness
nhyo5 天前有提交已提供中文文档扫描:含敏感能力

用本地命令或一句话完成明日方舟日常任务

30.8/100
综合分
1
GitHub 星标
—
npm 周下载
—/5
用户评分

数据截至 2026/10/30 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add nhyo/dsh-maa-cli
该包不可直接 npm 安装,改从 GitHub 源安装(明细见下方安装检查)

状态速览

判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位:仅索引
是什么
dsh 原生插件 · other
装得上吗
本站尚未做安装检查
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
活跃:最近一次提交在 5 天前
档位由哪些信号合成

本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →
社区实装还没有人打卡 · 装过的第一个就是你
安全扫描自动 · 静态分析源码
v2.7.0
🔵 扫描:含敏感能力尚无人工评估
展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力:执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量(至少其一)。这是能力清单,不是危险判定——具体能力项与证据见下方,安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件
扫描于 2026/11/3(1 天前) · 范围 入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个

DeepSeek Harness 插件,用自然语言和本地命令控制 maa-cli

README

由 DeepSeek 最新模型翻译生成
dsh-maa-cli 一个 DeepSeek Harness 插件:把《明日方舟》的日常操作变成一条本地命令,只有复杂需求才交给模型组装计划。 - 日常操作零模型调用:只输入 /maa fight、/maa infrast、/maa rouge 等项目名就能打开参数面板;改完并确认后才执行,全程不进入模型上下文。 - 确认与执行分离:自然语言需求只消耗一次模型调用生成计划,执行由本地确认按钮触发,确认阶段不再调用模型。 - 不需要预装 MAA:插件自带私有运行时,首次真正执行任务时自动下载 maa-cli + MaaCore + 资源,与系统里已有的 MAA 完全隔离。 - 运行中可停止:只终止本会话启动的 maa-cli 进程树,不动游戏、模拟器或其它 MAA 实例。 - 按需自动更新:开始新任务前至多每 24 小时调用一次 maa-cli 官方更新;培养榜只在用户请求建议时检查。
展开完整文档(README 剩余 1 节)
dsh-maa-cli

一个 DeepSeek Harness 插件:把《明日方舟》的日常操作变成一条本地命令,只有复杂需求才交给模型组装计划。

- 日常操作零模型调用:只输入 /maa fight、/maa infrast、/maa rouge 等项目名就能打开参数面板;改完并确认后才执行,全程不进入模型上下文。
- 确认与执行分离:自然语言需求只消耗一次模型调用生成计划,执行由本地确认按钮触发,确认阶段不再调用模型。
- 不需要预装 MAA:插件自带私有运行时,首次真正执行任务时自动下载 maa-cli + MaaCore + 资源,与系统里已有的 MAA 完全隔离。
- 运行中可停止:只终止本会话启动的 maa-cli 进程树,不动游戏、模拟器或其它 MAA 实例。
- 按需自动更新:开始新任务前至多每 24 小时调用一次 maa-cli 官方更新;培养榜只在用户请求建议时检查。

目录

- 快速开始
- 本地命令(零模型调用)
- 自然语言用法
- 工具一览
- 私有运行时
- 环境变量
- 兼容性
- 故障排查
- 安全边界
- 开发
- 常见问题
- 更新日志
- 许可与致谢

快速开始

dsh plugin --profile desktop add dsh-maa-cli
或
dsh plugin --profile web add dsh-maa-cli
安装完成后重启 DSH Desktop,然后任选一种方式:

/maa fight # 打开理智作战参数面板,不会立即开打 /maa update # 选择更新干员 Box / 仓库数据 /maa setup # 想提前下载运行时的话

第一次真正执行游戏任务时会自动准备私有运行时(约 520–630 MB,视网络通常 1–3 分钟)。任务开始前请确保模拟器已经启动;没启动时插件会直接提示「请手动启动mumu模拟器!」,不会消耗理智,计划也不会失效。

本地命令(零模型调用)

命令走 DSH 的本地命令通道,完全不产生模型调用。任务命令只负责打开面板;不点击「确认并执行 MAA」就不会操作游戏。

| 命令 | 别名 | 作用 |
| /maa help | 帮助、? | 显示命令帮助 |
| /maa startup | 启动游戏、打开明日方舟 | 打开开始唤醒面板 |
| /maa fight | flight、刷、作战 | 打开理智作战面板 |
| /maa infrast | 基建、基建换班 | 打开基建换班面板 |
| /maa recruit | 公招、自动公招 | 打开自动公招面板 |
| /maa mall | credit、信用收支 | 打开信用收支面板 |
| /maa award | 领取奖励、领奖 | 打开领取奖励面板 |
| /maa rouge | rogue、roguelike、肉鸽 | 打开自动肉鸽面板 |
| /maa reclamation | 生息、生息演算 | 打开生息演算面板 |
| /maa update | 更新数据 | 选择更新干员 Box / 仓库数据 |
| /maa closedown | 关闭游戏、关闭明日方舟 | 打开关闭游戏确认面板 |
| /maa box | operbox、扫描干员Box | 打开只更新干员 Box 的数据面板 |
| /maa stop | 停止、停止任务、终止任务 | 停止本会话正在执行的任务 |
| /maa setup | 安装运行时、初始化 | 下载并配置私有运行时 |
| /maa confirm MAA-XXXXXX [参数] | — | 面板内部确认命令;通常不需要手工输入 |

示例:

/maa fight # 在面板里选关卡、次数、连战倍率与资源上限 /maa infrast # 在面板里选设施、无人机用途、心情阈值等 /maa recruit # 在面板里选择刷新、星级、次数与加急许可 /maa mall # 在面板里选择访问好友、购物与名单 /maa rouge # 在面板里选择主题、模式、分队与开局干员 /maa update # 在面板里选择 Box、仓库或两者

约定:

- 所有面板参数来自同一套服务端白名单,确认前会再次校验;非法参数不会消耗确认码。
- 参数布局、中文名称、选项和默认值参考本机 MAA.exe 6.18.0 的任务设置及 MAA 官方任务协议。
- 兼容旧写法(如 /maa fight 1-7 10、/maa rouge 萨米 3),但旧参数只用于预填面板,仍不会直接执行。
- 执行期间确认条上会出现「停止任务」按钮,等价于 /maa stop。MaaCore 没有可靠的暂停/继续接口,因此停止后不会自动补完剩余局数。

统一零模型参数面板

截图中的 MAA 主任务已全部接入同一流程:开始唤醒、理智作战、基建换班、自动公招、信用收支、领取奖励、自动肉鸽、生息演算、更新数据。输入 /maa + 项目名 后,插件在输入框上方显示对应面板;参数改动、只读回读和确认全部走本地命令通道。

/maa fight
/maa recruit
/maa mall
/maa rouge
/maa reclamation
/maa update
- 基础项直接显示,高级项收进「高级设置」;布尔项用复选框,枚举用下拉框,多选项用复选框组,数量用带范围限制的数字框。
- MAA.exe 原本带提示的设置,会在对应字段下显示说明;生息演算按当前模式显示启动位置、存档/编队要求、所需干员、预期流程和注意事项。
- 肉鸽保留专用面板和 MAA 推荐开局;其他项目走统一表单渲染器。
- 「更新数据」对应 MAA 的 UserDataUpdateTask:可分别选择 OperBox 与 Depot,不会被误解成下载软件更新。
- 面板里的参数来自待确认计划本身(/maa peek 只做只读回读),打开时看到的就是将要执行的值。
- 不点确认就什么都不会执行;计划 30 分钟有效、一次性,/maa confirm MAA-XXXXXX … 也能手动执行。
- /maa peek MAA-XXXXXX 是面板用的只读命令,手工用只会打印计划的 JSON,不会执行。

干员 Box 查询

/maa box 会先打开只包含 OperBox 的确认面板;确认后才识别已拥有干员,保存到 ~/.dsh/maa-cli/operator-box.json。缓存只含干员 ID、名称、星级、精英化、等级、潜能和扫描时间,不含账号凭据。

扫描一次后,可以直接用自然语言询问:

我有哪些六星干员?
哪些六星还没精二?
维什戴尔多少级、几潜?
给我一份培养建议

DSH 会先调用只读的 maa_operator_box 查询缓存,不连接模拟器。没有缓存,或你明确要求刷新时,才会准备一份需要确认的 StartUp + OperBox 扫描计划。

每次扫描完成后,插件会主动询问是否需要培养建议。你主动询问时,DSH 会先显示上次扫描时间,再让你选择直接用缓存还是重新扫描;重新扫描仍需单独确认。

培养建议使用以下可审计规则:

- 这是蒂蒂,她很可爱!!!
- 杯级来自明日方舟六星干员强度投票箱最新已发布主题,按该项目原有的九等分规则归为 超大上 > 超大中 > 超大下 > 大杯 > 中杯 > 其他。这是社区投票,不是官方强度结论。
- 职业与子职业读取当前 MAA 运行时自带的 battle_data.json,不另外维护一份容易过期的名单;职业内排名由同一社区总榜按职业分组得到。
- 「已有可用职业覆盖」指该职业至少有一名精一或精二干员。没有覆盖时,会提高该职业候选人在同杯级内的顺序,并明确写出职业缺口原因。
- 只推荐尚未精二、或精二但低于 60 级的已拥有六星;榜单没有收录的干员标为「其他」,不会补造评级或排名。
- 每次生成建议前只检查最新已结束主题 ID;主题没变就直接复用 ~/.dsh/maa-cli/training-ranking.json,不重复下载完整榜单。新主题下载成功后才原子替换;检查失败则继续用旧缓存。

自然语言用法

复杂需求仍然可以直接说,例如「先启动游戏,清一下基建,再刷十次 1-7,最后领奖励」。

1. 模型调用一次 maa_prepare_plan,把需求整理成有顺序的步骤,写入任务文件并落盘保存。
2. DSH 输入框附近出现确认条(思考区的工具卡里也有同样的按钮)。确认条右上角有「最小化 / 删除」:最小化把它收成一行摘要,保留确认按钮以外的全部状态(展开后参数还在);删除则让这一条计划从当前界面消失(工具卡上的确认按钮同步隐藏),确认码本身仍可用 /maa confirm 手动执行。
3. 点击「确认并执行 MAA」→ 本地执行 /maa confirm → 运行 maa-cli。这一步不会调用模型。

确认码规则:

- 只对同一个 DSH 会话有效;
- 一次性,用过即失效;
- 30 分钟后过期;
- DSH 重启后计划仍在磁盘上,可继续确认(默认 ~/.dsh/maa-cli/pending-plans.json,可用 DSH_MAA_CLI_STATE_DIR 改目录)。

自动肉鸽参数面板

计划里含 Roguelike 步骤时,确认条和工具卡会多出一块「自动肉鸽参数」,字段对齐 MAA 自己的肉鸽任务设置。默认值取 MAA 官方「推荐开局」表,带 【推荐】 后缀;除「刷取次数」外所有字段都是下拉选项(开关类只有「是」/「否」),不需要手输数字或名字。刷取次数默认 9999,这一栏可以手输,但只接受数字(1–99999)。

主题按游戏内主题列表的推出顺序排列(与 MAA 文档「推荐开局」表一致,最后核对 2026/10/26):

| 主题 | 难度 | 分队(推荐) | 职业组(推荐) | 开局干员(推荐) |
| 傀影与猩红孤钻 | 正式调查·2 | 指挥分队 / 突击战术分队 | 取长补短 | 丰川祥子 / 棘刺 |
| 水月与深蓝之树 | 波涛迭起·3~10(默认 3) | 以人为本分队 / 心胜于物分队 | 稳扎稳打 | 维什戴尔(助战) |
| 探索者的银凇止境 | 挑战自然·4~10(默认 4) | 特训分队 / 远程战术分队 | 稳扎稳打 | 维什戴尔(助战) |
| 萨卡兹的无终奇语 | 直面魂灵·4~10(默认 4) | 蓝图测绘分队 / 远程战术分队 | 稳扎稳打 | 维什戴尔(助战) |
| 岁的界园志异 | 请君入园·3~10(默认 3) | 指挥分队 / 远程战术分队 | 稳扎稳打 | 维什戴尔(助战) |
| 黑流树海 | 暂无(默认 0) | 特勤分队 / 堡垒战术分队 | 稳扎稳打 / 坚不可摧 | 机械师 |

切换主题会把难度/分队/职业组/开局干员重置为该主题的推荐值,并清掉只属于上一个主题的高级开关(密文板 / 坍缩范式 / 骰子刷商店 / 打到最终 Boss 停)。

基础字段:

| 字段 | 说明 | 可选/范围 |
| 主题 | 肉鸽主题 | 傀影与猩红孤钻 / 水月与深蓝之树 / 探索者的银凇止境 / 萨卡兹的无终奇语 / 岁的界园志异 / 黑流树海 |
| 模式 | 刷取策略,对应 MaaCore mode,按主题过滤 | 刷分(0) / 刷源石锭(1) / 凹开局(4) / 刷坍缩范式(5,仅萨米) / 刷月度小队(6) / 刷深入调查(7) / 快速过第一层(10001,仅萨卡兹) / 刷常乐节点(20001,仅界园) / 刷襁褓动物(30001,仅黑流树海) |
| 难度 | 对应主题的难度档位 | 下拉 0–15(MAA 推荐值见上表;手工命令仍接受 0–99) |
| 刷取次数 | 打几局 | 手输数字 1–99999,默认 9999(其他字符会被过滤掉) |
| 分队 | 开局分队 | 下拉:本主题推荐项 + MAA 全部 44 个分队名 |
| 职业组 | 开局职业组 | 下拉:稳扎稳打 / 取长补短 / 坚不可摧(推荐项带【推荐】) |
| 开局干员 | 第 1 顺位招募的干员 | 下拉:本主题推荐干员 + 其他主题推荐干员 |
| 使用助战 | 开局干员是否借助战 | 下拉:是 / 否 |

「高级功能(MAA 高级设置)」折叠区只显示当前主题 / 模式下 MAA 真正会用到的开关:切主题或换模式时,不适用的项直接不渲染,也不会随确认命令发送,避免出现「改了但 MAA 根本不理」的选项。

| 字段 | 说明 | MaaCore 字段 | 出现条件 |
| 使用非好友助战 | 助战可以是路人 | use_nonfriend_support | 使用助战=是 |
| 打到最终 Boss 停 | 见好就收 | stop_at_final_boss | 主题 ≠ 傀影 |
| 等级刷满停 | 肉鸽等级满后停止 | stop_at_max_level | 总是 |
| 投资源石锭 | 是否投资 | investment_enabled | 总是 |
| 投资次数 | 投资多少次(0–99999) | investments_count | 投资源石锭=是 |
| 投资满停 | 投资到达上限即停 | stop_when_investment_full | 投资源石锭=是 |
| 投资后购物 | 投资后顺便购物 | investment_with_more_score | 模式 = 刷源石锭(1) |
| 凹精二直升 | 凹开局时同时凹精二直升 | start_with_elite_two | 模式 = 凹开局(4) |
| 只凹精二直升 | 只凹精二直升,忽略其他开局条件 | only_start_with_elite_two | 凹开局(4) 且 凹精二直升=是 |
| 月度小队自动切换 | 月度小队自动换 | monthly_squad_auto_iterate | 模式 = 刷月度小队(6) |
| 深入调查自动切换 | 深入调查自动换 | deep_exploration_auto_iterate | 模式 = 刷深入调查(7) |
| 常乐节点 | 目标 1 令 / 2 黍 / 3 年 | find_playTime_target | 模式 = 刷常乐节点(20001) |
| 使用密文板 | 是否使用密文板 | use_foldartal | 主题 = 萨米 |
| 检测坍缩范式 | 检测本次拿到的坍缩范式 | check_collapsal_paradigms | 主题 = 萨米 |
| 骰子刷新商店 | 用骰子刷商店买特殊商品 | refresh_trader_with_dice | 主题 = 水月 |

- 主题、模式、难度、分队、职业组、开局干员、高级开关的初始值优先级:模型计划里显式给出的值 → MAA 推荐开局 → 内置默认。刷取次数是例外:面板始终从 9999 起步,不跟随计划里的次数,需要别的局数请直接改这一栏。
- 改动后仍用同一个确认码执行:按钮实际发送 /maa confirm theme=Sarkaz mode=0 difficulty=4 squad=蓝图测绘分队 ...。
- 参数在消费确认码之前校验(主题枚举、模式枚举、次数 1–99999、难度 0–99、投资次数 0–99999、常乐目标 1–3、开关只接受 true/false)。校验失败会直接报错,计划不会被消耗,可以改完再点。
- 确认按钮右侧「30 分钟内有效」旁边有一个备注栏:备注不会进 MaaCore,只随确认命令(URL 编码的 note=)回到 DSH,由 DSH 自行决定怎么理解、做什么,不保证执行。
- 只影响计划里的 Roguelike 步骤;计划中没有肉鸽步骤时面板不出现,附加参数会被拒。
- 高级开关只发送当前主题/模式下可用的项;开局干员只用于第 1 顺位招募(core_char,不支持三顺位 core_char_list)。
- 面板只提供下拉选项(开关是「是 / 否」)与刷取次数的手输数字;手工命令通道仍接受 key=value 文本(分队 / 职业组 / 干员长度 1–32),例如 /maa confirm MAA-1A2B3C theme=Sarkaz mode=0 difficulty=4 useSupport=false investmentsCount=999 note=%E6%89%93%E5%AE%8C%E5%B0%B1%E5%81%9C。

工具一览

模型侧可用的工具(本地命令不需要它们):

| 工具 | 作用 |
| maa_query | 只读查询:version、help、list,以及各目录位置(cache_dir、hot_update_dir、config_dir、library_dir、resource_dir、data_dir、log_dir) |
| maa_operator_box | 只读查询上次 OperBox 缓存,可按星级、名称和精英化筛选;不会连接模拟器 |
| maa_training_advice | 基于 Box 缓存、MAA 职业数据和公开社区榜生成有序培养建议;首次请求会先询问使用缓存还是重扫 |
| maa_doctor | 环境体检,只读:maa-cli 版本、AppData 视图、缓存目录可原子写、热更新仓库、连接配置、ADB 文件、ADB 端口、MuMu 管理器,共 9 项 |
| maa_prepare_plan | 把自然语言步骤整理成计划并落盘,显示本地确认按钮 |
| maa_runtime | status / install / update:查看、安装、更新私有运行时;force 强制重装,keepCaches 保留安装包 |

私有运行时

插件不打包 maa-cli、MaaCore 或资源,而是给每位用户在自己的目录里准备一份:

- 默认位置:~/.dsh/maa-cli/runtime(DSH_MAA_CLI_RUNTIME_DIR 可改)。

- 结构:

runtime/
├─ bin/ maa-cli(Windows 下是 maa.exe) ├─ data/lib/ MaaCore 与依赖 DLL ├─ data/resource/ 资源 ├─ config/profiles/default.toml ├─ state/ 日志等 ├─ cache/ 运行期缓存(安装包会被自动清理) └─ runtime.json 版本与安装信息

- 安装流程:下载 maa-cli 官方 release(约 3.6 MB)→ tar 解包 → maa-cli install --batch(由 maa-cli 自己下载匹配的 MaaCore 与资源)→ 探测 adb 并生成 default.toml → 清理几百 MB 的安装缓存。

- 自动更新:准备启动新任务时检查上次更新时间;距离上次检查满 24 小时才运行一次官方 maa-cli update --batch。maa-cli 自己判断远端版本,版本未变不会重复安装。更新过程全局互斥;已有任务运行时跳过,更新结束后任务才会启动。更新前用同盘硬链接保存旧 lib/resource 快照,成功后清理,失败或中断则原子恢复旧版本。

- 体积:装完约 520–630 MB(MaaCore 约 250 MB,资源约 267 MB)。

- 隔离:通过 MAA_DATA_DIR / MAA_STATE_DIR / MAA_CACHE_DIR / MAA_CONFIG_DIR 四个变量让 maa-cli 只认这个目录,不会读写用户全局的 MAA 配置与缓存。

- 生成任务时的目录:先执行 maa-cli dir config,把任务文件写到该进程实际使用的配置目录,避免私有运行时与全局配置不一致。

- 卸载:直接删除该目录即可,不影响系统里的 MAA。

- 不开 DSH 也能装:node scripts/install-runtime.mjs(会打印每一步的耗时)。

- adb 探测顺序:DSH_MAA_CLI_ADB_PATH → ANDROID_HOME / ANDROID_SDK_ROOT → %ProgramFiles% 与各固定盘的 Program Files / Program Files (x86) 下的 MuMu / 雷电 / 蓝叠 → PATH。探测不到时会写出不含 adb_path 的 default.toml,手动补一行即可(地址默认 127.0.0.1:16384)。

环境变量

| 变量 | 作用 |
| DSH_MAA_CLI_RUNTIME_DIR | 私有运行时根目录 |
| DSH_MAA_CLI_PATH / MAA_CLI_PATH | 指定别的 maa-cli(优先于私有运行时;指向不存在的文件会直接报错,不会偷偷下载) |
| DSH_MAA_CLI_ADB_PATH | 指定 adb,安装时跳过探测 |
| DSH_MAA_CLI_STATE_DIR | 待确认计划的存放目录(默认 ~/.dsh/maa-cli) |
| DSH_MAA_CLI_ASSET_URL | 覆盖 maa-cli 下载地址(内网镜像或离线 zip) |

兼容性

- 系统:Windows 10/11 x64(运行时来自 maa-cli 官方发布,Linux/macOS 理论上同样适用,但未实测)。
- Node:>=22(只用 node --test、node:fs 等内置模块,无第三方依赖)。
- DSH:dshReleases: 0.2.1-rc.3 标记为兼容。
- 模拟器:任何能被 adb 连接的 Android 模拟器;MuMu 12 是主要测试环境(127.0.0.1:16384、MuMuEmulator12、MiniTouch)。
- 服务区:Official、Bilibili、Txwy、YoStarEN、YoStarJP、YoStarKR。

故障排查

先跑一次体检(模型侧 maa_doctor):9 项里任何一项红了,基本都能直接定位问题。

| 现象 | 原因与处理 |
| I/O error: 系统无法将文件移到不同的磁盘驱动器。 (os error 17) | 目标目录被 EFS 加密,maa-cli 的「同目录临时文件 + rename」原子写在加密目录上必然失败。把该目录 cipher /d 解密,或用 junction 重定向到未加密盘(mklink /J)。 |
| Resource directory ... not found, ignoring | maa-cli 回退到了内置资源,通常不影响功能;若行为异常,用 maa_doctor 看资源目录,再 maa_runtime update。 |
| 提示「请手动启动mumu模拟器!」 | 模拟器没启动或没开 ADB 调试。启动后重新点一次确认即可,计划不会失效。 |
| adb 连不上 / 端口不通 | adb devices 看设备;MuMu 需要在设置里开启 ADB,端口默认 16384;必要时 adb connect 127.0.0.1:16384。 |
| 目录一会儿存在一会儿不存在 | 从 Microsoft Store 打包的应用启动进程时,%APPDATA% / %LOCALAPPDATA% 会被重定向到 %LOCALAPPDATA%\Packages\<包名>\LocalCache\{Roaming,Local},且「写后才物化」。插件用 paths.js 在两个视图里查找,maa_doctor 会显示实际路径。 |
| 运行时下载慢或失败 | 设置 DSH_MAA_CLI_ASSET_URL 指向镜像/离线 zip,或手动下载后放到 runtime/downloads/ 再重试 install。 |
| 提示「当前 DSH 会话已有一个 MAA 任务正在执行」 | 同一会话同时只能跑一个任务;先 /maa stop 或等它结束。 |
| 确认按钮点了没反应 / 提示确认码不匹配 | 确认码单会话、一次性、30 分钟过期;重新让模型准备一次计划即可。 |

安全边界

- 只调用 maa-cli 的白名单子命令(查询类 version / help / list / dir,执行类 run),并对参数做字符校验;不会执行任意 shell。
- 只操作游戏:不涉及充值、不修改账号资料、不改动系统 MAA 的配置。
- 停止操作只对本会话启动的进程树执行 taskkill /T,不会波及其它 MAA 实例、游戏或模拟器。
- 确认码机制保证「模型提议」与「用户批准」是两次独立动作。

开发 bash
npm test # node --test,无第三方依赖
目录按功能划分:

| 路径 | 职责 |
| src/index.js | 服务端入口:注册工具与 /maa 本地命令,串起确认与执行 |
| src/client/ | 客户端 UI:计划卡片、确认条、肉鸽参数面板、停止按钮 |
| src/commands/ | 本地命令解析、MaaCore 任务规划与确认码管理 |
| src/runtime/ | maa-cli 调用、私有运行时、路径、状态、模拟器预检与环境诊断 |
| src/operators/ | 干员 Box 缓存与培养建议 |
| test/ | 全部 Node 测试,包括统一零模型参数面板用例 |
| config/ | DSH/Cordis 插件挂载配置 |
| scripts/ | 不启动 DSH 时可独立运行的维护脚本 |
| docs/ | 开发与交接文档 |
| artifacts/ | 本地历史打包文件;不随 npm 包发布 |

测试统一放在 test/,全部走 node --test test/.test.mjs,无第三方依赖。

发布流程: bash

1. 改 package.json 的 version

npm test
npm publish # 2. 发布到 npm
git tag -a v<version> -m "<说明>" # 3. 打 tag
git push origin main --tags # 4. 推送并创建 GitHub Release

常见问题

需要先装 MAA 吗?
不需要。插件会自己准备运行时;系统里已有的 MAA 也不会被影响。

会覆盖我现有的 MAA 配置吗?
不会。所有读写都限制在私有运行时目录内,通过四个 MAA__DIR 环境变量隔离。

装了插件以后原来的 MAA 还能用吗?
能。两者互不干扰。

为什么不把 MAA 打包进 npm 包?
MaaCore 与资源有几百 MB,且 MAA 采用 AGPL-3.0,重新分发需要承担相应的源码义务。按需下载更轻,也更容易跟随上游更新。

支持哪些服?
Official、Bilibili、Txwy(台服)、YoStarEN/JP/KR。用自然语言指定即可,例如「日服刷 1-7 两次」。

能一次刷 100 次以上吗?
单条命令上限 100;需要更多可以分多次执行。

任务跑到一半能暂停吗?
MaaCore 没有可靠的暂停/继续接口,只能停止(/maa stop),停止后不会自动补完剩余局数。

日志在哪里?
私有运行时下的 state/debug/;也可以用 maa_query 的 log_dir 查询实际路径。

更新日志

查看更新日志

许可与致谢

- 插件本身:MIT。
- 插件不附带 MaaCore。运行时会从官方渠道下载 MAA 与 maa-cli,它们遵循各自的许可(MAA 为 AGPL-3.0),下载后请遵守上游协议。
- 感谢 MaaAssistantArknights 团队维护 MAA 与 maa-cli,以及 DeepSeek Harness 提供插件机制。
预览分享卡片长什么样 ↓nhyo/dsh-maa-cli
分享 · DeepSeek Harness Hub
nhyo/dsh-maa-cli

用本地命令或一句话完成明日方舟日常任务

这是你的仓库?认领条目

回到顶部