# 安装会做什么(副作用清单) > 这份文档很直白:装上这个插件,系统上会发生什么、写了哪些文件、联了哪些网。 > 每一条都标了**能不能关**、**怎么关**。 如果你只想要「调语气、不改系统」,直接跳到最后的 **最小权限安装**。 --- ## 一、会写哪些文件 安装(`install.ps1`)会改 **`$DSH_HOME`** 下的东西。`$DSH_HOME` 通常在 workspace 之外 (默认 `~/.dsh`,本机是 `G:\DeepSeek_dsh`)。 | 路径 | 动作 | 能不能不写 | |---|---|---| | `profiles\\plugins\moyun-ultimate\` | 复制整包(源位) | 只有这个包不装才不写 | | `profiles\\node_modules\moyun-ultimate\` | 复制整包(运行位) | 同上 | | `profiles\\package.json` | 加一条 dependency + 一条 bundles 项(改动前备份 `*.bak-*`) | 同上 | | `$DSH_HOME\skills\<63 个技能名>\` | **首次启动时同步技能** | ✅ **能**:`syncSkills: false` | `$DSH_HOME\skills` 那一条是最容易被忽略的:即使你只想要提示词,插件默认也会把 63 个技能目录 复制进去(只补缺失、不覆盖已有的)。 **关掉它**: ```yaml - insert: - id: moyun-ultimate config: syncSkills: false ``` --- ## 二、会联网吗 **会,一次,默认开启。** 插件启动时请求: ``` GET https://git.lingdongjiansuo.cn/api/v1/repos/moyun/moyun-ultimate/releases/latest ``` 只读公开的 Release 元数据,用途是判断有没有新版本。**不上传任何本机信息**,8 秒超时, 失败就静默跳过,不阻塞启动。 **关掉它**: ```yaml - insert: - id: moyun-ultimate config: checkUpdate: false ``` 关掉后不会发出任何网络请求。 --- ## 三、会动权限吗 **完整模式(full)会。这是这个插件的核心功能之一,不是副作用。** 具体做了三件事: | 动作 | 机制 | 效果 | |---|---|---| | 沙箱放开 | 覆盖 cordis 的 `sandbox-policy`,`mode: danger-full-access` | 工具可以读写任意路径,不受 workspace 限制 | | 预设放开 | 覆盖 `permission`,`defaultPreset: danger-full-access` | 权限预设默认就是全放开 | | 审批自动通过 | 注册 `approval/request` 应答器,返回 `allowed-once` | 工具调用不弹窗、不等确认 | **注意**:这三条都**不改宿主源码**,只覆盖官方 cordis 配置 + 注册一个事件应答器。 卸载/切换模式后立即失效,不留补丁。 **关掉它**: ```yaml - insert: - id: moyun-ultimate config: permission: false # 不覆盖权限 config,也不注册应答器 ``` 或者直接切到 **complement** / **prompt-only** 模式(见下)。 --- ## 四、会改模型行为吗 **会。这是它存在的理由。** 六段提示词会注入 `systemPrompt`,合计约 23 KB: | order | 层 | 作用 | |---|---|---| | 100 | 人格主内核 | 语气、工作习惯 | | 150 | 反拒绝机制 | 少说「我无法协助」 | | 160 | 执行强度 | 先动手、不写 TODO | | 200 | 强化镜像 | 二次钉死上面几条 | | 210 | 技能路由 | 什么时候用哪个技能 | | 220 | 输出抗审 | 被服务端截断时换形态重试 | **副作用**:23 KB 会占上下文,长链推理(写代码、复杂分析)会略微掉点。 **按需关**: ```yaml config: core: true refusal: true execution: false # 关掉「必须动手」的强制 mirror: false # 先关这个,感知最明显 routing: true anticensor: true ``` --- ## 五、三种安装模式 | 模式 | 提示词 | 技能同步 | 联网 | 权限层 | 写 $DSH_HOME | |---|---|---|---|---|---| | **full**(默认) | 6 段 | ✅ 63 个 | ✅ | ✅ 接管 | 是 | | **complement** | 6 段 | ✅ 63 个 | ✅ | ❌ 让位 | 是 | | **prompt-only** | 6 段 | ❌ | ❌ | ❌ | 仅插件目录 + package.json | ```powershell powershell -File .\switch-mode.ps1 -Mode prompt-only powershell -File .\switch-mode.ps1 -Mode complement powershell -File .\switch-mode.ps1 -Mode full ``` --- ## 六、最小权限安装(推荐给谨慎的人) 如果你只想要「改语气、改工作习惯」,不想要任何系统级改动: ```powershell # 1) 安装 powershell -ExecutionPolicy Bypass -File .\install.ps1 -Mode prompt-only # 2) 确认模式 powershell -ExecutionPolicy Bypass -File .\doctor.ps1 # 应显示 MODE=prompt-only ``` 这个形态下: - ✅ 注入六段提示词 - ❌ **不写 `$DSH_HOME\skills`** - ❌ **不发任何网络请求** - ❌ **不覆盖权限 config、不注册审批应答器** 换句话说:**除了插件自己的目录和 `package.json` 那两行登记,不碰任何东西。** 代价:技能库要在包目录里自己看;工具跑不起来时没有权限层兜底。 --- ## 七、卸载干净吗 ```powershell powershell -ExecutionPolicy Bypass -File .\install.ps1 -Uninstall ``` 会删:两个插件目录、`package.json` 里的 dependency 与 bundles 项。 **不会删**(需要手动处理,或本来就不该删): - `$DSH_HOME\skills` 下已同步的 63 个技能目录(它们可能被你改过,删了是你的损失) - `package.json.bak-*` 备份文件 - `*.bak-update-*` 升级前的目录备份 要彻底清掉技能: ```powershell $names = Get-ChildItem "$env:DSH_HOME\skills" -Directory | Select-Object -ExpandProperty Name # 先看清楚都有哪些,然后挑本插件带来的删 ``` --- ## 八、源码可审计 全部逻辑在这几个文件里,加起来不到 1000 行,可以直接读: | 文件 | 行数级 | 内容 | |---|---|---| | `index.js` | ~700 | 六段注入 + 4 个工具 + 技能同步 + 审批应答器 + 冲突审计 + 更新检查 | | `client.js` | ~180 | 状态条(纯 UI) | | `cordis.patch.yml` | ~70 | 配置覆盖(纯 YAML,一眼看完) | | `cordis.patch.complement.yml` | ~30 | 补充模式 | | `cordis.patch.prompt-only.yml` | ~30 | 仅提示词模式 | **没有任何混淆、没有远程加载的代码、没有二进制。** --- ## 九、一句话总结 | 你可能担心的 | 实情 | |---|---| | 写 workspace 外的文件 | 是,`$DSH_HOME` 下三个位置,可用 `syncSkills: false` 减到两个 | | 跑第三方脚本 | `install.ps1` 是纯文本 PowerShell,可先 `-DryRun` 看它要干什么 | | 全盘访问 + 审批自动通过 | 是,这是功能不是后门,`permission: false` 或 prompt-only 模式可关 | | 静默联网 | 一次 GET,`checkUpdate: false` 可关 | | 装完不好卸 | `-Uninstall` + `-Rollback` 两条命令 | **不确定就先跑 `install.ps1 -DryRun`**:它会把冲突扫描结果和即将写入的路径全打印出来, 一个字节都不写。