Tampermonkey 油猴脚本实践：头注释、GM_* API 与加密 Cookie 钩子

// ==UserScript==
// @name         New Userscript
// @namespace    http://tampermonkey.net/
// @version      0.1
// @description  try to take over the world!
// @author       You
// @match        https://example.com/*
// @grant        none
// ==/UserScript==

(function() {
    'use strict';

    // Your code here...
})();

// @include http://www.tampermonkey.net/*
// @include http://*
// @include https://*
// @include /^https://www\.tampermonkey\.net/.*$/

// @require https://code.jquery.com/jquery-3.7.1.min.js
// @require https://code.jquery.com/jquery-2.1.3.min.js#sha256=23456...
// @require https://code.jquery.com/jquery-2.1.2.min.js#md5=34567...,sha256=6789...
// @require tampermonkey://vendor/jquery.js
// @require tampermonkey://vendor/jszip/jszip.js

// @resource icon1 http://www.tampermonkey.net/favicon.ico
// @resource icon2 /images/icon.png
// @resource html  http://www.tampermonkey.net/index.html
// @resource xml   http://www.tampermonkey.net/crx/tampermonkey.xml
// @resource SRIsecured1 http://www.tampermonkey.net/favicon.ico#md5=123434...
// @resource SRIsecured2 http://www.tampermonkey.net/favicon.ico#md5=123434...;sha256=234234...

// @grant GM_setValue
// @grant GM_getValue
// @grant GM_setClipboard
// @grant unsafeWindow
// @grant window.close
// @grant window.focus
// @grant window.onurlchange

// unsafeWindow 不需要 @grant
unsafeWindow.somePageFunction();

// @grant GM_addStyle
GM_addStyle('html body { background-image: url(https://example.com/bg.png) }');

// @grant GM_setValue
// @grant GM_getValue
// @grant GM_deleteValue
// @grant GM_listValues

GM_setValue('time1', '2026-10-01 20:10:00');   // 存键值对
GM_setValue('time2', '2026-10-01 20:11:00');
console.log('获取 time1', GM_getValue('time1'));
console.log('带默认值的读法', GM_getValue('notExist', '默认值'));
console.log('storage 中所有的 key', GM_listValues());
GM_deleteValue('time1');
console.log('删除后再读', GM_getValue('time1'));

// @grant GM_addValueChangeListener
// @grant GM_removeValueChangeListener

const listenerId = GM_addValueChangeListener('token', function (name, oldValue, newValue, remote) {
    // remote 为 true：值是被另一个标签页里的脚本改的
    console.log(name, oldValue, newValue, remote);
});

GM_removeValueChangeListener(listenerId);

// @grant GM_openInTab
GM_openInTab('https://www.baidu.com/', { active: true, insert: true, setParent: true });

// @grant GM_setClipboard
GM_setClipboard('要复制的内容', { type: 'text', mimetype: 'text/plain' });

// @grant GM_registerMenuCommand
// @grant GM_unregisterMenuCommand

const menuId = GM_registerMenuCommand('清空缓存', function () {
    console.log('菜单被点击');
}, 'c');

GM_unregisterMenuCommand(menuId);

// ==UserScript==
// @name         BoSSCookie
// @namespace    http://tampermonkey.net/
// @version      0.1
// @description  把当前页面的 Cookie 回传到本地服务
// @author       You
// @match        https://www.zhipin.com/*
// @grant        GM_xmlhttpRequest
// @connect      127.0.0.1
// @run-at       document-start
// ==/UserScript==

(function () {
    'use strict';

    console.log(document.cookie);

    GM_xmlhttpRequest({
        method: 'POST',
        url: 'http://127.0.0.1:7890/cookie',
        data: JSON.stringify(document.cookie),
        headers: { 'Content-Type': 'application/json' },
        onload: function (res) {
            if (res.status === 200) {
                console.log('Cookie 发送成功');
            } else {
                console.log('Cookie 发送失败');
                console.log(res);
            }
        },
        onerror: function (err) {
            console.log('发生 error');
            console.log(err);
        }
    });
})();

from flask import Flask, request

app = Flask(__name__)


@app.route('/cookie', methods=['POST'])
def server_cookie():
    raw = request.get_data(as_text=True)   # 与 Content-Type: application/json 对应
    print(raw)
    # 也可以直接写进 Redis，让爬虫从队列里取
    return 'ok'


if __name__ == '__main__':
    app.run(host='127.0.0.1', port=7890, debug=True)

// ==UserScript==
// @name         示例脚本
// @namespace    https://example.com/
// @version      1.0.0
// @description  一句话说明这个脚本干什么
// @author       You
// @match        https://example.com/*
// @exclude      https://example.com/admin/*
// @icon         https://example.com/favicon.ico
// @require      https://code.jquery.com/jquery-3.7.1.min.js#sha256=...
// @resource     logo https://example.com/logo.png
// @grant        GM_addStyle
// @grant        GM_setValue
// @grant        GM_getValue
// @grant        GM_deleteValue
// @grant        GM_registerMenuCommand
// @grant        GM_xmlhttpRequest
// @connect      example.com
// @run-at       document-end
// @noframes
// ==/UserScript==

(function () {
    'use strict';

    GM_addStyle('.my-tip { color: #e33 }');

    GM_registerMenuCommand('清空本脚本缓存', function () {
        GM_deleteValue('cache');
        alert('已清空');
    });

    const tip = document.createElement('div');
    tip.className = 'my-tip';
    tip.textContent = '脚本已注入 ' + new Date().toLocaleString();
    document.body.appendChild(tip);
})();