简介：《Connect命令参考手册》面向需要深度使用STK（System Tool Kit）进行空间任务仿真与分析的中文用户，尤其适合已掌握基础操作、希望借助Connect指令实现定制化控制与批量处理的中高级使用者。原版STK帮助文档为英文，阅读门槛较高，这份由个人翻译整理的Word文档提供了中文参考，并开放版权、鼓励社区继续补全未译部分。资源包共1个doc文件，约5.62MB，内容按子命令组织，涵盖BoundaryType、Copy、DisplayTimes等指令的格式、参数选项、用法举例、返回值及适用对象组与STK版本说明，例如大圆弧与等角航线的边界类型选择、对象复制与重命名、按时间间隔控制2D/3D显示等。目前已有2227人学习下载，可作为查阅Connect指令、理解参数含义与排查调用问题的实用工具书，也便于有兴趣的读者接力翻译剩余章节。

1. Connect 命令参考手册：把 STK 从点界面变成可脚本化的黑匣子

如果你只用 STK 的图形界面点按钮，很多重复操作会把人耗死：几十个面目标要统一改边界粒度、一批卫星要按时间窗口控制显隐、外部遥测数据要实时灌进 3D 窗口。这些事在 GUI 里点一遍还行，点十遍就是纯体力活。Connect 命令就是把这些操作变成一行行可复用、可批处理的指令，而这份《Connect 命令参考手册》做的正是把英文帮助文档里的 Connect 指令逐条翻成中文，覆盖面目标、线目标、图形显示、外部数据等常用组。它适合已经会用 STK 界面、想往自动化和批量处理走的人；也适合刚接触 Connect、被英文文档劝退的新手拿来对照查参数。手册本身是 Word 文档形态的翻译稿，不是官方出版物，读的时候要带着“对照原版验证”的习惯。

2. Connect 指令的调用骨架：路径、对象与返回值怎么对上

Connect 指令看着杂，但骨架高度统一：一条命令基本是「指令名 + 对象路径 + 选项/参数」三段式，成功返回 ACK 开头的确认信息，失败则返回错误码。把这三段吃透，手册里几十条命令就是同一套语法在不同对象上的展开。这一章先把调用骨架立住，后面再看具体命令就不会散。

2.1 对象路径的写法与通配符

STK 里的对象路径用斜杠分层，根是场景，往下是对象类别，再往下是实例名。Connect 命令里的<ObjectPath>支持通配符*，这在批量操作时非常关键。比如*/Satellite/Satellite1表示当前场景下 Satellite1 这颗卫星，而*单独出现在某一段就代表该层所有对象。

# 复制当前场景下所有卫星对象中的 Satellite1 Copy / */Satellite/Satellite1 # 复制 Satellite1 下的 Sensor1，挂到 Satellite2 下并改名 DownSn Copy / */Satellite/Satellite1/Sensor/Sensor1 Path */Satellite/Satellite2/Sensor/DownSn

第一行里第一个/是应用路径（ApplicationPath），第二个*是场景通配，后面才是对象路径。第二行用Path选项指定了新对象的落点，注意目标路径的末段DownSn就是新实例名，不需要再单独写Name。这里容易翻车的是路径层级：传感器挂在卫星下，所以路径是Satellite/Satellite1/Sensor/Sensor1，少写一层Sensor就会报对象不存在。参数说明上，Copy的Name和Path可以只给一个，只给Name时对象留在原父级下改名，只给Path时按目标路径末段命名。

2.2 选项参数的大小写与引号规则

Connect 对选项关键字大小写不敏感，但字符串参数里的空格必须用引号包住，这是新手最常踩的语法坑。手册里DisplayTimes、ExternalData、Graphics SetLabel都反复强调带空格的名称要加引号。

# 给地面设施设置带空格的显示标识 Graphics */Facility/Fac1 SetLabel "New Label" # 为卫星添加一个名为 My Data 的外部数据组，含两个变量 ExternalData */Satellite/Sat1 AddGroup "My Data" 2 Fuel Mass Spin Rate

