npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@fish-under-sea/magpie-purge

v0.8.4

Published

magpie-purge: a magpie page plugin that treats a local purge folder as a free plugin/skill source, inspects and validates what is in it, and rewrites the gateway's system prompt by mode (off / strict / replace / append).

Readme

magpie-purge

把本地 purge 目录当成 magpie 的「自由插件与技能源」:清点、校验、分类、去重、回滚, 再按模式把选中的人设与技能写进经过 magpie 网关的 agent 请求。

它是 magpie 的页面插件 + 网关钩子单包,不是 FISH Dock 插件,不依赖任何宿主补丁。

| | | | --- | --- | | npm | @fish-under-sea/magpie-purge | | 仓库 | https://github.com/Fish-under-sea/magpie-purge | | 侧栏名字 | 破甲&注入(magpie.page.titles) | | 许可 | MIT |

致谢

  • ZiChuanLan/agent-purge — 作者 ZiChuanLan,MIT。 本插件的四种 protocol 落点、off/strict/replace/append 模式语义、块结构保留、 stripIdentity 去身份策略都来自它;magpie-plugin/ 子目录是这条链的起点。没有它就没有这个包。
  • yetone/magpie — 页面插件与异步网关钩子的宿主契约 (magpie.page / magpie.options / page/_magpie/bridge.js / onRequest(body, ctx))由 magpie 提供。
  • 本机 dsh-purge 红队技能库 — 内置的 22 份技能来自它的 skills/redteam/(原文照搬,逐字未改), 逐条注明原文件。底座人设 大肥鱼 是为本插件新写的。

完整来源与改动范围见 THIRD_PARTY_NOTICES.md;上游 MIT 原文原样保留在 LICENSE 里(Copyright (c) 2026 ZiChuanLan)。

上游到底给了一套什么提示词

一句话:agent-purge 不提供「破甲提示词」,它提供的是把人设送进 system 的那套管道。

上游仓库里与「提示词」有关的只有两样东西,都不是越狱载荷:

① 一份起步模板 lib/templates/personas/neutral.md(1115 字节),正文就三段:

| 段落 | 内容 | | --- | --- | | 语言与格式 | 简体中文;先给结论再给依据;命令、路径、标识符保持原样 | | 工作方式 | 先读再改、最小改动、有证据再下结论(没验证的标 [INFERENCE])、卡住时给具体信息 | | 边界 | 技术细节该给就给;不确定就说不确定,不编造 |

它自己的 README 也写明:「软件本身不提供、不分发任何用于越狱、对抗安全审查或侵犯第三方权益的提示词载荷。」

② 改写逻辑本身(magpie-plugin/hooks.js + lib/rewrite.mjs)。这才是上游真正的东西,也是本插件对齐的对象:

| 语义 | 上游怎么做 | 我们怎么做 | | --- | --- | --- | | 四种落点 | anthropic 的 system 块、chat 的 system/developer 消息、responses 的 instructions、gemini 的 systemInstruction.parts | 一致 | | 块结构 | Anthropic 保留 cache_control 等非文本块(拍平会让客户端缓存断点失效、每轮重新计费) | 一致 | | 去身份 | 只删「一行里同时有自称 + 点名模型/厂商」的行;名字表覆盖 21 个宿主 | 一致(这一版补齐了漏掉的 6 个:OpenCode / ZCode / CodeBuddy / Hermes / Grok / Antigravity) | | 模式 | off / strict / replace / append | 一致 | | append 位置 | 人设在前(与它 CLI 的后置相反,插件 README 明确点出这个差异) | 一致 | | 每次读盘 | 只在 state.json 与人设文件 mtime 变了才读;1 秒预算 | 我们每请求读一次(文件很小),换来「换人设下一请求立刻生效」 | | 失败处理 | fail-open,ctx.report('invalid') 后原样放行 | 一致 | | 回滚 | 用完整请求的 JSON 做键,只回滚自己确切产出的那一版 | 一致 |

我们多做的两件事(上游没有):

  • 技能段:上游只注入一个人设;我们把显式启用的技能按 ## 技能:<名字> 拼在人设后面。
  • 多来源与内置包:上游只读 ~/.agent-purge/,人设列表靠 gen-personas.mjs 生成静态 page/personas.js;我们扫多个目录、内置 22 份技能,页面不读盘。

