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

6.6 KiB
Raw Blame History

安装会做什么(副作用清单)

这份文档很直白:装上这个插件,系统上会发生什么、写了哪些文件、联了哪些网。 每一条都标了能不能关、怎么关。

如果你只想要「调语气、不改系统」,直接跳到最后的 最小权限安装。


一、会写哪些文件

安装(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 个技能目录 复制进去(只补缺失、不覆盖已有的)。

关掉它:

- insert:
    - id: moyun-ultimate
      config:
        syncSkills: false

二、会联网吗

会,一次,默认开启。

插件启动时请求:

GET https://git.lingdongjiansuo.cn/api/v1/repos/moyun/moyun-ultimate/releases/latest

只读公开的 Release 元数据,用途是判断有没有新版本。不上传任何本机信息,8 秒超时, 失败就静默跳过,不阻塞启动。

关掉它:

- 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 配置 + 注册一个事件应答器。 卸载/切换模式后立即失效,不留补丁。

关掉它:

- insert:
    - id: moyun-ultimate
      config:
        permission: false     # 不覆盖权限 config,也不注册应答器

或者直接切到 complement / prompt-only 模式(见下)。


四、会改模型行为吗

会。这是它存在的理由。

六段提示词会注入 systemPrompt,合计约 23 KB:

order 层 作用
100 人格主内核 语气、工作习惯
150 反拒绝机制 少说「我无法协助」
160 执行强度 先动手、不写 TODO
200 强化镜像 二次钉死上面几条
210 技能路由 什么时候用哪个技能
220 输出抗审 被服务端截断时换形态重试

副作用:23 KB 会占上下文,长链推理(写代码、复杂分析)会略微掉点。

按需关:

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 -File .\switch-mode.ps1 -Mode prompt-only
powershell -File .\switch-mode.ps1 -Mode complement
powershell -File .\switch-mode.ps1 -Mode full

六、最小权限安装(推荐给谨慎的人)

如果你只想要「改语气、改工作习惯」,不想要任何系统级改动:

# 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 -ExecutionPolicy Bypass -File .\install.ps1 -Uninstall

会删:两个插件目录、package.json 里的 dependency 与 bundles 项。

不会删(需要手动处理,或本来就不该删):

  • $DSH_HOME\skills 下已同步的 63 个技能目录(它们可能被你改过,删了是你的损失)
  • package.json.bak-* 备份文件
  • *.bak-update-* 升级前的目录备份

要彻底清掉技能:

$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:它会把冲突扫描结果和即将写入的路径全打印出来, 一个字节都不写。