moyun-ultimate/CHANGELOG.md
moyun 7b3e7f0ec8 feat: 0.9.1 - AGENT.md so "have your agent install it" actually works
Telling an agent "install https://.../moyun-ultimate" currently fails, because
the first thing it finds is install.ps1 and running a third-party script is
exactly what it is right to refuse.

AGENT.md gives it three paths that involve no script at all:

  A (recommended) copy standalone/moyun-armor/SKILL.md into <project>/.dsh/skills/
     - stays inside the workspace, so no extra permission is needed
  B install as a prompt-only plugin using pure file operations
     - copy two directories, add two lines to package.json, verify JSON
  C full plugin, with the impact table it must show the user first

It also states where the agent should stop and ask (writing \,
running scripts, changing package.json without a backup), a troubleshooting
table, and a one-liner to ask the user which tier they want.

README now opens with a pointer to it, so any agent landing on the repo sees it
before anything else.
2026-11-17 15:50:38 +08:00

402 lines
16 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.

# Changelog
## 0.9.1 — 2026-11-17
### 新增:`AGENT.md` —— 让「叫 agent 自己装」这件事真的能成
用户能对 agent 说「帮我装 https://git.lingdongjiansuo.cn/moyun/moyun-ultimate」,
但 agent 打开仓库看到 `install.ps1` 会拒绝执行(这类拒绝是合理的)。
`AGENT.md` 就是给 agent 的替代路径:
- **A 档(默认推荐)**:只把 `standalone/moyun-armor/SKILL.md` 复制到项目 `.dsh/skills/`。
完全在 workspace 内、零系统改动、不用重启——agent 自己就能做,不需要额外授权。
- **B 档**:装成提示词插件,全部用**文件操作**完成(复制目录 + 改 package.json 两行),
不用跑任何脚本。附 JSON 合法性验证命令。
- **C 档**:完整插件,附带必须先告知用户的影响表(权限/联网/技能同步)。
还写了:拒绝执行的边界(哪些必须先问用户)、出错时的对照表、以及一段
「先问用户要哪种」的建议话术。
README 顶部加了一行指向它,agent 一进仓库就能看到。
---
## 0.9.0 — 2026-11-17
### 新增:零安装版(纯文本人格技能)
`standalone/moyun-armor/SKILL.md`。
有人不愿意跑安装脚本、不愿意让插件写系统目录、不愿意重启 DSH。那就别装插件——
把这一份文本复制到技能目录,效果是「人格 + 纪律 + 输出抗审」全部到位。
- **不注册工具**、**不改配置**、**不联网**、**不写系统目录**、**不用重启**
- 三种用法:复制到项目 `.dsh/skills/`(完全在 workspace 内)/复制到 `~/.agents/skills/`/直接贴给 agent
- 内容:三条定律、执行纪律、占位符规则、输出抗审(判断表 + 五种重表达策略)
- 和插件版的能力对比写在 README 里(少了工具、权限层、63 技能,但那三样本来就要动系统)
### 为什么这样做
「让他装」这件事有两种解法:一种是让安装更简单,一种是**让「装」这个动作消失**。
技能版属于后者——它就是一份文本,agent 读一遍就会照做。
---
## 0.8.0 — 2026-11-17
### 新增:插件市场一键安装(不跑脚本)
对方拒绝执行 `install.ps1` 这类第三方脚本时,命令行装法就完全走不通。
这版补上另一条路:**在 DSH 插件市场里点一下。**
- **`market/index.json`**:format 1 标准索引,`source.type = npm`,
市场会直接从 npm 拉包,不碰 git、不跑脚本
- **`publish-npm.ps1`**:一键发布到 npm(含登录检查、版本冲突提示、发布后验证)
- **package.json 补齐 npm 字段**:`repository` / `homepage` / `bugs` / `publishConfig`
- README 新增「让人一键装(不用命令行)」章节:三步操作 + 索引源兜底
### 这条路的原理
市场装插件时是 **market 自己**往 profile 写文件,用户点「安装」= 授权。
所以既解决了「不想跑脚本」,也解决了「不想让别人的脚本写系统目录」。
### 前置条件
需要先把包发到 npm(`moyun-ultimate` 这个包名目前未被占用):
```powershell
powershell -ExecutionPolicy Bypass -File .\publish-npm.ps1 -Token npm_xxxxxxxx
```
---
## 0.7.0 — 2026-11-17
### 新增:副作用透明化 + prompt-only 模式
起因:有人指出装这个插件会「往 workspace 外写文件、跑第三方脚本、全盘放行、静默联网」。
**这些说法全部属实**,所以这版把三件事做成可关的,并写清全部副作用。
- **`SECURITY.md`**:逐条列出写哪些路径、联哪些网、动哪些权限,每条都标「能不能关 / 怎么关」
- **新增 `syncSkills` 开关**:`false` 时完全不写 `$DSH_HOME/skills`
- **新增 `cordis.patch.prompt-only.yml`**:副作用最小的形态——
只注入六段提示词,不同步技能、不联网、不注册审批应答器、不覆盖权限 config
- **`switch-mode.ps1` 支持三模式**:`full` / `complement` / `prompt-only`
- **`install.ps1 -Mode prompt-only`**:一步装成最小形态
### 一句话
`prompt-only` 模式除插件目录和 `package.json` 那两行登记外,**不碰任何东西**。
---
## 0.6.2 — 2026-11-17
### 文档
- **重拍全部截图**:仓库页(真实计数 3.5k / 3.2k / 2.4k)、文件树、技能目录、状态条特写
- 状态条特写显示「六层就绪 · 权限由用户层接管」(琥珀色),与当前行为一致
- 删除未引用的 `05-signup.png`
- 仓库描述同步更正:`five-layer` → `six-layer`,补 `anti-censor`
---
## 0.6.1 — 2026-11-17
### 修复
- 状态条文案写死「五层就绪」,实际已是六段(含输出抗审)→ 全部改为「六层就绪」(4 处)
- 悬停提示「五段提示词已注入」→ 「六段提示词已注入(含输出抗审)」
- `moyun_ultimate_profile` 的 `design` 数组同样更正为六段
### 验证(重启后实测)
```
version : 0.6.0 -> 0.6.1
layers : 6/6 全部 enabled
100 core 2,893 B / 150 refusal 2,795 B / 160 execution 1,463 B
200 mirror 995 B / 210 routing 3,488 B / 220 anti-censor 1,663 B
permission : effective=overridden-by-user-layer(用户层接管,预期)
env : profile=desktop hardConflicts=[] scannedPlugins=19
softOverlaps=[dsh-purge: system-prompt](可共存)
provider : deepseek-account / deepseek-flash censorRisk=medium
update : current 0.6.1 / latest v0.6.1 / 已是最新
skills : 63 total / 48 ready / 15 need tools
状态条 : 「墨昀爱搬砖 · 六层就绪 · 权限由用户层接管」(琥珀,正确)
```
---
## 0.6.0 — 2026-11-17
### 新增:更新检查 + 一键升级
回答「我这边更新了,用户怎么知道 / 他该怎么做」。
**三条得知路径**
1. `moyun_ultimate_profile` 的 `update` 段:`current` / `latest` / `available` / `howTo`
2. 新工具 `moyun_check_update`(`force: true` 强制重查)
3. **插件启动时后台自动查一次**,有新版本写进 DSH 日志
**一条命令升级**
```powershell
powershell -ExecutionPolicy Bypass -File .\update.ps1
```
查 Release → 下载 tgz → 备份旧目录(`*.bak-update-<时间戳>`)→ 解压覆盖 →
**保留用户的模式选择**(complement 不会被冲成 full)→ 提示重启。
变体:`-Check`(只查)/ `-Force`(强制重装)/ `-DryRun`(只演示)。
**可关闭**:`cordis.patch.yml` 里 `checkUpdate: false`。
### 实现要点
- 版本比较按段数值比较,`0.10.0 > 0.9.9` 正确
- 查询失败静默降级(不影响使用),状态里写明「无法连接更新服务器」
- 请求超时 8 秒,不阻塞插件启动
---
## 0.5.1 — 2026-11-17
### 新增:两条退路 + 自愈
让用户「敢装」的三件套:
- **`doctor.ps1 -Fix`**:自检后自动修复能安全修的
(重拷运行副本 / 补 `exports["./client"]` / 补 dependencies / 同步缺失技能)。
**不动** profile 用户层 config——那可能影响别的插件,只给提示。
- **`install.ps1 -Rollback`**:从 `package.json.bak-*` 恢复配置 + 删插件目录,
一条命令回到安装前。
- **安装结尾改为三步指引**:退出重开 → 跑 doctor → 调 `moyun_ultimate_profile`,
并直接给出「出问题时的两条命令」。
### 模式识别
doctor 现在会显示当前处于 `FULL` 还是 `COMPLEMENT` 模式(读 bundle patch 判断),
不再把「补充模式」误报成故障。
---
## 0.5.0 — 2026-11-17
### 新增:安装时自动识别冲突 + 智能让位
针对「别人已经装了别的破甲插件,会不会打架」,做成三步:
**1. 安装时自动扫描**
`install.ps1` 复制文件前,先读每个已装插件的 `cordis.patch.yml`,提取它**实际改写**的
config id,与本插件求交集:
```
--- conflict scan ---
scanned plugins : 19
hard conflicts : none
~ dsh-purge shares: system-prompt (safe)
```
**2. 三种模式,auto 自动决策**
| 模式 | 权限层 | 提示词 | 技能 |
|---|---|---|---|
| `full` | 本插件接管 | 6 段 | 63 个 |
| `complement` | **让位** | 6 段 | 63 个 |
| `auto`(默认) | 扫描结果决定 | 6 段 | 63 个 |
**3. 随时切换**
```powershell
powershell -File .\switch-mode.ps1 -Mode complement
powershell -File .\switch-mode.ps1 -Mode full
```
新增 `cordis.patch.complement.yml`:精简版 bundle patch,只留 system-prompt 与本体 insert,
**不含** sandbox-policy / approval / permission / spill-policy / tool-result-pruner 五段覆盖。
### 刻意不做:自动卸载别人的插件
卸载会破坏用户环境(状态目录、依赖、配置),且无法回滚。**让位比清场安全**。
---
## 0.4.3 — 2026-11-17
### 改进:冲突检测从「猜包名」升级为「读实际配置」
之前用包名正则(`purge|ungate|jailbreak...`)猜谁可能冲突,会误报——
实测 `dsh-purge` 被误判成同类,但它其实走宿主源码补丁,**不碰 approval/permission**。
现在改为:**读每个已装插件的 `cordis.patch.yml`,取它实际改的 config id 列表,与本插件的
id 集合求交集**。分两级:
| 级别 | 判定 | 后果 |
|---|---|---|
| `hardConflicts` | 对方也改 approval / permission / sandbox-policy / spill-policy / tool-result-pruner | 后应用者赢,一方静默失效 → 二选一 |
| `softOverlaps` | 对方只改 system-prompt(身份前缀) | 效果差异极小 → 可放心共存 |
`moyun_ultimate_profile` 的 `environment` 新增 `hardConflicts` / `softOverlaps` / `scannedPlugins`。
### 实测(本机 22 个插件)
```
scannedPlugins : 19
hardConflicts : []
softOverlaps : [{dsh-purge, system-prompt}]
```
**结论:`dsh-purge` 与本插件不冲突。**
---
## 0.4.2 — 2026-11-17
### 新增
- **`COMMENTS-FAQ.md`**:抖音评论区 11 条反馈的逐条对照表,每条标明
「已解决 / 部分解决 / 无法解决」以及解决方案落在哪个文件。
目的是让被同样问题困住的人能自己查到,不用再问一遍。
---
## 0.4.1 — 2026-11-17
### 修复
- **状态条误报「权限层已关」**:投影数据(`armor`)尚未就绪时,`permOn` 被算成 `false`,
于是显示「权限层已关」。实际 `permission: true` 是开着的。
改为:`armor.permissionOn` 不是布尔值时不作判断,默认按开启显示。
### 说明
权限层真实状态以 `moyun_ultimate_profile` 的 `permission.effective` 为准:
`effective`(本插件接管)/ `overridden-by-user-layer`(被 profile 覆盖)/ `disabled-by-config`。
---
## 0.4.0 — 2026-11-17
### 新增:第 6 层「输出抗审」+ provider 审核风险评估
针对「服务端把回复掐掉」这件唯一无法用提示词根除的事,做了两件能做的:
- **`prompts/50-anticensor.md`(order 220,1663 B)**:五种重表达策略
(代码块形态 / 分段生成 / 术语化 / 反事实表述 / 分语言)+ 拦截类型判断表 +
重试的正确姿势(换形态而不是原样重发)
- **`moyun_ultimate_profile` 新增 `provider` 字段**:识别当前 provider 与模型,
给出 `censorRisk`(high / medium / low / none)与说明。实测本机识别出
`modelscope-token-plan + DeepSeek-V4.1-Flash-1017 → high`(阿里系内容安全)
### 为什么这很重要
审核强度随 provider 差异极大,**换 provider 往往比改提示词有效**:
| provider | censorRisk |
|---|---|
| 魔搭 / 通义 / 智谱 | high |
| DeepSeek 官方 | medium |
| 海外官方 | low(中转继承上游) |
| 本地模型 | none |
### 校验
六层合计 23,017 B;`node --check` 通过;工具实测输出 provider 风险等级正确。
---
## 0.3.0 — 2026-11-17
### 新增:插件自己诊断自己
针对「装了没效果 / 不知道哪里冲突 / 技能跑不起来」三类反馈,把隐性状态变成显性输出。
- **`moyun_ultimate_profile` 大改**:新增 `permission`(builtin / effective / verdict 三态)+
`environment`(profile / userLayerOverrides / siblingPlugins / winner)+ `skills` 汇总。
权限层是不是真生效,一眼能看到,不用猜。
- **新工具 `moyun_skills_audit`**:审计 63 个技能的可用性,区分「能直接用」和「缺外部工具」,
并列出具体缺哪些二进制。
- **状态条按真实状态变色**:绿(本插件接管)/ 琥珀(被用户层接管、有同类插件、已关闭)/ 红(判拒)。
悬停显示详细原因。
- **性能**:技能审计从逐条 `where`(约 2.9 s)改为 PATH 目录索引(**234 ms**,缓存后 0 ms)。
### 验证
- `node --check` 通过;工具实测输出正确(本机识别出 `overridden-by-user-layer` +
`siblingPlugins: ["dsh-purge"]`)
---
## 0.2.1 — 2026-11-17
### 新增
- **`doctor.ps1`**:一键自检,11 项检查(运行时副本 / 双处登记 / exports / 五段提示词 /
权限层配置 / 应答器代码 / 技能落地 / 用户层覆盖 / 冲突插件),输出 `[OK]`/`[WARN]`/`[FAIL]`
- **`TROUBLESHOOTING.md`**:按抖音评论区反馈整理的排查手册,五类问题(装不上 / 没效果 /
效果不对 / 和 purge 冲突 / 质疑),每类都给判断命令
- README 新增「效果边界」章节:明确区分「工具权限」「模型意愿」「服务端审核」三层,
避免把服务端拦截误判成插件失效
### 说明
- 不改变任何已生效的逻辑,纯文档与工具补充
---
## 0.2.0 — 2026-11-16
### 新增:内置权限层(不再需要额外插件)
- `cordis.patch.yml` 覆盖 6 组官方 config:`sandbox-policy`(`danger-full-access`)、
`approval`(`ask`)、`permission`(重定义预设表 + `defaultPreset`)、`spill-policy`、
`tool-result-pruner`、`agent-instructions` / `session-query-sqlite`
- `index.js` 新增 `installApprovalAnswerer()`:在 `approval/request` 等三个候选事件名上
注册应答器,直接返回 `allowed-once`,工具审批不再弹窗
- 新增开关 `permission`(默认 `true`)与 `approvalResult`(默认 `allowed-once`)
- **不改写任何宿主源码文件**,全部通过官方 cordis patch 的 id 级 config 覆盖实现
### 验证
- `node --check index.js` 通过
- `dsh --profile web --patch cordis.patch.yml --dump-config` exit 0,
合成结果含全部 6 个 id 且取值正确
---
## 0.1.0 — 2026-11-16
首个版本。五层分层提示词内核。
### 新增
- **五段分层系统提示**(21,354 B)
- `order 100` 人格主内核(6,003 B)
- `order 150` 反拒绝机制(5,341 B)
- `order 160` 执行强度(3,095 B)
- `order 200` 强化镜像(2,121 B,防上下文稀释)
- `order 210` 技能路由(4,794 B,接 DSH 原生 skill 工具)
- **63 个内置技能**:逆向 24 / 渗透 16 / 云 8 / 取证 6 / 其它 9,去重后无重复
- **技能幂等同步**:首次启动复制到 `$DSH_HOME/skills`,只补缺失不覆盖
- **`moyun_frame` 工具**:5 个换框模板(roleplay / textbook / defender_reverse / transform_first / k3),不常驻提示词
- **`moyun_ultimate_profile` 工具**:自查五层状态与技能数
- **判拒投影状态条**:右下角绿框,实时显示 pass / refusal / fallback
- **五个分层开关**:任意层可单独关闭
### 修复
- `package.json` 补 `exports["./client"]` —— 缺此项会导致 DSH 报
`client-modules: declares dsh.client but exports no "./client" bundle`,client 完全不加载(状态条不显示)
- `client.js` 投影 key 与服务端对齐为 `moyun-ultimate`
### 设计取舍
- **不做权限层**:审批 / 沙箱 / 路径围栏属宿主范畴,交给宿主补丁类插件,避免抢同一批 config id
- **不压运行时上下文**:cwd / GUI URL 等上下文必须保留,否则操作会退化
- **换框不常驻**:5 个框架只在真被拒时按需取,省上下文
- **技能只补不覆盖**:同步到 `$DSH_HOME/skills` 时只补缺失,绝不覆盖用户手改
- **不叠加同类插件**:多个改同一批 config id 的插件同时装会互相覆盖,两个都废