快速开始
十分钟从零到跑通第一条命令:先验环境,再跑工具。
需要什么
DSHA 自己不带运行时。它检查你机器上有没有这些东西,缺了就告诉你:
| 依赖 | 最低要求 | 用在哪 |
|---|---|---|
| Node.js | 18 以上 | 门禁插件、路由、CLI |
| Python | 3.10 以上 | 词表校验器、书记官、索引 |
| Git | 任意较新版本 | 书记官收集提交历史;可选 |
| PowerShell 7 | 可选 | 加固 shell;没有则退回 Windows PowerShell |
先确认依赖再往下走。 跳过这步的人,后面每一条命令都会失败,而失败原因看起来会像"DSHA 坏了"。
第一步:看本机环境
dsha envfeel
它会打印一份实测清单:平台、Node 版本、Python 版本、每个工具在哪、哪些没找到。
注意两点:
- 它只报测到的,不报推断的。找不到就写"未找到",不会猜。
- 显式指定错了路径时(例如
DSHA_PYTHON指向不存在的文件),它会报错而不是偷偷换一个。
第二步:看有哪些工具
dsha-index list
输出七行,每行一个工具,并标出依赖是否就位。
第三步:跑第一条命令
dsha rea inspect-artifact "<某个文件的路径>" --json
或者用路由层,让它自己判断该调哪个工具:
dsha route "帮我解包这个 app.asar 看内部源码"
装不上 / 跑不起来
返回到故障排查。那一页按报错码分类,对号入座即可。