干将使用说明书

先选对功能，再开始分析。干将将实验图谱分析、结构计算和晶体查看集中在同一个工作空间。

01

物相识别

从实验图谱检索候选晶相。

02

精修 + 识别

先寻找物相，再检验候选结构的拟合。

03

已知物相精修

使用已有 CIF 直接进行结构精修。

04

PDF 卡计算

将理论反射与实验峰进行对照。

05

XRD 模拟

从 CIF / MCIF 计算理论衍射图谱。

06

晶体可视化

查看 CIF 中的原子排列。

根据目标准备输入文件，并记录真实测量条件。这一步决定后续参数能否正确解释实验数据。

图谱格式

每个任务只提交一份实验图谱。仪器专用文件解析失败时，从仪器软件导出两列 CSV 或 XY；仅修改后缀不能转换文件。

两列文本通常为 2θ（度）和强度，每行对应一个采样点。保持角度与强度整行对应，并说明文件是否包含表头，以及是否经过扣背景、平滑或归一化处理。

测量条件

记录样品编号、辐射源或波长、横坐标单位、扫描范围及仪器参数文件（如有）。不要把软件默认值当成已知测量条件。

1. 点击“新建任务”，再选择左侧所需功能。
2. 点击底部任务输入框的 “+”，选择具体文件并确认附件名正确。不要把测试数据总压缩包作为一份图谱上传。
3. 在同一输入框填写分析目标、样品编号和已知条件。功能入口预填的文字可以补充；模型选择器不是物相检索模型或辐射设置。
4. 点击右下角发送按钮。参数确认表单出现后，检查任务类型、单相或多相、检索方式、元素及化学式等可见字段。
5. 以确认表单的最终选值为准。修改后提交表单；关闭或取消表单不会启动计算。
6. 查看当前任务的执行消息。若仍停留在“计划待确认”，先完成表单提交，不必重复上传相同文件。

同一样品补充条件时继续原任务。更换样品或比较另一组设置时新建任务，名称包含样品编号和条件，以免把不同任务的截图与输出混用。

根据一份实验图谱检索候选晶相，不执行结构精修。未知物相识别不要求提供 CIF；进行不带化学式的测试时，化学式字段留空。

请对附件进行单相物相识别，不精修。
已知元素：Ca Fe Si O
不提供候选化学式。请在单相配置中使用 XMatcher 和 XQueryer-LW。
辐射条件：[实际条件]；预处理：[实际处理或无]。

完成检查

先检查检索通道是否成功，再查看候选排序和复核结论。Top 1 仅指当前排序第一的候选，不能自动当作已确认物相。没有候选列表时，不存在可选择的 Top 1。

多相指一份样品图谱包含多个晶相，不是同时上传多份图谱。选择“物相识别”并上传一份混合图谱，在确认表单中选择“多相”。相数未知时可选择“未知物相数目”。

多相表单提供以上两种通道，可保留默认的两种通道，或按测试要求只选一种。候选会汇总并接受复核。单相的 XQueryer-LW 与 XMatcher 选项不能代替多相表单设置。

元素与化学式分别填写

请对附件进行多相物相识别，不精修，不提供候选化学式。
已知元素：Ca Al Si O Ni S
请使用多相配置中的 XMatcher-AutoMix 和 XDecomposer。
辐射条件：[实际条件]；相数：[未知或已知数量]。

先寻找物相，再检验候选结构对实验图谱的拟合。输入一份图谱和测量条件，已知元素用于识别阶段。识别结果与精修结果属于不同阶段，应分别检查。

1. 点击“精修 + 识别”，上传图谱并说明单相、多相或相数未知。
2. 提交首次识别确认表单，核对元素、化学式及识别通道。
3. 识别阶段返回后，查看候选及其依据；出现精修确认表单时，核对使用的候选相或结构文件。
4. 选择当前可用的精修引擎，填写仪器文件（如有）、精修范围、参数约束及轮数设置。不要仅因提高拟合程度就释放全部原子参数。
5. 提交精修确认并保持任务会话。通信中断时先检查原任务状态，避免重复启动同一计算。
6. 完成后核对计算与观测曲线、差值、拟合指标、结构文件及验证状态，并下载本任务文件。