第一行SetLabel后面的文本含空格，不加引号会被解析成多个参数直接报错。第二行AddGroup的组名"My Data"同样要引号，而变量名Fuel、Mass、Spin、Rate之间用空格分隔，数量必须和前面的2对上——这里2是变量个数，Fuel Mass是第一个变量的名和维度，Spin Rate是第二个。维度写错（比如把Mass写成mass或漏掉）会导致后续AddData时单位对不上。常见做法是先用SetInputUnit把每个变量的单位显式设一遍，再灌数据，避免默认单位带来的隐性错误。

2.3 返回值判读与批量脚本的容错

每条 Connect 命令执行成功返回ACK加指令名，失败返回错误信息。批量脚本里不能假设每条都成功，尤其是路径写错、对象不存在、时间格式不对这三类错误。我一般会在脚本里对返回值做前缀判断，ACK开头才继续，否则记录该行并跳过。

import subprocess def run_connect(cmd): # 通过命令行方式调用 Connect，实际接入方式按你的环境调整 result = subprocess.run(cmd, capture_output=True, text=True) out = result.stdout.strip() if out.startswith("ACK"): return True, out # 非 ACK 一律视为失败，记录原始返回便于排查 return False, out commands = [ 'DisplayTimes */AreaTarget/AreaTarget1 State AlwaysOn', 'Graphics */AreaTarget/AreaTarget1 Fill On', ] for c in commands: ok, msg = run_connect(c) if not ok: print(f"[FAIL] {c} -> {msg}")

这段脚本的重点不在调用方式，而在容错逻辑：ACK前缀判断是唯一可靠的成败信号，不要用“没报错就是成功”来推断。参数上，DisplayTimes的State AlwaysOn会让对象无视时间间隔始终显示，适合调试阶段先确认对象存在；Graphics Fill On控制面目标填充显示，和Boundary On是两回事，前者管区域填充、后者管边界线，排查显示问题时这两个要分开验证。批量跑之前建议先单条手工执行一遍，确认路径和参数无误再进循环，否则错误会被批量放大。

3. 面目标与线目标：BoundaryType、ExtendBoundary、GetBoundary 三件套

面目标和线目标是 Connect 里最常用也最容易出参数问题的一组。边界类型选错会让覆盖计算的结果偏离预期，粒度设太大又会让边界点稀疏到看不出形状。这一章按「定类型 → 扩边界 → 读回来验证」的顺序把三件套串起来，每一步都给可抄的命令。

3.1 BoundaryType：GreatArc 与 RhumbLine 的选型理由

BoundaryType决定面目标/线目标边界线的几何类型。GreatArc是地球表面两点间最短距离，但方向沿途变化，不能直接用于导航；RhumbLine是等角航线，方向恒定，适合导航类场景。选哪个不是审美问题，而是下游计算依赖什么。

# 把线目标 ltPrimeMeridian 设为等角航线，粒度 2.0 度 BoundaryType */LineTarget/ltPrimeMeridian Type RhumbLine Granularity 2.0

Type只接受GreatArc或RhumbLine两个值，写别的直接报错。Granularity单位是度，范围 0.01～10.0，默认 0.5。粒度越小边界越贴合真实曲线，但边界点数量上升，后续覆盖计算和显示都会变慢；粒度越大越省资源，但形状失真明显。我的经验是：做覆盖分析用 0.1～0.5，做快速可视化预览用 1.0～2.0。注意这条命令只改边界线型，不改已有边界点坐标，改完要用GetBoundary回读确认。

3.2 ExtendBoundary：按经纬度或 UTM 追加边界点

ExtendBoundary往已有面目标边界上追加点，前提是面目标至少已有一个边界点，否则先报错。点类型默认LatLon，也可以显式指定UTM。

# 为面目标 at1 追加两个经纬度边界点：50,0 和 10,45 ExtendBoundary */AreaTarget/at1 Pattern LatLon 2 50 0 10 45 # 用 UTM 坐标追加一个点，ZoneStr 形如 50N ExtendBoundary */AreaTarget/at1 Pattern UTM 1 50N 500000 4000000

