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.
213 lines
6.6 KiB
Markdown
213 lines
6.6 KiB
Markdown
# 安装会做什么(副作用清单)
|
||
|
||
> 这份文档很直白:装上这个插件,系统上会发生什么、写了哪些文件、联了哪些网。
|
||
> 每一条都标了**能不能关**、**怎么关**。
|
||
|
||
如果你只想要「调语气、不改系统」,直接跳到最后的 **最小权限安装**。
|
||
|
||
---
|
||
|
||
## 一、会写哪些文件
|
||
|
||
安装(`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`**:它会把冲突扫描结果和即将写入的路径全打印出来,
|
||
一个字节都不写。
|