先识别附件中的物相，再对有依据的候选进行精修。
样品：[编号]；元素：[已知元素或未知]；辐射：[实际条件]。
优先优化比例、背景和晶胞相关参数，固定原子占位率。
请提供全谱拟合、差值曲线、拟合指标及最终验证状态。

用于已具备结构模型的样品：跳过物相检索，直接以提供的 CIF 进行精修。单相上传一个 CIF；多相上传每个相的 CIF，并同时提供一份完整实验图谱。

1. 选择“已知物相精修”，通过“+”加入图谱和全部 CIF。
2. 核对每个 CIF 的化学式、晶胞及原子信息，避免重复上传同一结构或遗漏某一相。
3. 在精修表单中确认单相或多相、结构列表、引擎和仪器配置。提供 FullProf 仪器文件时使用对应的 IRF 文件。

输入一份实验图谱及一份或多份已知结构 CIF，计算理论反射并与实验峰对照。该功能不执行未知物相识别或 Rietveld 精修。

1. 点击“PDF 卡计算”，上传图谱与各相 CIF。
2. 检查确认表单中的文件名、波长及峰检测和匹配参数。
3. 提交计算。完成后分别查看理论反射表与实验峰表，检查峰归属和未匹配峰。
4. 调整相的可见性、颜色或标注时，保留物相名称及来源。手工改动峰归属后，使用报告中的导出控件保存当前版本。

初始值是软件默认设置，须按实际数据核对。下载 theory.csv、peaks.csv、observed.csv、parameters.json 或结果压缩包。初始文件记录自动归属，后续手工修改需另行导出。

从 CIF 或 MCIF 计算理论粉末衍射图谱，不需要实验图谱。可上传一个或多个结构文件，多文件模拟可比较各相分量及总图谱。

1. 选择“XRD 模拟”，上传需要模拟的结构文件。多个文件分别对应不同相。
2. 在确认表单中检查波长、2θ 范围、采样步长、峰形、峰宽及混合参数。
3. 提交计算，检查每个文件的解析状态；部分文件失败时，只能将成功的相列入已完成范围。
4. 在模拟面板中调整相可见性、颜色、相对显示比例与峰宽；选择总谱、叠加或堆叠视图，查看 HKL 峰表。
5. 保存当前视图时使用面板 CSV 或 SVG 导出。改变波长、扫描范围或步长，需要重新确认并计算。

初始下载文件包括 peaks.csv、pattern.csv、parameters.json 及压缩包，记录确认时的设置。

1. 点击左侧“晶体可视化”，进入结构查看页面。
2. 通过 CIF 文件选择控件选择一个 .cif 文件；页面提供拖放区域时也可拖入。
3. 等待结构解析，核对当前文件名和结构信息。换样品时重新加载对应 CIF，避免把上一份模型误认为当前模型。
4. 使用页面提供的视图操作观察原子排列；需要计算衍射图谱时返回“XRD 模拟”。

从 CIF 查看元素

用文本编辑器打开 CIF，搜索 _chemical_formula_structural、_chemical_formula_sum 或 _atom_site_type_symbol。化学式中的元素符号表示元素种类，数字表示计量关系。晶胞展开式中的数字可能大于最简结构式，但元素种类相同。

解析失败时

确认文件已解压且确为 CIF，检查晶胞参数和原子位点信息是否完整。CSV 图谱或图片不能通过修改扩展名变成结构文件。

先判断执行状态

保存与复查

从“最近”返回任务，核对样品编号、附件、参数和时间。保存原始输入、确认设置、输出文件及错误记录。使用结果附件中的下载入口；截图只记录可见内容，不能代替完整 CSV 或结果包。

查看 PDF 第 13 页

软件结果用于组织证据，不能以单一分数、覆盖率或低残差直接确定物相。结论必须同时满足数据条件、峰位、强度趋势、化学合理性和复核状态。