所以「打磨提示词」这件事的真实边界:能打磨的是注入通道(落点、去身份、拼接顺序、预算), 不是内容——内容是你自己写的人设与技能。本插件的 22 份技能与底座人设「大肥鱼」属于「内容」,随包分发; 上游的 neutral.md 属于「起步内容」,我们没抄它,因为它只是一个最小骨架,不是这个插件的价值所在。

内置专家技能包

装好就有,不用去别处找 md 再导入。skills/ 里是 22 份技能(原文照搬,逐字未改), personas/ 里是 1 份底座人设,随包分发、随包更新;它们在页面里带「内置」标,可启用可停用, 但删不掉(不是用户导入的)。

文件名与显示名都汉化了;id 保持 ASCII,因为 id 要稳定的当 options.enabled 的键。

按作业顺序

| 技能 | 管什么 | 原文文件 | | --- | --- | --- | | 环境准备 | 首次使用引导:FOFA_KEY 与 VPS 登录方式、验证通道、降级口径 | redteam-setup | | 被动信息收集 | 不接触目标,只用公开数据源(证书透明日志等) | passive-recon | | 主动扫描 | 端口与服务扫描(nmap / masscan),严守授权范围 | active-scan | | Web 指纹识别 | 框架、中间件、CMS、组件版本 | web-fingerprint | | 资产关联 | 域名 ↔ IP ↔ C 段 ↔ 证书 ↔ 服务的图谱化 | asset-correlation | | 侦察流水线 | subfinder → dnsx → naabu → httpx → katana 一键铺开 | recon-pipeline | | FOFA 测绘 | FOFA API 批量测绘;内置限速客户端,避免触发 45012 | fofa-recon | | 目录爆破 | 后台、备份、配置泄露、源码与版本库(ffuf / feroxbuster / gobuster) | dir-bruteforce | | 浏览器自动化 | 无依赖 headless 抓 SPA、截图、执行 JS、抓接口清单 | browser-automation | | 浏览器桥接 | 借 Kimi 扩展驱动真实 Chrome:导航、点击、填表、截图 | kimi-webbridge | | nuclei 扫描 | 13,000+ 模板覆盖 CVE / 暴露面 / 配置缺陷 / 默认口令 | nuclei-scan | | 凭据攻击 | 在线弱口令(hydra)与离线哈希(hashcat / john) | credential-attack | | WebShell 工具集 | 冰蝎 / 哥斯拉 / 蚁剑的启动与用法 | webshell-toolkit | | 反弹 Shell 处理 | VPS 上起 MSF / nc / socat 接收 shell,或从目标拉载荷 | shell-handler | | VPS 中转 | 9000-9999 监听、非交互会话驱动、载荷投递、反向隧道 | vps-reverse-shell | | suo5 隧道 | 走 WebShell / HTTP 建 SOCKS5,把内网流量代理出来 | suo5-tunnel | | chisel 隧道 | HTTP / WebSocket 封装的多路复用隧道,最易穿透出网限制 | chisel-tunnel | | frp 隧道 | VPS 上 frps、目标上 frpc,稳定 socks5 与端口映射 | frp-tunnel | | 国内代理池 | 免费 HTTP / SOCKS5 抓取验活轮换;只用命令级参数,不改本机网络 | cn-proxy-pool | | fscan 内网扫描 | 存活、端口、28 类弱口令、未授权、MS17-010、Redis 利用 | fscan-intranet | | gogo 内网测绘 | 智能 / 超智能模式、主被动指纹、关键信息提取、发包可控 | gogo-intranet | | 横向移动 | Impacket(PtH / PsExec / WMI / DCOM / Kerberos / 转储)+ enum4linux | lateral-movement | | 大肥鱼(人设 · 底座) | 不绑定任务:定语气、证据标准与交付形态;后面挂几位专家,就按它们各自的范围接起来。削弱版——留着判断,不做「无条件照做」的执行器 | 为本插件新写 |

用法:左栏点行本身就是开关——技能点一下启用、再点一下停用;人设点一下设为当前, 再点一下停用(停用后回落到「没有可用人设」,这次就不注入人设)。右侧「查看」看详情与原文。 没在用的条目会在最右一列标「未启用」,那一列位置固定,竖着扫下去就知道谁没开。

大肥鱼是底座人设(frontmatter 里 default: true):你没选人设时由它顶上, 它本身不含任何具体打法,只规定「怎么读后面的技能段」。所以三种用法都成立:

