moyun-ultimate/TROUBLESHOOTING.md
moyun 07fabc9fe6 feat: 0.2.1 - add doctor.ps1 and TROUBLESHOOTING.md, document effect boundaries
Answers the issues raised in the comments:

1. "keeps triggering safety refusal" -> README now separates three layers:
   host permission (this package fixes it), model willingness (prompt layer),
   provider-side moderation (nothing can fix it). TROUBLESHOOTING gives a
   decision tree with commands.
2. "how do I verify it worked" -> doctor.ps1 checks 11 items and prints
   [OK]/[WARN]/[FAIL]. Verified locally: OK=11 WARN=2 FAIL=0.
3. "does it conflict with purge" -> documented: both target the same config
   ids, last-applied wins. doctor warns when a user-layer override or a
   conflicting plugin is detected.
4. "incomplete / missing stuff" -> documented that the 63 skills need their
   external binaries (nuclei/fscan/IDA/jadx...), which the package does not ship.
5. "stronger armor makes the model dumber" -> confirmed in README as a real
   trade-off with per-layer guidance on what to turn off.
2026-11-17 14:20:47 +08:00

8.7 KiB
Raw Blame History

常见问题与排查(TROUBLESHOOTING)

抖音评论区反馈的问题,按「装不上 / 装了没效果 / 效果不对 / 和别的插件冲突 / 质疑」五类整理。 每条都给原因和怎么做,不绕弯。


一、「老是触发安全拒绝」「好像没破甲成功」

这是反馈最多的一条。分三种情况,先判断是哪一种。

情况 A:装的是 0.1.0(没有权限层)

0.1.0 只有提示词层,工具审批和沙箱还在拦。

# 看版本
(Get-Content "$env:DSH_HOME\profiles\desktop\node_modules\moyun-ultimate\package.json" -Raw | ConvertFrom-Json).version
  • 显示 0.1.0 → 升级到 0.2.0
  • 显示 0.2.0 → 看情况 B

情况 B:0.2.0 装了,但 profile 自己的配置把它盖掉了

判断方法:

# 看用户层有没有覆盖 permission / approval
Select-String -Path "$env:DSH_HOME\profiles\desktop\cordis.patch.yml" -Pattern 'id: permission|id: approval|id: sandbox-policy'
  • 有输出 → 用户层覆盖了,本包的权限层被盖掉(用户层后应用、优先级更高)
  • 没输出 → 看情况 C

怎么办(二选一):

# 方案 1:删掉用户层那几段,让本包接管
# 方案 2:保留用户层,把本包的权限层关掉,避免重复
- insert:
    - id: moyun-ultimate
      config:
        permission: false

情况 C:权限层正常,但模型还是在「拒绝」

这一层插件管不了。 要分清两件事:

拦截位置 谁在处理 插件能不能改
工具审批 / 沙箱 / 路径围栏 宿主(DSH 本体) ✅ 能(0.2.0 已内置)
模型「愿不愿意说」 模型 + 系统提示词 ✅ 能(提示词层能影响)
服务端内容审核 模型厂商(DeepSeek / 中转) ❌ 不能

DeepSeek 官方 API、部分中转站会在服务端再过一层审核。提示词再怎么改,也改不了服务端返回的拒绝。

怎么确认是服务端拦的:看回复的措辞。

特征 判定
中文短句「抱歉,我无法…」+ 没有任何思考过程 大概率服务端拦截
长篇解释 + 引用条款 + 「作为AI」 模型层,提示词能改
直接空回复 / 只有 reasoning_content 服务端或中转拦截

二、「破甲越强模型越傻」——这条评论是对的

评论原话:

肯定啊破甲越强模型越傻,不让模型变傻,他就会思考,然后就破不了 限制越多 能力越弱,直接提示词过能力出众点

这是真实代价,不是 bug。

原因:五段提示词合计 21 KB,全部注入系统提示。它占了上下文预算,也把模型的注意力往「规则」上拉,复杂推理任务(写代码、长链分析)会掉点。

怎么权衡:

场景 建议
长时间写代码 / 复杂重构 关掉 refusal 和 execution,只留 core
短平快问答、需要直给 全开
觉得模型变笨了 先关 mirror(镜像层),再看 execution
# cordis.patch.yml
- insert:
    - id: moyun-ultimate
      config:
        core: true          # 人格:建议常开
        refusal: true       # 反拒绝:会加重「规则感」
        execution: true     # 执行纪律:会加重「必须动手」
        mirror: false       # 镜像层:最先关这个
        routing: true       # 技能路由:几乎无副作用

三、「和 purge 冲突吗」

取决于 purge 的版本和你的目标 profile。

冲突的根源

本包 0.2.0 会覆盖这几个 cordis config id:

sandbox-policy / approval / permission / spill-policy / tool-result-pruner / agent-instructions