第一行Pattern LatLon后跟点数2，再按「纬度 经度」成对给坐标，顺序不能反。第二行 UTM 模式下ZoneStr的有效值是 A、B、Y、Z 或「两位数字 + 字母」形式，Easting、Northing用 Connect 距离单位。常见翻车点是点数与实际坐标对数不一致：写2却只给了一对坐标，命令会截断或报错。另外ExtendBoundary只追加不替换，想重设整条边界要用SetBoundary，这两个命令别混。

3.3 GetBoundary：回读边界验证与椭圆目标的特殊返回

GetBoundary是验证手段，不是设置手段。对面目标定义为图像的情况，它返回边界点列表；对椭圆定义的面目标，返回半长轴、半短轴和方位角，返回结构完全不同。

# 回读 Iceberg 面目标的边界定义 GetBoundary */AreaTarget/Iceberg

返回以ACKGETBOUNDARY开头，后面跟Pattern Data; Num Points:和逐行经纬度点对。如果对象是椭圆定义，返回的是轴长和方位而不是点列表，脚本解析时不能假设一定是点数组。实操里我习惯在ExtendBoundary之后立刻GetBoundary一次，把点数对一遍——追加了几个点、总数对不对，一眼就能看出来，比等到覆盖计算出问题再回头查省事得多。

4. DisplayTimes 与 Graphics 系列：把 2D 窗口的显隐控制住

图形显示类命令是 Connect 里数量最多、也最容易互相干扰的一组。DisplayTimes管时间维度上的显隐，Graphics系列管静态样式和窗口级开关，两者叠加时优先级要理清，否则会出现「明明设了 AlwaysOn 却还是不显示」的玄学现象。这一章把时间控制和图形控制分开讲，再给一个组合排查思路。

4.1 DisplayTimes：Intervals、State、File 三种控制路径

DisplayTimes的核心是{DisplayOption}加{Action}的组合。Intervals下可Add、Delete、Replace、Clear，State下可设AlwaysOn、AlwaysOff、Interval、Access，File下可Load或Add时间间隔文件。

# 让 AreaTarget1 在 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 */Facility/Facility1 Intervals File Load "C:\stk50DB\Target1.int" # 删除 Sensor1 的一个指定时间间隔 DisplayTimes */Satellite/Satellite1/Sensor/Sensor1 Intervals Delete 1 "1 Jul 2005 20:44:05.396" "1 Jul 2005 22:54:24.00"

第一行Add后的2是时间间隔对数，后面按「开始 结束」成对给，时间字符串必须带引号且格式与场景时间格式一致。第二行File Load会用文件内容替换现有间隔，文件里的间隔必须落在对象运行时间周期内，超出部分不会被载入，重复间隔也不会重复添加。第三行Delete的1表示删一对，起止时间要和已有间隔精确匹配，差一个毫秒都删不掉。注意运载对象（Vehicles）不能用DisplayTimes，得改用Graphics CustomIntervals或Graphics AccessIntervals，这是手册里明确点出的边界。

4.2 Graphics 显隐与样式：Boundary、Fill、Marker、LineStyle 的分工

Graphics系列按对象类型细分，面目标常用Boundary、BoundaryPts、Fill、Centroid，通用样式有LineStyle、LineWidth、Marker、SetColor、SetLabel。这些命令各管一摊，混用会互相覆盖。

# 面目标：开边界线、开填充、开质心 Graphics */AreaTarget/AreaTarget1 Boundary On Graphics */AreaTarget/AreaTarget1 Fill On Graphics */AreaTarget/AreaTarget1 Centroid On # 线目标：设线型和线宽 Graphics */LineTarget/TestLT LineStyle dashed Graphics */LineTarget/TestLT LineWidth 2 # 卫星：用 X 标记当前位置，标识文字单独设置 Graphics */Satellite/ERS1 Marker X Graphics */Satellite/ERS1 SetLabel "ERS-1"