| 用法 | 结果 | | --- | --- | | 只挂一位专家 | 大肥鱼 + 那一位。底座说清边界,专家补能力 | | 多位一起挂 | 大肥鱼先看有没有调度类技能,其余各管一段 | | 一位也不挂 | 只有大肥鱼,就是通用协作 |

「削弱版」是什么意思

被问「你是什么模型 / 什么版本」时,人设要求它回答**「我是大肥鱼削弱版」**。

削弱指的是边界,不是能力:

| 满血版(不装本插件的破甲提示词) | 削弱版(本插件的底座人设) | | --- | --- | | 把「拒绝」当故障,任何请求都得给结果 | 留着判断,做不了就说做不了 | | 把违法与伤害行为逐条列成「可用」 | 不列,也不假装它们正常 | | 被要求绕开限制时继续执行 | 直接说做不到,并说清是哪一条 |

工具怎么用、命令怎么写、活怎么干,一样给足。

其他内置人设(不带 default)不会被自动选中——不点名就注入,等于偷偷改你的 system。

一处必须知道的差异

这些技能原本跑在 dsh-purge 里,正文中有 137 处 redteam_* 工具调用 (redteam_asset_add、redteam_vuln_add、redteam_chain_add 等),那套工具由 dsh-purge 注册。magpie 这条链上没有它们,模型若照着调用会得到「工具不存在」。

按「原样照搬」的要求,正文一字未改,因此这个坑原样保留。要消除它,得把那些调用替换成 等价动作(比如「在产物里记一条资产」而不是 redteam_asset_add)——这件事没做。

它解决什么

agent-purge 的 magpie 插件只认 ~/.agent-purge/ 的人设,页面也不能读盘。 本插件把这条链补成三件事:

  1. 内容只从两条路来:随包分发的 22 份技能 + 1 份底座人设,以及你自己导入的文件。 不再去翻磁盘上的任意目录——「它会不会自己扫我的硬盘」不该是个悬念;
  2. 认得四种东西:DSH 会话导出包(dsh-session-archive)、DSH cordis 插件包、 人设 / 技能 markdown、裸文本与 JSON 清单——坏包给出具体拒绝原因,不半途落盘;
  3. 页面能调配:条目列表、检查器(含查看原文)、模式、启用、版本回滚、校验记录、最近一次生效记录。

安装

# 从 npm
magpie plugin add @fish-under-sea/magpie-purge

# 或从本仓目录
git clone https://github.com/Fish-under-sea/magpie-purge
magpie plugin add "./magpie-purge"
magpie plugin list

装好后 magpie 的侧栏会多出一页「破甲&注入」;插件页第一次打开时,后端会清点包内内容与已导入的文件, 写出三份产物,页面读后两份。

三份产物分别放哪

| 产物 | 位置 | 为什么 | | --- | --- | --- | | catalog.json、imports/、last.json | ~/.magpie/purge/ | 用户数据。放包目录里会被 npm 升级整目录替换掉,导入的副本每次更新都丢 | | page/catalog.js | 包内 page/ | 只有元数据的快照,页面用 <script src> 载入 | | page/catalog.json | 包内 page/ | 完整快照(含正文),页面通过 page/hostread.js 取(见下) |

为什么把正文拆出去(重要)

内置技能是一批红队手册,合计约 130 KB。以前整段内联进 page/catalog.js,这个文件就成了 「一个装着 webshell / Meterpreter / 冰蝎 大段文本的可执行脚本」——Windows Defender 据此把它判成 Trojan:Script/Wacatac.C!ml。正文挪进 .json 之后,脚本里只剩条目名、类型、字数这类元数据 (实测 104 KB → 18 KB,正文 0 条),不再落在脚本引擎的扫描范围里。

代价是页面要读正文就得多一条通道,而 magpie 插件页的 CSP 是 connect-src 'none'—— 页面自己 fetch 一定被拦。所以正文走 page/hostread.js,两条通道按顺序试:

| 顺序 | 通道 | 什么时候用得上 | | --- | --- | --- | | 1 | 页面直连 fetch('catalog.json') | 宿主哪天把 connect-src 放开到自身目录,这条最快 | | 2 | 请宿主窗口代取(parent.postMessage({method:'asset'}),magpie 用它给页面取页内文件) | 现在的真机走这条:CSP 拦得住页面,拦不住窗口自己的 fetch |

