dsh-maa-cli: A DSH plugin that drives Arknights routines with local commands

What Does It Do?

It is a DSH plugin for DeepSeek Harness that turns the daily routine of Arknights into a single local command. It solves the problem of wanting automated sanity farming, base rotation and recruitment without spending a model call every time: routine actions run through the local command channel with zero model calls, and only complex requests are handed to the model to assemble one plan. The plugin ships its own private runtime, fully isolated from any MAA already installed on the system, and is maintained by nhyo under the MIT license.

Core Features

• Zero-model local commands: typing /maa fight, /maa infrast or /maa rouge opens a parameter panel; nothing runs until you edit and confirm, and nothing enters the model context.
• Confirmation split from execution: a natural-language request costs one model call to produce a plan saved to disk, and execution is triggered by a local confirm button; plans are valid for 30 minutes and single-use.
• Bundled private runtime: no pre-installed MAA is required; on the first real task it downloads maa-cli, MaaCore and resources, isolated from any existing MAA setup.
• Stoppable while running: it only terminates the maa-cli process tree started by this session, leaving the game, emulator and other MAA instances untouched.
• Operator box lookup and training advice: scan results are cached locally, so you can ask in natural language which six-star operators you own and get auditable training suggestions based on community ranking rules.
• On-demand updates: at most one official update call per 24 hours before a new task, and the training ranking is checked only when you ask for advice.

How to Use This Plugin?

After enabling it in DSH, make sure your emulator is running, then type a command such as /maa fight to open the matching panel, choose stage, run count and other options, and click the confirm button to actually control the game. Complex requests can be stated directly, for example starting the game, clearing the base, farming 1-7 ten times and then claiming rewards; DSH produces an ordered plan and shows a confirmation bar, and execution happens locally after you confirm. Use /maa setup to prepare the runtime ahead of time, and the stop button on the confirmation bar is equivalent to /maa stop while a task runs.

How to Troubleshoot This Plugin?

If the emulator is not running, the plugin reports that you should start the Mumu emulator manually; start it and confirm again, since no sanity is consumed and the plan stays valid. If remaining runs are not completed after stopping a task, that is expected: MaaCore has no reliable pause/resume interface, so stopping does not automatically finish the remaining rounds.