企业官网建设流程全解析

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、sqlite
• method（方法名）：不区分大小写，例如SendTextMessage
• 参数：--长参数名或-短参数名+ 值

💡 技巧：不带任何参数运行oint会显示欢迎页和全部可用库；只写库名（如oint telegram）列出该库的方法；再加上方法名（如oint telegram SendTextMessage）显示参数详情。这三级递进的内置帮助是查文档最快的方式。

二、五大参数类型写法速查表

这是新手最容易踩坑的地方。CLI 通过值的书写格式自动识别参数类型，写法对了才能被正确解析：

几个实战示例（均取自项目自带文档）：

# 执行 SQL 查询（--dbc 是字符串，--tls 是 JSON 对象） oint mssql ExecuteSQLQuery \ --sql "SELECT 1 AS n" \ --dbc "Server=127.0.0.1;Database=***;User Id=SA;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 的关键：

例如执行oint sqlite GetLoggingSettings --config就能查出日志设置里有哪些可配字段，无需翻阅文档。

四、二进制输出：--out 的三种进阶用法

下载文件、读取二进制等场景下，方法会返回二进制数据。如果直接输出到控制台，OInt CLI 会提示你使用--out指定保存路径。

--out支持两种模式：

1. 写入文件（推荐）

oint s3 DownloadObject --key "files/report.xlsx" --out "D:/downloads/report.xlsx"

数据以原始二进制形式写入文件。注意--out保存的文件编码固定为 UTF-8（OInt 内部编码），而 shell 重定向>用的是终端编码——处理含中文的结果时，建议优先用--out。

2. 文本表示模式（控制台输出）

--out还支持三个带下划线的特殊值，把二进制结果以文本形式打印出来：

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 "hi"

2. 参数外置为 JSON 文件

把--config、复杂 JSON 参数抽成文件，脚本里只引用路径，方便维护和版本管理。

3. 结果落盘 + 文件判断

--out写文件后，stdout 会输出一条"文件大小已写入 xxx"的提示，脚本可据此判断成功与否。

4. 用 hashsum 校验构建产物

oint hashsum命令返回当前构建的哈希值，适合在 CI 脚本中做产物一致性校验。

5. 集成到 MCP 服务器

OInt CLI 内置 MCP（Model Context Protocol）服务器，AI Agent 可通过 stdio 直接调用所有集成方法，让大模型帮你查数据库、发消息、传文件。详见官方文档 mcp-server.mdx。

六、遇到问题怎么办：调试与排查路径

1. 先看--debug：输出实际生成的 OneScript 调用语句，一眼定位参数拼写问题
2. 错误输出会区分简明/详细模式：带--debug时显示完整堆栈描述，适合贴 issue
3. 源码级排查：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。