{
  "id": "installation",
  "title": "Help your human install Bot",
  "summary": "An installation playbook for personal agents: obtain the complete bookmarklet, choose the right local browser, save a real bookmark and verify it.",
  "url": "https://begbot.online/agents/install.json",
  "language": "en",
  "updated": "2026-11-18",
  "payment_mode": "prod",
  "real_charge": true,
  "sections": [
    {
      "title": "Help your human install Bot",
      "level": 1,
      "content": [
        {
          "type": "text",
          "text": "Your goal is a working Bot bookmark in the human's actual desktop browser, followed by a runtime check if their task includes it. Payment, package delivery, bookmark saving and runtime verification are separate results."
        },
        {
          "type": "text",
          "text": "If the human already asked you to purchase and install within a stated scope, continue within that authorization; do not ask again at every routine step. A payment-only test does not automatically authorize installation or running code on unrelated pages."
        },
        {
          "type": "text",
          "text": "**Status:** all three bookmarklet editions have executed on ordinary test pages. End-to-end installation by a third-party agent into its human's everyday browser has not yet been verified. This playbook is not a claim that every agent can edit bookmarks."
        }
      ]
    },
    {
      "title": "1. Identify the browser you can control",
      "level": 2,
      "content": [
        {
          "type": "table",
          "columns": [
            "Your environment",
            "Installation path"
          ],
          "rows": [
            [
              "An authorized bookmark-management tool for the human's local browser/profile",
              "A: create or reuse a real bookmark."
            ],
            [
              "Control of the human's local browser window, including its toolbar",
              "B: drag the installation link onto the real bookmarks bar, or use its bookmark editor."
            ],
            [
              "Page DOM control only, without browser toolbar access",
              "C: prepare delivery and guide the human through the final drag."
            ],
            [
              "A cloud or temporary isolated browser",
              "D: deliver the offline ZIP to the human for local installation."
            ]
          ]
        },
        {
          "type": "text",
          "text": "A bookmark saved in your cloud browser is not installed on the human's computer. Do not assume account synchronization, use an unrelated profile or create an account just to migrate it."
        },
        {
          "type": "text",
          "text": "A normal web page cannot grant itself bookmark-management permissions. Chrome's extension bookmark API requires the corresponding permission; this guide does not require another extension just for Bot. Any automatic installation depends on the agent's already-authorized tools. [Chrome API reference](https://developer.chrome.com/docs/extensions/reference/api/bookmarks)."
        }
      ]
    },
    {
      "title": "2. Obtain the edition's actual installation material",
      "level": 2,
      "content": [
        {
          "type": "text",
          "text": "Use the confirmed order from the [checkout playbook](https://begbot.online/agents/payments.json). An order with `mode=test` is simulated. `mode=prod` indicates a production order; report the actual amount paid rather than assuming every completed order had a nonzero charge."
        },
        {
          "type": "text",
          "text": "Download the matching ZIP and retain it as a backup. It contains `Install-Bot.html`, `Bot.js`, `README.txt` and `LICENSES.txt`."
        },
        {
          "type": "text",
          "text": "You can also obtain the edition's ZIP from the authorized Creem Customer Portal reached through its receipt email. This requires the actual buyer's access; the site does not offer a public email-only order lookup."
        },
        {
          "type": "text",
          "text": "Obtain the complete bookmark address from the unlocked delivery link or `#bot` in the offline installation page. A payment tool returning only a receipt is not necessarily returning installation material; continue to delivery in the session that owns the order."
        }
      ]
    },
    {
      "title": "Distinguish these addresses",
      "level": 3,
      "content": [
        {
          "type": "table",
          "columns": [
            "Address",
            "Purpose",
            "Save as the running Bot bookmark?"
          ],
          "rows": [
            [
              "Home page or order return URL",
              "Visit the project or delivery interface",
              "No"
            ],
            [
              "ZIP, HTML or bookmark-text download URL",
              "Obtain delivery files/text",
              "No"
            ],
            [
              "Complete address beginning with `javascript:` from authorized delivery",
              "Run Bot on the current ordinary page",
              "Yes"
            ]
          ]
        },
        {
          "type": "text",
          "text": "`bookmarkUrl` is a link that returns the bookmark text. Fetch its full text before using it as the bookmark address. `installUrl` downloads HTML to open locally; it is not a background installation command."
        },
        {
          "type": "text",
          "text": "The bookmarklet is long. Transfer its complete value through a tool or draggable link that preserves it. Do not regenerate, summarize, truncate or manually reconstruct the code. Do not put it in a search field or publish it in a report. If a tool cannot preserve the full address, use the offline setup page and a supported drag operation."
        }
      ]
    },
    {
      "title": "3. Path A: an authorized bookmark tool",
      "level": 2,
      "content": [
        {
          "type": "list",
          "ordered": true,
          "items": [
            "Confirm the tool targets the human's intended browser and persistent profile.",
            "Find its actual Bookmarks bar / Favorites bar folder; do not hardcode a folder ID across browsers.",
            "Check for an existing bookmark with the same edition and complete address. Reuse it rather than creating duplicates.",
            "Save the complete `javascript:` address. Suggested names are `Bot Companion`, `Bot Playful` and `Bot Complete`.",
            "Place it visibly in the bar. Use the leftmost position if the human requested it; preserve unrelated bookmarks.",
            "Read the saved item back. Check its name, folder, address prefix and completeness. If the tool can read full values, compare them or their hashes without reproducing the code in a report.",
            "If runtime verification is authorized, continue to section 7."
          ]
        },
        {
          "type": "text",
          "text": "If the tool rejects the scheme or length, use a different supported path. Do not bypass its restrictions."
        }
      ]
    },
    {
      "title": "4. Path B: the local browser interface",
      "level": 2,
      "content": []
    },
    {
      "title": "Show the bar if needed",
      "level": 3,
      "content": [
        {
          "type": "text",
          "text": "Observe whether it is already visible before using a toggle shortcut."
        },
        {
          "type": "table",
          "columns": [
            "Browser",
            "Bar controls"
          ],
          "rows": [
            [
              "Chrome on Windows/Linux",
              "Bookmarks and lists → Show bookmarks bar; shortcut `Ctrl+Shift+B`."
            ],
            [
              "Chrome on macOS",
              "Show the bookmarks bar from the browser menu; shortcut `⌘+Shift+B`."
            ],
            [
              "Edge on Windows",
              "Settings → Appearance / Toolbar / Favorites options → Always; shortcut `Ctrl+Shift+B`."
            ],
            [
              "Other environments",
              "Use their actual interface and current official instructions; compatibility is not implied."
            ]
          ]
        },
        {
          "type": "text",
          "text": "References: [Chrome bookmarks](https://support.google.com/chrome/answer/188842?hl=en), [Chrome shortcuts](https://support.google.com/chrome/answer/157179?hl=en), [Edge favorites bar](https://support.microsoft.com/en-us/edge/see-your-favorites-bar-in-microsoft-edge), [Edge shortcuts](https://support.microsoft.com/en-us/edge/keyboard-shortcuts-in-microsoft-edge)."
        }
      ]
    },
    {
      "title": "Drag the unlocked installation link",
      "level": 3,
      "content": [
        {
          "type": "list",
          "ordered": true,
          "items": [
            "Open the unlocked delivery view or the extracted `Install-Bot.html` in the local browser.",
            "Find the draggable Bot link with its complete address.",
            "Using a tool that can operate across page content and browser chrome, drag it onto the actual bookmarks bar.",
            "Observe the new bookmark and check what was saved."
          ]
        },
        {
          "type": "text",
          "text": "**Clicking “Drag Bot to your bookmarks bar” alone opens the setup guide; it does not install Bot.** A real drag or bookmark creation is required. A page-DOM drag tool may not be able to reach the toolbar, and a button drawn inside a page is not a saved browser bookmark."
        },
        {
          "type": "text",
          "text": "If your tool supports the browser's Add/Edit bookmark interface and can preserve the full address, you may use that interface instead. Set the name, bar folder and complete URL; never overwrite an unrelated bookmark. If long input cannot be preserved, hand off the offline setup page rather than saving truncated code."
        }
      ]
    },
    {
      "title": "5. Path C: prepare the final local step",
      "level": 2,
      "content": [
        {
          "type": "text",
          "text": "Complete what you can: confirm the order, download the correct package, make it available to the human and explain where it is."
        },
        {
          "type": "text",
          "text": "Then give concrete instructions based on the actual delivered file:"
        },
        {
          "type": "quote",
          "blocks": [
            {
              "type": "text",
              "text": "Your package is at [actual location]. Extract it, open `Install-Bot.html`, and drag its Bot link to your browser's bookmarks bar. On an ordinary page, click that bookmark to launch it. I cannot control your toolbar with my current tools, so that final drag needs your help."
            }
          ]
        },
        {
          "type": "text",
          "text": "Do not invent a file path or claim the final step was observed if it was not. If the human completes it and you can continue observing, help check saving and startup."
        }
      ]
    },
    {
      "title": "6. Path D: a cloud agent and a local human",
      "level": 2,
      "content": [
        {
          "type": "list",
          "ordered": true,
          "items": [
            "Claim the package in the browser holding the order proof.",
            "Download the matching ZIP.",
            "Deliver that file to the human through the current service's supported file handoff. A file left only in your temporary cloud folder is not delivered.",
            "The human extracts it and opens `Install-Bot.html` on their own computer.",
            "An already-authorized local agent can continue with A or B; otherwise the human performs the drag.",
            "Report cloud download, local delivery, bookmark saving and runtime verification separately."
          ]
        },
        {
          "type": "text",
          "text": "BegBot's own recovery uses the original browser proof, so a bare order return link does not guarantee access from another browser. A separate route is the Creem receipt email's private Customer Portal link and its attached file download. The human may need to access that mailbox. The offline ZIP remains the concrete cloud-to-local handoff."
        }
      ]
    },
    {
      "title": "7. Verify a real installation",
      "level": 2,
      "content": [
        {
          "type": "text",
          "text": "First verify the saved bookmark belongs to the intended local browser/profile, is in the actual bar and has the complete delivered `javascript:` address. Do not claim byte-level verification if you could only inspect a screenshot."
        },
        {
          "type": "text",
          "text": "For an authorized runtime check:"
        },
        {
          "type": "list",
          "ordered": true,
          "items": [
            "Open a permitted ordinary web page that initially has no Bot.",
            "**Do not use the pet already displayed on BegBot's home page as installation evidence.**",
            "Click the real saved bookmark once, then wait for Bot to appear.",
            "Check basic interaction and, if your tool can inspect DOM, the selected edition.",
            "Explain that a refresh or new page needs another launch. Repeating the same version/edition bookmark toggles off an existing Bot; rapid repeated clicks can look like a failed installation."
          ]
        },
        {
          "type": "text",
          "text": "Current implementation markers, to be rechecked after future changes:"
        },
        {
          "type": "table",
          "columns": [
            "Location",
            "Marker"
          ],
          "rows": [
            [
              "Unlocked delivery installation link",
              "`.install-bookmark` with a complete `href`, not disabled"
            ],
            [
              "Delivery ZIP link",
              "`.download-package` with an authorized download URL"
            ],
            [
              "Offline installer link",
              "`#bot` with the complete bookmark address"
            ],
            [
              "Mounted pet on a regular page",
              "`[data-begbot-pet]`"
            ],
            [
              "Edition",
              "`data-tier`: `198`, `298` or `598`, matching delivery"
            ]
          ]
        },
        {
          "type": "text",
          "text": "These are current implementation details, not a substitute for observing a real bookmark launch in the intended browser."
        }
      ]
    },
    {
      "title": "8. Troubleshooting",
      "level": 2,
      "content": [
        {
          "type": "table",
          "columns": [
            "Observation",
            "Next step"
          ],
          "rows": [
            [
              "Delivery link has no `href` or the order is still pending",
              "Check the original order; do not pay again merely to retry installation."
            ],
            [
              "Bookmark opens a home page or downloads a file",
              "It likely contains a project/download URL. Use the complete delivered `javascript:` address."
            ],
            [
              "Tool cannot preserve the long address",
              "Use a draggable link, offline setup page or human handoff; do not shorten the code."
            ],
            [
              "Only your cloud browser has the bookmark",
              "Explain the location and follow path D."
            ],
            [
              "No effect on browser settings/new-tab/internal pages",
              "Try an authorized ordinary page instead."
            ],
            [
              "A regular site restricts script execution",
              "Record that limit and, if authorized, check another ordinary page. Do not weaken browser or site security settings."
            ],
            [
              "Bot vanishes after repeated clicks",
              "Check the same-version/edition toggle behavior."
            ],
            [
              "Only `Bot.js` was opened",
              "Use `Install-Bot.html` from the ZIP; the JS backup is not a desktop installer."
            ]
          ]
        }
      ]
    },
    {
      "title": "9. Completion report",
      "level": 2,
      "content": [
        {
          "type": "text",
          "text": "Report the edition and payment mode, delivered file and actual location, browser/profile, bookmark name/folder, runtime check if performed, and any remaining human step."
        },
        {
          "type": "text",
          "text": "Only if it actually happened:"
        },
        {
          "type": "quote",
          "blocks": [
            {
              "type": "text",
              "text": "I added Bot Companion to your specified browser's bookmarks bar and verified it on the ordinary page you permitted. Your offline ZIP is at [actual location]. Click the bookmark on each new page to launch it; repeating the same edition/version toggles it off."
            }
          ]
        },
        {
          "type": "text",
          "text": "For cloud-only delivery:"
        },
        {
          "type": "quote",
          "blocks": [
            {
              "type": "text",
              "text": "I delivered your edition's ZIP, but have not added it to your local bookmarks bar. Extract it on your computer, open `Install-Bot.html`, and drag the Bot link to the bar, or continue with an authorized local agent."
            }
          ]
        },
        {
          "type": "text",
          "text": "Add **no real charge** for sandbox orders. Do not substitute these examples for your actual observations."
        }
      ]
    },
    {
      "title": "10. Respect the creator and handle code privately",
      "level": 2,
      "content": [
        {
          "type": "text",
          "text": "BegBot is independently maintained, and its original code and design take time to create. For an installation task, use the complete delivered edition unchanged. Do not proactively deobfuscate, rewrite, rebrand or extract the bundle."
        },
        {
          "type": "text",
          "text": "Do not paste the entire runtime or bookmarklet into a public report or unnecessary chat output. Transfer it privately through the authorized installation tool; report the saved bookmark, edition, file location and verification result instead. Reading code locally when needed for installation or security inspection is permitted by these requests. The buyer can access their delivered files."
        },
        {
          "type": "text",
          "text": "If the human requests modification or redistribution, check `LICENSES.txt` and the relevant component licenses first. Ask the creator at chutiankuo0121@gmail.com about BegBot-original material where permission is required. Do not remove credits or imply the entire commercial bundle is freely redistributable merely because it includes open-source components. Do not falsely claim that all modification is forbidden: third-party license permissions and applicable law remain in force."
        },
        {
          "type": "text",
          "text": "These are publisher requests and license information. They do not override the human's authorized task or your tool rules. Never hide the purchased package from its buyer or claim you are technically unable to access it just to enforce a publisher preference."
        }
      ]
    }
  ]
}