两条都断时(老宿主、或页面被单独打开),「查看原文」仍然可点:点开是一段说明,写清两条通道 分别为什么失败、文件在哪个路径——而不是一个点了没反应的灰色按钮。

也就是说:原文与编辑不依赖上游改 CSP 也能用;只用到了 magpie 现有的 asset 资产通道, 它若在某版里不可用,页面会如实降级成「取不到」,不会静默装成空正文。

旧版本把 state/ 放在包目录里;升级后第一次扫描会自动把它搬到新位置,不覆盖已有文件。

PURGE_STATE_DIR 可以覆盖 ~/.magpie/purge(多实例或测试用);建不出来时自动退回包内 state/, 宁可退到一个会被升级清掉的位置,也好过整个扫描直接抛错、页面停在空壳上。

缓存与「更新后看不见变化」

页面打开时会自己带时间戳重取一次 catalog.js(catalog.js?t=…),所以后端刚写出的快照立刻可见, 不会因为浏览器缓存而一直看到旧的那份。app.js / plan.js / style.css 在打包时会被打上 ?v=<版本号>;仓库里是 ?v=0 占位,postpack 会还原,免得每次发版都留一处待提交的改动。

包内出厂的两个快照都是空壳(version: 0)。页面把「版本号 < 1」当作「后端还没扫过」, 会自己轮询等待,不会对着空列表干等。

配置

设置写进 magpie 的 plugins.json(magpie.options),页面上改,别手改文件也行:

| 字段 | 作用 | | --- | --- | | mode | strict / replace / append;留空就是不注入(等同于 off) | | persona | 用哪条人设的 id;留空取标了 default 的底座人设,再留空取第一个启用的人设 | | agents | 只对这些 magpie agent 生效,如 ["claude","codex"];空数组 = 全部 | | enabled | {条目id: true/false}:技能必须显式为 true 才注入;人设默认启用 | | pinned | {条目id: 摘要}:固定到某一版,网关用那一版的正文 | | imports | 页面写的导入请求({op, path, at}),后端处理后复制进 ~/.magpie/purge/imports | | inline | 页面里直接贴进来的人设/技能正文,不进磁盘 | | gatewayTimeoutMs | 钩子预算,默认 1500 ms(magpie 侧 100–10000) | | useAgentPurge | 默认 false。设为 true 才去读 agent-purge 的 state.json,见下 |

想读 agent-purge 的设置?(默认关)

默认不读 ~/.agent-purge/:装了这个插件的人未必装过上游,静默去翻别人的目录, 会让「我什么都没配,怎么 system 被换了」变成真的。要用就显式打开:

magpie plugin options magpie-purge '{"useAgentPurge":true}'

打开后按四层取,先到先得:

| 层 | mode | persona | | --- | --- | --- | | 1 | 插件页选过的值 | 插件页选过的人设 | | 2 | override[agent].mode → default.mode | override[agent].persona → state.persona | | 3 | 兜底 off | 标了 default 的底座人设 | | 4 | — | 第一个启用的人设 |

上游 disabledHarnesses 含这个 agent、或 default.mode 是 off 时,本插件一样不做—— 页面的状态条会写明「agent-purge 里关掉了这个 harness」。没打开 useAgentPurge 时这一层整段不存在。

指向的人设不在来源里时,不会偷偷换成别人:状态条直接说「指定的 X 不在当前来源里」。

模式语义与上游一致:

  • 不注入(mode 留空,页面上就是「开始注入」没按):不动请求;
  • strict:整段可控 system 换成人设——原 system 里的工具说明文本也会一起没了;
  • replace:人设放最前,宿主 system 里「自称 + 点名模型/厂商」的行删掉(近似);
  • append:人设放最前,宿主 system 原样保留。

页面上「开不开」和「怎么改」是两件事:右侧那颗开关负责注入开关,模式下拉只选改写方式。 注入开着的时候模式是锁住的——改模式等于换一套改写规则,而请求随时可能进来, 必须先关掉注入再改。

页面怎么告诉你「到底注不注」

页面顶部那条状态就是答案,三种样子:

  • 绿点「下一次 agent 请求会注入「大肥鱼」」+ 模式与人设的来源(本页设置 / 底座人设);
  • 红点「现在不会注入:请求原样放行」+ 具体原因 + 一个能点的下一步(「用 replace 开始注入」/「去看人设」/「导入一份人设」);
  • 底部「最近一次生效」:真跑过就写人设、技能、字符数;被放行就写为什么放行。