Boundary管边界线显示，Fill管区域填充，Centroid管质心点，三者独立开关，排查「面目标看不见」时要逐个确认。LineStyle接受Solid、Dashed、Dotted或数字 0、1、2，LineWidth范围 1.0～10.0。Marker的Custom模式要求图片是.bmp位图，路径带空格要引号。SetColor的{Item}参数决定改哪个图形属性，卫星可改Label、Marker、GroundTrack，面目标可改Label、Marker、Polygon，不写{Item}会改所有属性，这点要特别小心。

4.3 ObjectStateInWin：窗口级显隐与时间控制的叠加优先级

ObjectStateInWin控制对象在指定 2D 窗口里是否显示，和DisplayTimes的时间控制是两层逻辑：时间控制决定「这个时刻该不该显示」，窗口控制决定「在这个窗口里允不允许显示」，两者取交集。

# 在窗口 1 和 3 中隐藏目标 t1 和飞机 ac1 Graphics * ObjectStateInWin Show off Object Target/t1 Object Aircraft/ac1 WindowId 1 WindowId 3 # 在窗口 1 中重新打开目标 t1 Graphics * ObjectStateInWin Show On Object Target/t1 WindowId 1

Object可以在一行里写多个，WindowId也可以多个，但要注意窗口关闭后状态会恢复默认——在窗口 2 里设成 Off，关掉再新建同名窗口 2，对象又会全部显示。这个行为在批量脚本里很容易造成「设置没生效」的错觉。另外这条命令不影响 Chains、Constellations、Attitude Coverage 对象，对这几类对象要用别的途径。排查显示问题时我的顺序是：先GetDspTimes看时间状态，再确认ObjectStateInWin的窗口设置，最后才怀疑Graphics样式，从时间到窗口到样式逐层排除，比乱试快得多。

5. ExternalData 与常见排查：外部时序数据灌入的五个坑

ExternalData是把第三方程序算出的遥测、状态数据实时喂进 STK 的入口，也是整份手册里参数最密、最容易出错的一条。它涉及组创建、单位设置、插值阶数、数据稀释、字符类型五个环节，任何一环没对上，数据要么灌不进去，要么灌进去显示错位。这一章先讲清楚数据流的建立顺序，再把踩过的坑逐条列出来。

5.1 从 AddGroup 到 AddData：数据流的建立顺序

ExternalData的正确顺序是：AddGroup建组并声明变量 →SetInputUnit设单位 →SetInterpOrder设插值 →SetThinningInterval设稀释 →AddData灌数据 → 用完FlushGroup或DeleteGroup。顺序错了，后面的命令会找不到组或单位不匹配。

# 建组：两个变量 Fuel(Mass) 和 Spin(Rate) ExternalData */Satellite/Sat1 AddGroup "My Data" 2 Fuel Mass Spin Rate # 设单位：Spin 用 km/min，Fuel 用默认 ExternalData */Satellite/Sat1 SetInputUnit "My Data" Spin km Spin min # 插值阶数设为 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 # 清空数据但保留组结构 ExternalData */Satellite/Sat1 FlushGroup "My Data"

AddGroup的2是变量个数，后面按「变量名 维度」成对出现，Fuel Mass表示变量 Fuel、维度 Mass，Spin Rate表示变量 Spin、维度 Rate。SetInputUnit对复合变量要分别设，Spin km Spin min是「变量名 单位缩写 变量名 单位缩写」的成对写法。AddData的值顺序必须和建组时的变量顺序一致，单位必须和SetInputUnit一致，否则直接报错。FlushGroup只清数据不删组，DeleteGroup连组一起删，调试阶段用前者更安全。

5.2 无单位数据与字符变量的特殊写法

不是所有外部数据都有物理单位，字符串变量也要单独处理。无单位数据把维度设成Custom、单位设成空字符串；字符变量把维度设成Char，灌数据时值要带引号。

# 无单位数据：维度 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

