安装浏览器扩展
扩展以解压目录形式分发，不经过应用商店。装法只有一种：开发者模式 + 加载已解压的扩展程序。
准备
先把发布包解压到一个固定位置（例如 D:\LinkMaw），不要在压缩包里直接操作，也不要放在会被清理的临时目录。
| 路径 | 内容 |
|---|---|
LinkMaw.exe | 桌面版主程序 |
extension\ | 扩展目录，安装时选它 |
kernel\ | 下载内核与转封装组件 |
CHANGELOG.md | 版本更新记录 |
扩展目录要选对
「加载已解压的扩展程序」要选到含
manifest.json 的那一层，也就是 extension 文件夹本身。选成上级目录会报「清单文件缺失」。安装步骤
- 打开扩展管理页地址栏输入
chrome://extensions（Edge 是edge://extensions），回车。 - 打开开发者模式页面右上角（Edge 在左侧栏底部）找到「开发者模式」开关，打开。
- 点「加载已解压的扩展程序」出现文件夹选择框。选中
extension目录，确定。 - 固定到工具栏点浏览器右上角的拼图图标，找到「拾贝 LinkMaw」，点图钉固定，方便随时打开。
- 验证版本点扩展图标，弹窗标题应显示版本 1.28.0。版本不对说明加载的是旧目录。
装完先验三件事
拾贝 · 版本号弹窗顶部显示名称与版本，例如 1.28.0
正在检测桌面版…打开弹窗瞬间的握手状态；随后变成「已连接」或「桌面版未运行」
还没有捕获到媒体资源当前页没发现可下载内容时的空态
大小过滤 / 屏蔽域名 / 保存位置三个设置区，后面各有一篇专讲
- 版本对：1.28.0。低于这个版本请重新加载目录。
- 桌面版状态明确：要么「已连接」，要么「桌面版未运行」。一直停在「正在检测…」说明本机端口不通，见 连接自检。
- 页面标记生效：随便打开一个有
.zip或.pdf直链的页面，链接旁应出现绿色箭头。
关于 Chrome 137 之后的限制
Chrome 137 起移除了命令行参数 --load-extension，也就是说以前那种「改快捷方式加参数自动加载」的写法不再可用，只能通过扩展管理页手动加载；企业环境还需要管理员在策略里放开开发者模式。Edge 目前仍是同样的界面加载方式。
重装或换目录后
换了扩展目录需要重新「加载已解压的扩展程序」一次。原来的设置存在浏览器本地存储里，同一条扩展 ID 会沿用；如果目录路径变了导致 ID 变化，设置会回到默认值。
权限说明
| 权限 | 实际用途 | 不涉及什么 |
|---|---|---|
tabs | 读取当前标签页地址与标题，用于把资源归属到页面 | 不读取你的浏览历史 |
storage | 保存设置、已屏蔽域名等本地配置 | 不同步到任何服务器 |
downloads | 仅用于扩展自己的下载页点「下载」时交给浏览器下载器 | 不监听下载事件、不取消、不重发 |
scripting / activeTab | 在页面里注入链接旁的标记按钮 | 不修改页面内容与请求 |
webRequest | 只读观察页面发出的请求，识别媒体地址 | 只读，不改写、不拦截、不重定向 |
notifications | 下载完成、域名被屏蔽等提示 | 不用于推送营销内容 |
contextMenus | 右键菜单三项：发送到 LinkMaw 下载 / 把本页地址发送到 LinkMaw / 已屏蔽域名 | — |
| 站点访问（http/https） | 全站注入标记按钮 | 不上传页面内容 |
完整清单见 权限说明。
装不上怎么办
提示「清单文件缺失」或「Manifest file is missing」
选择的目录层级不对。要选含
manifest.json 的那一层（extension 文件夹本身）。扩展列表里出现了但图标是灰的
被浏览器停用了。点扩展卡片上的开关重新启用；如果提示「此扩展程序可能已损坏」，删掉重新加载目录。
装好后页面没有任何绿箭头
会不会影响浏览器自带下载？
不会。扩展不注册下载事件监听，浏览器下载一律照原样进行。