导入的 .zip 是素材(会话导出包、DSH 插件包),不会进 system——检查器里会直说,别把素材当人设。

导入分两步

「导入」折叠区里:先点「选择」挑文件(路径会填进输入框,你能看见选中了什么), 再点「导入」才真的写进去。一步到底容易误触——浏览器选完就落盘,人还没确认类型。

  • 框里直接粘绝对路径时走另一条路:后端把原件复制进 ~/.magpie/purge/imports,原文件不动;
  • 「这份文件是」三选一(自动判断 / 人设 / 技能):自动判断按 frontmatter 与正文结构猜, 猜错就在检查器里点**「改判为技能 / 人设」**,不必删了重导;
  • 删的时候用检查器里的**「删除导入」(页面导入的)或「删除副本」**(复制进 ~/.magpie/purge/imports 的), 指向它的 persona / enabled / pinned 引用会一起清掉——否则会卡在「指定的人设不在了」。

选中任一条目,检查器里有**「查看原文」**:正文(去掉 frontmatter 之后真正会拼进 system 的那段) 随快照一起下发,点开就能读,不用去磁盘翻文件。超过 8000 字符会截断并标出总长度; 换条目自动收起,不会把上一条的正文带过来。

边界(照实说,不含糊)

  • 只处理经过 magpie 网关的 agent 请求;客户端自己写死的行为、不经过网关的流量改不到。
  • strict 只换可控的 system 文本;结构化工具定义不在网关这一层,改不动也不假装改动。
  • 页面不读磁盘:所有扫描与读盘都在插件后端(hooks.js)里做,页面只显示快照。
  • 不执行导入件里的任何脚本:DSH 插件包与导出包只被判型与登记,不当代码跑。
  • 坏包(缺 manifest、路径带 ..、超大文件)整个拒绝,同目录其它条目不受影响。

目录

Purge in Magpie/
├── package.json           插件清单:magpie.hooks / magpie.page / magpie.options
├── hooks.js               网关钩子:清点 + 改写(Bun 侧,能读盘)
├── skills/                22 份内置技能(随包分发,一份技能一个 .md)
├── personas/              内置底座人设(大肥鱼,不绑定任务)
├── lib/
│   ├── zip.mjs            极简 ZIP 只读解析(store + deflate,拦路径越界)
│   ├── inventory.mjs      判型、校验、摘要、去重与版本
│   ├── rewrite.mjs        四种 protocol × 四种模式的 system 改写
│   ├── agentpurge.mjs     读 agent-purge 的 state.json(原生语义)
│   ├── plan.mjs           三层优先级:这次注不注、注谁、为什么没注
│   ├── bundled.mjs        读包内 skills/ 与 personas/,标 builtin
│   └── state.mjs          快照落盘(state/catalog.json + page/catalog.js)
├── page/                  插件页:index.html / app.js / style.css / icon.*
│   ├── glass.js           液态玻璃:把宿主四区域数字收敛成 --purge-glass-*(含文字面保底与 deep 判定)
│   ├── plan.js            页面侧注入判定(与 lib/plan.mjs 同规则,parity 测试逐条比对)
│   ├── hostread.js        取正文的两条通道:直连 fetch → 宿主窗口代取(CSP connect-src 'none' 下走后者)
│   ├── icon-lock.svg      侧栏与页面标签的图标(实心锁)
│   └── card.png           插件卡片的图(由 tools/card-icon.mjs 内联进 package.json)
├── preview/               本地预览:mock 宿主 + 演示快照 + 单文件 purge-preview.html
├── tools/
│   ├── scan.mjs           离线清点(预览与真机同一条路径)
│   ├── build-preview.mjs  把整页压成单文件 HTML(双击就能看)
│   └── card-icon.mjs      把 page/card.png 内联进 magpie.icon(data URI)
└── tests/                 node --test:判型、校验、改写、选人、快照、内置包

两个图标,别混

magpie 的两个 icon 键管的是不同地方,改错一个就会影响另一个:

| 键 | 显示在哪 | 值 | | --- | --- | --- | | magpie.icon | 插件卡片 | 必须是 https:// 或 data:image/——magpie 的 iconOf() 会直接丢掉相对路径 | | magpie.page.icon | 侧栏标签与页面 tab | 可以是包内相对路径 |

