{ "schemaVersion": 1, "providerId": "official", "catalogId": "pi-plugin-center", "name": "Voki-Work 官方插件市场", "homepage": "https://work.vokiai.com/plugins/", "artifactBaseUrl": "https://work.vokiai.com/plugins", "updatedAt": "2026-11-02T14:27:55.847Z", "plugins": [ { "id": "pi.browser", "name": "Browser", "description": "Work-panel browser chrome and agent CDP against the host guest page.", "author": "voki-work", "i18n": { "en": { "name": "Browser", "description": "Work-panel browser chrome and agent CDP against the host guest page." }, "zh-CN": { "name": "浏览器", "description": "工作面板里的浏览器外壳，并为 Agent 提供针对宿主访客页的 CDP 调试能力。" }, "ja": { "name": "ブラウザ", "description": "ワークパネルのブラウザシェルと、ホストのゲストページに対するエージェント CDP。", "safetyNotes": "ワークパネルのブラウザ UI と、ホストのゲストページに対するエージェントの CDP 操作です。" } }, "categories": [ "files" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#pi.browser", "docs": { "zh-CN": { "intro": "工作面板里的浏览器给助手一块能真正打开网页的地方：右侧面板里是一个可用的浏览器页面，助手通过宿主的 CDP 通道读它、点它、填它，而不是只拿到一段 HTML。\n\n你能用它做什么：\n\n- 打开网址或工作区里的 HTML 文件，在同一块面板里反复查看。\n- 让助手先读页面的可访问性结构（带 `uid`），再按 `uid` 点击、填写、回车提交，比猜坐标稳。\n- 页面“点了没反应”时，直接读 console 与网络请求，而不是再截一张图靠猜。\n- 计划模式和目标模式下也能只用只读动作做观察：列标签页、读页面、查找、看网络、看日志、截图。\n", "install": "本插件随应用提供并默认启用。如果你卸载了它，可以在这里重新安装，并把配置从头配一遍。\n开箱即可用：不需要账号、密钥或额外的本机服务，也没有需要填写的设置项。插件只用两项能力——在工作面板里放一个视图（`ui.view`），以及向助手注册工具并访问宿主浏览器页面的 CDP 接口（`agent.tool.register`、`browser.cdp`）。\n\n首次验证：\n\n1. 用命令「打开浏览器」，或在对话里说「打开浏览器面板」，右侧应出现一个带地址栏的面板；\n2. 在里面输入一个公开网址，确认页面能正常渲染；\n3. 回到对话里说「打开 example.com，把页面标题告诉我」，助手应当自己唤起面板并读回标题；\n4. 再说「截一张图」，回复里应出现当前页面截图。\n\n常见安装失败：\n\n- **助手说没有浏览器工具**：插件没启用，或工具还没注册。在「扩展」里启用它，再用命令「打开浏览器」开一次面板。\n- **面板里的页面白屏或打不开**：目标站点拒绝被内嵌、需要登录，或者地址是 `chrome://` 一类页面。换一个普通 http(s) 地址；需要你自己的登录状态时改用「浏览器扩展操控」插件。\n- **计划模式下点击被拒绝**：计划和目标模式只放行只读动作，改动页面的动作要切回执行模式再试。\n", "usage": "三个常见用法：\n\n1. 「打开我们自己的后台登录页，看看登录按钮的文案是什么」——助手先 `snapshot` 读页面结构，再回答元素与文案，不用截图比对。\n2. 「在这个页面的搜索框里填 `invoice` 回车，然后把前三条结果列出来」——填表、回车、重新读页面，一步接一步。\n3. 「这个按钮点了没反应，你看看控制台和网络请求」——读 console 与 network，通常比再点一次更快找到失败的那个请求。\n\n入口有三个：命令面板里的「打开浏览器」（斜杠 `/browser`）、右侧工作面板的「浏览器」视图，以及对话里直接说清要做什么——助手手上的工具叫 `Browser`，开始操作前宿主会自动切到当前会话并打开面板。\n\n| 能力 | 做什么 |\n| --- | --- |\n| 标签页与导航 | 列出面板里的标签页、打开网址或工作区内的 HTML 文件 |\n| 读取页面 | 抓取带 `uid` 的页面结构、按角色或名称查找元素、截图（可整页） |\n| 操作 | 按 `uid` 或坐标点击、填表并回车、按键组合、滚动、上传项目内的文件、接受或关闭 JavaScript 对话框 |\n| 诊断 | 读 console 消息、读网络请求、执行一段 JavaScript、调用白名单内的 CDP 方法 |\n\n不要指望它做什么：\n\n- 它不是你的浏览器：这是应用内一个独立的浏览器配置，没有你的 cookie 和登录状态。要操作你已经登录的站点，用「浏览器扩展操控」。\n- 它不碰凭据：密码框、cookie 与原始 storage 不会交给助手；上传的文件必须来自项目或本次会话的临时目录。\n- 计划模式下它改不了页面；它也不会绕过宿主的网络设置，出口白名单与代理照常生效。\n" }, "ja": { "intro": "ワークパネルのブラウザは、エージェントが実際に Web ページを開ける場所を用意します。右側のパネルに動くブラウザページがあり、エージェントはホストの CDP チャネル経由でそのページを読み、クリックし、入力します。HTML の塊を渡されて終わり、ではありません。\n\nできること:\n\n- URL やワークスペース内の HTML ファイルを同じパネルで開いて見続けられます。\n- エージェントがまずページのアクセシビリティツリー（`uid` 付き）を読み、`uid` でクリック・入力・Enter 送信します。座標を推測するより確実です。\n- 「クリックしても反応しない」ときに、もう一枚スクリーンショットを撮って推測する代わりに console とネットワーク要求を読みます。\n- プランモードとゴールモードでも読み取り専用の操作だけで観察できます（タブ一覧、ページ読み取り、検索、ネットワーク、ログ、スクリーンショット）。\n", "install": "このプラグインはアプリに同梱され、既定で有効です。削除した場合はここから再インストールし、あらためて設定してください。\nすぐに使えます。アカウント、キー、追加のローカルサービスは不要で、入力する設定項目もありません。このプラグインが使うのは 2 つの権限だけです。ワークパネルにビューを置くこと（`ui.view`）と、エージェントにツールを登録してホストのブラウザページへ CDP で到達すること（`agent.tool.register`、`browser.cdp`）。\n\n最初の確認:\n\n1. コマンド「ブラウザーを開く」を実行するか、会話で「ブラウザーパネルを開いて」と言うと、右側にアドレスバー付きのパネルが現れます。\n2. 公開 URL を入力し、ページが表示されることを確認します。\n3. 会話に戻って「example.com を開いてページタイトルを教えて」と言うと、エージェントが自分でパネルを開いてタイトルを返します。\n4. 続けて「スクリーンショットを撮って」と言うと、返信に現在のページ画像が付きます。\n\nよくある導入のつまずき:\n\n- **エージェントがブラウザツールを持っていないと言う**: プラグインが無効か、ツールがまだ登録されていません。「拡張機能」で有効にしてから、コマンド「ブラウザーを開く」を一度実行してください。\n- **パネルのページが真っ白、または開けない**: サイトが埋め込みを拒否している、ログインが必要、あるいは `chrome://` 系のページです。通常の http(s) アドレスに変えてください。自分のログイン状態が必要な場合は「ブラウザ拡張制御」を使ってください。\n- **プランモードでクリックが拒否される**: プラン／ゴールモードは読み取り専用の操作だけを許可します。ページを変更する操作は実行モードに戻してから行ってください。\n", "usage": "よくある 3 つの頼み方:\n\n1. 「うちの管理画面のログインページを開いて、ログインボタンの文言を教えて」— エージェントはまず `snapshot` でページ構造を読み、スクリーンショット比較なしで要素と文言を答えます。\n2. 「このページの検索ボックスに `invoice` を入れて Enter し、最初の 3 件を並べて」— 入力、送信、再読み取りを順に進めます。\n3. 「このボタンを押しても反応しない。コンソールとネットワークを見て」— console と network を読むほうが、もう一度クリックするより失敗した要求を早く見つけられます。\n\n入口は 3 つです。コマンドパレットの「ブラウザーを開く」（スラッシュ `/browser`）、右側ワークパネルの「ブラウザ」ビュー、そして会話でそのまま用件を伝える方法です。エージェントが持つツール名は `Browser` で、操作の前にホストが呼び出し元のセッションへ切り替えてパネルを開きます。\n\n| できること | 内容 |\n| --- | --- |\n| タブと移動 | パネルのタブ一覧、URL やワークスペース内 HTML ファイルを開く |\n| ページの読み取り | `uid` 付きのページ構造の取得、ロールや名前での要素検索、スクリーンショット（ページ全体も可） |\n| 操作 | `uid` または座標でのクリック、入力と送信、キー組み合わせ、スクロール、プロジェクト内ファイルのアップロード、JavaScript ダイアログの承認・却下 |\n| 診断 | console メッセージの読み取り、ネットワーク要求の読み取り、JavaScript の実行、許可済み CDP メソッドの呼び出し |\n\n期待しないでください:\n\n- あなたのブラウザではありません。アプリ内の独立したブラウザプロファイルで、あなたの cookie もログイン状態もありません。ログイン済みのサイトを操作するには「ブラウザ拡張制御」を使ってください。\n- 認証情報には触れません。パスワード欄、cookie、生の storage がエージェントに渡ることはなく、アップロードできるのはプロジェクト内またはこのセッションの一時領域のファイルだけです。\n- プランモードではページを変更できません。ホストのネットワーク設定も迂回しません。送信先の許可リストとプロキシはそのまま効きます。\n" }, "en": { "intro": "The Browser plugin gives the assistant a place to actually open a web page: a working browser page in the right work panel, which the assistant reads, clicks and fills through the host's CDP channel instead of receiving a lump of HTML.\n\nWhat you can do with it:\n\n- Open a URL or an HTML file from the workspace and keep looking at it in the same panel.\n- Have the assistant read the page's accessibility tree (with `uid`s) first, then click, fill and submit by `uid` instead of guessing coordinates.\n- When a page \"does nothing when I click\", read the console and network requests instead of taking another screenshot and guessing.\n- Keep observing in Plan and Goal modes with read-only actions: list tabs, read a page, find text, inspect network and console, take screenshots.\n", "install": "This plugin ships with the app and is on by default. If you removed it, install it here to bring it back, then set it up again.\nWorks out of the box: no account, key or extra local service, and there are no settings to fill in. The plugin uses two capabilities only — a view in the work panel (`ui.view`), and registering an agent tool plus reaching the host browser page over CDP (`agent.tool.register`, `browser.cdp`).\n\nFirst check:\n\n1. Run the command **Open Browser**, or say \"open the browser panel\", and a panel with an address bar appears on the right;\n2. Type a public URL in it and confirm the page renders;\n3. Back in the conversation say \"open example.com and tell me the page title\" — the assistant should open the panel itself and read the title back;\n4. Then say \"take a screenshot\" and the reply should carry an image of the current page.\n\nCommon setup failures:\n\n- **The assistant says it has no browser tool**: the plugin is disabled or the tool is not registered yet. Enable it under Extensions, then run **Open Browser** once.\n- **The page stays blank or will not load**: the site refuses to be embedded, needs a login, or the address is a `chrome://` page. Use a normal http(s) address; when you need your own session, use the Browser Extension Control plugin instead.\n- **Clicks are refused in Plan mode**: Plan and Goal modes only allow read-only actions; switch back to an executing mode for anything that changes the page.\n", "usage": "Three common things to ask for:\n\n1. \"Open our own admin login page and tell me the exact wording on the sign-in button\" — the assistant snapshots the page structure and answers with the element and its text, no screenshot comparison needed.\n2. \"Type `invoice` in this page's search box, press Enter, then list the first three results\" — fill, submit, re-read the page, one step at a time.\n3. \"This button does nothing when I click it — check the console and the network requests\" — reading console and network usually finds the failing request faster than clicking again.\n\nThere are three entry points: the command **Open Browser** (slash `/browser`), the **Browser** view in the right work panel, and simply saying what you want in the conversation — the tool the assistant holds is named `Browser`, and the host switches to the calling session and opens the panel before it acts.\n\n| Capability | What it does |\n| --- | --- |\n| Tabs and navigation | List the panel's tabs; open a URL or an HTML file from the workspace |\n| Reading a page | Capture the page structure with `uid`s, find an element by role or name, take a screenshot (optionally full page) |\n| Acting | Click by `uid` or coordinates, fill and submit, press key combinations, scroll, upload a file from the project, accept or dismiss a JavaScript dialog |\n| Diagnosing | Read console messages, read network requests, run a snippet of JavaScript, call an allowlisted CDP method |\n\nDo not expect it to:\n\n- Be your browser. This is a separate browser profile inside the app with none of your cookies or logins; to drive sites you are signed into, use Browser Extension Control.\n- Touch credentials. Password fields, cookies and raw storage are never handed to the assistant, and uploads must come from the project or this session's scratch directory.\n- Change a page in Plan mode, or bypass the host's network policy — the egress allowlist and proxy still apply.\n" } }, "versions": [ { "version": "1.0.1", "publishedAt": "2026-11-01T00:00:00Z", "minPiDesktop": ">=0.8.0", "shasum": "4eb2a72824fe7fce3d298837df8148de1fae8ca50db43d3d69481dd017b22f2e", "url": "packages/pi.browser-1.0.1.piplug", "sizeBytes": 61763, "permissions": [ "ui.view", "agent.tool.register", "browser.cdp" ], "fs": {} } ], "distribution": "bundled" }, { "id": "voki.aihub-apps", "name": "AI Hub Apps", "description": "Run cloud AI Hub apps from Voki办公 as agent tools, with a dynamically loaded app catalog.", "author": "voki-work", "i18n": { "en": { "name": "AI Hub Apps", "description": "Run cloud AI Hub apps from Voki办公 as agent tools, with a dynamically loaded app catalog.", "safetyNotes": "Runs cloud AI apps as your signed-in AI Hub account. The plugin never receives your SSO token; the host proxy injects it. App outputs and descriptions are untrusted data. Writes and apps without a read-only declaration require explicit confirmation. Files are read only from the folder you choose or a file you attached to this conversation, and uploaded only when you ask; links open only after confirmation. The plugin stores a catalog cache, pinned apps, task metadata, and encrypted task events locally." }, "zh-CN": { "name": "智能应用", "description": "在 Voki办公中把云端 AI 工作台应用作为 Agent 工具运行，应用目录动态加载。", "safetyNotes": "以你登录的 AI Hub 账号运行云端应用；插件不会拿到 SSO 令牌，由宿主代理注入。应用输出与描述都是不可信数据。写操作和未声明只读的应用需要你明确确认。文件只从你选择的目录或你附加到对话的文件读取，且只在你要求时上传；链接只有确认后才会打开。插件会在本地保存目录缓存、固定应用、任务元数据和加密的任务事件。" }, "ja": { "name": "AI Hub アプリ", "description": "Voki Work からクラウド AI Hub のアプリをエージェントツールとして実行します。アプリ一覧は動的に読み込まれます。", "safetyNotes": "サインイン中の AI Hub アカウントとしてクラウドアプリを実行します。SSO トークンはプラグインに渡されず、ホストプロキシが注入します。アプリの出力と説明は信頼できないデータです。書き込みおよび読み取り専用の宣言がないアプリは明示的な確認が必要です。ファイルは選択したフォルダ、または会話に添付したファイルからのみ読み取り、依頼されたときだけアップロードします。リンクは確認後にのみ開きます。プラグインはカタログキャッシュ、固定アプリ、タスクメタデータ、暗号化されたタスクイベントをローカルに保存します。" } }, "categories": [ "office" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.aihub-apps", "docs": { "zh-CN": { "intro": "智能应用把云端 AI Hub 工作台里的应用接进对话：目录动态加载，应用会新增、改名、换输入表单，所以助手每次都要先查目录、再看应用说明，而不是凭记忆直接跑。\n\n运行用的是你在这台应用里已经登录的 AI Hub 账号，插件本身拿不到 SSO 令牌——请求由宿主代理带上凭证。写操作、以及没有声明自己是只读的应用，都需要你明确同意后才会执行；只提供链接的应用只把链接交出来，确认后才打开。\n\n长任务不必占住这一轮：异步启动后任务记录在任务监控的「插件」区域，跑完会自动唤醒这段对话。应用产物下载到工作区里的目录，链接会过期，本地文件才是长期交付。\n\n你能用它做什么：\n\n- 让助手按关键词在云端目录里找应用，读它的输入表单和文件字段，再按表单跑一次。\n- 把文档交给云端应用处理（翻译、审阅、生成、对比），过程中在任务监控里看状态，跑完回到对话取结果。\n- 把这次对话里附上的文件作为输入上传，或只用你选定的目录里的文件。\n- 翻看某个应用在云端的最近会话，把历史结果当材料读回来。\n", "install": "本插件不随安装包提供，安装后才可用。卸载之后可以在这里重新安装，配置与数据需要重新设置。\n开箱可用的前提只有一个：你已经在这个桌面应用里登录了 AI Hub。插件不保存 SSO 令牌，也不需要你另外填地址或密钥，请求经宿主代理发出。应用目录、固定应用、任务元数据与加密后的任务事件保存在插件自己的数据目录；文件只从你选定的目录或这条对话的附件里读取，且只在你要求时才上传。**不要把任何访问令牌贴进对话**——插件既不需要也不接受。\n\n| 设置项 | 用途 | 默认值 |\n| --- | --- | --- |\n| `catalogTtlMinutes` | 后台刷新应用目录的间隔（分钟） | `15` |\n| `maxResultBytes` | 任务回答与增量超过这个大小会被截断 | `32768` |\n| `taskRetentionDays` | 早于该天数的任务记录与加密事件会被清理 | `7` |\n| `maxPinnedApps` | 最多把多少个固定应用暴露成独立工具 | `16` |\n| `maxTasks` | 本地保留的任务记录上限 | `50` |\n| `outputDirectory` | 应用产物在工作区里的相对目录 | `aihub-output` |\n\n首次验证：\n\n1. 打开命令「智能应用」，确认面板里的目录已经加载出来（没有登录时面板会提示先登录 AI Hub）。\n2. 回到对话说「用智能应用查一下目录里有没有合同审阅的应用」——助手会先调 `aihub_status`，再列出匹配的应用。\n3. 挑一个只读应用说「用这个应用处理这段话」——助手读表单、跑一次，结果直接回到对话；长任务会出现在任务监控的「插件」区域。\n\n常见安装失败：\n\n- **助手说未登录**：AI Hub 的登录状态属于宿主，不在插件里；在应用内登录后重试，不要往对话里贴令牌。\n- **列出的应用是旧的**：目录按 `catalogTtlMinutes` 后台刷新，刚上架或刚下线的应用需要刷新一次（助手可以调 `aihub_refresh_catalog`）。\n- **上传文件被拒（`AIHUB_FILE_INVALID`）**：路径不在你选定的目录里，或文件选择框被取消；把文件附加到对话里再让助手用，不要重复重试同一个路径。\n", "usage": "三个常见用法：\n\n1. **跑一个云端应用**：「用智能应用把这份会议记录整理成结论和待办」。助手先查目录、读输入表单，跟你确认输入后再跑，结果回到对话，产物落到 `aihub-output`。\n2. **长文档丢给云端慢慢处理**：「把这份采购合同翻译成英文，跑完告诉我」。助手用 `mode:\"async\"` 启动，报出 taskId 就结束这一轮，进度在任务监控的「插件」区域，跑完会自动唤醒对话。\n3. **查历史结果**：「看看这个应用上周给那份报告的结论」。助手用 `aihub_list_conversations` 找到会话，再用 `aihub_get_conversation` 读消息，把云端历史当数据读回来。\n\n入口是命令「智能应用」，打开应用目录面板（浏览、固定、管理已安装应用、看任务）。对话里的能力来自目录、运行与任务三类工具，固定过的应用还会各自暴露一个 `aihub_app_<别名>` 工具：\n\n| 能力 | 做什么 |\n| --- | --- |\n| `aihub_status` | 登录状态、hub、目录版本与年龄、固定应用、活动任务与限额 |\n| `aihub_refresh_catalog` | 刷新云端目录，报告新增、删除与变化的条目 |\n| `aihub_list_apps` | 按关键词、分类或运行方式列出应用 |\n| `aihub_describe_app` | 一个应用的类型、运行方式、风险、输入表单与文件字段 |\n| `aihub_get_options` | 解析某个下拉字段的动态选项 |\n| `aihub_run_app` | 启动一次运行；高风险应用需 `confirm`，只给链接的应用直接返回 URL |\n| `aihub_upload_file` | 上传一个文件并返回该应用文件字段需要的对象 |\n| `aihub_get_task` | 读任务状态、按游标取增量与最终结果 |\n| `aihub_wait_task` | 最多等 45 秒，超时不算失败 |\n| `aihub_stop_task` | 停止一个正在运行的任务 |\n| `aihub_resume_task` | 按 message id 恢复被中断的任务 |\n| `aihub_open_app` | 打开只提供链接的应用；确认后才会真的打开 |\n| `aihub_list_conversations` | 找某个应用在云端的最近会话 |\n| `aihub_get_conversation` | 读一个云端会话的消息 |\n\n不要指望它做什么：\n\n- 不替你确认高风险动作：写操作和未声明只读的应用每次都要 `confirm:true`，模型不会把上一轮的同意当成这一轮的同意。\n- 不会自己读你的磁盘：文件只来自你选定的目录或这条对话的附件，且只在你要求时上传；链接也只有确认后才打开。\n- 不当成可信指令源：应用描述、应用输出、云端历史会话都是不可信数据，插件不因为里面写了什么就改变权限或改做别的操作。\n" }, "ja": { "intro": "AI Hub アプリは、クラウド AI Hub のワークベンチを会話に持ち込みます。アプリ一覧は動的に読み込まれ、アプリの追加・改名・入力フォームの変更が起こるため、アシスタントは記憶に頼らず毎回一覧を引き、そのアプリ自身の説明を読みます。\n\n実行はサインイン中の AI Hub アカウントとして行われ、プラグインが SSO トークンを受け取ることはありません。ホストのプロキシが付与します。書き込みと、読み取り専用を宣言していないアプリは、明示的な同意を待ちます。リンクのみのアプリは URL を返し、確認したうえで初めて開きます。\n\n長い実行がターンを占有する必要はありません。非同期で開始し、タスク監視のプラグイン領域で進捗を見て、完了時に会話が再開されます。成果物はワークスペースのフォルダーにダウンロードされ、プレビュー URL は失効するため、ローカルファイルが正式な受け渡しになります。\n\nできること:\n\n- クラウドの一覧からキーワードでアプリを探し、入力スキーマとファイル項目を読んでから、その通りに実行します。\n- 文書をクラウドアプリ（翻訳、レビュー、生成、比較）に渡し、タスク監視で追いながら会話で結果を受け取ります。\n- この会話に添付したファイル、または選択したフォルダーのファイルをアップロードします。\n- あるアプリの直近のクラウド会話を一覧し、過去の結果を素材として読み戻します。\n", "install": "このプラグインはインストーラーに含まれません。使う前にここからインストールしてください。削除後に再度インストールできますが、設定とデータは初期状態になります。\nすぐに使えるための条件は 1 つだけです。このデスクトップアプリで AI Hub にサインイン済みであること。プラグインは SSO トークンを保存せず、独自のアドレスや鍵も不要で、リクエストはホストのプロキシ経由で送られます。アプリ一覧のキャッシュ、固定アプリ、タスクメタデータ、暗号化されたタスクイベントはプラグイン独自のデータディレクトリに保存されます。ファイルは選択したフォルダーかこの会話の添付からのみ読み取り、依頼されたときだけアップロードします。**アクセストークンをチャットに貼らないでください**。プラグインは必要とせず、受け取りもしません。\n\n| 設定項目 | 用途 | 既定値 |\n| --- | --- | --- |\n| `catalogTtlMinutes` | アプリ一覧をバックグラウンドで更新する間隔（分） | `15` |\n| `maxResultBytes` | タスクの回答と差分がこれを超えると切り詰められます | `32768` |\n| `taskRetentionDays` | この日数より古いタスク記録と暗号化イベントを削除します | `7` |\n| `maxPinnedApps` | 固定アプリを独立したツールとして公開する最大数 | `16` |\n| `maxTasks` | ローカルに保持するタスク記録の上限 | `50` |\n| `outputDirectory` | 成果物を保存するワークスペース内の相対フォルダー | `aihub-output` |\n\n最初の確認:\n\n1. コマンド「AI Hub アプリ」を実行し、パネルに一覧が表示されることを確認します（未サインインの場合、パネルは先にサインインを促します）。\n2. 会話に戻って「AI Hub の一覧から契約レビューのアプリを探して」と伝えます。アシスタントは `aihub_status` を呼び、該当するアプリを一覧します。\n3. 読み取り専用のアプリを選んで「このアプリで次の文章を処理して」と伝えると、スキーマを読んで 1 回実行し、結果を会話に返します。長い実行はタスク監視のプラグイン領域に表示されます。\n\nよくある導入の失敗:\n\n- **未サインインと言われる**: AI Hub のセッションはホスト側のもので、プラグインにはありません。アプリ内でサインインしてから再試行し、トークンをチャットに貼らないでください。\n- **一覧が古い**: 一覧は `catalogTtlMinutes` ごとにバックグラウンドで更新されます。追加・削除された直後のアプリは更新が必要です（アシスタントが `aihub_refresh_catalog` を呼べます）。\n- **アップロードが拒否される（`AIHUB_FILE_INVALID`）**: パスが選択したフォルダーの外にあるか、ファイル選択が取り消されています。同じパスを再試行せず、ファイルを会話に添付してください。\n", "usage": "よくある 3 つの依頼:\n\n1. **クラウドアプリを実行する**: 「AI Hub でこの議事録を決定事項と ToDo に整理して」。アシスタントは一覧を引き、入力スキーマを読み、入力内容を確認してから実行します。回答は会話に戻り、成果物は `aihub-output` に保存されます。\n2. **長い文書をクラウドに任せる**: 「この調達契約を英語に翻訳して、終わったら教えて」。アシスタントは `mode:\"async\"` で開始して taskId を報告し、ターンを終えます。進捗はタスク監視のプラグイン領域に出て、完了時に会話が再開されます。\n3. **過去の結果を見る**: 「先週このアプリが出したあのレポートの結論を見せて」。アシスタントは `aihub_list_conversations` で会話を探し、`aihub_get_conversation` でメッセージを読み、クラウドの履歴をデータとして扱います。\n\n入口はコマンド「AI Hub アプリ」で、アプリ一覧パネル（閲覧、固定、インストール済みアプリの管理、タスクの確認）が開きます。会話内は一覧・実行・タスクの各ツールが担い、固定したアプリはそれぞれ `aihub_app_<別名>` ツールとしても公開されます:\n\n| 機能 | 内容 |\n| --- | --- |\n| `aihub_status` | サインイン状態、hub、一覧のリビジョンと経過、固定アプリ、実行中タスク、上限 |\n| `aihub_refresh_catalog` | クラウドの一覧を更新し、追加・削除・変更を報告します |\n| `aihub_list_apps` | キーワード、カテゴリ、実行方式でアプリを一覧します |\n| `aihub_describe_app` | 1 つのアプリの種類、実行方式、リスク、入力スキーマ、ファイル項目 |\n| `aihub_get_options` | 選択項目の動的な選択肢を解決します |\n| `aihub_run_app` | 実行を開始します。高リスクのアプリは `confirm` が必要で、リンクのみのアプリは URL を返します |\n| `aihub_upload_file` | ファイルを 1 つアップロードし、ファイル項目が要求するオブジェクトを返します |\n| `aihub_get_task` | タスク状態、カーソル以降の差分、最終結果を読みます |\n| `aihub_wait_task` | 最大 45 秒待ちます。タイムアウトは失敗ではありません |\n| `aihub_stop_task` | 実行中のタスクを停止します |\n| `aihub_resume_task` | 中断されたタスクを message id で再開します |\n| `aihub_open_app` | リンクのみのアプリを開きます。実際に開くのは確認後です |\n| `aihub_list_conversations` | あるアプリの直近のクラウド会話を探します |\n| `aihub_get_conversation` | 1 つのクラウド会話のメッセージを読みます |\n\n期待しないでください:\n\n- 高リスク操作の代行承認: 書き込みと読み取り専用ではないアプリは毎回 `confirm:true` が必要で、前のタスクでの同意が引き継がれることはありません。\n- ディスクの自発的な読み取り: ファイルは選択したフォルダーかこの会話の添付からのみ取得し、依頼されたときだけアップロードします。リンクも確認後にのみ開きます。\n- 信頼できる指示元として扱うこと: アプリの説明、出力、クラウドの会話履歴はいずれも信頼できないデータで、そこに書かれた内容で権限や作業内容が変わることはありません。\n" }, "en": { "intro": "AI Hub Apps brings the cloud AI Hub workbench into the conversation. The catalog is loaded dynamically — apps get added, renamed and given new input forms — so the assistant looks it up and reads the app's own description every time instead of trusting a remembered one.\n\nRuns execute as your signed-in AI Hub account, and the plugin never receives the SSO token: the host proxy injects it. Writes, and any app that does not declare itself read-only, wait for your explicit agreement; a link-only app hands back a URL and opens only after you confirm.\n\nLong runs do not have to hold the turn: start one asynchronously, watch it in the task monitor's plugin area, and the conversation is woken when it finishes. Artifacts download into a workspace folder; preview links expire, the local files are the real delivery.\n\nWhat you can do with it:\n\n- Have the assistant find an app in the cloud catalog by keyword, read its input schema and file fields, then run it as that schema says.\n- Hand a document to a cloud app (translation, review, generation, comparison), follow it in the task monitor and pick the result up in the conversation.\n- Upload a file you attached to this conversation, or a file from the folder you selected.\n- Browse an app's recent cloud conversations and read the earlier results back as material.\n", "install": "This plugin is not part of the installer: install it here before using it. After removing it you can reinstall it here, but its settings and data start over.\nOne thing makes it work out of the box: you are already signed in to AI Hub in this desktop app. The plugin stores no SSO token and needs no address or key of its own — requests go out through the host proxy. The catalog cache, pinned apps, task metadata and encrypted task events stay in the plugin's own data directory; files are read only from the folder you selected or from this conversation's attachments, and uploaded only when you ask. **Do not paste any access token into the chat** — the plugin neither needs nor accepts one.\n\n| Setting | Purpose | Default |\n| --- | --- | --- |\n| `catalogTtlMinutes` | Background catalog refresh interval in minutes | `15` |\n| `maxResultBytes` | Task answers and deltas above this size are truncated | `32768` |\n| `taskRetentionDays` | Task records and encrypted events older than this are removed | `7` |\n| `maxPinnedApps` | How many pinned apps are exposed as dedicated tools | `16` |\n| `maxTasks` | How many task records are kept locally | `50` |\n| `outputDirectory` | Workspace-relative folder for downloaded artifacts | `aihub-output` |\n\nFirst verification:\n\n1. Run the command \"AI Hub apps\" and check that the panel lists the catalog (without a sign-in the panel asks you to sign in first).\n2. Back in the chat, say \"find a contract review app in the AI Hub catalog\" — the assistant calls `aihub_status`, then lists the matching apps.\n3. Pick a read-only app and say \"run this app on the following text\" — the assistant reads the schema, runs it once and returns the result; long runs show up in the task monitor's plugin area.\n\nCommon install failures:\n\n- **The assistant reports you are not signed in**: the AI Hub session belongs to the host, not the plugin; sign in inside the app and retry, and never paste a token into the chat.\n- **The listed apps are stale**: the catalog refreshes in the background every `catalogTtlMinutes`; an app added or removed just now needs a refresh (the assistant can call `aihub_refresh_catalog`).\n- **An upload is rejected (`AIHUB_FILE_INVALID`)**: the path is outside the folder you selected, or the picker was dismissed; attach the file to the conversation instead of retrying the same path.\n", "usage": "Three common things to ask for:\n\n1. **Run a cloud app**: \"Use AI Hub to turn these meeting notes into decisions and action items.\" The assistant looks up the catalog, reads the input schema, confirms the inputs with you, then runs it; the answer returns to the conversation and artifacts land in `aihub-output`.\n2. **Hand a long document to the cloud**: \"Translate this procurement contract into English and tell me when it is done.\" The assistant starts it with `mode:\"async\"`, reports the task id, ends the turn, and the run finishes in the task monitor's plugin area — the conversation is woken when it does.\n3. **Read earlier results**: \"What did this app conclude about that report last week?\" The assistant finds the conversation with `aihub_list_conversations`, reads it with `aihub_get_conversation`, and treats the cloud history as data.\n\nThe entry point is the command \"AI Hub apps\", which opens the app catalog panel (browse, pin, manage installed apps, watch tasks). In the conversation, catalog, run and task tools do the work, and every pinned app also exposes its own `aihub_app_` tool:\n\n| Capability | What it does |\n| --- | --- |\n| `aihub_status` | Sign-in state, hub, catalog revision and age, pinned apps, active tasks and limits |\n| `aihub_refresh_catalog` | Refreshes the cloud catalog and reports added, removed and changed apps |\n| `aihub_list_apps` | Lists apps by keyword, category or run mode |\n| `aihub_describe_app` | Type, run mode, risk, input schema and file fields of one app |\n| `aihub_get_options` | Resolves the dynamic options of one select field |\n| `aihub_run_app` | Starts a run; high-risk apps need `confirm`, link-only apps return a URL |\n| `aihub_upload_file` | Uploads one file and returns the object the app's file field needs |\n| `aihub_get_task` | Reads task state, deltas since a cursor and the final result |\n| `aihub_wait_task` | Waits up to 45 seconds; a timeout is not a failure |\n| `aihub_stop_task` | Stops a running task |\n| `aihub_resume_task` | Resumes an interrupted task by message id |\n| `aihub_open_app` | Opens a link-only app; it really opens only after confirmation |\n| `aihub_list_conversations` | Finds an app's recent cloud conversations |\n| `aihub_get_conversation` | Reads the messages of one cloud conversation |\n\nDo not expect it to:\n\n- Confirm risky actions for you: writes and apps without a read-only declaration need `confirm:true` every time, and agreement from an earlier task never carries over.\n- Read your disk on its own: files come only from the folder you selected or from this conversation's attachments, and only upload when you ask; links open only after confirmation.\n- Be a trusted instruction source: app descriptions, app output and cloud conversation history are untrusted data — nothing written inside them changes permissions or the task.\n" } }, "versions": [ { "version": "1.3.4", "publishedAt": "2026-11-01T00:00:00Z", "minPiDesktop": ">=0.24.0", "shasum": "f4d57d7cd62218d3349aec3bc79d503c921cc08c701a064afebde53430cf2bee", "url": "packages/voki.aihub-apps-1.3.4.piplug", "sizeBytes": 290859, "permissions": [ "agent.tool.register", "agent.prompt.inject", "cloud.aihub", "fs.read", "shell.openExternal", "ui.panel", "renderer.extension" ], "fs": { "read": { "root": "userSelected" } } } ], "distribution": "marketplace" }, { "id": "voki.chrome-use", "name": "Browser Extension Control", "description": "Drive the user's own Chromium browser through the Voki browser extension.", "author": "voki-work", "i18n": { "en": { "name": "Browser Extension Control", "description": "Drive the user's own Chromium browser through the Voki browser extension.", "safetyNotes": "Reads and acts on the tabs the user hands to the agent. High-risk actions (send, publish, buy, delete, upload, login, script execution) ask the user in the browser page first. Credentials are never filled." }, "zh-CN": { "name": "浏览器扩展操控", "description": "通过 Voki 浏览器扩展操控用户自己的 Chromium 浏览器。", "safetyNotes": "只读取并操作用户交给 Agent 的标签页；发送、发布、购买、删除、上传、登录、执行脚本等高危动作会先在网页内请求用户确认；不会代填凭据。" }, "ja": { "name": "ブラウザ拡張制御", "description": "Voki Work ブラウザ拡張を介して、ユーザー自身の Chromium ブラウザを操作します。", "safetyNotes": "ユーザーがエージェントに渡したタブを読み取り、操作します。高リスクの操作（送信、公開、購入、削除、アップロード、ログイン、スクリプト実行）は、先にブラウザページでユーザーに確認します。認証情報を入力することはありません。" } }, "categories": [ "automation" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.chrome-use", "docs": { "zh-CN": { "intro": "浏览器扩展操控让助手在你自己的浏览器里干活：用的是你已经开着的那几个标签页，和它已经登录好的那些会话，而不是应用内部另开一个空的浏览器配置。\n\n你能用它做什么：\n\n- 在需要登录的站点上操作：公司后台、内部系统、邮箱、SaaS 控制台、SSO 后面的页面，都不用重新登录一遍。\n- 接手你已经打开的那个页面——你说「这个页面」「我刚开的那个标签」，它就在那个标签上操作。\n- 需要看着它做的时候，把浏览器放在旁边，操作过程就在你眼前发生。\n- 提交表单这类动作之前，它会先在网页里问你一句；你的密码、验证码、卡号不在它的输入范围里。\n", "install": "本插件随应用提供并默认启用。如果你卸载了它，可以在这里重新安装，并把配置从头配一遍。\n需要两步准备，都不是在插件里填的：\n\n1. 在 Chrome 或其它 Chromium 浏览器里安装并连接 Voki Work 扩展；\n2. 在设置里打开连接开关，并确认扩展显示为已连接（连接入口在「设置 › 电脑操控 › 浏览器」，命令「打开浏览器扩展操控」会直接跳到那里）。\n\n插件本身没有需要填写的设置项。它要三项权限：注册助手工具（`agent.tool.register`）、访问宿主的浏览器扩展通道（`browser.external`），以及向助手注入使用说明（`agent.prompt.inject`）。\n\n首次验证：\n\n1. 命令「打开浏览器扩展操控」应打开设置页，连接开关处于开启、扩展显示已连接；\n2. 在浏览器里随便开一个标签页，然后对助手说「看看我现在开着的标签页」；\n3. 让它读当前页面：「这个页面的标题是什么」，它应该答出你眼前那页的标题；\n4. 再说「截一张图」，回复里应出现那个标签页的画面。\n\n常见安装失败：\n\n- **提示连接已关闭**：连接开关没开。去「设置 › 电脑操控 › 浏览器」打开，然后重新连接扩展。\n- **提示没有浏览器连接**：浏览器里没有打开并连接的 Voki Work 扩展。点扩展图标连接一次，确认扩展面板里显示已连接。\n- **提示扩展版本过旧**：扩展落后于协议版本。更新扩展，或者重新加载未打包扩展，再重新连接。\n- **某个标签页始终抓不到**：`chrome://` 页面、应用商店和 DevTools 占着的标签无法操作，换一个普通 http(s) 页面。\n", "usage": "三个常见用法：\n\n1. 「在我已经打开的报销系统里，把 8 月那张单子提交掉」——它只在你交出的那个标签页里按 `uid` 点击和填表，提交动作会先在网页里弹确认，你点了同意才继续。\n2. 「我登录着的后台里，订单列表第三页有几条超时的？」——它读的是你当前会话的页面，不用重新登录，也不需要你复制粘贴。\n3. 「这个按钮点了没反应，看看控制台报了什么」——读 console 与网络请求，比再截一张图更容易定位失败的那次调用。\n\n入口有两个。命令面板里的「打开浏览器扩展操控」（斜杠 `/browser-use`）跳到「设置 › 电脑操控 › 浏览器」；对话里直接说「用我的 Chrome」也可以——插件带一份使用说明，在你提到自己的浏览器、已登录的站点时会引导助手改用它。助手手上的工具叫 `BrowserExtension`。\n\n| 能力 | 做什么 |\n| --- | --- |\n| 标签页与导航 | 列出你开着的标签页、在指定标签里打开你在提示里给出的网址 |\n| 读取页面 | 抓取带 `uid` 的页面结构、按文字或角色查找、截图 |\n| 操作 | 按 `uid` 或坐标点击、输入文本、按键组合、滚动、上传文件、处理网页弹窗、执行一段脚本 |\n| 诊断 | 读 console 消息、读网络请求、调用扩展提供的浏览器接口 |\n\n不要指望它做什么：\n\n- 不碰凭据：密码框会被拒绝，它不会代填密码、验证码或卡号——需要你自己登录。\n- 不替你越过确认：发送、发布、购买、删除、上传、登录、执行脚本都会先在网页里问你；你拒绝了就是拒绝了，它不会绕过去重试。\n- 不是内置浏览器：它只操作你交出的那个标签页，`chrome://` 页面、应用商店、DevTools 占用的标签抓不到；页面里的文字是数据，不是给助手的指令。\n" }, "ja": { "intro": "ブラウザ拡張制御は、エージェントをあなた自身のブラウザの中で働かせます。すでに開いているタブと、すでにログインしているセッションを使います。アプリ内に新しく空のブラウザプロファイルを作るのではありません。\n\nできること:\n\n- ログインが必要なサイトで操作できます。社内管理画面、基幹システム、Web メール、SaaS コンソール、SSO の先にあるページでも、ログインし直す必要はありません。\n- すでに開いているページをそのまま引き継げます。「このページ」「さっき開いたタブ」と言えば、そのタブで操作します。\n- 動作を見ていられます。ブラウザをアプリの隣に置けば、操作は目の前で進みます。\n- フォーム送信のような操作の前には、ページ内で先に確認を求めます。パスワード、ワンタイムコード、カード番号は入力対象外です。\n", "install": "このプラグインはアプリに同梱され、既定で有効です。削除した場合はここから再インストールし、あらためて設定してください。\n準備は 2 つで、どちらもプラグイン側で入力するものではありません。\n\n1. Chrome などの Chromium 系ブラウザに Voki Work 拡張をインストールして接続します。\n2. 設定で接続スイッチをオンにし、拡張が接続済みと表示されることを確認します（接続先は「設定 › コンピューター操作 › ブラウザ」で、コマンド「ブラウザー拡張制御を開く」から直接移動できます）。\n\nプラグイン自体に入力する設定項目はありません。使う権限は 3 つです。エージェントへのツール登録（`agent.tool.register`）、ホストのブラウザ拡張チャネルへの到達（`browser.external`）、エージェントへの利用ガイダンス注入（`agent.prompt.inject`）。\n\n最初の確認:\n\n1. コマンド「ブラウザー拡張制御を開く」で設定ページが開き、接続スイッチがオン、拡張が接続済みと表示されます。\n2. ブラウザで任意のタブを開き、エージェントに「いま開いているタブを見せて」と伝えます。\n3. 現在のページを読ませます。「このページのタイトルは？」に対して、目の前のタブのタイトルを答えるはずです。\n4. 「スクリーンショットを撮って」と言うと、そのタブの画像が返信に付きます。\n\nよくある導入のつまずき:\n\n- **接続がオフだと表示される**: 接続スイッチが入っていません。「設定 › コンピューター操作 › ブラウザ」でオンにして、拡張を接続し直してください。\n- **ブラウザが接続されていないと表示される**: ブラウザ側で Voki Work 拡張が開いて接続されていません。拡張アイコンから接続し、拡張のポップアップが接続済みと表示されることを確認してください。\n- **拡張が古いと表示される**: 拡張がプロトコルより古い状態です。拡張を更新するか、未パッケージ拡張を再読み込みしてから接続し直してください。\n- **特定のタブだけ取得できない**: `chrome://` ページ、ウェブストア、DevTools が握っているタブは操作できません。通常の http(s) ページに切り替えてください。\n", "usage": "よくある 3 つの頼み方:\n\n1. 「いま開いている経費精算システムで、8 月の申請を提出して」— 渡したタブの中だけで `uid` を使ってクリックと入力を行い、送信の前にページ内で確認を求めます。同意してから続行します。\n2. 「ログイン中の管理画面で、注文一覧の 3 ページ目にタイムアウトは何件ある？」— 既存のセッションのページを読むので、ログインし直しもコピペも不要です。\n3. 「このボタンを押しても反応しない。コンソールに何が出ている？」— console とネットワーク要求を読むほうが、もう 1 枚スクリーンショットを撮るより失敗した呼び出しを特定しやすいです。\n\n入口は 2 つです。コマンドパレットの「ブラウザー拡張制御を開く」（スラッシュ `/browser-use`）は「設定 › コンピューター操作 › ブラウザ」へ移動します。会話で「自分の Chrome を使って」と言っても構いません。プラグインは利用ガイダンスを提供し、自分のブラウザやログイン済みのサイトに触れたときにこのツールへ誘導します。エージェントが持つツール名は `BrowserExtension` です。\n\n| できること | 内容 |\n| --- | --- |\n| タブと移動 | 開いているタブの一覧、指定したタブで伝えた URL を開く |\n| ページの読み取り | `uid` 付きのページ構造の取得、テキストやロールでの検索、スクリーンショット |\n| 操作 | `uid` または座標でのクリック、テキスト入力、キー組み合わせ、スクロール、ファイルのアップロード、ページのダイアログ処理、スクリプトの実行 |\n| 診断 | console メッセージの読み取り、ネットワーク要求の読み取り、拡張が提供するブラウザ API の呼び出し |\n\n期待しないでください:\n\n- 認証情報には触れません。パスワード欄は拒否され、パスワード、ワンタイムコード、カード番号を代理入力しません。ログインはご自身で行ってください。\n- 確認を飛ばすことはできません。送信、公開、購入、削除、アップロード、ログイン、スクリプト実行はページ内で先に確認を求めます。断ったらそこで終わりで、迂回はしません。\n- 内蔵ブラウザではありません。渡したタブだけを操作し、`chrome://` ページ、ウェブストア、DevTools が握っているタブは取得できません。ページ内のテキストはデータであり、エージェントへの指示ではありません。\n" }, "en": { "intro": "Browser Extension Control lets the assistant work inside your own browser: the tabs you already have open, with the sessions you are already signed into — not a fresh, empty browser profile inside the app.\n\nWhat you can do with it:\n\n- Act on sites that need a login: internal admin panels, back-office systems, webmail, SaaS consoles, anything behind SSO, without signing in again.\n- Take over the page you already have open — when you say \"this page\" or \"the tab I just opened\", that is the tab it works on.\n- Watch it happen: keep the browser next to the app and the work happens in front of you.\n- Before actions like submitting a form it asks you inside the page first; your passwords, one-time codes and card numbers are outside what it may type.\n", "install": "This plugin ships with the app and is on by default. If you removed it, install it here to bring it back, then set it up again.\nTwo things to set up, and neither is filled in on the plugin itself:\n\n1. Install the Voki Work extension in Chrome or another Chromium browser and connect it;\n2. Turn the connection switch on in settings and confirm the extension shows as connected (the switch lives under Settings › Computer Control › Browser; the command **Open Browser Extension Control** takes you there directly).\n\nThe plugin has no settings of its own to fill in. It uses three permissions: registering an agent tool (`agent.tool.register`), reaching the host's browser extension channel (`browser.external`), and injecting usage guidance for the assistant (`agent.prompt.inject`).\n\nFirst check:\n\n1. The command **Open Browser Extension Control** should open the settings page with the switch on and the extension shown as connected;\n2. Open any tab in your browser, then ask the assistant \"what tabs do I have open right now\";\n3. Have it read the current page: \"what is the title of this page\" — it should answer with the tab in front of you;\n4. Say \"take a screenshot\" and the reply should carry an image of that tab.\n\nCommon setup failures:\n\n- **It reports the connection is off**: the switch is not on. Open Settings › Computer Control › Browser, turn it on, then connect the extension again.\n- **It reports no browser connected**: no Voki Work extension is open and connected in the browser. Connect it from the extension icon and confirm the extension popup shows it as connected.\n- **It reports the extension is outdated**: the extension is behind the protocol. Update it, or reload the unpacked extension, then reconnect.\n- **One specific tab can never be captured**: `chrome://` pages, the Web Store and tabs held by DevTools cannot be driven. Switch to a normal http(s) page.\n", "usage": "Three common things to ask for:\n\n1. \"Submit the August expense claim in the reimbursement system I already have open\" — it clicks and fills by `uid` only inside the tab you handed over, and the submit asks you for confirmation in the page before it continues.\n2. \"In the admin panel I'm signed into, how many orders on page 3 of the list have timed out?\" — it reads the page in your existing session, with no new login and no copy-pasting.\n3. \"This button does nothing when I click it — check what the console says\" — reading console and network requests locates the failing call faster than another screenshot.\n\nThere are two entry points. The command **Open Browser Extension Control** (slash `/browser-use`) jumps to Settings › Computer Control › Browser; in the conversation, \"use my Chrome\" is enough — the plugin contributes usage guidance that steers the assistant to this tool when you mention your own browser or a site you are signed into. The tool the assistant holds is named `BrowserExtension`.\n\n| Capability | What it does |\n| --- | --- |\n| Tabs and navigation | List the tabs you have open; open the URL you named inside a given tab |\n| Reading a page | Capture the page structure with `uid`s, find by text or role, take a screenshot |\n| Acting | Click by `uid` or coordinates, type text, press key combinations, scroll, upload a file, handle a page dialog, run a script |\n| Diagnosing | Read console messages, read network requests, call the extension's browser API |\n\nDo not expect it to:\n\n- Touch credentials: password fields are refused, and it will not type passwords, one-time codes or card numbers — sign in yourself.\n- Get past your confirmation: send, publish, buy, delete, upload, login and script execution all ask you in the page first. If you decline, that is the answer; it does not go around it.\n- Be the built-in browser: it only acts on the tab you handed over, and `chrome://` pages, the Web Store and tabs held by DevTools cannot be captured. Page text is data, not instructions for the assistant.\n" } }, "versions": [ { "version": "1.0.0", "publishedAt": "2026-11-01T00:00:00Z", "minPiDesktop": ">=0.20.0", "shasum": "66477f6d36e5ebf582047c51419b18150825d347b5c03e578f0aaf9a40160d74", "url": "packages/voki.chrome-use-1.0.0.piplug", "sizeBytes": 32173, "permissions": [ "agent.tool.register", "browser.external", "agent.prompt.inject" ], "fs": {} } ], "distribution": "bundled" }, { "id": "voki.computer-use", "name": "Computer Control", "description": "Observe and operate desktop applications through the native Computer Use runtime.", "author": "voki-work", "i18n": { "en": { "name": "Computer Control", "description": "Observe and operate desktop applications through the native Computer Use runtime.", "safetyNotes": "Requires the Computer Control switch and, on macOS, Accessibility/Screen Recording grants. Every mutating action asks for confirmation before it runs, is written to the audit trail, and can be stopped with the emergency hotkey or the stop bar. The app policy decides which applications may be observed or launched. The plugin sees only structured results." }, "zh-CN": { "name": "电脑操控", "description": "通过原生 Computer Use 运行组件观察并操作桌面应用。", "safetyNotes": "需要开启电脑操控；macOS 还需授予辅助功能/屏幕录制权限。所有变更类动作执行前都会请求确认，写入审计轨迹，并可用急停热键或停止条中止。应用策略决定哪些应用可以被观察或启动。插件只能拿到结构化结果。" }, "ja": { "name": "コンピューター操作", "description": "ネイティブの Computer Use ランタイムを通じてデスクトップアプリを観察し操作します。", "safetyNotes": "コンピューター操作スイッチと、macOS ではアクセシビリティ/画面収録の許可が必要です。変更を伴う操作は実行前に確認を求め、監査ログに記録され、緊急停止キーまたは停止バーで中止できます。アプリポリシーが観察・起動できるアプリを決めます。プラグインは構造化された結果のみを受け取ります。" } }, "categories": [ "automation" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.computer-use", "docs": { "zh-CN": { "intro": "电脑操控让助手看你的桌面并动手：截图、列出打开的窗口、读界面上真实的控件，然后点、输入、拖拽、按快捷键。它走的是应用自带的原生 Computer Use 运行组件。\n\n你能用它做什么：\n\n- 处理只存在于桌面应用里的东西：本地表格、财务软件、只有 Windows 客户端的老系统、系统设置面板。\n- 它先读可访问性树拿到元素，再按元素操作，比盲点坐标稳；读不到元素时才退回用坐标。\n- 需要等界面反应过来时，用「等待某个窗口 / 某段文字出现」代替硬编码的 sleep。\n- 长流程中间可以随时喊停：急停热键或停止条一按，当前桌面操作和这一轮对话一起终止。\n", "install": "本插件随应用提供并默认启用。如果你卸载了它，可以在这里重新安装，并把配置从头配一遍。\n装好之后还要过一个开关和（在 macOS 上）两个系统授权，插件里没有需要填写的设置项：\n\n1. 打开「设置 › 电脑操控」，把总开关打开；\n2. macOS 上再授予**辅助功能**与**屏幕录制**（系统设置 › 隐私与安全性）；\n3. 在同一个设置页里决定哪些应用可以被观察或操作——这份应用策略决定 `launch` 能启动什么。\n\n插件只声明两项权限：注册助手工具（`agent.tool.register`）与桌面操控（`computer.control`）。运行组件由应用提供，平台支持为 macOS 14+、Windows 10+，以及带 X11 的 Linux；元素级操作需要 macOS 或 Windows。\n\n首次验证：\n\n1. 用命令「打开电脑操控」打开设置页，确认总开关已开、平台没有报「不支持」；\n2. 说「截个图看看现在屏幕上是什么」，回复里应出现当前屏幕的截图；\n3. 说「有哪些窗口开着」，它应列出窗口标题而不是报错；\n4. 让它点一下某个无害的位置，确认网页/系统弹窗里出现确认请求，取消即可。\n\n常见安装失败：\n\n- **报缺少权限**：辅助功能或屏幕录制没授予。在系统设置里勾上之后重启 Voki Work，让原生辅助重新读取授权；已经勾着还报错，几乎都是没重启。\n- **报平台不支持**：需要 macOS 14+、Windows 10+ 或带 X11 的 Linux；达不到这个前提时装了也用不了。\n- **报应用被策略拦住**：目标应用不在允许列表里。在「设置 › 电脑操控」里允许它，或换成别的应用。\n- **报运行组件不可用**：安装包里没有带上原生运行组件。重装应用，不要试着手动补文件。\n", "usage": "三个常见用法：\n\n1. 「把 Excel 里这张表另存成 PDF，放到桌面」——它先看窗口和界面元素，再走菜单或快捷键；保存这类变更动作执行前会先问你。\n2. 「刚才那个弹窗里写了什么」——截图加读元素值，把界面上的文字和结构给你，而不是让你自己念一遍。\n3. 「在编辑器里把第 12 行改成 `return null`」——通过元素操作或粘贴写入，然后停在你确认的那一步。\n\n入口有两个。命令面板里的「打开电脑操控」（斜杠 `/computer-use`）直接跳到「设置 › 电脑操控」，可以开关、授权和改应用列表；对话里直接说「帮我在某个应用里做某事」就会用到它。助手手上的工具叫 `ComputerControl`。\n\n| 能力 | 做什么 |\n| --- | --- |\n| 观察 | 截图、列出窗口、列出可启动的应用、读取界面元素结构、读某个元素的值、等待某个条件出现 |\n| 操作 | 单击、双击、移动指针、滚动、输入文本、通过剪贴板粘贴、按快捷键、拖拽、对元素执行语义动作（聚焦、调用、设置值、滚动） |\n| 启动与中止 | 启动允许列表里的应用；`stop` 立即中止当前桌面操作 |\n\n不要指望它做什么：\n\n- 不能越过确认与策略：每个变更类动作都要你点确认，被应用策略挡住的应用既不能被观察也不能被启动；插件只拿到结构化结果，看不到原始画面流。\n- 不是无痕操作：变更类动作会写入审计轨迹，可以用急停热键或停止条中止，中止就是中止，这一轮不会继续重试。\n- 不保证认得清每个界面：元素级操作只在 macOS 与 Windows 上可用，自绘界面、游戏、远程桌面里通常只剩坐标和截图，仍然可能点偏。\n" }, "ja": { "intro": "コンピューター操作は、エージェントにデスクトップを見せて動かします。スクリーンショット、開いているウィンドウの一覧、画面上の実際のコントロールの読み取り、そのうえでクリック、入力、ドラッグ、ショートカットの押下を行います。アプリに同梱されたネイティブ Computer Use ランタイムを使います。\n\nできること:\n\n- デスクトップアプリにしか無いものを扱えます。ローカルの表計算、会計ソフト、Windows クライアントしかない古いシステム、OS の設定画面など。\n- アクセシビリティツリーを読んで要素に対して操作します。座標を闇雲にクリックするより確実で、要素が読めないときだけ座標に戻ります。\n- UI の反応を待てます。固定の sleep ではなく、ウィンドウやテキストの出現を条件に待機します。\n- 長い手順の途中でいつでも止められます。緊急停止キーまたは停止バーで、現在のデスクトップ操作とそのターンが終了します。\n", "install": "このプラグインはアプリに同梱され、既定で有効です。削除した場合はここから再インストールし、あらためて設定してください。\nインストールに加えて、スイッチ 1 つと（macOS では）システム許可 2 つが必要です。プラグイン側に入力する設定項目はありません。\n\n1. 「設定 › コンピューター操作」を開き、メインスイッチをオンにします。\n2. macOS ではさらに**アクセシビリティ**と**画面収録**を許可します（システム設定 › プライバシーとセキュリティ）。\n3. 同じ設定ページで、観察・操作を許可するアプリを決めます。このアプリポリシーが `launch` で起動できるアプリを決めます。\n\n宣言する権限は 2 つです。エージェントへのツール登録（`agent.tool.register`）とデスクトップ操作（`computer.control`）。ランタイムはアプリに同梱され、対応プラットフォームは macOS 14+、Windows 10+、X11 の Linux です。要素単位の操作には macOS か Windows が必要です。\n\n最初の確認:\n\n1. コマンド「コンピューター操作を開く」で設定ページを開き、スイッチがオンで、プラットフォームが「非対応」と表示されないことを確認します。\n2. 「スクリーンショットを撮って、いま画面に何が出ているか教えて」と言うと、現在の画面画像が返信に付きます。\n3. 「どんなウィンドウが開いている？」と聞くと、エラーではなくウィンドウのタイトルが並びます。\n4. 無害な場所をクリックさせ、確認ダイアログが出ることを確認してからキャンセルします。\n\nよくある導入のつまずき:\n\n- **権限が足りないと表示される**: アクセシビリティまたは画面収録が許可されていません。システム設定で許可したあと Voki Work を再起動し、ネイティブヘルパーに許可を読み直させてください。チェック済みなのに失敗する場合は、ほぼ再起動漏れです。\n- **プラットフォーム非対応と表示される**: macOS 14+、Windows 10+、X11 の Linux が必要です。これを満たさない環境では動きません。\n- **アプリがポリシーで拒否されると表示される**: 対象アプリが許可リストに入っていません。「設定 › コンピューター操作」で許可するか、別のアプリを使ってください。\n- **ランタイムが利用できないと表示される**: インストーラーにネイティブランタイムが含まれていません。アプリを再インストールしてください（手動でファイルを足さないでください）。\n", "usage": "よくある 3 つの頼み方:\n\n1. 「Excel のこのシートを PDF でデスクトップに保存して」— ウィンドウと画面上の要素を見てからメニューやショートカットで進みます。保存のような変更操作の前には確認を求めます。\n2. 「さっきのダイアログには何が書いてあった？」— スクリーンショットと要素の値から、画面のテキストと構造を返します。読み上げてもらう必要はありません。\n3. 「エディターの 12 行目を `return null` に変えて」— 要素操作または貼り付けで書き換え、あなたが確認する段階で止まります。\n\n入口は 2 つです。コマンドパレットの「コンピューター操作を開く」（スラッシュ `/computer-use`）は「設定 › コンピューター操作」へ移動し、オン／オフ、許可、アプリ一覧の編集ができます。会話では「このアプリでこれをやって」と頼めば到達します。エージェントが持つツール名は `ComputerControl` です。\n\n| できること | 内容 |\n| --- | --- |\n| 観察 | スクリーンショット、ウィンドウ一覧、起動可能なアプリ一覧、UI 要素ツリーの読み取り、要素の値の読み取り、条件待ち |\n| 操作 | クリック、ダブルクリック、ポインター移動、スクロール、テキスト入力、クリップボード経由の貼り付け、ショートカット押下、ドラッグ、要素へのセマンティック操作（フォーカス、実行、値設定、スクロール） |\n| 起動と中止 | 許可リストのアプリを起動、`stop` で現在のデスクトップ操作を即座に中止 |\n\n期待しないでください:\n\n- 確認とポリシーを飛ばすことはできません。変更を伴う操作はすべて事前に確認を求め、ポリシーで拒否されたアプリは観察も起動もできません。プラグインが受け取るのは構造化された結果だけで、生の画面ストリームではありません。\n- 痕跡が残らないわけではありません。変更を伴う操作は監査ログに記録され、緊急停止キーや停止バーで中止できます。中止したらそのターンは再試行しません。\n- どの UI でも正しく認識できるわけではありません。要素単位の操作は macOS と Windows のみで、自前描画の画面、ゲーム、リモートデスクトップでは座標とスクリーンショットだけになり、外すことがあります。\n" }, "en": { "intro": "Computer Control lets the assistant see your desktop and act on it: take screenshots, list open windows, read the real controls in a UI, then click, type, drag and press shortcuts. It runs through the app's own native Computer Use runtime.\n\nWhat you can do with it:\n\n- Work on things that only exist in desktop apps: local spreadsheets, accounting software, an old system with a Windows-only client, the system settings pane.\n- It reads the accessibility tree and acts on elements rather than clicking blind coordinates, and only falls back to coordinates when an element cannot be read.\n- Wait for the UI instead of sleeping: wait for a window or a piece of text and continue when it appears.\n- Stop a long run at any point: the emergency hotkey or the stop bar aborts the current desktop operation together with the turn.\n", "install": "This plugin ships with the app and is on by default. If you removed it, install it here to bring it back, then set it up again.\nBeyond installing, there is one switch and — on macOS — two system grants. The plugin has no settings of its own to fill in:\n\n1. Open Settings › Computer Control and turn the main switch on;\n2. On macOS, also grant **Accessibility** and **Screen Recording** (System Settings › Privacy & Security);\n3. On the same page, decide which applications may be observed or operated — that app policy decides what `launch` can start.\n\nThe plugin declares two permissions: registering an agent tool (`agent.tool.register`) and desktop control (`computer.control`). The runtime ships with the app; supported platforms are macOS 14+, Windows 10+, and Linux with X11, and element-level actions need macOS or Windows.\n\nFirst check:\n\n1. Run the command **Open Computer Control**, confirm the switch is on and the platform is not reported as unsupported;\n2. Say \"take a screenshot and tell me what is on screen\" — the reply should carry an image of the current screen;\n3. Say \"which windows are open\" — it should list window titles instead of failing;\n4. Have it click a harmless spot and confirm the confirmation prompt appears; cancel it.\n\nCommon setup failures:\n\n- **It reports missing permissions**: Accessibility or Screen Recording is not granted. Grant it in System Settings, then restart Voki Work so the native helper re-reads the grant — a grant that is already ticked but still failing almost always means no restart.\n- **It reports an unsupported platform**: this needs macOS 14+, Windows 10+ or Linux with X11; below that, the plugin cannot work at all.\n- **It reports the app is blocked by policy**: the target application is not on the allowed list. Allow it under Settings › Computer Control, or use another app.\n- **It reports the runtime is unavailable**: the installer did not carry the native runtime. Reinstall the app; do not try to add files by hand.\n", "usage": "Three common things to ask for:\n\n1. \"Save this sheet in Excel as a PDF on the Desktop\" — it looks at the window and its controls, then goes through the menu or a shortcut; the save asks you before it runs.\n2. \"What did that dialog say?\" — a screenshot plus the element values give you the text and structure instead of you reading it out loud.\n3. \"Change line 12 in the editor to `return null`\" — it acts on the element or pastes the text, then stops at the step you confirm.\n\nThere are two entry points. The command **Open Computer Control** (slash `/computer-use`) jumps to Settings › Computer Control, where you turn it on, grant access and edit the app list; in the conversation, \"do this in that app for me\" is what reaches it. The tool the assistant holds is named `ComputerControl`.\n\n| Capability | What it does |\n| --- | --- |\n| Observing | Screenshot, list windows, list launchable apps, read the UI element tree, read one element's value, wait for a condition |\n| Acting | Click, double-click, move the pointer, scroll, type text, paste through the clipboard, press a shortcut, drag, run a semantic action on an element (focus, invoke, set value, scroll) |\n| Starting and stopping | Launch an app from the allowlist; `stop` aborts the current desktop operation immediately |\n\nDo not expect it to:\n\n- Get past confirmation or policy: every mutating action asks you first, and an app blocked by policy can be neither observed nor launched. The plugin only receives structured results, never a raw screen stream.\n- Be invisible: mutating actions are written to the audit trail, and the emergency hotkey or stop bar aborts them — an abort ends the turn instead of retrying.\n- Recognise every UI: element-level actions exist only on macOS and Windows, so custom-drawn interfaces, games and remote desktops usually leave only coordinates and screenshots, and can still miss.\n" } }, "versions": [ { "version": "1.0.0", "publishedAt": "2026-11-01T00:00:00Z", "minPiDesktop": ">=0.20.0", "shasum": "4063271e8c691bc40532761f457c669c4e46f98e4e14026df917009e6745dab3", "url": "packages/voki.computer-use-1.0.0.piplug", "sizeBytes": 32059, "permissions": [ "agent.tool.register", "computer.control" ], "fs": {} } ], "distribution": "bundled" }, { "id": "voki.dns-ssh-management", "name": "DNS & SSH Operations", "description": "Multi-cloud DNS records, ACME certificate issuance, SSH certificate deployment, monitoring and audit, with credentials kept in a local encrypted vault.", "author": "voki-work", "i18n": { "en": { "name": "DNS & SSH Operations", "description": "Multi-cloud DNS records, ACME certificate issuance, SSH certificate deployment, monitoring and audit, with credentials kept in a local encrypted vault.", "safetyNotes": "Credentials and certificate private keys are encrypted in this plugin's private vault; the default device-key mode protects against accidental copying, not against a malicious program running as you. Auto mode skips the per-call approval card for high-risk Agent tools. The plugin requests net.anyHost so user-entered webhooks and self-hosted ACME endpoints work; cloud metadata endpoints remain blocked. SSH runs the system OpenSSH client with your ~/.ssh/config and known_hosts; host fingerprint changes stop deployment." }, "zh-CN": { "name": "域名与 SSH 运维", "description": "多云解析记录、ACME 证书签发、SSH 证书部署、监控与审计；凭据保存在本机加密保险库。", "safetyNotes": "账号凭据与证书私钥加密保存在本插件私有保险库；默认设备密钥模式防止误拷贝，但不承诺抵御以你的身份运行的恶意程序，可选口令锁可加强保护。会话处于 auto 模式时，高风险 Agent 工具会跳过逐次审批卡。插件申请 net.anyHost 以支持用户自填 Webhook 与自建 ACME 端点，云元数据地址仍被拒绝。SSH 使用系统 OpenSSH 与你的 ~/.ssh/config、known_hosts；主机指纹变化会停止部署。" }, "ja": { "name": "DNS & SSH 運用", "description": "マルチクラウド DNS レコード、ACME 証明書発行、SSH 証明書配備、監視と監査。認証情報はローカルの暗号化ボルトに保存されます。", "safetyNotes": "認証情報と証明書の秘密鍵はこのプラグイン専用の暗号化ボルトに保存されます。既定のデバイスキー方式は誤コピーを防ぎますが、同じユーザーで動く悪意あるプログラムには耐えません。セッションが auto モードのとき、高リスクの Agent ツールは呼び出しごとの承認カードを省略します。プラグインはユーザー入力の Webhook と自前 ACME 端点のため net.anyHost を要求しますが、クラウドメタデータ端点は引き続き拒否されます。SSH はシステムの OpenSSH と ~/.ssh/config、known_hosts を使用し、ホスト鍵の変更で配備を停止します。" } }, "categories": [ "development" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.dns-ssh-management", "docs": { "zh-CN": { "intro": "域名与 SSH 运维把多云解析记录、ACME 证书签发、SSH 部署、监控与审计放进一个控制台。改 DNS 和部署证书都是对线上生效的动作，所以这里的写操作默认预演：先给你看要改什么，执行之后留一条审计。\n\n凭据与证书私钥加密保存在插件私有的保险库。默认是设备密钥模式（密钥文件在本机，权限 0600），能防误拷贝；也可以在面板里启用口令锁（口令至少 6 位）进一步保护。\n\n你能用它做什么：\n\n- 在阿里云、腾讯云 DNSPod、Cloudflare、AWS Route53、火山引擎、华为云之间切换，读同一批 zone 与记录。\n- 通过 ACME DNS-01 申请证书（Let's Encrypt、ZeroSSL、Google），密钥类型可选 ECC-256、ECC-384、RSA-2048、RSA-4096。\n- 用系统 OpenSSH 把证书部署到服务器，支持 nginx、apache、caddy、haproxy 预设与自定义文件与重载命令。\n- 跟踪证书到期、端点 TLS、域名与部署漂移，异常时推送到飞书、钉钉、企业微信或 ServerChan。\n", "install": "本插件不随安装包提供，安装后才可用。卸载之后可以在这里重新安装，配置与数据需要重新设置。\n需要你已有的云 DNS 账号（AccessKey 或 API Token）、一个你控制并能托管到这些账号的域名，以及用于部署的 SSH 服务器。SSH 走系统自带的 OpenSSH 客户端与你的 `~/.ssh/config`、`known_hosts`，不额外装依赖；主机指纹变化会直接中止部署。凭据、推送渠道的 token 与证书私钥加密存在插件私有保险库，不写进应用设置、不上传；插件申请了 `net.anyHost` 以便你自填 Webhook 与自建 ACME 端点，云元数据地址仍被拒绝。**AccessKey、API Token 与私钥请在面板表单里录入，不要贴在对话里。**\n\n没有需要填写的应用设置项：云账号、推送渠道、保险库模式与到期阈值都在侧栏「运维」面板的「设置」页里管理，凭据进入保险库之后只显示掩码。\n\n首次验证：\n\n1. 运行「Add cloud account」，选厂商、填 AccessKey 或 API Token，保存后账号显示可用；\n2. 在「解析」里选该账号，能看到 zone 列表与记录；\n3. 改一条测试记录：先看预演里的差异，确认后执行，再刷新确认已生效；\n4. 运行「Check monitors now」，在「监控」里看到这次检查结果与状态。\n\n常见安装失败：\n\n- **账号校验失败或签名错误**：AccessKey 权限不足（多数厂商要 DNS 或域名产品的读写权限）、地域端点填错（华为云、火山引擎需要正确的区域），或 Token 已过期。\n- **证书申请卡在 DNS-01**：域名必须托管在已配置的 zone 下，`challengeZone` 要选对；HTTP-01 与 TLS-ALPN-01 本版本不在范围内。\n- **部署失败**：服务器要先在「服务器」里登记；`~/.ssh/config` 连不上、主机指纹变化或目标目录不可写都会中止部署，先在「部署」里跑一次预演定位。\n- **保险库打不开**：启用口令锁后忘记口令无法恢复，只能清空保险库内容重新录入凭据。\n", "usage": "三个常见用法：\n\n1. **核对解析**：「看看 example.com 现在解析到哪台机器，有没有还指向旧 IP 的记录」。助手用 `dns_records` 读记录，只读不改。\n2. **改一条解析**：「把 api.example.com 的 A 记录换成 10.0.0.8，先给我看 diff」。`dns_record_upsert` 先用 `dryRun` 返回差异，你确认后它才带 `expected` 真正提交，宿主还会弹审批卡。\n3. **签证书并部署**：「给 example.com 和 *.example.com 签一张证书，部署到 web-01 的 nginx」。`certificate_request` 发起 DNS-01 作业并返回 jobId，`deploy_certificate` 部署前先预演，`ops_jobs` 可查进度或取消（取消要二次确认）。\n\n入口：侧栏「运维」面板（概览、解析、证书、部署、服务器、监控、通知、设置）；命令「Open console」「Add cloud account」「Request certificate」「Deploy certificate」「Check monitors now」。\n\n| 能力 | 做什么 |\n| --- | --- |\n| `dns_accounts` / `dns_zones` / `dns_records` | 列账号与 zone、查记录（分页、关键字），不返回凭据 |\n| `dns_record_upsert` / `dns_record_delete` | 建、改、删记录，high 风险，要先 `dryRun` 预演并带 `expected` 做并发校验 |\n| `certificates` | 列证书清单与到期状态，不返回私钥 |\n| `certificate_request` | 发起 ACME DNS-01 签发作业，返回 jobId |\n| `deploy_certificate` | 对已有部署与证书发起部署作业，返回 jobId |\n| `servers` / `server_probe` | 列 SSH 服务器与连通性；跑只读巡检（服务、证书、时钟、磁盘、sshd） |\n| `ops_jobs` | 列作业、看详情、取消作业（取消要二次确认） |\n| `monitors` / `notifications` | 列监控与最新状态；列最近的插件通知 |\n\n不要指望它做什么：\n\n- 不替你确认变更：写工具默认预演，`dryRun: false` 之前不会有真实改动；会话处于 auto 权限模式时审批卡会被跳过，语义与其他工具一致。\n- 不是通用 SSH 终端：只在已登记的服务器上跑预置部署与只读巡检，不做任意命令执行，也不做多服务器批量。\n- 不保证一次成功：厂商限流（429 / 5xx）会让作业失败，需要你重试或等下一轮调度；密钥轮换、WHOIS、PFX / JKS、STARTTLS 都不在范围内。\n" }, "ja": { "intro": "DNS & SSH 運用は、マルチクラウドの DNS レコード、ACME 証明書の発行、SSH での配備、監視、監査を 1 つのコンソールにまとめます。DNS の変更も証明書の配備も本番に効く操作なので、ここでの書き込みは既定でドライランです。まず何が変わるかを見せ、実行後は監査に 1 行残します。\n\n認証情報と証明書の秘密鍵は、プラグイン専用の暗号化ボルトに保存されます。既定はデバイスキー方式（鍵ファイルは本機、パーミッション 0600）で誤コピーを防ぎ、パネルでパスフレーズ ロック（6 文字以上）を有効にすればさらに強く保護できます。\n\nできること:\n\n- Alibaba Cloud、Tencent Cloud DNSPod、Cloudflare、AWS Route53、Volcengine、Huawei Cloud を切り替えながら、同じ操作でゾーンとレコードを読めます。\n- ACME DNS-01 で証明書を申請できます（Let's Encrypt、ZeroSSL、Google）。鍵種別は ECC-256、ECC-384、RSA-2048、RSA-4096。\n- システムの OpenSSH で証明書をサーバーへ配備します。nginx、apache、caddy、haproxy のプリセットに加え、カスタムのファイル一覧と再読み込みコマンドも使えます。\n- 証明書の有効期限、エンドポイントの TLS、ドメイン、配備のドリフトを監視し、異常時は Feishu、DingTalk、WeCom、ServerChan へ通知します。\n", "install": "このプラグインはインストーラーに含まれません。使う前にここからインストールしてください。削除後に再度インストールできますが、設定とデータは初期状態になります。\n必要なのは、すでにお持ちのクラウド DNS アカウント（AccessKey または API トークン）、そのアカウントにホストできるご自身のドメイン、そして配備先の SSH サーバーです。SSH はシステムの OpenSSH クライアントと `~/.ssh/config`、`known_hosts` を使うため追加依存はありません。ホスト鍵が変わると配備は中止されます。認証情報、通知チャネルのトークン、証明書の秘密鍵はプラグイン専用の暗号化ボルトに保存され、アプリ設定にも書かれず、アップロードもされません。自前の Webhook と自前の ACME エンドポイントを使えるよう `net.anyHost` を要求しますが、クラウドのメタデータ端点は引き続き拒否されます。**AccessKey、API トークン、秘密鍵はパネルのフォームに入力し、チャットには貼らないでください。**\n\n記入が必要なアプリ設定はありません。クラウド アカウント、通知チャネル、ボルトのモード、期限のしきい値は、サイドバーの「運用」パネルの「設定」ページで管理し、ボルトに入った認証情報はマスク表示だけになります。\n\n最初の確認:\n\n1. 「Add cloud account」を実行し、プロバイダーを選んで AccessKey または API トークンを入力します。保存後にアカウントが利用可能と表示されます。\n2. 「DNS」でそのアカウントを選び、ゾーンとレコードが一覧表示されることを確認します。\n3. テスト用のレコードを 1 件変更します。ドライランの差分を見て、確認してから実行し、更新して反映を確認します。\n4. 「Check monitors now」を実行し、「監視」で今回の結果と状態を確認します。\n\nよくある導入の失敗:\n\n- **アカウント検証や署名エラー**: AccessKey の権限不足（多くのプロバイダーは DNS またはドメイン製品の読み書き権限が必要）、リージョン端点の誤り（Huawei Cloud と Volcengine は正しいリージョンが必要）、トークンの期限切れが原因です。\n- **証明書申請が DNS-01 で止まる**: ドメインが設定済みのゾーンにホストされている必要があり、`challengeZone` を正しく選ぶ必要があります。HTTP-01 と TLS-ALPN-01 はこのバージョンの対象外です。\n- **配備に失敗する**: サーバーを先に「サーバー」へ登録する必要があります。`~/.ssh/config` で到達できない、ホスト鍵が変わった、対象ディレクトリに書き込めない場合は配備が中止されます。まず「配備」でドライランを実行してください。\n- **ボルトが開かない**: パスフレーズ ロックを有効にしたあとパスフレーズを忘れると復旧できません。ボルトの内容を消して認証情報を入れ直す必要があります。\n", "usage": "よくある 3 つの依頼:\n\n1. **DNS を確認する**: 「example.com は今どのホストを向いている？ 古い IP を指したままのレコードはある？」。`dns_records` で読むだけで変更しません。\n2. **レコードを 1 件変更する**: 「api.example.com の A レコードを 10.0.0.8 にして、先に差分を見せて」。`dns_record_upsert` はドライランで差分を返し、確認後に `expected` を付けて初めて送信します。ホストも承認カードを表示します。\n3. **証明書を発行して配備する**: 「example.com と *.example.com の証明書を取って、web-01 の nginx に配備して」。`certificate_request` が DNS-01 ジョブを開始して jobId を返し、`deploy_certificate` は配備前にドライランし、`ops_jobs` で進捗確認やキャンセル（2 回目の確認が必要）ができます。\n\n入口: サイドバーの「運用」パネル（概要、DNS、証明書、配備、サーバー、監視、通知、設定）と、コマンド「Open console」「Add cloud account」「Request certificate」「Deploy certificate」「Check monitors now」です。\n\n| 機能 | 内容 |\n| --- | --- |\n| `dns_accounts` / `dns_zones` / `dns_records` | アカウントとゾーンの一覧、レコードの照会（ページング、キーワード）。認証情報は返しません |\n| `dns_record_upsert` / `dns_record_delete` | レコードの作成・更新・削除。high リスクで `dryRun` によるドライランと `expected` による競合検査が必要 |\n| `certificates` | 証明書の一覧と有効期限の状態。秘密鍵は返しません |\n| `certificate_request` | ACME DNS-01 の発行ジョブを開始し、jobId を返します |\n| `deploy_certificate` | 既存の配備と証明書に対して配備ジョブを開始し、jobId を返します |\n| `servers` / `server_probe` | SSH サーバーと疎通の一覧、読み取り専用の点検（サービス、証明書、時刻、ディスク、sshd） |\n| `ops_jobs` | ジョブの一覧、詳細、キャンセル（キャンセルは 2 回目の確認が必要） |\n| `monitors` / `notifications` | 監視と最新状態の一覧、直近のプラグイン通知の一覧 |\n\n期待しないでください:\n\n- 変更の代行確認: 書き込みツールは既定でドライランで、`dryRun: false` までは実変更がありません。セッションが auto 権限モードのときは承認カードが省略され、他のツールと同じ意味になります。\n- 汎用 SSH 端末: 登録済みサーバーでプリセット配備と読み取り専用点検のみを実行し、任意コマンドの実行や複数サーバーの一括処理は行いません。\n- 一発成功の保証: プロバイダーの制限（429 / 5xx）でジョブは失敗し、再試行か次回のスケジュール待ちになります。鍵のローテーション、WHOIS、PFX / JKS、STARTTLS は対象外です。\n" }, "en": { "intro": "DNS & SSH Operations puts multi-cloud DNS records, ACME certificate issuance, SSH deployment, monitoring and audit into one console. Changing DNS and deploying certificates both take effect in production, so writes here are dry runs by default: you see what would change first, and every executed change leaves an audit entry.\n\nCredentials and certificate private keys are encrypted in the plugin's private vault. The default device-key mode (key file on this machine, mode 0600) protects against accidental copying; you can also turn on a passphrase lock in the panel (at least six characters) for stronger protection.\n\nWhat you can do with it:\n\n- Work across Alibaba Cloud, Tencent Cloud DNSPod, Cloudflare, AWS Route53, Volcengine and Huawei Cloud, reading zones and records the same way.\n- Request certificates over ACME DNS-01 (Let's Encrypt, ZeroSSL, Google) with ECC-256, ECC-384, RSA-2048 or RSA-4096 keys.\n- Deploy certificates to servers with the system OpenSSH client, using nginx, apache, caddy and haproxy presets plus custom file lists and reload commands.\n- Track certificate expiry, endpoint TLS, domains and deployment drift, and push alerts to Feishu, DingTalk, WeCom or ServerChan.\n", "install": "This plugin is not part of the installer: install it here before using it. After removing it you can reinstall it here, but its settings and data start over.\nYou need a cloud DNS account you already have (access key or API token), a domain you control and can host on that account, and the SSH servers you deploy to. SSH uses the system OpenSSH client with your `~/.ssh/config` and `known_hosts`, so no extra dependency is installed; a changed host fingerprint stops deployment. Credentials, notification tokens and certificate private keys are encrypted in the plugin's private vault and never written to app settings or uploaded. The plugin requests `net.anyHost` so your own webhooks and self-hosted ACME endpoints work, while cloud metadata addresses stay blocked. **Enter access keys, API tokens and private keys in the panel forms, not in the chat.**\n\nThere is no app setting to fill in: cloud accounts, notification channels, the vault mode and expiry thresholds are all managed on the \"Settings\" page of the \"Operations\" panel, and credentials show as masked values once they are in the vault.\n\nFirst verification:\n\n1. Run \"Add cloud account\", pick the provider and enter the access key or API token; the account should show as usable;\n2. In \"DNS\", select that account and check that zones and records are listed;\n3. Change one test record: inspect the diff in the dry run, confirm, execute, then refresh to see it applied;\n4. Run \"Check monitors now\" and look at the result and status in \"Monitors\".\n\nCommon install failures:\n\n- **Account validation or signature errors**: the access key lacks DNS or domain permissions (most providers need read and write on the DNS product), the regional endpoint is wrong (Huawei Cloud and Volcengine need the right region), or the token expired.\n- **Certificate requests stall at DNS-01**: the domain must be hosted in a configured zone and `challengeZone` must be the right one; HTTP-01 and TLS-ALPN-01 are out of scope in this version.\n- **Deployment fails**: the server must be registered under \"Servers\" first; an unreachable `~/.ssh/config` host, a changed host fingerprint or an unwritable target directory stops the deployment — run a dry run in \"Deployments\" first.\n- **The vault will not open**: with a passphrase lock enabled, a forgotten passphrase cannot be recovered; the vault must be cleared and the credentials entered again.\n", "usage": "Three common things to ask for:\n\n1. **Check DNS**: \"What does example.com resolve to right now, and is any record still pointing at the old IP?\" The assistant reads with `dns_records` and changes nothing.\n2. **Change one record**: \"Point api.example.com's A record at 10.0.0.8, show me the diff first.\" `dns_record_upsert` returns the diff under a dry run, and only submits with the `expected` value after you confirm; the host also shows an approval card.\n3. **Issue and deploy a certificate**: \"Get a certificate for example.com and *.example.com and deploy it to nginx on web-01.\" `certificate_request` starts a DNS-01 job and returns a jobId, `deploy_certificate` dry-runs before deploying, and `ops_jobs` shows progress or cancels (cancel needs a second confirmation).\n\nEntry points: the \"Operations\" panel in the sidebar (overview, DNS, certificates, deployments, servers, monitors, notifications, settings); the commands \"Open console\", \"Add cloud account\", \"Request certificate\", \"Deploy certificate\", \"Check monitors now\".\n\n| Capability | What it does |\n| --- | --- |\n| `dns_accounts` / `dns_zones` / `dns_records` | List accounts and zones; query records with paging and keywords, never returning credentials |\n| `dns_record_upsert` / `dns_record_delete` | Create, update, delete a record; high risk, needs a `dryRun` first and an `expected` value for concurrency checks |\n| `certificates` | List the certificate inventory with expiry status, never returning private keys |\n| `certificate_request` | Start an ACME DNS-01 issuance job and return a jobId |\n| `deploy_certificate` | Start a deployment job for an existing deployment and certificate, returning a jobId |\n| `servers` / `server_probe` | List SSH servers and connectivity; run read-only checks (service, certificate, clock, disk, sshd) |\n| `ops_jobs` | List jobs, inspect one, cancel a job (cancel needs a second confirmation) |\n| `monitors` / `notifications` | List monitors with their latest status; list recent plugin notifications |\n\nDo not expect it to:\n\n- Confirm changes for you: write tools are dry runs by default and nothing changes before `dryRun: false`; in auto permission mode the approval card is skipped, matching every other tool.\n- Be a general SSH terminal: it only runs preset deployments and read-only checks on registered servers, with no arbitrary command execution and no multi-server batches.\n- Succeed on the first try: provider throttling (429 / 5xx) fails the job and needs your retry or the next scheduled run; key rotation, WHOIS, PFX / JKS and STARTTLS are out of scope.\n" } }, "versions": [ { "version": "1.2.1", "publishedAt": "2026-11-01T00:00:00Z", "changelog": "- Rebuild the panel around guidance instead of discovery. Every page now opens\n with a one-line page lead and a next-step row that derives the single most\n useful action from the current state (repair first, onboarding second), and\n stays hidden when the target is the page already open.\n- Replace the flat setup checklist with an ordered runway: account, certificate,\n server, deployment, notification channel, each marked done / do this next /\n later / blocked by a named earlier stage. The duplicate quick-action block is\n gone; the sidebar already owns navigation.\n- Rework Settings into intent groups with a configuration summary strip and one\n row per control: name, plain-language consequence, control, save state.\n Renewal/auto-deploy dependency and expiry thresholds are explained in place;\n an inverted threshold order reports inline, disables save, and the numbers are\n restated as \"N days left means which level\".\n- Ask for the vault passphrase in a confirmed drawer instead of failing with a\n \"required\" toast, and confirm before dropping back to the device key.\n- Name missing prerequisites and link to them instead of leaving disabled\n buttons: deployments lists the certificate and server it still needs, and the\n certificate wizard explains that a DNS account comes first.", "minPiDesktop": ">=0.25.0", "shasum": "6efd870011e0c0b617c1cbf9a4793386f721702435fcb990f4e62e7a911cb461", "url": "packages/voki.dns-ssh-management-1.2.1.piplug", "sizeBytes": 683131, "permissions": [ "ui.panel", "ui.view", "notify", "clipboard.read", "clipboard.write", "shell.openExternal", "net.fetch", "net.anyHost", "agent.tool.register", "background.service", "fs.read" ], "fs": { "read": { "root": "userSelected" } } } ], "distribution": "marketplace" }, { "id": "voki.esm-management", "name": "ESM Management", "description": "Connect Voki办公 to multiple ESM admin systems, bind one system per task, and query or change its resources through agent tools.", "author": "voki-work", "i18n": { "en": { "name": "ESM Management", "description": "Connect Voki办公 to multiple ESM admin systems, bind one system per task, and query or change its resources through agent tools.", "safetyNotes": "Each task is bound to one ESM system. Switching systems requires an explicit confirmed tool call. Write tools need confirm:true and are audited. Before each tool step, the plugin can open the resource list or record detail page in the built-in browser and seed that site's login token; after a successful write it refreshes the page. Single-record writes are serialized per task; batch updates use the list page and run in parallel. Tool results include only the page URL and open/refresh status, never the token, account name, or password. Systems with a different login mechanism may still ask you to log in. Account names and passwords are encrypted in this plugin's data directory; the encryption key sits beside the ciphertext and does not protect against a local root user." }, "zh-CN": { "name": "ESM 系统管理", "description": "把 Voki办公连接到多套 ESM 管理系统；每个任务绑定一套系统，并通过 Agent 工具查询或修改其资源。", "safetyNotes": "每个任务只绑定一套 ESM 系统，切换系统需要显式确认。写操作必须传 confirm:true 并记录审计。每个工具步骤开始前，插件可在内置浏览器中打开资源列表页或记录详情页，并写入该站点的登录 token；写入成功后刷新页面。单记录写操作按任务串行执行；批量更新使用列表页并行执行。工具结果只包含页面 URL 与打开/刷新状态，不包含 token、账号或密码。使用其他登录机制的系统仍可能需要单独登录。账号与密码加密保存在本插件数据目录；密钥与密文同目录，不能防本机 root。" }, "ja": { "name": "ESM システム管理", "description": "Voki Work を複数の ESM 管理システムに接続し、タスクごとに 1 つのシステムをバインドして、Agent ツールから照会・変更します。", "safetyNotes": "各タスクは 1 つの ESM システムにのみバインドされます。切り替えには明示的な確認が必要です。書き込みツールは confirm:true を要求し、監査に記録されます。各ツールステップの前に、リソース一覧またはレコード詳細ページを内蔵ブラウザーで開き、そのサイトのログイントークンを設定します。書き込み成功後はページを再読み込みします。単一レコードの書き込みはタスクごとに直列化され、バッチ更新は一覧ページを使って並列実行されます。ツール結果にはページ URL と開閉/更新状態のみが含まれ、トークン、アカウント名、パスワードは含まれません。別のログイン方式のシステムではログインを求められることがあります。アカウントとパスワードはこのプラグインのデータディレクトリに暗号化して保存されますが、鍵は暗号文の隣にあり、ローカルの root ユーザーからは保護されません。" } }, "categories": [ "office" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.esm-management", "docs": { "zh-CN": { "intro": "ESM 系统管理把多套 ESM（Laravel + amis 后台）系统接到对话里：每个任务只绑定一套系统，助手通过工具查资源列表、看单条详情、写记录。要动另一套系统，必须先在对话里明确确认，再切换绑定。\n\n只用一套系统时，它像一个有记性的后台客户端：登录用你在面板里填的账号，登录 token 加密缓存，过期自动刷新一次，遇到验证码或账号锁定会直接报错而不是反复重试。写操作一律要带 `confirm:true`，并写入按天轮转的审计日志。\n\n每个工具步骤开始前，插件可以在内置浏览器里打开对应的资源列表页或记录详情页，并把该站点的登录 token 写进去；写入成功后刷新页面，让你在页面上核对结果。单条记录的写操作按任务串行执行，批量更新走列表页并在任务写锁内并行执行。\n\n你能用它做什么：\n\n- 在对话里点名一套系统，让助手列出资源、翻页、打开单条记录。\n- 新建、修改、删除单条记录：先看详情页上的当前值，确认后再写。\n- 一次改 2–50 条记录，拿回逐条结果和成功/失败汇总。\n- 用内置浏览器核对结果：工具结果只回页面 URL 与打开/刷新状态，不回 token、账号或密码。\n", "install": "本插件不随安装包提供，安装后才可用。卸载之后可以在这里重新安装，配置与数据需要重新设置。\n需要准备的东西只有三样：一套 ESM 后台的 Base URL、它对应的接口模板（内置 `EMS v1.0.C`、`EMS v1.0.N`、`EMS v1.0.0` 三份），以及一个有相应权限的后台账号与密码。不需要 Node、npm 或额外的服务。账号与密码用 AES-256-GCM 加密保存在插件的本地数据目录（`credentials.enc`，密钥 `key.bin` 权限 0600），宿主只看得到绑定状态和掩码后的账号；密钥与密文同目录，属于静态混淆与防篡改，不能防本机 root。**不要把后台密码贴进对话**——它只填在面板的表单里。\n\n| 设置项 | 用途 | 默认值 |\n| --- | --- | --- |\n| `browserPreview` | 每个步骤开始前在内置浏览器打开目标列表页或详情页，写入成功后刷新，并把页面状态放进工具结果 | `true` |\n| `autoTestOnSave` | 创建或编辑系统后自动登录并做一次列表查询 | `true` |\n| `requestTimeoutMs` | ESM 后端请求的单次超时 | `20000` |\n| `maxResponseBytes` | 超过这个大小的响应会被截断 | `32768` |\n| `auditRetentionDays` | 启动时删除早于该天数的审计日志 | `30` |\n\n首次验证：\n\n1. 打开命令「ESM 系统管理」，添加一套系统：名称、Base URL、接口模板、账号、密码，保存。`autoTestOnSave` 开着时，保存后会登录并跑一次列表查询。\n2. 回到对话说「用 ESM 查一下商品列表」——助手先列出系统，再绑定当前任务，然后返回分页结果。\n3. 说「打开第 3 条记录的详情」——内置浏览器打开详情页，工具结果里带页面 URL 和打开状态。\n\n常见安装失败：\n\n- **保存后测试报登录失败**：Base URL 少了路径前缀，或该账号在后台没有目标资源的权限；接口版本漂移时用这套系统的高级覆盖项改端点。\n- **返回 `ESM_AUTH_CHALLENGE`**：这套系统启用了验证码或二次验证，插件不代填；请先在浏览器里手动登录，或换一个不需要二次验证的账号。\n- **列表能查、详情页打不开**：`browserPreview` 开着，但目标站点用别的登录机制；看工具结果里的 `openCode`，然后在内置浏览器里手动登录一次。\n", "usage": "三个常见用法：\n\n1. **核对一条记录再改**：「在 ESM 里把订单 20260812001 的收货地址改成新地址，先给我看现在的内容」。助手会先调 `esm_get` 打开详情页并列出当前值，你同意后才带 `confirm:true` 写入，写完刷新详情页。\n2. **批量改状态**：「把状态为待处理的这 12 条工单一起标记为已处理」。助手先用 `esm_list` 展示目标集合，确认后调 `esm_batch_update`，列表页预打开，完成后给你逐条结果。\n3. **换一套系统查**：「这套系统里没有，去另一套 ESM 里找同一个单号」。助手会先请你确认切换，确认后带 `confirmSwitch: true` 重新绑定当前任务。\n\n入口是命令「ESM 系统管理」，打开管理面板（系统增删改查、连接测试、清除登录、审计查看）。对话里的能力来自 13 个 Agent 工具：\n\n| 能力 | 做什么 |\n| --- | --- |\n| `esm_list_environments` | 列出系统、模板、数据空间、凭据/登录状态与当前绑定 |\n| `esm_select_environment` | 绑定当前任务；跨系统切换需 `confirmSwitch` |\n| `esm_environment_status` | 当前绑定、鉴权、写开关与最近一次测试结果 |\n| `esm_list_resources` | 当前模板的资源，以及每个资源支持的操作 |\n| `esm_describe_resource` | 单个资源的路径、id/title 字段与操作 |\n| `esm_list` | 分页列表 |\n| `esm_get` | 单条详情 |\n| `esm_create` | 新建记录（需 `confirm`） |\n| `esm_update` | 修改单条记录（需 `confirm`） |\n| `esm_batch_update` | 批量修改 2–50 条记录（需 `confirm`） |\n| `esm_delete` | 删除单条记录（高风险，需 `confirm`） |\n| `esm_request` | 未映射端点的受控请求，非 GET 需 `confirm` |\n| `esm_logout` | 清除本地登录 token |\n\n不要指望它做什么：\n\n- 不会替你决定改哪条：写操作每次都要 `confirm:true`，删除属于高风险操作，确认在对话里完成，不由插件代你点同意。\n- 不会绕过登录检查：账号密码登录无法自动完成验证码或二次验证，这类环境会直接报错，也不会重试到被锁。\n- 不上传文件，也不导入模板文件：不支持 multipart 文件上传，v1 也不支持导入第三方模板。\n" }, "ja": { "intro": "ESM システム管理は、複数の ESM（Laravel + amis の管理画面）システムを会話につなぎます。各タスクは 1 つのシステムにのみバインドされ、アシスタントはツール経由でリソース一覧の照会、1 件の詳細表示、レコードの書き込みを行います。別のシステムを操作するには、会話内で明示的に確認してからバインドを切り替えます。\n\n1 つのシステムだけを使う場合、記憶のある管理画面クライアントのように動きます。ログインはパネルで入力したアカウントを使い、トークンは暗号化してキャッシュし、期限切れ時は 1 度だけ再取得します。画像認証やアカウントロックに当たった場合は、繰り返し試さずエラーとして報告します。書き込みには必ず `confirm:true` が必要で、日次でローテーションする監査ログに記録されます。\n\n各ツールステップの前に、プラグインは内蔵ブラウザーで対象の一覧ページまたはレコード詳細ページを開き、そのサイトのログイントークンを設定できます。書き込みに成功するとページを再読み込みするので、画面上で結果を確認できます。単一レコードの書き込みはタスクごとに直列化され、バッチ更新は一覧ページを使ってタスクの書き込みロック内で並列実行されます。\n\nできること:\n\n- 会話でシステムを指定し、リソースの一覧・ページ送り・1 件の詳細表示を行います。\n- 1 件のレコードを作成・更新・削除します。詳細ページで現在値を確認してから書き込みます。\n- 2〜50 件をまとめて更新し、レコードごとの結果と成功/失敗の集計を受け取ります。\n- 内蔵ブラウザーで確認できます。ツール結果に含まれるのはページ URL と開閉/更新状態だけで、トークン、アカウント、パスワードは含まれません。\n", "install": "このプラグインはインストーラーに含まれません。使う前にここからインストールしてください。削除後に再度インストールできますが、設定とデータは初期状態になります。\n必要なのは 3 つだけです。ESM 管理画面の Base URL、対応するエンドポイントテンプレート（`EMS v1.0.C`、`EMS v1.0.N`、`EMS v1.0.0` を同梱）、そして必要な権限を持つアカウントとパスワードです。Node、npm、追加サービスは不要です。アカウントとパスワードは AES-256-GCM でプラグインのローカルデータディレクトリに暗号化して保存され（`credentials.enc`、鍵ファイル `key.bin` はパーミッション 0600）、ホストが見られるのはバインド状態とマスクされたアカウントだけです。鍵は暗号文の隣にあり、静的難読化と改ざん検知のためのもので、ローカルの root ユーザーからは保護されません。**管理画面のパスワードをチャットに貼らないでください**。入力する場所はパネルのフォームです。\n\n| 設定項目 | 用途 | 既定値 |\n| --- | --- | --- |\n| `browserPreview` | 各ステップの前に内蔵ブラウザーで対象の一覧または詳細ページを開き、書き込み成功後に再読み込みし、ページ状態をツール結果に含めます | `true` |\n| `autoTestOnSave` | システムの作成・編集後にログインし、一覧取得を 1 回実行します | `true` |\n| `requestTimeoutMs` | ESM バックエンド呼び出し 1 回のタイムアウト | `20000` |\n| `maxResponseBytes` | これを超えるレスポンスは切り詰められます | `32768` |\n| `auditRetentionDays` | 起動時に、この日数より古い監査ログを削除します | `30` |\n\n最初の確認:\n\n1. コマンド「ESM システム設定」を実行し、システムを追加します（名前、Base URL、エンドポイントテンプレート、アカウント、パスワード）。`autoTestOnSave` が有効なら、保存直後にログインと一覧取得が走ります。\n2. 会話に戻って「ESM で商品一覧を出して」と伝えます。アシスタントはシステムを一覧し、このタスクをバインドして、ページ送り付きの結果を返します。\n3. 「3 件目のレコードの詳細を開いて」と伝えると、内蔵ブラウザーで詳細ページが開き、ツール結果にページ URL と開閉状態が入ります。\n\nよくある導入の失敗:\n\n- **保存後のテストでログイン失敗になる**: Base URL にパスの接頭辞が足りないか、そのアカウントに対象リソースの権限がありません。バックエンドのバージョンがずれている場合は、そのシステムの詳細上書き設定でエンドポイントを変更します。\n- **`ESM_AUTH_CHALLENGE` が返る**: 画像認証や二段階認証が有効なシステムです。プラグインは代行しません。ブラウザーで手動ログインするか、二段階認証の不要なアカウントを使ってください。\n- **一覧は取れるが詳細ページが開かない**: `browserPreview` は有効でも、対象サイトが別のログイン方式を使っています。結果の `openCode` を確認し、内蔵ブラウザーで一度手動ログインしてください。\n", "usage": "よくある 3 つの依頼:\n\n1. **確認してから 1 件を変更する**: 「ESM で注文 20260812001 の配送先を新しい住所に変えて。まず現在の内容を見せて」。アシスタントは `esm_get` で詳細ページを開き現在値を示し、同意後に `confirm:true` で書き込み、最後に詳細ページを再読み込みします。\n2. **状態をまとめて変更する**: 「保留中のこの 12 件のチケットを対応済みにして」。アシスタントは `esm_list` で対象を示し、確認後に `esm_batch_update` を呼び、一覧ページを先に開いて、レコードごとの結果を返します。\n3. **別のシステムを調べる**: 「このシステムには無いので、もう 1 つの ESM で同じ注文番号を探して」。アシスタントは切り替えの確認を取り、`confirmSwitch: true` でこのタスクを再バインドします。\n\n入口はコマンド「ESM システム設定」で、管理パネル（システムの追加・編集・接続テスト・ログイン情報の削除・監査ログの閲覧）が開きます。会話内の機能は 13 個の Agent ツールが担います:\n\n| 機能 | 内容 |\n| --- | --- |\n| `esm_list_environments` | システム、テンプレート、データスペース、認証情報/ログイン状態、現在のバインドを一覧します |\n| `esm_select_environment` | このタスクをバインドします。システムの切り替えには `confirmSwitch` が必要です |\n| `esm_environment_status` | 現在のバインド、認証、書き込みスイッチ、直近のテスト結果 |\n| `esm_list_resources` | 現在のテンプレートのリソースと、各リソースが対応する操作 |\n| `esm_describe_resource` | 1 つのリソースのパス、id/title フィールド、操作 |\n| `esm_list` | ページ送り付きの一覧 |\n| `esm_get` | 1 件の詳細 |\n| `esm_create` | レコードの作成（`confirm` が必要） |\n| `esm_update` | 1 件の更新（`confirm` が必要） |\n| `esm_batch_update` | 2〜50 件の一括更新（`confirm` が必要） |\n| `esm_delete` | 1 件の削除（高リスク、`confirm` が必要） |\n| `esm_request` | 未対応エンドポイントへの制御されたリクエスト。GET 以外は `confirm` が必要 |\n| `esm_logout` | ローカルのログイントークンを削除します |\n\n期待しないでください:\n\n- どのレコードを変更するかの判断: 書き込みには毎回 `confirm:true` が必要で、削除は高リスク操作です。確認は会話内で行われ、プラグインが代わりに承認することはありません。\n- ログイン検査の回避: アカウントとパスワードのログインでは画像認証や二段階認証を完了できません。そのような環境ではエラーを返し、ロックされるまで再試行することもありません。\n- ファイルのアップロードやテンプレートの取り込み: multipart のアップロードには対応せず、v1 は第三者のテンプレートファイルも取り込みません。\n" }, "en": { "intro": "ESM Management connects several ESM admin systems (Laravel + amis backends) to the conversation: each task binds exactly one system, and the assistant queries resource lists, reads single records and writes through tools. Moving to another system needs an explicit confirmation in the conversation before the binding switches.\n\nWith one system it behaves like a backend client with a memory: it signs in with the account you entered in the panel, caches the login token encrypted, refreshes it once after expiry, and reports a captcha or a locked account as an error instead of retrying. Every write needs `confirm:true` and lands in a daily-rotated audit log.\n\nBefore each tool step the plugin can open the matching list page or record detail page in the built-in browser and seed that site's login token; after a successful write it refreshes the page so you can check the result there. Single-record writes are serialized per task; batch updates use the list page and run inside the task's write lock.\n\nWhat you can do with it:\n\n- Name a system in the conversation and have the assistant list resources, page through them and open a single record.\n- Create, update or delete one record: read the current values on the detail page, confirm, then write.\n- Change 2–50 records in one batch and get per-record results plus a success/failure summary.\n- Verify in the built-in browser: tool results carry only the page URL and open/refresh status, never the token, account or password.\n", "install": "This plugin is not part of the installer: install it here before using it. After removing it you can reinstall it here, but its settings and data start over.\nYou need three things: the Base URL of an ESM backend, its matching endpoint template (built in: `EMS v1.0.C`, `EMS v1.0.N`, `EMS v1.0.0`), and an account with the right permissions plus its password. No Node, npm or extra service is involved. The account and password are encrypted with AES-256-GCM in the plugin's local data directory (`credentials.enc`, key file `key.bin` with mode 0600); the host only ever sees the binding state and a masked account. The key sits beside the ciphertext — that is at-rest obfuscation with tamper detection, not protection from a local root user. **Do not paste the backend password into the chat** — it belongs in the panel's form.\n\n| Setting | Purpose | Default |\n| --- | --- | --- |\n| `browserPreview` | Open the target list or detail page in the built-in browser before each step, refresh it after a successful write, and include the page status in the tool result | `true` |\n| `autoTestOnSave` | Sign in and run one list request after creating or editing a system | `true` |\n| `requestTimeoutMs` | Per-request timeout for ESM backend calls | `20000` |\n| `maxResponseBytes` | Responses above this size are truncated | `32768` |\n| `auditRetentionDays` | Audit log files older than this are removed at startup | `30` |\n\nFirst verification:\n\n1. Run the command \"ESM system settings\" and add a system: name, Base URL, endpoint template, account, password, save. With `autoTestOnSave` on, it signs in and runs one list request right away.\n2. Back in the chat, say \"list the products through ESM\" — the assistant lists the systems, binds this task, then returns the paged result.\n3. Say \"open the detail page of the third record\" — the built-in browser opens it and the tool result carries the page URL and open status.\n\nCommon install failures:\n\n- **The save-time test reports a login failure**: the Base URL is missing a path prefix, or the account lacks permission on the target resource; when the backend version drifted, change the endpoints with that system's advanced overrides.\n- **The tool returns `ESM_AUTH_CHALLENGE`**: this system enforces a captcha or second factor, and the plugin does not fill it in; sign in manually in the browser first, or use an account without a second factor.\n- **Lists work but the detail page will not open**: `browserPreview` is on, but the site uses another login mechanism; read `openCode` in the result and sign in once in the built-in browser.\n", "usage": "Three common things to ask for:\n\n1. **Check a record before changing it**: \"In ESM, change the delivery address of order 20260812001 to the new one — show me the current values first.\" The assistant calls `esm_get`, opens the detail page and lists the current values; only after you agree does it write with `confirm:true`, then refreshes the detail page.\n2. **Update a batch of statuses**: \"Mark these 12 pending tickets as handled.\" The assistant shows the target set with `esm_list`, calls `esm_batch_update` after you confirm, pre-opens the list page and returns per-record results.\n3. **Look in another system**: \"It is not in this one — find the same order number in the other ESM system.\" The assistant asks you to confirm the switch, then rebinds this task with `confirmSwitch: true`.\n\nThe entry point is the command \"ESM system settings\", which opens the management panel (create, edit, test, clear login, read the audit log). In the conversation the work is done by 13 agent tools:\n\n| Capability | What it does |\n| --- | --- |\n| `esm_list_environments` | Lists systems, templates, data spaces, credential/login state and the current binding |\n| `esm_select_environment` | Binds this task; switching systems needs `confirmSwitch` |\n| `esm_environment_status` | Current binding, authentication, write switch and the last test result |\n| `esm_list_resources` | Resources of the current template and the operations each supports |\n| `esm_describe_resource` | Path, id/title fields and operations of one resource |\n| `esm_list` | Paged list |\n| `esm_get` | One record in full |\n| `esm_create` | Create a record (needs `confirm`) |\n| `esm_update` | Update one record (needs `confirm`) |\n| `esm_batch_update` | Update 2–50 records (needs `confirm`) |\n| `esm_delete` | Delete one record (high risk, needs `confirm`) |\n| `esm_request` | A controlled request to an unmapped endpoint; non-GET needs `confirm` |\n| `esm_logout` | Clears the local login token |\n\nDo not expect it to:\n\n- Decide which record to change: every write needs `confirm:true`, deletion is high risk, and that confirmation happens in the conversation — the plugin never approves on your behalf.\n- Get past a login check: an account-and-password login cannot complete a captcha or a second factor, and such a system returns an error instead of retrying until it is locked.\n- Upload or import files: multipart uploads are not supported, and v1 does not import third-party template files.\n" } }, "versions": [ { "version": "0.3.1", "publishedAt": "2026-11-01T00:00:00Z", "changelog": "- Keep one run-policy skill and shorten its catalog name and description, so\n the always-loaded skill entry no longer reads like a second ESM system skill.\n- Drop parameter-level instructions that duplicate the tool schemas and keep\n only the cross-tool workflow and page-verification policy.\n- Guard the single-skill layout with a test: the skills directory, catalog\n description and on-demand body size stay within budget.", "minPiDesktop": ">=0.21.0", "shasum": "cee6147ae14f2d241facb9b71b76395e279b91127cac123f1030dc1a40d42e7a", "url": "packages/voki.esm-management-0.3.1.piplug", "sizeBytes": 306098, "permissions": [ "agent.prompt.inject", "agent.tool.register", "net.fetch", "net.anyHost", "browser.cdp", "ui.panel" ], "fs": {} } ], "distribution": "marketplace" }, { "id": "voki.file-manager", "name": "File Manager", "description": "Browse, view, and edit files in the open project from the right work panel: a full directory tree with per-file-type icons; a left file list that collapses as a whole and closes automatically when the host opens a file; syntax-highlighted editing and saving (Markdown is edited in Vditor's instant-rendering mode, with the editor's assets bundled so editing stays offline); Markdown, PDF, image, audio, video, CSV, and JSON previews; read-only SQLite browsing with a SQL query box; create, rename, move, and delete from the context menu; filename search; switching between folders in a multi-folder project (the folder name in the header opens the switcher and the choice is remembered per project); and host-driven open requests for a single file, including session scratch and attachment paths outside the project. The context menu also offers Copy relative path, Copy absolute path, and an Open with… submenu that expands on hover and lists programs actually installed on this machine (the system default plus VS Code, Zed, Chrome, Edge, Zen, and the like), filtered by file type so a browser appears only for the web files it can render. The editor probe runs once at startup and is cached per day on disk, shared across windows; it locates apps through the App Paths / StartMenuInternet registry keys, PATH, and a few fixed install locations, and never walks directories. Git integration marks modified and new files (folders carry a subtree rollup), shows changed line counts (+N/−N), and shows a file's line-by-line changes against the last commit (untracked files read as all-new; staged and unstaged edits are labelled separately); outside a repository the marks disappear. File watching reloads the list when files change outside this view (another editor, a git checkout, a build, a second window); both manual refresh buttons remain, and a toolbar switch turns auto-refresh off. For a file with changes, the toolbar is one mutually exclusive tab group — Edit / Preview / Changes — so Changes is reachable from either side and the two views never share the content area.", "author": "Voki", "i18n": { "en": { "name": "File Manager", "description": "Browse, view, and edit files in the open project from the right work panel: a full directory tree with per-file-type icons; a left file list that collapses as a whole and closes automatically when the host opens a file; syntax-highlighted editing and saving (Markdown is edited in Vditor's instant-rendering mode, with the editor's assets bundled so editing stays offline); Markdown, PDF, image, audio, video, CSV, and JSON previews; read-only SQLite browsing with a SQL query box; create, rename, move, and delete from the context menu; filename search; switching between folders in a multi-folder project (the folder name in the header opens the switcher and the choice is remembered per project); and host-driven open requests for a single file, including session scratch and attachment paths outside the project. The context menu also offers Copy relative path, Copy absolute path, and an Open with… submenu that expands on hover and lists programs actually installed on this machine (the system default plus VS Code, Zed, Chrome, Edge, Zen, and the like), filtered by file type so a browser appears only for the web files it can render. The editor probe runs once at startup and is cached per day on disk, shared across windows; it locates apps through the App Paths / StartMenuInternet registry keys, PATH, and a few fixed install locations, and never walks directories. Git integration marks modified and new files (folders carry a subtree rollup), shows changed line counts (+N/−N), and shows a file's line-by-line changes against the last commit (untracked files read as all-new; staged and unstaged edits are labelled separately); outside a repository the marks disappear. File watching reloads the list when files change outside this view (another editor, a git checkout, a build, a second window); both manual refresh buttons remain, and a toolbar switch turns auto-refresh off. For a file with changes, the toolbar is one mutually exclusive tab group — Edit / Preview / Changes — so Changes is reachable from either side and the two views never share the content area.", "safetyNotes": "Databases are opened strictly read-only (readOnly + PRAGMA query_only) and the query box only accepts single read-only statements, so a database can be browsed but never modified. fs.read is declared only for the two host-mediated actions \"open with default app\" and \"show in folder\" (same permission and scope as the bundled Files view); the plugin's own reading and writing goes through Node's fs inside the plugin's own process — the host permission gateway does not mediate these calls, and the manifest cannot declare a whole-tree write. Deletion goes through the same path: it is performed by the plugin's own Node fs, is bound by the same root containment checks and credential deny list, explicitly refuses to delete the project root itself, and is recorded in the write audit log. Root-relative paths are confined by the plugin itself to the selected registered folder root of the project: resolved paths must stay inside that root (symlink and junction escapes are refused), and credential paths (.env*, .ssh/, *.pem, .git/**) are refused. When a project is registered as several local folders, the containment base is still exactly one of those roots at a time — never their union — and an absolute path the host asks this view to open that lies under another root of the same project is accepted by first switching the base to the containing root and then resolving that path relative to it, with the same containment checks applied. One exception is deliberate and is NOT covered by that containment guarantee: when the host asks this view to open a file it picked itself outside the project (a session scratch or attachment path), the request is an absolute OS path and the plugin reads and writes it with raw Node fs, with no root containment; the credential deny list is still enforced for those paths (checked against the raw, the normalised and the realpath form), and they are still written atomically and audited. Saves are atomic (temp file + rename), and overwriting a file changed outside the editor asks first. Images and media are read up to this machine's size budget (8 MiB / 24 MiB floors, tiered by RAM and cores) and handed to the view as base64 data URIs; binaries such as zip or exe are never decoded, only reported as unsupported. No network access; the plugin data directory only holds settings and a write audit log.Git integration only runs git's read-only subcommands (status / diff / rev-parse) from the user's own working copy: no index writes, no network, nothing inside .git/**. Status runs with GIT_OPTIONAL_LOCKS=0 / GIT_TERMINAL_PROMPT=0 / GIT_LITERAL_PATHSPECS=1; every subcommand has a 5s timeout and an output cap, and if git is not on PATH the plugin probes the usual install locations once. When git still isn't available the only consequence is \"no status\" — listing, reading, writing, saving and deleting are untouched. Paths handed to git are root-relative and pass the root containment check and the credential deny list first; git is merely asked how those files are doing. Diffs come from git diff for tracked files; an untracked new file is read by the plugin and shown with every line added (256 KiB cap), and oversized or binary files say so instead of being silently truncated. Badges and counts come from one snapshot cached for 2s, and the plugin's own saves invalidate it immediately. File watching (0.8.0) uses Node's own fs.watch on the **currently selected folder root**, recursive and non-persistent (it never holds the plugin process awake when nothing changes). Changes are only read, never written, no network, nothing inside .git/** — events under .git/ and node_modules/ are dropped outright and credential paths are still never reported (watching is not a back door around the deny list). The plugin's own writes (temp file + rename) are noted first, so a same-path event within 1.5s does not count as an external change; without that, every Ctrl+S would re-load the user's own document. Events are debounced for 250ms into a bounded cursor history (400 entries) which the view collects every 1.2s (the host gives plugins no push channel to a view), and the round is skipped while the panel is hidden. **An open file with no unsaved changes is re-read automatically; with unsaved changes the view only warns and never overwrites** — silently discarding what someone just typed is the worst kind of automation. Switching the base switches the watcher, and unloading the plugin closes it. If the runtime cannot watch recursively, auto-refresh is simply off while manual refresh and everything else behave exactly as before. \"Open with…\" is performed by this plugin's own main process, which spawns the chosen editor using Node capabilities that process already had and no extra permission: the executable can only come from the list the plugin detected itself (the view passes an id, never a path), the target passes the same root containment check and credential deny list as every other channel, the spawn goes through no shell with a single absolute path as its argument (so there is no command-line injection surface), and the child is detached with stdio ignored so the editor outlives the panel without holding the plugin process open. Every launch is recorded in the write audit log. Detection only reads the registry and PATH, writes nothing outside the plugin data directory, and caches its result per day (editors.json); if the probe is unavailable the only consequence is one menu layer fewer." }, "zh-CN": { "name": "文件管理器", "description": "在右侧工作面板中浏览、查看并编辑当前项目的文件：完整目录树（图标随文件类型变化）、左右分栏（左侧文件列表可整块收起，宿主请求打开文件时自动收起）、代码高亮编辑与保存（Markdown 用 Vditor 即时渲染编辑，编辑器资源随包、不联网）、Markdown 预览、PDF 预览（连续滚动、双页与导航侧栏）、图片与音视频查看、CSV/JSON 结构化查看、SQLite 只读浏览与 SQL 查询、右键新建、重命名/移动、按文件名搜索、项目组里的多文件夹切换（宿主把一个项目注册成多个本地文件夹时，面板左上角的文件夹名就是切换器，按项目记住看的是哪个 folder），以及宿主驱动的打开请求——宿主可以让视图直接打开某个文件，包括项目之外的会话临时 / 附件路径。右键菜单支持复制相对路径、复制绝对路径、删除文件或文件夹（目录整体删除，删前先弹确认框），以及「通过…打开」子菜单——鼠标移上去即展开，列出这台机器上真实存在的程序（系统默认应用，以及 VS Code、Zed、Chrome、Edge、Zen 等装了哪几个就列哪几个；按文件类型过滤——编辑器什么都能打开，浏览器只出现在它真能渲染的网页类文件上），选中即用那个程序打开当前条目。编辑器探测在启动时做一次、按天缓存并落盘（多开共享同一次结果），靠注册表 App Paths / StartMenuInternet、PATH 与少数固定安装位置定位，不遍历目录。文件列表与 git 联动：标出被修改和新增的文件（目录上给整棵子树的汇总），显示改动行数（+N/−N），打开文件后可查看相对上次提交的逐行变更（未跟踪文件按全文新增展示，已暂存与未暂存分开标注）；没有 git 或不是仓库时这些标记消失。文件在编辑器之外被改动（外部编辑器、git checkout、构建产物、另一个窗口）时会自动重新读取并刷新列表，两个手动刷新按钮保留，工具栏开关可关闭自动刷新。打开有改动的文件时，工具栏是「编辑 / 预览 / 变更」一组互斥页签：从任何一侧都能进入「变更」，两种内容不会同时出现在内容区。", "safetyNotes": "数据库一律以只读方式打开（readOnly + PRAGMA query_only），SQL 框只接受单条只读语句，因此只能浏览、绝无修改；fs.read 仅用于「用默认应用打开」与「在文件夹中显示」这两个由宿主代为执行的动作（权限与范围同内置的 Files 视图），插件自身的读写仍走自己进程内的 Node fs——宿主的权限网关不介入这些调用，manifest 也无法申报「整树写入」。路径的访问范围由插件自身限定在项目**当前选中的那个已注册文件夹根**（folder root）内：解析后的路径必须仍在根内（拒绝符号链接与 junction 逃逸）、拒绝凭据类路径（.env*、.ssh/、*.pem、.git/**）。项目注册了多个文件夹时，包含基点仍然是**其中一个** root、绝不放大成整个组的并集；宿主请求打开的绝对路径若落在同项目的另一个 root 下，插件会先把基点切到包含它的那个 root，再按「相对该 root」解析，根内包含校验一条不减。另有一条刻意的例外，它不在上面这条包含保证之内：宿主可以要求本视图打开由宿主自己选定的项目外文件（会话临时目录 / 附件的绝对路径），插件对这些路径走原生 Node fs 读写、不做根内包含校验；凭据类路径黑名单在两种模式下都照旧全量生效（原始字符串、规范化后与 realpath 之后各查一遍），这类路径同样原子写并记审计。保存采用原子写（临时文件 + 重命名）、覆盖在编辑器外被改动过的文件前会先询问。图片与音视频按本机体积档位（下限 8 MiB / 24 MiB，按内存与核数上调）读取后以 base64 data URI 交给视图；zip、exe 这类二进制只报「不支持预览」，不做任何解码。无网络访问；插件数据目录只保存设置与写入审计日志。git 联动只调用项目里 git 的只读子命令（status / diff / rev-parse），不写索引、不联网、不碰 .git/**：状态以 GIT_OPTIONAL_LOCKS=0 / GIT_TERMINAL_PROMPT=0 / GIT_LITERAL_PATHSPECS=1 运行，每个子命令 5s 超时并有输出上限，PATH 上没有 git 时按常见安装位置兜底探测，仍不可用就只是「没有状态」——列目录、读写、保存、删除一条都不受影响。传给 git 的是根相对路径并先过根内包含校验与凭据黑名单，git 只被问「这些文件怎么样了」。差异内容对已跟踪文件用 git diff，未跟踪的新文件由插件自己读文件、逐行加前缀（上限 256 KiB），超限与二进制都明确说明而不是硬截。徽标与行数来自同一次快照并缓存 2s，本插件自己的保存会立刻作废该缓存。文件监听（0.8.0）用 Node 自带的 fs.watch 对**当前基点 root** 开一只递归监听，persistent: false（没有变化时不吊住插件进程），并且：只把变化当数据看，不写入、不联网、不碰 .git/**（.git/ 与 node_modules/ 的事件直接丢弃，凭据类路径照旧不上报，监听不是绕过黑名单的后门）；每个子进程没有额外权限，沿用插件进程本已有的 Node 能力；本插件自己的写盘（临时文件 + rename）先记一笔，1.5 秒内到达的同名事件不算「外部改动」，否则每按一次 Ctrl+S 都会把自己的文档重装一遍；变化去抖 250ms 后并入游标历史（上限 400 条），视图每 1.2 秒取一次增量（宿主没有给插件向视图推送的通道），面板不可见时跳过这一轮。**没有未保存改动时自动重新读取打开的文件；有未保存改动时只提示、不覆盖**——静默丢掉用户刚敲的字是最糟的一种「自动」。基点一换，监听跟着换；插件卸载时监听一并关闭。运行时不支持递归 fs.watch 时只是关掉自动刷新，手动刷新与其它功能一律不受影响。「通过…打开」由本插件主进程 spawn 目标编辑器，用的是插件进程本已有的 Node 能力、没有额外权限：可执行文件只能来自插件自己探测出来的那份列表（视图只递 id、递不了路径），被打开的条目先过同一套根内包含校验与凭据黑名单；spawn 不经 shell，参数只有一条绝对路径（没有命令行注入面）；子进程 detached + stdio ignore + unref，编辑器不随面板关闭而消失，也不会吊住插件进程；每次打开都记一条写入审计。编辑器探测只读注册表与 PATH、不写任何东西，结果按日期缓存在插件数据目录（editors.json）；探测不可用时只是少一层菜单，其余功能不受影响。" }, "ja": { "name": "ファイルマネージャー", "description": "右側のワークパネルで、開いているプロジェクトのファイルを閲覧・表示・編集できます。ファイル種類別アイコン付きのディレクトリツリー、まとめて折りたためる左側のファイル一覧（ホストがファイルを開くときは自動で折りたたみ）、シンタックスハイライト付きの編集と保存（Markdown は Vditor のインスタントレンダリングで編集、エディタの資産は同梱）、Markdown・PDF・画像・音声・動画・CSV・JSON のプレビュー、SQL クエリ付きの読み取り専用 SQLite ブラウズ、右クリックからの新規作成・名前変更・移動・削除、ファイル名検索、複数フォルダープロジェクト内のフォルダー切り替え（ヘッダーのフォルダー名で切り替え画面が開き、選択はプロジェクトごとに記憶）、ホスト主導のファイルオープン要求（プロジェクト外のセッション一時領域や添付ファイルのパスを含む）に対応します。右クリックメニューには、相対パスのコピー、絶対パスのコピー、削除（フォルダーは中身ごと削除し、確認ダイアログを表示）、およびホバーで展開する「アプリで開く…」サブメニューがあります。このサブメニューには、このコンピューターに実際にインストールされているプログラム（システム既定のアプリ、VS Code、Zed、Chrome、Edge、Zen など）だけが表示され、ファイル種類で絞り込まれます（ブラウザーは実際に表示できる Web ファイルのみ）。エディターの検出は起動時に一度だけ行い、日単位でディスクにキャッシュして複数ウィンドウで共有します。検出にはレジストリの App Paths / StartMenuInternet、PATH、少数の固定インストール先を使用し、ディレクトリを走査しません。Git と連携し、変更されたファイルと新規ファイルを一覧に表示（フォルダーはサブツリー全体の集計）、変更行数（+N/−N）を表示し、ファイルを開くと前回のコミットからの行単位の差分を確認できます（未追跡ファイルは全行追加として表示し、ステージ済みと未ステージを分けて表示）。Git がない、またはリポジトリ外ではこれらの表示は消えます。このビュー外での変更（別のエディター、git checkout、ビルド、別ウィンドウ）は自動で再読み込みして一覧を更新します。手動の更新ボタンは残り、ツールバーのスイッチで自動更新をオフにできます。変更のあるファイルでは、ツールバーが「編集 / プレビュー / 変更」の排他的なタブグループになり、どちらからでも「変更」を開け、2 つの表示が同時に内容エリアを占有することはありません。", "safetyNotes": "データベースは厳密に読み取り専用で開かれ（readOnly + PRAGMA query_only）、クエリボックスは単一の読み取り専用ステートメントのみ受け付けるため、データベースを閲覧できても変更はできません。fs.read はホストが仲介する 2 つのアクション「既定のアプリで開く」と「フォルダに表示」にのみ宣言されています（同梱の Files ビューと同じ権限とスコープ）。プラグイン自身の読み書きはプラグインプロセス内の Node の fs を通ります。ホストの権限ゲートウェイはこれらの呼び出しを仲介せず、マニフェストでツリー全体への書き込みを宣言することもできません。ルート相対パスはプラグイン自身によって、プロジェクトの選択済み登録フォルダルート内に制限されます。解決後のパスはそのルート内に留まる必要があり（シンボリックリンクやジャンクションによる脱出は拒否）、認証情報パス（.env*、.ssh/、*.pem、.git/**）も拒否されます。プロジェクトが複数のローカルフォルダとして登録されている場合でも、包含の基準は常にそのうち 1 つのルートであり、それらの和集合になることはありません。ホストがこのビューに、同じプロジェクトの別ルート配下にある絶対パスを開くよう要求した場合は、まず基準をその包含ルートに切り替え、そのルートからの相対パスとして解決し、同じ包含チェックを適用します。ただし意図的な例外が 1 つあり、上記の包含保証の対象外です。ホストが、プロジェクト外でホスト自身が選択したファイル（セッション一時領域や添付ファイルのパス）をこのビューに開かせた場合、要求は OS の絶対パスとなり、プラグインは生の Node fs で読み書きし、ルート包含は行いません。そのようなパスでも認証情報の拒否リストは適用され（生のパス、正規化パス、realpath の各形式で確認）、原子的に書き込み、監査されます。保存は原子的（一時ファイル + リネーム）で、エディター外で変更されたファイルを上書きする前には確認します。画像とメディアはこのマシンのサイズ上限（下限 8 MiB / 24 MiB、メモリとコア数で段階的に拡大）まで読み取り、base64 データ URI としてビューに渡します。zip や exe などのバイナリはデコードせず、非対応として報告するだけです。ネットワークアクセスはありません。プラグインのデータディレクトリには設定と書き込み監査ログのみが保存されます。" } }, "categories": [ "files" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.file-manager", "docs": { "zh-CN": { "intro": "文件管理器把当前项目的文件树放进右侧工作面板：左边是目录，右边是内容，代码直接在这里改、在这里存。它对着磁盘上真实的那份文件工作，不读缓存副本，所以在面板里看到的永远就是磁盘上的内容。\n\n你能用它做什么：\n\n- 在一个面板里浏览整个项目：目录树按文件类型换图标，按 `.gitignore` / `.ignore` 隐藏条目（一个规则文件都没有时全部显示）。\n- 直接编辑并保存：代码高亮、查找替换、多光标、代码折叠，`Ctrl/Cmd+S` 保存；没有改动时不写盘。\n- Markdown 用 Vditor 的即时渲染编辑（所见即所得，公式与 Mermaid 直接渲染），`Ctrl/Cmd+S` 保存；**保存会按 Lute 规范化整篇文档**，书写风格（setext 标题、列表与空行间距）会被统一，改动过的文件在 git 里可能出现纯格式差异。编辑器资源随插件包提供，编辑 Markdown 不联网。\n- 不打开别的程序就能看内容：Markdown 预览、PDF（连续滚动、双页、缩略图与书签）、图片、音视频、CSV/TSV 分页表格、JSON 折叠树、Office 文档只读预览（Word / PowerPoint / Excel 常见格式）、只读 SQLite 浏览与 SQL 查询框。\n- 跟 git 对上：文件行上标出新增、修改、删除、重命名、冲突，给出 `+N`/`−N` 行数，打开文件后可以逐行查看相对上次提交的变更。\n", "install": "本插件随应用提供并默认启用。如果你卸载了它，可以在这里重新安装，并把配置从头配一遍。\n没有需要填写的设置项，也不需要账号或网络：插件不发起任何请求，运行时不访问网络。\n\n它用两项权限：`ui.view` 放视图，`fs.read` 只用于「用默认应用打开」和「在文件夹中显示」这两个只能由宿主代为执行的动作（范围与内置文件视图相同：项目根、全部文件）。其余读写由插件自己的进程完成，写入会追加到插件数据目录的 `write-audit.jsonl`。\n\n入口只有一个：右侧工作面板头部的切换菜单 →「插件视图」分组 →「文件管理器」。这个插件不注册命令面板命令，也没有独立的窗口。\n\n首次验证：\n\n1. 打开一个本地项目，在右侧面板切到「文件管理器」，应看到目录树而不是空面板；\n2. 点开一个 `.ts` 或 `.md` 文件，改一个字并保存，确认没有弹出权限对话框；\n3. 打开一个 `.json` 或 `.csv`，确认能在树视图 / 表格视图与源码之间切换；\n4. 在任一文件上右键，确认菜单里有「复制相对路径」和「通过…打开」。\n\n常见安装失败：\n\n- **面板头部菜单里没有「文件管理器」**：插件没启用，或当前没有打开的项目；在「扩展」里启用后再打开项目。\n- **保存被拒绝或提示路径越界**：路径落在当前这个文件夹根之外（`..`、指向项目外的符号链接，或项目组里的另一个文件夹）。在面板左上角切到包含该文件的文件夹再试。\n- **某些文件打不开**：`.env*`、`.ssh/`、`*.pem`、`.git/**` 这类凭据路径读写全拒；超过体积上限的也不预览（文本 2 MiB、图片 8 MiB、音视频与 PDF 各 24 MiB、写入 8 MiB）。\n", "usage": "三个常见用法：\n\n1. 「把 `src/api/client.ts` 里的超时改成 30 秒」——助手改的是磁盘上的文件，面板里的那一行随即出现 `M` 徽标和改动行数，点「变更」可以逐行看它改了什么。\n2. 「这份配置的 JSON 有没有写错」——你在面板里保存后，助手读到的就是磁盘上那份；保存前会用 `mtime` 与体积做冲突检查，别处改过时不会静默覆盖，而是让你选覆盖 / 放弃 / 重新加载。\n3. 「这个项目的目录结构讲一遍」——你展开目录树对着看（`.gitignore` 规则生效、`.git` 不出现在树里），助手讲的是它自己读到的文件，两者指的是同一份磁盘状态。\n\n入口是一个停靠在右侧栏的视图：工具栏最左边的按钮可以整块收起左栏，中间的拖拽条调整分栏宽度；右下内容区在「编辑 / 预览 / 变更」之间切换，一次只显示一种。文件操作都在右键菜单里——新建文件、新建文件夹、重命名、移动、复制相对路径、复制绝对路径、通过…打开、删除、刷新；打开有 git 变化的文本文件后，工具栏还会出现「变更」页签。这个插件不提供助手工具，也没有命令，助手的读写走的是它自己的文件工具。\n\n不要指望它做什么：\n\n- 不是系统资源管理器：目录树只显示当前项目当前选中的那一个文件夹（项目注册多个文件夹时在左上角切换，不合并成一棵树），插件不会自己去翻项目之外的路径。\n- 数据库与 PDF 只读：SQL 框只接受单条只读语句，不写入、不 VACUUM，WAL 里尚未合并的内容看不到；扫描件可以看但不做 OCR。\n- 删除不可撤销：目录整体递归删除，删前弹确认框，路径同样限定在当前文件夹根内并拒绝根目录本身。\n" }, "ja": { "intro": "ファイルマネージャーは、開いているプロジェクトのファイルツリーを右側のワークパネルに置きます。左がディレクトリ、右が内容で、コードはその場で編集して保存できます。キャッシュではなくディスク上のファイルを直接扱うため、パネルに見えているものがディスク上の内容です。\n\nできること:\n\n- 1 つのパネルでプロジェクト全体を閲覧できます。ディレクトリツリーはファイル種類ごとにアイコンが変わり、`.gitignore` / `.ignore` に従って項目を隠します（どちらのファイルも無い場合はすべて表示）。\n- その場で編集と保存ができます。シンタックスハイライト、検索と置換、マルチカーソル、コード折りたたみ、`Ctrl/Cmd+S` で保存。変更が無ければディスクに書きません。\n- Markdown は Vditor のインスタントレンダリングで編集します（数式と Mermaid はその場で描画）。`Ctrl/Cmd+S` で保存しますが、**保存時に Lute が文書全体を正規化**するため、書き方（setext 見出し、リストや空行の間隔）は統一され、編集したファイルは git 上で書式だけの差分が出ることがあります。エディタの資産はプラグインに同梱されるので、Markdown の編集でネットワークは使いません。\n- 別のアプリを開かずに中身を確認できます。Markdown プレビュー、PDF（連続スクロール、見開き、サムネイルとしおり）、画像、音声・動画、ページ切り替え付き CSV/TSV テーブル、折りたたみ可能な JSON ツリー、Office 文書の読み取り専用プレビュー（Word / PowerPoint / Excel の一般的な形式）、読み取り専用の SQLite 閲覧と SQL 入力欄。\n- git と連動します。行ごとに追加・変更・削除・名前変更・競合が表示され、`+N`/`−N` の行数も出ます。開いたファイルは前回のコミットとの差分を 1 行ずつ確認できます。\n", "install": "このプラグインはアプリに同梱され、既定で有効です。削除した場合はここから再インストールし、あらためて設定してください。\n入力する設定項目はありません。アカウントもネットワークも不要で、実行時にリクエストを一切送りません。\n\n使う権限は 2 つです。ビューを置く `ui.view` と、ホストが代行する 2 つの操作（既定アプリで開く／フォルダー内で表示）のためだけの `fs.read` です（範囲は組み込みのファイルビューと同じ、プロジェクトルートの全ファイル）。それ以外の読み書きはプラグイン自身のプロセスで行われ、書き込みはプラグインのデータディレクトリの `write-audit.jsonl` に追記されます。\n\n入口は 1 つです。右側ワークパネル上部の切り替えメニュー →「プラグインビュー」グループ →「ファイルマネージャー」。コマンドパレットのコマンドは登録せず、独自のウィンドウも開きません。\n\n最初の確認:\n\n1. ローカルプロジェクトを開き、右パネルを「ファイルマネージャー」に切り替えると、空ではなくディレクトリツリーが表示されます。\n2. `.ts` か `.md` を開いて 1 文字変更し保存します。権限ダイアログは出ないはずです。\n3. `.json` か `.csv` を開き、ツリー／テーブル表示とソースを切り替えられることを確認します。\n4. 任意のファイルを右クリックし、メニューに「相対パスをコピー」と「アプリで開く…」があることを確認します。\n\nよくある導入のつまずき:\n\n- **パネル上部のメニューに「ファイルマネージャー」が無い**: プラグインが無効か、プロジェクトを開いていません。「拡張機能」で有効にしてからプロジェクトを開いてください。\n- **保存が拒否される、パスが範囲外と言われる**: パスが現在のフォルダールートの外にあります（`..`、プロジェクト外を指すシンボリックリンク、同じプロジェクトグループ内の別フォルダー）。左上の切り替えでそのファイルを含むフォルダーに移ってください。\n- **一部のファイルが開けない**: `.env*`、`.ssh/`、`*.pem`、`.git/**` は読み書きとも拒否されます。サイズ上限を超えたファイルもプレビューしません（テキスト 2 MiB、画像 8 MiB、音声・動画と PDF は各 24 MiB、書き込み 8 MiB）。\n", "usage": "よくある 3 つの頼み方:\n\n1. 「`src/api/client.ts` のタイムアウトを 30 秒に変えて」— エージェントはディスク上のファイルを編集し、パネルのその行にすぐ `M` バッジと行数が出ます。「変更」を開けば 1 行ずつの差分が見られます。\n2. 「この設定の JSON、書き間違いは無い？」— パネルで保存した時点で、エージェントが読むのはディスク上のその内容です。保存前には `mtime` とサイズで競合を確認するため、他所での変更を黙って上書きせず、上書き／破棄／再読み込みを選ばせます。\n3. 「このプロジェクトの構成を説明して」— ツリーを展開しながら読めます（gitignore のルールが効き、`.git` は表示されません）。エージェントが説明するのは自分で読んだファイルで、どちらも同じディスク状態を見ています。\n\n入口は右パネルに固定された 1 つのビューです。ツールバー左端のボタンでファイル一覧をまるごと折りたため、中央の仕切りはドラッグで幅を変えられ、その幅は記憶されます。内容領域は「編集 / プレビュー / 変更」を切り替え、同時に 1 つだけ表示します。ファイル操作は右クリックメニューにあります（新規ファイル、新規フォルダー、名前変更、移動、相対パスのコピー、絶対パスのコピー、アプリで開く…、削除、更新）。変更のあるテキストファイルを開くと、ツールバーに「変更」タブが加わります。このプラグインはエージェント向けツールもコマンドも提供しません。エージェントは自身のファイルツールを使います。\n\n期待しないでください:\n\n- OS のファイルマネージャーではありません。ツリーに出るのはプロジェクトで現在選択している 1 つのフォルダールートだけです（複数フォルダーを登録したプロジェクトでは左上で切り替え、1 つのツリーに統合はしません）。プラグインが自分からプロジェクト外をたどることはありません。\n- データベースと PDF は読み取り専用です。SQL 欄は単一の読み取り専用文だけを受け付け、書き込みも VACUUM もしません。WAL の未チェックポイント分は見えません。スキャンした PDF は表示できますが OCR はしません。\n- 削除は取り消せません。フォルダーは確認ダイアログの後に中身ごと削除され、パスの制限は同じフォルダールート内で、ルートディレクトリ自体は拒否されます。\n" }, "en": { "intro": "File Manager puts the open project's file tree into the right work panel: directories on the left, content on the right, and code edited and saved right there. It works against the file on disk, not a cached copy, so what the panel shows is what is on disk.\n\nWhat you can do with it:\n\n- Browse the whole project in one panel: a directory tree with per-file-type icons, hiding entries by `.gitignore` / `.ignore` (everything is shown when neither file exists).\n- Edit and save in place: syntax highlighting, find and replace, multiple cursors, code folding, `Ctrl/Cmd+S` to save — and nothing is written when nothing changed.\n- Markdown is edited in Vditor's instant-rendering mode (what you see is the document: math and Mermaid render inline), `Ctrl/Cmd+S` to save. **Saving normalizes the whole document through Lute**, so writing style (setext headings, list and blank-line spacing) is unified and an edited file may show pure-formatting churn in git. The editor's assets ship inside the plugin, so editing Markdown never touches the network.\n- Look at content without leaving the app: Markdown preview, PDF (continuous scroll, two-page layout, thumbnails and bookmarks), images, audio and video, paged CSV/TSV tables, a collapsible JSON tree, read-only Office previews (common Word / PowerPoint / Excel formats), and read-only SQLite browsing with a SQL box.\n- Keep it in step with git: rows are marked new, modified, deleted, renamed or conflicted, with `+N`/`−N` line counts, and an open file can be diffed line by line against the last commit.\n", "install": "This plugin ships with the app and is on by default. If you removed it, install it here to bring it back, then set it up again.\nThere are no settings to fill in, and no account or network is involved: the plugin makes no requests at runtime.\n\nIt uses two permissions: `ui.view` for the view, and `fs.read` only for **Open with default app** and **Reveal in folder**, the two actions the host must perform on its own (same scope as the built-in files view: project root, all files). Every other read and write runs in the plugin's own process, and each write is appended to `write-audit.jsonl` in the plugin's data directory.\n\nThere is one entry point: the switcher menu in the right work panel header → the \"Plugin views\" group → **File Manager**. The plugin registers no command-palette command and opens no window of its own.\n\nFirst check:\n\n1. Open a local project and switch the right panel to **File Manager**; a directory tree should appear, not an empty panel;\n2. Open a `.ts` or `.md` file, change one character and save — no permission dialog should appear;\n3. Open a `.json` or `.csv` file and confirm you can switch between the tree/table view and the source;\n4. Right-click any file and confirm the menu offers **Copy relative path** and **Open with…**.\n\nCommon setup failures:\n\n- **The panel header menu has no File Manager entry**: the plugin is disabled, or no project is open. Enable it under Extensions, then open a project.\n- **A save is refused as out of scope**: the path falls outside the currently selected folder root (`..`, a symlink pointing out of the project, or another folder in the same project group). Switch to the folder that contains the file with the switcher at the top left.\n- **Some files will not open**: `.env*`, `.ssh/`, `*.pem` and `.git/**` are refused for both reading and writing, and oversized files are not previewed (text 2 MiB, images 8 MiB, audio/video and PDF 24 MiB each, writes 8 MiB).\n", "usage": "Three common things to ask for:\n\n1. \"Change the timeout in `src/api/client.ts` to 30 seconds\" — the assistant edits the file on disk, the row in the panel immediately shows an `M` badge and line counts, and the **Changes** tab shows what it changed, line by line.\n2. \"Is this config JSON even valid?\" — once you save in the panel, the assistant reads exactly that file from disk; before saving, the panel compares `mtime` and size, so a change made elsewhere is never silently overwritten — you choose overwrite, discard or reload.\n3. \"Walk me through this project's structure\" — you expand the tree as you read (gitignore rules applied, `.git` not listed) while the assistant describes the files it read itself; both are looking at the same disk state.\n\nThe entry point is a view docked in the right panel. The leftmost toolbar button collapses the file list entirely, the divider between columns is draggable and its width is remembered, and the content area switches between **Edit / Preview / Changes** with only one of them visible at a time. File operations live in the context menu: new file, new folder, rename, move, copy relative path, copy absolute path, open with…, delete, refresh; opening a changed text file adds a **Changes** tab to the toolbar. This plugin exposes no agent tool and no command — the assistant uses its own file tools.\n\nDo not expect it to:\n\n- Be the system file manager: the tree shows the one folder root currently selected in the project (switch folders at the top left when a project registers several; they are never merged into one tree), and the plugin will not wander outside the project by itself.\n- Write to databases or PDFs: the SQL box accepts a single read-only statement, never writes and never vacuums, WAL content that has not been checkpointed is not visible, and scanned PDFs can be viewed but not OCR'd.\n- Undo a delete: a folder is removed recursively after a confirmation dialog, under the same folder-root restriction, and the root directory itself is refused.\n" } }, "versions": [ { "version": "1.0.0", "publishedAt": "2026-11-01T00:00:00Z", "changelog": "- **成为第一方插件 `voki.file-manager`。** id 从 `pi.file-manager` 换成\n `voki.file-manager`，版本从上游的 0.9.0 重新起算为 1.0.0；作者改为 Voki。\n 功能与 0.9.0 的随包版本一致——本地此前那批改动（应用改名、项目词、中文\n 界面补全、Office 预览、宿主的「通过…打开」目录、按机器算的打开上限、左侧\n 文件列表默认展开）全部重做到源码里，不再是构建产物的手工补丁。\n- **视图源码随仓库维护。** `apps/desktop/file-manager-view/` 是视图的 React +\n Vite 源码与九支离线校验（`pnpm verify`）；`views/` 是构建产物，由\n `pnpm --dir apps/desktop/file-manager-view build` 生成到插件目录。该目录是\n 独立安装的构建工具链（不上 pnpm workspace）：根 `overrides` 把 vite 5 抬到 6.x，\n 装上 workspace 会连带改掉这里的构建链。上游的\n `views-src/` 过去不随包 vendored，改一行界面要手改压缩过的 bundle，现在\n 改源码、跑校验、重新构建即可。\n- **左侧文件列表不会再留下空白页。** 没有打开文件时列表必定展开：宿主让视图\n 打开某个文件时照旧收起列表（把位置让给文件），但从文件退回、或回到一个仍\n 活着的面板时，列表会自己回来，不再出现「列表收起 + 内容为空」。\n- **Markdown 改用 Vditor 编辑（即时渲染）。** 宿主那边的 Markdown 编辑器就是 Vditor\n （ADR 0361），插件里却在用 CodeMirror，同一份文件两种排版感受。现在 `.md` 走 Vditor\n 的 IR 模式：工具栏只留常用几件，大纲/字数/本地缓存关掉，Lute 与 KaTeX、Mermaid、\n highlight.js 全部随包（`views/vditor`，10 MB），`cdn` 指向包内目录，编辑不产生任何\n 网络请求。其余文本文件仍是 CodeMirror。**保存会按 Lute 规范化整篇文档**（setext 变\n atx、列表与空行间距统一），这是换取同一套编辑体验的已知代价；保存通道、`mtime`\n 冲突检测、未保存提示与「外部改动只提示不覆盖」都沿用原规则。\n- **Office 预览的标题与主题跟随宿主。** 预览器的 `theme` 以前被塞进一个对象\n （`[object Object]`），现在读宿主当前明暗主题。", "minPiDesktop": ">=0.9.0", "shasum": "62f6511aff11a8af9ae1b386b27e478a90db281d94cd8f1bba7bc155495ee9fd", "url": "packages/voki.file-manager-1.0.0.piplug", "sizeBytes": 7227698, "permissions": [ "ui.view", "fs.read" ], "fs": { "read": { "root": "workspace", "scope": [ "**" ] } } } ], "distribution": "bundled" }, { "id": "voki.git-management", "name": "Git Management", "description": "A local Git workbench that opens only in the right work panel: branch and staging overview, per-file and per-hunk staging, discard, structured diffs with both line numbers, paged history, commit details, commit creation with amend, local branches, line-by-line blame, and stashes. Every operation runs the system git binary against the repository of the workspace you opened, with argument arrays and no shell; nothing leaves the machine, and fetch, pull, and push do not exist here.", "author": "voki-work", "i18n": { "en": { "name": "Git Management", "description": "A local Git workbench that opens only in the right work panel: branch and staging overview, per-file and per-hunk staging, discard, structured diffs with both line numbers, paged history, commit details, commit creation with amend, local branches, line-by-line blame, and stashes. Every operation runs the system git binary against the repository of the workspace you opened, with argument arrays and no shell; nothing leaves the machine, and fetch, pull, and push do not exist here.", "safetyNotes": "Runs the system git binary against the repository root resolved from the workspace you opened; the plugin refuses any path that is not repository-relative, and verifies the root really contains that workspace. Commands are executed with argument arrays and no shell, so a file name or branch name can never become a command. GIT_TERMINAL_PROMPT=0 makes an unexpected prompt fail immediately instead of freezing the panel. Destructive actions (discard, forced branch deletion, stash drop, deleting untracked files) are confirmed in the panel first and are only ever started by a person; no agent tool is registered. Nothing is fetched, pulled, pushed or cloned, no credentials are read, and nothing inside .git/ is read or written by the plugin itself. The plugin stores only its own panel preferences (auto refresh, history page size, diff context lines, confirmation behaviour, guide visibility) in the host's plugin settings; it keeps no repository data on disk. clipboard.write is used only for the copy buttons you press." }, "zh-CN": { "name": "Git 管理", "description": "只在右侧工作面板中打开的本地 Git 工作台：分支与暂存区概览、按文件与按 hunk 的暂存与取消暂存、丢弃改动、带双行号的结构化差异、可翻页的历史、提交详情、带 amend 的提交、本地分支、逐行追踪与 stash。所有操作都针对你打开的工作区所在的仓库执行系统 git，参数以数组传入、不经过 shell；不联网，fetch、pull、push 在这里不存在。", "safetyNotes": "只针对你打开的工作区解析出的仓库根执行系统 git，并校验该仓库根确实包含这个工作区；任何非仓库相对路径一律拒绝。命令以参数数组执行、不经过 shell，因此文件名与分支名不可能变成命令。GIT_TERMINAL_PROMPT=0 让意外的交互提示立即失败，而不是把面板挂住。危险动作（丢弃改动、强制删分支、删 stash、删除未跟踪文件）都先在面板里确认，且只由人发起；本插件不注册任何 Agent 工具。不 fetch、不 pull、不 push、不 clone，不读取凭据，插件自身不读写 .git/ 内部文件。插件只在宿主设置里保存自己的面板偏好（自动刷新、历史条数、差异上下文行数、确认行为、引导卡开关），不落盘、不缓存仓库数据；clipboard.write 只用于你按下复制按钮的那一刻。" }, "ja": { "name": "Git 管理", "description": "右側のワークパネルだけで開くローカル Git ワークベンチ：ブランチとステージング領域の概要、ファイル単位と hunk 単位のステージ／ステージ解除、変更の破棄、両方の行番号を持つ差分、ページ送りできる履歴、コミット詳細、amend 付きコミット、ローカルブランチ、行単位の blame、スタッシュ。すべて、開いているワークスペースのリポジトリに対してシステムの git を引数配列・シェルなしで実行します。ネットワークには出ず、fetch / pull / push は存在しません。", "safetyNotes": "開いているワークスペースから解決したリポジトリルートに対してのみシステムの git を実行し、そのルートがワークスペースを実際に含むことを検証します。リポジトリ相対でないパスはすべて拒否します。コマンドは引数配列で実行しシェルを経由しないため、ファイル名やブランチ名がコマンドになることはありません。GIT_TERMINAL_PROMPT=0 により、想定外の対話プロンプトはパネルを固まらせず即座に失敗します。危険な操作（変更の破棄、ブランチの強制削除、スタッシュの削除、未追跡ファイルの削除）はパネルで確認してから人間が実行します。Agent ツールは登録しません。fetch / pull / push / clone は行わず、認証情報も読みません。プラグイン自身は .git/ 内部を読み書きしません。ホストのプラグイン設定にパネル自身の好み（自動更新、履歴の件数、差分のコンテキスト行数、確認の有無、ガイドカードの表示）だけを保存し、リポジトリのデータはディスクに残しません。clipboard.write はコピーボタンを押したときだけ使われます。" } }, "categories": [ "development" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.git-management", "docs": { "zh-CN": { "intro": "Git 管理把仓库的日常操作搬进右侧工作面板：看分支与暂存区、按文件或按 hunk 暂存、看带双行号的差异、翻历史、建提交、管本地分支、按行追踪、保存与恢复 stash。它针对你当前打开的工作区所在的仓库执行系统 `git`，参数以数组传入、不经过 shell，**不联网**——fetch、pull、push 在这里不存在，所以它不会在你没看着的时候动远端。\n\n第一次打开时，概览页会有一张三步上手卡片（看现状 → 暂存 → 写说明并提交），暂存区还会把\n当前状态收敛成一条「下一步」建议；收起卡片不影响任何功能。\n\n你能用它做什么：\n\n- 在一个面板里看完「改了什么、哪些已暂存、有几条提交、上游领先几个」。\n- 把一个大改动拆成几次提交：hunk 级暂存，片段补丁由插件自己重算，视图只能指定「第几段」。\n- 复查历史：搜索提交信息、按作者过滤、点进提交看完整 patch 与文件清单。\n- 追一行代码的来历：逐行显示 sha、作者、时间，点一行跳进那次提交。\n- 临时放一放手上的改动：保存 stash（可包含未跟踪文件）、恢复、删除。\n", "install": "本插件不随安装包提供，安装后才可用。卸载之后可以在这里重新安装，配置与数据需要重新设置。\n装好即可用，没有必须填写的设置项——面板第七个页签「设置」里的每一项都是可选的，\n改一项就保存：自动刷新与间隔、历史默认条数、差异上下文行数（同时决定按 hunk 暂存的\n粒度）、丢弃前是否确认、是否显示引导卡。它需要两样东西：\n\n1. **本机有 `git`**：所有操作都调用系统 `git` 二进制，参数以数组传入、不经过 shell。\n2. **工作区是一个 git 仓库**：插件只对当前工作区解析出的仓库根执行命令，并校验该仓库根确实包含这个工作区。\n\n它申请的权限只有两个：`ui.view`（在右侧工作面板里画出视图）和 `clipboard.write`（复制 sha、路径等），没有任何网络或文件系统写权限。\n\n首次验证：\n\n1. 打开一个 git 仓库目录作为项目；\n2. 按 `Mod+J` 打开右侧工作面板，选「Git 管理」；\n3. 概览页应显示当前分支、上游、领先/落后与最近几条提交；\n4. 在「暂存区」页签改一个文件，确认它出现在「未暂存」分组里。\n\n常见安装失败：\n\n- **面板空白或提示不是仓库**：项目文件夹不在 git 仓库里，或仓库目录已被移动、删除；重新打开仓库目录即可。\n- **提示找不到 git**：`git` 不在 PATH 上（例如只装了图形化客户端）；把它加入 PATH 后重启应用。\n- **面板挂住不返回**：命令带 `GIT_TERMINAL_PROMPT=0` 运行，需要交互式输入（账号、密码、密钥口令）的操作会立即失败而不是等待——这类操作请在终端里做。\n", "usage": "三个常见用法：\n\n1. **拆提交**：「我这次改动混了三件事，帮我看看暂存区该分成哪几次提交」——你先在面板里按 hunk 勾选，再逐次写提交信息；助手可以帮你起草提交信息与分组顺序。\n2. **复查一次改动**：「打开 Git 管理，把这个分支相对上游的改动列出来，按风险排一下」——面板负责呈现，助手负责判断。\n3. **查一行代码的来龙去脉**：「这行是谁什么时候改的，改之前是什么样」——用逐行追踪定位到提交，再进提交详情看完整 patch。\n\n入口有三处：\n\n| 入口 | 说明 |\n| --- | --- |\n| 右侧工作面板 | `Mod+J` 打开面板后选「Git 管理」；这是唯一的呈现位置 |\n| 命令面板 | `Git Management: Open`（概览）、`Git Management: Open Changes`（暂存区）等五条命令 |\n| 视图内页签 | 概览 / 暂存区 / 历史 / 分支 / 逐行追踪 / 隐藏改动 |\n\n视图里能做的事：单文件暂存、取消暂存、丢弃（需要确认），全部暂存 / 全部取消暂存，提交（支持 `--amend`，可勾选先暂存已跟踪改动），新建 / 切换 / 删除本地分支（强制删除需确认），保存 / 恢复 / 删除 stash，按行范围追踪。\n\n不要指望它做什么：\n\n- **它不碰远端**：没有 fetch、pull、push、clone，也没有凭据管理；需要同步请用终端或你自己的 Git 客户端。\n- **它不替 AI 提供工具**：这是应用自身的面板，不是给助手调用的能力，助手看不到你的仓库内容。\n- **它不绕过危险确认**：丢弃改动、强制删分支、删 stash、删未跟踪文件都要你在面板里确认；这些是不可撤销的本地操作。\n" }, "ja": { "intro": "Git 管理はリポジトリの日常作業を右側のワークパネルに集めます。ブランチとステージング領域の概要、ファイル単位・hunk 単位のステージング、両方の行番号を伴う差分、ページ送りできる履歴、コミット、ローカルブランチ、行単位の追跡、stash の保存と復元。対象は開いているワークスペースのリポジトリで、システムの `git` に引数を配列で渡し、シェルは経由しません。**ネットワークには一切触れません** — fetch / pull / push は無いので、見ていない間にリモートを動かすことはありません。\n\n初めて開いたときは、概要ページに 3 ステップのカード（現状を見る → ステージ → 説明を書いて\nコミット）が出て、ステージング領域は現在の状態を「次の一手」の提案 1 つにまとめます。\nカードを閉じても機能は変わりません。\n\nできること:\n\n- 何が変わったか、どれがステージ済みか、コミットはいくつか、上流より何個進んでいるかを 1 つのパネルで確認できます。\n- 大きな変更を複数のコミットに分割できます。ステージングは hunk 単位で、断片のパッチはプラグイン側が再計算し、ビューは「何番目の断片か」しか指定できません。\n- 履歴を確認できます。コミットメッセージの検索、作者での絞り込み、コミットを開いて完全なパッチとファイル一覧の表示。\n- 1 行の来歴を追えます。行ごとに sha・作者・日時を表示し、行をクリックするとそのコミットへ移動します。\n- 作業中の変更を一時退避できます。stash の保存（未追跡ファイルも含められます）、復元、削除。\n", "install": "このプラグインはインストーラーに含まれません。使う前にここからインストールしてください。削除後に再度インストールできますが、設定とデータは初期状態になります。\nインストールすればそのまま使えます。必須の設定項目はありません。パネルの 7 番目のタブ\n「設定」にある項目はすべて任意で、変更すると即座に保存されます。自動更新とその間隔、\n履歴の既定件数、差分のコンテキスト行数（hunk 単位ステージの粒度も兼ねます）、破棄前の\n確認、ガイドカードの表示。必要なのは 2 つです。\n\n1. **このマシンに `git` があること**: すべての操作はシステムの `git` を引数配列で実行し、シェルを経由しません。\n2. **ワークスペースが git リポジトリであること**: 開いているワークスペースからリポジトリのルートを解決し、そのルートが実際にこのワークスペースを含むことを検証します。\n\n要求する権限は 2 つだけです: `ui.view`（右側のワークパネルにビューを描画）と `clipboard.write`（sha やパスのコピー）。ネットワーク権限もファイル書き込み権限もありません。\n\n最初の確認:\n\n1. git リポジトリのフォルダをプロジェクトとして開きます。\n2. `Mod+J` で右側のワークパネルを開き、「Git 管理」を選びます。\n3. 概要に現在のブランチ、上流、先行/遅延、直近のコミットが表示されるはずです。\n4. ファイルを 1 つ編集し、「ステージング」タブの「未ステージ」に現れることを確認します。\n\nよくあるつまずき:\n\n- **パネルが空、またはリポジトリではないと表示される**: プロジェクトのフォルダが git リポジトリの中にないか、リポジトリのディレクトリが移動・削除されています。リポジトリのフォルダを開き直してください。\n- **git が見つからない**: `git` が PATH にありません（GUI クライアントだけを入れている場合など）。PATH に追加してアプリを再起動してください。\n- **パネルが戻ってこない**: コマンドは `GIT_TERMINAL_PROMPT=0` で実行されるため、対話入力（アカウント、パスワード、鍵のパスフレーズ）が必要な操作は待たずに失敗します。そうした操作はターミナルで行ってください。\n", "usage": "よくある 3 つの使い方:\n\n1. **コミットを分ける**: 「今回の変更に 3 つの話が混ざっている。ステージング領域をどう分けるか見て」— hunk 単位の選択はパネルで行い、コミットメッセージと分割順はアシスタントが草案を作ります。\n2. **変更をレビューする**: 「Git 管理を開いて、このブランチが上流に対して何を変えたか、危ない順に並べて」— 表示はパネル、判断はアシスタント。\n3. **1 行の来歴を調べる**: 「この行は誰がいつ変えたのか、その前はどうだったか」— 行単位の追跡でコミットへ移動し、コミット詳細で完全なパッチを見ます。\n\n入り口は 3 つ:\n\n| 入り口 | 内容 |\n| --- | --- |\n| 右側のワークパネル | `Mod+J` で開き「Git 管理」を選択。表示されるのはここだけです |\n| コマンドパレット | `Git Management: Open`（概要）、`Git Management: Open Changes`（ステージング）など 5 つ |\n| ビュー内のタブ | 概要 / ステージング / 履歴 / ブランチ / 行単位の追跡 / stash |\n\nビューでできること: 単一ファイルのステージ・アンステージ・破棄（確認あり）、すべてステージ / すべてアンステージ、コミット（`--amend` と、追跡済みの変更を先にステージするオプション付き）、ローカルブランチの作成・切り替え・削除（強制削除は確認あり）、stash の保存・復元・削除、行範囲の追跡。\n\n期待しないでください:\n\n- **リモートには触れません**: fetch / pull / push / clone も、認証情報の管理もありません。同期はターミナルか普段お使いの Git クライアントで行ってください。\n- **アシスタントにツールを渡しません**: これはアプリ自身のパネルであり、AI が呼べる能力ではありません。アシスタントはこのパネル経由でリポジトリを見ることはできません。\n- **破壊的な確認を飛ばしません**: 変更の破棄、ブランチの強制削除、stash の削除、未追跡ファイルの削除は、いずれも取り消せないため必ず確認を求めます。\n" }, "en": { "intro": "Git Management brings everyday repository work into the right work panel: branches and the staging area, per-file and per-hunk staging, diffs with both line numbers, paged history, commits, local branches, line-by-line blame, and stashes. It runs the system `git` against the repository of the workspace you opened, passes arguments as arrays, never through a shell, and **never touches the network** — there is no fetch, pull or push here, so it cannot move a remote behind your back.\n\nThe first time you open it, the overview offers a three-step card (read the state,\nstage, describe and commit) and the staging area collapses the current state into one\n\"next step\" suggestion; dismissing the card changes nothing else.\n\nWhat you can do with it:\n\n- See in one panel what changed, what is staged, how many commits there are and how far ahead of the upstream you are.\n- Split one large change into several commits: staging is hunk-level, the fragment patch is recomputed by the plugin, and the view can only name which hunk.\n- Review history: search commit messages, filter by author, open a commit for its full patch and file list.\n- Trace a line: blame shows sha, author and time per line, and clicking a line jumps to that commit.\n- Park work in progress: save a stash (untracked files optional), restore it, delete it.\n", "install": "This plugin is not part of the installer: install it here before using it. After removing it you can reinstall it here, but its settings and data start over.\nNothing to configure — it works as soon as it is installed. Everything on the\npanel's seventh tab, Settings, is optional and saved as you change it: auto refresh\nand its interval, the history page size, the diff context lines (which also set the\ngranularity of per-hunk staging), whether discarding asks first, and whether the\nguide card shows. It needs two things:\n\n1. **`git` on this machine**: every operation runs the system `git` binary with argument arrays, never through a shell.\n2. **A workspace that is a git repository**: the plugin resolves the repository root from the workspace you opened and checks that the root really contains that workspace.\n\nIt asks for two permissions only: `ui.view` (draw the view in the right work panel) and `clipboard.write` (copy shas and paths). No network access, no filesystem writes.\n\nFirst check:\n\n1. Open a git repository folder as the project.\n2. Press `Mod+J` for the right work panel and pick \"Git Management\".\n3. The overview should show the current branch, upstream, ahead/behind and the latest commits.\n4. Edit a file and confirm it shows up under \"Unstaged\" on the Changes tab.\n\nCommon failures:\n\n- **Empty panel, or it says this is not a repository**: the project folder is not inside a git repository, or the repository directory was moved or deleted. Reopen the repository folder.\n- **It cannot find git**: `git` is not on PATH (for example only a GUI client is installed). Add it to PATH and restart the app.\n- **The panel hangs**: commands run with `GIT_TERMINAL_PROMPT=0`, so anything that needs an interactive answer (account, password, key passphrase) fails immediately instead of waiting. Do those in a terminal.\n", "usage": "Three common requests:\n\n1. **Split a commit**: \"my change mixes three things — help me decide how to split the staging area\" — you stage hunk by hunk in the panel, the assistant drafts the messages and the grouping.\n2. **Review a change**: \"open Git Management and list what this branch changes against its upstream, riskiest first\" — the panel shows, the assistant judges.\n3. **Trace a line**: \"who changed this line and when, and what did it look like before\" — blame takes you to the commit, the commit view shows the full patch.\n\nThree ways in:\n\n| Entry | What it does |\n| --- | --- |\n| Right work panel | `Mod+J`, then pick \"Git Management\"; this is the only place it renders |\n| Command palette | `Git Management: Open`, `Git Management: Open Changes` and three more |\n| Tabs in the view | Overview / Changes / History / Branches / Blame / Stashes |\n\nWhat the view can do: stage, unstage and discard a single file (confirm required), stage or unstage everything, commit (with `--amend` and an option to stage tracked changes first), create / switch / delete local branches (force delete asks first), save / restore / delete stashes, and blame a line range.\n\nWhat not to expect:\n\n- **It never touches a remote**: no fetch, pull, push or clone, and no credential handling. Sync with a terminal or your own Git client.\n- **It gives the assistant no tool**: this is the app's own panel, not an ability the AI can call — the assistant cannot see your repository through it.\n- **It never skips a destructive confirmation**: discarding changes, force-deleting a branch, deleting a stash or removing untracked files all ask you first, because none of them can be undone.\n" } }, "versions": [ { "version": "1.1.0", "publishedAt": "2026-11-01T00:00:00Z", "changelog": "引导式面板与设置页。功能一个没少，但第一次打开的人不必再猜。\n\n- **新增设置页**（第七个页签，风格对齐「域名与 SSH」插件的配置页）：五个分组\n ——刷新、列表与差异、安全、引导、关于。自动刷新开关与间隔、历史默认条数、\n 差异上下文行数（1–20，直接影响按 hunk 暂存的粒度）、丢弃前是否确认、是否显示\n 引导卡，改一项就保存，没有底部「保存」按钮。偏好存进宿主的插件设置\n （`prefs` 键），重装插件、换窗口、重启都在；宿主只读时界面明说「只在本次会话\n 生效」，不显示假的「已保存」。\n- **新增两条通道**：`git.prefs`（读，`{ ok, prefs }`）与 `git.prefs.set`\n （写，`{ patch }` → `{ ok, prefs, persisted }`）。\n- **引导式交互**：每个页签顶部一句「这一页是什么、该做什么」；概览页一张可关闭\n 且记住的三步上手卡片（看现状 → 暂存 → 写说明提交，并说明没有 push/pull/fetch）；\n 暂存区把状态收敛成一条「下一步」建议（冲突 → 没有暂存内容 → 没写说明 → 可以\n 提交），带一两个直达按钮。打字时只就地替换这条建议，不整页重绘。\n- **视觉重做**：整套样式换成与 DNS/SSH 配置页同一套词汇——中性底、柔和灰 tile、\n 无边框输入、单色强调、14/10 圆角，层级靠灰阶与间距，颜色只留给语义（增/删/\n 冲突/重命名与危险动作）。七个页签在窄面板里折行，不再横向滚动把设置页藏起来。\n 暗色主题与系统浅/深色都覆盖。空态加了图标与主行动按钮。\n- **修复**：界面语言初始值此前取自消息表而不是宿主 locale，导致宿主给 `en` 时\n 中文界面不落地；`textButton` 会丢掉 `data-action`，图标按钮点了没反应；设置行\n 误带 `data-field`，破坏焦点恢复与选择器。\n- 新增测试：`voki-git-manager.prefs.test.mjs`（7 项）、\n `voki-git-manager.panel-settings.test.mjs`（9 项）；合计 270 项，覆盖率\n 行 99.2% / 函数 97.3% / 分支约 90.5%。", "minPiDesktop": ">=0.27.0", "shasum": "4c5b8a526bef67cded3d99a176821178c4e83f140c7bb188a12c7fea14cb7067", "url": "packages/voki.git-management-1.1.0.piplug", "sizeBytes": 306397, "permissions": [ "ui.view", "clipboard.write" ], "fs": {} } ], "distribution": "marketplace" }, { "id": "voki.im-dingtalk", "name": "DingTalk", "description": "Bind a DingTalk app to this computer by scanning a QR code in DingTalk, or by entering its app key and secret.", "author": "voki-work", "i18n": { "en": { "name": "DingTalk", "description": "Bind a DingTalk app to this computer by scanning a QR code in DingTalk, or by entering its app key and secret.", "safetyNotes": "Talks to oapi.dingtalk.com to register the application, api.dingtalk.com to confirm it and to keep the robot's stream open, and the platform's file hosts when the robot downloads a picture or a file. Stores the app secret encrypted in this plugin's own data directory; the secret never leaves the plugin. Receives messages only while the channel is bound, through the connection the app opens outwards; nothing on this computer listens for them." }, "zh-CN": { "name": "钉钉", "description": "在钉钉里扫码创建应用，或填写 AppKey 与 AppSecret，把钉钉绑定到这台电脑。", "safetyNotes": "会访问 oapi.dingtalk.com 注册应用、访问 api.dingtalk.com 校验并保持机器人的长连接，机器人在下载图片或文件时还会访问平台的文件地址。AppSecret 加密保存在本插件自己的数据目录里，不会离开插件。只有频道绑定时才接收消息，且由应用主动向外建立连接，本机不监听任何端口。" }, "ja": { "name": "DingTalk", "description": "DingTalk で QR コードをスキャンするか、AppKey と AppSecret を入力して、DingTalk アプリをこのコンピューターにバインドします。", "safetyNotes": "アプリの登録に oapi.dingtalk.com、確認とロボットのストリーム維持に api.dingtalk.com、ロボットが画像やファイルをダウンロードする際にプラットフォームのファイルホストにアクセスします。AppSecret はこのプラグイン独自のデータディレクトリに暗号化して保存され、プラグインの外に出ることはありません。チャンネルがバインドされている間だけ、アプリが外向きに開いた接続を通じてメッセージを受信します。このコンピューター上で待ち受けるものはありません。" } }, "categories": [ "messaging" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.im-dingtalk", "docs": { "zh-CN": { "intro": "钉钉频道把钉钉机器人接到这台电脑上：你在钉钉里（单聊，或群里 @ 机器人）发消息，助手在绑定的会话里干完活，回复回到钉钉。绑定方式有两种——在钉钉里扫码注册一个应用，或者填写已有的 AppKey 与 AppSecret。\n\n收消息靠一条由插件主动向外建立的长连接，本机不开端口、不需要公网回调：收到回调后先写进插件的持久收件箱，再立刻应答平台，宿主随后按自己的节拍取走并提交到你在「IM 频道」里选定的会话。群消息只在机器人被 @ 时处理，@ 提及会从正文里去掉。\n\n回复走这条消息带来的会话 webhook；webhook 过期时会改用单聊接口发回。这一版钉钉回复只有文本，如果这一轮产出了文件，插件会把附件降级成文本提示，而不是假装发过去了。\n\n你能用它做什么：\n\n- 在钉钉单聊里给机器人发一句话，开一个任务或接着之前的任务。\n- 在群里 @ 机器人提问，让它在绑定会话里跑完并回你。\n- 扫码自动注册应用，不用去开放平台手工建应用抄密钥。\n- 已经有应用凭据时直接填 AppKey 与 AppSecret，保存时校验一次。\n", "install": "本插件不随安装包提供，安装后才可用。卸载之后可以在这里重新安装，配置与数据需要重新设置。\n开箱可用：频道随应用提供，不需要 Node、npm 或额外服务。你需要平台侧的一个钉钉应用（带机器人能力）和一次绑定。AppSecret 用 AES-256-GCM 加密保存在插件自己的数据目录（`credentials.enc`，密钥 `key.bin` 权限 0600，目录 0700），宿主只看得到绑定状态和掩码后的标识，密钥不会离开插件；注册与校验分别访问 `oapi.dingtalk.com` 与 `api.dingtalk.com`。**不要把 AppSecret 贴进对话**——它只填在「IM 频道」的配置对话框里。macOS 上建议授予「完全磁盘访问权限」，避免频道使用中反复弹出文件访问确认。\n\n没有需要填写的设置项：凭据与「消息发送到」的目标都在「IM 频道」页的配置对话框里选。\n\n首次验证：\n\n1. 打开「IM 频道」，在「钉钉」一栏点「配置」，用钉钉扫码完成应用注册；已经有应用时切到「手动配置」，填 AppKey（Client ID）与 AppSecret（Client secret）后点「保存并验证」。\n2. 绑定成功后选「消息发送到」：新建任务（会话）、新建任务（指定项目），或一个已有会话。\n3. 在钉钉里单聊机器人发「你好，用一句话说说你能做什么」——桌面应用侧栏出现该任务，回复回到钉钉。\n\n常见安装失败：\n\n- **扫码注册失败，或提示应用已存在**：改用手动配置，填这个应用的 AppKey 与 AppSecret；保存时会调令牌接口校验一次，校验失败说明密钥不对或应用没有机器人能力。\n- **发消息没反应**：机器人没有启用或应用未发布，回调就不会到；在钉钉开放平台把机器人启用并发布，然后回来重新绑定。\n- **群里 @ 了却不回**：确认 @ 的是这个机器人；只 @ 全体或只发文字不会触发，单聊则可以无条件应答。\n", "usage": "三个常见用法：\n\n1. **单聊派活**：「把今天的待办按优先级排一下，生成一个清单」。消息进入绑定的会话，助手按该会话的权限模式跑完一轮，文本回复发回钉钉。\n2. **群里 @ 一下**：「@机器人 这份需求里的验收标准有哪些遗漏？」只有在群里被 @ 时才处理，@ 提及会从正文里去掉，回复发回同一个群会话。\n3. **离开电脑也能推进**：「看看项目里那个构建为什么慢」。任务在桌面端创建，你可以在应用里看它跑到哪一步，结果回到钉钉。\n\n入口是「IM 频道」页（侧栏底部）：钉钉一行显示「未配置」「已配置」或「凭证已失效」，点「配置」走扫码或手动配置，点「解绑」清掉凭证。消息接入方式固定为：插件把回调先落盘到自己的持久收件箱，宿主取走后提交到你选定的会话，回复用这条消息带来的 webhook 发回平台，webhook 过期时改走单聊接口。\n\n不要指望它做什么：\n\n- 不会接收没有 @ 机器人的群消息，也不处理卡片、系统通知等非消息内容；这些不会进入会话。\n- 不会替你批准操作：消息按普通提示词在绑定会话里运行，继承该会话的权限模式；需要确认的写操作仍要在桌面应用里等你点同意。\n- 不会发附件：钉钉这一版出站只有文本，本轮产出的文件会以文本提示降级；本机也不监听端口，收消息只靠插件主动建立的长连接。\n" }, "ja": { "intro": "DingTalk チャンネルは DingTalk のボットをこのコンピューターにつなぎます。DingTalk の 1 対 1 チャット、またはグループでボットをメンションしてメッセージを送ると、アシスタントがバインド済みセッションで作業し、返信が DingTalk に戻ります。バインドは 2 通りで、DingTalk で QR コードをスキャンしてアプリを登録するか、既にお持ちの AppKey と AppSecret を入力します。\n\n受信はプラグインが外向きに開く長接続で行うため、このコンピューター上で待ち受けるものはなく、公開コールバックも不要です。コールバックはまずプラグインの永続的な受信箱に書き込んで即座に応答し、ホストが一定間隔で取り出して「IM チャンネル」ページで選んだセッションに渡します。グループのメッセージはボットがメンションされたときだけ処理し、メンションは本文から取り除かれます。\n\n返信はそのメッセージが持ってきた会話 Webhook で送り、Webhook が失効している場合は 1 対 1 送信のエンドポイントに切り替えます。このリリースの DingTalk の返信はテキストのみで、そのターンでファイルが生成された場合は、送ったことにせずテキストの案内に落とします。\n\nできること:\n\n- DingTalk の 1 対 1 チャットでボットに一言送り、タスクを開始したり前のタスクを続けたりします。\n- グループでボットをメンションすると、バインド済みセッションから回答します。\n- スキャンでアプリを登録でき、オープンプラットフォームで手作業のアプリ作成は不要です。\n- すでにアプリの認証情報がある場合は AppKey と AppSecret を入力し、保存時に検証します。\n", "install": "このプラグインはインストーラーに含まれません。使う前にここからインストールしてください。削除後に再度インストールできますが、設定とデータは初期状態になります。\nすぐに使えます。アプリをインストールすればこのチャンネルがあり、Node や npm、追加サービスは不要です。必要なのはプラットフォーム側のボット機能付き DingTalk アプリと、1 回のバインドです。AppSecret は AES-256-GCM でプラグイン独自のデータディレクトリに暗号化して保存され（`credentials.enc`、鍵ファイル `key.bin` は 0600、ディレクトリは 0700）、ホストが見られるのはバインド状態とマスクされた識別子だけです。登録は `oapi.dingtalk.com`、検証は `api.dingtalk.com` にアクセスします。**AppSecret をチャットに貼らないでください**。入力する場所は「IM チャンネル」の設定ダイアログです。macOS では「フルディスクアクセス」を許可すると、チャンネル使用中のファイルアクセス確認が繰り返されません。\n\n記入が必要な設定項目はありません。認証情報と「メッセージの送信先」はどちらも「IM チャンネル」ページの設定ダイアログで選びます。\n\n最初の確認:\n\n1. 「IM チャンネル」を開き、「DingTalk」の行の「設定」を押して DingTalk でスキャンし、アプリを登録します。既にアプリがある場合は「手動設定」に切り替え、AppKey（クライアント ID）と AppSecret（クライアントシークレット）を入力して「保存して検証」を押します。\n2. バインドに成功したら「メッセージの送信先」を選びます。新しいタスク（会話）、プロジェクト内の新しいタスク、既存の会話のいずれかです。\n3. 1 対 1 チャットでボットに「こんにちは。一言で何ができるか教えて」と送ると、デスクトップのサイドバーにタスクが現れ、返信が DingTalk に戻ります。\n\nよくある導入の失敗:\n\n- **スキャン登録に失敗する、アプリが既に存在すると言われる**: 手動設定に切り替え、そのアプリの AppKey と AppSecret を入力します。保存時にトークンのエンドポイントで 1 回検証し、失敗する場合はシークレットが違うか、アプリにボット機能がありません。\n- **メッセージを送っても反応しない**: ボットが有効化されていないか、アプリが公開されていないためコールバックが届きません。DingTalk のオープンプラットフォームでボットを有効化して公開し、バインドし直してください。\n- **グループでメンションしても返信がない**: メンションしたのがこのボットかを確認してください。全体メンションや本文だけでは反応せず、1 対 1 チャットは無条件に応答します。\n", "usage": "よくある 3 つの依頼:\n\n1. **1 対 1 チャットで仕事を渡す**: 「今日の ToDo を優先度順に並べてリストにして」。メッセージはバインド済みセッションに入り、アシスタントはそのセッションの権限モードで 1 ターン実行し、テキストの返信が DingTalk に戻ります。\n2. **グループでメンションする**: 「@ボット この要件の受け入れ条件で抜けている点は？」メンションされたときだけ処理し、メンションは本文から除かれ、返信は同じグループ会話に戻ります。\n3. **席を離れているときにも進める**: 「プロジェクトのあのビルドが遅い理由を調べて」。タスクはデスクトップ側に作られ、アプリで進捗を確認でき、結果は DingTalk に戻ります。\n\n入口はサイドバーの「IM チャンネル」ページです。DingTalk の行に「未設定」「設定済み」「認証情報が無効です」のいずれかが表示され、「設定」でスキャンまたは手動設定、「バインド解除」で認証情報を削除できます。メッセージの流れは常に同じです。プラグインがコールバックを自身の永続的な受信箱に書き、ホストが取り出して選択したセッションに渡し、返信はそのメッセージが持ってきた Webhook で戻り、失効時は 1 対 1 送信に切り替わります。\n\n期待しないでください:\n\n- メンションのないグループメッセージやカード、システム通知の受信: これらがセッションに入ることはありません。\n- 操作の代行承認: メッセージはバインド済みセッションで通常のプロンプトとして実行され、そのセッションの権限モードを継承します。承認が必要な書き込みは従来どおりデスクトップアプリで待機します。\n- 添付ファイルの送信: このリリースの DingTalk の送信はテキストのみで、そのターンのファイルはテキストの案内になります。受信もプラグインが開く長接続だけを使うため、このコンピューター上で待ち受けるものはありません。\n" }, "en": { "intro": "The DingTalk channel connects a DingTalk bot to this computer: you write in DingTalk (a direct chat, or a group where you mention the bot), the assistant works in the bound session, and the reply goes back to DingTalk. Binding takes one of two roads — scan a QR code in DingTalk to register an application, or enter an AppKey and AppSecret you already have.\n\nMessages arrive over a long connection the plugin opens outwards, so nothing on this computer listens and no public callback is needed: a callback is written into the plugin's durable inbox first and acknowledged immediately, then the host takes it on its own tick and submits it to the session you picked on the IM channels page. Group messages are handled only when the bot is mentioned, and the mention is stripped from the text.\n\nThe reply goes back through the conversation webhook that carried the message; when that webhook has expired the plugin falls back to the direct-message endpoint. In this release a DingTalk reply is text only — if a turn produced files, the attachment is reported as a text hint instead of pretending it was delivered.\n\nWhat you can do with it:\n\n- Send one message to the bot in a DingTalk direct chat to start a task or continue the previous one.\n- Mention the bot in a group to have it answer from the bound session.\n- Register an application by scanning, without creating an app on the open platform by hand.\n- Enter an AppKey and AppSecret you already have, with a verification step when you save.\n", "install": "This plugin is not part of the installer: install it here before using it. After removing it you can reinstall it here, but its settings and data start over.\nIt works out of the box: the channel is there once the app is installed, with no Node, npm or extra service. What you need is a DingTalk application with bot capability on the platform side and one binding. The AppSecret is encrypted with AES-256-GCM in this plugin's own data directory (`credentials.enc`, key file `key.bin` with mode 0600, directory 0700); the host only ever sees the binding state and a masked identifier, and the secret never leaves the plugin. Registration talks to `oapi.dingtalk.com` and verification to `api.dingtalk.com`. **Do not paste the AppSecret into the chat** — it belongs in the IM channels configuration dialog. On macOS, granting the app Full Disk Access avoids the repeated file-access prompts while a channel is in use.\n\nThere are no settings to fill in: the credential and the \"send messages to\" target both live in the configuration dialog on the IM channels page.\n\nFirst verification:\n\n1. Open \"IM channels\", click \"Configure\" on the DingTalk row and scan in DingTalk to register the application; if you already have one, switch to \"Manual setup\", enter the AppKey (Client ID) and AppSecret (Client secret) and click \"Save and verify\".\n2. After the binding succeeds, choose \"Send messages to\": a new task (conversation), a new task in a project, or an existing conversation.\n3. Send \"hello, tell me in one sentence what you can do for me\" to the bot in a direct chat — the task appears in the desktop sidebar and the reply comes back to DingTalk.\n\nCommon install failures:\n\n- **The scan registration fails, or the app already exists**: switch to manual setup and enter that application's AppKey and AppSecret; saving checks the token endpoint once, and a failure means the secret is wrong or the app has no bot capability.\n- **Nothing happens when you send a message**: the bot is not enabled or the app is not published, so no callback arrives; enable and publish the bot on the DingTalk open platform, then bind again.\n- **A group mention gets no answer**: check that you mentioned this bot; mentioning everyone or only sending text does not trigger it, while a direct chat answers unconditionally.\n", "usage": "Three common things to ask for:\n\n1. **Hand over work in a direct chat**: \"Sort today's to-dos by priority and give me a list.\" The message enters the bound session, the assistant runs a turn under that session's permission mode, and the text reply goes back to DingTalk.\n2. **Answer in a group**: \"@bot which acceptance criteria are missing from this spec?\" Only a mention is handled, the mention is stripped from the text, and the reply goes back to the same group conversation.\n3. **Keep things moving away from the desk**: \"Look into why that build in the project is slow.\" The task is created on the desktop, you can follow it in the app, and the result comes back to DingTalk.\n\nThe entry point is the IM channels page in the sidebar: the DingTalk row shows \"Not configured\", \"Configured\" or \"Credentials invalid\", with \"Configure\" for the scan or manual setup and \"Unbind\" to delete the credential. Messages always travel the same way: the plugin writes a callback into its own durable inbox, the host takes it and submits it to the session you selected, and the reply goes back through the webhook that carried the message, falling back to the direct-message endpoint when it has expired.\n\nDo not expect it to:\n\n- Take group messages without a mention, or handle cards and system notices; none of those enter a session.\n- Approve actions for you: a message runs as an ordinary prompt in the bound session and inherits that session's permission mode, so any write needing approval still waits for you in the desktop app.\n- Send attachments: outbound DingTalk is text only in this release, so files from a turn are reported as a text hint; nothing on this computer listens either, because receiving only uses the long connection the plugin opens.\n" } }, "versions": [ { "version": "1.0.0", "publishedAt": "2026-11-01T00:00:00Z", "minPiDesktop": ">=0.8.0", "shasum": "a78f7f002b24736697227579033ab5757e1b5e244897d39f7ea65b3fefec3fbe", "url": "packages/voki.im-dingtalk-1.0.0.piplug", "sizeBytes": 82902, "permissions": [ "channel.call" ], "fs": {} } ], "distribution": "marketplace" }, { "id": "voki.im-feishu", "name": "Feishu / Lark", "description": "Bind a Feishu or Lark bot to this computer by scanning a QR code, or by entering an app id and secret.", "author": "voki-work", "i18n": { "en": { "name": "Feishu / Lark", "description": "Bind a Feishu or Lark bot to this computer by scanning a QR code, or by entering an app id and secret.", "safetyNotes": "Talks to the Feishu or Lark open platform to register the application, keep its long connection open, and fetch or send the messages and files of the chats it is bound to. Stores the app secret encrypted in this plugin's own data directory; the secret never leaves the plugin. Receives messages only while the channel is bound, through the connection the app opens outwards; nothing on this computer listens for them." }, "zh-CN": { "name": "飞书 / Lark", "description": "扫码或填写 App ID 与 App Secret，把飞书 / Lark 机器人绑定到这台电脑。", "safetyNotes": "会访问飞书／Lark 开放平台注册应用、保持长连接，并收发已绑定会话里的消息与文件。AppSecret 加密保存在本插件自己的数据目录里，不会离开插件。只有频道绑定时才接收消息，且由应用主动向外建立连接，本机不监听任何端口。" }, "ja": { "name": "Feishu / Lark", "description": "QR コードをスキャンするか、App ID と App Secret を入力して、Feishu または Lark ボットをこのコンピューターにバインドします。", "safetyNotes": "アプリの登録、長接続の維持、バインドされたチャットのメッセージとファイルの取得・送信のために、Feishu または Lark のオープンプラットフォームにアクセスします。AppSecret はこのプラグイン独自のデータディレクトリに暗号化して保存され、プラグインの外に出ることはありません。チャンネルがバインドされている間だけ、アプリが外向きに開いた接続を通じてメッセージを受信します。このコンピューター上で待ち受けるものはありません。" } }, "categories": [ "messaging" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.im-feishu", "docs": { "zh-CN": { "intro": "飞书 / Lark 频道把机器人接到这台电脑上：你在飞书或 Lark 里发消息（单聊，或群里 @ 机器人），助手在绑定的会话里干完活，回复回到同一个会话。同一个插件同时提供「飞书」和「Lark」两行，两边的协议形状一样，只是开放平台域名不同。\n\n收消息靠插件主动向外建立的长连接，本机不开端口、不需要公网回调：收到的事件先写进插件的持久收件箱，宿主随后按节拍取走并提交到你在「IM 频道」里选定的会话。群消息只在机器人被 @ 时处理，@ 的占位符会从正文里去掉。\n\n绑定有两条路：用飞书（或 Lark）扫码，插件会自动创建并配置机器人；或者填已有的 App ID 与 App Secret，保存时用 `tenant_access_token` 接口校验一次。回复可以是文本，也可以带上一轮产出的文件。\n\n你能用它做什么：\n\n- 在飞书或 Lark 单聊里给机器人发一句话，开任务或接着之前的任务。\n- 在群里 @ 机器人提问，让它在绑定会话里跑完并回你。\n- 扫码让插件自动创建并配置机器人，不用手工建应用。\n- 已经有应用时填 App ID 与 App Secret，保存时校验一次。\n", "install": "本插件不随安装包提供，安装后才可用。卸载之后可以在这里重新安装，配置与数据需要重新设置。\n开箱可用：频道随应用提供，不需要 Node、npm 或额外服务。你需要平台侧的一个飞书或 Lark 应用（带机器人能力）和一次绑定。App Secret 用 AES-256-GCM 加密保存在插件自己的数据目录（`credentials.enc`，密钥 `key.bin` 权限 0600，目录 0700），宿主只看得到绑定状态和掩码后的标识，密钥不会离开插件。**不要把 App Secret 贴进对话**——它只填在「IM 频道」的配置对话框里。macOS 上建议授予「完全磁盘访问权限」，避免频道使用中反复弹出文件访问确认。\n\n没有需要填写的设置项：凭据与「消息发送到」的目标都在「IM 频道」页的配置对话框里选，飞书和 Lark 各自绑定一次。\n\n首次验证：\n\n1. 打开「IM 频道」，在「飞书」（或「Lark」）一栏点「配置」，用对应客户端扫码，插件会自动创建并配置机器人；已有应用时改用手动配置填 App ID（`cli_…`）与 App Secret，点「保存并验证」。\n2. 绑定成功后选「消息发送到」：新建任务（会话）、新建任务（指定项目），或一个已有会话。\n3. 在飞书里给机器人发「你好，用一句话说说你能做什么」——桌面应用侧栏出现该任务，回复回到飞书。\n\n常见安装失败：\n\n- **扫码时提示不再签发 App Secret**：这个部署不为新应用提供客户端密钥，插件无法完成自动注册；改用手动配置，填你已经有的 App ID 与 App Secret。\n- **保存并验证失败**：App ID（`cli_…`）或 App Secret 填错，或应用没有开通机器人能力；在开放平台开通机器人后重新填一次。\n- **群里 @ 了却没反应**：确认 @ 的是这个机器人；只发文字不 @，或 @ 后事件订阅范围不含群消息，都不会触发。\n", "usage": "三个常见用法：\n\n1. **单聊派活**：「把这周的周报要点整理成三条，直接回我」。消息进入绑定的会话，助手按该会话的权限模式跑完一轮，回复发回飞书。\n2. **群里 @ 一下**：「@机器人 这份合同里有哪些付款节点？」只有被 @ 时才处理，@ 占位符从正文里去掉，回复发回同一个群会话。\n3. **要一份文件**：「把这个统计结果导出成表格，发给我」。本轮产出的文件会随回复一起发出；超出大小或数量上限时会有通知，而不是静默丢掉。\n\n入口是「IM 频道」页（侧栏底部）：飞书和 Lark 各占一行，显示「未配置」「已配置」或「凭证已失效」，点「配置」走扫码或手动配置，点「解绑」清掉凭证。消息接入方式固定为：插件把事件先落盘到自己的持久收件箱，宿主取走后提交到你选定的会话，回复再用同一平台的接口发回。\n\n不要指望它做什么：\n\n- 不会接收没有 @ 机器人的群消息，也不处理卡片、系统通知等非消息事件；这些内容不会进入会话。\n- 不会替你批准操作：消息按普通提示词在绑定会话里运行，继承该会话的权限模式；需要确认的写操作仍要在桌面应用里等你点同意。\n- 不会在本机开端口，也无法验证一个假的机器人：收消息只靠插件主动建立的长连接，本机不监听；App Secret 一旦失效，频道状态会显示为「凭证已失效」，需要重新绑定。\n" }, "ja": { "intro": "Feishu / Lark チャンネルはボットをこのコンピューターにつなぎます。Feishu または Lark でメッセージを送ると（1 対 1 チャット、またはグループでボットをメンション）、アシスタントがバインド済みセッションで作業し、返信が同じ会話に戻ります。1 つのプラグインが「Feishu」と「Lark」の 2 行を提供します。プロトコルの形は同じで、オープンプラットフォームのホストだけが異なります。\n\n受信はプラグインが外向きに開く長接続で行うため、このコンピューター上で待ち受けるものはなく、公開コールバックも不要です。イベントはまずプラグインの永続的な受信箱に書き込まれ、ホストが一定間隔で取り出して「IM チャンネル」ページで選んだセッションに渡します。グループのメッセージはボットがメンションされたときだけ処理し、メンションのプレースホルダーは本文から取り除かれます。\n\nバインドは 2 通りです。Feishu（または Lark）でスキャンするとプラグインがボットを作成・設定します。既存の App ID と App Secret を入力する場合は、保存時に `tenant_access_token` のエンドポイントで 1 回検証します。返信はテキスト、またはそのターンで生成されたファイルを伴うテキストです。\n\nできること:\n\n- Feishu や Lark の 1 対 1 チャットでボットに一言送り、タスクを開始したり前のタスクを続けたりします。\n- グループでボットをメンションすると、バインド済みセッションから回答します。\n- スキャンでボットの作成と設定をプラグインに任せ、手作業でアプリを作らずに済みます。\n- すでにアプリがある場合は App ID と App Secret を入力し、保存時に検証します。\n", "install": "このプラグインはインストーラーに含まれません。使う前にここからインストールしてください。削除後に再度インストールできますが、設定とデータは初期状態になります。\nすぐに使えます。アプリをインストールすればこのチャンネルがあり、Node や npm、追加サービスは不要です。必要なのはプラットフォーム側のボット機能付き Feishu または Lark アプリと、1 回のバインドです。App Secret は AES-256-GCM でプラグイン独自のデータディレクトリに暗号化して保存され（`credentials.enc`、鍵ファイル `key.bin` は 0600、ディレクトリは 0700）、ホストが見られるのはバインド状態とマスクされた識別子だけです。**App Secret をチャットに貼らないでください**。入力する場所は「IM チャンネル」の設定ダイアログです。macOS では「フルディスクアクセス」を許可すると、チャンネル使用中のファイルアクセス確認が繰り返されません。\n\n記入が必要な設定項目はありません。認証情報と「メッセージの送信先」はどちらも「IM チャンネル」ページの設定ダイアログで選び、Feishu と Lark はそれぞれ個別にバインドします。\n\n最初の確認:\n\n1. 「IM チャンネル」を開き、「Feishu」（または「Lark」）の行の「設定」を押して、そのクライアントでスキャンします。プラグインがボットを作成・設定します。既にアプリがある場合は手動設定で App ID（`cli_…`）と App Secret を入力し、「保存して検証」を押します。\n2. バインドに成功したら「メッセージの送信先」を選びます。新しいタスク（会話）、プロジェクト内の新しいタスク、既存の会話のいずれかです。\n3. Feishu でボットに「こんにちは。一言で何ができるか教えて」と送ると、デスクトップのサイドバーにタスクが現れ、返信が Feishu に戻ります。\n\nよくある導入の失敗:\n\n- **スキャン時に App Secret を発行しないと言われる**: この配備では新しいアプリにクライアントシークレットが発行されないため、自動登録を完了できません。手動設定で、既にお持ちの App ID と App Secret を入力してください。\n- **保存して検証に失敗する**: App ID（`cli_…`）か App Secret が違うか、アプリにボット機能がありません。オープンプラットフォームでボットを有効化し、入力し直してください。\n- **グループでメンションしても返信がない**: メンションしたのがこのボットかを確認してください。メンションなしの本文や、購読範囲外のグループイベントでは反応しません。\n", "usage": "よくある 3 つの依頼:\n\n1. **1 対 1 チャットで仕事を渡す**: 「今週のレポートを 3 つの要点にして、ここに返して」。メッセージはバインド済みセッションに入り、アシスタントはそのセッションの権限モードで 1 ターン実行し、返信が Feishu に戻ります。\n2. **グループでメンションする**: 「@ボット この契約の支払いマイルストーンは？」メンションされたときだけ処理し、プレースホルダーを除いた本文を使い、返信は同じグループ会話に戻ります。\n3. **ファイルを受け取る**: 「この集計結果を表計算にして送って」。そのターンで生成されたファイルは返信と一緒に送られます。サイズや件数の上限を超えた場合は、黙って捨てずに通知されます。\n\n入口はサイドバーの「IM チャンネル」ページです。Feishu と Lark がそれぞれ 1 行ずつ並び、「未設定」「設定済み」「認証情報が無効です」のいずれかを表示します。「設定」でスキャンまたは手動設定、「バインド解除」で認証情報を削除できます。メッセージの流れは常に同じです。プラグインがイベントを自身の永続的な受信箱に書き、ホストが取り出して選択したセッションに渡し、返信はそのプラットフォームの API で戻ります。\n\n期待しないでください:\n\n- メンションのないグループメッセージやカード、システム通知の受信: これらがセッションに入ることはありません。\n- 操作の代行承認: メッセージはバインド済みセッションで通常のプロンプトとして実行され、そのセッションの権限モードを継承します。承認が必要な書き込みは従来どおりデスクトップアプリで待機します。\n- ポートの待ち受けや不正な認証情報の保証: 受信はプラグインが開く長接続だけで、このコンピューター上で待ち受けるものはありません。App Secret が失効すると、その行は「認証情報が無効です」になり再バインドが必要です。\n" }, "en": { "intro": "The Feishu / Lark channel connects a bot to this computer: you write in Feishu or Lark (a direct chat, or a group where you mention the bot), the assistant works in the bound session, and the reply goes back to the same conversation. One plugin serves two rows — \"Feishu\" and \"Lark\" — because the protocol has the same shape on both; only the open-platform hosts differ.\n\nMessages arrive over a long connection the plugin opens outwards, so nothing on this computer listens and no public callback is needed: an event is written into the plugin's durable inbox first, then the host takes it on its own tick and submits it to the session you picked on the IM channels page. Group messages are handled only when the bot is mentioned, and the mention placeholder is stripped from the text.\n\nBinding takes one of two roads: scan with Feishu (or Lark) and the plugin creates and configures the bot for you, or enter an existing App ID and App Secret, which is checked once against the `tenant_access_token` endpoint when you save. A reply can be text, or text plus the files a turn produced.\n\nWhat you can do with it:\n\n- Send one message to the bot in a Feishu or Lark direct chat to start a task or continue the previous one.\n- Mention the bot in a group to have it answer from the bound session.\n- Let the plugin create and configure the bot by scanning, instead of building an app by hand.\n- Enter an App ID and App Secret you already have, with a verification step when you save.\n", "install": "This plugin is not part of the installer: install it here before using it. After removing it you can reinstall it here, but its settings and data start over.\nIt works out of the box: the channel is there once the app is installed, with no Node, npm or extra service. What you need is a Feishu or Lark application with bot capability on the platform side and one binding. The App Secret is encrypted with AES-256-GCM in this plugin's own data directory (`credentials.enc`, key file `key.bin` with mode 0600, directory 0700); the host only ever sees the binding state and a masked identifier, and the secret never leaves the plugin. **Do not paste the App Secret into the chat** — it belongs in the IM channels configuration dialog. On macOS, granting the app Full Disk Access avoids the repeated file-access prompts while a channel is in use.\n\nThere are no settings to fill in: the credential and the \"send messages to\" target both live in the configuration dialog on the IM channels page, and Feishu and Lark are bound separately.\n\nFirst verification:\n\n1. Open \"IM channels\", click \"Configure\" on the \"Feishu\" (or \"Lark\") row and scan with that client so the plugin creates and configures the bot; if you already have an app, use manual setup, enter the App ID (`cli_…`) and App Secret and click \"Save and verify\".\n2. After the binding succeeds, choose \"Send messages to\": a new task (conversation), a new task in a project, or an existing conversation.\n3. Send \"hello, tell me in one sentence what you can do for me\" to the bot in Feishu — the task appears in the desktop sidebar and the reply comes back to Feishu.\n\nCommon install failures:\n\n- **The scan reports that an App Secret is no longer issued**: this deployment does not give client secrets to new applications, so automatic registration cannot finish; use manual setup with the App ID and App Secret you already have.\n- **Save and verify fails**: the App ID (`cli_…`) or the App Secret is wrong, or the app has no bot capability; enable the bot on the open platform and enter them again.\n- **A group mention gets no answer**: check that you mentioned this bot; text without a mention, or a mention outside the subscribed group events, does not trigger it.\n", "usage": "Three common things to ask for:\n\n1. **Hand over work in a direct chat**: \"Turn this week's report into three bullet points and reply here.\" The message enters the bound session, the assistant runs a turn under that session's permission mode, and the reply goes back to Feishu.\n2. **Answer in a group**: \"@bot which payment milestones does this contract contain?\" Only a mention is handled, the mention placeholder is stripped, and the reply goes back to the same group conversation.\n3. **Ask for a file**: \"Export this result as a spreadsheet and send it to me.\" Files from the turn go out with the reply; when one exceeds the size or count limit you get a notice instead of a silent drop.\n\nThe entry point is the IM channels page in the sidebar: Feishu and Lark each get a row showing \"Not configured\", \"Configured\" or \"Credentials invalid\", with \"Configure\" for the scan or manual setup and \"Unbind\" to delete the credential. Messages always travel the same way: the plugin writes an event into its own durable inbox, the host takes it and submits it to the session you selected, and the reply goes back out through that platform's API.\n\nDo not expect it to:\n\n- Take group messages without a mention, or handle cards and system notices; none of those enter a session.\n- Approve actions for you: a message runs as an ordinary prompt in the bound session and inherits that session's permission mode, so any write needing approval still waits for you in the desktop app.\n- Open a port, or vouch for a bad credential: receiving only uses the long connection the plugin opens, nothing on this computer listens, and once the App Secret stops working the channel row shows \"Credentials invalid\" and needs a new binding.\n" } }, "versions": [ { "version": "1.0.0", "publishedAt": "2026-11-01T00:00:00Z", "minPiDesktop": ">=0.8.0", "shasum": "826e7c914dfdf84779e1ea1f4ec98c466ff1597a0b717e5c5ee139c63499893a", "url": "packages/voki.im-feishu-1.0.0.piplug", "sizeBytes": 95448, "permissions": [ "channel.call" ], "fs": {} } ], "distribution": "marketplace" }, { "id": "voki.im-wechat", "name": "WeChat", "description": "Bind this computer to your WeChat account by scanning a sign-in code, or by entering a bot token you already have.", "author": "voki-work", "i18n": { "en": { "name": "WeChat", "description": "Bind this computer to your WeChat account by scanning a sign-in code, or by entering a bot token you already have.", "safetyNotes": "Talks to ilinkai.weixin.qq.com — Tencent's iLink bot channel, the same one the official openclaw-weixin package uses. Stores the bot token encrypted in this plugin's own data directory; the token never leaves the plugin. Unlike the other channels it cannot verify what it stores: iLink has no read-only call that proves a bot token, so a manual entry is recorded as given. Runs no background connection: this release only binds." }, "zh-CN": { "name": "微信", "description": "扫码登录，或填写已有的机器人令牌，把这台电脑绑定到你的微信。", "safetyNotes": "会访问 ilinkai.weixin.qq.com（腾讯 iLink 机器人通道，官方 openclaw-weixin 包用的是同一条）。机器人令牌加密保存在本插件自己的数据目录里，不会离开插件。与其它频道不同，本插件无法校验保存的内容：iLink 没有任何只读接口可以验证令牌，手动填写的内容会按原样记录。本版本不建立常驻连接，只做绑定。" }, "ja": { "name": "WeChat", "description": "サインインコードをスキャンするか、既にお持ちのボットトークンを入力して、このコンピューターを WeChat アカウントにバインドします。", "safetyNotes": "ilinkai.weixin.qq.com（Tencent の iLink ボットチャンネル。公式の openclaw-weixin パッケージが使用しているものと同じ）にアクセスします。ボットトークンはこのプラグイン独自のデータディレクトリに暗号化して保存され、プラグインの外に出ることはありません。他のチャンネルと異なり、保存内容を検証できません。iLink にはボットトークンを証明する読み取り専用の呼び出しがないため、手動入力は入力どおりに記録されます。バックグラウンド接続は実行しません。このリリースではバインドのみを行います。" } }, "categories": [ "messaging" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.im-wechat", "docs": { "zh-CN": { "intro": "微信频道让这台电脑接住你从手机微信发来的消息：你在手机上说话，助手在一个会话里干完活，回复发回微信。绑定有两条路——用微信扫码登录，或者填写你已有的机器人令牌。\n\n绑定之后，消息由宿主主动向 iLink 机器人通道取回，而不是本机开端口等人推过来：收到的消息先进插件的持久收件箱，宿主按节拍取走并提交到你在「IM 频道」里选定的会话。所以这台电脑不需要公网地址，也不需要转发或内网穿透。\n\n回复默认是文本；如果这一轮产出了文件，文件也会随回复发出去。你想让任务跑在哪里由你定：一个新建任务、某个项目里的新任务，或者一个已有会话；任务结束时还可以让它推一条摘要。\n\n你能用它做什么：\n\n- 在微信里给机器人发一句话，就开一个任务或接着之前的任务跑。\n- 用扫码把绑定做完，不用去开放平台抄任何密钥。\n- 已经有一份机器人令牌时直接填进去，跳过扫码。\n- 在「IM 频道」里看到绑定状态，随时解绑（解绑会删掉保存的凭证）。\n", "install": "本插件不随安装包提供，安装后才可用。卸载之后可以在这里重新安装，配置与数据需要重新设置。\n开箱可用：装好应用就有这个频道，不需要 Node、npm 或额外服务。你需要的只是平台侧的一个微信机器人，以及一次绑定。凭证（机器人令牌）用 AES-256-GCM 加密保存在插件自己的数据目录（`credentials.enc`，密钥 `key.bin` 权限 0600，目录 0700），宿主只看得到绑定状态和掩码后的标识，令牌不会离开插件。**不要把机器人令牌贴进对话**——要填就填在「IM 频道」的配置对话框里。macOS 上建议给应用授予「完全磁盘访问权限」，否则频道使用过程中会反复弹出文件访问确认。\n\n没有需要填写的设置项：绑定信息和「消息发送到」的目标都在「IM 频道」页的配置对话框里选，不在插件设置里。\n\n首次验证：\n\n1. 打开「IM 频道」，在「微信」一栏点「配置」，用手机微信扫描「扫码登录」的二维码并确认。平台认为这次扫码异常时会要求输入手机上显示的 4–8 位配对数字，输入后确认即可。\n2. 绑定成功后选「消息发送到」：新建任务（会话）、新建任务（指定项目），或一个已有会话。\n3. 在手机微信里给这个机器人发「你好，用一句话说说你能帮我做什么」——桌面应用侧栏会出现对应任务，回复回到微信。\n\n常见安装失败：\n\n- **二维码过期或一直等待确认**：码的有效期只有几分钟，点「刷新二维码」重新扫；扫码后用手机上的确认按钮完成，别停在扫描页。\n- **要求输入配对数字**：这是平台对可疑扫码的检查；连续输错会让这张码作废，需要重新生成一张再试。\n- **手动填了令牌却收不到消息**：iLink 没有只读接口可以验证令牌，手动填写的内容会按原样记录，插件无法替你确认它对不对；先解绑，再用扫码重新绑定一次。\n", "usage": "三个常见用法：\n\n1. **在微信里派活**：「把昨天会议纪要里的三条结论整理出来，发我一份」。消息进入绑定的会话，助手按该会话的权限模式跑完一轮，回复发回微信。\n2. **离开电脑也能用**：「帮我看看项目里那个测试为什么失败」。任务在桌面端创建，你可以在应用里看到它跑到哪一步。\n3. **收尾时拿摘要**：「这份表格统计完，把结论发到微信」。把「任务完成时推送摘要」打开，任务结束时你会收到一条摘要。\n\n入口是「IM 频道」页（侧栏底部）：每个平台一行，显示「未配置」「已配置」或「凭证已失效」，点「配置」走扫码或手动配置，点「解绑」清掉凭证。消息接入方式固定为：插件把收到的消息写进自己的持久收件箱，宿主取走后提交到你选定的会话，回复再用同一通道发回平台。\n\n不要指望它做什么：\n\n- 不会接收群聊消息：本频道只处理发给机器人的单聊消息，群里的内容一律不入会话。\n- 不会替你批准操作：消息在绑定会话里按普通提示词运行，继承该会话的权限模式；需要确认的写操作还是在桌面应用里等你点同意。\n- 不会在本机开端口，也不校验手动填的令牌：绑定与收消息都靠对外的请求，本机不监听；iLink 没有只读接口，手动令牌是否正确只能靠实际收发验证。\n" }, "ja": { "intro": "WeChat チャンネルは、スマートフォンの WeChat から送ったメッセージをこのコンピューターで受けます。スマートフォンで用件を伝えると、アシスタントがあるセッションで作業を終え、返信が WeChat に戻ります。バインドには 2 通りあり、WeChat でサインインコードをスキャンするか、既にお持ちのボットトークンを入力します。\n\nバインド後は、ホストが iLink ボットチャンネルへメッセージを取りに行きます。ポートを開いて push を待つのではなく、受信したメッセージはまずプラグインの永続的な受信箱に入り、ホストが一定間隔で取り出して「IM チャンネル」ページで選んだセッションに渡します。そのため、このコンピューターに公開アドレスもポート転送もトンネルも要りません。\n\n返信は既定でテキストで、そのターンでファイルが生成された場合はファイルも一緒に送られます。タスクをどこで動かすかは選べます。新しいタスク、プロジェクト内の新しいタスク、既存の会話のいずれかで、タスク完了時に要約を push させることもできます。\n\nできること:\n\n- WeChat でボットに一言送るだけで、タスクを開始したり前のタスクを続けたりできます。\n- スキャンだけでバインドを完了でき、オープンプラットフォームから鍵を書き写す必要はありません。\n- すでにボットトークンがある場合は入力するだけでスキャンを省けます。\n- 「IM チャンネル」ページでバインド状態を確認し、いつでも解除できます（解除すると保存した認証情報は削除されます）。\n", "install": "このプラグインはインストーラーに含まれません。使う前にここからインストールしてください。削除後に再度インストールできますが、設定とデータは初期状態になります。\nすぐに使えます。アプリをインストールすればこのチャンネルがあり、Node や npm、追加サービスは不要です。必要なのはプラットフォーム側の WeChat ボットと、1 回のバインドだけです。認証情報（ボットトークン）は AES-256-GCM でプラグイン独自のデータディレクトリに暗号化して保存され（`credentials.enc`、鍵ファイル `key.bin` は 0600、ディレクトリは 0700）、ホストが見られるのはバインド状態とマスクされた識別子だけです。トークンがプラグインの外に出ることはありません。**ボットトークンをチャットに貼らないでください**。入力する場所は「IM チャンネル」の設定ダイアログです。macOS では「フルディスクアクセス」を許可すると、チャンネル使用中のファイルアクセス確認が繰り返されません。\n\n記入が必要な設定項目はありません。認証情報と「メッセージの送信先」はどちらも「IM チャンネル」ページの設定ダイアログで選ぶもので、プラグイン設定にはありません。\n\n最初の確認:\n\n1. 「IM チャンネル」を開き、「WeChat」の行の「設定」を押して「スキャンしてサインイン」のコードを WeChat でスキャンし、スマートフォンで確認します。プラットフォームが不審なスキャンと判断した場合は、スマートフォンに表示される 4〜8 桁のペアリング番号の入力が求められます。\n2. バインドに成功したら「メッセージの送信先」を選びます。新しいタスク（会話）、プロジェクト内の新しいタスク、既存の会話のいずれかです。\n3. スマートフォンの WeChat からそのボットに「こんにちは。一言で何ができるか教えて」と送ると、デスクトップのサイドバーにタスクが現れ、返信が WeChat に戻ります。\n\nよくある導入の失敗:\n\n- **コードが期限切れになる、確認待ちのままになる**: コードの有効期間は数分です。「コードを更新」で再スキャンし、スキャン画面に留まらずスマートフォンの確認ボタンまで進めてください。\n- **ペアリング番号を求められる**: 不審なスキャンに対するプラットフォームの確認です。入力ミスが続くとコードが無効になるため、再生成してやり直してください。\n- **手動入力したトークンは保存されるがメッセージが来ない**: iLink にはトークンを証明する読み取り専用の呼び出しがないため、手動入力は入力どおりに記録され、プラグインが正しさを確認することはできません。いったん解除し、スキャンでバインドし直してください。\n", "usage": "よくある 3 つの依頼:\n\n1. **WeChat から仕事を渡す**: 「昨日の議事録から決定事項を 3 つ抜き出して、コピーを送って」。メッセージはバインド済みセッションに入り、アシスタントはそのセッションの権限モードで 1 ターン実行し、返信が WeChat に戻ります。\n2. **席を離れているときにも使う**: 「プロジェクトのあのテストが失敗する理由を調べて」。タスクはデスクトップ側に作られ、アプリで進捗を確認できます。\n3. **最後に要約を受け取る**: 「この表の集計が終わったら、結論を WeChat に送って」。「タスク完了時に要約を送信」を有効にしておくと、終了時に要約が届きます。\n\n入口はサイドバーの「IM チャンネル」ページです。プラットフォームごとに 1 行あり、「未設定」「設定済み」「認証情報が無効です」のいずれかを表示し、「設定」でスキャンまたは手動設定、「バインド解除」で認証情報を削除できます。メッセージの流れは常に同じです。プラグインが受信内容を自身の永続的な受信箱に書き、ホストが取り出して選択したセッションに渡し、返信は同じ経路でプラットフォームに戻ります。\n\n期待しないでください:\n\n- グループメッセージの受信: このチャンネルが扱うのはボット宛ての 1 対 1 のメッセージだけで、グループの内容がセッションに入ることはありません。\n- 操作の代行承認: メッセージはバインド済みセッションで通常のプロンプトとして実行され、そのセッションの権限モードを継承します。承認が必要な書き込みは従来どおりデスクトップアプリで待機します。\n- ポートの待ち受けや手動トークンの検証: バインドも受信も外向きのリクエストで、このコンピューター上で待ち受けるものはありません。iLink に読み取り専用の呼び出しはないため、手動トークンの正しさは実際の送受信でしか確かめられません。\n" }, "en": { "intro": "The WeChat channel lets this computer answer messages you send from WeChat on your phone: you write on the phone, the assistant does the work in a session, and the reply goes back to WeChat. There are two ways to bind — scan a sign-in code with WeChat, or enter a bot token you already have.\n\nOnce bound, the host asks the iLink bot channel for messages instead of opening a port and waiting for a push: incoming messages land in the plugin's durable inbox, the host takes them on its own tick and submits them to the session you picked on the IM channels page. So this computer needs no public address, no forwarding and no tunnel.\n\nReplies are text by default; when a turn produces files, the files go out with the reply. Where a task runs is your choice: a new task, a new task in a project, or an existing conversation — and you can have a summary pushed when a task finishes.\n\nWhat you can do with it:\n\n- Send one message to the bot in WeChat to start a task or continue the previous one.\n- Finish the binding by scanning, without copying any secret out of an open platform.\n- Enter a bot token you already have and skip the scan.\n- Watch the binding state on the IM channels page and unbind at any time (unbinding deletes the stored credential).\n", "install": "This plugin is not part of the installer: install it here before using it. After removing it you can reinstall it here, but its settings and data start over.\nIt works out of the box: the channel is there once the app is installed, with no Node, npm or extra service. All you need is a WeChat bot on the platform side and one binding. The credential (the bot token) is encrypted with AES-256-GCM in this plugin's own data directory (`credentials.enc`, key file `key.bin` with mode 0600, directory 0700); the host only ever sees the binding state and a masked identifier, and the token never leaves the plugin. **Do not paste the bot token into the chat** — enter it in the IM channels configuration dialog. On macOS, granting the app Full Disk Access avoids the repeated file-access prompts while a channel is in use.\n\nThere are no settings to fill in: the credential and the \"send messages to\" target both live in the configuration dialog on the IM channels page, not in plugin settings.\n\nFirst verification:\n\n1. Open \"IM channels\", click \"Configure\" on the WeChat row and scan the \"Scan to sign in\" code with WeChat, then confirm on the phone. If the platform treats the scan as unusual it asks for the 4–8 digit pairing number shown on the phone; type it and confirm.\n2. After the binding succeeds, choose \"Send messages to\": a new task (conversation), a new task in a project, or an existing conversation.\n3. Send \"hello, tell me in one sentence what you can do for me\" to that bot in WeChat — the task appears in the desktop sidebar and the reply comes back to WeChat.\n\nCommon install failures:\n\n- **The code expires or stays waiting**: a code lives only a few minutes — click \"Refresh code\" and scan again, and finish with the confirm button on the phone instead of staying on the scanner.\n- **A pairing number is requested**: that is the platform's check on an unusual scan; too many wrong entries invalidate the code, so regenerate one and try again.\n- **A manually entered token saves but no message arrives**: iLink has no read-only call that proves a token, so a manual entry is recorded as given and the plugin cannot confirm it for you; unbind and bind again by scanning.\n", "usage": "Three common things to ask for:\n\n1. **Hand over work from WeChat**: \"Pull the three decisions out of yesterday's meeting notes and send me a copy.\" The message enters the bound session, the assistant runs a turn under that session's permission mode, and the reply goes back to WeChat.\n2. **Use it away from the desk**: \"Take a look at why that test in the project fails.\" The task is created on the desktop and you can watch its progress in the app.\n3. **Get a summary at the end**: \"Once this spreadsheet is done, send me the conclusion on WeChat.\" With \"Send a summary when a task finishes\" on, a summary arrives when the task ends.\n\nThe entry point is the IM channels page in the sidebar: one row per platform showing \"Not configured\", \"Configured\" or \"Credentials invalid\", with \"Configure\" for the scan or manual setup and \"Unbind\" to delete the credential. Messages always travel the same way: the plugin writes what it received into its own durable inbox, the host takes it and submits it to the session you selected, and the reply goes back out through the same channel.\n\nDo not expect it to:\n\n- Take group messages: this channel handles only direct messages to the bot; group content never enters a session.\n- Approve actions for you: a message runs as an ordinary prompt in the bound session and inherits that session's permission mode, so any write needing approval still waits for you in the desktop app.\n- Open a port or validate a manual token: binding and receiving are outbound requests, nothing on this computer listens, and since iLink has no read-only call, whether a manual token works can only be proven by actually sending and receiving.\n" } }, "versions": [ { "version": "1.0.0", "publishedAt": "2026-11-01T00:00:00Z", "minPiDesktop": ">=0.8.0", "shasum": "043c5ecc965d69996b9f82f25c7400e81784cf61bfee6a5adb911d1f8b6f4d7c", "url": "packages/voki.im-wechat-1.0.0.piplug", "sizeBytes": 88367, "permissions": [ "channel.call" ], "fs": {} } ], "distribution": "marketplace" }, { "id": "voki.im-wecom", "name": "WeCom", "description": "Bind a WeCom bot to this computer by scanning a QR code in the WeCom app, or by entering its bot id and secret.", "author": "voki-work", "i18n": { "en": { "name": "WeCom", "description": "Bind a WeCom bot to this computer by scanning a QR code in the WeCom app, or by entering its bot id and secret.", "safetyNotes": "Talks to work.weixin.qq.com to create the bot and qyapi.weixin.qq.com to confirm it, and holds a long connection to openws.work.weixin.qq.com while it is bound so the bot can receive messages. The bot secret and anything waiting to be delivered are encrypted in this plugin's own data directory and never leave the plugin." }, "zh-CN": { "name": "企业微信", "description": "用企业微信扫码，或填写机器人 ID 与密钥，把企业微信机器人绑定到这台电脑。", "safetyNotes": "会访问 work.weixin.qq.com 创建机器人，并访问 qyapi.weixin.qq.com 校验；绑定期间会与 openws.work.weixin.qq.com 保持一条长连接以接收消息。机器人密钥与待投递的消息都加密保存在本插件自己的数据目录里，不会离开插件。" }, "ja": { "name": "WeCom", "description": "WeCom アプリで QR コードをスキャンするか、ボット ID とシークレットを入力して、WeCom ボットをこのコンピューターにバインドします。", "safetyNotes": "ボットの作成に work.weixin.qq.com、確認に qyapi.weixin.qq.com へアクセスし、バインド中はボットがメッセージを受信できるよう openws.work.weixin.qq.com への長接続を保持します。ボットのシークレットと配信待ちの内容は、このプラグイン独自のデータディレクトリに暗号化して保存され、プラグインの外に出ることはありません。" } }, "categories": [ "messaging" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.im-wecom", "docs": { "zh-CN": { "intro": "企业微信频道把企业微信机器人接到这台电脑上：你在企业微信里给机器人发消息，助手在绑定的会话里干完活，回复回到企业微信。绑定有两条路——用企业微信扫码创建机器人（推荐），或者填写已有的机器人 ID 与机器人密钥。\n\n收消息靠一条由插件主动向外建立的长连接，绑定期间一直保持，本机不开端口、不需要公网回调。语音消息以平台给出的转写文本作为正文；图片和文件会在入队前先下载到插件自己的数据目录，宿主看到的是一条带着全部附件的消息。\n\n回复可以是文本，也可以带上一轮产出的文件。机器人密钥与还在等待投递的内容都加密保存在插件自己的数据目录里，不会离开插件。\n\n你能用它做什么：\n\n- 在企业微信里给机器人发一句话，开任务或接着之前的任务。\n- 扫码创建机器人并自动完成配置，不用手工建应用。\n- 已经有机器人时填机器人 ID 与机器人密钥，保存时校验一次。\n- 收图片、文件与语音转写，回复文本或本轮产出的文件。\n", "install": "本插件随应用提供并默认启用。如果你卸载了它，可以在这里重新安装，并把配置从头配一遍。\n开箱可用：频道随应用提供，不需要 Node、npm 或额外服务。你需要平台侧的一个企业微信机器人和一次绑定。机器人密钥用 AES-256-GCM 加密保存在插件自己的数据目录（`credentials.enc`，密钥 `key.bin` 权限 0600，目录 0700），宿主只看得到绑定状态和掩码后的标识；创建机器人访问 `work.weixin.qq.com`，校验访问 `qyapi.weixin.qq.com`，绑定期间的长连接指向 `openws.work.weixin.qq.com`。**不要把机器人密钥贴进对话**——它只填在「IM 频道」的配置对话框里。macOS 上建议授予「完全磁盘访问权限」，避免频道使用中反复弹出文件访问确认。\n\n没有需要填写的设置项：凭据与「消息发送到」的目标都在「IM 频道」页的配置对话框里选。\n\n首次验证：\n\n1. 打开「IM 频道」，在「企业微信」一栏点「配置」，用企业微信扫码完成机器人创建（「快捷绑定（推荐）」）；已有机器人时切到「手动配置」，填机器人 ID 与机器人密钥，点「保存并验证」。\n2. 绑定成功后选「消息发送到」：新建任务（会话）、新建任务（指定项目），或一个已有会话。\n3. 在企业微信里给机器人发「你好，用一句话说说你能做什么」——桌面应用侧栏出现该任务，回复回到企业微信。\n\n常见安装失败：\n\n- **扫码创建失败**：机器人可能已经存在但没启用；先在企业微信管理后台启用机器人，再重新扫码，或改用手动配置填机器人 ID 与密钥。\n- **保存并验证失败**：机器人 ID 或密钥不对；密钥在重置后会变，重置后回来重新填一次。\n- **收消息有延迟、回复偶尔发不出**：长连接会因网络抖动重连，重连期间的消息可能延迟；先确认本机网络与代理不拦截长连接，持续异常就解绑再绑定一次。\n", "usage": "三个常见用法：\n\n1. **在企业微信里派活**：「把这份周报的要点整理成三条发我」。消息进入绑定的会话，助手按该会话的权限模式跑完一轮，回复发回企业微信。\n2. **直接发素材**：「（发一张截图）看看这个界面哪里有问题」。图片会先落到插件数据目录再作为附件进入会话，助手看图回答。\n3. **要一份文件**：「把统计结果导出成表格，发给我」。本轮产出的文件随回复一起发出，超出大小或数量上限时会有通知。\n\n入口是「IM 频道」页（侧栏底部）：企业微信一行显示「未配置」「已配置」或「凭证已失效」，点「配置」走扫码或手动配置，点「解绑」清掉凭证。消息接入方式固定为：插件在长连接上收到回调后先落盘，宿主按节拍取走并提交到你选定的会话，回复再用同一条通道发回企业微信。\n\n不要指望它做什么：\n\n- 不会替你批准操作：消息按普通提示词在绑定会话里运行，继承该会话的权限模式；需要确认的写操作仍要在桌面应用里等你点同意。\n- 不会在本机开端口，也不保存明文密钥：收消息只靠插件主动建立的长连接，密钥与待投递内容都是加密存储。\n- 不会自己转写语音：语音消息用平台给出的转写文本，平台没有给出文本时就没有正文；一个频道也只投递到一个会话，不会同时分发多处。\n" }, "ja": { "intro": "WeCom チャンネルは企業微信（WeCom）のボットをこのコンピューターにつなぎます。WeCom でボットにメッセージを送ると、アシスタントがバインド済みセッションで作業し、返信が WeCom に戻ります。バインドは 2 通りで、WeCom でスキャンしてボットを作成する（推奨）か、既にお持ちのボット ID とボットシークレットを入力します。\n\n受信はプラグインが外向きに開き、バインド中は保持する長接続で行うため、このコンピューター上で待ち受けるものはなく、公開コールバックも不要です。音声メッセージはプラットフォームが返す書き起こしを本文として扱います。画像とファイルはキューに入れる前にプラグイン独自のデータディレクトリへダウンロードされるため、ホストは添付をすべて伴った 1 通のメッセージとして受け取ります。\n\n返信はテキスト、またはそのターンで生成されたファイルを伴うテキストです。ボットシークレットと配信待ちの内容はプラグイン独自のデータディレクトリに暗号化して保存され、プラグインの外に出ることはありません。\n\nできること:\n\n- WeCom でボットに一言送り、タスクを開始したり前のタスクを続けたりします。\n- スキャンでボットを作成し、設定までプラグインに任せられます。手作業でアプリを作る必要はありません。\n- 既にボットがある場合はボット ID とシークレットを入力し、保存時に検証します。\n- 画像、ファイル、音声の書き起こしを受け取り、テキストまたはそのターンのファイルで返信します。\n", "install": "このプラグインはアプリに同梱され、既定で有効です。削除した場合はここから再インストールし、あらためて設定してください。\nすぐに使えます。アプリをインストールすればこのチャンネルがあり、Node や npm、追加サービスは不要です。必要なのはプラットフォーム側の WeCom ボットと、1 回のバインドです。ボットシークレットは AES-256-GCM でプラグイン独自のデータディレクトリに暗号化して保存され（`credentials.enc`、鍵ファイル `key.bin` は 0600、ディレクトリは 0700）、ホストが見られるのはバインド状態とマスクされた識別子だけです。ボットの作成は `work.weixin.qq.com`、検証は `qyapi.weixin.qq.com`、バインド中に保持する長接続は `openws.work.weixin.qq.com` に接続します。**ボットシークレットをチャットに貼らないでください**。入力する場所は「IM チャンネル」の設定ダイアログです。macOS では「フルディスクアクセス」を許可すると、チャンネル使用中のファイルアクセス確認が繰り返されません。\n\n記入が必要な設定項目はありません。認証情報と「メッセージの送信先」はどちらも「IM チャンネル」ページの設定ダイアログで選びます。\n\n最初の確認:\n\n1. 「IM チャンネル」を開き、「WeCom」の行の「設定」を押して WeCom でスキャンし、ボットを作成します（「クイックバインド（推奨）」）。既にボットがある場合は「手動設定」に切り替え、ボット ID とボットシークレットを入力して「保存して検証」を押します。\n2. バインドに成功したら「メッセージの送信先」を選びます。新しいタスク（会話）、プロジェクト内の新しいタスク、既存の会話のいずれかです。\n3. WeCom でボットに「こんにちは。一言で何ができるか教えて」と送ると、デスクトップのサイドバーにタスクが現れ、返信が WeCom に戻ります。\n\nよくある導入の失敗:\n\n- **スキャンでボットを作成できない**: ボットが既に存在して無効になっている可能性があります。WeCom の管理コンソールで有効化してから再スキャンするか、手動設定でボット ID とシークレットを入力してください。\n- **保存して検証に失敗する**: ボット ID かシークレットが違います。シークレットはリセットで変わるため、新しい値を入力して保存し直してください。\n- **メッセージが遅れる、返信が時々失敗する**: 長接続はネットワークの乱れで再接続し、その間のメッセージが遅れることがあります。ローカルのネットワークやプロキシが長接続を遮断していないか確認し、続く場合はバインドし直してください。\n", "usage": "よくある 3 つの依頼:\n\n1. **WeCom から仕事を渡す**: 「この週報の要点を 3 つにまとめて送って」。メッセージはバインド済みセッションに入り、アシスタントはそのセッションの権限モードで 1 ターン実行し、返信が WeCom に戻ります。\n2. **素材をそのまま送る**: 「（スクリーンショットを送信）この画面のどこが問題？」画像はまずプラグインデータディレクトリに保存され、添付としてセッションに入り、アシスタントが画像について回答します。\n3. **ファイルを受け取る**: 「集計結果を表計算にして送って」。そのターンのファイルは返信とともに送られ、サイズや件数の上限を超えると通知されます。\n\n入口はサイドバーの「IM チャンネル」ページです。WeCom の行に「未設定」「設定済み」「認証情報が無効です」のいずれかが表示され、「設定」でスキャンまたは手動設定、「バインド解除」で認証情報を削除できます。メッセージの流れは常に同じです。プラグインが長接続で受け取ったコールバックを先に保存し、ホストが一定間隔で取り出して選択したセッションに渡し、返信は同じ経路で WeCom に戻ります。\n\n期待しないでください:\n\n- 操作の代行承認: メッセージはバインド済みセッションで通常のプロンプトとして実行され、そのセッションの権限モードを継承します。承認が必要な書き込みは従来どおりデスクトップアプリで待機します。\n- ポートの待ち受けや平文のシークレット保存: 受信はプラグインが開く長接続だけで、シークレットも配信待ちの内容も暗号化して保存されます。\n- 音声の自前の書き起こし: 音声メッセージはプラットフォームが返す書き起こしを使うため、テキストが無ければ本文もありません。また 1 つのチャンネルは 1 つの会話にのみ配信し、複数へ同時配信はしません。\n" }, "en": { "intro": "The WeCom channel connects a WeCom bot to this computer: you send a message to the bot in WeCom, the assistant works in the bound session, and the reply goes back to WeCom. Binding takes one of two roads — scan in WeCom to create the bot (recommended), or enter an existing bot id and bot secret.\n\nMessages arrive over a long connection the plugin opens outwards and holds while bound, so nothing on this computer listens and no public callback is needed. A voice message arrives with the platform's transcript as its text; images and files are downloaded into the plugin's own data directory before the message is queued, so the host sees one message with all of its attachments.\n\nA reply can be text, or text plus the files a turn produced. The bot secret and anything still waiting to be delivered are encrypted in the plugin's own data directory and never leave the plugin.\n\nWhat you can do with it:\n\n- Send one message to the bot in WeCom to start a task or continue the previous one.\n- Create the bot by scanning and let the plugin configure it, instead of building an app by hand.\n- Enter an existing bot id and secret, with a verification step when you save.\n- Receive images, files and voice transcripts, and reply with text or the files a turn produced.\n", "install": "This plugin ships with the app and is on by default. If you removed it, install it here to bring it back, then set it up again.\nIt works out of the box: the channel is there once the app is installed, with no Node, npm or extra service. What you need is a WeCom bot on the platform side and one binding. The bot secret is encrypted with AES-256-GCM in this plugin's own data directory (`credentials.enc`, key file `key.bin` with mode 0600, directory 0700), and the host only ever sees the binding state and a masked identifier. Creating the bot talks to `work.weixin.qq.com`, verification to `qyapi.weixin.qq.com`, and the long connection held while bound goes to `openws.work.weixin.qq.com`. **Do not paste the bot secret into the chat** — it belongs in the IM channels configuration dialog. On macOS, granting the app Full Disk Access avoids the repeated file-access prompts while a channel is in use.\n\nThere are no settings to fill in: the credential and the \"send messages to\" target both live in the configuration dialog on the IM channels page.\n\nFirst verification:\n\n1. Open \"IM channels\", click \"Configure\" on the WeCom row and scan in WeCom to create the bot (\"Quick bind (recommended)\"); with an existing bot, switch to \"Manual setup\", enter the bot id and the bot secret and click \"Save and verify\".\n2. After the binding succeeds, choose \"Send messages to\": a new task (conversation), a new task in a project, or an existing conversation.\n3. Send \"hello, tell me in one sentence what you can do for me\" to the bot in WeCom — the task appears in the desktop sidebar and the reply comes back to WeCom.\n\nCommon install failures:\n\n- **Scanning fails to create the bot**: the bot may already exist but be disabled; enable it in the WeCom admin console and scan again, or use manual setup with the bot id and secret.\n- **Save and verify fails**: the bot id or the secret is wrong; a reset changes the secret, so enter the new one and save again.\n- **Messages are delayed or a reply occasionally fails**: the long connection reconnects after network trouble and messages can be late during the reconnect; check that the local network and proxy do not block long connections, and rebind if it keeps happening.\n", "usage": "Three common things to ask for:\n\n1. **Hand over work in WeCom**: \"Turn this weekly report into three bullet points and send them to me.\" The message enters the bound session, the assistant runs a turn under that session's permission mode, and the reply goes back to WeCom.\n2. **Send the material directly**: \"(sends a screenshot) what looks wrong in this screen?\" The image lands in the plugin data directory first and enters the session as an attachment, and the assistant answers about it.\n3. **Ask for a file**: \"Export the result as a spreadsheet and send it to me.\" Files from the turn go out with the reply, and a notice appears when one exceeds the size or count limit.\n\nThe entry point is the IM channels page in the sidebar: the WeCom row shows \"Not configured\", \"Configured\" or \"Credentials invalid\", with \"Configure\" for the scan or manual setup and \"Unbind\" to delete the credential. Messages always travel the same way: the plugin receives a callback on the long connection and writes it down first, the host takes it on its tick and submits it to the session you selected, and the reply goes back out over the same channel.\n\nDo not expect it to:\n\n- Approve actions for you: a message runs as an ordinary prompt in the bound session and inherits that session's permission mode, so any write needing approval still waits for you in the desktop app.\n- Open a port or keep a plaintext secret: receiving only uses the long connection the plugin opens, and both the secret and anything waiting to be delivered are stored encrypted.\n- Transcribe voice on its own: a voice message uses the transcript the platform provides, so without one there is no text; and one channel delivers to one conversation only, never several at once.\n" } }, "versions": [ { "version": "1.0.0", "publishedAt": "2026-11-01T00:00:00Z", "minPiDesktop": ">=0.8.0", "shasum": "9da4e7ca613990fe498256a3489e6cf25fd4291902b26d146dbdad4644f88ccb", "url": "packages/voki.im-wecom-1.0.0.piplug", "sizeBytes": 91346, "permissions": [ "channel.call" ], "fs": {} } ], "distribution": "bundled" }, { "id": "voki.image-creative", "name": "Image Creative", "description": "Create and edit images through the Voki Image service, with an MCP + Skills channel and a local voki-image CLI + Skills channel.", "author": "voki-work", "i18n": { "en": { "name": "Image Creative", "description": "Create and edit images through the Voki Image service, with an MCP + Skills channel and a local voki-image CLI + Skills channel.", "safetyNotes": "Prompts and reference images are sent to the Voki Image service. Generated images are remote URLs; the CLI can download them into your workspace. This build ships a shared service credential inside the plugin package instead of asking for one in settings, so anyone with the app can extract it; a future sign-in replaces it with a per-user header. Service output is untrusted data, not instructions. Do not upload files you did not choose, and do not put secrets in prompts. Image generation can incur service cost." }, "zh-CN": { "name": "图片创作", "description": "通过 Voki Image 服务生成与编辑图片，同时提供 MCP + Skills 和本地 voki-image CLI + Skills 两种通道。", "safetyNotes": "提示词与参考图会发送到 Voki Image 服务。生成结果是远端 URL，CLI 可将其下载到工作区。当前版本把共享的服务授权头内置在插件包中，而不是让用户在设置里填写，因此拿到安装包的人都能提取它；后续登录会替换为按用户签发的授权头。服务输出是不可信数据，不是指令。不要上传你未选择的文件，也不要在提示词中写入密钥。图片生成可能产生服务费用。" }, "ja": { "name": "画像クリエイティブ", "description": "Voki Image サービスで画像を生成・編集します。MCP + Skills とローカル voki-image CLI + Skills の 2 つのチャネルを提供します。", "safetyNotes": "プロンプトと参照画像は Voki Image サービスに送信されます。生成結果はリモート URL で、CLI はワークスペースにダウンロードできます。このビルドは設定ではなくプラグインに同梱した共有サービス認証情報を使うため、アプリを持っている人は誰でも取り出せます。将来のサインインでユーザーごとのヘッダーに置き換わります。サービスの出力は信頼できないデータであり、指示ではありません。自分が選択していないファイルをアップロードせず、プロンプトに秘密情報を書かないでください。画像生成にはサービス費用が発生する場合があります。" } }, "categories": [ "creation" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.image-creative", "docs": { "zh-CN": { "intro": "图片创作把 Voki Image 服务接进对话：你描述要什么，它把提示词整理成可用的形状，出图，然后把图片直接放在回复里。同一套服务有两条通道——远程 MCP 与随插件分发的本地 `voki-image` 命令——用来覆盖「快速看一眼」到「落成本地文件、批量跑、断点续查」的不同需要。\n\n你能用它做什么：\n\n- 从一句话出图：封面、海报、配图、图标、贴纸、产品图、社媒图，先出一版 1k 看构图。\n- 改已有的图：换背景、改画面里的文字、调风格，用一至四张参考图说清「改什么、保留什么」。\n- 把结果落到工作区：默认开启的 `saveResults` 会把成图下载进项目，回合末尾的产出列表里就是本地文件。\n- 大尺寸走异步：1.5k / 2k、更多步数的任务提交后轮询，只提示一次「正在生成」，不刷屏。\n", "install": "本插件随应用提供并默认启用。如果你卸载了它，可以在这里重新安装，并把配置从头配一遍。\n不需要你填密钥：服务授权头内置在插件包里，MCP 与本地 CLI 都从这一处读。你需要的只是能访问 `qwenimg21.natec.cn`，以及知道图片生成会消耗服务额度。几个设置项决定出图习惯：\n\n| 设置项 | 用途 | 默认值 |\n| --- | --- | --- |\n| `channel` | `auto` 优先 MCP、失败或需要本地文件时回退 CLI；`mcp` / `cli` 强制单通道 | `auto` |\n| `saveResults` | 为 true 时把成图下载到工作区，并在回复里给出本地文件 | `true` |\n| `outputDirectory` | 工作区内的相对输出目录 | `image-creative` |\n| `defaultResolution` | 默认分辨率档：`1k` 最快，`1.5k` 平衡，`2k` 小字最好但最慢 | `1k` |\n| `defaultRatio` | 请求里没写尺寸或比例时使用 | `1:1` |\n| `jobWaitSeconds` | CLI 轮询异步任务的时长上限，30–600 秒 | `180` |\n\n首次验证：\n\n1. 在对话里说「生成一张 16:9 的图，白色背景上一个蓝色圆，右下角写 `Voki`」；\n2. 回复应当以图片开头，后面跟尺寸、seed、耗时和保存路径；\n3. 到工作区的 `image-creative/` 目录里确认那张图真的在本地；\n4. 想先确认连通性又不想出图，可以让助手跑一次 `doctor`：它只做 MCP 握手并列出可用工具。\n\n常见安装失败：\n\n- **报授权缺失或被拒绝**：内置授权头没打进安装包，或被服务轮换了。更新或重装桌面应用；不要把 token 填进设置、提示词或命令里。\n- **看不到图片工具**：先让助手用 `ToolSearch` 精确搜一次工具名；仍然没有时检查插件是否启用，以及 `channel` 是否被设成了 `cli`。\n- **提示 CLI 不存在**：安装包里的 `voki-image` 没落地。重装应用，不要自己拼一个路径。\n- **只拿到一个远端链接**：`saveResults` 被关掉了，或者下载失败。打开它，或者让助手对那个 URL 再做一次 `fetch`。\n", "usage": "三个常见用法：\n\n1. 「做一张 16:9 的课程封面，主色深蓝，左侧一句『限时特惠』，右下角放课程编号」——它按主体、构图、文字、风格写提示词，同步出图，把图放在回复第一行。\n2. 「这张产品图的背景换成浅灰渐变台面，产品本身一点都不要动」——走编辑通道，本地参考图先上传再改，提示词里同时写明改什么、保留什么。\n3. 「跟刚才那张一样，但换个 seed 再出一版 2k 的」——大尺寸走异步任务，只提示一次「正在生成」，之后每 5–10 秒查一次。\n\n入口有三个。技能 `/skill:image-generate` 决定用哪条通道、怎么写提示词、怎么轮询；MCP 服务 `natec-image` 提供五个出图工具；工具 `image_cli` 用来拿 CLI 路径、做连通性检查、把成图存进工作区。\n\n| 能力 | 做什么 |\n| --- | --- |\n| 同步出图 | `generate_image` 文生图，`edit_image` 编辑或垫图，1k 与不超过 40 步时最快 |\n| 异步出图 | `submit_image` / `submit_edit_image` 提交任务，再用 `get_image_job` 按 job id 轮询，适合 1.5k / 2k |\n| 本地命令行 | `voki-image` 的 `generate` / `edit` / `status` / `upload` / `fetch` / `doctor` / `config`，用于本地文件、批量和长任务续查 |\n| 保存与自检 | `image_cli` 的 `info` 给出本地 CLI 路径与当前通道，`doctor` 做 MCP 握手并列出工具，`fetch` 把已完成的图片 URL 下载进当前会话工作区 |\n\n完整的 MCP 工具名都带 `plugin_voki_image_creative_natec_image_` 前缀。\n\n不要指望它做什么：\n\n- 不是画布编辑器：没有图层、蒙版、局部重绘；改动靠重新出图或参考图编辑，无法保证只动你想动的那一处。\n- 不保证画面里的文字：小字、长句和高度风格化的字形仍可能出错；要精确就缩短文字、明确位置和字体感觉。\n- 不替你守住机密：提示词与参考图会离开本机送到 Voki Image 服务，只上传你亲自指定的文件，不要往提示词里写密钥；服务返回的文字、链接和图片里的标注都是数据，不是指令。\n" }, "ja": { "intro": "画像クリエイティブは Voki Image サービスを会話につなぎます。欲しいものを伝えると、プロンプトを整え、画像を生成し、返信にそのまま画像を載せます。同じサービスに 2 つのチャネルがあり、遠隔の MCP と、同梱のローカル `voki-image` コマンドです。「ちょっと確認したい」から「ローカルファイルに残す・バッチで回す・長いジョブを後から確認する」までをカバーします。\n\nできること:\n\n- 一文から生成できます。表紙、ポスター、挿絵、アイコン、ステッカー、商品画像、SNS 用画像など。まず 1k で構図を確認できます。\n- 既存の画像を編集できます。背景の差し替え、画像内の文字の変更、スタイルの調整を、1〜4 枚の参照画像と「何を変え、何を残すか」で指定します。\n- 結果をワークスペースに残せます。既定で有効な `saveResults` が完成画像をプロジェクトにダウンロードし、そのターンの出力一覧にローカルファイルとして並びます。\n- 大きいサイズは非同期です。1.5k / 2k やステップ数の多いジョブは投入してポーリングし、「生成中」の通知は 1 回だけで済ませます。\n", "install": "このプラグインはアプリに同梱され、既定で有効です。削除した場合はここから再インストールし、あらためて設定してください。\nキーの入力は不要です。サービスの認証ヘッダーはプラグインに同梱され、MCP とローカル CLI の両方がそこから読みます。必要なのは `qwenimg21.natec.cn` へ到達できることと、画像生成がサービスの枠を消費するという理解です。挙動はいくつかの設定で決まります。\n\n| 設定項目 | 用途 | 既定値 |\n| --- | --- | --- |\n| `channel` | `auto` は MCP を優先し、失敗時やローカルファイルが必要なときに CLI へ切り替え。`mcp` / `cli` は単一チャネルを強制 | `auto` |\n| `saveResults` | true のとき完成画像をワークスペースにダウンロードし、返信でローカルファイルを示す | `true` |\n| `outputDirectory` | CLI が画像を保存するワークスペース内の相対ディレクトリ | `image-creative` |\n| `defaultResolution` | 既定の解像度。`1k` が最速、`1.5k` はバランス、`2k` は小さい文字に強いが最も遅い | `1k` |\n| `defaultRatio` | 依頼にサイズも比率も無いときに使う | `1:1` |\n| `jobWaitSeconds` | 非同期ジョブの CLI ポーリング上限、30〜600 秒 | `180` |\n\n最初の確認:\n\n1. 会話で「16:9 で、白背景に青い円、右下に `Voki` と入った画像を作って」と伝えます。\n2. 返信が画像で始まり、そのあとにサイズ、seed、所要時間、保存先が続くはずです。\n3. ワークスペースの `image-creative/` にそのファイルが実際にあることを確認します。\n4. 生成せずに接続だけ確認したい場合は、エージェントに `doctor` を実行させます。MCP ハンドシェイクと利用可能なツール一覧だけを行います。\n\nよくある導入のつまずき:\n\n- **認証が無い、拒否されたと表示される**: 同梱の認証ヘッダーがパッケージに入っていないか、サービス側で更新されています。デスクトップアプリを更新または再インストールしてください。トークンを設定・プロンプト・コマンドに貼らないでください。\n- **画像ツールが見えない**: まずエージェントに `ToolSearch` で正確なツール名を 1 回検索させます。それでも無い場合は、プラグインが有効か、`channel` が `cli` になっていないかを確認します。\n- **CLI が存在しないと表示される**: 同梱の `voki-image` が配置されていません。アプリを再インストールしてください。パスを自作しないでください。\n- **リモートのリンクだけが返る**: `saveResults` が無効か、ダウンロードに失敗しています。有効にするか、その URL を一度 `fetch` させてください。\n", "usage": "よくある 3 つの頼み方:\n\n1. 「16:9 の講座表紙を作って。メインカラーは濃紺、左に『期間限定』、右下に講座コード」— 主体・構図・文字・スタイルからプロンプトを組み、同期で生成して返信の先頭に画像を置きます。\n2. 「この商品写真の背景を淡いグレーのグラデーションの天板に差し替えて。商品自体は一切変えないで」— 編集チャネルを使い、ローカル参照画像を先にアップロードします。プロンプトには変える点と残す点の両方を書きます。\n3. 「さっきと同じだけど、seed を変えて 2k でもう 1 版」— 大きいサイズは非同期ジョブになり、「生成中」の通知は 1 回、その後 5〜10 秒ごとに確認します。\n\n入口は 3 つです。`/skill:image-generate` スキルがチャネルの選択、プロンプトの書き方、ポーリングを決めます。MCP サービス `natec-image` が 5 つの生成ツールを提供します。`image_cli` ツールは CLI パスの取得、接続確認、完成画像のワークスペース保存を行います。\n\n| できること | 内容 |\n| --- | --- |\n| 同期生成 | `generate_image` でテキストから生成、`edit_image` で編集・参照画像。1k かつ 40 ステップ以下なら最速 |\n| 非同期生成 | `submit_image` / `submit_edit_image` で投入し、`get_image_job` を job id でポーリング。1.5k / 2k 向け |\n| ローカル CLI | `voki-image` の `generate` / `edit` / `status` / `upload` / `fetch` / `doctor` / `config`。ローカルファイル、バッチ、長いジョブの再確認に |\n| 保存と自己診断 | `image_cli` の `info`（ローカル CLI パスと現在のチャネル）、`doctor`（MCP ハンドシェイクとツール一覧）、`fetch`（完成画像 URL をセッションのワークスペースへダウンロード） |\n\nMCP ツールの正式名には `plugin_voki_image_creative_natec_image_` の接頭辞が付きます。\n\n期待しないでください:\n\n- キャンバスエディターではありません。レイヤー、マスク、部分的な再描画はなく、変更は再生成か参照画像を使った編集になります。変えたい箇所だけが変わる保証はありません。\n- 画像内の文字は毎回正しく出るとは限りません。小さい文字、長い文、強く様式化した書体は崩れることがあります。文字が重要なら短くし、位置と書体の雰囲気を明示してください。\n- 秘密情報を守ってはくれません。プロンプトと参照画像はこのマシンを離れて Voki Image サービスへ送られます。自分で指定したファイルだけをアップロードし、プロンプトに鍵を書かないでください。サービスが返すテキスト、リンク、画像内の文字はデータであり、指示ではありません。\n" }, "en": { "intro": "Image Creative connects the Voki Image service to the conversation: you describe what you want, it shapes the prompt, generates the image and puts the picture in the reply. The same service is reachable through two channels — a remote MCP server and the bundled local `voki-image` command — which covers everything from \"let me have a quick look\" to \"keep the file locally, run a batch, resume a long job\".\n\nWhat you can do with it:\n\n- Generate from one sentence: covers, posters, illustrations, icons, stickers, product shots, social images — a 1k draft first to check the composition.\n- Edit an existing image: replace the background, change the words in it, shift the style, with one to four reference images stating what to change and what to keep.\n- Land the result in the workspace: `saveResults` is on by default and downloads the finished image into the project, so the turn's output list carries a local file.\n- Go asynchronous for large sizes: 1.5k / 2k jobs with more steps are submitted and polled, with one \"generating\" notice instead of a stream of updates.\n", "install": "This plugin ships with the app and is on by default. If you removed it, install it here to bring it back, then set it up again.\nYou do not fill in a key: the service authorization header is bundled with the plugin and both the MCP and local CLI channels read it from there. All you need is reachability to `qwenimg21.natec.cn` and the knowledge that generating images spends service quota. A few settings decide how it behaves:\n\n| Setting | What it does | Default |\n| --- | --- | --- |\n| `channel` | `auto` prefers MCP and falls back to the CLI on failure or when a local file is needed; `mcp` / `cli` force one channel | `auto` |\n| `saveResults` | When true, finished images are downloaded into the workspace and the reply names the local file | `true` |\n| `outputDirectory` | Workspace-relative directory the CLI saves images into | `image-creative` |\n| `defaultResolution` | Default resolution: `1k` fastest, `1.5k` balanced, `2k` best for small text but slowest | `1k` |\n| `defaultRatio` | Used when the request names neither a size nor a ratio | `1:1` |\n| `jobWaitSeconds` | CLI polling budget for async jobs, 30–600 seconds | `180` |\n\nFirst check:\n\n1. In the conversation, say \"generate a 16:9 image with a blue circle on a white background and `Voki` in the lower right\";\n2. The reply should lead with the image, followed by size, seed, elapsed time and the saved path;\n3. Confirm that file really exists under `image-creative/` in the workspace;\n4. To check connectivity without spending a generation, ask the assistant to run `doctor` — it only does the MCP handshake and lists the available tools.\n\nCommon setup failures:\n\n- **It reports the authorization is missing or rejected**: the bundled header is absent from the package, or the service rotated it. Update or reinstall the desktop app; never paste a token into settings, prompts or commands.\n- **No image tool is visible**: have the assistant run `ToolSearch` once with the exact tool name; if it is still missing, check that the plugin is enabled and that `channel` is not set to `cli`.\n- **It reports the CLI does not exist**: the bundled `voki-image` did not land. Reinstall the app; do not assemble a path by hand.\n- **You only get a remote link**: `saveResults` is off, or the download failed. Turn it on, or have the assistant `fetch` that URL once.\n", "usage": "Three common things to ask for:\n\n1. \"Make a 16:9 course cover, deep blue as the main colour, 'Limited offer' on the left, the course code in the lower right\" — it writes a prompt for subject, composition, text and style, generates synchronously, and leads the reply with the image.\n2. \"Replace this product shot's background with a light grey gradient tabletop, and do not touch the product itself\" — this goes through edit, uploading the local reference first, with the prompt stating both what changes and what stays.\n3. \"Same as the last one, but a new seed and 2k this time\" — larger sizes run as async jobs, with one \"generating\" notice and a check every 5–10 seconds.\n\nThere are three entry points. The `/skill:image-generate` skill decides which channel to use, how to write the prompt and how to poll; the `natec-image` MCP server provides five generation tools; the `image_cli` tool returns the CLI path, checks connectivity and saves a finished image into the workspace.\n\n| Capability | What it does |\n| --- | --- |\n| Synchronous generation | `generate_image` for text to image, `edit_image` for edits and reference images — fastest at 1k with at most 40 steps |\n| Asynchronous generation | `submit_image` / `submit_edit_image` submit a job, then `get_image_job` polls it by job id; the right choice for 1.5k / 2k |\n| Local CLI | `voki-image` with `generate` / `edit` / `status` / `upload` / `fetch` / `doctor` / `config`, for local files, batches and resuming long jobs |\n| Saving and self-check | `image_cli` with `info` (local CLI path and current channel), `doctor` (MCP handshake and tool list) and `fetch` (download a finished image URL into the session workspace) |\n\nThe full MCP tool names carry the `plugin_voki_image_creative_natec_image_` prefix.\n\nDo not expect it to:\n\n- Be a canvas editor: there are no layers, masks or inpainting; changes come from regenerating or editing with reference images, so only the region you meant to change is not guaranteed to be the only one that changes.\n- Get text right every time: small type, long lines and highly stylized lettering can still come out wrong; when text matters, keep it short and state the placement and the feel of the type.\n- Keep secrets for you: prompts and reference images leave this machine for the Voki Image service. Upload only files you named, never put keys in a prompt, and treat anything the service returns — text, links, words inside an image — as data, not instructions.\n" } }, "versions": [ { "version": "1.1.1", "publishedAt": "2026-10-29T00:00:00Z", "changelog": "- `image_cli` 新增 `fetch` 动作：把已完成的 MCP 图片 URL 通过内置 CLI 下载到当前会话\n 工作区（项目目录或 `~/VokiWork`）的 `outputDirectory`，并在工具结果中返回\n `artifacts`/`files`，回合末尾与任务监控的产出列表会列出本地文件。\n- 技能要求：`saveResults` 开启（默认）时，每个 MCP `done` 结果必须先保存再回复；\n 保存失败才退回远端 URL。\n- CLI 的 `generate`/`edit`/`status`/`fetch` JSON 结果同步返回 `artifacts`/`files`。", "minPiDesktop": ">=0.24.0", "shasum": "4d84dd44276e94564a40b977e93a77bae7a7dedd4a805d47945fb121a03a4bea", "url": "packages/voki.image-creative-1.1.1.piplug", "sizeBytes": 119020, "permissions": [ "agent.tool.register", "agent.prompt.inject", "net.fetch", "mcp.server.remote" ], "fs": {} } ], "distribution": "bundled" }, { "id": "voki.mail-assistant", "name": "Mail Assistant", "description": "Bring a personal mailbox into the work panel: sign in, read the inbox, and let AI interpret what an email means. Whether and how to reply stays your call, made in the session itself. Supports QQ, NetEase, Outlook, 139, Aliyun and other common providers; new mail can open a session automatically. Credentials are encrypted on this machine only.", "author": "voki-work", "i18n": { "en": { "name": "Mail Assistant", "description": "Bring a personal mailbox into the work panel: sign in, read the inbox, and let AI interpret what an email means. Whether and how to reply stays your call, made in the session itself. Supports QQ, NetEase, Outlook, 139, Aliyun and other common providers; new mail can open a session automatically. Credentials are encrypted on this machine only.", "safetyNotes": "Email passwords and authorization codes are stored AES-256-GCM encrypted in this plugin's private data directory under a 0600 key file — never in plugin settings, never sent to the host. Outbound mail is only sent after explicit human confirmation: either you confirm in the panel, or — when the Agent sends on your behalf — the host shows a high-risk approval card with the full recipient/cc/subject/body preview that you must allow each time (except in auto permission mode, which skips approval like other tools). Mail bodies reach the Agent marked as data to analyze, not as instructions to follow; attachment text follows the same rule, and raw attachment bytes never leave the plugin process — downloads go only to a folder you pick in the native picker, and Agent-sent attachments are local files you named and confirmed. Network access is limited to the mail servers you configure plus Microsoft's sign-in endpoints. Envelope metadata for the message list (subject, sender, recipients, date, read flag, attachment flag) is kept in a local SQLite database (mail.db, with its -wal file, both mode 0600) inside this plugin's private data directory, stored in plaintext so the list can be paged, searched and grouped into conversations. Message bodies and attachment bytes never enter that database, and removing an account deletes that account's local mail with it." }, "zh-CN": { "name": "邮件助手", "description": "把个人邮箱接进工作面板：登录后查看收件箱，让 AI 解读邮件要点；是否回复、如何回复由你在会话里自行决定。支持 QQ、网易、Outlook、139、阿里云等常见邮箱；新邮件可自动建会话展开处理。凭据在本机加密保存，不经宿主、不上传。", "safetyNotes": "邮箱密码与授权码以 AES-256-GCM 加密存放在本插件私有数据目录下的 0600 密钥文件中，绝不写入插件设置、绝不经宿主可见、绝不上传。发信只在人工明确确认后执行：要么你在面板中确认，要么由 Agent 代发时宿主弹出高风险审批卡（卡上展示收件人/抄送/主题/正文全文预览），你逐次点「允许」才发出——唯一例外是会话处于 auto 权限模式时跳过审批（与其他工具的全局语义一致）。交给 Agent 的正文会被显式标注为「待分析的数据」而非「要执行的指令」；附件文本同样按不可信数据处理，附件原始字节不出插件进程——下载只写进你在原生选择器里亲自选定的文件夹，Agent 发信附带的文件必须是你点名并确认过的本地文档。网络访问仅限你配置的邮件服务器，以及微软登录端点。邮件列表的「信封」（主题、发件人、收件人、时间、已读状态、有无附件）保存在本插件私有目录下的本地 SQLite 库（mail.db，与 -wal 文件权限均为 0600），**明文存储**——这是为了让列表能分页、搜索与按会话聚合；正文与附件字节绝不入库，解绑账号时该账号的本地邮件一并删除。" }, "ja": { "name": "メールアシスタント", "description": "個人メールボックスをワークパネルに接続します。サインインして受信トレイを確認し、AI にメールの内容を解釈してもらえます。返信するかどうか、どのように返信するかは、セッション内でご自身が判断できます。QQ、NetEase、Outlook、139、Alibaba Cloud などの一般的なメールサービスに対応し、新着メールからセッションを自動で開くこともできます。認証情報はこのコンピューター上で暗号化して保存され、ホストを経由せず、アップロードされません。", "safetyNotes": "メールのパスワードと認証コードは、このプラグイン専用のデータディレクトリにある 0600 の鍵ファイルで AES-256-GCM 暗号化して保存されます。プラグイン設定には書き込まれず、ホストにも送信されず、アップロードもされません。メールの送信は、人間が明示的に確認した場合にのみ実行されます。パネルで確認するか、Agent が代理送信する場合はホストが受信者・Cc・件名・本文のプレビューを含む高リスク承認カードを表示し、その都度「許可」を選ぶ必要があります（auto 権限モードでは他のツールと同様に承認を省略します）。Agent に渡される本文は、従うべき指示ではなく分析対象のデータとして明示されます。添付ファイルのテキストも信頼できないデータとして扱われ、添付ファイルの生バイトはプラグインプロセスの外に出ません——ダウンロードはユーザーがネイティブピッカーで自ら選んだフォルダーにのみ書き込まれ、Agent が送信に添付するファイルはユーザーが名指しで確認したローカル文書でなければなりません。ネットワークアクセスは、設定したメールサーバーと Microsoft のサインインエンドポイントに限定されます。メール一覧のエンベロープ情報（件名、送信者、受信者、日時、既読フラグ、添付フラグ）は、このプラグイン専用データディレクトリ内のローカル SQLite データベース（mail.db、-wal ファイルとも パーミッション 0600）に**平文**で保存されます。一覧のページング・検索・スレッド表示に必要なためです。本文と添付ファイルのバイト列は保存されず、アカウントを解除するとそのローカルメールも削除されます。" } }, "categories": [ "office" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.mail-assistant", "docs": { "zh-CN": { "intro": "邮件助手把个人邮箱接进工作面板：登录后看收件箱、按需读全文、让 AI 说明一封邮件到底要你做什么。它不替你回复——是否回、怎么回由你在会话里决定。\n\n读信和发信是两件不同的事。读只给信封（主题、发件人、时间、预览），要正文得单独取；发是另一个工具，风险等级 high，逐次确认。\n\n你能用它做什么：\n\n- 定时把收件箱收进本地邮件库，面板先给本地结果再刷新，点开过的信再看不联网。\n- 让助手把一封长邮件压成要点，指出对方要你确认的那几件事。\n- 在会话里起草回复或新邮件，你核过收件人、抄送、主题与正文之后才发出。\n- 抽取附件文本（pdf / docx / txt 等）供分析，附件原始字节不出插件进程。\n", "install": "本插件不随安装包提供，安装后才可用。卸载之后可以在这里重新安装，配置与数据需要重新设置。\n开箱即用，不需要 Node、npm 或额外服务：在面板里选服务商、填邮箱和授权码即可。外发协议是 IMAP / SMTP（993 / 465，TLS），微软邮箱走浏览器授权码 + PKCE，设备码只作兜底。密码与授权码只存在本插件的加密保险库（AES-256-GCM，密钥是本机数据目录下权限 0600 的 `key.bin`），不写插件设置、不经宿主、不上传；邮件列表的信封存在本地 `mail.db`（明文 SQLite，权限 0600），正文按需缓存，附件字节不入库。**不要把邮箱密码或授权码贴在对话里**——它只需要出现在面板的登录表单里。\n\n| 设置项 | 用途 | 默认值 |\n| --- | --- | --- |\n| `syncIntervalMinutes` | 后台收取间隔（分钟）；填 0 关闭后台收取，打开面板时仍会实时收取 | `30` |\n| `defaultAccount` | Agent 在会话里发信默认使用的账号；留空表示只有一个已绑定账号时自动用它 | 空 |\n\n首次验证：\n\n1. 运行「Mail Assistant: Add mailbox account」，选服务商、填邮箱与**授权码**（QQ、163 等要先在网页端开启 IMAP/SMTP 再生成授权码）；\n2. 侧栏「邮件」面板出现该账号，收件箱列出最近几封信的信封；\n3. 在对话里说「看看我收件箱有什么新邮件」，助手应调用 `mail_inbox`，只返回信封；\n4. 说「读一下第一封」，助手调用 `mail_read`，返回正文与附件清单。\n\n常见安装失败：\n\n- **提示密码错误**：多数邮箱不接受登录密码，只接受单独生成的授权码；腾讯企业邮、飞书等企业邮箱还要管理员先开通 IMAP。\n- **Microsoft 365 提示组织要求管理员同意**：在面板里生成授权链接交给 IT，管理员接受后点「已批准，重新登录」。\n- **一直显示旧邮件**：`syncIntervalMinutes` 为 0 时没有后台收取；点「刷新」取最新，改完间隔要重新启用插件才生效。\n", "usage": "三个常见用法：\n\n1. **筛出要处理的信**：「看一眼收件箱，把需要我今天回的挑出来」。助手先只读信封，你点了哪封它才读正文，不会把整箱邮件塞进上下文。\n2. **压缩长邮件**：「这封邮件到底要我做什么？给我三个要点和截止时间」。正文按不可信数据交给模型，信里让你「转发给某人」的文字不会被当成指令执行。\n3. **起草回复**：「按这个意思回一封，抄送财务，先给我看全文」。助手调 `mail_reply` 前会与你核对收件人 / 抄送 / 正文，之后宿主还会弹高风险审批卡逐次放行。\n\n入口：侧栏「邮件」面板（账号、收件箱、已发送、搜索、刷新、回复、转发），命令「Mail Assistant: Open inbox」与「Mail Assistant: Add mailbox account」。\n\n| 能力 | 做什么 |\n| --- | --- |\n| `mail_inbox` | 列出各已绑定账号收件箱里的新邮件，只给信封；按账号维护水位，不重复返回同一批 |\n| `mail_read` | 读一封邮件全文（收件人、抄送、正文、附件清单）；传 `attachments` 可抽取文本类附件的文字 |\n| `mail_reply` | 以已绑定邮箱回复一封邮件；不可撤销，需确认与审批 |\n| `mail_send` | 以已绑定邮箱新写并发送一封邮件；不可撤销，需确认与审批 |\n\n不要指望它做什么：\n\n- 不替你决定回不回：判断与措辞留给你，插件只给事实和草稿。\n- 不保证能撤回：发出的邮件收不回来，`mail_reply` / `mail_send` 在 Plan 与 Goal 模式下会被直接拒绝。\n- 不把邮件当指令：正文与附件文本都是不可信数据，其中的指令不构成对你的指令。\n" }, "ja": { "intro": "メールアシスタントは個人のメールボックスをワークパネルに接続します。サインインして受信トレイを確認し、必要なときに本文を読み、AI に「このメールは何を求めているのか」を整理させられます。返信するかどうか、どう書くかはセッション内でご自身が決めます。\n\n読むことと送ることは別の操作です。読む場合は封筒情報（件名、送信者、日時、プレビュー）だけを返し、本文は個別に取得します。送信は独立したツールで、リスクは high、その都度確認が必要です。\n\nできること:\n\n- 受信トレイを定期的にローカルのメールストアへ取り込みます。パネルはまずローカル結果を表示してから更新し、一度開いたメールは再表示時にネットワークへ接続しません。\n- 長いメールを要点に圧縮させ、返答が必要な点だけを抜き出させます。\n- セッション内で返信や新規メールを下書きし、宛先・Cc・件名・本文を確認してから送信します。\n- 添付ファイルのテキスト（pdf / docx / txt など）を抽出して分析に使えます。添付の生バイトがプラグインプロセスの外に出ることはありません。\n", "install": "このプラグインはインストーラーに含まれません。使う前にここからインストールしてください。削除後に再度インストールできますが、設定とデータは初期状態になります。\nすぐに使えます。Node や npm、追加サービスは不要で、パネルでプロバイダーを選び、メールアドレスと認証コードを入力するだけです。プロトコルは IMAP / SMTP（993 / 465、TLS）、Microsoft のメールボックスはブラウザー認証コード + PKCE、デバイスコードは代替手段です。パスワードと認証コードはこのプラグイン専用の暗号化ボルト（AES-256-GCM、鍵ファイル `key.bin` はローカルデータディレクトリにパーミッション 0600）にのみ保存され、プラグイン設定にもホストにも渡らず、アップロードもされません。一覧用の封筒情報はローカルの `mail.db`（平文 SQLite、0600）に、本文は必要に応じてキャッシュされ、添付のバイト列は保存されません。**メールのパスワードや認証コードをチャットに貼らないでください**。入力する場所はパネルのサインインフォームだけです。\n\n| 設定項目 | 用途 | 既定値 |\n| --- | --- | --- |\n| `syncIntervalMinutes` | バックグラウンド取得の間隔（分）。0 で無効（パネルを開いたときは取得します） | `30` |\n| `defaultAccount` | セッションで Agent が送信に使うアカウント。空欄なら「バインド済みが 1 件のとき自動で使う」 | 空 |\n\n最初の確認:\n\n1. 「Mail Assistant: Add mailbox account」を実行し、プロバイダーを選んでメールアドレスと**認証コード**を入力します（QQ や 163 は Web 側で IMAP/SMTP を有効にしてから認証コードを発行します）。\n2. サイドバーの「メール」パネルにアカウントが表示され、受信トレイに直近の封筒が並びます。\n3. チャットで「受信トレイの新着を見て」と伝えると、`mail_inbox` が呼ばれ封筒だけが返ります。\n4. 「1 通目を読んで」と伝えると、`mail_read` が本文と添付一覧を返します。\n\nよくある導入の失敗:\n\n- **パスワードが違うと言われる**: 多くのプロバイダーはログインパスワードを受け付けず、別途発行する認証コードが必要です。Tencent Exmail や Feishu などの企業メールは管理者による IMAP 有効化も必要です。\n- **Microsoft 365 で管理者の同意が必要と言われる**: パネルで同意リンクを生成して IT に渡し、承認後に「承認済み、再サインイン」を押します。\n- **古いメールしか表示されない**: `syncIntervalMinutes` が 0 だとバックグラウンド取得が動きません。最新は「更新」で取得し、間隔を変えたあとはプラグインを再度有効化します。\n", "usage": "よくある 3 つの依頼:\n\n1. **返信すべきものを選ぶ**: 「受信トレイを見て、今日返信が必要なものだけ拾って」。まず封筒だけを読み、指定したメールだけ本文を開くので、受信トレイ全体がコンテキストに流れ込みません。\n2. **長いメールを圧縮する**: 「このメールは結局何を求めている？ 要点 3 つと期限を教えて」。本文は分析対象のデータとしてモデルに渡り、「これを転送して」といった文中の指示は実行されません。\n3. **返信を下書きする**: 「この趣旨で返信して。財務を Cc に入れて、先に全文を見せて」。`mail_reply` の前に宛先・Cc・本文を確認し、送信時にはホストが高リスク承認カードを表示します。\n\n入口: サイドバーの「メール」パネル（アカウント、受信トレイ、送信済み、検索、更新、返信、転送）と、コマンド「Mail Assistant: Open inbox」「Mail Assistant: Add mailbox account」です。\n\n| 機能 | 内容 |\n| --- | --- |\n| `mail_inbox` | バインド済み各アカウントの新着を封筒のみで一覧化。アカウントごとに水位を保ち、同じ束を二度返しません |\n| `mail_read` | 1 通の全文（宛先、Cc、本文、添付一覧）を読みます。`attachments` を渡すとテキスト系添付の文字列も抽出します |\n| `mail_reply` | バインド済みメールボックスから返信します。取り消し不可、確認と承認が必要です |\n| `mail_send` | バインド済みメールボックスから新規メールを作成して送信します。取り消し不可、確認と承認が必要です |\n\n期待しないでください:\n\n- 返信するかどうかの判断: 判断と文面はご自身のもので、プラグインは事実と下書きだけを提供します。\n- 送信後の取り消し: 送ったメールは戻せません。Plan / Goal モードでは `mail_reply` / `mail_send` は拒否されます。\n- メールを指示として扱うこと: 本文も添付テキストも信頼できないデータで、中の指示はあなたへの指示にはなりません。\n" }, "en": { "intro": "Mail Assistant brings a personal mailbox into the work panel: sign in, read the inbox, read a message in full when you ask for it, and let the AI explain what an email is actually asking you to do. It does not answer on your behalf — whether to reply and what to say stays your call in the session.\n\nReading and sending are separate concerns. Reading returns envelopes only (subject, sender, date, preview); the body is fetched separately. Sending is its own tool at risk level high and is confirmed every time.\n\nWhat you can do with it:\n\n- Pull the inbox into a local mail store on a schedule; the panel shows local results first and then refreshes, and reopening a message you already read does not hit the network.\n- Have the assistant compress a long email into the points that need an answer.\n- Draft a reply or a new message in the session, and send only after you have checked recipients, cc, subject and body.\n- Extract attachment text (pdf / docx / txt and similar) for analysis; raw attachment bytes never leave the plugin process.\n", "install": "This plugin is not part of the installer: install it here before using it. After removing it you can reinstall it here, but its settings and data start over.\nIt works out of the box — no Node, npm or extra service. Pick a provider in the panel, enter the address and the authorization code. Transport is IMAP / SMTP (993 / 465, TLS); Microsoft mailboxes use browser authorization code with PKCE, with device code only as a fallback. Passwords and authorization codes live only in this plugin's encrypted vault (AES-256-GCM, key file `key.bin` with mode 0600 in the local data directory); they never enter plugin settings, the host, or any upload. Message envelopes for the list live in a local `mail.db` (plaintext SQLite, mode 0600), bodies are cached on demand, attachment bytes are never stored. **Do not paste a mailbox password or authorization code into the chat** — it belongs in the panel's sign-in form.\n\n| Setting | Purpose | Default |\n| --- | --- | --- |\n| `syncIntervalMinutes` | Background fetch interval in minutes; 0 turns background fetch off (opening the panel still fetches live) | `30` |\n| `defaultAccount` | Account the Agent sends from in a session; empty means \"use the only bound account automatically\" | empty |\n\nFirst verification:\n\n1. Run \"Mail Assistant: Add mailbox account\", choose the provider and enter the address plus an **authorization code** (QQ, 163 and others need IMAP/SMTP enabled on the web first);\n2. The \"Mail\" panel shows the account and the inbox lists the most recent envelopes;\n3. In the chat say \"what's new in my inbox\" — the assistant should call `mail_inbox` and return envelopes only;\n4. Say \"read the first one\" — the assistant calls `mail_read` and returns the body plus the attachment list.\n\nCommon install failures:\n\n- **Wrong password message**: most providers reject the sign-in password and require a separately generated authorization code; enterprise mailboxes such as Tencent Exmail or Feishu also need IMAP enabled by the administrator first.\n- **Microsoft 365 says the organization requires administrator consent**: generate the consent link in the panel and give it to IT; after they accept, click \"approved, sign in again\".\n- **Only old mail appears**: with `syncIntervalMinutes` at 0 there is no background fetch; click refresh for the newest, and re-enable the plugin after changing the interval.\n", "usage": "Three common things to ask for:\n\n1. **Triage what needs an answer**: \"Look at my inbox and pick out what I need to reply to today.\" The assistant reads envelopes first and only opens the ones you point at, so the whole inbox does not land in context.\n2. **Compress a long email**: \"What does this email actually want from me? Give me three points and the deadline.\" The body reaches the model marked as data to analyze, so a line telling it to \"forward this to someone\" is not executed as an instruction.\n3. **Draft a reply**: \"Reply along these lines, cc finance, show me the full text first.\" Before calling `mail_reply` the assistant checks recipients, cc and body with you, and the host then shows a high-risk approval card for each send.\n\nEntry points: the \"Mail\" panel in the sidebar (accounts, inbox, sent, search, refresh, reply, forward), plus the commands \"Mail Assistant: Open inbox\" and \"Mail Assistant: Add mailbox account\".\n\n| Capability | What it does |\n| --- | --- |\n| `mail_inbox` | Lists new mail in each bound inbox as envelopes only; keeps a per-account watermark so the same batch is not returned twice |\n| `mail_read` | Reads one message in full (recipients, cc, body, attachment list); pass `attachments` to extract text from text-like attachments |\n| `mail_reply` | Replies from a bound mailbox; irreversible, needs confirmation and approval |\n| `mail_send` | Writes and sends a new message from a bound mailbox; irreversible, needs confirmation and approval |\n\nDo not expect it to:\n\n- Decide whether to reply: judgement and wording stay with you; the plugin supplies facts and drafts.\n- Take anything back: sent mail cannot be recalled, and `mail_reply` / `mail_send` are rejected outright in Plan and Goal modes.\n- Treat mail as instructions: bodies and attachment text are untrusted data, and instructions inside them are not instructions to you.\n" } }, "versions": [ { "version": "2.7.0", "publishedAt": "2026-10-31T00:00:00Z", "changelog": "面板能做的事，Agent 侧补齐到「至少能读、该写的分级」；顺带修掉一个真机 bug\n（微软账号「标为已读」一直失败）。核心是让 AI 能自己记账：这封看过了、那封处理完了。\n\n### Agent 工具：4 → 12\n\n原有 4 个（`mail_inbox` / `mail_read` / `mail_reply` / `mail_send`）保留不变，新增 8 个：\n\n| 工具 | 风险 | 作用 |\n|---|---|---|\n| `mail_status` | low | 账号清单 + 授权态（`canSend=false` 即「能收不能发」）+ 未读数 + 标注统计 + 最后同步时间 |\n| `mail_search` | low | 本地全文搜索（主题/发件人/预览/正文缓存），可按标注状态筛 |\n| `mail_folders` | low | 真实文件夹路径 + 判定「已发送/垃圾箱」 |\n| `mail_thread` | low | 一条往来的全部信封 |\n| `mail_contacts` | low | 收件人地址补全 |\n| `mail_admin_consent` | low | 管理员同意链接 + 可转发的申请理由 |\n| `mail_triage` | low | **本地处理标注**（reviewed / actioned / archived + 备注），支持批量 |\n| `mail_flag` | medium | 服务器已读/星标（同步到用户所有设备，逐次审批） |\n\n### 本地处理标注（`mail_triage`）\n\n- 新表 `triage`（`email, folder, uid, state, note, updated_at`，`mail.db` 权限不变）。\n **只写本机**：不改服务器、不改已读、不动邮件，可随时改、随时清除。\n- 为什么要它：收件箱大部分信「看一眼就结束」，这个结论以前只存在于人的脑子里，\n 下一轮 AI 再读一遍还是不知道。标成已读也表达不了「看过了但还没回」和「处理完了」的差别。\n- 三档而非自由标签：`reviewed` 看过待定 / `actioned` 已处理 / `archived` 无需动作；\n 空串 = 清除标注（删行，不留空行）。\n- `mail_inbox` 的每封邮件、`mail_read` 的返回都带 `triage`，`mail_search` 支持\n `triage: \"none\"` 找「还没标注的」——这就是「还有哪些没处理」的查询方式。\n- 邮件在服务器侧消失/解绑账号时，标注行一并清理，不留孤儿。\n\n### 修复\n\n- **微软账号「标为已读/未读」必然失败**（`lib/oauth-ms.js`）：`setMessageFlags` 用**请求体**\n 去拼返回值 `body.flag.flagStatus`，而面板只传 `seen` 时 `body.flag` 是 undefined →\n TypeError → 面板显示「操作失败」。改成只回报真的改过的字段，并优先取服务端回执。\n 面板 2026-10-28 记的「点了毫无变化」里，有这一半的原因。\n- `mail_read` 的报错文案还在提早已不存在的 `list_recent`，改为 `mail_inbox` / `mail_search`。\n\n### 技能\n\n- 新增 `skills/mail-inbox.md`（查收与标注）与 `skills/mail-send.md`（发信与授权），\n 并补 `agent.prompt.inject` 权限——**缺这个权限宿主会静默忽略技能**。\n- 技能的作用不只是文档：读插件技能会一次性激活该插件名下全部工具\n （`agent-runtime` 的 `skillPluginTools`，且不受 12 个激活上限约束）。\n 没有技能时，12 个工具只能靠截断到 120 字的目录 + ToolSearch 撞。\n\n### 测试\n\n- `test/mail-assistant-integration.test.mjs`：工具面 4 → 12 的断言更新；新增 5 个用例\n （status 授权态含 canSend=null 反向、triage 可写可筛可清且不碰服务器、flag 真实\n PATCH 与短 id 拒绝、四个只读工具、**manifest ↔ registerTool 契约**）。\n 该文件 64 → 69 项，全绿。\n- 契约测试同时校验技能文件存在且带 `name`/`description` front matter。", "minPiDesktop": ">=0.8.0", "shasum": "39539f0db2798582119a0ace16e1e0dd611f39a5e25618cc03a4e6101eae0d53", "url": "packages/voki.mail-assistant-2.7.0.piplug", "sizeBytes": 6032250, "permissions": [ "ui.view", "ui.panel", "clipboard.read", "clipboard.write", "desktop.control", "shell.openExternal", "net.fetch", "agent.tool.register", "agent.prompt.inject", "fs.read", "background.service" ], "fs": {} } ], "distribution": "marketplace" }, { "id": "voki.microsoft365-app", "name": "Microsoft 365 Workspace", "description": "Brings SharePoint sites and lists, OneDrive files, Teams channels, people and licences, and mail into one workspace, with dry-run first and an audit trail for every write.", "author": "voki-work", "i18n": { "en": { "name": "Microsoft 365 Workspace", "description": "Brings SharePoint sites and lists, OneDrive files, Teams channels, people and licences, and mail into one workspace, with dry-run first and an audit trail for every write.", "safetyNotes": "The plugin talks only to Microsoft Graph and the Microsoft identity platform, using your own Entra app registration. Sign-in tokens and client secrets are encrypted in this plugin's private vault; the default device-key mode protects against accidental copying, not against a malicious program running as you. Bulk or destructive writes run only after a dry run you confirm, and every call is written to a local audit log. Messages posted to Teams channels or mail sent on your behalf cannot be recalled." }, "zh-CN": { "name": "Microsoft 365 工作台", "description": "把 SharePoint 站点与列表、OneDrive 文件、Teams 频道、人员与许可证、邮件收进一个工作台；写操作先出预演，并留审计。", "safetyNotes": "插件只访问 Microsoft Graph 与 Microsoft 身份平台，并使用你自己的 Entra 应用注册。登录令牌与客户端密钥加密保存在本插件私有保险库；默认设备密钥模式可防止误拷贝，但不承诺抵御以你的身份运行的恶意程序。批量或破坏性写入必须先预演并经你确认，每次调用都会写入本地审计日志。以你的名义发出的 Teams 频道消息与邮件无法撤回。" }, "ja": { "name": "Microsoft 365 ワークスペース", "description": "SharePoint サイトとリスト、OneDrive のファイル、Teams チャネル、ユーザーとライセンス、メールを 1 つのワークスペースに集約。書き込みは必ずドライラン後に実行し、監査ログを残します。", "safetyNotes": "プラグインは Microsoft Graph と Microsoft ID プラットフォームにのみ接続し、お客様自身の Entra アプリ登録を使用します。サインイン トークンとクライアント シークレットはプラグイン専用の暗号化ボルトに保存されます。既定のデバイスキー方式は誤コピーを防ぎますが、同じユーザーとして動く悪意あるプログラムには耐えません。破壊的な書き込みはドライランと確認の後にのみ実行され、すべての呼び出しは監査ログに記録されます。Teams チャネルへの投稿と代理送信したメールは取り消せません。" } }, "categories": [ "office" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.microsoft365-app", "docs": { "zh-CN": { "intro": "Microsoft 365 工作台把 SharePoint 站点与列表、OneDrive 与文档库文件、Teams 频道、人员与许可证、邮件收进一个面板，并给 Agent 一套按读写分级的工具：读随时可用，写先出预演，执行后留审计。\n\n它用你自己的 Entra 应用注册，只访问 Microsoft Graph 与 Microsoft 身份平台。令牌与客户端密钥加密存在本插件的私有保险库；默认设备密钥模式防误拷贝，但不承诺抵御以你的身份运行的恶意程序。\n\n你能用它做什么：\n\n- 搜站点、翻列表、按 OData 过滤与字段选择读条目，不必手写 Graph 语法。\n- 把当前列表视图导出为 CSV，落到工作区的 `m365/` 目录。\n- 让助手按当前值（ETag）改一条列表项，改之前先看预演。\n- 查频道最近的对话、查某人的许可证、读自己的邮件。\n", "install": "本插件不随安装包提供，安装后才可用。卸载之后可以在这里重新安装，配置与数据需要重新设置。\n需要三样东西：一个 Microsoft 365 租户、一个你自己创建的 Entra 应用注册、一次在浏览器里完成的设备代码登录（或改用应用身份 + 客户端密钥）。没有本机依赖，也不装命令行工具。令牌与密钥存在插件私有数据目录的保险库（AES-256-GCM），每次 Graph 调用写一行本地 JSONL 审计。**客户端密钥只在面板的设置表单里录入，不要贴在对话里。**\n\n最小权限按你要做的事给：只读先给 `User.Read`、`Sites.Read.All`、`Files.Read.All`、`Team.ReadBasic.All`、`ChannelMessage.Read.All`、`Mail.Read`；要写列表项再加 `Sites.ReadWrite.All`，要改文件内容再加 `Files.ReadWrite.All`，要发频道消息加 `ChannelMessage.Send`，要发信加 `Mail.Send`，要读组织信息加 `Organization.Read.All`。写工具默认 `dryRun`，只有显式传 `dryRun: false` 才真的发请求；`enableWrites` 是总开关，`allowMailSend` 与 `allowGenericGraph` 默认关闭。\n\n| 设置项 | 用途 | 默认值 |\n| --- | --- | --- |\n| `tenantId` | 租户 ID 或域名；`organizations` 表示任意工作账号租户 | `organizations` |\n| `clientId` | 你自建 Entra 应用的客户端 ID；设备代码流需启用公共客户端 | 空 |\n| `authMode` | `deviceCode` 以你的身份登录；`clientSecret` 以应用身份运行 | `deviceCode` |\n| `cloudEnvironment` | `public`、`usgov`、`usgovhigh`、`usgovdod`、`china`，端点随所选云切换 | `public` |\n| `defaultSiteUrl` | 默认 SharePoint 站点；留空时每次操作都要显式给出站点 | 空 |\n| `pageSize` | 分页请求的每页条数，1–200 | `50` |\n| `requestTimeoutMs` | 单次请求超时，5000–120000 毫秒 | `30000` |\n| `maxRetryAttempts` | 429 / 503 限流重试次数，0–5，仅对幂等请求 | `2` |\n| `allowGenericGraph` | 允许 Agent 对白名单前缀发起只读 GET | `false` |\n| `allowMailSend` | 允许真正发信；关闭时 `m365_mail_send` 只做预演 | `false` |\n| `enableWrites` | 写操作总开关；关闭后所有写工具与面板写操作只预演 | `true` |\n| `auditRetentionDays` | 审计文件保留天数，1–365，下一次写入时清理过期文件 | `30` |\n\n首次验证：\n\n1. 在 Entra 管理中心创建应用注册，启用公共客户端，添加所需的 Graph 委托权限（需要管理员同意的先同意）；\n2. 把应用（客户端）ID 填进 `clientId`，运行「Connect a tenant」，在浏览器里完成设备代码登录；\n3. 回到面板「概览」，确认已登录账号、云环境与授予的 scope 与预期一致；\n4. 运行「Browse sites」搜一个站点并打开它的列表，能读出条目即算打通。\n\n常见安装失败：\n\n- **登录提示需要管理员同意**：委托权限如 `Sites.Read.All` 需要租户管理员同意一次，普通用户自己点不掉。\n- **写操作只返回预演**：`enableWrites` 被关掉，或工具调用没带 `dryRun: false`；发信还要单独打开 `allowMailSend`。\n- **403 或端点打不开**：`cloudEnvironment` 与租户所在的云不一致（例如世纪互联租户要选 `china`），或应用缺少对应权限。\n- **频繁 429**：`maxRetryAttempts` 只重试 429 / 503 的幂等请求，翻页太快时把 `pageSize` 调小。\n", "usage": "三个常见用法：\n\n1. **查列表数据**：「在财务站点里找出上个月金额大于一万的报销条目，只给我单号和金额」。助手先用 `search_sites` 定位站点，再用 `filter` 与 `select` 只取必要字段。\n2. **改一条记录**：「把这条任务的负责人改成张三，先给我看预演」。写操作默认预演，返回它准备发出的请求；你确认后它才用当前 ETag 真写，值变了会失败而不是覆盖。\n3. **发频道消息或邮件**：「把这个结论发到运维团队的公告频道，先预演」。发消息与发信都是 high 风险，消息发出后无法撤回，发信还要 `allowMailSend` 已打开。\n\n入口：侧栏「Microsoft 365」面板（概览、SharePoint、文件、Teams、人员、邮件、审计、设置八个分区）；命令「Open workspace」「Connect a tenant」「Browse sites」「Export list items」「Connection settings」。\n\n| 能力 | 做什么 |\n| --- | --- |\n| `m365_status` | 看连接状态：已登录账号、云环境、已授予 scope、写开关与保险库状态，不返回令牌 |\n| `m365_auth` | 管理租户连接：发起或轮询设备代码、添加应用密钥连接、列出、退出登录 |\n| `m365_sharepoint` | 读：搜站点、按 URL 定位站点、列列表、读条目（分页、过滤、字段选择） |\n| `m365_files` | 读：列文件夹、按路径取文件、搜索、给二进制文件取预签名下载链接 |\n| `m365_teams` / `m365_people` / `m365_mail` | 读：加入的团队与频道消息、用户与许可证与组织信息、邮件列表与单封邮件 |\n| `m365_item_write` | 写：建、改、删列表项，默认预演，改删要带当前 ETag |\n| `m365_file_share` / `m365_content` | 写：建或撤共享链接；读写 UTF-8 文本文件内容，默认预演 |\n| `m365_team_message` / `m365_mail_send` | 写：发频道消息、发邮件，默认预演，发出后无法撤回 |\n| `m365_graph` | 受开关保护的通用只读 GET，仅限白名单前缀 |\n| `m365_audit` | 读本地审计日志，按时间倒序 |\n\n不要指望它做什么：\n\n- 不读你的磁盘：插件没有 `fs.read`，二进制内容不经过插件进程，下载链接交给系统浏览器。\n- 不绕过 Graph 权限：工具只能在应用已授予的 scope 内工作，超范围就是 403。\n- 不保证能撤回：频道消息与邮件发出即不可撤回，开关与审批只是事前控制。\n- 不处理非 UTF-8 文本：`m365_content` 只读写 UTF-8 文本，Office 二进制文件不在范围内。\n" }, "ja": { "intro": "Microsoft 365 ワークスペースは、SharePoint のサイトとリスト、OneDrive とドキュメントライブラリのファイル、Teams のチャネル、ユーザーとライセンス、メールを 1 つのパネルに集約し、Agent には読み取りと書き込みで分けたツール群を渡します。読み取りはいつでも使え、書き込みはまずドライランを返し、実行後は監査に残ります。\n\nお客様自身の Entra アプリ登録を使い、接続先は Microsoft Graph と Microsoft ID プラットフォームだけです。サインイン トークンとクライアント シークレットはプラグイン専用の暗号化ボルトに保存されます。既定のデバイスキー方式は誤コピーを防ぎますが、同じユーザーとして動く悪意あるプログラムには耐えません。\n\nできること:\n\n- Graph の構文を手で書かずに、サイトを検索し、リストを辿り、OData のフィルターとフィールド選択で項目を読めます。\n- 現在のリスト ビューを CSV としてワークスペースの `m365/` フォルダーに書き出せます。\n- 現在の ETag に基づいてリスト項目を更新させられます。実行前にドライランを確認できます。\n- チャネルの最近の会話、あるユーザーのライセンス、自分のメールを確認できます。\n", "install": "このプラグインはインストーラーに含まれません。使う前にここからインストールしてください。削除後に再度インストールできますが、設定とデータは初期状態になります。\n必要なのは 3 つです。Microsoft 365 テナント、ご自身で作成する Entra アプリ登録、そしてブラウザーで 1 回完了するデバイス コード サインイン（またはアプリ自身の ID + クライアント シークレット）。ローカル依存もコマンドライン ツールも不要です。トークンとシークレットはプラグイン専用データディレクトリのボルト（AES-256-GCM）に保存され、Graph 呼び出しのたびにローカルの JSONL 監査ログへ 1 行記録します。**クライアント シークレットはパネルの設定フォームに入力してください。チャットに貼らないでください。**\n\n権限は必要な分だけ付与します。読み取りのみなら `User.Read`、`Sites.Read.All`、`Files.Read.All`、`Team.ReadBasic.All`、`ChannelMessage.Read.All`、`Mail.Read`。リスト項目の書き込みには `Sites.ReadWrite.All`、ファイル内容の変更には `Files.ReadWrite.All`、チャネル投稿には `ChannelMessage.Send`、メール送信には `Mail.Send`、組織情報の参照には `Organization.Read.All` を追加します。書き込みツールは既定で `dryRun` で、`dryRun: false` を明示したときだけ実際に送信します。`enableWrites` は全体スイッチで、`allowMailSend` と `allowGenericGraph` は既定で無効です。\n\n| 設定項目 | 用途 | 既定値 |\n| --- | --- | --- |\n| `tenantId` | テナント ID またはドメイン。`organizations` は任意の仕事用アカウントのテナント | `organizations` |\n| `clientId` | ご自身の Entra アプリのクライアント ID。デバイス コード フローにはパブリック クライアントの有効化が必要 | 空 |\n| `authMode` | `deviceCode` はご自身として、`clientSecret` はアプリとして動作 | `deviceCode` |\n| `cloudEnvironment` | `public`、`usgov`、`usgovhigh`、`usgovdod`、`china`。エンドポイントは選択したクラウドに従う | `public` |\n| `defaultSiteUrl` | 既定の SharePoint サイト。空欄なら毎回サイトを明示する必要あり | 空 |\n| `pageSize` | ページング要求の件数、1〜200 | `50` |\n| `requestTimeoutMs` | 1 リクエストのタイムアウト、5000〜120000 ミリ秒 | `30000` |\n| `maxRetryAttempts` | 冪等な要求に対する 429 / 503 の再試行回数、0〜5 | `2` |\n| `allowGenericGraph` | 許可リストのプレフィックスに対する読み取り専用 GET を Agent に許可 | `false` |\n| `allowMailSend` | 実際の送信を許可。無効のとき `m365_mail_send` はドライランのみ | `false` |\n| `enableWrites` | 書き込みの全体スイッチ。無効のときは全書き込みツールとパネル操作がドライラン | `true` |\n| `auditRetentionDays` | 監査ファイルの保持日数、1〜365。期限切れは次の書き込み時に削除 | `30` |\n\n最初の確認:\n\n1. Entra 管理センターでアプリ登録を作成し、パブリック クライアントを有効化し、必要な Graph 委任権限を追加します（管理者同意が必要なものは先に同意）。\n2. アプリ（クライアント）ID を `clientId` に入力し、「Connect a tenant」を実行してブラウザーでデバイス コード サインインを完了します。\n3. パネルの「概要」に戻り、サインイン済みアカウント、クラウド、付与されたスコープが想定どおりか確認します。\n4. 「Browse sites」でサイトを検索し、リストを開いて項目が読めれば疎通確認は完了です。\n\nよくある導入の失敗:\n\n- **サインインで管理者の同意が必要と言われる**: `Sites.Read.All` などの委任権限はテナント管理者の同意が 1 回必要で、一般ユーザーだけでは完結しません。\n- **書き込みツールがドライランしか返さない**: `enableWrites` が無効か、呼び出しに `dryRun: false` が付いていません。メール送信は別途 `allowMailSend` の有効化が必要です。\n- **403 またはエンドポイントに到達できない**: `cloudEnvironment` がテナントのクラウドと一致していない（例: 21Vianet のテナントは `china`）か、アプリに権限が足りません。\n- **429 が頻発する**: `maxRetryAttempts` は 429 / 503 の冪等要求のみ再試行します。ページングが速すぎる場合は `pageSize` を下げてください。\n", "usage": "よくある 3 つの依頼:\n\n1. **リストを照会する**: 「財務サイトで先月の 1 万円超の経費項目を探して、番号と金額だけ教えて」。まず `search_sites` でサイトを特定し、`filter` と `select` で必要なフィールドだけを取得します。\n2. **1 件を更新する**: 「このタスクの担当を張三に変えて、先にドライランを見せて」。書き込みは既定でドライランとして送信内容を返し、確認後に現在の ETag で実書き込みします。値が変わっていれば上書きせず失敗します。\n3. **チャネル投稿やメール送信**: 「この結論を運用チームの告知チャネルに投稿して、先にドライラン」。投稿も送信も high リスクで、投稿したメッセージは取り消せません。メール送信には `allowMailSend` の有効化も必要です。\n\n入口: サイドバーの「Microsoft 365」パネル（概要、SharePoint、ファイル、Teams、ユーザー、メール、監査、設定の 8 セクション）と、コマンド「Open workspace」「Connect a tenant」「Browse sites」「Export list items」「Connection settings」です。\n\n| 機能 | 内容 |\n| --- | --- |\n| `m365_status` | 接続状態の確認: サインイン済みアカウント、クラウド、付与スコープ、書き込みスイッチ、ボルト状態。トークンは返しません |\n| `m365_auth` | テナント接続の管理: デバイス コードの開始とポーリング、アプリ シークレット接続の追加、一覧、サインアウト |\n| `m365_sharepoint` | 読み取り: サイト検索、URL からのサイト解決、リスト一覧、項目の読み取り（ページング、フィルター、フィールド選択） |\n| `m365_files` | 読み取り: フォルダー一覧、パス解決、検索、バイナリ ファイルの署名付きダウンロード リンク取得 |\n| `m365_teams` / `m365_people` / `m365_mail` | 読み取り: 参加チームとチャネル投稿、ユーザーとライセンスと組織情報、メール一覧と 1 通 |\n| `m365_item_write` | 書き込み: リスト項目の作成・更新・削除。既定はドライラン、更新と削除は現在の ETag が必要 |\n| `m365_file_share` / `m365_content` | 書き込み: 共有リンクの作成・削除、UTF-8 テキスト内容の読み書き。既定はドライラン |\n| `m365_team_message` / `m365_mail_send` | 書き込み: チャネル投稿、メール送信。既定はドライラン、送信後は取り消せません |\n| `m365_graph` | スイッチで保護された汎用の読み取り専用 GET。許可リストのプレフィックス限定 |\n| `m365_audit` | ローカル監査ログを新しい順に表示 |\n\n期待しないでください:\n\n- ディスクの読み取り: このプラグインに `fs.read` はなく、バイナリ内容がプラグインプロセスを通ることはありません。ダウンロード リンクはシステム ブラウザーに渡します。\n- Graph 権限の回避: ツールはアプリに付与されたスコープの範囲だけで動作し、超えると 403 になります。\n- 送信後の取り消し: チャネル投稿とメールは送信後に戻せません。スイッチと承認は事前の制御にすぎません。\n- UTF-8 以外のテキスト: `m365_content` は UTF-8 テキストのみ読み書きし、Office のバイナリ ファイルは対象外です。\n" }, "en": { "intro": "Microsoft 365 Workspace pulls SharePoint sites and lists, OneDrive and library files, Teams channels, people and licences, and mail into one panel, and gives the Agent a tool set split by read and write: reads are always available, writes return a dry run first, and every call is audited.\n\nIt uses your own Entra app registration and talks only to Microsoft Graph and the Microsoft identity platform. Sign-in tokens and client secrets are encrypted in the plugin's private vault; the default device-key mode protects against accidental copying, not against a malicious program running as you.\n\nWhat you can do with it:\n\n- Search sites, browse lists, read items with OData filters and field selection, without writing Graph syntax by hand.\n- Export the current list view as CSV into the workspace `m365/` folder.\n- Have the assistant change a list item against its current ETag, after showing you the dry run.\n- Read recent channel messages, check someone's licences, read your own mail.\n", "install": "This plugin is not part of the installer: install it here before using it. After removing it you can reinstall it here, but its settings and data start over.\nYou need three things: a Microsoft 365 tenant, an Entra app registration you create yourself, and one device code sign-in completed in the browser (or app-only identity with a client secret instead). No local dependencies, no command line tools. Tokens and secrets live in the vault under the plugin's private data directory (AES-256-GCM), and every Graph call writes one JSONL line to a local audit log. **The client secret goes into the panel's settings form, never into the chat.**\n\nGrant the least permission your work needs: for read-only, `User.Read`, `Sites.Read.All`, `Files.Read.All`, `Team.ReadBasic.All`, `ChannelMessage.Read.All`, `Mail.Read`; add `Sites.ReadWrite.All` to write list items, `Files.ReadWrite.All` to change file content, `ChannelMessage.Send` to post to channels, `Mail.Send` to send mail, and `Organization.Read.All` to read the organisation profile. Write tools default to `dryRun` and only send when `dryRun: false` is passed explicitly; `enableWrites` is the master switch, and `allowMailSend` and `allowGenericGraph` are off by default.\n\n| Setting | Purpose | Default |\n| --- | --- | --- |\n| `tenantId` | Tenant id or domain; `organizations` accepts any work account tenant | `organizations` |\n| `clientId` | Client id of your Entra app; the device code flow needs a public client | empty |\n| `authMode` | `deviceCode` signs in as you; `clientSecret` runs as the application | `deviceCode` |\n| `cloudEnvironment` | `public`, `usgov`, `usgovhigh`, `usgovdod`, `china`; endpoints follow the chosen cloud | `public` |\n| `defaultSiteUrl` | Default SharePoint site; when empty every call must name the site | empty |\n| `pageSize` | Page size for paged requests, 1–200 | `50` |\n| `requestTimeoutMs` | Per-request timeout, 5000–120000 ms | `30000` |\n| `maxRetryAttempts` | Retries for 429 / 503 on idempotent requests, 0–5 | `2` |\n| `allowGenericGraph` | Let the Agent issue read-only GETs against allow-listed prefixes | `false` |\n| `allowMailSend` | Allow real sending; while off, `m365_mail_send` only returns a dry run | `false` |\n| `enableWrites` | Master switch for writes; while off, every write tool and panel write is a dry run | `true` |\n| `auditRetentionDays` | Audit file retention, 1–365 days; expired files are cleaned on the next write | `30` |\n\nFirst verification:\n\n1. Create an app registration in the Entra admin center, enable the public client, and add the Graph delegated permissions you need (grant admin consent where required);\n2. Put the application (client) id into `clientId`, run \"Connect a tenant\", and finish the device code prompt in the browser;\n3. Back in the panel's overview, check that the signed-in account, cloud and granted scopes match what you expected;\n4. Run \"Browse sites\", open a site's list and read an item — that proves the path works.\n\nCommon install failures:\n\n- **Sign-in says administrator consent is required**: delegated permissions such as `Sites.Read.All` need a tenant administrator to consent once; a regular user cannot do it alone.\n- **Write tools only return a dry run**: `enableWrites` is off, or the call did not pass `dryRun: false`; sending mail also needs `allowMailSend` turned on.\n- **403 or unreachable endpoints**: `cloudEnvironment` does not match the tenant's cloud (a 21Vianet tenant needs `china`), or the app is missing the permission.\n- **Frequent 429**: `maxRetryAttempts` only retries idempotent 429 / 503 responses; lower `pageSize` if you page too fast.\n", "usage": "Three common things to ask for:\n\n1. **Query a list**: \"In the finance site, find expense items over ten thousand from last month and give me just the id and amount.\" The assistant resolves the site with `search_sites`, then uses `filter` and `select` to fetch only what is needed.\n2. **Change one record**: \"Change the owner on this task to Zhang San, show me the dry run first.\" Writes return the request they would send by default; only after you confirm does it write with the current ETag, and it fails rather than overwrites when the value moved.\n3. **Post to a channel or send mail**: \"Post this conclusion to the ops team announcement channel, dry run first.\" Posting and sending are both high risk; a posted message cannot be recalled, and mail also needs `allowMailSend`.\n\nEntry points: the \"Microsoft 365\" panel in the sidebar (eight sections: overview, SharePoint, files, Teams, people, mail, audit, settings); the commands \"Open workspace\", \"Connect a tenant\", \"Browse sites\", \"Export list items\", \"Connection settings\".\n\n| Capability | What it does |\n| --- | --- |\n| `m365_status` | Show connection state: signed-in account, cloud, granted scopes, write switches and vault state; never returns tokens |\n| `m365_auth` | Manage tenant connections: start or poll device code, add an app-secret connection, list, sign out |\n| `m365_sharepoint` | Read: search sites, resolve a site by URL, list lists, read items (paging, filters, field selection) |\n| `m365_files` | Read: list a folder, resolve a path, search, get a pre-authenticated download link for binary files |\n| `m365_teams` / `m365_people` / `m365_mail` | Read: joined teams and channel messages, users and licences and organisation profile, mail list and one message |\n| `m365_item_write` | Write: create, update, delete a list item; dry run by default, updates and deletes need the current ETag |\n| `m365_file_share` / `m365_content` | Write: create or remove a sharing link; read and write UTF-8 text file content, dry run by default |\n| `m365_team_message` / `m365_mail_send` | Write: post a channel message, send mail; dry run by default, cannot be recalled |\n| `m365_graph` | Generic read-only GET behind a switch, allow-listed path prefixes only |\n| `m365_audit` | Read the local audit log, newest first |\n\nDo not expect it to:\n\n- Read your disk: the plugin has no `fs.read`, binary content never passes through the plugin process, and download links go to the system browser.\n- Exceed Graph permissions: tools work only inside the scopes the app was granted; anything else is a 403.\n- Take anything back: channel messages and mail cannot be recalled once sent; switches and approvals are pre-flight controls only.\n- Handle non-UTF-8 text: `m365_content` reads and writes UTF-8 text only, and Office binary files are out of scope.\n" } }, "versions": [ { "version": "1.0.0", "publishedAt": "2026-11-01T00:00:00Z", "changelog": "- First release: tenant connections (device code and app-only client secret),\n SharePoint site and list browsing with OData paging, list item create/update/\n delete behind a dry run, drive browsing with pre-authenticated download links,\n UTF-8 text content read/write, sharing links, Teams channels and messages,\n directory people and licences, mail read and send, generic read-only Graph\n requests, and a local JSONL audit log.\n- Panel with eight sections (overview, SharePoint, files, Teams, people, mail,\n audit, settings) in English, Simplified Chinese and Japanese.\n- 14 Agent tools with read/write risk split; read tools declare plan-safe actions.", "minPiDesktop": ">=0.25.0", "shasum": "51ba4250eb8529507b9335ea1569a95aae5eff5b2f12faa40f9987fae3e54526", "url": "packages/voki.microsoft365-app-1.0.0.piplug", "sizeBytes": 419457, "permissions": [ "ui.panel", "ui.view", "notify", "clipboard.write", "shell.openExternal", "net.fetch", "agent.tool.register", "agent.prompt.inject", "fs.write" ], "fs": { "write": { "root": "workspace", "scope": [ "m365/**" ] } } } ], "distribution": "marketplace" }, { "id": "voki.prompt-enhancement", "name": "Prompt Enhancement", "description": "Rewrite the current Composer draft as a clearer enterprise-work prompt when you choose to run it, configured from the plugin's own settings panel.", "author": "voki-work", "i18n": { "en": { "name": "Prompt Enhancement", "description": "Rewrite the current Composer draft as a clearer enterprise-work prompt when you choose to run it, configured from the plugin's own settings panel.", "safetyNotes": "Sends the draft to the selected model provider only after you click the enhancement action. Does not read conversation history or file attachments. Reads the host's ready model list (no credentials) to fill the settings panel's model choice. Keeps settings and a last-run summary in the plugin's private data directory." }, "zh-CN": { "name": "提示词增强", "description": "按需将当前输入框草稿改写成更清晰的企业工作提示词，模型、强度与模板在插件自己的设置面板里配置。", "safetyNotes": "仅在你点击增强操作后，把草稿发送给所选模型提供商；不会读取会话历史或文件附件。为填充设置面板的模型选项，会读取宿主已就绪的模型列表（不含凭据）。设置与上次运行摘要保存在插件私有数据目录中。" }, "ja": { "name": "プロンプト強化", "description": "実行したときに、現在の Composer の下書きをより明確な業務プロンプトに書き換えます。設定はプラグイン独自の設定パネルで行います。", "safetyNotes": "アクションをクリックしたときにのみ、下書きを選択したモデルプロバイダーに送信します。会話履歴やファイル添付は読み取りません。設定パネルのモデル選択を埋めるため、ホストの準備済みモデル一覧（認証情報なし）を読み取ります。設定と前回実行の要約は、プラグインのプライベートデータディレクトリに保存されます。" } }, "categories": [ "creation" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.prompt-enhancement", "docs": { "zh-CN": { "intro": "提示词增强给输入框加一个动作：你写好草稿，点「增强提示词」，草稿被替换成一版更清楚的工作请求——目标、上下文、交付物、验收标准都在该在的位置。它只在你点的时候运行，也只处理当时输入框里的那段文字。\n\n你能用它做什么：\n\n- 把一句含糊的交代变成一个能直接执行的任务，缺的信息变成可以在输入框里直接填的空位。\n- 三档强度：轻度只顺表达，标准补全目标和关键要求，专业档给出更深的分析框架和自检要求。\n- 受保护的内容原样保留：反引号里的片段、路径、URL、邮箱、标识符、日期、版本号、金额不会被改写。\n- 改坏了就撤：一次「撤销提示词增强」回到增强前的草稿。\n", "install": "本插件随应用提供并默认启用。如果你卸载了它，可以在这里重新安装，并把配置从头配一遍。\n开箱即用，但要有一个已经就绪的模型——用哪一档模型由你选，凭据留在应用里，插件不接触密钥。\n\nmanifest 没有声明任何宿主设置项，因此没有需要填写的设置项；可配的东西都在插件自己的面板里：增强用的模型（默认「跟随输入框模型」）、强度（轻度 / 标准 / 专业，默认专业）、是否启用思考（只提供所选模型接受的等级）、以及当前强度的模板编辑器（留空就回到内置模板）。\n\n插件要四项权限：`composer.transform`（提供输入框动作并只在草稿未被改动时应用结果）、`agent.complete`（用已配置的模型做一次补全，点一次才花一次额度）、`models.list`（读已就绪的模型列表，不含凭据）、`ui.panel`（打开自己的设置面板）。\n\n首次验证：\n\n1. 命令「Prompt Enhancement: Settings」打开设置面板，模型先留「跟随输入框模型」；\n2. 在输入框写一句真实但含糊的话，点「增强提示词」；\n3. 草稿应被替换成结构清楚的版本，`[填写说明]` 这类空位可以直接点着填；\n4. 点「撤销提示词增强」，确认原文回来了。\n\n常见安装失败：\n\n- **点了草稿没变化**：草稿只有标点、表情或空白时不会调用模型，原样返回——先写点实际内容。\n- **报错说改写被拒**：结果换掉了语言、掺进了答案、过长，或回显了模板结构。插件会带原因重试一次，仍失败就换模型或降一档强度。\n- **设置面板打不开**：插件被禁用。在「扩展」里启用后再用命令打开。\n- **模型下拉是空的**：应用里没有已就绪的模型。先在模型设置里登录或配置一个，再回到面板。\n", "usage": "三个常见用法：\n\n1. 「下周一之前把这版设计评审走完」——点增强后变成一条带背景、范围、交付物和验收标准的工作请求，你没说的部分留成可直接填的空位。\n2. 「总结一下这份会议记录」——用「标准」就够；「专业」会给出更强的分析框架和自检要求，而不是单纯把篇幅写长。\n3. 「把这句改成给客户的正式说法」——在原语言内重写；语言被换掉的结果会被拒绝并重试一次。\n\n入口有三处：命令面板里的「Prompt Enhancement: Settings」打开设置面板（标题「提示词增强」）；输入框上的动作「增强提示词」，以及它的反向动作「撤销提示词增强」；设置面板里还有模板编辑器与上次运行摘要（时间、模型、耗时、字符数、token 用量、强度、失败码——不存你的草稿，也不存模型输出）。这个插件不提供助手工具。\n\n不要指望它做什么：\n\n- 不读上下文：只把当前草稿发给模型，不读会话历史、不读附件；它不会替你补上你没提供的事实。\n- 不替你发送：一次点击只做一次补全，用你的额度；被判定不合格的改写不会被强行套到草稿上。\n- 不改变你的原意：语言、受保护片段和输入框能渲染的空位语法必须通过检查，否则整次改写作废——它保证的是表达更清楚，不是把内容换成别的。\n" }, "ja": { "intro": "プロンプト強化は Composer にアクションを 1 つ追加します。下書きを書いて「プロンプトを強化」を押すと、下書きがより明確な業務プロンプトに置き換わります。目標、背景、成果物、受け入れ条件がしかるべき位置に入ります。実行されるのはクリックしたときだけで、対象はその時点の Composer のテキストだけです。\n\nできること:\n\n- 曖昧な指示をそのまま実行できるタスクに変えます。足りない情報は Composer 上でそのまま埋められる欄になります。\n- 強度は 3 段階です。軽度は表現を整えるだけ、標準は目標と主要な要件を補い、専門はより深い分析の枠組みと自己検証の条件を加えます。\n- 保護対象はそのまま残ります。バッククォート内の断片、パス、URL、メールアドレス、識別子、日付、バージョン、金額は書き換えません。\n- 失敗したら戻せます。「プロンプト強化を元に戻す」1 回で強化前の下書きに戻ります。\n", "install": "このプラグインはアプリに同梱され、既定で有効です。削除した場合はここから再インストールし、あらためて設定してください。\nすぐに使えますが、準備済みのモデルが 1 つ必要です。どのモデルを使うかは選べますが、認証情報はアプリ側にあり、プラグインはキーに触れません。\n\nmanifest はホスト側の設定項目を宣言していないため、そこに入力する設定はありません。設定できるものはプラグイン独自のパネルにあります。強化に使うモデル（既定は「Composer のモデルに従う」）、強度（軽度 / 標準 / 専門、既定は専門）、思考を有効にするか（選択中のモデルが受け付ける段階のみ提示）、現在の強度のテンプレート編集（空なら組み込みテンプレート）。\n\n使う権限は 4 つです。`composer.transform`（Composer のアクションを提供し、下書きが変わっていない場合のみ結果を適用）、`agent.complete`（設定済みモデルで 1 回だけ補完。クリックしたときだけ枠を消費）、`models.list`（準備済みモデル一覧の読み取り。認証情報は含まない）、`ui.panel`（独自の設定パネルを開く）。\n\n最初の確認:\n\n1. コマンド「Prompt Enhancement: Settings」で設定パネルを開き、モデルは「Composer のモデルに従う」のままにします。\n2. Composer に、実際にありそうで曖昧な一文を書いて「プロンプトを強化」を押します。\n3. 下書きが構造化された版に置き換わり、`[入力してください]` のような欄をその場で埋められるはずです。\n4. 「プロンプト強化を元に戻す」を押して、元の文が戻ることを確認します。\n\nよくある導入のつまずき:\n\n- **押しても下書きが変わらない**: 句読点、絵文字、空白だけの下書きはモデルを呼ばずそのまま返ります。まず実際の内容を書いてください。\n- **書き換えが拒否されたと表示される**: 言語が変わった、答えが混ざった、長すぎる、テンプレートの骨組みがそのまま出た、のいずれかです。理由付きで 1 回だけ再試行し、それでも失敗する場合はモデルを変えるか強度を下げてください。\n- **設定パネルが開かない**: プラグインが無効です。「拡張機能」で有効にしてからコマンドを実行してください。\n- **モデルの一覧が空**: アプリに準備済みのモデルがありません。モデル設定でサインインまたは構成してから、パネルに戻ってください。\n", "usage": "よくある 3 つの頼み方:\n\n1. 「来週の月曜までにこのデザインレビューを終わらせて」— 強化すると、背景、範囲、成果物、受け入れ条件を備えた依頼になり、言っていない部分は埋められる欄として現れます。\n2. 「この議事録を要約して」— 標準で十分です。専門は単に長くするのではなく、より強い分析の枠組みと自己検証を伴います。\n3. 「この一文を顧客向けの正式な言い方にして」— 元の言語のまま書き換えます。言語が変わった結果は拒否され、1 回だけ再試行します。\n\n入口は 3 つです。コマンドパレットの「Prompt Enhancement: Settings」で設定パネル（タイトルは「プロンプト強化」）が開きます。Composer のアクション「プロンプトを強化」と、その逆の「プロンプト強化を元に戻す」。パネル内にはテンプレート編集と前回実行の要約（日時、モデル、所要時間、文字数、トークン使用量、強度、失敗コード。下書きやモデル出力は保存しません）があります。このプラグインはエージェント向けツールを提供しません。\n\n期待しないでください:\n\n- 文脈は読みません。送るのは現在の下書きだけで、会話履歴も添付も読みません。あなたが与えていない事実を補うことはできません。\n- 代わりに送信はしません。1 クリックで 1 回の補完、消費はあなたの枠です。検査に通らない書き換えが下書きに押し込まれることはありません。\n- 意味を変えません。言語、保護対象の断片、Composer が描画できる欄の構文がすべて検査を通らなければ、書き換え全体が破棄されます。保証するのは表現の明確さで、内容の差し替えではありません。\n" }, "en": { "intro": "Prompt Enhancement adds one action to the Composer: you write a draft, click **Enhance prompt**, and the draft is replaced with a clearer work request — goal, context, deliverables and acceptance criteria where they belong. It runs only when you click, and only touches the text that was in the Composer at that moment.\n\nWhat you can do with it:\n\n- Turn a vague instruction into a task that can be executed as written, with the missing inputs left as fields you can fill in the Composer.\n- Three strengths: Light smooths the wording, Standard fills in the goal and key requirements, and Professional adds a deeper analysis frame plus a check the result must pass.\n- Keep protected content intact: backticked spans, paths, URLs, emails, identifiers, dates, versions and amounts are not rewritten.\n- Undo a bad rewrite: one **Undo prompt enhancement** restores the pre-enhancement draft.\n", "install": "This plugin ships with the app and is on by default. If you removed it, install it here to bring it back, then set it up again.\nWorks out of the box, but it needs at least one ready model — you choose which one, the credentials stay in the app and the plugin never touches a key.\n\nThe manifest declares no host settings, so there is nothing to fill in there; everything configurable lives in the plugin's own panel: the enhancement model (default **Follow the Composer model**), the strength (Light / Standard / Professional, default Professional), whether thinking is enabled (only levels the selected model accepts are offered), and a template editor for the current strength (empty means the built-in template).\n\nThe plugin uses four permissions: `composer.transform` (expose a Composer action and apply the result only while the draft is unchanged), `agent.complete` (one completion with a configured model — it spends your credits only when you click), `models.list` (read the ready model rows, never credentials), and `ui.panel` (open its own settings panel).\n\nFirst check:\n\n1. Run the command **Prompt Enhancement: Settings** and leave the model on **Follow the Composer model**;\n2. Type a real but vague sentence in the Composer and click **Enhance prompt**;\n3. The draft should come back structured, with fields like `[Enter ...]` that you can fill in directly;\n4. Click **Undo prompt enhancement** and confirm the original text is back.\n\nCommon setup failures:\n\n- **Nothing happens after clicking**: a draft with only punctuation, emoji or whitespace returns unchanged without a model call — write something real first.\n- **It reports the rewrite was rejected**: the result changed the language, smuggled in an answer, ran long, or echoed the template scaffolding. The plugin retries once with the reason; if that fails, pick another model or a lighter strength.\n- **The settings panel will not open**: the plugin is disabled. Enable it under Extensions, then run the command again.\n- **The model list is empty**: the app has no ready model. Sign in or configure one in model settings, then return to the panel.\n", "usage": "Three common things to ask for:\n\n1. \"Get this design review done before next Monday\" — after enhancing it becomes a work request with background, scope, deliverables and acceptance criteria, and whatever you left unsaid appears as a field you can fill in.\n2. \"Summarise these meeting notes\" — Standard is enough; Professional brings a stronger analysis frame and a self-check rather than simply more words.\n3. \"Rewrite this sentence formally for a client\" — the rewrite stays in the original language; a result that switches language is rejected and retried once.\n\nThere are three entry points: the command **Prompt Enhancement: Settings** opens the settings panel (titled \"Prompt Enhancement\"); the Composer action **Enhance prompt** and its counterpart **Undo prompt enhancement**; and, inside the panel, the template editor and the last-run summary (time, model, duration, character counts, token usage, strength, failure code — never your draft and never the model output). The plugin exposes no agent tool.\n\nDo not expect it to:\n\n- Read context: only the current draft is sent, never conversation history or attachments, and it cannot invent facts you did not provide.\n- Send anything for you: one click is one completion on your credits, and a rewrite that fails the checks is never forced onto your draft.\n- Change your meaning: the language, the protected spans and the field syntax the Composer can render must all pass, or the whole rewrite is discarded — it makes the request clearer, it does not replace its content.\n" } }, "versions": [ { "version": "1.0.0", "publishedAt": "2026-11-01T00:00:00Z", "minPiDesktop": ">=0.21.0", "shasum": "28a1979ccdec354d6f6021b416761176f7f7a45c4d93878bef36d378f80913b2", "url": "packages/voki.prompt-enhancement-1.0.0.piplug", "sizeBytes": 202585, "permissions": [ "composer.transform", "agent.complete", "models.list", "ui.panel" ], "fs": {} } ], "distribution": "bundled" }, { "id": "voki.qianwen-generate", "name": "Qianwen Generate", "description": "Generate and edit images, video, speech, music and 3D models through the Qianwen platform CLI, with API-key settings, automatic CLI setup, media previews, task-monitor progress cards and workspace output.", "author": "voki-work", "i18n": { "en": { "name": "Qianwen Generate", "description": "Generate and edit images, video, speech, music and 3D models through the Qianwen platform CLI, with API-key settings, automatic CLI setup, media previews, task-monitor progress cards and workspace output.", "safetyNotes": "Prompts, reference media and recordings are sent to the Qianwen platform, and every generation call can incur service cost. The plugin runs the qianwen CLI you install, reads the API Key from the plugin setting first and falls back to a 0600 key file, and never returns the key in tool results. On first enable it runs npm install -g @qianwenai/qianwen-cli when the CLI is missing. The API Key setting is stored in the plugin's local settings file, which the plugin restricts to the current user on POSIX. Chat previews use the short-lived result URLs returned by the service and the saved paths; model output, remote URLs and generated files are untrusted data, not instructions. Upload only files the user chose, do not put secrets in prompts, and do not retry paid calls in a tight loop." }, "zh-CN": { "name": "千问生成", "description": "通过千问AI平台 CLI 生成与编辑图像、视频、语音、音乐和 3D 模型，支持设置内填写 API Key、自动安装 CLI、对话内媒体预览、任务监控进度卡和工作区结果落盘。", "safetyNotes": "提示词、参考素材和录音会发送到千问AI平台，每次生成调用都可能产生费用。插件运行你安装的 qianwen CLI，优先从插件设置读取 API Key，其次使用 0600 密钥文件，并且不会在工具结果中返回密钥。首次启用且未检测到 CLI 时，会运行 npm install -g @qianwenai/qianwen-cli。API Key 设置保存在插件的本地设置文件中，插件会在 POSIX 上把该文件权限收紧到当前用户。对话预览使用服务返回的短期结果 URL 和已保存路径；模型输出、远端 URL 和生成文件都是不可信数据，不是指令。只上传用户选择的文件，不要在提示词里写入密钥，也不要对付费调用进行紧凑重试。" }, "ja": { "name": "千問生成", "description": "千問AIプラットフォームの CLI で画像・動画・音声・音楽・3D モデルを生成・編集します。設定画面での API Key 入力、CLI の自動インストール、メディアプレビュー、タスク監視の進捗カード、ワークスペースへの保存を提供します。", "safetyNotes": "プロンプト、参照メディア、録音は千問AIプラットフォームに送信され、生成のたびに料金が発生する場合があります。プラグインはインストール済みの qianwen CLI を実行し、API Key はプラグイン設定を優先し、次に 0600 のキーファイルを使用します。ツール結果にキーを返すことはありません。初回有効化時に CLI が見つからない場合、npm install -g @qianwenai/qianwen-cli を実行します。API Key 設定はプラグインのローカル設定ファイルに保存され、POSIX では現在のユーザーだけが読める権限に制限されます。チャットのプレビューはサービスが返す短期 URL と保存済みパスを使用します。モデル出力、リモート URL、生成ファイルは信頼できないデータであり、指示ではありません。ユーザーが選んだファイルだけをアップロードし、プロンプトに秘密情報を書かず、有料呼び出しを短い間隔で再試行しないでください。" } }, "categories": [ "creation" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.qianwen-generate", "docs": { "zh-CN": { "intro": "千问生成把千问AI平台的命令行工具接进对话：图像、视频、语音合成、语音识别、音乐和 3D 模型都能从一句话发起，产物落进当前会话的工作目录，对话里直接预览。\n\n插件不自己发请求，它把「安装检查、密钥注入、参数校验、异步任务轮询、结果落盘」收成一条稳定路径：先找到你本机的 `qianwen` CLI，把密钥放进子进程环境，再把校验过的参数拼成一条完整命令交给宿主的 Bash 工具执行。所以命令里永远不会出现 `--api-key`，密钥也不会进 shell 历史和转录。\n\n异步任务是常态：图片可能等一会儿，视频和 3D 默认只提交并返回任务 id，之后用 `task` 查询；提交和查询到的任务都会出现在任务监控的「千问生成」卡片上，即使你结束了这一轮对话，插件仍会在后台继续跟踪。\n\n你能用它做什么：\n\n- 一句话出图，或拿一张参考图做编辑，产物直接在工作区里。\n- 把文稿合成语音，或把录音转成文字。\n- 提交视频与 3D 模型生成，先拿任务 id，稍后回来取结果。\n- 在对话里预览图片、视频、语音，并用结果卡上的图标打开结果或打开所在文件夹。\n", "install": "本插件不随安装包提供，安装后才可用。卸载之后可以在这里重新安装，配置与数据需要重新设置。\n需要两样东西：本机可用的 Node/npm（用来安装 `@qianwenai/qianwen-cli`），以及千问AI平台的推理 API Key。`autoInstallCli` 开着时，首次启用若没找到 CLI，插件会执行 `npm install -g @qianwenai/qianwen-cli`；失败后一小时内不再自动重试。密钥优先读插件设置（保存在插件的本地设置文件，插件在 POSIX 上尽力收紧到 `0600`），其次读 `0600` 密钥文件；插件不会把密钥写进日志、聊天或工具结果，启动器还会在转发 CLI 输出时再抹一次。**不要把 API Key 贴进对话或写进提示词**——它只放在设置里或密钥文件里。\n\n| 设置项 | 用途 | 默认值 |\n| --- | --- | --- |\n| `apiKey` | 推理 API Key，优先于密钥文件与环境变量 | 空 |\n| `cliPath` | `qianwen` 入口路径；留空自动在 PATH、npm 全局目录、Homebrew 目录与自动安装记录里查找 | 空 |\n| `autoInstallCli` | 启用插件时若缺少 CLI，自动运行 npm 全局安装 | `true` |\n| `apiKeyFile` | `apiKey` 留空时使用的密钥文件，建议 `0600`；留空时用 `~/.config/qianwen/api_key` | 空 |\n| `outputDirectory` | 工作区内的结果目录 | `qianwen-generate` |\n| `defaultImageModel` | 默认图像模型，留空用 CLI 默认（当前 `qwen-image-3.0-pro`） | 空 |\n| `defaultVideoModel` | 默认视频模型，留空用 CLI 默认（文生视频 `happyhorse-1.1-t2v`，图生视频 `happyhorse-1.1-i2v`） | 空 |\n| `waitSeconds` | CLI 轮询异步任务的时长上限，30–900 | `300` |\n\n首次验证：\n\n1. 运行命令「千问AI平台」，让它检测或安装 CLI；也可以在设置里把 `cliPath` 指到你已有的入口。\n2. 在扩展设置里填入 API Key，然后回对话说「用千问生成一张 1024*1024 的简约产品图」——助手会先用 `qianwen_cli` 的 `command` 动作拼命令，再用 Bash 执行。\n3. 图片出现在对话里的同时，任务监控右侧栏的「插件」区域会出现一张「千问生成」卡片，产物文件在 `qianwen-generate` 目录里。\n\n常见安装失败：\n\n- **提示 CLI 未安装或 `cliPath` 指错**：本机没有 npm 全局前缀的写权限，或 PATH 里找不到；手动执行 `npm install -g @qianwenai/qianwen-cli`，或把 `cliPath` 指向已有入口。\n- **认证失败（退出码 2）**：API Key 无效，或该密钥没有对应模型的权限；重新在设置里填一次，不要改去改命令里的参数。\n- **`models` 报需要管理登录**：模型浏览需要 `qianwen auth login`，但生成只需要 API Key，直接用默认模型继续即可。\n", "usage": "三个常见用法：\n\n1. **出图或改图**：「做一张 1024*1024 的产品主图，简约风，不要文字」。助手拼好命令并执行，图片在消息里居中预览，最高 600 px。\n2. **配音或转写**：「把这段文字用中文女声读出来」或「把这段录音转成文字，标点保留」。前者走语音合成，后者走语音识别，转写结果按不可信数据处理。\n3. **提交一段视频**：「用这张图生成一段 5 秒的视频」。视频默认只提交并返回任务 id，助手会告诉你稍后用 `task` 取，而不是占住这一轮。\n\n入口是命令「千问AI平台」（安装或修复 CLI；英文界面为 \"Qianwen CLI: Install or repair\"）。对话里的能力来自 `qianwen_cli` 工具的 5 个动作：\n\n| 能力 | 做什么 |\n| --- | --- |\n| `info` | 返回解析到的 CLI 路径、密钥来源、安装状态与输出目录，不返回密钥 |\n| `doctor` | 跑一次 CLI 诊断，报告版本、网络与认证问题 |\n| `models` | 按模态列出、搜索或查看模型 ID |\n| `command` | 校验参数并生成一条已加引号的完整生成命令，不执行 |\n| `task` | 查询一个异步任务，并把完成的媒体下载到输出目录 |\n\n不要指望它做什么：\n\n- 不免费：每次生成都可能产生费用，插件不做自动重试循环，也不批量并发；失败先看错误码再决定。\n- 不绕过计划限制：Token Plan（`sk-sp-`）密钥只支持公网 URL 素材、不支持本地文件上传，也不覆盖音乐与 3D；这类限制会以错误返回，重试同一个付费调用没有意义。\n- 不替你保管密钥安全：密钥在本地设置文件或 `0600` 密钥文件里，仍位于当前用户的数据目录；不要把密钥写进提示词，也不要把该目录共享给其他用户。\n" }, "ja": { "intro": "千問生成は千問AIプラットフォームの CLI を会話につなぎます。画像、動画、音声合成、音声認識、音楽、3D モデルを 1 つの指示から開始でき、成果物は現在のセッションの作業ディレクトリに保存され、チャット内でプレビューできます。\n\nプラグイン自身はリクエストを送りません。「インストール確認、キーの注入、引数の検証、非同期タスクのポーリング、結果の保存」を 1 本の経路にまとめます。まずマシン上の `qianwen` CLI を見つけ、キーは子プロセスの環境変数にだけ入れ、検証済みの引数から完全なコマンドを組み立てて、ホストの Bash ツールに実行させます。そのためコマンドラインに `--api-key` が現れることはなく、キーがシェル履歴やトランスクリプトに入ることもありません。\n\n非同期が通常です。画像は少し待つことがあり、動画と 3D は既定では送信のみで task id を返し、あとで `task` により確認します。送信・確認したタスクはタスク監視の「千問生成」カードに表示され、ターンが終わってもプラグインはバックグラウンドで追跡を続けます。\n\nできること:\n\n- 1 つの指示から画像を生成し、参照画像があれば編集モードで仕上げ、そのままワークスペースに保存します。\n- 原稿を音声に、録音をテキストに変換します。\n- 動画と 3D モデルの生成を送信し、task id を保持して後から結果を受け取ります。\n- チャット内で画像・動画・音声をプレビューし、結果カードのアイコンから結果を開いたりフォルダーを開いたりできます。\n", "install": "このプラグインはインストーラーに含まれません。使う前にここからインストールしてください。削除後に再度インストールできますが、設定とデータは初期状態になります。\n必要なのは 2 つです。`@qianwenai/qianwen-cli` を入れるための Node/npm と、千問AIプラットフォームの推論 API Key です。`autoInstallCli` が有効なら、初回有効化時に CLI が見つからない場合 `npm install -g @qianwenai/qianwen-cli` を実行します。失敗した場合は 1 時間は自動再試行しません。キーはプラグイン設定（プラグインのローカル設定ファイルに保存され、POSIX では `0600` に制限）を優先し、次に `0600` のキーファイルを読みます。キーがログ、チャット、ツール結果に書かれることはなく、ランチャーは転送する CLI 出力からも再度伏せ字にします。**API Key をチャットやプロンプトに貼らないでください**。置き場所は設定かキーファイルです。\n\n| 設定項目 | 用途 | 既定値 |\n| --- | --- | --- |\n| `apiKey` | 推論 API Key。キーファイルや環境変数より優先されます | 空 |\n| `cliPath` | `qianwen` のエントリパス。空なら PATH、npm のグローバルディレクトリ、Homebrew の領域、自動インストールの記録から探します | 空 |\n| `autoInstallCli` | 有効化時に CLI が無ければ npm のグローバルインストールを実行します | `true` |\n| `apiKeyFile` | `apiKey` が空のときに使うキーファイル（`0600` 推奨）。空なら `~/.config/qianwen/api_key` | 空 |\n| `outputDirectory` | ワークスペース内の出力フォルダー | `qianwen-generate` |\n| `defaultImageModel` | 既定の画像モデル。空なら CLI の既定（現在 `qwen-image-3.0-pro`） | 空 |\n| `defaultVideoModel` | 既定の動画モデル。空なら CLI の既定（テキストから `happyhorse-1.1-t2v`、画像から `happyhorse-1.1-i2v`） | 空 |\n| `waitSeconds` | 非同期タスクのポーリング上限（秒）、30〜900 | `300` |\n\n最初の確認:\n\n1. コマンド「Qianwen CLI：インストール/修復」を実行し、CLI を検出またはインストールします。既にある入口を `cliPath` に指定しても構いません。\n2. 拡張機能の設定で API Key を入力し、会話で「千問で 1024*1024 のミニマルな商品画像を作って」と伝えます。アシスタントは `qianwen_cli` の `command` でコマンドを組み立て、Bash で実行します。\n3. 画像がチャットに表示され、タスク監視のプラグイン領域に「千問生成」カードが出て、ファイルは `qianwen-generate` フォルダーに保存されます。\n\nよくある導入の失敗:\n\n- **CLI が無い、または `cliPath` が誤っている**: npm のグローバルプレフィックスに書き込めないか、PATH に入口がありません。`npm install -g @qianwenai/qianwen-cli` を手動で実行するか、`cliPath` に既存の入口を指定してください。\n- **認証エラー（終了コード 2）**: API Key が無効か、そのモデルへの権限がありません。コマンド引数をいじらず、設定で入力し直してください。\n- **`models` が管理者ログインを求める**: モデル一覧には `qianwen auth login` が必要ですが、生成には API Key だけで足ります。既定のモデルのまま続けてください。\n", "usage": "よくある 3 つの依頼:\n\n1. **画像を作る・編集する**: 「1024*1024 の商品画像を作って。ミニマルな雰囲気で、文字は入れないで」。アシスタントがコマンドを組み立てて実行し、画像はメッセージ内に最大 600 px で中央に表示されます。\n2. **音声化・文字起こし**: 「この文章を中国語の女性音声で読んで」「この録音を文字にして、句読点は残して」。前者は音声合成、後者は音声認識で、書き起こしは信頼できないデータとして扱われます。\n3. **動画を送信する**: 「この画像から 5 秒の動画を作って」。動画は既定では送信のみで task id を返すため、アシスタントはターンを占有せず `task` で後から取得するよう伝えます。\n\n入口はコマンド「Qianwen CLI：インストール/修復」です。会話内の機能は `qianwen_cli` ツールの 5 つのアクションが担います:\n\n| 機能 | 内容 |\n| --- | --- |\n| `info` | 解決された CLI パス、認証情報の取得元、インストール状態、出力ディレクトリを返します。キーは返しません |\n| `doctor` | CLI の診断を実行し、バージョン、ネットワーク、認証の問題を報告します |\n| `models` | モダリティ別にモデル ID を一覧・検索・詳細表示します |\n| `command` | 引数を検証し、引用済みの完全な生成コマンドを組み立てます（実行はしません） |\n| `task` | 非同期タスクを 1 回確認し、完了したメディアを出力ディレクトリにダウンロードします |\n\n期待しないでください:\n\n- 無料であること: 生成のたびに料金が発生する場合があり、プラグインは自動再試行も並列バッチも行いません。再試行の前にエラーコードを確認してください。\n- プランの制限の回避: Token Plan（`sk-sp-`）のキーは公開 URL の素材のみ対応し、ローカルファイルのアップロードには対応せず、音楽と 3D も対象外です。制限はエラーとして返り、同じ有料呼び出しを繰り返しても解決しません。\n- キーの保護をすべて肩代わりすること: キーはローカル設定ファイルか `0600` のキーファイルとして現在のユーザーのデータディレクトリにあります。プロンプトに書かず、そのディレクトリを他のユーザーと共有しないでください。\n" }, "en": { "intro": "Qianwen Generate wires the Qianwen platform CLI into the conversation: images, video, speech synthesis, transcription, music and 3D models all start from one sentence, and the output lands in the current session's working directory with a preview in the chat.\n\nThe plugin sends no requests itself. It collapses \"install check, key injection, argument validation, async polling and saving the result\" into one stable path: find the `qianwen` CLI on your machine, put the key only into the child process environment, then turn validated arguments into a complete command and let the host's Bash tool run it. A key never appears in the command line, in shell history or in the transcript.\n\nAsync is the normal case: an image may take a while, and video and 3D submit-only by default and return a task id you poll later with `task`. Submitted and polled tasks show up as cards in the task monitor, and the plugin keeps tracking them after the turn ends.\n\nWhat you can do with it:\n\n- Generate an image from one sentence, or edit one from a reference image, straight into the workspace.\n- Turn a script into speech, or a recording into text.\n- Submit video and 3D generation, keep the task id and collect the result later.\n- Preview images, video and audio in the chat, and use the result card's icons to open the result or its folder.\n", "install": "This plugin is not part of the installer: install it here before using it. After removing it you can reinstall it here, but its settings and data start over.\nTwo things are needed: a working Node/npm on this machine (to install `@qianwenai/qianwen-cli`) and a Qianwen inference API Key. With `autoInstallCli` on, a first enable that finds no CLI runs `npm install -g @qianwenai/qianwen-cli`; after a failure it does not retry for an hour. The key is read from the plugin setting first (stored in the plugin's local settings file, which the plugin tightens to `0600` on POSIX) and from a `0600` key file second; the plugin never writes the key into logs, the chat or tool results, and the launcher scrubs it again from forwarded CLI output. **Do not paste the API Key into the chat or into a prompt** — it belongs in the setting or the key file.\n\n| Setting | Purpose | Default |\n| --- | --- | --- |\n| `apiKey` | Inference API Key; takes precedence over the key file and environment variables | empty |\n| `cliPath` | Path to the `qianwen` entry; empty auto-detects PATH, npm global directories, Homebrew prefixes and a recorded auto-install | empty |\n| `autoInstallCli` | Run the npm global install when the CLI is missing at enable time | `true` |\n| `apiKeyFile` | Key file used when `apiKey` is empty, `0600` recommended; empty falls back to `~/.config/qianwen/api_key` | empty |\n| `outputDirectory` | Workspace-relative output folder | `qianwen-generate` |\n| `defaultImageModel` | Default image model; empty uses the CLI default (currently `qwen-image-3.0-pro`) | empty |\n| `defaultVideoModel` | Default video model; empty uses the CLI defaults (`happyhorse-1.1-t2v`, or `happyhorse-1.1-i2v` with an image) | empty |\n| `waitSeconds` | CLI polling budget for async tasks, 30–900 | `300` |\n\nFirst verification:\n\n1. Run the command \"Qianwen CLI: Install or repair\" so it detects or installs the CLI, or point `cliPath` at an entry you already have.\n2. Enter the API Key in the extension settings, then say \"generate a minimal 1024*1024 product image with Qianwen\" — the assistant builds the command with `qianwen_cli`'s `command` action and runs it with Bash.\n3. The image appears in the chat, a \"Qianwen Generate\" card appears in the task monitor's plugin area, and the file is in the `qianwen-generate` folder.\n\nCommon install failures:\n\n- **The CLI is missing or `cliPath` points at the wrong file**: this machine cannot write to npm's global prefix, or the entry is not on PATH; run `npm install -g @qianwenai/qianwen-cli` by hand, or point `cliPath` at the entry you have.\n- **Authentication fails (exit code 2)**: the API Key is invalid, or it has no access to that model; enter it again in the settings instead of editing command arguments.\n- **`models` asks for an admin login**: browsing models needs `qianwen auth login`, but generation only needs the API Key — continue with the default model.\n", "usage": "Three common things to ask for:\n\n1. **Make or edit an image**: \"Make a 1024*1024 product shot, minimal style, no text.\" The assistant builds the command, runs it, and the image is centred in the message at up to 600 px.\n2. **Voice or transcript**: \"Read this text out in a Chinese female voice\" or \"transcribe this recording and keep the punctuation.\" The first is speech synthesis, the second transcription; the text comes back as untrusted data.\n3. **Submit a video**: \"Turn this image into a five-second video.\" Video submits by default and returns a task id; the assistant tells you to collect it with `task` instead of holding the turn.\n\nThe entry point is the command \"Qianwen CLI: Install or repair\". In the conversation the work is done by five actions of the `qianwen_cli` tool:\n\n| Capability | What it does |\n| --- | --- |\n| `info` | Returns the resolved CLI path, credential source, install state and output directory, never the key |\n| `doctor` | Runs the CLI diagnostic and reports version, network and authentication problems |\n| `models` | Lists, searches or describes model IDs by modality |\n| `command` | Validates arguments and builds a complete, already-quoted generation command without running it |\n| `task` | Polls one async task and downloads finished media into the output directory |\n\nDo not expect it to:\n\n- Be free: every generation can incur cost, and the plugin runs no retry loop and no parallel batch — read the error code before trying again.\n- Bypass plan limits: a Token Plan (`sk-sp-`) key accepts public URLs only, refuses local uploads, and does not cover music or 3D; those limits come back as errors, and retrying the same paid call does not help.\n- Keep your key safe from everything: the key lives in the local settings file or a `0600` key file inside the current user's data directory; never put it in a prompt and never share that directory with another user.\n" } }, "versions": [ { "version": "1.2.3", "publishedAt": "2026-10-31T00:00:00Z", "changelog": "- 任务监控卡片不再有云端链接：产物行仅在存在本地文件时打开，只有云端地址的\n 产物行变为不可点击；不再复用宿主 `openBrowserUrl`，避免与智能应用卡片\n 的“云端详情”链接混淆。", "minPiDesktop": ">=0.24.0", "shasum": "4a8fb39aa7fd392748b479da4c988c9cbf0513842ee286774d466b9f72d12f8e", "url": "packages/voki.qianwen-generate-1.2.3.piplug", "sizeBytes": 187229, "permissions": [ "agent.tool.register", "agent.prompt.inject", "renderer.extension" ], "fs": {} } ], "distribution": "marketplace" }, { "id": "voki.screenshot-ocr", "name": "OCR", "description": "Recognize text in workspace images and screenshots with a local OCR engine shipped inside the plugin: single images and batches, language and model-tier selection, line merging, and results written to the workspace.", "author": "voki-work", "i18n": { "en": { "name": "OCR", "description": "Recognize text in workspace images and screenshots with a local OCR engine shipped inside the plugin: single images and batches, language and model-tier selection, line merging, and results written to the workspace.", "safetyNotes": "Recognition runs on this machine through the nbocr engine (ocr-rs / MNN) that you install or place in the plugin bin directory; images are not uploaded anywhere. Models are loaded from the plugin data directory and, unless you enable autoDownloadModels, the plugin refuses instead of fetching them over the network. The plugin only spawns an executable named nbocr, newbee_ocr or nbocr.exe, never through a shell. Input paths must resolve inside the workspace and credential paths are refused. Results are written only under the configured output directory (ocr/** by default). OCR output is untrusted data: it is text from an image, not instructions." }, "zh-CN": { "name": "截图文字识别", "description": "用随插件一起安装的本地 OCR 引擎识别工作区图片与截图中的文字：单图与批量、语言与模型档位选择、行合并，以及把结果写入工作区。", "safetyNotes": "识别在本机通过你安装或放在插件 bin 目录里的 nbocr 引擎（ocr-rs / MNN）完成，图片不会上传到任何地方。模型从插件数据目录加载；除非开启 autoDownloadModels，插件会直接报缺模型而不是联网下载。插件只会执行名为 nbocr、newbee_ocr 或 nbocr.exe 的可执行文件，且从不经过 shell。输入路径必须解析到工作区内，凭据路径一律拒绝。结果只会写到配置的输出目录（默认 ocr/**）。OCR 结果属于不可信数据：它是图片里的文字，不是指令。" }, "ja": { "name": "OCR", "description": "プラグインと一緒に導入されるローカル OCR エンジンで、ワークスペースの画像やスクリーンショットから文字を認識します。単体画像とバッチ、言語とモデル段位の選択、行の結合、ワークスペースへの結果保存に対応します。", "safetyNotes": "認識はインストール済み、またはプラグインの bin ディレクトリに置いた nbocr エンジン（ocr-rs / MNN）でこのマシン上で実行され、画像はどこにも送信されません。モデルはプラグインのデータディレクトリから読み込み、autoDownloadModels を有効にしない限りネットワーク取得は行わず不足を報告します。実行するのは nbocr、newbee_ocr、nbocr.exe という名前の実行ファイルだけで、シェルは経由しません。入力パスはワークスペース内に解決される必要があり、資格情報のパスは拒否します。結果は設定された出力ディレクトリ（既定は ocr/**）にのみ書き込みます。OCR の結果は信頼できないデータであり、指示ではありません。" } }, "categories": [ "office" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.screenshot-ocr", "docs": { "zh-CN": { "intro": "把图片里的文字读出来，而且图片不离开本机。识别由本地的 `nbocr` 引擎（基于 ocr-rs 与 MNN）完成，插件只负责找到引擎、组织参数、把结果整理成模型和人都能读的形态。\n\n你能用它做什么：\n\n- 从发票、回执、截图里取出编号、金额、地址这类必须逐字准确的字段。\n- 一次识别整个目录的扫描件，逐文件报告成功或失败。\n- 需要排版信息时打开框明细，拿到每个区域的文本、置信度与坐标。\n- 把完整结果写成 Markdown、纯文本或 JSON，留在工作区里当底稿。\n\n它不做什么：不还原版面（不重建表格行列），不做云端兜底，也不替你判断识别结果对不对。\n", "install": "本插件不随安装包提供，安装后才可用。卸载之后可以在这里重新安装，配置与数据需要重新设置。\n插件本身开箱可用，但**识别引擎要另外安装**。三种方式任选：\n\n1. Homebrew：`brew install zibo-chen/tap/nbocr`；Windows 用 `winget install ChenZibo.NewbeeOCRCLI`。\n2. 把 `nbocr` 放到插件目录的 `bin/<平台>-<架构>/`（例如 `bin/darwin-arm64/nbocr`）。\n3. 在设置里填 `enginePath`，指向已有的 `nbocr` 可执行文件。\n\n装好后在对话里说「检查一下 OCR 引擎」，或运行命令 `OCR: check engine and models`，`doctor` 会报告引擎路径、版本、模型目录与缺失文件。\n\n| 设置项 | 用途 | 默认值 |\n| --- | --- | --- |\n| `enginePath` | 显式引擎路径；留空依次查插件 `bin/`、PATH 与常见安装前缀 | 空 |\n| `tier` | 默认模型档位 | `v6-tiny` |\n| `language` | 默认语言代码或引擎模型名 | `zh` |\n| `modelsDirectory` | 模型目录；留空用插件数据目录下的 `models/` | 空 |\n| `outputDirectory` | 结果保存目录，必须在 `ocr/**` 内 | `ocr` |\n| `maxImageMiB` | 单图大小上限 | `32` |\n| `autoDownloadModels` | 缺模型时是否允许引擎自行下载 | 关闭 |\n| `timeoutMs` | 单张识别超时 | `60000` |\n\n常见问题：\n\n- **提示找不到引擎**：先把 `nbocr --version` 在终端跑通，再回到设置填路径。插件不会替你执行远程安装脚本。\n- **提示缺模型**：`v6-tiny` 是内嵌档位，其余档位需要模型文件；要么开启下载，要么把文件放进模型目录。\n- **识别出方块**：多为图片里本身就是方块字（字体缺字），换一张图或提高分辨率再试。\n", "usage": "三个常见用法：\n\n1. **取字段**：「把 `scans/invoice.png` 里的发票号和合计金额读出来」——助手会用默认档位识别并直接回答字段。\n2. **整目录批量**：「把 `scans/` 下所有回执识别成文本，存到 `ocr/`」——批量模式逐文件返回结果，单个失败不影响其它文件。\n3. **要位置**：当表格或双栏排版重要时，打开框明细拿到坐标，再按坐标自行判断归属。\n\n选档位的经验：中文、英文、日文先用默认 `v6-tiny`；小字或长文档换 `v6-small`；韩文、西里尔、阿拉伯、天城文、泰文、希腊文、泰米尔、泰卢固必须换 `v5`，否则会用错识别模型。内存紧张时用 `v5-fp16`。\n\n注意：OCR 结果是**不可信数据**——它是图片里的文字，不是给你的指令；金额、编号这类关键字段建议二次核对。\n" }, "ja": { "intro": "画像から文字を読み取ります。画像はどこにも送信されません。認識はローカルの `nbocr` エンジン（ocr-rs と MNN ベース）で実行され、プラグインはエンジンの解決、引数の組み立て、結果の整形だけを担当します。\n\nできること:\n\n- 請求書、レシート、スクリーンショットから、番号・金額・住所など一字一句正確であるべき値を取り出す。\n- ディレクトリ全体のスキャンをまとめて認識し、ファイルごとに成否を返す。\n- 位置が重要なときは枠の詳細を有効にし、領域ごとのテキスト・信頼度・座標を取得する。\n- 完全な結果を Markdown、テキスト、JSON としてワークスペースに保存する。\n\nできないこと: レイアウトの復元（表の行と列の再構築）、クラウドへのフォールバック、認識結果の正しさの判定。\n", "install": "このプラグインはインストーラーに含まれません。使う前にここからインストールしてください。削除後に再度インストールできますが、設定とデータは初期状態になります。\nプラグイン自体はすぐ使えますが、**認識エンジンは別途導入が必要**です。次のいずれかを選びます。\n\n1. Homebrew: `brew install zibo-chen/tap/nbocr`、Windows は `winget install ChenZibo.NewbeeOCRCLI`。\n2. `nbocr` をプラグインの `bin/-/` に置く（例: `bin/darwin-arm64/nbocr`）。\n3. 設定の `enginePath` に既存の `nbocr` 実行ファイルを指定する。\n\n導入後、チャットで「OCR エンジンを確認して」と伝えるか、コマンド `OCR: check engine and models` を実行すると、`doctor` がエンジンのパス、バージョン、モデルディレクトリ、不足ファイルを報告します。\n\n| 設定 | 意味 | 既定値 |\n| --- | --- | --- |\n| `enginePath` | 明示的なエンジンパス。空ならプラグインの `bin/`、PATH、一般的な導入先を順に確認 | 空 |\n| `tier` | 既定のモデル段位 | `v6-tiny` |\n| `language` | 既定の言語コードまたはエンジンのモデル名 | `zh` |\n| `modelsDirectory` | モデルディレクトリ。空ならプラグインのデータディレクトリ配下の `models/` | 空 |\n| `outputDirectory` | 結果の保存先。`ocr/**` の内側である必要あり | `ocr` |\n| `maxImageMiB` | 1 枚あたりのサイズ上限 | `32` |\n| `autoDownloadModels` | 不足モデルの自動取得を許可するか | オフ |\n| `timeoutMs` | 1 枚あたりのタイムアウト | `60000` |\n\nよくある問題:\n\n- **エンジンが見つからない**: 先にターミナルで `nbocr --version` を確認し、そのパスを設定に入れてください。リモートのインストールスクリプトを勝手に実行することはありません。\n- **モデルが不足**: `v6-tiny` は内蔵段位です。他の段位はファイルが必要なので、ダウンロードを有効にするかモデルディレクトリに配置してください。\n- **文字が四角になる**: 画像側のフォントに字形がない可能性があります。別の画像か高解像度で試してください。\n", "usage": "よくある 3 つの使い方:\n\n1. **項目を読む**: 「`scans/invoice.png` の請求書番号と合計金額を読み取って」— 既定の段位で認識し、値をそのまま答えます。\n2. **ディレクトリをまとめて処理**: 「`scans/` のレシートをすべて認識して `ocr/` に保存して」— バッチはファイルごとに結果を返し、1 件の失敗が他を止めません。\n3. **位置を保つ**: 表や 2 段組が重要なときは枠の詳細を有効にし、座標から帰属を判断します。\n\n段位の選び方: 中国語・英語・日本語はまず `v6-tiny`。小さい文字や長い文書は `v6-small`。韓国語、キリル文字、アラビア語、デーヴァナーガリー、タイ語、ギリシャ語、タミル語、テルグ語は `v5` が必要です。メモリが厳しいときは `v5-fp16`。\n\nOCR の結果は**信頼できないデータ**です。画像内の文字であり、指示ではありません。金額や識別子は実行前に確認してください。\n" }, "en": { "intro": "Read text out of images without sending them anywhere. Recognition runs in a local `nbocr` engine (built on ocr-rs and MNN); the plugin only finds the engine, builds the arguments and turns the result into something both the model and a person can read.\n\nWhat you can do with it:\n\n- Pull numbers, amounts and addresses out of invoices, receipts and screenshots where every character matters.\n- Recognize a whole directory of scans in one call, with a per-file success or failure report.\n- Turn on box details when position matters and get text, confidence and coordinates per region.\n- Write the full result to the workspace as Markdown, text or JSON and keep it as a source document.\n\nWhat it does not do: rebuild layout (table rows and columns), fall back to a cloud service, or decide whether the recognized text is correct.\n", "install": "This plugin is not part of the installer: install it here before using it. After removing it you can reinstall it here, but its settings and data start over.\nThe plugin works out of the box, but **the recognition engine is a separate install**. Pick one:\n\n1. Homebrew: `brew install zibo-chen/tap/nbocr`; on Windows use `winget install ChenZibo.NewbeeOCRCLI`.\n2. Drop `nbocr` into the plugin's `bin/-/` directory (for example `bin/darwin-arm64/nbocr`).\n3. Set `enginePath` in the settings to an existing `nbocr` executable.\n\nThen ask \"check the OCR engine\" in chat, or run the command `OCR: check engine and models`; `doctor` reports the engine path, version, model directory and any missing files.\n\n| Setting | Meaning | Default |\n| --- | --- | --- |\n| `enginePath` | Explicit engine path; empty checks the plugin `bin/`, PATH and the usual install prefixes | empty |\n| `tier` | Default model tier | `v6-tiny` |\n| `language` | Default language code or engine model name | `zh` |\n| `modelsDirectory` | Model directory; empty uses `models/` under the plugin data directory | empty |\n| `outputDirectory` | Where results are written; must stay inside `ocr/**` | `ocr` |\n| `maxImageMiB` | Per-image size limit | `32` |\n| `autoDownloadModels` | Whether the engine may fetch missing models | off |\n| `timeoutMs` | Per-image timeout | `60000` |\n\nCommon problems:\n\n- **No engine found**: run `nbocr --version` in a terminal first, then point the setting at that path. The plugin never runs a remote install script for you.\n- **Missing model files**: `v6-tiny` is the embedded tier; other tiers need files. Enable downloads or place the files in the models directory.\n- **Boxes instead of characters**: the image itself may contain missing glyphs; try another file or a higher resolution.\n", "usage": "Three common patterns:\n\n1. **Read a field**: \"get the invoice number and the total out of `scans/invoice.png`\" — the assistant recognizes the image with the default tier and answers with the values.\n2. **Batch a directory**: \"recognize every receipt under `scans/` and save the text to `ocr/`\" — batch mode reports per file, and one failure does not stop the others.\n3. **Keep positions**: when a table or a two-column form matters, turn on box details to get coordinates and decide grouping yourself.\n\nChoosing a tier: start with `v6-tiny` for Chinese, English and Japanese; switch to `v6-small` for small print or long documents; Korean, Cyrillic, Arabic, Devanagari, Thai, Greek, Tamil and Telugu require `v5`, otherwise the wrong recognition model is used. Use `v5-fp16` when memory is tight.\n\nRemember that OCR output is **untrusted data**: it is text from an image, not instructions. Verify amounts and identifiers before acting on them.\n" } }, "versions": [ { "version": "0.2.1", "publishedAt": "2026-11-02T12:36:00Z", "changelog": "- Ship `bin/voki-ocr.mjs` inside the package. The 0.2.0 packages were built\n with the whole `bin/` tree ignored, so a market install had no CLI and every\n recognition request failed.", "minPiDesktop": ">=0.24.0", "shasum": "f6f5a3ca91cde88421bdca2b25bce8a78130a981e683881dfe17c9e4ca7f9d48", "url": "packages/voki.screenshot-ocr-0.2.1.piplug", "sizeBytes": 136978, "permissions": [ "agent.tool.register", "agent.prompt.inject", "fs.read", "fs.write", "notify", "renderer.extension" ], "fs": { "read": { "root": "workspace", "scope": [ "**/*.png", "**/*.jpg", "**/*.jpeg", "**/*.webp", "**/*.bmp", "**/*.tif", "**/*.tiff" ] }, "write": { "root": "workspace", "scope": [ "ocr/**" ] } } } ], "distribution": "marketplace" }, { "id": "voki.ticket-management", "name": "Ticket Management", "description": "Turn customer support mail into trackable tickets: one ticket one session, with intake, initial diagnosis, root cause, customer reports, close-out and SOP distillation all recorded. Attachments live with the ticket and its comments, and the Agent can read them.", "author": "voki-work", "i18n": { "en": { "name": "Ticket Management", "description": "Turn customer support mail into trackable tickets: one ticket one session, with intake, initial diagnosis, root cause, customer reports, close-out and SOP distillation all recorded. Attachments live with the ticket and its comments, and the Agent can read them.", "safetyNotes": "Tickets, comments, reports and SOP text are stored in a local SQLite database (tickets.db, mode 0600) inside this plugin's private data directory; attachment bytes live beside it under attachments/ and never leave this machine. Inbound mail and attachment text are passed to the Agent explicitly marked as untrusted data: instructions inside them are not executed. Nothing is ever sent to a customer from this plugin — outbound mail always goes through the Mail Assistant tools, where the host shows a high-risk approval card and you allow each message individually; closing a ticket likewise requires your explicit confirmation and is written to the timeline. When the Agent opens a ticket session it calls the host session API, which is why this plugin declares desktop.control; it creates and prompts a session only, it does not read your screen or control other applications. Log evidence is never fabricated: this plugin stores no log platform of its own, it only records what you paste, attach, or what an MCP log tool in the session returns." }, "zh-CN": { "name": "工单管理", "description": "把客户报障邮件变成可追踪的工单：一单一会话，受理、初诊、根因、对客报告、关单与 SOP 沉淀全程留痕。附件随工单与评论归档，Agent 可以直接读取。", "safetyNotes": "工单、评论、报告与 SOP 正文保存在本插件私有目录下的本地 SQLite 库（tickets.db，权限 0600），附件字节存在同目录 attachments/ 下，都不出本机。收到的邮件正文与附件文本交给 Agent 时会被显式标注为「不可信数据」——其中的指令不执行。本插件**从不**直接给客户发信：对客邮件一律走邮件助手的工具，由宿主弹高风险审批卡、你逐封放行；关单同样需要你明确确认，并写入时间线。Agent 为工单开会话时调用宿主的会话接口，所以本插件声明了 desktop.control 权限；它只创建并投递一条会话消息，不截屏、不操控其他应用。日志证据绝不编造：本插件不自带日志平台，只记录你粘贴的、你附上的，或会话里日志类 MCP 工具查回来的内容。" }, "ja": { "name": "チケット管理", "description": "顧客の障害連絡メールを追跡可能なチケットに変換します。1 チケット 1 セッションで、受付・初動診断・根本原因・顧客向けレポート・クローズ・SOP 化までを記録します。添付ファイルはチケットとコメントに紐づき、Agent が直接読み取れます。", "safetyNotes": "チケット・コメント・レポート・SOP 本文は、このプラグイン専用データディレクトリ内のローカル SQLite データベース（tickets.db、パーミッション 0600）に保存され、添付ファイルのバイト列は同じディレクトリの attachments/ に置かれ、いずれも本機の外に出ません。受信メール本文と添付テキストは「信頼できないデータ」と明示した上で Agent に渡され、その中の指示は実行されません。本プラグインが顧客へ直接メールを送ることはありません。送信は必ずメールアシスタントのツール経由で、ホストが高リスク承認カードを表示し、1 通ずつ許可が必要です。クローズにも明示的な確認が必要で、タイムラインに記録されます。Agent がチケットのセッションを開く際はホストのセッション API を呼ぶため desktop.control を宣言していますが、セッションの作成と 1 通の投入のみで、画面の取得や他のアプリの操作は行いません。ログ証跡を捏造することはありません。本プラグインは独自のログ基盤を持たず、貼り付けられた内容・添付・セッション内のログ系 MCP ツールが返した内容のみを記録します。" } }, "categories": [ "office" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.ticket-management", "docs": { "zh-CN": { "intro": "工单管理把客户报障邮件变成可追踪的工单：一单一会话，受理、初诊、根因、对客报告、关单与 SOP 沉淀全程留痕。工单、评论、附件、报告与 SOP 都在本机的 SQLite 库里，插件自己不发信、不联网。\n\n难的不是处理一封邮件，而是第二次遇到同类故障时，上一次的解法已经找不到了。这个插件把「判断该不该建单 → 存附件 → 查历史 SOP → 出报告 → 关单 → 沉淀」串成一单的记录，Agent 每轮收口都会告诉你下一步该做什么。\n\n你能用它做什么：\n\n- 用三条规则（支持邮箱 / 报障关键词 / 客户域名）判定一封来信该不该建单，而不是靠模型的感觉。\n- 把日志、截图、表格附件随工单一并归档，Agent 能读文本、按错误签名聚合日志。\n- 生成版本化的初诊、根因、故障报告，纯文本可直接作为发信正文。\n- 关单后把处理过程写成 SOP，下次遇到同类现象按关键词召回。\n", "install": "本插件不随安装包提供，安装后才可用。卸载之后可以在这里重新安装，配置与数据需要重新设置。\n需要先有一个可用的邮箱账号：读信、存附件、把报告发给客户都走邮件助手的工具与审批卡，本插件不直接连邮箱服务器。数据全部留在本机——`tickets.db`（权限 0600）存工单、评论、附件索引、时间线、证据、报告与 SOP 索引，附件字节在 `attachments/` 下按 sha256 内容寻址，抽取出的文本在 `texts/`，SOP 正文是 `sop/*.md` 真文件。插件没有网络调用，也没有需要单独申请的密钥。\n\n| 设置项 | 用途 | 默认值 |\n| --- | --- | --- |\n| `supportAddresses` | 收件人里出现这些地址之一才算报障信，逗号分隔；留空跳过这一层 | 空 |\n| `intakeKeywords` | 主题或正文命中任一关键词才建单，支持 `[故障]` 这类标签写法 | `报障,故障,异常,无法,失败,报错,超时,5xx,[故障],[咨询]` |\n| `customerDomains` | 发件人域名白名单，逗号分隔（如 `blueking.com,example.cn`） | 空 |\n| `autoSession` | 建单后是否自动开会话：`incident` 只给故障单、`all` 含咨询单、`off` 等你点「开始处理」 | `incident` |\n| `maxAttachmentMb` | 单个附件上限，1–25 MB；超过的附件被拒绝并说明原因 | `25` |\n| `retentionDays` | 关单后附件保留天数；0 表示不清理（工单记录始终保留） | `0` |\n\n首次验证：\n\n1. 先在邮件助手里绑定一个邮箱，再打开侧栏「工单」面板；\n2. 在面板设置里填一条接单规则（三条全空等于所有来信都建单）；\n3. 在对话里说「有没有新的报障邮件」，助手应调用 `ticket_intake_check` 给出该不该建单的判断；\n4. 让它建单，回到面板能看到工单、附件清单与时间线。\n\n常见安装失败：\n\n- **新邮件没建单**：三条规则都填了但都没命中——任一规则命中即接单，`customerDomains` 按发件域名匹配，子域要单独写进去。\n- **附件读不出文字**：抽取只支持 docx / xlsx / pptx 与 PDF，旧版 `.doc` / `.xls` 请先另存；超过 `maxAttachmentMb` 的附件在建单前就被拒。\n- **报告发不出去**：本插件不发信，报告要靠邮件助手的 `mail_send`，需要已绑定账号并逐封批准审批卡。\n- **建单后没有会话**：`autoSession` 为 `incident` 时咨询单不自动开会话，需要手动点「开始处理」。\n", "usage": "三个常见用法：\n\n1. **批量接单**：「把收件箱里今天的报障邮件处理一下」。助手逐封调用 `ticket_intake_check`，该建的建、该归集的并到已有工单、不该接的跳过并保持邮件水位不动。\n2. **诊断与出报告**：「这张单先读附件做初诊，然后出一份对客报告」。它先列附件清单再逐条读正文，日志类给错误签名聚合，报告只交结构化小节，HTML 由插件渲染。\n3. **关单与沉淀**：「这单修好了，发报告给客户然后关单，把经验沉淀成 SOP」。发信与关单各要你明确确认一次，关单后写的 SOP 下次遇到同类现象会被召回。\n\n入口：侧栏「工单」面板（看板、工单详情六个页签、知识库）；命令「Ticket Management: Open board」与「Ticket Management: New ticket」；四份技能（邮件接单、工单处理总纲、工单处理、SOP 沉淀）会在你谈到报障、出报告、关单、沉淀时加载。\n\n| 能力 | 做什么 |\n| --- | --- |\n| `ticket_list` / `ticket_get` | 列工单、读一张工单的全貌（要素、评论、附件清单、时间线、证据、报告摘要） |\n| `ticket_create` / `ticket_update` | 建单（可带邮件指纹与初始附件）；回填或纠正要素，带 `ifRev` 冲突检测 |\n| `ticket_comment` / `ticket_advance` | 写评论并留痕；推进状态（受理、等客户、等内部、恢复、解决、关单、重开、取消） |\n| `ticket_intake_check` / `ticket_link_thread` | 判定一封来信该不该建单；把后续来信归集到已有工单，避免重复建单 |\n| `ticket_attachment_list` / `ticket_attachment_read` | 列附件（含抽取状态）；读正文，日志类附错误签名聚合，图片给本地路径 |\n| `ticket_attachment_add` / `ticket_attachment_extract` / `ticket_attachment_delete` | 从允许的三类路径导入附件、重试文本抽取、软删附件 |\n| `evidence_add` / `evidence_list` | 归档证据（日志签名、指标、截图、客户原话、命令输出），可引用附件 id |\n| `report_save` / `report_list` / `report_mark_sent` | 生成版本化报告、列报告、回写「已发送」事实（本工具不发信） |\n| `sop_search` / `sop_get` / `sop_save` / `sop_archive` | 按现象召回 SOP、读正文、新建或增强、归档 |\n| `ticket_next_action` / `ticket_open_session` | 按确定性规则算出下一步与缺失要素；为工单创建或打开专属会话 |\n| `ticket_link` / `ticket_delete` / `ticket_restore` | 关联两张工单（重复 / 相关 / 父子）；移入回收站与从回收站恢复 |\n\n不要指望它做什么：\n\n- 不发信也不联网：对客邮件只能走邮件助手的审批卡，本插件没有任何网络调用。\n- 不编造日志证据：它没有自己的日志平台，只记录你粘贴的、你附上的，或会话里日志类工具查回来的内容。\n- 不替你下结论：关单需要你确认，根因仍由你判断，助手给的是假设与取证步骤。\n" }, "ja": { "intro": "チケット管理は顧客の障害連絡メールを追跡可能なチケットに変えます。1 チケット 1 セッションで、受付・初動診断・根本原因・顧客向けレポート・クローズ・SOP 化までを記録します。チケット、コメント、添付、レポート、SOP はローカルの SQLite に保存され、プラグイン自身はメールを送らず、ネットワークにも接続しません。\n\n難しいのは 1 通のメール処理ではなく、同じ障害が 2 回目に起きたときに前回の解決策が見つからないことです。このプラグインは「チケット化すべきか判定 → 添付を保存 → 過去の SOP を検索 → レポート作成 → クローズ → 知見の蓄積」を 1 枚のチケットにまとめ、Agent は各ラウンドの締めに次にやるべきことを示します。\n\nできること:\n\n- 3 つのルール（サポート宛先 / 障害キーワード / 顧客ドメイン）で、受信メールをチケットにすべきか判定します。モデルの感覚には頼りません。\n- ログ、スクリーンショット、表計算の添付をチケットと一緒に保管し、Agent はテキストを読み、ログはエラー署名で集約できます。\n- バージョン付きの初動診断・根本原因・障害レポートを作成します。プレーンテキストはそのまま送信本文に使えます。\n- クローズ後に処理を SOP として書き、次回は同じ現象からキーワードで呼び出せます。\n", "install": "このプラグインはインストーラーに含まれません。使う前にここからインストールしてください。削除後に再度インストールできますが、設定とデータは初期状態になります。\nまず利用可能なメールアカウントが必要です。受信、添付の保存、顧客へのレポート送信はすべてメールアシスタントのツールと承認カードを経由し、このプラグインがメールサーバーへ直接接続することはありません。データはすべて本機に残ります。`tickets.db`（パーミッション 0600）にチケット、コメント、添付索引、タイムライン、証跡、レポート、SOP 索引を保存し、添付のバイト列は `attachments/` に sha256 で内容アドレス指定して置き、抽出テキストは `texts/`、SOP 本文は `sop/*.md` の実ファイルです。ネットワーク呼び出しも、別途取得する鍵もありません。\n\n| 設定項目 | 用途 | 既定値 |\n| --- | --- | --- |\n| `supportAddresses` | 宛先にこのいずれかが含まれるメールだけを障害連絡とみなします（カンマ区切り）。空欄ならこの判定を省略 | 空 |\n| `intakeKeywords` | 件名または本文がいずれかのキーワードに一致したときだけチケットを作成。`[故障]` のようなタグ形式も可 | `报障,故障,异常,无法,失败,报错,超时,5xx,[故障],[咨询]` |\n| `customerDomains` | 送信者ドメインの許可リスト（カンマ区切り、例 `blueking.com,example.cn`） | 空 |\n| `autoSession` | チケット作成後にセッションを自動で開くか。`incident` は障害のみ、`all` は問い合わせも、`off` は手動で開始 | `incident` |\n| `maxAttachmentMb` | 添付 1 件の上限（1〜25 MB）。超えた添付は理由付きで拒否されます | `25` |\n| `retentionDays` | クローズ後の添付保持日数。0 は削除しない（チケット記録は常に残ります） | `0` |\n\n最初の確認:\n\n1. まずメールアシスタントでメールボックスをバインドし、サイドバーの「チケット」パネルを開きます。\n2. パネルの設定で受付ルールを 1 つ入力します（3 つすべて空欄なら、すべての受信メールがチケットになります）。\n3. チャットで「新しい障害連絡はある？」と伝えると、`ticket_intake_check` がチケット化すべきかの判定を返します。\n4. そのままチケットを作成させ、パネルにチケット・添付一覧・タイムラインが表示されることを確認します。\n\nよくある導入の失敗:\n\n- **新着メールでチケットが作られない**: 3 つのルールを設定したがどれにも一致していません。いずれか 1 つが一致すれば受付です。`customerDomains` は送信者ドメインで判定するため、サブドメインは個別に書きます。\n- **添付のテキストが読めない**: 抽出は docx / xlsx / pptx と PDF のみ対応です。旧形式の `.doc` / `.xls` は別形式で保存し直してください。`maxAttachmentMb` を超える添付は受付前に拒否されます。\n- **レポートを送れない**: このプラグインはメールを送りません。メールアシスタントの `mail_send` を使うため、バインド済みアカウントと 1 通ごとの承認が必要です。\n- **チケット作成後にセッションが開かない**: `autoSession` が `incident` のとき、問い合わせは自動でセッションを作りません。手動で開始してください。\n", "usage": "よくある 3 つの依頼:\n\n1. **まとめて受付**: 「受信トレイの今日の障害連絡を処理して」。`ticket_intake_check` を 1 通ずつ呼び、作るべきものは作り、継続メールは既存チケットへ寄せ、受けないものは水位を動かさずに飛ばします。\n2. **診断とレポート**: 「このチケットの添付を読んで初動診断して、顧客向けレポートを出して」。添付一覧を見てから本文を読み、ログはエラー署名を集約し、レポートは構造化されたセクションのみを渡します（HTML はプラグインが描画します）。\n3. **クローズと蓄積**: 「直ったので顧客にレポートを送ってクローズして、知見を SOP にして」。送信とクローズはそれぞれ明示的な確認が必要で、クローズ時に書いた SOP は次回同じ現象で呼び出されます。\n\n入口: サイドバーの「チケット」パネル（ボード、6 タブのチケット詳細、ナレッジベース）、コマンド「Ticket Management: Open board」「Ticket Management: New ticket」、そして 4 つのスキル（メール受付、チケット処理総綱、チケット処理、SOP 化）が、障害・レポート・クローズ・蓄積の話題で読み込まれます。\n\n| 機能 | 内容 |\n| --- | --- |\n| `ticket_list` / `ticket_get` | チケット一覧、1 枚の全体像（要素、コメント、添付一覧、タイムライン、証跡、レポート要約） |\n| `ticket_create` / `ticket_update` | チケット作成（メール指紋と初期添付も可）。要素の補完・修正は `ifRev` による競合検出付き |\n| `ticket_comment` / `ticket_advance` | コメントを残してタイムラインに記録。状態を進める（受付、顧客待ち、社内待ち、再開、解決、クローズ、再オープン、キャンセル） |\n| `ticket_intake_check` / `ticket_link_thread` | 受信メールがチケットか判定。継続メールを既存チケットへ寄せ、重複作成を避ける |\n| `ticket_attachment_list` / `ticket_attachment_read` | 添付一覧（抽出入力状態付き）。本文を読み、ログはエラー署名集約、画像はローカルパスを返す |\n| `ticket_attachment_add` / `ticket_attachment_extract` / `ticket_attachment_delete` | 許可された 3 種類のパスから添付を取り込み、抽出生を再試行し、論理削除する |\n| `evidence_add` / `evidence_list` | 証跡（ログ署名、メトリクス、スクリーンショット、顧客の発言、コマンド出力）を保管。添付 id を参照可能 |\n| `report_save` / `report_list` / `report_mark_sent` | バージョン付きレポートの保存、一覧、送信済み事実の記録（このツールは送信しません） |\n| `sop_search` / `sop_get` / `sop_save` / `sop_archive` | 現象から SOP を呼び出し、本文を読み、新規作成または追記し、アーカイブする |\n| `ticket_next_action` / `ticket_open_session` | 決定的なルールで次の行動と不足要素を算出。チケット専用セッションを作成または開く |\n| `ticket_link` / `ticket_delete` / `ticket_restore` | 2 枚のチケットを関連付け（重複 / 関連 / 親子）。ゴミ箱への移動と復元 |\n\n期待しないでください:\n\n- メール送信やネットワーク接続: 顧客向けメールはメールアシスタントの承認カード経由のみで、このプラグインにネットワーク呼び出しはありません。\n- ログ証跡の創作: 独自のログ基盤は持たず、貼り付けられた内容、添付、セッション内のログ系ツールが返した内容だけを記録します。\n- 判断の肩代わり: クローズには確認が必要で、根本原因はご自身の判断です。アシスタントが示すのは仮説と証拠集めの手順です。\n" }, "en": { "intro": "Ticket Management turns customer report mail into trackable tickets: one ticket, one session, with intake, initial diagnosis, root cause, customer reports, close-out and SOP distillation all recorded. Tickets, comments, attachments, reports and SOP text stay in a local SQLite database, and the plugin never sends mail or makes network calls itself.\n\nThe hard part is not handling one email — it is that the second time the same failure shows up, last time's solution is already lost. This plugin puts \"decide whether this is a ticket → store the attachment → search past SOPs → write the report → close → distill\" onto one ticket, and at the end of each round the Agent tells you what the next step is.\n\nWhat you can do with it:\n\n- Decide whether an incoming email is a ticket from three rules (support address / report keywords / customer domains) instead of the model's gut feeling.\n- Archive logs, screenshots and spreadsheets with the ticket; the Agent can read text and aggregate log error signatures.\n- Produce versioned initial-diagnosis, root-cause and incident reports; the plain text can be the mail body directly.\n- After close-out, write the handling into an SOP that is recalled by symptom next time.\n", "install": "This plugin is not part of the installer: install it here before using it. After removing it you can reinstall it here, but its settings and data start over.\nYou need a working mailbox first: reading mail, storing attachments and sending reports to the customer all go through Mail Assistant's tools and approval cards — this plugin never talks to a mail server directly. All data stays on this machine. `tickets.db` (mode 0600) holds tickets, comments, the attachment index, the timeline, evidence, reports and the SOP index; attachment bytes live under `attachments/`, content-addressed by sha256; extracted text goes to `texts/`; SOP bodies are real files under `sop/*.md`. The plugin has no network calls and no separate keys to request.\n\n| Setting | Purpose | Default |\n| --- | --- | --- |\n| `supportAddresses` | Only mail addressed to one of these entries counts as a report, comma-separated; empty skips this rule | empty |\n| `intakeKeywords` | A ticket is created only when the subject or body matches a keyword; tag forms such as `[故障]` work | `报障,故障,异常,无法,失败,报错,超时,5xx,[故障],[咨询]` |\n| `customerDomains` | Sender domain allow list, comma-separated (for example `blueking.com,example.cn`) | empty |\n| `autoSession` | Auto-start a session after creating a ticket: `incident` only for incidents, `all` also for inquiries, `off` waits for you to click Start | `incident` |\n| `maxAttachmentMb` | Per-attachment limit, 1–25 MB; larger attachments are rejected with a reason | `25` |\n| `retentionDays` | Attachment retention after close, in days; 0 keeps them (ticket records always stay) | `0` |\n\nFirst verification:\n\n1. Bind a mailbox in Mail Assistant first, then open the \"Tickets\" panel in the sidebar;\n2. Fill in one intake rule in the panel settings (all three empty means every incoming mail becomes a ticket);\n3. In the chat say \"is there any new report mail\" — the assistant should call `ticket_intake_check` and answer whether each one is a ticket;\n4. Let it create a ticket, then check the panel: ticket, attachment list and timeline should be there.\n\nCommon install failures:\n\n- **New mail does not create a ticket**: all three rules are set and none matched. Any single matching rule is enough; `customerDomains` matches the sender domain, so subdomains must be listed explicitly.\n- **Attachment text cannot be read**: extraction supports docx / xlsx / pptx and PDF only — save legacy `.doc` / `.xls` to a new format first; attachments over `maxAttachmentMb` are rejected before intake.\n- **The report cannot be sent**: this plugin does not send mail; the report goes through Mail Assistant's `mail_send`, which needs a bound account and a per-message approval card.\n- **No session after creating a ticket**: with `autoSession` at `incident`, inquiries do not get a session automatically; click Start yourself.\n", "usage": "Three common things to ask for:\n\n1. **Batch intake**: \"Process today's report mail in the inbox.\" The assistant calls `ticket_intake_check` per message, creates what should be created, folds follow-ups into existing tickets, skips what should not be taken, and leaves the mail watermark untouched for those.\n2. **Diagnose and report**: \"Read the attachments on this ticket, do the initial diagnosis, then write a customer report.\" It lists attachments before reading bodies, aggregates error signatures for logs, and submits structured sections only — the plugin renders the HTML.\n3. **Close and distill**: \"This one is fixed — send the report to the customer, close the ticket, and write the experience into an SOP.\" Sending and closing each need an explicit confirmation from you, and the SOP written at close-out is recalled for the same symptom next time.\n\nEntry points: the \"Tickets\" panel in the sidebar (board, a ticket detail with six tabs, knowledge base); the commands \"Ticket Management: Open board\" and \"Ticket Management: New ticket\"; four skills (mail intake, ticket handling overview, ticket handling, SOP distillation) load when you talk about reports, handling, closing or distilling.\n\n| Capability | What it does |\n| --- | --- |\n| `ticket_list` / `ticket_get` | List tickets; read one ticket in full (fields, comments, attachment list, timeline, evidence, report summaries) |\n| `ticket_create` / `ticket_update` | Create a ticket (optionally with a mail fingerprint and initial attachments); fill in or correct fields with `ifRev` conflict detection |\n| `ticket_comment` / `ticket_advance` | Write a comment and record it on the timeline; advance status (accept, waiting on customer, waiting internally, resume, resolve, close, reopen, cancel) |\n| `ticket_intake_check` / `ticket_link_thread` | Decide whether an email is a ticket; fold follow-up mail into an existing ticket instead of creating a duplicate |\n| `ticket_attachment_list` / `ticket_attachment_read` | List attachments with extraction status; read text, with log signature aggregation and a local path for images |\n| `ticket_attachment_add` / `ticket_attachment_extract` / `ticket_attachment_delete` | Import attachments from the three allowed paths, retry extraction, soft-delete an attachment |\n| `evidence_add` / `evidence_list` | Archive evidence (log signatures, metrics, screenshots, customer quotes, command output), referencing an attachment id |\n| `report_save` / `report_list` / `report_mark_sent` | Save a versioned report, list reports, record that a report was sent (this tool does not send mail) |\n| `sop_search` / `sop_get` / `sop_save` / `sop_archive` | Recall SOPs by symptom, read the body, create or extend one, archive it |\n| `ticket_next_action` / `ticket_open_session` | Compute the next step and missing fields by deterministic rules; create or open the ticket's own session |\n| `ticket_link` / `ticket_delete` / `ticket_restore` | Link two tickets (duplicate / related / parent); move a ticket to the recycle bin and restore it |\n\nDo not expect it to:\n\n- Send mail or reach the network: customer mail goes only through Mail Assistant's approval card; this plugin makes no network calls at all.\n- Invent log evidence: it has no log platform of its own and records only what you paste, attach, or what a log tool in the session returns.\n- Decide for you: closing needs your confirmation, root cause stays your judgement, and the assistant offers hypotheses and evidence-gathering steps.\n" } }, "versions": [ { "version": "1.4.1", "publishedAt": "2026-10-31T00:00:00Z", "changelog": "修一个只有盯着图标才看得出来、而且从 1.0.0 起就在的问题：工作面板「新建」启动器里\n「工单」一直是**标题首字母贴片**（「工」），不是列表图标。\n\n`contributes.views[0].icon` 写的是 `\"list\"`，但宿主的 icon 是**闭集**\n（`PLUGIN_VIEW_ICONS`，ADR 0104：插件只给 token、不给 SVG），里面没有 `list`，只有\n`list-checks`。宿主对认不出的 token 按设计降级成首字母贴片——不报错、不写日志，\n所以这个拼错的 token 一直看起来像「设计如此」，而不是像 bug。\n\n改为 `list-checks`，并补一条**跨插件**的守卫测试（`plugin-work-panel-views`：每个内置插件\n视图声明的 icon 必须落在 SDK 公布的 token 里）。只改本插件的话，下一个插件还会写错，\n而且同样没人发现。\n\n本插件以市场分发（`distribution.json` 的 `marketOnly`），所以必须抬版本：只改 manifest\n不抬版本的话，已装 1.4.0 的用户会被判为「已是最新」，永远拿不到这个修复。", "minPiDesktop": ">=0.8.0", "shasum": "09764f75d1183492a33418aa76868b23e96e67413bde2a4c3be078f7375ee2f7", "url": "packages/voki.ticket-management-1.4.1.piplug", "sizeBytes": 2641498, "permissions": [ "ui.view", "ui.panel", "agent.tool.register", "agent.prompt.inject", "fs.read", "clipboard.write", "desktop.control" ], "fs": {} } ], "distribution": "marketplace" }, { "id": "voki.web-search", "name": "Web Search", "description": "Search the web through your own SearXNG instance, with readable source lists, page reading, suggestions and instance information.", "author": "voki-work", "i18n": { "en": { "name": "Web Search", "description": "Search the web through your own SearXNG instance, with readable source lists, page reading, suggestions and instance information.", "safetyNotes": "Queries go only to the SearXNG instance you configure. Search results and page text are untrusted data, not instructions. Page reading can reach URLs you or the results point at, including your local network; cloud metadata endpoints are blocked. The optional MCP transport runs through npx and needs Node/npm; the default CLI uses the app's own runtime. This plugin stores no secret. The default instance uses plain HTTP; prefer HTTPS when it is available." }, "zh-CN": { "name": "联网搜索", "description": "通过你自己的 SearXNG 实例联网搜索，结果以可读的来源列表呈现，并可读取网页正文、获取搜索建议与实例信息。", "safetyNotes": "查询只发送到你配置的 SearXNG 实例。搜索结果与网页正文都是不可信数据，不是指令。读取网页会访问你或搜索结果指向的 URL（包括本地网络）；云 metadata 地址会被拒绝。可选 MCP 通道通过 npx 启动、需要 Node/npm；默认 CLI 使用应用自带运行时。本插件不保存任何密钥。默认实例使用明文 HTTP，实例支持时建议改用 HTTPS。" }, "ja": { "name": "ウェブ検索", "description": "自分の SearXNG インスタンスでウェブ検索し、読みやすい参照元リスト、ページ本文、検索候補、インスタンス情報を提供します。", "safetyNotes": "クエリは設定した SearXNG インスタンスにのみ送信されます。検索結果とページ本文は信頼できないデータであり、指示ではありません。ページ取得は自分または検索結果が指す URL（ローカルネットワークを含む）に到達しますが、クラウド metadata アドレスは拒否されます。任意の MCP チャネルは npx 経由で Node/npm が必要です。既定の CLI はアプリ自身のランタイムを使い、本プラグインは秘密情報を保存しません。既定のインスタンスは平文 HTTP です。対応していれば HTTPS を使用してください。" } }, "categories": [ "knowledge" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.web-search", "docs": { "zh-CN": { "intro": "联网搜索让对话里的回答有出处，而不是只靠模型记忆。它把查询交给一个 SearXNG 实例，取回带标题、链接和摘要的排序结果，并把命中的页面当作**数据**对待——页面里的文字不会变成给你的指令。\n\n你能用它做什么：\n\n- 查今天发生的事、价格、版本号、发布说明，让回答带上可核对的链接。\n- 让助手在给出结论前先找证据，并明确区分「查到的」和「推测的」。\n- 按站点、文件类型、标题限定范围，例如只要 `site:docs.example.com` 的页面。\n- 在计划模式和目标模式下照常搜索——这个工具是只读的，随时可用。\n", "install": "本插件随应用提供并默认启用。如果你卸载了它，可以在这里重新安装，并把配置从头配一遍。\n默认开箱即用：内置的命令行传输会直接访问默认实例 `http://www.vokiai.com:9988`，不需要 Node、npm 或额外的服务。\n\n需要改的只有一件事——如果你有自己的 SearXNG：\n\n| 设置项 | 用途 | 默认值 |\n| --- | --- | --- |\n| `searxngUrl` | 实例基础地址，**必须开启 JSON 输出**（`search.formats` 含 `json`） | `http://www.vokiai.com:9988` |\n| `transport` | `cli` 用内置命令行；`mcp` 用 `mcp-searxng` 子进程，需要本机有 Node | `cli` |\n| `maxResults` | 每次搜索保留的结果数，1–20 | `8` |\n| `language` | 语言代码，例如 `zh-CN`、`en`、`ja`；留空交给实例决定 | 空 |\n| `safesearch` | `0` 关闭、`1` 中等、`2` 严格 | `0` |\n| `requestTimeoutMs` | 单次请求超时，2000–30000 毫秒 | `15000` |\n\n首次验证：\n\n1. 打开「扩展 → 联网搜索」，确认实例地址没有报错；\n2. 在对话里说「用联网搜索查一下 Vite 6 的发布时间」；\n3. 回答里应出现可点开的链接，并且助手说明它引用了哪一条。\n\n常见安装失败：\n\n- **实例返回 403 或 HTML**：`search.formats` 没有包含 `json`，SearXNG 只肯给网页结果。\n- **`mcp` 传输报找不到命令**：本机没有可用的 `node`/`npm`；切回 `cli` 即可，两者搜索能力等价。\n- **改完设置没生效**：切换 `transport` 后要先禁用再启用插件。\n", "usage": "三个常见用法：\n\n1. **核对事实**：「查一下 2026 年 10 月 Vue 的最新稳定版本，并给出官方发布说明的链接」。助手会先把查询压成关键词，再逐条引用。\n2. **限定范围**：「只搜 docs.microsoft.com 上关于 Graph API 增量查询的内容」。\n3. **做调研底稿**：「把这周关于 EU AI Act 的三条主要变化找出来，按时间排列」。\n\n在对话里不需要点名工具，说清「要查、要出处」就够了。需要精确控制时，可以直说要求：`site:` 限定站点、`filetype:pdf` 限定格式、`intitle:` 限定标题，或者「翻到第 2 页」「最多给我 5 条」。\n\n不要指望它做什么：\n\n- 它不是浏览器：结果只有标题、链接、摘要，正文要另行打开（可以用浏览器插件）。\n- 它不会替你做判断：检索结果属于不可信输入，结论仍由助手基于多条来源给出。\n- 它不绕过网络设置：出口白名单、代理和元数据地址拒绝都由宿主执行。\n" }, "ja": { "intro": "Web 検索は、モデルの記憶だけに頼らず、根拠となる出典を回答に添えるためのプラグインです。クエリを SearXNG インスタンスへ送り、タイトル・リンク・要約を伴う順位付きの結果を受け取ります。取得したページはすべて**データ**として扱われ、ページ上の文章が指示として解釈されることはありません。\n\nできること:\n\n- 今日の出来事、価格、バージョン番号、リリースノートを調べ、自分で確認できるリンクを付けて回答させられます。\n- 結論の前に根拠を探させ、「見つかったこと」と「推測したこと」を分けて示させられます。\n- サイト、ファイル種別、タイトルで範囲を絞れます（例: `site:docs.example.com` のページだけ）。\n- プランモードやゴールモードでもそのまま使えます。読み取り専用のツールだからです。\n", "install": "このプラグインはアプリに同梱され、既定で有効です。削除した場合はここから再インストールし、あらためて設定してください。\nすぐに使えます。同梱のコマンドライン経由で既定のインスタンス `http://www.vokiai.com:9988` に接続するため、Node も npm も追加サービスも不要です。\n\n変更が必要なのは、自前の SearXNG を使う場合の接続先だけです:\n\n| 設定項目 | 用途 | 既定値 |\n| --- | --- | --- |\n| `searxngUrl` | インスタンスのベース URL。**JSON 出力が有効**である必要があります（`search.formats` に `json` を含める）。 | `http://www.vokiai.com:9988` |\n| `transport` | `cli` は同梱のコマンドライン、`mcp` は `mcp-searxng` 子プロセス（ローカルの Node が必要）。 | `cli` |\n| `maxResults` | 1 回の検索で残す件数（1〜20）。 | `8` |\n| `language` | `zh-CN`、`en`、`ja` などの言語コード。空ならインスタンスの判断に任せます。 | 空 |\n| `safesearch` | `0` オフ、`1` 中程度、`2` 厳格。 | `0` |\n| `requestTimeoutMs` | 1 リクエストのタイムアウト（2000〜30000 ミリ秒）。 | `15000` |\n\n最初の確認:\n\n1. 「拡張機能 → Web 検索」を開き、インスタンス URL にエラーが出ていないことを確認します。\n2. 会話で「Vite 6 のリリース時期を Web で調べて」と依頼します。\n3. クリックできるリンクが回答に含まれ、どの結果を使ったかをアシスタントが述べれば成功です。\n\nよくあるつまずき:\n\n- **インスタンスが 403 を返す、または HTML が返る**: `search.formats` に `json` が無く、SearXNG が Web UI しか返していません。\n- **`mcp` でコマンドが見つからない**: ローカルに使える `node`/`npm` がありません。`cli` に戻せば検索能力は同じです。\n- **設定を変えても反映されない**: `transport` を切り替えたら、プラグインを無効化してから再度有効にしてください。\n", "usage": "とくに役立つのは次の三つです:\n\n1. **事実確認**: 「2026 年 10 月時点の Vue の最新安定版を調べて、公式リリースノートのリンクを出して」。アシスタントはキーワードに整理し、結果を一つずつ引用します。\n2. **サイト内検索**: 「docs.microsoft.com の中だけから Graph API の差分クエリについて探して」。\n3. **調査の下地づくり**: 「今週の EU AI Act の主な変更を三つ挙げて、日付順に並べて」。\n\n会話でツール名を指定する必要はありません。「調べて」「出典付きで」と伝えれば足ります。細かく制御したいときは、そのまま指示してください。`site:` でサイトを固定、`filetype:pdf` で形式を固定、`intitle:` でタイトルを固定、「2 ページ目を見て」「最大 5 件で」も通ります。\n\n期待しないでほしいこと:\n\n- ブラウザではありません。結果はタイトル・リンク・要約だけなので、本文は別途開いてください（ブラウザプラグインが使えます）。\n- 判断は代行しません。検索結果は信頼できない入力であり、結論は複数の出典に基づいて出されます。\n- ネットワーク設定を迂回しません。送信先の許可リスト、プロキシ、メタデータアドレスの拒否はすべてホスト側で実施されます。\n" }, "en": { "intro": "Web search lets an answer cite its sources instead of relying on what the model remembers. The plugin sends your query to a SearXNG instance, gets back ranked results with title, link and snippet, and treats every fetched page as **data** — text on a page never becomes an instruction to you.\n\nWhat you can do with it:\n\n- Look up something that happened today, a price, a version number or a release note, and get links you can check yourself.\n- Ask the assistant to find evidence before it concludes, and to keep \"what I found\" and \"what I infer\" apart.\n- Narrow a search by site, file type or title, for example only pages from `site:docs.example.com`.\n- Search in plan and goal mode as usual — the tool is read-only and always available.\n", "install": "This plugin ships with the app and is on by default. If you removed it, install it here to bring it back, then set it up again.\nIt works out of the box: the bundled command-line transport talks to the default instance at `http://www.vokiai.com:9988`, so no Node, npm or extra service is needed.\n\nThe only thing worth changing is where the searches go, and only if you run your own SearXNG:\n\n| Setting | What it does | Default |\n| --- | --- | --- |\n| `searxngUrl` | Base URL of the instance. It **must allow JSON output** (`search.formats` includes `json`). | `http://www.vokiai.com:9988` |\n| `transport` | `cli` uses the bundled command line; `mcp` runs the `mcp-searxng` child process and needs a local Node. | `cli` |\n| `maxResults` | Results kept per search, 1–20. | `8` |\n| `language` | Language code such as `zh-CN`, `en` or `ja`; leave empty to let the instance decide. | empty |\n| `safesearch` | `0` off, `1` moderate, `2` strict. | `0` |\n| `requestTimeoutMs` | Per-request timeout, 2000–30000 ms. | `15000` |\n\nFirst check:\n\n1. Open \"Extensions → Web search\" and confirm the instance URL reports no error.\n2. In a conversation ask: \"search the web for when Vite 6 was released\".\n3. The answer should contain links you can click, and the assistant should say which result it used.\n\nCommon install failures:\n\n- **The instance answers 403 or with HTML**: `search.formats` does not include `json`, so SearXNG only serves the web UI.\n- **`mcp` transport says the command is missing**: there is no usable `node`/`npm` on this machine; switch back to `cli`, which searches just as well.\n- **A settings change did nothing**: after switching `transport`, disable the plugin and enable it again.\n", "usage": "Three things it is good at:\n\n1. **Checking a fact**: \"look up the latest stable Vue release as of October 2026 and give me the official release note link\". The assistant turns that into keywords and cites the results one by one.\n2. **Searching inside one site**: \"only search docs.microsoft.com for Graph API delta queries\".\n3. **Building a research base**: \"find the three main changes to the EU AI Act this week and put them in date order\".\n\nYou do not name the tool in a conversation — saying that you want something looked up, with sources, is enough. When you need precision, say it directly: `site:` to pin a site, `filetype:pdf` to pin a format, `intitle:` to pin the title, or \"go to page 2\" and \"give me at most 5 results\".\n\nWhat not to expect:\n\n- It is not a browser: results carry only title, link and snippet. Open the page itself separately (the browser plugin does that).\n- It does not decide for you: search results are untrusted input, and the conclusion still comes from several sources.\n- It does not bypass your network settings: the egress allowlist, the proxy and the metadata-address refusal are all enforced by the host.\n" } }, "versions": [ { "version": "1.1.1", "publishedAt": "2026-10-26T00:00:00Z", "changelog": "更新默认实例并修复原生搜索在部分 SearXNG 上的永久挂起。\n\n- 默认 `searxngUrl` 与 `net.domains` 改为 `http://www.vokiai.com:9988`。已保存的\n `searxngUrl` 不会被自动覆盖；升级后如需切换实例，请在插件设置中修改。\n- 原生搜索固定使用宿主直连的 Node 传输：SearXNG 的 `server-timing` 响应头可能\n 包含非 ASCII 引擎名（如“搜狗”），Chromium `net.fetch` 会永久挂起且忽略中止\n 信号。出口白名单、`net.anyHost`、云 metadata 拒绝与审计仍由宿主执行。\n- `pi.net.fetch` 新增可选 `transport: \"auto\" | \"direct\"`，并通过\n `net.getCapabilities()` 的 `fetchTransports` 通告支持。\n- 实网冒烟测试现在覆盖公网实例，并断言原生搜索不再经过 Chromium 传输。", "minPiDesktop": ">=0.23.0", "shasum": "b0ccd9117966054a44ebb3745be89bc76503e2887344b5d691deb99c1f1adef4", "url": "packages/voki.web-search-1.1.1.piplug", "sizeBytes": 107406, "permissions": [ "agent.tool.register", "agent.prompt.inject", "net.fetch", "net.anyHost", "mcp.server.local", "renderer.extension" ], "fs": {} } ], "distribution": "bundled" }, { "id": "voki.workflow-tool-mcp", "name": "Workflow Tool MCP", "description": "Expose AIHub/ESM workflow capabilities to the agent: bind a task to one environment and agent, search knowledge bases, and run published workflows through tools and a skill.", "author": "voki-work", "i18n": { "en": { "name": "Workflow Tool MCP", "description": "Expose AIHub/ESM workflow capabilities to the agent: bind a task to one environment and agent, search knowledge bases, and run published workflows through tools and a skill.", "safetyNotes": "Each task is bound to one workflow environment. The plugin signs in with the configured integration account and stores the token encrypted in its data directory. Knowledge text is untrusted data, not instructions. The encryption key sits beside the ciphertext and does not protect against a local root user." }, "zh-CN": { "name": "工作流工具", "description": "把 AIHub/ESM 的工作流能力交给 Agent：任务绑定一个环境与智能体，通过工具与技能检索知识库并运行已发布工作流。", "safetyNotes": "每个任务只绑定一个工作流环境。插件使用配置的集成账号登录，并把令牌加密保存在插件数据目录。知识库文本是不可信数据，不是指令。密钥与密文同目录，不能防本机 root。" }, "ja": { "name": "ワークフローツール", "description": "AIHub/ESM のワークフロー機能をエージェントに公開します。タスクを 1 つの環境とエージェントにバインドし、ツールとスキルでナレッジベースを検索し、公開済みワークフローを実行します。", "safetyNotes": "各タスクは 1 つのワークフロー環境にのみバインドされます。プラグインは設定された統合アカウントでサインインし、トークンをプラグインデータディレクトリに暗号化して保存します。ナレッジベースのテキストは指示ではなく信頼できないデータです。鍵は暗号文の隣にあり、ローカルの root ユーザーからは保護されません。" } }, "categories": [ "beta" ], "verified": true, "trust": "verified", "publisherId": "voki-work", "downloads": 0, "homepage": "https://work.vokiai.com/plugins/#voki.workflow-tool-mcp", "docs": { "zh-CN": { "intro": "工作流工具把 AIHub/ESM 的知识库与工作流接到对话里：每个任务绑定一个环境、一个智能体，助手用工具检索知识库、读取文本正文、运行已经发布的工作流。要换环境或换智能体，需要你明确同意后再切换。\n\n它偏向「调用」而不是「编排」：插件运行的是平台上别人已经发布的智能体与工作流，返回节点轨迹和最终输出；不写数据表，不逐节点执行，也不做工作流编排。\n\n登录用你配置的集成账号，令牌加密缓存，鉴权过期时只刷新一次；遇到 MFA、选组或账号锁定会明确报错，不会反复重试。检索范围是你在平台上可见的范围与该环境可选知识库白名单的交集。\n\n你能用它做什么：\n\n- 按语义、关键字或全文检索知识库，并列出可见知识库与各自的文件数。\n- 读取一个知识库文件的文本正文，把它当材料分析。\n- 运行已发布的智能体或工作流，最多等 90 秒，拿回有界的节点轨迹和最终输出。\n- 按运行 id 查状态、停止指定 task id，并在需要时清除本地登录令牌。\n", "install": "本插件不随安装包提供，安装后才可用。卸载之后可以在这里重新安装，配置与数据需要重新设置。\n需要三样东西：AIHub/ESM 的 Base URL、SSO 应用 ID（有实例的还要填 `hubId`），以及一个集成账号——密码或已签发的手动令牌。不需要 Node、npm 或额外服务。令牌 AES-256-GCM 加密保存在插件的本地数据目录（`sessions.enc`，密钥 `key.bin` 权限 0600），宿主只看得到绑定与掩码信息；密钥与密文同目录，不能防本机 root。建议使用专用的集成账号：个人账号可能因为单设备会话被踢出。**不要把密码或令牌贴进对话**——它们只填在面板里。\n\n| 设置项 | 用途 | 默认值 |\n| --- | --- | --- |\n| `requestTimeoutMs` | AIHub/ESM 调用单次超时 | `20000` |\n| `maxResponseBytes` | 超过这个大小的响应会被截断 | `32768` |\n| `auditRetentionDays` | 启动时删除早于该天数的审计日志 | `30` |\n\n首次验证：\n\n1. 打开命令「工作流工具设置」，添加一个环境：名称、Base URL、SSO 应用 ID，选择密码或令牌登录，点击「测试连接」。\n2. 回到对话说「用工作流工具查一下这个环境里有哪些智能体」——助手会先列出环境、绑定当前任务，再按场景列出智能体。\n3. 说「在知识库里搜一下报销政策」——助手会检索并返回命中的条目与来源，正文按需再读。\n\n常见安装失败：\n\n- **测试连接返回鉴权失败**：SSO 应用 ID 或环境地址填错，或这个账号在平台上没有对应的可见范围；先确认能登录平台再回来填。\n- **提示 MFA、选组或账号被锁**：插件不代填二次验证；在平台网页登录一次完成选组，或换一个集成账号。\n- **工作流运行报超时**：单次运行最多等 90 秒，更长的流程会返回 `WF_RUN_TIMEOUT`，任务可能仍在平台上运行；用 `workflow_run_status` 按 id 查，不要重复提交。\n", "usage": "三个常见用法：\n\n1. **取知识库答案**：「在知识库里查一下差旅报销的标准，给我原文出处」。助手会调 `workflow_search_knowledge` 检索，必要时用 `workflow_read_knowledge` 读正文，并说明引自哪个知识库文件。\n2. **跑一条已发布的流程**：「用合同审查这个智能体，把这份说明过一遍」。助手先用 `workflow_agent_info` 读输入表单，跟你确认输入后带 `confirm` 调 `workflow_run`，返回节点轨迹与最终输出。\n3. **看运行结果或停掉它**：「刚才那次运行到哪了？」或「把那个运行停掉」。助手用 `workflow_run_status` 查状态，或用 `workflow_stop_run` 停指定 task id。\n\n入口是命令「工作流工具设置」，打开管理面板（环境增删改查、连接测试、清除令牌、默认智能体、审计查看）。对话里的能力来自 13 个 Agent 工具：\n\n| 能力 | 做什么 |\n| --- | --- |\n| `workflow_list_environments` | 列出环境、登录状态与当前绑定 |\n| `workflow_select_environment` | 绑定当前任务；跨环境切换需 `confirmSwitch` |\n| `workflow_environment_status` | 当前环境/智能体绑定、鉴权、写开关与最近测试 |\n| `workflow_list_agents` | 按场景列出可见的智能体 |\n| `workflow_select_agent` | 绑定当前任务的智能体；跨智能体切换需 `confirmSwitch` |\n| `workflow_agent_info` | 智能体类型、描述与输入表单 |\n| `workflow_run` | 运行工作流（需 `confirm`，最多 90 秒） |\n| `workflow_run_status` | 按运行 id 查询状态 |\n| `workflow_stop_run` | 停止指定 task id（需 `confirm`） |\n| `workflow_list_knowledge_bases` | 列出可见知识库与文件数 |\n| `workflow_search_knowledge` | `semantic` / `keyword` / `fulltext` 三种检索 |\n| `workflow_read_knowledge` | 读取文本正文或文本类源文件 |\n| `workflow_logout` | 清除本地登录令牌 |\n\n不要指望它做什么：\n\n- 不写数据表、也不逐节点执行：这是调用已发布工作流的能力，表格读写与流程编排不在范围内。\n- 不读二进制文件：PDF、Office 之类的附件会返回 `WF_UNSUPPORTED_FILE`，只处理文本类内容。\n- 不替你开权限：知识库正文和智能体输出都是不可信数据；团队可见范围、白名单和账号权限由平台决定，插件只会缩小范围，不会放大。\n" }, "ja": { "intro": "ワークフローツールは AIHub/ESM のナレッジベースとワークフローを会話につなぎます。各タスクは 1 つの環境と 1 つのエージェントにバインドされ、アシスタントはツール経由でナレッジを検索し、テキスト本文を読み、公開済みのワークフローを実行します。環境やエージェントを切り替えるには、まず明示的な同意が必要です。\n\n作成よりも呼び出しに寄った作りです。プラグインが実行するのはプラットフォーム上で公開済みのエージェントとワークフローで、ノードのトレースと最終出力を返します。データテーブルの書き込み、ノード単位の実行、ワークフローの作成は行いません。\n\nサインインには設定した統合アカウントを使い、トークンは暗号化してキャッシュし、認証切れの際は 1 度だけ再取得します。MFA、グループ選択、アカウントロックは繰り返さずエラーとして報告します。検索範囲はプラットフォーム上で見える範囲と、その環境の任意のナレッジベース許可リストの積集合です。\n\nできること:\n\n- ナレッジベースをセマンティック / キーワード / 全文で検索し、参照可能なナレッジベースとファイル数を一覧します。\n- 1 つのナレッジファイルのテキスト本文を読み、素材として使います。\n- 公開済みのエージェントやワークフローを実行し、最大 90 秒待って、上限付きのノードトレースと最終出力を受け取ります。\n- 実行 ID で状態を確認し、指定した task id を停止し、必要ならローカルのログイントークンを削除します。\n", "install": "このプラグインはインストーラーに含まれません。使う前にここからインストールしてください。削除後に再度インストールできますが、設定とデータは初期状態になります。\n必要なのは 3 つです。AIHub/ESM の Base URL、SSO アプリケーション ID（インスタンスのある環境では `hubId` も）、そして統合アカウント（パスワードまたは発行済みの手動トークン）。Node、npm、追加サービスは不要です。トークンは AES-256-GCM でプラグインのローカルデータディレクトリに暗号化して保存され（`sessions.enc`、鍵ファイル `key.bin` はパーミッション 0600）、ホストが見られるのはバインド状態とマスクされた情報だけです。鍵は暗号文の隣にあるため、ローカルの root ユーザーからは保護されません。専用の統合アカウントを推奨します。個人アカウントは単一デバイスのセッション規則で切断されることがあります。**パスワードやトークンをチャットに貼らないでください**。入力する場所はパネルです。\n\n| 設定項目 | 用途 | 既定値 |\n| --- | --- | --- |\n| `requestTimeoutMs` | AIHub/ESM 呼び出し 1 回のタイムアウト | `20000` |\n| `maxResponseBytes` | これを超えるレスポンスは切り詰められます | `32768` |\n| `auditRetentionDays` | 起動時に、この日数より古い監査ログを削除します | `30` |\n\n最初の確認:\n\n1. コマンド「ワークフローツール設定」を実行し、環境を追加します（名前、Base URL、SSO アプリケーション ID）。パスワードかトークンのどちらでサインインするかを選び、「接続テスト」を押します。\n2. 会話に戻って「この環境のエージェントを一覧して」と伝えます。アシスタントは環境を一覧し、このタスクをバインドして、シナリオ別にエージェントを返します。\n3. 「ナレッジベースで経費精算の規程を検索して」と伝えると、該当する項目と出所を返し、本文は必要なときだけ読みます。\n\nよくある導入の失敗:\n\n- **接続テストで認証エラーになる**: SSO アプリケーション ID か環境のアドレスが違うか、そのアカウントにプラットフォーム上の参照範囲がありません。まずプラットフォームにサインインできることを確認してください。\n- **MFA、グループ選択、アカウントロックが報告される**: プラグインは二段階認証を代行しません。プラットフォームの Web UI で一度サインインしてグループ選択を済ませるか、別の統合アカウントを使ってください。\n- **ワークフロー実行がタイムアウトする**: 1 回の実行は最大 90 秒で、それを超えると `WF_RUN_TIMEOUT` を返しますが、タスクはまだ動いている可能性があります。再送せず `workflow_run_status` で ID から確認してください。\n", "usage": "よくある 3 つの依頼:\n\n1. **ナレッジから答えを取る**: 「ナレッジベースで出張旅費の上限を調べて、出所も教えて」。アシスタントは `workflow_search_knowledge` で検索し、必要なら `workflow_read_knowledge` で本文を読み、どのファイルからの引用かを示します。\n2. **公開済みのフローを実行する**: 「契約レビューのエージェントでこの説明文を確認して」。アシスタントは `workflow_agent_info` で入力フォームを読み、入力内容を確認したうえで `confirm` 付きで `workflow_run` を呼び、ノードトレースと最終出力を返します。\n3. **実行結果の確認や停止**: 「さっきの実行はどこまで進んだ？」「その実行を止めて」。アシスタントは `workflow_run_status` で状態を取得し、`workflow_stop_run` で指定した task id を停止します。\n\n入口はコマンド「ワークフローツール設定」で、管理パネル（環境の追加・編集・接続テスト・トークン削除・既定のエージェント・監査ログ）が開きます。会話内の機能は 13 個の Agent ツールが担います:\n\n| 機能 | 内容 |\n| --- | --- |\n| `workflow_list_environments` | 環境、ログイン状態、現在のバインドを一覧します |\n| `workflow_select_environment` | このタスクをバインドします。環境の切り替えには `confirmSwitch` が必要です |\n| `workflow_environment_status` | 現在の環境/エージェントのバインド、認証、書き込みスイッチ、直近のテスト |\n| `workflow_list_agents` | 参照可能なエージェントをシナリオ別に一覧します |\n| `workflow_select_agent` | このタスクにエージェントをバインドします。切り替えには `confirmSwitch` が必要です |\n| `workflow_agent_info` | エージェントの種類、説明、入力フォーム |\n| `workflow_run` | ワークフローを実行します（`confirm` が必要、最大 90 秒） |\n| `workflow_run_status` | 実行 ID から状態を取得します |\n| `workflow_stop_run` | 指定した task id を停止します（`confirm` が必要） |\n| `workflow_list_knowledge_bases` | 参照可能なナレッジベースとファイル数 |\n| `workflow_search_knowledge` | `semantic` / `keyword` / `fulltext` の検索 |\n| `workflow_read_knowledge` | テキスト本文またはテキスト系のソースファイルを読みます |\n| `workflow_logout` | ローカルのログイントークンを削除します |\n\n期待しないでください:\n\n- データテーブルの書き込みやノード単位の実行: 公開済みワークフローを呼ぶ機能で、テーブルの読み書きやフローの作成は範囲外です。\n- バイナリファイルの読み取り: PDF や Office の添付は `WF_UNSUPPORTED_FILE` を返し、テキスト系のみ扱います。\n- 権限の肩代わり: ナレッジ本文もエージェントの出力も信頼できないデータです。チームの参照範囲、許可リスト、アカウント権限はプラットフォームが決め、プラグインは範囲を狭めることしかできません。\n" }, "en": { "intro": "Workflow Tool brings AIHub/ESM knowledge bases and workflows into the conversation: each task binds one environment and one agent, and the assistant searches knowledge bases, reads text content and runs published workflows through tools. Switching the environment or the agent needs your explicit agreement first.\n\nIt leans toward calling rather than authoring: the plugin runs agents and workflows someone already published on the platform and returns a node trace plus the final output. It does not write data tables, execute nodes one by one, or build workflows.\n\nSign-in uses the integration account you configure, the token is cached encrypted, and an expired authentication is refreshed once; MFA, group selection or a locked account is reported as an error instead of being retried in a loop. Search scope is the intersection of what you can see on the platform and the environment's optional knowledge-base allowlist.\n\nWhat you can do with it:\n\n- Search knowledge bases by semantic, keyword or full text, and list the visible knowledge bases with their file counts.\n- Read the text content of one knowledge file and use it as material.\n- Run a published agent or workflow, waiting at most 90 seconds, and get back a bounded node trace and the final output.\n- Check a run by id, stop a specific task id, and clear the local login token when needed.\n", "install": "This plugin is not part of the installer: install it here before using it. After removing it you can reinstall it here, but its settings and data start over.\nYou need three things: the AIHub/ESM Base URL, the SSO application id (plus `hubId` when the deployment has instances), and an integration account — a password or an already-issued manual token. No Node, npm or extra service is involved. Tokens are encrypted with AES-256-GCM in the plugin's local data directory (`sessions.enc`, key file `key.bin` with mode 0600), and the host only sees the binding and masked fields; the key sits beside the ciphertext, so it does not protect against a local root user. Prefer a dedicated integration account: a personal account can be kicked out by the platform's single-device session rule. **Do not paste a password or token into the chat** — they belong in the panel.\n\n| Setting | Purpose | Default |\n| --- | --- | --- |\n| `requestTimeoutMs` | Per-request timeout for AIHub/ESM calls | `20000` |\n| `maxResponseBytes` | Responses above this size are truncated | `32768` |\n| `auditRetentionDays` | Audit log files older than this are removed at startup | `30` |\n\nFirst verification:\n\n1. Run the command \"Workflow tool settings\", add an environment (name, Base URL, SSO application id), choose password or token sign-in and click \"test connection\".\n2. Back in the chat, say \"list the agents in this workflow environment\" — the assistant lists the environments, binds this task, then lists agents by scenario.\n3. Say \"search the knowledge base for the expense policy\" — the assistant searches and returns the matching entries with their source, and reads the content only when needed.\n\nCommon install failures:\n\n- **The connection test reports an authentication failure**: the SSO application id or the base URL is wrong, or the account has no visibility on the platform; confirm the platform sign-in works before filling this in.\n- **MFA, group selection or a locked account is reported**: the plugin does not fill in a second factor; sign in on the platform web UI once to finish group selection, or use another integration account.\n- **A workflow run reports a timeout**: one run waits at most 90 seconds, so a longer flow returns `WF_RUN_TIMEOUT` while the task may still be running; check it with `workflow_run_status` by id instead of submitting again.\n", "usage": "Three common things to ask for:\n\n1. **Get an answer from the knowledge base**: \"Look up the travel expense limit in the knowledge base and cite the source.\" The assistant calls `workflow_search_knowledge`, reads the content with `workflow_read_knowledge` when needed, and names the knowledge file it came from.\n2. **Run a published flow**: \"Use the contract review agent on this description.\" The assistant reads the input form with `workflow_agent_info`, confirms the inputs with you, then calls `workflow_run` with `confirm` and returns the node trace and final output.\n3. **Check or stop a run**: \"Where did that run get to?\" or \"stop that run.\" The assistant uses `workflow_run_status` for the state, or `workflow_stop_run` for the specific task id.\n\nThe entry point is the command \"Workflow tool settings\", which opens the management panel (create, edit and test environments, clear tokens, default agent, audit log). In the conversation the work is done by 13 agent tools:\n\n| Capability | What it does |\n| --- | --- |\n| `workflow_list_environments` | Lists environments, login state and the current binding |\n| `workflow_select_environment` | Binds this task; switching environments needs `confirmSwitch` |\n| `workflow_environment_status` | Current environment/agent binding, authentication, write switch and the last test |\n| `workflow_list_agents` | Lists the visible agents by scenario |\n| `workflow_select_agent` | Binds an agent to this task; switching agents needs `confirmSwitch` |\n| `workflow_agent_info` | Agent type, description and input form |\n| `workflow_run` | Runs a workflow (needs `confirm`, waits up to 90 seconds) |\n| `workflow_run_status` | Reads the state of one run by id |\n| `workflow_stop_run` | Stops a specific task id (needs `confirm`) |\n| `workflow_list_knowledge_bases` | Lists visible knowledge bases and their file counts |\n| `workflow_search_knowledge` | `semantic` / `keyword` / `fulltext` search |\n| `workflow_read_knowledge` | Reads text content or a text-like source file |\n| `workflow_logout` | Clears the local login token |\n\nDo not expect it to:\n\n- Write data tables or run nodes one by one: this calls published workflows; table writes and workflow authoring are out of scope.\n- Read binary files: PDF and Office attachments return `WF_UNSUPPORTED_FILE`, so only text-like content is handled.\n- Grant permissions for you: knowledge text and agent output are untrusted data, and team visibility, allowlists and account permissions come from the platform — the plugin can narrow that scope, never widen it.\n" } }, "versions": [ { "version": "1.0.0", "publishedAt": "2026-11-01T00:00:00Z", "minPiDesktop": ">=0.21.0", "shasum": "67096fbf71f86a77a61d8df03e79d587b31bea56762c07c6114d3ca4e3de1d95", "url": "packages/voki.workflow-tool-mcp-1.0.0.piplug", "sizeBytes": 235046, "permissions": [ "agent.tool.register", "agent.prompt.inject", "net.fetch", "net.anyHost", "ui.panel" ], "fs": {} } ], "distribution": "marketplace" } ] }