简介：《Connect命令参考手册》面向使用STK（System Tool Kit）进行空间任务仿真与分析的中文用户，尤其适合需要深度定制操作、却苦于英文帮助文档阅读不便的进阶使用者。Connect指令是STK实现精细化操控的关键，本手册由译者整理翻译，覆盖BoundaryType、Copy、DisplayTimes等子命令的格式、参数、返回值与用法示例，并标注适用对象组及STK 8.0、8.12等版本信息。资源为1个doc文档，压缩包约5.62MB，内容按命令逐条编排，便于对照查阅与继续翻译补充。目前已有2221人学习下载。读者可借此理解大圆弧与等角航线的边界类型选择、对象复制路径命名、图形显示时间间隔控制等具体知识点，快速上手复杂空间分析与任务规划，也可在无版权限制下自由传播、协作完善。
1. 从一份半成品中文手册说起：STK Connect 到底能省下多少事
如果你用过 STK 做任务仿真，大概率经历过这个场景：界面上点了几十次鼠标，才把一颗卫星的传感器指向调好，结果导师说“换个参数再跑一遍”，于是又从头点一遍。Connect 指令就是为这种重复劳动准备的——它让你用一行行命令去驱动 STK，把建模、显示、数据注入全部脚本化。问题是官方帮助文档全是英文，命令参数又多又碎，查一个DisplayTimes的用法得在几百页里翻半天。这份《Connect 命令参考手册》就是有人把英文文档啃了一半之后留下的中文翻译稿，Word 格式，覆盖了 BoundaryType、Copy、DisplayTimes、ExtendBoundary、ExternalData、GetBoundary、Graphics 系列等二十多条高频指令。它适合两类人：一是刚接触 STK 脚本、需要中文对照快速上手的；二是已经能写 Connect 但想系统查参数边界的老手。下面我按“怎么读、怎么用、怎么避坑”的顺序，把这份手册的落地路径拆开。
2. 手册里最值得先啃的三类指令：边界、复制与显示控制
2.1 BoundaryType 与 ExtendBoundary：面目标边界的两种画法
面目标（Area Target）在 STK 里通常用来表示覆盖区域、禁飞区或者地面站的可视范围。手册里BoundaryType和ExtendBoundary是配套使用的：前者定义边界的线型规则，后者往已有边界上追加点。
BoundaryType的核心参数是Type和Granularity。Type只有两个取值——GreatArc和RhumbLine。大圆弧是地球表面两点间最短距离，但方向一直在变；等角航线方向固定，适合导航场景。如果你做的是地面覆盖分析，选GreatArc更贴近真实几何；如果是模拟飞机沿固定航向飞行，RhumbLine更合适。Granularity控制边界离散精度，单位是度，范围 0.01 到 10.0，默认 0.5。这个值越小，边界点越密，计算量越大。我一般做区域覆盖时设 0.1 到 0.2，做全球级粗筛时设 1.0 以上。
# 将线目标 ltPrimeMeridian 的边界类型设为等角航线，粒度 2.0 度 BoundaryType */LineTarget/ltPrimeMeridian Type RhumbLine Granularity 2.0逻辑说明：*/LineTarget/ltPrimeMeridian是对象路径，*代表当前场景。Type RhumbLine指定线型规则，Granularity 2.0把离散精度放宽到 2 度。参数改动的直接影响是边界点的数量和后续覆盖计算的速度。如果你发现面目标边界在 2D 窗口里看起来“棱角分明”，大概率是 Granularity 设太大了。
ExtendBoundary的用法更直接：先确保面目标至少有一个边界点，然后按LatLon或UTM格式追加。手册里的例子是给at1加两个经纬度点：
# 为面目标 at1 追加两个边界点：纬度 50 经度 0，纬度 10 经度 45 ExtendBoundary */AreaTarget/at1 Pattern LatLon 2 50 0 10 45这里Pattern LatLon是点类型，2是点数，后面每两个数字一组。注意经纬度默认单位是度，如果你从其他系统导出的坐标是弧度，得先转换。常见做法是先用SetBoundary定义初始边界，再用ExtendBoundary逐步细化，最后用GetBoundary导出验证。
2.2 Copy 命令：对象复制的路径陷阱
Copy看起来简单，但路径写法是新手翻车最多的地方。手册给了三种用法：复制到同路径下、复制并重命名、跨父对象粘贴。
# 复制 Satellite1 到当前场景根下，保持原名 Copy / */Satellite/Satellite1 # 复制 Satellite1 并重命名为 MySat1 Copy / */Satellite/Satellite1 Name MySat1 # 把 Satellite1 下的 Sensor1 复制到 Satellite2 下，命名为 DownSn Copy / */Satellite/Satellite1/Sensor/Sensor1 Path */Satellite/Satellite2/Sensor/DownSn第一个参数ApplicationPath通常写/，表示当前应用。第二个参数是源对象路径。Name和Path的区别在于：Name只改名字，路径不变；Path直接指定完整的新路径，包括父对象。如果你用Path但目标父对象不存在，命令会报错。我一般会先用GetChildren或手动确认目标路径存在，再执行复制。
提示：复制传感器、雷达这类挂在运载器下的对象时，目标路径必须包含同类型的父对象节点，否则 STK 会拒绝创建。
2.3 DisplayTimes 与 GetDspTimes：图形显示的时间开关
DisplayTimes是手册里参数最复杂的指令之一，因为它同时控制“什么时候显示”和“显示状态怎么切换”。核心逻辑是：先通过Intervals或Access定义时间片段，再用State决定是否启用这些片段。
# 让 AreaTarget1 在 2000年1月1日凌晨1点到2点、4点到5点显示 DisplayTimes */AreaTarget/AreaTarget1 Intervals Add 2 "1 Jan 2000 01:00:00.0" "1 Jan 2000 02:00:00.0" "1 Jan 2000 04:00:00.0" "1 Jan 2000 05:00:00.0" # 让对象始终可见 DisplayTimes */LineTarget/Lt1 State AlwaysOn # 从文件加载时间间隔，替换现有设置 DisplayTimes */Facility/Facility1 Intervals File Load "C:\stk50DB\Target1.int"Intervals Add后面的数字是时间对的数量，每对由开始和结束时间组成，时间字符串必须加引号。State有四个取值：AlwaysOn、AlwaysOff、Interval、Access。注意手册里特别提到：运载对象（Vehicles）不能用DisplayTimes，得用Graphics CustomIntervals或Graphics AccessIntervals。这是版本差异导致的，如果你在卫星上试DisplayTimes发现不生效，先检查对象类型。
GetDspTimes是反向查询，用来确认当前显示状态：
# 查询 Landover 设施的显示时间间隔 GetDspTimes */Facility/Landover Intervals返回值会列出所有时间对。如果你发现脚本执行后图形没变化，先用这个命令查一下实际状态，比盯着 2D 窗口猜要快。
3. ExternalData 与 Graphics 系列：外部数据注入和 2D 窗口精细控制
3.1 ExternalData：把遥测数据实时喂给 STK
ExternalData是这份手册里最有实战价值的一条指令。它允许你通过第三方程序生成时序数据，实时注入 STK 对象，并在 3D 窗口中显示。典型场景是：你用 Python 或 C++ 算出一组姿态、燃料、转速数据，想直接在 STK 里看动态效果，而不是导出文件再手动导入。
手册里的流程是：先AddGroup创建数组，再SetInputUnit设单位，然后AddData逐条添加，最后可以用FlushGroup清空或DeleteGroup删除。
# 在 Sat1 下创建名为 My Data 的数组，包含 Fuel Mass 和 Spin Rate 两个变量 ExternalData */Satellite/Sat1 AddGroup "My Data" 2 Fuel Mass Spin Rate # 设置 Spin Rate 的输入单位为 km/min ExternalData */Satellite/Sat1 SetInputUnit "My Data" Spin km Spin min # 设置 Spin 变量的插值阶数为 2 ExternalData */Satellite/Sat1 SetInterpOrder "My Data" Spin 2 # 设置数据稀释间隔为 10 秒 ExternalData */Satellite/Sat1 SetThinningInterval "My Data" 10.0 # 添加两条数据 ExternalData */Satellite/Sat1 AddData "My Data" "1 Jun 2002 00:00:00.00" 303.25 4.2938 ExternalData */Satellite/Sat1 AddData "My Data" "1 Jun 2002 00:00:15.22" 302.02 4.4522参数说明：AddGroup的第二个参数是变量数量，后面依次是变量名和维度。如果变量名带空格，必须加引号。SetInputUnit的单位缩写要跟 STK GUI 里的一致，复合变量比如Rate需要拆开设。SetThinningInterval控制数据保存的最小时间间隔，默认是 0，表示全存；设成 10 秒后，10 秒内的新数据会覆盖旧数据，适合高频遥测场景。
无单位数据和字符数据的处理是容易忽略的点：
# 无单位数据：维度设为 Custom，单位设为空字符串 ExternalData */Facility/f1 AddGroup "LinearData" 1 "Values" "Custom" ExternalData */Facility/f1 SetInputUnit "LinearData" "Values" "" # 字符数据：维度设为 Char，数值加引号 ExternalData */Satellite/Satellite1 AddGroup "Test Char Data" 3 Fuel Mass Name Char Spin Rate ExternalData */Satellite/Satellite1 AddData "Test Char Data" "27 Oct 2004 00:00:00.00" 303.25 "Name 1" 4.2938字符变量在AddData时数值必须带引号，否则 STK 会把它当成数值解析然后报错。这个坑我在第一次用的时候踩过，排查了半天才发现是引号问题。
3.2 Graphics 系列：2D 窗口的显示开关与样式
Graphics 系列指令在手册里占了很大篇幅，从Boundary、BoundaryPts、Centroid、Fill到LineStyle、LineWidth、Marker、SetColor、SetLabel，基本覆盖了 2D 窗口里所有视觉元素。
# 打开面目标边界显示 Graphics */AreaTarget/AreaTarget1 Boundary On # 显示边界上的个别点 Graphics */AreaTarget/AreaTarget1 BoundaryPts On # 显示质心 Graphics */AreaTarget/AreaTarget1 Centroid On # 填充覆盖区域 Graphics */AreaTarget/AreaTarget1 Fill On # 设置线型为虚线，线宽为 2 Graphics */LineTarget/TestLT LineStyle dashed Graphics */LineTarget/TestLT LineWidth 2 # 用 X 标记卫星当前位置 Graphics */Satellite/ERS1 Marker X # 设置标识颜色为黄色（颜色代码 4） Graphics */Satellite/Shuttle SetColor 4 Marker # 设置自定义标识文字 Graphics */Facility/Fac1 SetLabel "New Label"Marker的Custom模式支持加载位图，但文件必须以.bmp结尾。如果要用 MIL-STD 2525b 军用符号，需要额外安装字符服务器，并且SymbolID是 15 字符长度的编码。SetColor的颜色值可以用数字代码，也可以用red、%255000255这种格式。手册里提到：如果Marker选了图片，SetColor的Item参数就不起作用了。
Graphics ObjectStateInWin是控制多窗口显示的进阶指令：
# 在 2D 窗口 1 和 3 中关闭目标 t1 和飞机 ac1 的图形 Graphics * ObjectStateInWin Show off Object Target/t1 Object Aircraft/ac1 WindowId 1 WindowId 3注意手册里的一个细节：关闭某个 2D 窗口后，该窗口中对象的 On/Off 状态会恢复默认。也就是说，你在窗口 2 里关掉了某个对象，窗口关闭再重建后，对象又会显示出来。如果你需要持久化的显示控制，得在每次创建窗口后重新执行指令。
4. 避坑与排查：Connect 指令执行失败的五个常见原因
4.1 对象路径写错，命令返回错误但不说哪里错
现象：执行Copy或Graphics时返回错误信息，但只提示“命令失败”，不指出具体路径问题。
原因：STK Connect 的路径解析是大小写敏感的，而且*只能代表当前场景。如果你写*/Satellite/satellite1而实际对象名是Satellite1，就会失败。
解决：先用GetChildren或手动在对象浏览器里确认完整路径。我习惯在脚本开头定义一个变量存路径前缀，避免手打出错。
4.2 DisplayTimes 对运载对象不生效
现象：对卫星或飞机执行DisplayTimes，返回确认信息但图形显示没变化。
原因：手册明确写了，运载对象（Vehicles）不能用DisplayTimes，得用Graphics CustomIntervals或Graphics AccessIntervals。
解决：先判断对象类型。如果是Satellite、Aircraft、Missile等，换用 Graphics 系列指令。如果是AreaTarget、Facility、Sensor，DisplayTimes才有效。
4.3 ExternalData 的 AddData 报单位不匹配
现象：AddData执行时报错，提示单位不一致或数据格式错误。
原因：AddGroup时定义的变量顺序和AddData时传入的数值顺序必须完全一致。另外，如果变量是Char类型，数值必须加引号；如果变量无单位，SetInputUnit要设为空字符串。
解决：先AddGroup，再SetInputUnit，再SetInterpOrder，最后AddData。每一步都确认返回值。如果还是报错，用GetDescription或手动在 Object Tools 里查看数据提供器状态。
4.4 Graphics Marker 的 Custom 图片不显示
现象：执行Graphics */Satellite/ERS1 Marker Custom "/path/to/test.bmp"后，2D 窗口里没有出现图片。
原因：文件路径不对，或者文件不是.bmp格式。手册里强调图片文件必须为位图，且路径要用双引号括起来。
解决：确认文件存在且扩展名是.bmp。如果路径包含空格，引号不能省。另外，如果之前设置过SetColor的Marker项，Custom 图片会覆盖颜色设置。
4.5 BoundaryType 的 Granularity 设太小导致性能下降
现象：面目标边界点数量暴增，2D 窗口刷新变慢，覆盖计算耗时明显增加。
原因：Granularity默认 0.5 度，设到 0.01 度时边界点数量可能翻几十倍。
解决：根据实际精度需求调整。全球级分析用 1.0 到 2.0，区域级用 0.1 到 0.5，局部精细分析才用到 0.01。改完之后用GetBoundary查看点数，确认在可接受范围。
5. 把手册用成自己的速查表：三个进阶习惯
这份手册是半成品，翻译了一半，剩下的得自己补。我的做法是：先通读已翻译的部分，把每条指令的“命令格式、参数表、用法举例、返回值、适用组、STK 版本”六要素抄到自己的笔记里，然后针对没翻译的指令，直接对照英文帮助文档补全。这样一轮下来，手册就变成了个人定制的速查表。
第二个习惯是给每条指令写一个最小可执行脚本。比如ExternalData，我会写一个 Python 脚本，用subprocess调用 STK Connect，生成模拟数据并注入，然后截图验证。这样下次遇到类似需求，直接改参数就能跑。
第三个习惯是版本对照。手册里标注了每条指令的 STK 版本，比如BoundaryType是 8.1，Copy是 8.0，DisplayTimes是 7.1。如果你用的版本低于标注版本，指令可能不存在或参数不同。我一般会在脚本开头加一个版本检查，避免在低版本上浪费时间。
import subprocess # 定义 STK Connect 执行函数 def stk_connect(cmd): # 假设 STK 安装在默认路径，实际使用时替换为你的路径 stk_path = r"C:\Program Files\AGI\STK 12\bin\Connect.exe" result = subprocess.run([stk_path, cmd], capture_output=True, text=True) return result.stdout # 示例：查询面目标边界 output = stk_connect("GetBoundary */AreaTarget/Iceberg") print(output)这段代码的逻辑是：通过subprocess调用 STK 的 Connect 可执行文件，把指令作为参数传入，然后捕获输出。参数说明：stk_path需要根据实际安装路径修改，cmd是任意合法的 Connect 指令。如果你在 Linux 环境下，STK 的调用方式不同，得用stkConnect或者通过 COM 接口。
从那以后我每次拿到新的 STK 版本，都会先跑一遍手册里的示例指令，确认哪些还能用、哪些参数变了。这份半成品手册最大的价值不是它翻译了多少，而是它给了你一个起点——剩下的，靠自己补比等别人翻译快得多。希望帮到你。
本文还有配套的精品资源，点击获取