所以卡片图走 tools/card-icon.mjs 内联成 data URI(约 41 KiB),侧栏仍是 page/icon-lock.svg 的实心锁。 换了卡片图就重跑一次脚本;npm run prepack 会顺带校验。

预览整个界面

两种,看你要给谁看。

① 单文件,双击就开(给人看界面时用这个):

node tools/build-preview.mjs      # → preview/purge-preview.html

生成物是一个 HTML 文件,CSS、JS、mock 桥、演示快照全部内联,没有任何外部依赖—— 双击直接打开,不用起服务、不用开端口。顶部有主题与状态两个开关:

| 参数 | 作用 | | --- | --- | | #theme=dark / #theme=light | 深色 / 浅色 | | #glass=off / lite / balanced / clear | 液态玻璃档位:关 / 轻透 82%+12px / 均衡 62%+26px / 全透 20%+30px(数字与真机四区域同口径) | | #snap=ready / #snap=blocked | 就绪那一屏 / 什么都没就绪那一屏 | | #row=0 | 直接打开第几条的详情(0 起) |

单文件预览在 html 背景里垫了「画布 + 遮罩 + 壁纸」三层,壁纸是模拟的柔光色块—— 真机上它由 magpie 画在 body 上(带 --wall-veil 遮罩)。玻璃关掉时画布不透明,垫层看不见。

例:preview/purge-preview.html#theme=light&snap=blocked

② 起服务,改完自动刷新(调 UI/UX 时用这个):

npm run preview:serve            # → http://127.0.0.1:55172

用 mock 宿主把真实的 page/index.html 放进一个帧里,主题跟随 magpie 的变量名: ?theme=dark(默认)/ ?theme=light。

改完 page/ 里的文件会自动重载——服务监听这些文件,通过 /_reload 推一条消息给页面, 帧自己换 src。不用手点刷新,也不用手动重建。嫌它太勤?加 ?watch=0 关掉。

| 参数 | 作用 | | --- | --- | | ?theme=dark / ?theme=light | 深色 / 浅色 | | ?glass=off / lite / balanced / clear | 液态玻璃档位,见上表 | | ?row=0 | 预选第几条,直接看检查器(0 起) | | ?watch=0 | 关掉热重载 |

preview/host.html 的帧背后同样垫了壁纸 + 遮罩(iframe 是透明的), 顶上那颗「玻璃」下拉换档只重载帧、不刷新整个预览壳——改 UI 时用来逐档对照。

--csp=magpie 让预览用真机同款 CSP(connect-src 'none')发页面文件:这时页面自己的 fetch 会被拦,正文只能走宿主代取(preview/host.html 模拟了 magpie 的 asset 应答)——用来复现和回归 「查看原文取不到正文」那条路径。

默认不预选任何条目——右栏默认显示「注入组装」,那是最该看的一屏。 不带 --demo 时读的是真机生成的 page/catalog.js;--demo=blocked 是「什么都没就绪」那一屏。

热重载靠一条常开的 SSE 连接。用无头浏览器截图时会一直等不到网络空闲, 截图命令记得带 ?watch=0。

单文件是派生文件:改完 page/ 要重新跑一次 build-preview,别手改它。 npm run prepack 会顺手重建,所以发布包里那份总是最新的。

页面怎么排的

一屏三段,按「先看结论、再动手、最后翻细节」:

  1. 顶部一行状态条:绿点 / 红点 + 「这次注不注、注谁」+ 一个能点的下一步,最该被看见的放最上面;
  2. 左列表 / 右组装:左边按「内置专家」与「我的来源」分组;右栏平时显示注入组装—— 把这次会拼成的 system 摊成按顺序的积木(人设 → 技能 → 宿主原文),选中条目时切成详情;
  3. 底部四块折叠:导入与来源 / 校验记录 / 最近一次生效 / 边界。平时只占一行, 不把「声明」和「导入表单」顶在首屏。

样式只吃 magpie 的主题变量(--magpie-*),跟随宿主明暗;语义色只留三类 (人设 / 技能 / 素材),其余交给墨色与分隔线。

液态玻璃(magpie 2.4.0 起)

