⚠️需确认：

官方指令在哪？

官方指令是用户在左侧指令区自定义指令旁边 获取 → 指令市场 安装的指令，如下图：
image.png
用户在企业指令或个人指令中安装的指令属于用户自行开发的指令，包括实施小组给到客户的指令，不维护。

如何根据「指令名」确定「指令集名」？

举例：修改日期时间指令出错，在左边搜索，搜索结果中展示指令集名。
image.png

如何判断一个指令是否是官方指令？

点击设计器左上角获取按钮，点击已安装，鼠标移动到出问题的指令集上，官方指令的所有者帐号是 sdk@fckj 或 admin@bigdata，其他指令都是非官方指令，不维护。
image.png
如果是“下架指令”开头，说明指令已经下架不再维护，也不能在未安装的应用中安装，出问题请使用新版官方指令。

是否已经阅读使用说明？

使用说明中会解释指令使用中的一大部分问题，请先确认读过使用说明：
image.png

如何检查指令版本是最新？

点击设计器左上角获取按钮，点击已安装，如果这个指令旁边有更新按钮，则这个指令不是最新版，不维护。请更新指令。
指令改动后，也需要更新指令才能更新代码为最新版。更新指令后重试一下看看问题有没有修复。
image.png

☑️上述均已确认：

需要给到的材料：

1. 问题指令名及指令集名，如「日期时间扩展指令集-修改日期时间」。

2. 指令的所有输入的截图（包含「高级」选项截图，如有）
如果指令的输入有其他指令或用户输入的内容不明的变量，尽量按照指令的使用说明中的使用示例单独测试，确认是指令问题而不是输入的变量有错，如：

image.png

3. 详细报错信息（如有），在下图中点击按钮复制，不要直接给下图中简化后的信息，
image.png
如：

  1. Traceback (most recent call last):
  2.   File "C:\Program Files (x86)\ShadowBot\shadowbot-5.0.54\python\lib\runpy.py", line 193, in _run_module_as_main
  3.     "__main__", mod_spec)
  4.   File "C:\Program Files (x86)\ShadowBot\shadowbot-5.0.54\python\lib\runpy.py", line 85, in _run_code
  5.     exec(code, run_globals)
  6.   File "C:\Program Files (x86)\ShadowBot\shadowbot-5.0.54\python\lib\site-packages\xbot_interpreter.py", line 67, in <module>
  7.     main()
  8.   File "C:\Program Files (x86)\ShadowBot\shadowbot-5.0.54\python\lib\site-packages\xbot_interpreter.py", line 45, in main
  9.     try:
  10.   File "C:\Users\Admin\AppData\Local\ShadowBot\users\fa28c4be-b1fc-4625-a19a-91577829d448\apps\77ee9160-980a-40f9-9452-7f7be82c3e96\xbot_robot\process29.py", line 25, in main
  11.     ], _block=("日期时间扩展测试", 5, "修改日期时间"))
  12.   File "<string>", line 112, in wrapper
  13.   File "<string>", line 107, in wrapper
  14.   File "<string>", line 82, in run
  15.   File "C:\Users\Admin\AppData\Local\ShadowBot\users\fa28c4be-b1fc-4625-a19a-91577829d448\apps\77ee9160-980a-40f9-9452-7f7be82c3e96\xbot_extensions\shadowbot_datatime\process3.py", line 22, in main
  16.     }, _block=("修改日期时间", 1, "调用模块"))
  17.   File "<string>", line 112, in wrapper
  18.   File "<string>", line 107, in wrapper
  19.   File "<string>", line 112, in wrapper
  20.   File "<string>", line 107, in wrapper
  21.   File "<string>", line 37, in invoke_module
  22.   File "C:\Users\Admin\AppData\Local\ShadowBot\users\fa28c4be-b1fc-4625-a19a-91577829d448\apps\77ee9160-980a-40f9-9452-7f7be82c3e96\xbot_extensions\shadowbot_datatime\arrow_utils.py", line 129, in switch_fields_for_datetime
  23.     return arrow_instance.replace(**{gap_dict[field_to_switch]: _value_to_switch_to}).datetime
  24.   File "C:\Users\Admin\AppData\Local\ShadowBot\users\fa28c4be-b1fc-4625-a19a-91577829d448\apps\77ee9160-980a-40f9-9452-7f7be82c3e96\venv\lib\site-packages\arrow\arrow.py", line 976, in replace
  25.     current = self._datetime.replace(**absolute_kwargs)
  26. ValueError: day is out of range for month

4. 如果指令涉及任何元素操作（如生意参谋、京东商智等业务相关指令），尽可能给到测试或运行时的录屏。
如果是指令报错，可以用影刀自带的录屏，开启自动录制，关掉下图中的选项即可自动录制报错录屏。

image.png

❓常见问题

Q1：我可以参与官方指令的开发吗？or 我开发了一个指令，可不可以帮我上架官方？

A1：为保证所有官方指令的开发符合规范以及减少维护工作量，除综合内容小组成员原则上不可以参与开发。自行开发的指令不可以上架官方，可以发布在 fckj 企业内部市场；或者有指令需求提给白云。

Q2：XX官方指令可不可以给我个协作？ or 我可以看官方指令源码吗？

A1：官方指令原则上不设开发者以外的协作者（综合内容小组除外）。可以给到指令截图参考思路，如果指令有问题，提工单或联系综合内容小组确认问题并排期维护。如果希望新增或更改指令实现，参照 Q1。

Q3：担心官方指令的更新会导致问题？

所有应用中的所有指令集均不会自动更新，更新指令集的操作无法撤销。
指令更新：
1. 在 获取→ 已安装 中更新；
2. 在影刀控制台→应用管理（下图）找到这个应用，点击更新应用，即可更新这个应用包含的所有指令集。
image.png
如果为了避免执行更新后的陌生代码，希望依赖一个固定（当前）版本的官方指令，可以用企业管理员帐号新建指令集，在其中安装官方指令后把所有需要的指令重新封装一次，之后保证不更新这个指令集中的官方指令即可。可将这个指令分享到企业指令市场中供所有员工使用。