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.
16 KiB
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 -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-onlyinstall.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
新增:更新检查 + 一键升级
回答「我这边更新了,用户怎么知道 / 他该怎么做」。
三条得知路径
moyun_ultimate_profile的update段:current/latest/available/howTo- 新工具
moyun_check_update(force: true强制重查) - 插件启动时后台自动查一次,有新版本写进 DSH 日志
一条命令升级
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 -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-sqliteindex.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-configexit 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 的插件同时装会互相覆盖,两个都废