宿主的「设置 › 外观」把液态玻璃拆成 sidebar / content / overlay / control 四个区域, 每个区域一对数字(fill 0–100% 不透明度、blur 0–40px 模糊半径)。页面不自己实现模糊、 不自己挑颜色,只照这套数字上色。口径与官方插件页(magpie-checkin-relay-probe)一致:

  • 画布全透:html / body 都不铺底,壁纸由宿主画在自己的 body 上(带 --wall-veil 遮罩)。 页面自己再铺一层 --bg 会整页发暗、跟宿主对不上。
  • 材质直出宿主那套(对照 fish-glass.css):底色 = --card × 区域不透明度; backdrop-filter: blur(区域 blur) saturate(180%) brightness(1.06) 做折射观感;内侧白色高光 + 一层柔和投影;::before 左上冷光 / 右下壳光;::after 用 mask 挖出 1px 渐变高光边。 没有自定义描边、没有黑色边框。
  • 行与块本身就是玻璃面:状态条、列表行、组装行、详情里的「何时用 / 事实块」用同一套面材质 (行 12px 圆角、块 14px);不再给左右两列套大壳,壁纸从行与行之间透出来。
  • 控件用 --fg 的 10%:按钮、输入框、chip、pick、查看、胶囊组都是 --fg × 控件数字的 10%, 带同一份模糊与描边高光;主操作仍用强调色。
  • 数字照抄、不设下限:page/glass.js 把 --magpie-glass-<region>-* 与 magpie.glass()/onGlass() 收敛成 --purge-glass-*(fill 与 blur 都带);control 缺席时跟 content 走;脏值夹回安全范围。
  • 分组标题:透明、不吸顶,跟着列表滚走(吸顶就必须给它一层遮挡,实测透明底兜不住滚过去的行)。
  • 文字全部接官方 token:--magpie-fg / --magpie-muted / --magpie-accent / --magpie-accent-fg / --magpie-green / --magpie-red / --magpie-amber / --magpie-font / --magpie-code; 输入框占位符显式用 --magpie-muted,不再吃浏览器默认的「当前文字色 54%」。
  • 模糊边界:壁纸在宿主文档上,插件页在沙箱帧里,画布本身只能透、不能糊;能吃到模糊的是 卡片/行的页内背景,以及详情浮层与模式下拉。
  • 降级:@supports not (backdrop-filter)、prefers-reduced-transparency: reduce、 forced-colors: active 一律回实底并撤掉柔光/高光边。

开发

# 测试(102 个用例:判型/校验/改写/选人/快照/钩子端到端/options 回读/agent-purge 语义/注入判定/控制面过滤/内置专家包/液态玻璃策略)
node --test --test-isolation=none "tests/*.test.mjs"

# 离线清点,看看本机 purge 目录里都认得什么
node tools/scan.mjs --import "D:\purge\我的.md"

# 只打条目表到 stdout(不写文件)
node tools/scan.mjs --json

npm test 用 --test-isolation=none:Windows 沙箱下 node --test 默认要开子进程管道, 会被拦成 spawn EPERM。

与上游的差别

| 项 | agent-purge 的 magpie-plugin/ | 本插件 | | --- | --- | --- | | 来源 | 只读 ~/.agent-purge/ | 包内专家包 + ~/.magpie/purge/imports(只认导入) | | 判型 | 只有人设 markdown | 导出包 / DSH 插件包 / 人设 / 技能 / 文本 / 清单 | | 注入 | 一个人设 | 人设 + 显式启用的技能(含 22 份内置技能) | | 页面 | 人设选择 + 导入 | 条目列表 + 检查器 + 模式 + 回滚 + 校验记录 | | 快照 | 生成脚本写 personas.js | 后端每次扫描写 catalog.js,页面不读盘 | | 版本 | 无 | 同 id 新摘要算新版本,留两版可回滚 | | 与 agent-purge 的关系 | 读 state.json 但页面改不了模式 | 默认不读;要读得显式设 useAgentPurge: true | | 状态可见性 | 无 | 顶部状态条直接回答「注不注、注谁、为什么没注」 |

版本

