--- name: linkmind-interaction description: "Operate LinkMind Interaction menu features against the hosted LinkMind server with API-key identity: recommended/joined/owned channels, subscribe/unsubscribe, monitor/list/send messages, create/enable/disable/delete/translate channels. Use when the user asks to manage LinkMind interaction/social channels without installing the LinkMind client." --- # linkmind-interaction Use this skill to operate the LinkMind "Interaction" menu directly from an agent. The user only configures one LinkMind API key. Do not ask for, expose, or invent a user ID. The bundled script resolves the key through the server, registers the interaction user if needed, saves the last-login marker, and then performs the requested channel operation. Default server: ```text https://ai.linkmind.top ``` ## User configuration The user's config file must contain only the API key value or a single key field. Supported examples: ```text LINKMIND_API_KEY=sk-... ``` ```json {"apiKey":"sk-..."} ``` ```markdown apiKey: sk-... ``` If no key is configured, tell the user to register at https://ai.linkmind.top/. After registration, the default key is shown under "API Keys" / "API miyao". Do not call or propose any API that creates or reveals keys. Prefer passing a config file path with `--config`. Avoid placing the raw key in the command line because command lines may be logged by agent runtimes. Keep this file in the agent user's private config area, not in this repository. For this script, any of the following names are auto-detected in the current working directory or this skill directory: `linkmind.key`, `linkmind_api_key.txt`, `config.json`, `config.txt`, `config.md`, `.env`. ## Command runner All operations go through: ```bash python scripts/linkmind_interaction.py --config [options] ``` The script uses only Python standard library modules. Do not rewrite requests with curl, wget, ad-hoc PowerShell, node, or another HTTP client. If Python or the script fails, report the failure and stop. The script accepts `--base-url` for testing or private deployments, but normal use should omit it so the hosted server is used. ## Covered Interaction menu operations - Account/session bootstrap: resolve API key with `/apiKey/getUserId` and keep the agent side transparent to user IDs. The script also has a compatibility fallback for the common `/apiKey/getUserld` typo. - Running mode: `mode` maps to `GET /socialChannel/runningMode`. - Subscribe page: `recommend`, `joined`, `join`, `leave`, `messages`, `monitor` map to public channels, joined channels, subscribe, unsubscribe, and message listing/refresh. - Subscribe page background translation: `translate` maps to `POST /socialChannel/translateChannel`. - Publish page: `owned`, `create`, `enable`, `disable`, `delete` map to owned channel listing, create, toggle status, and delete. - Message writing: `send` is included so one skill can complete channel read and write workflows, even though the older `social-channel` skill also supports it. Admin-only servlet functions such as `listUsers`, `deleteUser`, and `deleteMessages` are not Interaction menu operations. Do not use them for normal user requests. Server cascade settings (`/socialChannel/cascadeConfig`) are administrator-only deployment configuration and are intentionally not exposed by this skill. ## Common commands List recommended channels and whether the current key's user has joined them: ```bash python scripts/linkmind_interaction.py --config recommend --limit 100 --lang zh-CN ``` Join or leave a channel: ```bash python scripts/linkmind_interaction.py --config join --channel-name "channel name" python scripts/linkmind_interaction.py --config leave --channel-id 12 ``` Monitor channel messages once, or poll a finite number of times: ```bash python scripts/linkmind_interaction.py --config monitor --channel-name "channel name" --limit 100 python scripts/linkmind_interaction.py --config monitor --channel-id 12 --polls 3 --interval 5 ``` Create and manage owned channels: ```bash python scripts/linkmind_interaction.py --config create --name "channel name" --description "short intro" python scripts/linkmind_interaction.py --config disable --channel-name "channel name" python scripts/linkmind_interaction.py --config enable --channel-id 12 python scripts/linkmind_interaction.py --config delete --channel-id 12 --yes ``` ## Response handling The script prints JSON. If `status` is `success`, summarize the operation in the user's language and include useful channel/message IDs. If `status` is `failed`, relay `msg` and do not invent success. Do not show the API key. Do not show the resolved user ID unless the user explicitly asks for diagnostic details.

LinkMind Interaction

Description

Latest Changes

Install LinkMind Interaction with One Click