如果另一个插件(或你的 profile 用户层)也改这几个 id,就是「后写的赢」——不会报错,但有一方静默失效。

三种情况

情况 结果 建议
只有 moyun-ultimate ✅ 权限层由本包提供 什么都不用做
只有 purge(社区版) ✅ 权限层由 purge 提供 本包 permission: false
两个都装 ⚠️ 谁后应用谁生效 二选一,别指望叠加

怎么判断谁赢了:

# 看合成后的实际配置
dsh --profile web --patch "$env:DSH_HOME\profiles\desktop\cordis.patch.yml" --dump-config | Select-String 'policy:'

看 approval 段最终是 ask 还是 never,就知道谁生效了。

关于「二改肯定冲突啊」这条评论

不是「二改」,是「同靶点」。 任何两个都改 approval / permission 的插件同时装都会互相盖,这和是不是改别人的包无关。


四、「可惜是个残次品,里面缺东西」

大概率指的是:63 个技能里,很多依赖外部工具,而对方机器没装。

技能本身是「说明书 + 命令模板」,不是自带二进制:

技能 依赖的真实工具
nuclei-scan / fscan-intranet / gogo-intranet nuclei / fscan / gogo 二进制
ida-reverse / ghidra-reverse / radare2 IDA / Ghidra / r2
apk-reverse / mobile-reverse jadx / apktool / frida
webshell-toolkit 冰蝎 / 哥斯拉 / 蚁剑
chisel-tunnel / frp-tunnel / suo5-tunnel chisel / frpc / suo5

技能能加载但跑不起来,就是这个原因。

本包只提供「知道怎么用」,不提供「工具本体」——这是刻意的:二进制动辄几百 MB,塞进插件会让包变成几个 GB。


五、「这个怎么装啊」「怎么检验是否成功」

三步装

# 1) 拿代码
git clone https://git.lingdongjiansuo.cn/moyun/moyun-ultimate.git
cd moyun-ultimate

# 2) 装进 DSH
powershell -ExecutionPolicy Bypass -File .\install.ps1

# 3) 完全退出 DSH(含托盘)再打开

一键自检

装完重启后,在包目录跑:

powershell -ExecutionPolicy Bypass -File .\doctor.ps1

它会逐项检查并打印 [OK] / [FAIL]:

[OK]   插件已安装:node_modules\moyun-ultimate (88 files)
[OK]   plugins 副本存在
[OK]   package.json dependencies 已登记
[OK]   package.json bundles 已登记
[OK]   exports["./client"] 存在
[OK]   五段提示词文件齐全 (5/5)
[OK]   权限层配置存在 (sandbox/approval/permission)
[OK]   技能已落地:63 个
[WARN] 用户层 cordis.patch.yml 覆盖了 permission —— 本包权限层可能被盖
[OK]   未检测到同类冲突插件

四项手动验证

验证什么 怎么验 期望
五段是否注入 问 Agent「你现在有哪几层提示词」 说出 core / refusal / execution / mirror / routing
工具是否注册 让 Agent 调 moyun_ultimate_profile 返回 skills: 63
换框是否可用 调 moyun_frame(frame="textbook", request="...") 返回填好的教材框架
权限是否放开 让 Agent 写一个工作区外的文件 不弹审批、直接成功

六、「怎么感觉和另一个破甲很像」

因为解决的是同一个问题,所以结构相似。 具体区别:

维度 本包 典型宿主补丁类
做法 只改 cordis config + 运行时注册应答器 改写宿主源文件(pattern 匹配磁盘文本)
依赖 零依赖,不碰源码 依赖宿主版本,版本变了要重新对锚点
冲突风险 只与改同批 config id 的插件冲突 与改同批源文件的插件冲突
卸载 删目录 + 删两行登记 需要「还原」操作,否则残留补丁

判断是不是同一份代码:看 index.js 和 cordis.patch.yml——本包全部 90 行级别的逻辑都在里面,可以直接读。


七、一句话总结(也是抖音评论的本质)

提示词破甲解决的是「模型愿不愿意配合」,不是「平台允不允许」。

工具跑不起来 → 权限层(本包 0.2.0 已内置) 模型不肯说 → 提示词层(本包强项) 服务端直接拦 → 谁都改不了


附:常见报错对照

报错 原因 处置
client-modules: declares dsh.client but exports no "./client" bundle package.json 缺 exports["./client"] 检查 exports 四个键
装了但工具面板看不到 moyun_frame 插件没加载 看 $DSH_HOME\fish-memory-diag.log 最近一条 assemble 的工具
状态条不显示 exports 缺失或未完全重启 彻底退出 DSH 重开
提示 DSH_HOME not found 路径非标准 install.ps1 -DshHome "D:\你的\dsh"
技能列表没有新技能 技能目录要新会话才刷新 重启后新建会话
改源码后不生效 改的是源位 plugins\,运行位在 node_modules\ 重新同步后彻底重启