1. 确认输入。核对波长、2θ 范围、背景、元素约束和样品信息。
2. 查看候选。先看物相名称、化学式、空间群和数据库编号，再看排序分数。
3. 检查谱图。观察主要峰位是否对应，重点检查未解释峰和系统性强度偏差。
4. 执行复核。查看 Inspector、峰位检查和覆盖率；“通过”仍表示需要人工核实。
5. 检查精修。比较实验与计算曲线、差值曲线、拟合指标和参数变化是否合理。
6. 形成结论。仅把证据一致的结果写入报告，保留任务、输入、CIF 和导出文件。

查看 PDF 第 14 页

点击候选组合可同步查看各相的理论峰和结构。下面保留说明书中的四组候选，百分比表示相对衍射贡献。

• C2Li4O6 等价于 2 × Li2CO3 的化学式表示，ClNa 表示 NaCl，组合 3 与已知两相组成相符。
• 该组合分数为 55.71，已解释强度为 51.4%，但复核未通过，因此只能记录为候选。
• 组合 1、2、4 增加第三相，可能是对剩余峰的过度拆分。确认新增相前，应检查其独有峰是否连续存在，并核对化学来源。

查看 PDF 第 15 页

• 候选 1 排名最高并通过软件复核，可进入人工确认；峰位整体接近，但理论强度与实验强度存在差异。“通过”不等于已确定物相。
• 候选 2 的峰位检查未通过，应降低优先级。候选 3 虽有 0.938 的覆盖率，但未通过复核，不能仅凭覆盖率接受。
• 最终确认应核对样品可能元素、辐射源或波长、独有峰、数据库编号、空间群和下载的 CIF 结构。

点击候选只会切换预览中的理论峰与晶体结构，不会改变排名或科学结论。

查看 PDF 第 16 页

• 强度系数只改变显示贡献，独立或全局峰宽控制峰形展宽，两者都不能直接给出物相含量。
• 模拟谱用于验证峰位、HKL 和相间重叠，不替代实验数据的物相鉴定。
• 蓝色 P1 对应 Li2CO3，暗红色 P2 对应 NaCl。峰位匹配支持候选相存在，但显示曲线已归一化，强度差异不能直接换算含量。
• 择优取向、晶粒尺寸或应变、背景及仪器条件都会改变强度。定量评价应结合精修。

查看 PDF 第 17 页

• 初始结构为用户提供的 Mn2O3.cif（80 个原子）。晶格和体积变化均小于 0.03%，说明晶胞调整幅度很小。
• 实验与计算主峰总体重合，差值曲线大部分围绕零线。个别强峰仍有局部残差，应检查峰形、背景和择优取向。
• 微小晶胞变化不能证明精修已被接受。必须同时记录 Rwp、Rp、χ²，并确认参数无异常相关或超出物理范围。

查看 PDF 第 18 页

差值在若干强峰位置出现尖锐残差，仍需复核模型、峰形、背景或择优取向。

验收检查表

• 空间群、晶胞设置和相的 CIF 身份一致；“—”不能解释为零变化。
• 主峰峰位和强度趋势一致，差值曲线无连续结构或强峰残差。
• Rwp、Rp、χ² 与同类数据和同一精修策略可比，不能以单一低 Rwp 判定成功。
• 晶格、峰形、背景、择优取向和原子参数均在物理合理范围。
• 定量分析时相含量总和接近 100%，并报告不确定度、约束和未建模相。

查看 PDF 第 19 页

干将用于组织 XRD 数据处理、物相检索、候选复核、PDF 卡匹配、理论谱模拟和结构精修。软件输出辅助形成材料分析证据链，最终结论仍需结合样品来源与人工复核。

标准工作流程

1. 准备 XRD / CIF。
2. 创建任务。
3. 检查候选。
4. 执行复核。
5. 必要时精修。
6. 导出与归档。

查看 PDF 第 20 页

确认当前登录账号正确，并明确充值金额、支付方式和开票需求。余额、套餐、价格和支付渠道以软件当时显示为准。

