https://istarwyh.github.io/harbor-self-evolving/zh/docs/reference/Recent content in 参考 on Harbor Self-EvolvingHugozh-CNSun, 20 Sep 2026 10:28:22 +0800https://istarwyh.github.io/harbor-self-evolving/zh/docs/reference/tools/Mon, 01 Jan 0001 00:00:00 +0000https://istarwyh.github.io/harbor-self-evolving/zh/docs/reference/tools/<p>Plugin 暴露 <strong>19 个严格工具</strong>：10 个 workspace/Job mutation 进入 DSH 一次性 approval；9 个为只读或内存操作。Host 缺少 approval seam 时，mutation tool fail closed。</p> <div class="td-table-scroll td-table-scroll--static"> <table> <thead> <tr> <th scope="col">Tool</th> <th scope="col">用途与最小边界</th> <th scope="col">模式 / 结果</th> </tr> </thead> <tbody> <tr> <td><code>harbor_candidate_snapshot</code></td> <td>把一个 Cordis composition 固定为不可变 Candidate Manifest。</td> <td>**写本地 Artifact · approval。**下一步：Doctor 或 Context preview。</td> </tr> <tr> <td><code>harbor_model_binding</code></td> <td>读取当前 DSH 默认 provider/model/reasoning 身份。</td> <td>**只读/内存。**返回非敏感 binding draft，不返回凭据。</td> </tr> <tr> <td><code>harbor_evolution_init</code></td> <td>把已确认四概念卡编译成 non-overwriting Stack project。</td> <td>**写本地 Artifact · approval。**不运行评测。</td> </tr> <tr> <td><code>harbor_evolution_doctor</code></td> <td>在产生费用前检查 Candidate、Dataset、Stack、可选 Policy 与执行架构。</td> <td>**只读。**返回阻断诊断。</td> </tr> <tr> <td><code>harbor_quick_diagnostic_init</code></td> <td>创建一个 Query、最小 Host-model Candidate、可运行 Task 与非晋级 Evaluator。</td> <td>**写本地 Artifact · approval。**只证明 wiring。</td> </tr> <tr> <td><code>harbor_session_diagnostic_preview</code></td> <td>在 exact current workspace 预览 1–10 个最近完成顶层 Session。</td> <td>**只读/内存。**安全 metadata + 15 分钟 owner-bound token。</td> </tr> <tr> <td><code>harbor_session_diagnostic_run</code></td> <td>重新验证 token，冻结私有脱敏 Batch，每条 Session 运行一个 Trial。</td> <td>**启动评测 · 写入 · approval。**Historical，Gate N/A。</td> </tr> <tr> <td><code>harbor_dataset_validate</code></td> <td>验证 manifest、Task 唯一性、instruction、路径、敏感 metadata 与 source digest。</td> <td>**只读。**不修复或重写身份。</td> </tr> <tr> <td><code>harbor_context_preview</code></td> <td>刷新 Candidate manifest，预览 Context v3 并寻找可比 baseline。</td> <td>**刷新 manifest · approval。**不运行 Job。</td> </tr> <tr> <td><code>harbor_eval_run</code></td> <td>使用冻结身份运行 strict diagnostic 或 promotion-eligible Candidate Job。</td> <td>**启动评测 · 写入 · approval。**返回 Job 身份。</td> </tr> <tr> <td><code>harbor_eval_result</code></td> <td>读取 summary、Job、Dataset、progress、Trial 或 governance view。</td> <td>**只读。**bounded、递归脱敏、显式 untrusted envelope。</td> </tr> <tr> <td><code>harbor_resolve_page_context</code></td> <td>解析 exact-session opaque <code>@harbor</code> 页面上下文与当前 revision。</td> <td>**只读。**返回窄 metadata、typed ref 与 navigation action。</td> </tr> <tr> <td><code>harbor_get_evidence</code></td> <td>通过精确 typed ancestry ref 读取一个 Evidence。</td> <td>**只读。**不接受猜测 path/id。</td> </tr> <tr> <td><code>harbor_propose_action</code></td> <td>从显式用户请求与新鲜上下文起草一个可过期 Workbench action。</td> <td>**内存 draft。**不写资源、不启动 Job、不 Gate、不部署。</td> </tr> <tr> <td><code>harbor_evaluator_inspect</code></td> <td>检查 active descriptor、implementation kind、ternary Criteria 与 bounded editable source。</td> <td>**只读。**省略 secret/local-path-shaped source。</td> </tr> <tr> <td><code>harbor_evaluator_update</code></td> <td>以 optimistic concurrency 替换一个 allowlisted source，并生成新 Evaluator/Stack 版本。</td> <td>**写本地 Artifact · approval。**不自动评测或 Gate。</td> </tr> <tr> <td><code>harbor_ground_truth_init</code></td> <td>创建 non-overwriting 独立 Ground Truth draft，并记录 provenance。</td> <td>**写本地 Artifact · approval。**支持 human/programmatic/consensus/model/external。</td> </tr> <tr> <td><code>harbor_evaluator_meta_evaluate</code></td> <td>对比重复 observation 与独立 GT，产出 ESF/SCE/RCR。</td> <td>**写报告 · approval。**治理 Evaluator，不晋级 Candidate。</td> </tr> <tr> <td><code>harbor_candidate_compare</code></td> <td>在 Policy 下对可比 Baseline/Candidate Job 应用确定性 Promotion Gate。</td> <td>**写 Gate Artifact · approval · 可晋级。**永不部署。</td> </tr> </tbody> </table> </div> <h2 id="badges">徽标含义 </h2> <ul> <li><strong>Read-only</strong>：不修改 workspace 评测状态。</li> <li><strong>Writes local artifacts</strong>：在 bounded Harbor workspace 创建或版本化文件。</li> <li><strong>Starts evaluation</strong>：批准后可能发生 runner/Judge/model 工作。</li> <li><strong>Promotion eligible</strong>：证据或结论可进入 promotion policy；Historical 与 quick diagnostic 不可。</li> </ul> <p>Tool success 只表示声明操作完成，不代表 Candidate 质量提升或生产环境变化。</p>