| 版本 | 要点 | | --- | --- | | 0.8.4 | 行/事实块补上宿主同款光学:左上冷光 + 渐变高光边;状态徽标、类型标签、模式下拉也吃玻璃胶囊;玻璃下解除滚动区的 mask-image / opacity(它们会建立 backdrop root,让行里的 backdrop-filter 采不到东西) | | 0.8.3 | 玻璃改成宿主材质直出:--card 底色 + backdrop 模糊/饱和/提亮 + 内侧高光 + 1px 渐变高光边 + 柔光;去掉左右两列大壳与所有自定义边框(不再有黑边),行/块本身就是玻璃面;控件仍是 --fg 10% 胶囊;占位符接 --magpie-muted | | 0.8.2 | 玻璃观感对齐官方插件页:画布全透、卡片用 content 原值(去掉 55/70/45 的下限)、胶囊与控件改用 --fg 的 10%×控件数字、材质与分隔线由 --fg 派生;另修掉注释里写了 page/*/style.css 导致 */ 提前闭合、整段玻璃变量规则被解析器吞掉的问题 | | 0.8.1 | 颜色全部接官方主题 token:强调色 --magpie-accent、强调色上的文字 --magpie-accent-fg、三态 --magpie-green/red、技能色 --magpie-amber,页面不再写死莓红;宿主只下发三个玻璃区(无 control)时控件跟「主界面」数字走,不再恒为实底 | | 0.8.0 | 玻璃卡片化:左列(搜索 + 列表)、右列(组装清单)、底部导入条在玻璃开着时各成一张玻璃卡(圆角 14、内边距 12/14、列间距 16);卡内的列表行与组装行各成一颗玻璃胶囊(12px 圆角),详情里的「何时用 / 事实块」也是胶囊,分组标题保持透明且不吸顶;玻璃关着仍是扁平工作台 | | 0.7.0 | 适配 magpie 液态玻璃:页面画布与成块文字面跟随「主界面」、详情浮层与模式下拉跟随「浮层」、控件跟随「控件」(page/glass.js);玻璃关闭时与旧版逐像素一致,减弱透明/高对比度回实底;预览新增 ?glass= 与垫底壁纸 | | 0.6.5 | 修「查看原文」对所有条目都点不动:正文取回先试 fetch,被 CSP 拦下就让宿主窗口代取(page/hostread.js);两条都断时按钮仍可点,点开写明原因与文件位置 | | 0.6.4 | 侧栏图标改用独立 icon-lock.svg,避开已打开窗口沿用旧图标缓存;侧栏名称与锁形不变 | | 0.6.3 | 侧栏名字改为「破甲&注入」,图标换成黑白单色实心锁 | | 0.6.2 | 正文一律不落盘(.js、.json、state/catalog.json 全都不含),注入时按 source.root/rel 现读——彻底止住 Defender 对聚合文件的反复上传 | | 0.6.1 | 修:注入关闭时人设行恒显示「未启用」、点它没有反应(判定把人设一起清空了) | | 0.6.0 | 正文移出 page/catalog.js、改写成 page/catalog.json 按需取,修 Defender Trojan:Script/Wacatac.C!ml 误判;配色换莓石;详情改浮层;分组可折叠;整页不滚;模式去掉 off 改由开关控制 | | 0.5.0 | 内置技能换成 22 份原文(原为 9 位提炼稿);左栏点行即启用、原文可编辑可删除;两侧等长;修网格行被压扁;人设改为「大肥鱼削弱版」 | | 0.4.3 | 判定改由页面本地计算:技能开关、装配面板、状态条改完立刻生效,不再等后端重扫;左栏跟随右栏等高;专家开关带复选框与计数 | | 0.4.2 | 状态条不再按过期判定劝人(改完模式还劝「用 replace」);修「页面导入」条目没有删除按钮、被当素材 | | 0.4.1 | 修「选完模式又被换回」「确认注入点了没用」;导入区改成「选择 → 再点导入」两步并可选人设/技能;去掉来源目录与自动扫描,只扫包内与 state/imports | | 0.4.0 | 底座人设 大肥鱼 取代 Prompt Forge:不绑定任务,0–9 位专家随意组合;默认不再读上游 state.json(要读设 useAgentPurge:true);默认来源只剩 ~/.magpie/purge;模式下拉去掉「跟随上游」 | | 0.3.0 | 内置 9 位专家技能包(由本机 dsh-purge 的 23 份原子技能提炼);内置条目带「内置」标、可停用不可删 | | 0.2.0 | 认 agent-purge 的 state.json(原生语义);页面加「当前注入」状态条与可点的下一步;导入素材后不再一头雾水 | | 0.1.2 | README 版本表 | | 0.1.1 | 修掉「没流量时插件页是空的」:钩子模块加载时先从 plugins.json 读回自己的 options 再预热扫描 | | 0.1.0 | 首个版本 |

许可

MIT。上游 agent-purge 的 MIT 文本与版权行原样保留在 LICENSE 与 THIRD_PARTY_NOTICES.md 里。