deploy webservice static-file routing for docsite folder URLs, per-instance step-cache db, and constant-height panel title bars.

This commit is contained in:
2026-08-27 14:51:37 +08:00
parent 1fc510af5e
commit 2a98ae7556
1468 changed files with 182837 additions and 18888 deletions
@@ -92,7 +92,7 @@
<li>Assistant Model
<ul>
<li><a class="xref" href="../../api/Hi.MachiningProcs.MachiningProject.html">MachiningProject</a></li>
<li><a class="xref" href="../../api/Hi.HiNcKits.UserService.html">UserService</a></li>
<li><a class="xref" href="../../sample/Sample.Common.UserService.html">UserService</a></li>
</ul>
</li>
</ul>
@@ -171,7 +171,8 @@ The boxes are draggable for re-order.
</li>
<li>Title Label
<ul>
<li>Apply <a class="xref" href="../../api/Hi.SessionCommands.ITitleCommand.html#Hi_SessionCommands_ITitleCommand_GetCommandTitle_">GetCommandTitle</a> if the command is inherited from <a class="xref" href="../../api/Hi.SessionCommands.ITitleCommand.html">ITitleCommand</a>; otherwise, show the class name.</li>
<li>Apply <a class="xref" href="../../api/Hi.SessionCommands.ITitleCommand.html#Hi_SessionCommands_ITitleCommand_GetCommandTitle_">GetCommandTitle</a> if the command is inherited from <a class="xref" href="../../api/Hi.SessionCommands.ITitleCommand.html">ITitleCommand</a>; otherwise, show its localized display name (the <code>DisplayName</code> attribute), never the class name.</li>
<li>The label always leads with the command's NAME. A title the user typed is appended as <code>Name [title]</code>, it does not replace the name — a row has to say what it is.</li>
</ul>
</li>
</ul>
@@ -2,9 +2,9 @@
<html>
<head>
<meta charset="utf-8">
<title>NcFileCommand Panel | HiAPI-C# 2025 </title>
<title>NcFileCommand Panel (Program File) | HiAPI-C# 2025 </title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="title" content="NcFileCommand Panel | HiAPI-C# 2025 ">
<meta name="title" content="NcFileCommand Panel (Program File) | HiAPI-C# 2025 ">
<link rel="icon" href="../../img/HiAPI.favicon.ico">
@@ -85,12 +85,19 @@
</div>
<article data-uid="">
<h1 id="ncfilecommand-panel">NcFileCommand Panel</h1>
<h1 id="ncfilecommand-panel-program-file">NcFileCommand Panel (Program File)</h1>
<p>The key model is <a class="xref" href="../../api/Hi.SessionCommands.NcFileCommand.html">NcFileCommand</a>.</p>
<ul>
<li>Other Model: string BaseDirectory.</li>
</ul>
<div class="NOTE">
<h5>Note</h5>
<p>The GUI labels this command &ldquo;Program File&rdquo;: it plays NC, CL (CLSF) and CSV
files — the runner is picked by
<a class="xref" href="../../api/Hi.SessionCommands.NcFileCommand.html#Hi_SessionCommands_NcFileCommand_NcKind">NcKind</a>
(<a class="xref" href="../../api/Hi.MachiningProcs.NcKind.html#Hi_MachiningProcs_NcKind_Auto">Auto</a> detects by file extension).</p>
</div>
<h2 id="layout">Layout</h2>
<ul>
<li>NcFileCommand Panel
@@ -148,7 +155,7 @@ Set NC Code TextArea height resizable.</p>
<h3 id="web-page-application-source-code-path">Web Page Application Source Code Path</h3>
<p>HiNC-2025-webservice (Quasar CLI SPA):</p>
<ul>
<li><code>wwwroot-src/src/components/mission/NcFileCommandPanel.vue</code> — NC File text field + Browse (prompt-based per <code>apply-prompt-instead-of-local-file-upload-browser</code>) + <code>&lt;q-banner&gt;</code> live file-info banner + Preview dialog. File-loading is server-side; the browser never uploads file bytes.</li>
<li><code>wwwroot-src/src/components/mission/NcFileCommandPanel.vue</code> — Program File text field + Browse (prompt-based per <code>apply-prompt-instead-of-local-file-upload-browser</code>) + &ldquo;Play As&rdquo; NC-kind select (Auto / Brand NC / CL / CSV) + <code>&lt;q-banner&gt;</code> live file-info banner + Preview dialog. File-loading is server-side; the browser never uploads file bytes.</li>
<li><code>wwwroot-src/src/api/mission.ts</code> — typed wrapper over the NcFile-related endpoints on <code>MissionController.cs</code>.</li>
<li><code>Missions/MissionController.cs</code> — REST endpoints for <code>NcFile</code> property updates and file-info queries.</li>
</ul>
@@ -96,7 +96,7 @@
<li>Assistant Model
<ul>
<li><a class="xref" href="../../api/Hi.MachiningProcs.MachiningProject.html">MachiningProject</a></li>
<li><a class="xref" href="../../api/Hi.HiNcKits.UserService.html">UserService</a></li>
<li><a class="xref" href="../../sample/Sample.Common.UserService.html">UserService</a></li>
</ul>
</li>
</ul>
@@ -120,7 +120,7 @@
</ul>
</li>
<li>Output Shot Files Section
Visible if <a class="xref" href="../../api/Hi.HiNcKits.UserService.html#Hi_HiNcKits_UserService_EnablePhysics">EnablePhysics</a> is true.
Visible if <a class="xref" href="../../sample/Sample.Common.UserService.html#Sample_Common_UserService_EnablePhysics">EnablePhysics</a> is true.
<ul>
<li>Enable Write Shot Files CheckBox
<ul>
@@ -142,7 +142,7 @@ Visible if <a class="xref" href="../../api/Hi.HiNcKits.UserService.html#Hi_HiNcK
</ul>
</li>
<li>Optimization Files Section
Visible if <a class="xref" href="../../api/Hi.HiNcKits.UserService.html#Hi_HiNcKits_UserService_EnablePhysics">EnablePhysics</a> is true.
Visible if <a class="xref" href="../../sample/Sample.Common.UserService.html#Sample_Common_UserService_EnablePhysics">EnablePhysics</a> is true.
<ul>
<li>Enable Optimize To Files CheckBox
<ul>
@@ -157,6 +157,21 @@ Visible if <a class="xref" href="../../api/Hi.HiNcKits.UserService.html#Hi_HiNcK
</li>
</ul>
</li>
<li>CL → NC Writeback Section
<ul>
<li>Enable Convert CL To NC Files CheckBox
<ul>
<li>The model is <a class="xref" href="../../api/Hi.SessionCommands.PostExecutionCommand.html#Hi_SessionCommands_PostExecutionCommand_EnableConvertClToNcFiles">EnableConvertClToNcFiles</a>.</li>
</ul>
</li>
<li>NC Output Template Text Field
<ul>
<li>The model is <a class="xref" href="../../api/Hi.SessionCommands.PostExecutionCommand.html#Hi_SessionCommands_PostExecutionCommand_ClToNcFileTemplate">ClToNcFileTemplate</a>.</li>
<li>Default value: &ldquo;Output/[NcName].nc&rdquo;</li>
</ul>
</li>
</ul>
</li>
<li>Geometry Difference Section
<ul>
<li>Enable Geom Diff CheckBox
@@ -174,6 +189,15 @@ Visible if <a class="xref" href="../../api/Hi.HiNcKits.UserService.html#Hi_HiNcK
</ul>
</li>
</ul>
<div class="NOTE">
<h5>Note</h5>
<p>Meshed-geometry output is no longer a Post-Execution section: a geometry
snapshot can be taken at any spot of the mission, unlike the run-derived
file outputs above. Use the standalone Record Meshed Geometry
(<a class="xref" href="../../api/Hi.SessionCommands.RecordMeshedGeomCommand.html">RecordMeshedGeomCommand</a>) or Export Meshed
Geometry (<a class="xref" href="../../api/Hi.SessionCommands.ExportMeshedGeomToStlCommand.html">ExportMeshedGeomToStlCommand</a>) commands
instead.</p>
</div>
<h2 id="source-code-path">Source Code Path</h2>
<p>See <a href="../index.html">this page</a> for git repository.</p>
<h3 id="wpf-application-source-code-path">WPF Application Source Code Path</h3>
@@ -183,7 +207,7 @@ Visible if <a class="xref" href="../../api/Hi.HiNcKits.UserService.html#Hi_HiNcK
<h3 id="web-page-application-source-code-path">Web Page Application Source Code Path</h3>
<p>HiNC-2025-webservice (Quasar CLI SPA):</p>
<ul>
<li><code>wwwroot-src/src/components/mission/PostExecutionCommandPanel.vue</code> — five cards: Step Files / Shot Files / Optimization / Geom Diff / Runtime Geom. Shot Files and Optimization cards are gated on <code>appState.isShowPhysicsOptions</code> (matches legacy). GeomDiff is embedded inline because it is a property on <code>PostExecutionCommand</code> rather than a standalone <code>ISessionCommand</code>.</li>
<li><code>wwwroot-src/src/components/mission/PostExecutionCommandPanel.vue</code> — five cards: Step Files / Shot Files / Optimization / CL → NC Writeback / Geom Diff. Shot Files and Optimization cards are gated on <code>appState.isShowPhysicsOptions</code> (matches legacy). GeomDiff is embedded inline because it is a property on <code>PostExecutionCommand</code> rather than a standalone <code>ISessionCommand</code>.</li>
<li><code>wwwroot-src/src/api/mission.ts</code> — typed wrapper; uses <code>commands/{path}/postexecution/*</code> endpoints including <code>enable-geom-diff</code> + <code>geom-diff-detect-radius-mm</code>.</li>
<li><code>Missions/MissionController.cs</code> — REST endpoints for PostExecution per-property PUTs.</li>
</ul>
@@ -96,7 +96,7 @@
<li>Assistant Model
<ul>
<li><a class="xref" href="../../api/Hi.MachiningProcs.MachiningProject.html">MachiningProject</a></li>
<li><a class="xref" href="../../api/Hi.HiNcKits.UserService.html">UserService</a></li>
<li><a class="xref" href="../../sample/Sample.Common.UserService.html">UserService</a></li>
</ul>
</li>
</ul>
@@ -181,7 +181,7 @@ If <a class="xref" href="../../api/Hi.SessionCommands.PreSettingCommand.html#Hi_
<h3 id="web-page-application-source-code-path">Web Page Application Source Code Path</h3>
<p>HiNC-2025-webservice (Quasar CLI SPA):</p>
<ul>
<li><code>wwwroot-src/src/components/mission/PreSettingCommandPanel.vue</code> — Runtime Geometry + Machining Resolution + Motion Resolution type select (with embedded Fixed sub-fields: Linear + Rotary) + Collision / Pause / Physics checkboxes. <code>MachiningMotionResolution</code> is embedded inline because it is a property on <code>PreSettingCommand</code> rather than a standalone <code>ISessionCommand</code>.</li>
<li><code>wwwroot-src/src/components/mission/PreSettingCommandPanel.vue</code> — Meshed Geometry + Machining Resolution + Motion Resolution type select (with embedded Fixed sub-fields: Linear + Rotary) + Collision / Pause / Physics checkboxes. <code>MachiningMotionResolution</code> is embedded inline because it is a property on <code>PreSettingCommand</code> rather than a standalone <code>ISessionCommand</code>.</li>
<li><code>wwwroot-src/src/api/mission.ts</code> — typed wrapper; uses <code>commands/{path}/presetting/*</code> endpoints including <code>machining-motion-resolution-type</code>, <code>fixed-linear-resolution-mm</code>, <code>fixed-rotary-resolution-deg</code>.</li>
<li><code>Missions/MissionController.cs</code> — REST endpoints for PreSetting per-property PUTs.</li>
</ul>
@@ -1,246 +0,0 @@
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Classic Session Command Panel | HiAPI-C# 2025 </title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="title" content="Classic Session Command Panel | HiAPI-C# 2025 ">
<link rel="icon" href="../../img/HiAPI.favicon.ico">
<link rel="stylesheet" href="../../public/docfx.min.css">
<link rel="stylesheet" href="../../public/main.css">
<meta name="docfx:navrel" content="../../toc.html">
<meta name="docfx:tocrel" content="../toc.html">
<meta name="docfx:rel" content="../../">
<meta name="loc:inThisArticle" content="In this article">
<meta name="loc:searchResultsCount" content="{count} results for &quot;{query}&quot;">
<meta name="loc:searchNoResults" content="No results for &quot;{query}&quot;">
<meta name="loc:tocFilter" content="Filter by title">
<meta name="loc:nextArticle" content="Next">
<meta name="loc:prevArticle" content="Previous">
<meta name="loc:themeLight" content="Light">
<meta name="loc:themeDark" content="Dark">
<meta name="loc:themeAuto" content="Auto">
<meta name="loc:changeTheme" content="Change theme">
<meta name="loc:copy" content="Copy">
<meta name="loc:downloadPdf" content="Download PDF">
<script type="module" src="./../../public/docfx.min.js"></script>
<script>
const theme = localStorage.getItem('theme') || 'auto'
document.documentElement.setAttribute('data-bs-theme', theme === 'auto' ? (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light') : theme)
</script>
</head>
<body class="tex2jax_ignore" data-layout="" data-yaml-mime="">
<header class="bg-body border-bottom">
<nav id="autocollapse" class="navbar navbar-expand-md" role="navigation">
<div class="container-xxl flex-nowrap">
<a class="navbar-brand" href="../../index.html">
<img id="logo" class="svg" src="../../img/HiAPI.logo.png" alt="">
</a>
<button class="btn btn-lg d-md-none border-0" type="button" data-bs-toggle="collapse" data-bs-target="#navpanel" aria-controls="navpanel" aria-expanded="false" aria-label="Toggle navigation">
<i class="bi bi-three-dots"></i>
</button>
<div class="collapse navbar-collapse" id="navpanel">
<div id="navbar">
<form class="search" role="search" id="search">
<i class="bi bi-search"></i>
<input class="form-control" id="search-query" type="search" disabled placeholder="Search" autocomplete="off" aria-label="Search">
</form>
</div>
</div>
</div>
</nav>
</header>
<main class="container-xxl">
<div class="toc-offcanvas">
<div class="offcanvas-md offcanvas-start" tabindex="-1" id="tocOffcanvas" aria-labelledby="tocOffcanvasLabel">
<div class="offcanvas-header">
<h5 class="offcanvas-title" id="tocOffcanvasLabel">Table of Contents</h5>
<button type="button" class="btn-close" data-bs-dismiss="offcanvas" data-bs-target="#tocOffcanvas" aria-label="Close"></button>
</div>
<div class="offcanvas-body">
<nav class="toc" id="toc"></nav>
</div>
</div>
</div>
<div class="content">
<div class="actionbar">
<button class="btn btn-lg border-0 d-md-none" type="button" data-bs-toggle="offcanvas" data-bs-target="#tocOffcanvas" aria-controls="tocOffcanvas" aria-expanded="false" aria-label="Show table of contents">
<i class="bi bi-list"></i>
</button>
<nav id="breadcrumb"></nav>
</div>
<article data-uid="">
<h1 id="classic-session-command-panel">Classic Session Command Panel</h1>
<p>The key model is <a class="xref" href="../../api/Hi.SessionCommands.SimpleSessionCommand.html">SimpleSessionCommand</a>.</p>
<h2 id="layout">Layout</h2>
<ul>
<li>Head Line
<ul>
<li><a href="../widget/object-management-menu-button.html">Object Management Menu Button</a>
<ul>
<li>file extension is ShellCommand</li>
<li>The pointed Editor Panel is Session Management Panel</li>
</ul>
</li>
</ul>
</li>
<li>Title Label</li>
<li>Session Management Panel
<ul>
<li>NC/Command List Tab
<ul>
<li>Shell Commands ListBox
<ul>
<li>The model is <a class="xref" href="../../api/Hi.SessionCommands.SimpleSessionCommand.html#Hi_SessionCommands_SimpleSessionCommand_NcCommandList">NcCommandList</a>.</li>
<li>Support add, remove, reorder commands.</li>
<li>The items are multi-selectable.</li>
<li>Support file drag from the external application (such as file explorer), files drag into the Shell Commands List is equivalent to create <a class="xref" href="../../api/Hi.SessionCommands.NcFileCommand.html">NcFileCommand</a>s.</li>
</ul>
<div class="TIP">
<h5>Tip</h5>
<p>don't use file filter to the drag behavior</p>
</div>
<ul>
<li>On each NC File Command:
<ul>
<li>Only one line for each entry.</li>
<li>Batch Selection CheckBox with &lsquo;Select&rsquo; Text Label</li>
<li><a href="NcFileCommand-panel.html">NC File Command Panel</a>.</li>
</ul>
</li>
<li>The horizontal auto scroll bar is required.</li>
</ul>
</li>
</ul>
</li>
<li>Output Tab
<ul>
<li>Output Shot Files Tab
<ul>
<li>Enable Write Shot Files CheckBox
<ul>
<li>The model is <a class="xref" href="../../api/Hi.SessionCommands.SimpleSessionCommand.html#Hi_SessionCommands_SimpleSessionCommand_EnableWriteShotFiles">EnableWriteShotFiles</a>.</li>
</ul>
</li>
<li>Shot File Template Text Field
<ul>
<li>The model is <a class="xref" href="../../api/Hi.SessionCommands.SimpleSessionCommand.html#Hi_SessionCommands_SimpleSessionCommand_ShotFileTemplate">ShotFileTemplate</a>.</li>
<li>Default value: <code>Output/[NcName].shot.csv</code></li>
</ul>
</li>
<li>Shot File Time Resolution (ms) Number Field
<ul>
<li>The model is <a class="xref" href="../../api/Hi.SessionCommands.SimpleSessionCommand.html#Hi_SessionCommands_SimpleSessionCommand_ShotFileTimeResolution_ms">ShotFileTimeResolution_ms</a>.</li>
<li>Default value: 1</li>
</ul>
</li>
</ul>
</li>
<li>Output Step Files Tab
<ul>
<li>Enable Write Step Files CheckBox
<ul>
<li>The model is <a class="xref" href="../../api/Hi.SessionCommands.SimpleSessionCommand.html#Hi_SessionCommands_SimpleSessionCommand_EnableWriteStepFiles">EnableWriteStepFiles</a>.</li>
</ul>
</li>
<li>Step File Template Label</li>
<li>Step File Template Text Field
<ul>
<li>The model is <a class="xref" href="../../api/Hi.SessionCommands.SimpleSessionCommand.html#Hi_SessionCommands_SimpleSessionCommand_StepFileTemplate">StepFileTemplate</a>.</li>
<li>Default value: &ldquo;Output/[NcName].step.csv&rdquo;</li>
</ul>
</li>
<li>Apply one line layout to the label and the text field.</li>
</ul>
</li>
<li>Optimization Files Tab
<ul>
<li>Enable Optimize To Files CheckBox
<ul>
<li>The model is <a class="xref" href="../../api/Hi.SessionCommands.SimpleSessionCommand.html#Hi_SessionCommands_SimpleSessionCommand_EnableOptimizeToFiles">EnableOptimizeToFiles</a>.</li>
</ul>
</li>
<li>Optimization File Template Text Field
<ul>
<li>The model is <a class="xref" href="../../api/Hi.SessionCommands.SimpleSessionCommand.html#Hi_SessionCommands_SimpleSessionCommand_OptimizationFileTemplate">OptimizationFileTemplate</a>.</li>
<li>Default value: &ldquo;Output/Opt-[NcName]&rdquo;</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li>Geometry Difference Tab
<ul>
<li>Enable Geom Diff CheckBox
<ul>
<li>The model is <a class="xref" href="../../api/Hi.SessionCommands.SimpleSessionCommand.html#Hi_SessionCommands_SimpleSessionCommand_EnableGeomDiff">EnableGeomDiff</a>.</li>
</ul>
</li>
<li>Geom Diff Detect Radius (mm) Number Field
<ul>
<li>One Line layout</li>
<li>The model is <a class="xref" href="../../api/Hi.SessionCommands.SimpleSessionCommand.html#Hi_SessionCommands_SimpleSessionCommand_GeomDiffDetectRadius_mm">GeomDiffDetectRadius_mm</a>.</li>
<li>Default value: 1</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
<div class="TIP">
<h5>Tip</h5>
<p>Use Disabled Style if the section key checkbox is not checked.</p>
</div>
<div class="TIP">
<h5>Tip</h5>
<p>The file templates support placeholder <code>[NcName]</code> which will be replaced with actual NC program name.</p>
</div>
<h2 id="wpf-application-source-code-path">WPF Application Source Code Path</h2>
<ul>
<li>Mission/SimpleSessionCommandPanel</li>
</ul>
<p>see <a href="../index.html">this page</a> for git repository.</p>
</article>
<div class="contribution d-print-none">
</div>
<div class="next-article d-print-none border-top" id="nextArticle"></div>
</div>
<div class="affix">
<nav id="affix"></nav>
</div>
</main>
<div class="container-xxl search-results" id="search-results"></div>
<footer class="border-top text-secondary">
<div class="container-xxl">
<div class="flex-fill">
<span> Copyright © 2025 <a href='https://superhightech.com.tw'>Tech Coordinate</a>. All rights reserved. <a href='https://superhightech.com.tw'>超級高科技股份有限公司</a> © 2025 版權所有 </span>
</div>
</div>
</footer>
</body>
</html>
@@ -94,7 +94,7 @@
<li><strong>Supporting</strong>:
<ul>
<li><a class="xref" href="../../api/Hi.MachiningProcs.MachiningProject.html">MachiningProject</a></li>
<li><a class="xref" href="../../api/Hi.HiNcKits.UserService.html">UserService</a></li>
<li><a class="xref" href="../../sample/Sample.Common.UserService.html">UserService</a></li>
</ul>
</li>
</ul>