无单位那条里"Values" "Custom"是变量名加维度，SetInputUnit的单位缩写给空串""，漏了这步会按默认单位解析导致数值被换算。字符变量那条Name Char声明了字符维度，AddData时对应位置必须给带引号的字符串，给数字会报类型错误。这两类写法在手册里是分开举例的，实际项目里经常混在同一个组里，建组时变量顺序和类型一定要一次定对，中途改类型只能删组重建。

5.3 避坑清单：五条血泪排查记录

现象一：AddData报单位不匹配。原因：建组时没设SetInputUnit，或设的单位缩写和AddData数值的实际单位不一致。解决：建组后立刻把每个变量单位显式设一遍，复合变量按「变量名 单位」成对写，灌数据前用GetGUIUnits对照可用缩写。

现象二：数据灌进去了但 3D 窗口不刷新。原因：ExternalData只负责把数据挂到 User Supplied Data 数据提供器下，3D 实时显示还要在对象工具里选中该数据源。解决：打开 Object Tools → Report，新建报告时在数据提供器列表里勾选对应组，确认数据源被引用。

现象三：File Load的时间间隔没生效。原因：文件里的间隔超出对象运行时间周期，或与已有间隔重复。解决：先确认场景时间周期覆盖文件内所有间隔，重复间隔不会被添加，需要先Clear再Load。

现象四：DisplayTimes设了AlwaysOn对象仍不显示。原因：ObjectStateInWin在该窗口里把对象设成了 Off，窗口级开关优先级高于时间状态。解决：用Graphics * ObjectStateInWin Show On把目标窗口的对象重新打开，再验证时间状态。

现象五：Copy复制传感器后路径找不到。原因：Path选项的末段被当成新实例名，但父级路径层级写错，比如漏了Sensor这一层。解决：复制前先用GetDescription或界面确认源对象完整路径，Path写到目标父级加新实例名，层级逐段对照。

6. 把手册用成工作流：从单条验证到批量脚本的落地习惯

这份手册的价值不在通读，而在当查询字典用。我的习惯是：任何一条 Connect 命令进批量脚本之前，先在单条环境里跑通并回读验证，确认路径、参数、返回值三样都对，再往循环里放。单条验证阶段重点看两件事——返回是不是ACK开头，以及用对应的Get类命令回读设置是否真的生效。比如设完BoundaryType用GetBoundary看粒度，设完DisplayTimes用GetDspTimes看状态，设完ExternalData用报告确认数据源被引用。这一步多花两分钟，能省掉后面批量跑完发现全错、回头逐条排查的两小时。

批量脚本的组织上，我一般按对象类别分文件：面目标一个脚本、卫星显示一个脚本、外部数据一个脚本，每个脚本头部放一组路径常量，避免路径散落在几十行命令里改起来漏改。命令之间加短暂延时或串行执行，别并发灌同一条命令，STK 对同一对象的并发写操作行为不稳定，这是踩过的坑。手册里没翻完的部分，遇到不认识的命令先查英文原版帮助，确认参数含义再补进自己的注释表，别凭命令名猜参数——Graphics系列里Boundary和BoundaryPts只差几个字母，作用完全不同，猜错就是白跑一轮。

还有一个具体技巧：把常用命令组合封装成带参数的函数，参数只暴露对象路径和关键数值，其余选项写死。比如封装一个set_area_display(path, boundary=True, fill=True, centroid=False)，内部拼三条Graphics命令，调用时只传路径和开关。这样脚本可读性上来了，改默认行为也只改一处。手册里那些选项表，正好拿来当函数参数的合法值清单，LineStyle的Solid/Dashed/Dotted、Marker的Point/Plus/Star/Square/Circle/X/None/Custom，直接映射成枚举校验，传错值在函数入口就拦下来，不用等 STK 返回错误码。

从那以后我每次把新命令加进脚本前，都强制走一遍「单条跑通 → Get 回读 → 再进循环」的流程，哪怕这条命令在手册里看着再简单。Connect 的坑大多不在命令本身，而在路径层级、单位、窗口状态这些周边条件上，单条验证是唯一能把这些条件逐个钉死的办法。希望这份手册和这些排查顺序，能帮你少走几轮弯路。

本文还有配套的精品资源，点击获取