1. 进入账户页面。点击主界面的账号或头像入口，打开账户、额度或充值页面。
2. 选择充值项目。选择可用套餐或金额，核对币种、有效期、可用范围和退款规则。
3. 确认订单。核对账号、项目、金额和支付渠道后提交，不要在聊天或截图中暴露支付信息。
4. 完成支付。按页面提示完成支付，等待订单状态变为成功，不要重复提交未确认的订单。
5. 刷新额度。返回账户页面刷新余额或额度；如未到账，先查询订单记录和支付状态。
6. 保存凭证。按单位要求保存订单号、支付凭证和发票信息。

查看 PDF 第 21 页

打开配置页面

1. 点击主界面左下角齿轮形“设置”。
2. 在左侧选择“大模型”。
3. 在右侧“自定义模型”区域点击“添加模型”。

查看 PDF 第 22 页

必填项示意

查看 PDF 第 23 页

1. 保存配置。点击弹窗右下角“保存”，在“已保存模型”确认配置名称出现；未更新时点击刷新。
2. 返回聊天。关闭设置窗口，点击输入框右下方、发送按钮附近的当前模型名称。
3. 选择模型。在“自定义”分组选择新配置；同名时注意与“系统”分组区分。
4. 确认切换。确认输入框下方显示目标配置名称，再发送请求。
5. 发起验证。新建普通聊天，输入“请只回复：配置成功”，观察是否正常返回。

示例配置（不可直接调用）

若页面提示“流程自动选模型”，首次验证应改用允许手动选模的普通聊天任务。

查看 PDF 第 24 页

能力验证边界

• 基础文本验证通过后，再分别验证工具调用、图片理解或其他所需能力。
• 普通文本返回成功不能证明所有高级能力均受支持。
• 修改高级参数前保留原值，出现参数错误时先移除非必需字段。

查看 PDF 第 25 页

查看 PDF 第 26 页

方法一：使用账号提供的系统模型

1. 检查登录状态。显示“去登录”时先完成登录，已登录时确认网络正常。
2. 出现“重新发现”时点击重试。仍无法获取时退出账号并重新登录；若无法连接后端服务，重启应用后再试。
3. 返回普通聊天，点击输入框下方的模型名称，在“模型选择 → 系统”中选择可用模型。
4. 发送一条简短消息，正常收到回复后即可继续使用。

方法二：配置自己的模型服务（可选）

1. 进入“设置 → 大模型”，点击“添加模型”。
2. 填写配置名称、模型名称、API Key 和 Base URL，其余参数按服务方要求填写并保存。
3. 返回聊天，在“模型选择 → 自定义”中选择该配置并发送消息验证。

查看 PDF 第 27 页

这是正常的环境准备流程。应用会检查运行所需依赖，并在缺失时启动安装。

1. 查看环境准备页面的安装状态，确认正在处理的依赖并等待完成；出现终端窗口时按提示操作。
2. 仅在系统要求授权时输入电脑管理员密码，不是干将账号密码。终端输入时可能不显示字符，输入完成后按回车。
3. 返回应用，进入“设置 → 环境变量”，点击“重新检测”。
4. 确认必选依赖均已识别，可选依赖根据实际功能需求安装。

安装失败时

• 在首次准备页面展开“查看详细输出”，记录具体失败原因。
• 进入“设置 → 环境变量”，对缺失且支持安装的依赖点击“安装”重试。
• 若提示未找到终端，复制界面提供的命令并在系统终端中执行，完成后再次点击“重新检测”。

查看 PDF 第 28 页

1. 使用项目方提供的下载入口，选择与当前操作系统及处理器架构一致的安装包。
2. 打开浏览器下载面板，查看文件旁的完整提示。

查看 PDF 第 29 页

1. 确认邮箱或手机号填写正确，再点击验证码旁的“获取”。
2. 区分发送失败与未收到：若提示发送失败，检查网络并记录报错；若提示发送成功，检查邮箱、短信、垃圾邮件或拦截记录。
3. 发送成功后，“获取”按钮显示 60 秒倒计时，期间无需重复点击。
4. 关闭并重新打开干将，重新输入账号后再次获取验证码。

查看 PDF 第 30 页

请一次性提供以下信息，以便技术人员复现并定位问题。