如何使用 OneKit
浏览器、工作流和 CLI。
认识一下您每天文件处理的小工具。学习基础知识，把工具连接成工作流程，或者把 OneKit 带到您的终端。
OneKit 是什么？
OneKit 帮您比较、转换和处理 PDF、图片、文档、代码及其他文件。可以用单个工具快速完成任务，也可以连接多个工具处理重复工作，或者从命令行运行共享的 Python 核心。
工具和类别
目录中包含 285 个工具；255 目前在浏览器中运行。按任务或格式搜索，然后使用类别筛选缩小列表。启用 显示CLI工具 查看通过 CLI 可用的操作及其所需依赖项。
在您的浏览器中使用一个工具。
借助先进的浏览器技术，OneKit 会直接在您的设备上处理文件。您的文档和结果会保留在您这里，而不会上传到我们的服务器。OneKit 下载处理环境和所需的软件包，然后在您切换工具时重复使用它们。
- 打开一个工具。 从目录中选择一个操作并检查其输入要求。
- 添加您的输入内容。 选择文件或在支持的地方粘贴文本。使用“替换”或“移除”来更改选择。
- 设置选项。 选择输出格式或设置。支持的 PDF 工具提供页面预览和重新排序；图像裁剪提供可视化选择。
- 运行并下载。 等待处理完成，检查任何警告，然后下载结果。在刷新或关闭页面前保存。
OneKit 会在后台准备本地环境。公开下载内容可以缓存以便下次访问。您的工作文件不会被存储在该缓存中。取消操作会停止处理环境。
结果、保真度与对比
✓ 和 ≈ 意味着什么？
✓ 内容保持： 此操作旨在保留相关内容。 ≈ 有妥协的转换： 布局、字体、元数据或细节可能会变化。将鼠标悬停或聚焦在工具卡上的符号以读取其具体说明。
比较和合并是怎么工作的？
打开两个文件或粘贴两段文本。新增内容显示为绿色，删除内容显示为红色。使用各个修改行上的箭头将其中一个版本应用到另一边，每次一处修改。您可以继续编辑并下载任意一边。JSON 比较会标准化键值；笔记本比较可以专注于代码、Markdown 或两者。
工作流是做什么的？
在单一工作流中结合各类别工具：转换文件、处理其内容，然后压缩或打包结果。根据需要重复混合步骤，只要每个工具都接受上一步的输出格式和文件数量。OneKit 会自动在步骤之间传递结果，无需下载和选择文件。
正在处理多个文件？ 使用一个工作流程。选择一个文件池：单文件工具在 对于每个文件 循环，对每个输入应用相同设置。每次传递都会将结果发送到下一步。像 “合并 PDF” 这样的工具会按选定顺序一起处理该组。比较和差异被排除，因为它们需要特定的输入对。
移除封面页，然后将剩余页面旋转 90°。使用至少有两页的 PDF。打开此设置后，您可以更改这两个设置。
压缩图片，然后将结果转换为 WebP。图片质量和文件大小取决于您的输入和设置；压缩可能会丢失细节。
检查JSON文档是否有效，并保存报告。一个工作流程可以只包含一个工具；只有在输入格式兼容时才添加更多步骤。
这是一个设置示例，不是实时文件操作。在构建器中，选择“打开工作流”加载下载的 .1kit 文件，然后添加您自己的文件。
- 从文件池开始
选择一个或多个输入和第一个工具。在运行前可添加、移除或重新排序文件。
- 构建您的序列
组合任何类别中兼容的工具. 重复步骤并调整它们的选项.
- 运行并重用
运行工作流，下载结果并保存设置以备下次使用。
步骤按编号顺序运行；移动模块只改变它们的位置。文件集合支持最多 256 个文件和 128 MiB 总量；每个步骤也有自己的文件大小和总量限制。失败会停止工作流程，不会发布部分结果。可以将多个结果一起下载为 ZIP。保存的 .1kit 设置会保留工具、选项和布局，但不包括输入文件或密码。
您也可以从 CLI 运行已保存的设置：
onekit pipeline --steps workflow.1kit input.pdf -o output/您的 CLI。您的代理 CLI。
CLI 让您可以直接访问 位于 OneKit 核心的开源（PolyForm Shield 1.0.0）Python 核心库- 运行 所有 285 工具，包括那些尚未在浏览器中可用的，与 更宽松的文件大小限制 在支持的情况下。一切都在您的机器上运行。
需要 Python 3.11 或更高版本。限制因工具而异；某些操作需要可选包或外部引擎，例如 FFmpeg、LibreOffice 或 Pandoc。
python -m pip install "onekit-tools[pdf,images,documents]"直接使用 OneKit 或作为本地工具包配合 AI 代理执行 shell 命令。您的代理可以发现工具、检查需求、处理文件并运行已保存的工作流 .1kit 工作流程。文件处理在本地进行；哪些内容会发送给远程模型，取决于您的智能体配置。
发现并检查
onekit list --json
onekit doctor pdf-merge --json尝试 PDF 合并
onekit run pdf-merge first.pdf second.pdf -o combined.pdf对于代理工作流，解析发现和就绪的 JSON，传递显式的输入/输出路径，并在读取结果前检查退出状态。 run and pipeline 写输出文件；一些工具生成 JSON 报告。无人值守运行前准备好依赖项，因为首次使用设置可能需要下载或交互。使用 onekit doctor TOOL_ID 检查特定工具的依赖关系。OneKit 会保留现有输出文件，除非您故意传入 --force。密码请使用 --ask-password 将机密信息保留在 shell 参数之外。
帮助建设 OneKit 的开放革命：为每个人提供日常工具，从动手任务到由本地 AI 代理运行的工作流程。贡献力量，让工具更高效、更有效：提升速度和内存使用，修复错误结果，增加回归示例，或者澄清文档和代理工作流程。 阅读贡献指南 ↗
问题、限制和故障排除
.1kit 文件是什么？
.1kit 是 OneKit 文件扩展名。 它支持工作流和白板。保存的工作流包含其工具、选项和画布布局；保存的白板包含其笔记、形状和绘图。在此打开白板： 白板 和工作流构建器中的工作流。新的白板和消息文件使用压缩的 .1kit 容器；旧版 JSON 和工作流文件仍然受支持。每个文件都会记录其类型和版本。工作流输入文件和密码不包含在内。白板包含您保存的笔记和绘图。共享会创建一个不可更改的托管副本，并带有到期时间和可选的密码加密；编辑草稿永远不会改变已有链接。白板仅在网页应用中可用。对于工作流，浏览器和 CLI 只接受 .1kit 工作流文件。
我的文件能有多大？
当前文件和总量限制会显示在每个工具的上传区域和要求中。它们会根据工具的处理限制自动为您的浏览器和设备选择。图片还有像素限制，媒体工具有时长和分辨率限制。当输入或输出超过浏览器允许时，请使用较小的文件或 OneKit CLI。CLI 独立于浏览器保持自己的限制。
为什么有些工具只能在 CLI 中使用？
需要额外模型或本地引擎的工具在 CLI 上运行。缺失的依赖项将在首次使用时自动安装，但需视平台可用性而定。使用工具的 CLI 详细信息页面并 onekit doctor TOOL_ID 看它需要什么。
一个工作流程停止或文件被拒绝。我应该检查什么？
检查实际的文件格式，而不仅仅是它的扩展名，还要查看所选工具显示的大小限制。每个工作流程步骤必须能接受上一步的输出格式和文件数量。步骤限制比较小的，不能因为前一步支持更大结果就接受。加密的PDF需要正确的密码。尝试单独运行该步骤以隔离问题，或者对于超出浏览器限制的文件使用CLI。
我可以关闭标签页或者稍后再回来吗？
请在关闭或刷新页面前下载结果。工作文件和结果仅保留在当前会话中；重新打开网站不会恢复它们。如果希望日后复用处理步骤，请保存工作流程配置，然后重新选择输入文件。
我怎么验证下载？
使用从下载页面链接的版本化软件包。它们直接来自公开的 GitHub 发布。在安装前，将文件的 SHA-256 摘要与发布清单进行比较。可选的原生引擎有自己的平台要求。
OneKit 使用分析功能吗？
可选的 Google Analytics 仅在您允许分析 cookie 后加载。您可以在页脚的 Cookie 设置中更改选择。文件内容不会发送到 Analytics。详情请阅读隐私页面。
一个您可以检查和改进的工具包
OneKit Python 核心是开源的（PolyForm Shield 1.0.0）。它的代码驱动浏览器工具和 CLI。您可以查看实现、报告 bug、提出工具建议或者贡献修复。
帮助建设 OneKit 的开放革命：为每个人提供日常工具，从动手任务到由本地 AI 代理运行的工作流程。贡献力量，让工具更高效、更有效：提升速度和内存使用，修复错误结果，增加回归示例，或者澄清文档和代理工作流程。 阅读贡献指南 ↗
您可以出于允许的目的使用、修改和再分发核心代码，包括商业用途和内部使用。您不得用它来提供与该软件或许可方或其关联公司使用该软件提供的产品竞争的产品或服务；免费的产品以及不同的平台或界面也可以构成竞争。在分享副本时，请附上许可证文本或其 URL 及软件提供的任何必需通知行。完整许可证适用，包括其对新产品和停产产品、专利条款和免责声明的例外规定。在这里，“开源 (PolyForm Shield 1.0.0)”指在这些条款下发布的源代码； 不竞争限制意味着这是源代码可用的软件，而不是根据《开源定义》完全开放的开源软件。
有用的链接
联系 OneKit
选择与您的问题相关的联系人。
请私下发送安全报告，并避免附加敏感文件或凭证。
