moyun-ultimate/TROUBLESHOOTING.md
moyun 2c50d1e79e feat: 0.4.3 - precise conflict detection (read actual config ids, not package names)
The old heuristic matched names like purge|ungate|jailbreak and reported
dsh-purge as a sibling. That was wrong: dsh-purge patches host source, it does
not touch approval/permission config ids at all.

Now the plugin reads every installed bundle's cordis.patch.yml, extracts the
config ids it actually rewrites, and intersects with its own set:

  hardConflicts - other plugin rewrites approval/permission/sandbox-policy/...
                  -> last-applied wins, one silently stops working -> pick one
  softOverlaps  - other plugin only rewrites system-prompt (identity prefix)
                  -> negligible difference -> safe to coexist

Measured on this machine (22 bundles): scanned 19, hardConflicts [],
softOverlaps [{dsh-purge, system-prompt}]. So dsh-purge and this plugin do NOT
conflict.
2026-11-17 14:53:13 +08:00

267 lines
9.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 常见问题与排查(TROUBLESHOOTING)
> 抖音评论区反馈的问题,按「装不上 / 装了没效果 / 效果不对 / 和别的插件冲突 / 质疑」五类整理。
> 每条都给**原因**和**怎么做**,不绕弯。
---
## 一、「老是触发安全拒绝」「好像没破甲成功」
这是反馈最多的一条。分三种情况,**先判断是哪一种**。
### 情况 A:装的是 0.1.0(没有权限层)
0.1.0 只有提示词层,工具审批和沙箱还在拦。
```powershell
# 看版本
(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 自己的配置把它盖掉了
**判断方法**:
```powershell
# 看用户层有没有覆盖 permission / approval
Select-String -Path "$env:DSH_HOME\profiles\desktop\cordis.patch.yml" -Pattern 'id: permission|id: approval|id: sandbox-policy'
```
- **有输出** → 用户层覆盖了,本包的权限层被盖掉(用户层后应用、优先级更高)
- **没输出** → 看情况 C
**怎么办**(二选一):
```yaml
# 方案 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` |
```yaml
# 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` |
| **两个都装** | ⚠️ 要具体看它改了什么 id | 见下「精确判定」 |
### 精确判定(不用猜)
**本插件改这 7 个 id**:`sandbox-policy` / `approval` / `permission` /
`spill-policy` / `tool-result-pruner` / `agent-instructions` / `session-query-sqlite`
```
moyun_ultimate_profile
→ environment.hardConflicts ← 非空 = 真冲突,要二选一
→ environment.softOverlaps ← 只共享 system-prompt,可放心共存
→ environment.scannedPlugins ← 实际扫描了多少个插件
```
工具会读每个已装插件的 `cordis.patch.yml`,看它实际改了哪些 id。
**实测参考(22 个插件)**:
```
scannedPlugins : 19
hardConflicts : []
softOverlaps : [{dsh-purge, system-prompt}]
```
→ **dsh-purge 与本插件不冲突**:它走宿主源码补丁,不碰 approval/permission。
**怎么判断谁赢了**:
```powershell
# 看合成后的实际配置
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。
---
## 五、「这个怎么装啊」「怎么检验是否成功」
### 三步装
```powershell
# 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
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\` | 重新同步后彻底重启 |