HiNC-Deploy/HiNC-2025-win-desktop-Deploy
Archived
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
iamboss
2026-08-27 14:51:37 +08:00
parent 1fc510af5e
commit 2a98ae7556
1468 changed files with 182837 additions and 18888 deletions
Download Patch File Download Diff File Expand all files Collapse all files
App/wwwroot/HiAPI-docsite/api/Hi.NcParsers.Dependencys.SystemWired.html
+95 -6
View File
@@ -99,14 +99,14 @@ Classes
<dd><p>Per-session monotonically-increasing file index allocator. Holds the
counter as a private field; <a class="xref" href="Hi.NcParsers.Dependencys.SystemWired.FileIndexCounterDependency.html#Hi_NcParsers_Dependencys_SystemWired_FileIndexCounterDependency_Allocate">Allocate()</a> returns the next
unused value and increments. <a class="xref" href="Hi.NcParsers.Dependencys.SystemWired.FileIndexCounterDependency.html#Hi_NcParsers_Dependencys_SystemWired_FileIndexCounterDependency_OnSessionReset">OnSessionReset()</a> rewinds to 0 —
the owning <a class="xref" href="Hi.NcParsers.SoftNcRunner.html#Hi_NcParsers_SoftNcRunner_RunControlLines_System_String_System_Collections_Generic_IEnumerable_System_String__Hi_MachiningProcs_MachiningSession_Hi_MachiningProcs_SessionProgress_System_Threading_CancellationToken_">RunControlLines(string, IEnumerable&lt;string&gt;, MachiningSession, SessionProgress, CancellationToken)</a> invokes it via
the owning <a class="xref" href="Hi.NcParsers.SoftNcRunner.html#Hi_NcParsers_SoftNcRunner_RunNcLines_System_String_System_Collections_Generic_IEnumerable_System_String__Hi_MachiningProcs_MachiningSession_Hi_MachiningProcs_StepDiagnosticProgress_Hi_NcParsers_NcDiagnosticProgress_System_Threading_CancellationToken_">RunNcLines(string, IEnumerable&lt;string&gt;, MachiningSession, StepDiagnosticProgress, NcDiagnosticProgress, CancellationToken)</a> invokes it via
the <a class="xref" href="Hi.NcParsers.ISessionResettable.html">ISessionResettable</a> sweep on the same edge that
initializes a fresh <a class="xref" href="Hi.MachiningProcs.NcRunnerSessionState.html">NcRunnerSessionState</a>,
so a controller power-reset clears both the syntax-piece pipeline and
this counter in lock-step.</p>
<p>
Two consumers share one allocator:
<ul><li><a class="xref" href="Hi.NcParsers.SoftNcRunner.html#Hi_NcParsers_SoftNcRunner_RunControlLines_System_String_System_Collections_Generic_IEnumerable_System_String__Hi_MachiningProcs_MachiningSession_Hi_MachiningProcs_SessionProgress_System_Threading_CancellationToken_">RunControlLines(string, IEnumerable&lt;string&gt;, MachiningSession, SessionProgress, CancellationToken)</a> allocates one
<ul><li><a class="xref" href="Hi.NcParsers.SoftNcRunner.html#Hi_NcParsers_SoftNcRunner_RunNcLines_System_String_System_Collections_Generic_IEnumerable_System_String__Hi_MachiningProcs_MachiningSession_Hi_MachiningProcs_StepDiagnosticProgress_Hi_NcParsers_NcDiagnosticProgress_System_Threading_CancellationToken_">RunNcLines(string, IEnumerable&lt;string&gt;, MachiningSession, StepDiagnosticProgress, NcDiagnosticProgress, CancellationToken)</a> allocates one
index per top-level NC file that streams through the runner.</li><li><a class="xref" href="Hi.NcParsers.EvaluationSyntaxs.SubProgramCallSyntax.html">SubProgramCallSyntax</a> allocates a
fresh index for each inlined subprogram invocation, including
each <code>L</code> repetition — distinct indices ensure
@@ -128,12 +128,26 @@ that need broad host access (machining equipment, session, tool house,
time mapping, …). The built-in CSV pipeline does not consume this
dependency; it uses the narrower
<a class="xref" href="Hi.NcParsers.Dependencys.SystemWired.StepPropertyAccessDictionaryDependency.html">StepPropertyAccessDictionaryDependency</a> instead.</p>
</dd>
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.NcParsers.Dependencys.SystemWired.MappingAnchorDependency.html">MappingAnchorDependency</a></dt>
<dd><p>Narrow NC-pipeline dependency that lets a CSV semantic convert an absolute
controller instant to a run-relative timecode against the project mapping
anchor, without reaching the whole <a class="xref" href="Hi.MachiningSteps.IMachiningService.html">IMachiningService</a>
surface (cf. <a class="xref" href="Hi.NcParsers.Dependencys.SystemWired.MachiningServiceDependency.html">MachiningServiceDependency</a>). The host wires
<a class="xref" href="Hi.NcParsers.Dependencys.SystemWired.MappingAnchorDependency.html#Hi_NcParsers_Dependencys_SystemWired_MappingAnchorDependency_ToTimecodeProvider">ToTimecodeProvider</a> to <code>TimeMapping.ToTimecode</code>, whose
set-once <code>??=</code> seeds (lazily builds) the anchor on first use.</p>
<p>
Runtime-only: the provider is wired per host and not persisted; serialization
writes only the empty element so the dependency survives an XML round-trip.
</p>
</dd>
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.NcParsers.Dependencys.SystemWired.NcKinematicsDependency.html">NcKinematicsDependency</a></dt>
<dd><p>Provides <a class="xref" href="Hi.Numerical.Xyzabc.IMachineKinematics.html">IMachineKinematics</a> as an <a class="xref" href="Hi.NcParsers.Dependencys.INcDependency.html">INcDependency</a>
for <a class="xref" href="Hi.NcParsers.SoftNcRunner.html">SoftNcRunner</a>.<a class="xref" href="Hi.NcParsers.SoftNcRunner.html#Hi_NcParsers_SoftNcRunner_NcDependencyList">NcDependencyList</a>.</p>
for <a class="xref" href="Hi.NcParsers.SoftNcRunner.html">SoftNcRunner</a>.<a class="xref" href="Hi.NcParsers.SoftNcRunner.html#Hi_NcParsers_SoftNcRunner_PipelineNcDependencyList">PipelineNcDependencyList</a>.</p>
<p>
The actual kinematics instance is resolved at runtime via
<a class="xref" href="Hi.NcParsers.Dependencys.SystemWired.NcKinematicsDependency.html#Hi_NcParsers_Dependencys_SystemWired_NcKinematicsDependency_KinematicsProvider">KinematicsProvider</a>. This supports scenarios where
@@ -146,6 +160,32 @@ Consumed by <a class="xref" href="Hi.NcParsers.LogicSyntaxs.G53p1RotaryPositionS
<a class="xref" href="Hi.NcParsers.Semantics.McLinearMotionSemantic.html">McLinearMotionSemantic</a> via
<code>dependencyList.OfType&lt;IMachineKinematics&gt;()</code>.
</p>
</dd>
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.NcParsers.Dependencys.SystemWired.NcLineSourceDependency.html">NcLineSourceDependency</a></dt>
<dd><p>In-memory line source for NC &ldquo;files&rdquo; with no disk backing — inline
NC-code plays whose <a class="xref" href="Hi.NcParsers.Sentence.html#Hi_NcParsers_Sentence_FilePath">FilePath</a> is a
command-title pseudo-path (e.g. <code>&ldquo;NC Code&rdquo;</code>). Control-flow
re-segmentation (WHILE reverse jump, backward GOTO, <code>M99 P{seq}</code>
caller re-entry — every <a class="xref" href="Hi.NcParsers.EvaluationSyntaxs.LabelScanUtil.html">LabelScanUtil</a>
scan) re-reads the host file by path; an inline play's pseudo-path never
exists on disk, so without this source those jumps fall through (loops
that do not loop) or error with a <code>*FileNotFound</code> diagnostic.
<a class="xref" href="Hi.MachiningProcs.MachiningSession.html#Hi_MachiningProcs_MachiningSession_RunNc_System_String_System_String_">RunNc(string, string)</a> registers the play's
raw lines under its pseudo-path before running;
<a class="xref" href="Hi.NcParsers.EvaluationSyntaxs.LabelScanUtil.html">LabelScanUtil</a> consults this source first
and only falls back to disk.</p>
<p>
Entries persist for the runner's lifetime, the latest registration of a
path winning — deliberately NOT <a class="xref" href="Hi.NcParsers.ISessionResettable.html">ISessionResettable</a>: the
session-reset sweep runs inside the first
<a class="xref" href="Hi.NcParsers.SoftNcRunner.html#Hi_NcParsers_SoftNcRunner_RunNcLines_System_String_System_Collections_Generic_IEnumerable_System_String__Hi_MachiningProcs_MachiningSession_Hi_MachiningProcs_StepDiagnosticProgress_Hi_NcParsers_NcDiagnosticProgress_System_Threading_CancellationToken_">RunNcLines(string, IEnumerable&lt;string&gt;, MachiningSession, StepDiagnosticProgress, NcDiagnosticProgress, CancellationToken)</a> of a fresh session, which would
wipe the registration made moments earlier for that very play. A
registered pseudo-path shadows an identically-named disk file during
re-segmentation, so inline command titles should not mirror real
project-relative NC paths.
</p>
</dd>
</dl>
<dl class="jumplist">
@@ -177,12 +217,52 @@ subprogram file and re-using the host runner's segmenter so the inlined
blocks are split with the same rules).</p>
<p>
The actual segmenter is resolved at runtime via
<span class="xref">Hi.NcParsers.Dependencys.SystemWired.SegmenterDependency.SegmenterProvider</span>; <a class="xref" href="Hi.NcParsers.SoftNcRunner.html#Hi_NcParsers_SoftNcRunner_RunControlLines_System_String_System_Collections_Generic_IEnumerable_System_String__Hi_MachiningProcs_MachiningSession_Hi_MachiningProcs_SessionProgress_System_Threading_CancellationToken_">RunControlLines(string, IEnumerable&lt;string&gt;, MachiningSession, SessionProgress, CancellationToken)</a>
<span class="xref">Hi.NcParsers.Dependencys.SystemWired.SegmenterDependency.SegmenterProvider</span>; <a class="xref" href="Hi.NcParsers.SoftNcRunner.html#Hi_NcParsers_SoftNcRunner_RunNcLines_System_String_System_Collections_Generic_IEnumerable_System_String__Hi_MachiningProcs_MachiningSession_Hi_MachiningProcs_StepDiagnosticProgress_Hi_NcParsers_NcDiagnosticProgress_System_Threading_CancellationToken_">RunNcLines(string, IEnumerable&lt;string&gt;, MachiningSession, StepDiagnosticProgress, NcDiagnosticProgress, CancellationToken)</a>
wires the provider to its own <a class="xref" href="Hi.NcParsers.SoftNcRunner.html#Hi_NcParsers_SoftNcRunner_Segmenter">Segmenter</a> at the
start of each session run, so this dependency can sit in
<a class="xref" href="Hi.NcParsers.SoftNcRunner.html#Hi_NcParsers_SoftNcRunner_NcDependencyList">NcDependencyList</a> without participating in XML
<a class="xref" href="Hi.NcParsers.SoftNcRunner.html#Hi_NcParsers_SoftNcRunner_PipelineNcDependencyList">PipelineNcDependencyList</a> without participating in XML
serialization (see <a class="xref" href="Hi.NcParsers.Dependencys.SystemWired.SegmenterDependency.html#Hi_NcParsers_Dependencys_SystemWired_SegmenterDependency_MakeXmlSource_System_String_System_String_System_Boolean_">MakeXmlSource(string, string, bool)</a>).
</p>
</dd>
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.NcParsers.Dependencys.SystemWired.SentenceIndexCounterDependency.html">SentenceIndexCounterDependency</a></dt>
<dd><p>Per-session monotonically-increasing <a class="xref" href="Hi.NcParsers.Syntaxs.SyntaxPiece.html#Hi_NcParsers_Syntaxs_SyntaxPiece_SentenceIndex">SentenceIndex</a>
allocator. Holds the counter as a private field; <a class="xref" href="Hi.NcParsers.Dependencys.SystemWired.SentenceIndexCounterDependency.html#Hi_NcParsers_Dependencys_SystemWired_SentenceIndexCounterDependency_Allocate">Allocate()</a>
returns the next unused value and increments. <a class="xref" href="Hi.NcParsers.Dependencys.SystemWired.SentenceIndexCounterDependency.html#Hi_NcParsers_Dependencys_SystemWired_SentenceIndexCounterDependency_OnSessionReset">OnSessionReset()</a>
rewinds to 0 — the owning <a class="xref" href="Hi.NcParsers.SoftNcRunner.html#Hi_NcParsers_SoftNcRunner_RunNcLines_System_String_System_Collections_Generic_IEnumerable_System_String__Hi_MachiningProcs_MachiningSession_Hi_MachiningProcs_StepDiagnosticProgress_Hi_NcParsers_NcDiagnosticProgress_System_Threading_CancellationToken_">RunNcLines(string, IEnumerable&lt;string&gt;, MachiningSession, StepDiagnosticProgress, NcDiagnosticProgress, CancellationToken)</a>
invokes it via the <a class="xref" href="Hi.NcParsers.ISessionResettable.html">ISessionResettable</a> sweep on the same
edge that initializes a fresh <a class="xref" href="Hi.MachiningProcs.NcRunnerSessionState.html">NcRunnerSessionState</a>,
so a controller power-reset clears both the syntax-piece pipeline and
this counter in lock-step.</p>
<p>
This dependency exists to fix the sentence-index double-booking bug:
before it, the host file's lazy enumerator numbered pieces from
<code>layers[0].Count</code> captured at file-append time while subprogram /
macro / control-flow re-segmentation numbered from
<code>layers[0].Last.Value.SentenceIndex + 1</code> — two independent
sequences that overlap as soon as a call is inlined mid-stream
(host blocks after <code>M98</code> and the inlined body shared the same
indices). With this counter, <a class="xref" href="Hi.NcParsers.Segmenters.ISegmenter.html">GetSyntaxPieces(ISegmenter, List&lt;INcDependency&gt;, IEnumerable&lt;IndexedFileLine&gt;, int, NcDiagnosticProgress, CancellationToken)</a>
allocates one value per piece at materialization time, which the lazy
pipeline pulls in execution order — indices are session-globally
unique and strictly increasing along the executed stream, at the cost
of no longer being contiguous per file (eager label scans discard
their pre-label prefix, leaving gaps).
</p>
<p>
Values are never negative, preserving the <code>-1</code> "not in pipeline"
sentinel used by <a class="xref" href="Hi.NcParsers.NcDiagnostic.html#Hi_NcParsers_NcDiagnostic_SentenceIndex">SentenceIndex</a> and
<a class="xref" href="Hi.MachiningSteps.MachiningStep.html#Hi_MachiningSteps_MachiningStep_SentenceIndex">SentenceIndex</a>.
When this dependency is absent from the pipeline list,
<a class="xref" href="Hi.NcParsers.Segmenters.ISegmenter.html">GetSyntaxPieces(ISegmenter, List&lt;INcDependency&gt;, IEnumerable&lt;IndexedFileLine&gt;, int, NcDiagnosticProgress, CancellationToken)</a> falls back to the
caller-supplied begin-index numbering — the legacy colliding behavior.
Only code-built runners can hit that fallback: XML rehydration back-fills
a missing instance (the <code>SoftNcRunner</code> XML constructor's
system-wired back-fill), because saves that predate this dependency
never self-heal by round-tripping — re-saving stamps a new
<code>ApiVersion</code> on the same incomplete list.
</p>
</dd>
</dl>
<dl class="jumplist">
@@ -216,13 +296,22 @@ file's blocks back into <code>layers[0]</code> immediately after the M98 host
node so the entire syntax pipeline naturally re-processes them.</p>
<p>
The actual layer list is resolved at runtime via
<span class="xref">Hi.NcParsers.Dependencys.SystemWired.SyntaxPieceLayerDependency.LayersProvider</span>; <a class="xref" href="Hi.NcParsers.SoftNcRunner.html#Hi_NcParsers_SoftNcRunner_RunControlLines_System_String_System_Collections_Generic_IEnumerable_System_String__Hi_MachiningProcs_MachiningSession_Hi_MachiningProcs_SessionProgress_System_Threading_CancellationToken_">RunControlLines(string, IEnumerable&lt;string&gt;, MachiningSession, SessionProgress, CancellationToken)</a>
<span class="xref">Hi.NcParsers.Dependencys.SystemWired.SyntaxPieceLayerDependency.LayersProvider</span>; <a class="xref" href="Hi.NcParsers.SoftNcRunner.html#Hi_NcParsers_SoftNcRunner_RunNcLines_System_String_System_Collections_Generic_IEnumerable_System_String__Hi_MachiningProcs_MachiningSession_Hi_MachiningProcs_StepDiagnosticProgress_Hi_NcParsers_NcDiagnosticProgress_System_Threading_CancellationToken_">RunNcLines(string, IEnumerable&lt;string&gt;, MachiningSession, StepDiagnosticProgress, NcDiagnosticProgress, CancellationToken)</a>
wires the provider to the active session's
<a class="xref" href="Hi.MachiningProcs.NcRunnerSessionState.html#Hi_MachiningProcs_NcRunnerSessionState_SyntaxPieceLayers">SyntaxPieceLayers</a> at
the start of each call. Index 0 is the source layer (init seed +
sentence-derived pieces); indices 1..N are post-NcSyntax layers — same
convention as <a class="xref" href="Hi.MachiningProcs.NcRunnerSessionState.html">NcRunnerSessionState</a>.
</p>
</dd>
</dl>
<dl class="jumplist">
<dt><a class="xref" href="Hi.NcParsers.Dependencys.SystemWired.ToolHouseDependency.html">ToolHouseDependency</a></dt>
<dd><p>Exposes the project's <a class="xref" href="Hi.Machining.MachiningToolHouse.html">MachiningToolHouse</a> to NC pipeline
components — the narrow counterpart of
<a class="xref" href="Hi.NcParsers.Dependencys.SystemWired.MachiningServiceDependency.html">MachiningServiceDependency</a> for syntaxes / semantics that
only look up or register tools (e.g. the CLSF pipeline's
TLDATA-driven tool creation).</p>
</dd>
</dl>