OInt CLI深度手册：参数类型、二进制输出与脚本自动化技巧完整指南

【免费下载链接】OpenIntegrationsНабор инструментов интеграции с популярными сервисами и технологиями для 1С:Предприятие, OneScript и CLIMCP (Telegram, VK, Bitrix24, Google, Яндекс, S3, PostgreSQL, SQLite, MySQL и др.)项目地址https://gitcode.com/gh_mirrors/op/OpenIntegrations点击查看免费下载OpenIntegrations简称 OInt是为 1C:Предприятие、OneScript 和命令行提供的集成工具包内置 Telegram、VK、Bitrix24、Google、Яндекс、S3、PostgreSQL、SQLite、MySQL 等 40 多个服务连接器。它的OInt CLI让开发者无需打开 1C 或 OneScript 环境直接在终端里调用全部集成方法——本文带你快速吃透它的参数类型写法、二进制数据输出和脚本自动化技巧。一、5分钟上手 OInt CLI 命令结构OInt CLI 的安装方式很灵活Linux 包或 Windows 安装包安装后oint命令全局可用以 OPM 包安装时只要 OneScript 的bin目录在PATH中即可随处调用。所有命令都遵循统一结构oint library method --param1 Value --param2 Value...library库名小写且区分大小写例如telegram、s3、sqlitemethod方法名不区分大小写例如SendTextMessage参数--长参数名或-短参数名 值 技巧不带任何参数运行oint会显示欢迎页和全部可用库只写库名如oint telegram列出该库的方法再加上方法名如oint telegram SendTextMessage显示参数详情。这三级递进的内置帮助是查文档最快的方式。二、五大参数类型写法速查表这是新手最容易踩坑的地方。CLI 通过值的书写格式自动识别参数类型写法对了才能被正确解析参数类型写法示例字符串 String带引号或不带引号的普通文本--sql SELECT 1数字 Number不带引号的数字小数点用.--level 9日期 DateISO 8601 格式字符串2026-01-01T00:00:00数组 ArrayJSON 数组格式字符串[Value1,Value2]JSON 对象JSON 字符串或直接传 .json 文件路径{a:b}几个实战示例均取自项目自带文档# 执行 SQL 查询--dbc 是字符串--tls 是 JSON 对象 oint mssql ExecuteSQLQuery \ --sql SELECT 1 AS n \ --dbc Server127.0.0.1;Database***;User IdSA;Password***; \ --tls {use_tls:true,accept_invalid_certs:true,ca_cert_path:}# 压缩目录为 7z--settings 是复杂 JSON 对象 oint 7z ArchiveDirectory \ --src /tmp/src_compress \ --dest /tmp/archive_lzma.7z \ --settings {password:***,method:Lzma2,level:9,solid:true}重点技巧JSON 对象参数可以直接传文件路径复杂配置先写成.json文件命令里只传路径脚本可读性瞬间提升。每个方法的完整参数定义都在 src/en/cli/data/Classes/index/ 目录下的对应 json 索引文件中例如 sqlite.json、telegram.json。控制序列转义普通字符串参数支持\n、\r、\v、\f控制序列自动转为换行、回车等字符但以下三种情况不会转换数组/JSON 参数以{或[开头、实际存在的文件路径、--out参数。如果确实需要在这些场景里写字面\n用双反斜杠\\n转义即可。三、四大标准参数--help / --debug / --config / --out每个命令都自动附加四个标准参数理解它们是高效使用 OInt CLI 的关键参数作用--help显示当前命令/方法的帮助等同于不带参数调用--debug输出调试信息显示生成的完整 OneScript 调用文本--config方法附加配置不带值时返回该方法可用的配置项--out指定结果保存路径尤其针对二进制数据例如执行oint sqlite GetLoggingSettings --config就能查出日志设置里有哪些可配字段无需翻阅文档。四、二进制输出--out 的三种进阶用法下载文件、读取二进制等场景下方法会返回二进制数据。如果直接输出到控制台OInt CLI 会提示你使用--out指定保存路径。--out支持两种模式1. 写入文件推荐oint s3 DownloadObject --key files/report.xlsx --out D:/downloads/report.xlsx数据以原始二进制形式写入文件。注意--out保存的文件编码固定为 UTF-8OInt 内部编码而 shell 重定向用的是终端编码——处理含中文的结果时建议优先用--out。2. 文本表示模式控制台输出--out还支持三个带下划线的特殊值把二进制结果以文本形式打印出来--out值输出格式_hex_十六进制字符串_base64_Base64 字符串_utf8_UTF-8 文本oint msgpack SerializeData --value {a: b} --raw true --out _hex_ oint hashsum --out _utf8_⚠️ 这三个特殊值只用于控制台打印不会创建名为_hex_的文件。方法若返回普通字符串会先转成内部二进制再按所选格式输出。五、脚本自动化技巧清单OInt CLI 天生为 bat/sh 脚本设计——每次调用执行完就退出天然适合串联自动化流程。1. 用--test做干跑dry-run--test标志会打印完整处理信息但不实际发送/执行数据。写脚本前先用它验证参数拼接是否正确避免误操作线上服务oint telegram SendTextMessage --test --token xxx --chat_id 123 --text hi2. 参数外置为 JSON 文件把--config、复杂 JSON 参数抽成文件脚本里只引用路径方便维护和版本管理。3. 结果落盘 文件判断--out写文件后stdout 会输出一条文件大小已写入 xxx的提示脚本可据此判断成功与否。4. 用 hashsum 校验构建产物oint hashsum命令返回当前构建的哈希值适合在 CI 脚本中做产物一致性校验。5. 集成到 MCP 服务器OInt CLI 内置 MCPModel Context Protocol服务器AI Agent 可通过 stdio 直接调用所有集成方法让大模型帮你查数据库、发消息、传文件。详见官方文档 mcp-server.mdx。六、遇到问题怎么办调试与排查路径先看--debug输出实际生成的 OneScript 调用语句一眼定位参数拼写问题错误输出会区分简明/详细模式带--debug时显示完整堆栈描述适合贴 issue源码级排查CLI 入口逻辑在 src/en/cli/core/Classes/app.os参数解析与帮助显示在 src/en/cli/help/Classes/Help.os中英文 CLI 文档示例在 docs/en/cli/ 和 docs/ru/cli/ 目录总结记住这张速查卡命令结构oint 库名小写 方法名 --参数 值类型靠格式识别数字不加引号、数组/JSON 用 JSON 字符串或文件路径、日期用 ISO 8601二进制数据必须--out写文件用路径看内容用_hex_/_base64_/_utf8_自动化三板斧--test干跑、参数 JSON 化、--out落盘三级内置帮助oint→oint 库→oint 库 方法永远是最快的文档掌握以上内容你就能把 OInt CLI 的 40 个集成能力真正变成自己自动化流水线的一部分了。更多用法可阅读官方文档 CLI-version/index.md。赞分享【免费下载链接】OpenIntegrationsНабор инструментов интеграции с популярными сервисами и технологиями для 1С:Предприятие, OneScript и CLIMCP (Telegram, VK, Bitrix24, Google, Яндекс, S3, PostgreSQL, SQLite, MySQL и др.)项目地址https://gitcode.com/gh_mirrors/op/OpenIntegrations点击查看免费下载相关推荐Supabase Realtime 实时通信指南构建实时应用的核心技术Supabase Realtime 实时通信指南构建实时应用的核心技术 Supabase Realtime 是 Supabase 生态系统中提供实时数据同步功游戏自动化脚本技术完整指南AhabAssistantLimbusCompany深度解析游戏自动化脚本技术完整指南AhabAssistantLimbusCompany深度解析 在当今游戏自动化领域AhabAssistantLimbusCompaGUI 自动化计算机视觉为什么TypeScript自动知道你的CLI参数类型Optique类型自动推断机制深度解析为什么TypeScript自动知道你的CLI参数类型Optique类型自动推断机制深度解析 Optique 是一个面向 TypeScript 的类型安全组合式上一篇数据管线揭秘ai-image-prompts-skill 如何每天两次从 CMS 同步社区提示词库到 GitHub下一篇Hybrid 混合路由算法语义路由中的多信号加权选路实践创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考