moyun-ultimate/SECURITY.md
moyun f7a064a9a8 feat: 0.7.0 - disclose every side effect and add a prompt-only mode
Someone reviewed the plugin and objected to three things: it writes outside the
workspace, it asks you to run a third-party install.ps1, and after installing it
you get full-disk access with approvals auto-granted plus a silent update check.

All three are accurate. This release does not argue with that; it makes each one
optional and documents it.

- SECURITY.md lists every path written, every network call, every permission
  change, and for each one says whether it can be turned off and how.
- syncSkills: false - do not copy the 63 skills into \/skills
- cordis.patch.prompt-only.yml - the smallest footprint: six prompt sections
  only, no skill sync, no network, no approval answerer, no permission override.
- switch-mode.ps1 gains a third mode: full / complement / prompt-only
- install.ps1 -Mode prompt-only installs in that shape in one step

In prompt-only mode the plugin touches nothing except its own directories and the
two lines it adds to package.json.
2026-11-17 15:35:27 +08:00

213 lines
6.6 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.

# 安装会做什么(副作用清单)
> 这份文档很直白:装上这个插件,系统上会发生什么、写了哪些文件、联了哪些网。
> 每一条都标了**能不能关**、**怎么关**。
如果你只想要「调语气、不改系统」,直接跳到最后的 **最小权限安装**。
---
## 一、会写哪些文件
安装(`install.ps1`)会改 **`$DSH_HOME`** 下的东西。`$DSH_HOME` 通常在 workspace 之外
(默认 `~/.dsh`,本机是 `G:\DeepSeek_dsh`)。
| 路径 | 动作 | 能不能不写 |
|---|---|---|
| `profiles\<profile>\plugins\moyun-ultimate\` | 复制整包(源位) | 只有这个包不装才不写 |
| `profiles\<profile>\node_modules\moyun-ultimate\` | 复制整包(运行位) | 同上 |
| `profiles\<profile>\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`**:它会把冲突扫描结果和即将写入的路径全打印出来,
一个字节都不写。