# Workspace Tool 这是 [PluginKit v4](../../../docs/plugins/README.md#v4-宿主能力) 的作者示例。一个命令展示怎样查询工作区、提出批量修改、处理图片、发起 HTTPS 请求,以及声明工具界面和编辑器扩展。 ## 开发和安装 使用支持 API 4 的 Folra App。以下命令从仓库根目录执行。 ```sh folra="/Applications/Folra.app/Contents/MacOS/Folra" "$folra" plugin validate ./examples/plugins/workspace-tool --json "$folra" plugin test ./examples/plugins/workspace-tool --json "$folra" plugin pack ./examples/plugins/workspace-tool ./WorkspaceTool.folraplug --json ``` CLI 用例传入合成工作区、事件和宿主响应。每条用例测一轮脚本。真实请求和文件操作需要从 App 运行。 在「插件 → 管理插件… → 安装插件…」选择打包后的目录。创建临时工作区,放入 `Start.md`、`Plan.md` 和至少 32 × 32 像素的单帧 `cover.png`。打开 `Start.md`,从「插件」菜单运行 Workspace Tool。 - 默认打开原生侧栏,显示文件表格和复制文稿的按钮。 - **Copy and summarize Plan.md** 请求读取 `Plan.md`,随后预览 `Plan copy.md` 和 `Plan summary.md` 两项写入。目标文件若已在 Folra 打开,先关闭后再运行。 - **Copy cover.png** 复制小图片。**Compress cover.png** 和 **Crop cover.png** 由宿主生成 JPEG、PNG,可预览后保存。**Recognize text in cover.png** 返回本机识别结果。 - **Check example.com** 提示批准后请求 `https://example.com/`,返回 HTTP 状态。请求不携带文稿数据。 - 在插件管理为当前工作区启用自动化后,文稿打开、修改、文件夹变化和定时事件可生成索引条目数量报告。 ## 编辑器贡献 用 ⌃⌥⌘8 打开命令,或在正文写 `%%open-plan-tool:打开工作区工具%%` 并点击。输入 `;plan` 后按 Tab 插入待办,`%%plan:重点%%` 会显示标记样式。 将以下内容写入文稿。表格与条形图使用 Tab 分列。脚本渲染的代码块只把块内容交给插件。 ````markdown ```folra-plan-table Task Status Outline Ready ``` ```folra-plan-bars Draft 3 Review 2 ``` ```folra-plan-summary Outline Draft Review ``` ````