agentworkshop 0.7.71 → 0.8.1

package/app/pages/ontology/types.ts

@@ -0,0 +1,164 @@
+/** 本体管理台类型(与服务端 contracts 对齐的最小子集)。 */
+
+export interface OntologySummary {
+  id: string
+  lineId: string
+  versions: number
+  latest: number
+  status: string
+}
+
+export interface DraftSummary {
+  id: string
+  ontologyId: string
+  baseVersion: number | null
+  rev: number
+  ownerUserId: string
+  updatedAt: string
+}
+
+export interface OntologyEntityDto {
+  key: string
+  kind: string
+  name: string
+  description: string
+  unit: string
+  dimension: string
+  role?: string
+}
+
+export interface OntologyRelationDto {
+  id: string
+  kind: string
+  srcKey: string
+  dstKey: string
+  status: string
+  properties: { evidenceTier: string, sign?: string, lagMs?: number }
+}
+
+export interface OntologyRuleDto {
+  id: string
+  key: string
+  kind: string
+  dsl: Record<string, unknown>
+  constraintLevel: string
+  severity: string
+  status: string
+  description: string
+  evidence: Array<{ level: string, source: { type: string } }>
+}
+
+export interface BindingDto {
+  id: string
+  entityKey: string
+  platformKind: string
+  platformId: string
+  targetSub: string
+  direction: string
+  unitDeclared: string
+  unitTarget: string
+}
+
+export interface OntologyDocDto {
+  schemaVersion: number
+  name: string
+  lineId: string
+  description?: string
+  entities: OntologyEntityDto[]
+  relations: OntologyRelationDto[]
+  rules: OntologyRuleDto[]
+  bindings: BindingDto[]
+  note: string
+}
+
+export interface IssueDto { code: string, path: string, message: string, severity: string, ruleId?: string, hint?: string }
+
+export interface DraftDetailDto {
+  draft: DraftSummary
+  doc: OntologyDocDto
+  validation: { ok: boolean, issues: IssueDto[], stats: Record<string, unknown> }
+  bindings: { ok: boolean, failures: Array<{ bindingId: string, code: string, message: string }> }
+}
+
+export interface CompileDto {
+  status: string
+  contentHash: string
+  packHash: string
+  rulePackHash: string
+  counts: { compiled: number, guard: number, explained: number, rejected: number }
+  artifacts: {
+    problemIr: { mvBounds: Record<string, unknown>, cvBounds: Record<string, unknown>, softRegularization: unknown[] }
+    controlGuard: { guards: Array<{ id: string, ruleId: string, onViolate: string, message: string }> }
+    processModel: { featureCandidates: unknown[], delayPriors: unknown[] }
+    sceneContract: { variables: unknown[], constraints: unknown[], inferredRelations: unknown[] }
+  }
+  traces: Array<{ ruleId: string, decision: string, decisionCode: string, message: string, evidenceLevel: string }>
+  issues: IssueDto[]
+}
+
+export interface VersionDto {
+  version: number
+  status: string
+  name: string
+  lineId: string
+  parentVersion: number | null
+  contentHash: string
+  publishedBy: string
+  createdAt: string
+  compiled?: { packHash?: string, counts?: { compiled?: number, guard?: number, rejected?: number } }
+}
+
+export interface VersionDiffDto {
+  from: number
+  to: number
+  entities: { added: string[], removed: string[], changed: string[] }
+  relations: { added: string[], removed: string[], changed: string[] }
+  rules: { added: string[], removed: string[], changed: string[] }
+  bindings: { added: string[], removed: string[], changed: string[] }
+}
+
+export interface OverviewDto {
+  ontologies: OntologySummary[]
+  drafts: DraftSummary[]
+}
+
+/** 服务端 subgraph.core 的视图镜像(只取前端用到的字段) */
+export interface SubgraphBindingDto {
+  platformKind: string
+  platformId: string
+  targetSub: string
+  direction: string
+  status: string
+  unitDeclared: string
+  unitTarget: string
+}
+
+export interface SubgraphNodeDto {
+  key: string
+  kind: string
+  name: string
+  description: string
+  unit: string
+  role?: string
+  hop: number
+}
+
+export interface SubgraphEdgeDto {
+  id: string
+  kind: string
+  srcKey: string
+  dstKey: string
+  evidenceTier: string
+  hop: number
+  direction: 'out' | 'in' | 'lateral' | 'loop'
+}
+
+export interface SubgraphAroundDto {
+  ontologyId: string
+  version: number
+  lineId: string
+  center: SubgraphNodeDto & { hop: 0, bindings: SubgraphBindingDto[] }
+  nodes: SubgraphNodeDto[]
+  edges: SubgraphEdgeDto[]
+  truncated: boolean
+}

package/app/pages/optimizer/index.vue

@@ -18,7 +18,7 @@ const notice = ref('')
 const busy = ref(false)
 
 interface SpecRow { id: string, version: number, status: string, lineId: string, recipeId: string, contentHash: string, spec?: Record<string, unknown> }
-interface ProfileRow { id: string, version: number, status: string, modelRef: string, solverRef: string, profile?: Record<string, unknown> }
+interface ProfileRow { id: string, version: number, name?: string, description?: string, status: string, modelRef: string, solverRef: string, profile?: Record<string, unknown> }
 interface BindingRow { id: string, channelId: string, channelAgentId: string, profileVersion: string, mode: string, revision: number }
 interface RunRow { id: string, status: string, profileId: string, problemIrHash: string, startedAt: string, recommendation?: { status: string, statusLabel: string, validUntil: string } | null }
 
@@ -39,7 +39,7 @@ const specForm = reactive({
   runIds: '', conditionId: 'default', purpose: 'mpc_surrogate' as 'mpc_surrogate' | 'quality_predict',
 })
 
-const profileForm = reactive({ id: 'optp-demo', version: 1, modelId: '', template: 'linear_mpc_quadratic@1', solver: 'osqp_mpc@1', processSpecRef: '', configJson: '{\n  "linear_mpc_quadratic": {\n    "cvWeights": {"cv1": 1},\n    "duWeights": {"mv1": 0.1},\n    "terminalWeight": 2,\n    "targets": {"cv1": 50}\n  }\n}' })
+const profileForm = reactive({ id: 'optp-demo', version: 1, name: '', description: '', modelId: '', template: 'linear_mpc_quadratic@1', solver: 'osqp_mpc@1', processSpecRef: '', configJson: '{\n  "linear_mpc_quadratic": {\n    "cvWeights": {"cv1": 1},\n    "duWeights": {"mv1": 0.1},\n    "terminalWeight": 2,\n    "targets": {"cv1": 50}\n  }\n}' })
 const bindingForm = reactive({ workspaceId: '', channelId: '', agentInstanceId: '', profileId: '', profileVersion: 1, mode: 'recommendation' as 'recommendation' | 'shadow' })
 const datasetId = ref('')
 const solveAgent = ref('')
@@ -151,6 +151,7 @@ async function saveProfile() {
   try {
     const profile = {
       schemaVersion: 1, id: profileForm.id, version: profileForm.version,
+      name: profileForm.name || undefined, description: profileForm.description || undefined,
       modelRef: { modelId: profileForm.modelId, artifactKind: 'linear_state_space@1', artifactHash: '', modelInterface: 'linear_state_space', stage: 'candidate' },
       problemTemplateRef: profileForm.template, problemConfig: JSON.parse(profileForm.configJson),
       solverRef: profileForm.solver, solverVersion: '1', processSpecRef: profileForm.processSpecRef || `${specForm.id}@${specForm.version}`,
@@ -493,6 +494,14 @@ onMounted(loadAll)
           type="number"
           min="1"
         ></label>
+        <label>{{ t('optimizer.fields.name') }}<input
+          v-model="profileForm.name"
+          placeholder="膜厚闭环-MPC 配置"
+        ></label>
+        <label class="block">{{ t('optimizer.fields.description') }}<input
+          v-model="profileForm.description"
+          placeholder="这个求解配置代表什么工况/目标/约束(用户与 Agent 都看这段)"
+        ></label>
         <label>{{ t('optimizer.fields.model') }}<input
           v-model="profileForm.modelId"
           placeholder="mdl-..."
@@ -521,13 +530,20 @@ onMounted(loadAll)
         </button>
       </div>
       <table class="tbl">
-        <thead><tr><th>profile</th><th>status</th><th>model</th><th>solver</th><th /></tr></thead>
+        <thead><tr><th>profile</th><th>{{ t('optimizer.fields.name') }}</th><th>{{ t('optimizer.fields.description') }}</th><th>status</th><th>model</th><th>solver</th><th /></tr></thead>
         <tbody>
           <tr
             v-for="p in profiles"
             :key="`${p.id}@${p.version}`"
           >
-            <td>{{ p.id }}@{{ p.version }}</td><td>{{ p.status }}</td><td>{{ p.modelRef }}</td><td>{{ p.solverRef }}</td>
+            <td>{{ p.id }}@{{ p.version }}</td>
+            <td>{{ p.profile?.name || p.name || '--' }}</td>
+            <td class="desc-cell">
+              {{ p.profile?.description || p.description || '--' }}
+            </td>
+            <td>{{ p.status }}</td>
+            <td>{{ p.modelRef }}</td>
+            <td>{{ p.solverRef }}</td>
             <td>
               <button
                 v-if="p.status !== 'published'"
@@ -662,6 +678,7 @@ pre.json { background: #0d1117; border: 1px solid rgba(255,255,255,0.08); border
 .tbl { width: 100%; border-collapse: collapse; font-size: 12.5px; }
 .tbl th, .tbl td { text-align: left; padding: 7px 8px; border-bottom: 1px solid rgba(255,255,255,0.06); }
 .tbl th { color: #8b98a5; font-weight: 500; }
+.desc-cell { color: #aab6c2; max-width: 360px; }
 .list { list-style: none; padding: 0; margin: 10px 0; display: flex; flex-direction: column; gap: 6px; font-size: 12.5px; }
 .list .gap { color: #ffb86b; }
 .hint { color: #8b98a5; font-size: 12.5px; }

package/config.yml

@@ -12,7 +12,7 @@
 app:
   name: AgentWorkShop
   title: AgentWorkShop
-  version: 0.7.71
+  version: 0.8.1
   description: 基于 Nuxt 4 的配置驱动运行范式
 
 # 运行模式（dev/prod 实际由启动命令决定，此处仅作运行时展示）

package/docs/cli.en.md

@@ -62,7 +62,7 @@ pnpm tui             # the terminal workbench
 ### 3. Quick use via npx (no global install)
 
 ```bash
-npx agentworkshop start            # fetch and start (pin a version with: npx agentworkshop@0.7.71 start)
+npx agentworkshop start            # fetch and start (pin a version with: npx agentworkshop@0.8.1 start)
 npx agentworkshop doctor           # subcommands work as usual
 npx -p agentworkshop aw doctor     # use -p when you want the name aw
 ```
@@ -79,7 +79,7 @@ npx -p agentworkshop aw doctor     # use -p when you want the name aw
 | Package manager | `pnpm@11.9.0` (`packageManager`, needed only for source development) |
 | Module format | ESM (`type: module`) |
 | License | `Apache-2.0` |
-| Current version | `0.7.71` (`package.json`) |
+| Current version | `0.8.1` (`package.json`) |
 
 ## 2. First start (the Claude Code experience)
 

package/docs/cli.md

@@ -60,7 +60,7 @@ pnpm tui             # 终端工作台
 ### 3. npx 快速使用（免全局安装）
 
 ```bash
-npx agentworkshop start            # 拉取并启动(可锁定版本: npx agentworkshop@0.7.71 start)
+npx agentworkshop start            # 拉取并启动(可锁定版本: npx agentworkshop@0.8.1 start)
 npx agentworkshop doctor           # 子命令照常可用
 npx -p agentworkshop aw doctor     # 需要 aw 这个名字时用 -p 指定包
 ```
@@ -76,7 +76,7 @@ npx -p agentworkshop aw doctor     # 需要 aw 这个名字时用 -p 指定包
 | 包管理器 | `pnpm@11.9.0`（`packageManager`，仅源码开发需要） |
 | 模块形态 | ESM（`type: module`） |
 | 许可证 | `Apache-2.0` |
-| 当前版本 | `0.7.71`（`package.json`） |
+| 当前版本 | `0.8.1`（`package.json`） |
 
 ## 二、首次启动（Claude Code 式）
 

package/docs/plugins.en.md

@@ -9,7 +9,7 @@
 >
 > Applies to: plugin system v2 has been available since **v0.7.29** (frontend component
 > injection / plugin settings / plugin i18n / runtime services surface); this document
-> describes **v0.7.71**. `ctx.sdkVersion` is currently `0.3.0`.
+> describes **v0.8.1**. `ctx.sdkVersion` is currently `0.3.0`.
 
 ## 1. Folder layout & quick start
 

package/docs/plugins.md

@@ -6,7 +6,7 @@
 > 本文是唯一权威参考;`docs/site/plugins/` 的分页文档与本文同源。
 >
 > 适用版本:插件系统 v2 自 **v0.7.29** 起可用(前端组件注入 / 插件设置 / 插件 i18n /
-> 运行时服务面);本文档对应当前版本 **v0.7.71**。`ctx.sdkVersion` 当前为 `0.3.0`。
+> 运行时服务面);本文档对应当前版本 **v0.8.1**。`ctx.sdkVersion` 当前为 `0.3.0`。
 
 ## 一、目录结构与快速开始
 

package/docs/sdk.en.md

@@ -7,7 +7,7 @@
 
 **SDK version constants**: server-side `SDK_VERSION = '0.3.0'`, browser-side `CLIENT_SDK_VERSION = '0.3.0'`.
 These two constants are the **interface version of the SDK itself** and evolve **independently**
-from the npm package version (the `version` field in `package.json`, currently 0.7.71) —
+from the npm package version (the `version` field in `package.json`, currently 0.8.1) —
 them being out of sync is expected. Never use `SDK_VERSION` to infer the package version, or the reverse.
 **Module format**: ESM only (only `import` / `export`; there is no CJS entry).
 **Types**: `sdk/index.d.mts` and `sdk/client.d.mts` ship with the package, so TypeScript projects

package/docs/sdk.md

@@ -5,7 +5,7 @@
 > 零第三方运行时依赖,Node ≥ 23.4 与现代浏览器双端可用。
 
 **SDK 版本常量**:服务端 `SDK_VERSION = '0.3.0'`,浏览器端 `CLIENT_SDK_VERSION = '0.3.0'`。
-这两个常量是 **SDK 自身接口的版本号**,与 npm 包版本(`package.json` 的 `version`,当前 0.7.71)
+这两个常量是 **SDK 自身接口的版本号**,与 npm 包版本(`package.json` 的 `version`,当前 0.8.1)
 **各自独立演进** —— 常数不同步是预期行为,不要拿 `SDK_VERSION` 去推断包版本,反之亦然。
 **模块形态**:ESM only(只有 `import` / `export`,没有 CJS 入口)。
 **类型**:`sdk/index.d.mts`、`sdk/client.d.mts` 随包发布,TS 项目零配置获得提示(覆盖范围见 §7)。

package/i18n/locales/en.ts

@@ -27,6 +27,7 @@ export default {
       ops: 'Operations',
       system: 'System',
     },
+    ontology: 'Ontology Model',
     dashboard: 'Dashboard',
     workshop: 'Agent Harness',
     town: 'Digital Twin',
@@ -1678,6 +1679,87 @@ export default {
     kcjqcaw012: 'Drop or pick a device model file first (.glb/.gltf/.obj/.fbx)',
     k8n918k013: 'Model file deleted',
   },
+  ontology: {
+    kicker: 'Industrial Semantic Assets',
+    title: 'Ontology Model',
+    subtitle: 'Build and govern a control-oriented ontology: entities, relations, constraint rules and semantic bindings; the compiler emits traceable bounds, rate limits and runtime guards, published as immutable versions.',
+    refresh: 'Refresh',
+    newDraft: 'New draft',
+    pickDraft: 'Select draft',
+    validate: 'Validate',
+    compile: 'Compile preview',
+    publish: 'Publish version',
+    publishHint: 'Publish is admin-only; unapproved rules cannot enter control constraints',
+    loadFail: 'Failed to load ontology list',
+    loadDraftFail: 'Failed to load draft',
+    loadVersionsFail: 'Failed to load versions',
+    draftCreated: 'Draft {id} created',
+    draftCreateFail: 'Failed to create draft',
+    validateOk: 'Validation passed',
+    validateFail: 'Validation failed',
+    autofix: 'Auto-fix',
+    autofixDone: 'Auto-fixed {n} item(s) (persisted, revision advanced)',
+    autofixNothing: 'No safely auto-fixable issues',
+    autofixPartial: 'Auto-fixable items are done; missing evidence / platform binding drift still needs a human or the agent',
+    autofixFail: 'Auto-fix failed',
+    autofixLog: 'Auto-fixed {n} item(s) this round',
+    compileOk: 'Compiled: {status}',
+    compileFail: 'Compile failed',
+    publishOk: 'Published v{version}',
+    publishFail: 'Publish failed',
+    ruleTransitionOk: 'Rule {rule} → {to}',
+    ruleTransitionFail: 'Rule transition failed',
+    approvalRequested: 'Approval {id} created (needs a second person)',
+    approvalDecided: 'Approval granted',
+    approvalFail: 'Approval flow failed',
+    compareFail: 'Version compare failed',
+    retireOk: 'Retired v{version}',
+    retireFail: 'Retire failed',
+    compileEmpty: 'Click “Compile preview” in the toolbar first',
+    global: 'Global ontology',
+    empty: {
+      ontologies: '      No ontologies yet: create a draft and publish the first version.',
+      issues: '      No validation issues in the current draft.',
+    },
+    noEvidence: 'no evidence',
+    from: 'From version',
+    to: 'To version',
+    compare: 'Compare',
+    tab: { overview: 'Overview', graph: 'Entities & relations', rules: 'Constraint rules', bindings: 'Semantic bindings', versions: 'Versions & release', compile: 'Compile preview' },
+    section: {
+      ontologies: 'Ontologies', issues: 'Validation issues', entities: 'Entities', relations: 'Relations',
+      bindingFailures: 'Binding failures', artifacts: 'Compiled artifacts', ruleTrace: 'Rule trace',
+    },
+    stat: { ontologies: 'Ontologies', drafts: 'Drafts', entities: 'Entities', rules: 'Rules', bindings: 'Bindings' },
+    col: {
+      kind: 'Kind', name: 'Name', role: 'Role', unit: 'Unit', predicate: 'Predicate',
+      evidenceTier: 'Evidence tier', ruleKind: 'Rule kind', level: 'Level', status: 'Status',
+      evidence: 'Evidence', action: 'Action', entity: 'Entity', target: 'Target channel', direction: 'Direction',
+      unitPair: 'Units (declared→target)', version: 'Version', line: 'Line', parent: 'Parent',
+      createdAt: 'Created at', decision: 'Decision', code: 'Decision code', message: 'Message',
+    },
+    action: { review: 'Submit review', validate: 'Mark validated', approve: 'Request approval', retire: 'Retire' },
+    prompt: { ontologyId: 'Ontology id (e.g. ont-pva-line01)', lineId: 'Anchor line id (optional)', approvalId: 'Approval id (empty = request only)' },
+    diff: { entities: 'Entities', relations: 'Relations', rules: 'Rules', bindings: 'Bindings', rulesChanged: 'Changed rules' },
+    graph: {
+      viewGraph: 'Graph',
+      viewTable: 'Table',
+      hint: 'Click a node for details and neighbours; dashed = candidate influence, solid = observed / validated',
+      searchEntity: 'Search entity key or name',
+      largeGraph: '{n} entities — focus mode: search one entity to inspect its neighbourhood',
+      neighbors: 'Neighbourhood (edges and nodes)',
+      direct: 'Direct',
+      indirect: 'Indirect (2 hops)',
+      loading: 'Loading neighbourhood…',
+      truncated: 'Neighbours exceeded the display limit and were truncated (reduce hops or filter kinds)',
+      noNeighbors: 'This entity has no relations',
+      loadNeighborsFail: 'Failed to load neighbourhood',
+      aria: 'Ontology node-relation graph',
+      lane: { mv: 'Manipulated MV', cv: 'Controlled/quality CV', structural: 'State & structure' },
+      tier: { candidate: 'Candidate influence', observed: 'Observed correlation', validated: 'Validated control' },
+    },
+    drawer: { bindings: 'Semantic bindings', noBindings: 'This entity has no platform binding' },
+  },
   toolsPage: {
     title: 'Tools',
     subtitle: 'A unified catalog of built-in and plugin-registered tools: source, roles, availability, parameter schema, and which Channels disabled them.',
@@ -2733,6 +2815,8 @@ export default {
       max: 'Max',
       maxStep: 'Max step',
       model: 'Model id',
+      name: 'Profile name',
+      description: 'Profile description',
       template: 'Problem template',
       solver: 'Solver',
       agentInstance: 'Agent instance id',

package/i18n/locales/zh-CN.ts

@@ -27,6 +27,7 @@ export default {
       ops: '运维',
       system: '系统',
     },
+    ontology: '本体模型',
     dashboard: '仪表盘',
     workshop: 'Agent 工作台',
     town: '数字孪生',
@@ -1678,6 +1679,87 @@ export default {
     kcjqcaw012: '请先拖入或选择设备模型文件(.glb/.gltf/.obj/.fbx)',
     k8n918k013: '已删除模型文件',
   },
+  ontology: {
+    kicker: '工业语义资产',
+    title: '本体模型',
+    subtitle: '构建与治理面向控制的本体：实体、关系、约束规则与语义绑定；经编译器生成可追溯的问题界、步限与运行时守卫，发布为不可变版本。',
+    refresh: '刷新',
+    newDraft: '新建草稿',
+    pickDraft: '选择草稿',
+    validate: '校验',
+    compile: '编译预览',
+    publish: '发布版本',
+    publishHint: '发布仅管理员；未获批规则不得进入控制约束',
+    loadFail: '加载本体清单失败',
+    loadDraftFail: '加载草稿失败',
+    loadVersionsFail: '加载版本失败',
+    draftCreated: '已创建草稿 {id}',
+    draftCreateFail: '创建草稿失败',
+    validateOk: '校验通过',
+    validateFail: '校验未通过',
+    autofix: '自动修复',
+    autofixDone: '自动修复 {n} 项（已落库，rev 已前进）',
+    autofixNothing: '没有可安全自动修复的问题',
+    autofixPartial: '已修复可自动处理项；证据缺失/平台绑定漂移仍需人工或 Agent 补充',
+    autofixFail: '自动修复失败',
+    autofixLog: '本次自动修复 {n} 项',
+    compileOk: '编译完成：{status}',
+    compileFail: '编译失败',
+    publishOk: '已发布 v{version}',
+    publishFail: '发布失败',
+    ruleTransitionOk: '规则 {rule} → {to}',
+    ruleTransitionFail: '规则状态迁移失败',
+    approvalRequested: '已生成审批单 {id}（需第二人裁决）',
+    approvalDecided: '已裁决通过',
+    approvalFail: '批准流程失败',
+    compareFail: '版本比较失败',
+    retireOk: '已退役 v{version}',
+    retireFail: '退役失败',
+    compileEmpty: '先在工具栏点「编译预览」',
+    global: '全局本体',
+    empty: {
+      ontologies: '      本体清单为空：先新建草稿并发布首个版本。',
+      issues: '      当前草稿没有校验问题。',
+    },
+    noEvidence: '无证据',
+    from: '起始版本',
+    to: '目标版本',
+    compare: '比较',
+    tab: { overview: '总览', graph: '实体与关系', rules: '约束规则', bindings: '语义绑定', versions: '版本与发布', compile: '编译预览' },
+    section: {
+      ontologies: '本体清单', issues: '校验问题', entities: '实体', relations: '关系',
+      bindingFailures: '绑定校验失败', artifacts: '四类编译产物', ruleTrace: '规则溯源',
+    },
+    stat: { ontologies: '本体', drafts: '草稿', entities: '实体', rules: '规则', bindings: '绑定' },
+    col: {
+      kind: '类型', name: '名称', role: '角色', unit: '单位', predicate: '关系',
+      evidenceTier: '证据档', ruleKind: '规则类型', level: '约束级别', status: '状态',
+      evidence: '证据', action: '操作', entity: '实体', target: '目标通道', direction: '方向',
+      unitPair: '单位(声明→目标)', version: '版本', line: '产线', parent: '父版本',
+      createdAt: '创建时间', decision: '决策', code: '决策码', message: '说明',
+    },
+    action: { review: '提交审查', validate: '登记为已验证', approve: '申请批准', retire: '退役' },
+    prompt: { ontologyId: '本体 id（形如 ont-pva-line01）', lineId: '授权锚定产线 id（可留空）', approvalId: '审批单 id（留空=仅生成不裁决）' },
+    diff: { entities: '实体', relations: '关系', rules: '规则', bindings: '绑定', rulesChanged: '变更的规则' },
+    graph: {
+      viewGraph: '图',
+      viewTable: '表',
+      hint: '点击节点查看详情与邻接；虚线=候选影响，实线=已观测/已验证',
+      searchEntity: '搜索实体 key 或名称',
+      largeGraph: '实体较多（{n} 个），已切换为聚焦模式：先搜索一个实体再看邻接',
+      neighbors: '邻接（关联边与节点）',
+      direct: '直接关联',
+      indirect: '间接关联（2 跳）',
+      loading: '正在加载邻接…',
+      truncated: '邻居超过显示上限，已截断（可缩小跳数或类型过滤）',
+      noNeighbors: '该实体没有关联边',
+      loadNeighborsFail: '加载邻接失败',
+      aria: '本体节点关系图',
+      lane: { mv: '操纵量 MV', cv: '被控/质量量 CV', structural: '状态与结构' },
+      tier: { candidate: '候选影响', observed: '已观测相关', validated: '已验证控制' },
+    },
+    drawer: { bindings: '语义绑定', noBindings: '该实体未绑定平台节点' },
+  },
   toolsPage: {
     title: '工具管理',
     subtitle: '内置工具与插件注册工具的统一目录：来源、角色、可用性、参数 Schema，以及被哪些 Channel 停用。',
@@ -2733,6 +2815,8 @@ export default {
       max: '上限',
       maxStep: '单步限幅',
       model: '模型 id',
+      name: '配置名称',
+      description: '配置描述',
       template: '问题模板',
       solver: '求解器',
       agentInstance: 'Agent 实例 id',

package/mcp/aw-mcp-server.mjs

@@ -198,7 +198,7 @@ function omit(obj, ...keys) {
 }
 
 /**
- * 工具面(35 个)—— 按三个 skill 的标准流程分组:
+ * 工具面(41 个)—— 按三个 skill 的标准流程分组:
  *   连接:aw_status / aw_login
  *   节点绑定:aw_line_* / aw_product_create / aw_recipe_create / aw_dcw_* / aw_param_* / aw_daq_*
  *   优化 channel:aw_channel_* / aw_team_provision / aw_agent_tool_* / aw_twin_profile_* / aw_task_* / aw_model_* / aw_optimization_judge
@@ -665,6 +665,58 @@ export function buildToolDefs() {
       },
     },
 
+    // ── 工业本体(ONT;只读四件)──
+    // 写面(起草/编译预览/发布提议)刻意不暴露在本面:本面是用户身份的 REST 投影,
+    // 没有 channel 上下文,治理(引用面/收权即失活/HITL)不生效。写路径请用频道 Agent
+    // 工具桥(host 面 10 工具)或 aw_agent_tool_invoke。
+    {
+      name: 'ontology_scene_inspect',
+      description: '只读查询某产线的已发布工业本体:实体/语义绑定/已验证影响关系/约束规则编译决策/运行时守卫。用于确认变量语义、单位、受哪条规则限制及其来源版本。',
+      inputSchema: obj({
+        lineId: s('产线 id(必填)'),
+        limit: s('每页实体数(1-200,缺省 50)', 'number'),
+      }, ['lineId']),
+      run: rest('GET', args => `/api/workshop/ontology/scene${queryOf({ lineId: args.lineId, limit: args.limit })}`),
+    },
+    {
+      name: 'ontology_node_neighbors',
+      description: '只读查询某产线已发布本体中以实体为中心的邻接/多跳子图:中心实体与平台绑定、各跳邻居(key/hop/类型/角色)、关联边(类型/方向/证据档/hop)与截断标记。用于回答「这个变量直接/间接关联什么」。',
+      inputSchema: obj({
+        lineId: s('产线 id(必填)'),
+        entityKey: s('中心实体 key(必填,可先用 ontology_scene_inspect 查)'),
+        hops: s('跳数 1-3(缺省 1)', 'number'),
+        direction: s('both | out | in(缺省 both)'),
+        kinds: s('关系类型过滤,逗号分隔(缺省=全部)'),
+      }, ['lineId', 'entityKey']),
+      run: rest('GET', args => `/api/workshop/ontology/scene${queryOf({
+        lineId: args.lineId,
+        entity: args.entityKey,
+        hops: args.hops,
+        direction: args.direction,
+        kinds: args.kinds,
+      })}`),
+    },
+    {
+      name: 'ontology_rule_explain',
+      description: '只读解释一条本体规则的来源与编译决策(DSL/证据级别/生命周期/decision 与 decisionCode/落到哪类产物/适用配方与工况)。用于回答「为什么这条建议受限制」。',
+      inputSchema: obj({
+        ontologyId: s('本体 id(必填)'),
+        ruleId: s('规则 id 或 key(必填)'),
+        version: s('本体版本号(缺省=最近版本)', 'number'),
+      }, ['ontologyId', 'ruleId']),
+      run: rest('GET', args => `/api/workshop/ontology/traces/${encodeURIComponent(args.ontologyId)}${queryOf({ ruleId: args.ruleId, version: args.version })}`),
+    },
+    {
+      name: 'ontology_version_compare',
+      description: '只读比较本体两个已发布版本的差异(实体/关系/规则/绑定四段:新增/删除/变更)。用于回答「这份本体改了什么、为什么控制行为变了」。',
+      inputSchema: obj({
+        ontologyId: s('本体 id(必填)'),
+        from: s('起始版本号', 'number'),
+        to: s('目标版本号', 'number'),
+      }, ['ontologyId', 'from', 'to']),
+      run: rest('GET', args => `/api/workshop/ontology/versions/${encodeURIComponent(args.ontologyId)}/compare${queryOf({ from: args.from, to: args.to })}`),
+    },
+
     // ── 逃生舱 ──
     {
       name: 'aw_request',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentworkshop",
-  "version": "0.7.71",
+  "version": "0.8.1",
   "type": "module",
   "description": "AgentWorkShop 软件开发系统 - 基于 Nuxt 4 的配置驱动运行范式",
   "license": "Apache-2.0",

package/scripts/docs-shots.mjs

@@ -0,0 +1,36 @@
+/**
+ * 文档站渲染取证(一次性):首页 zh/en + 本体指南页截图。
+ * 用法: node scripts/docs-shots.mjs <baseUrl> <outDir>
+ */
+import { mkdirSync } from 'node:fs'
+import { join, resolve } from 'node:path'
+
+const BASE = process.argv[2] || 'http://127.0.0.1:4173/AgentWorkShop'
+const OUT = process.argv[3] || resolve('docs/audit/evidence/2026-10-24-idd-rag-ontology/docs-shots')
+mkdirSync(OUT, { recursive: true })
+
+const { launch, openPage } = await import('./ui/lib.mjs')
+process.env.AW_BASE = BASE
+const browser = await launch({ width: 1500, height: 1000 })
+try {
+  const page = await openPage(browser, { width: 1500, height: 1000, deviceScaleFactor: 1 })
+  const errors = []
+  page.on('pageerror', e => errors.push(String(e.message).slice(0, 200)))
+  const pages = [
+    ['/', 'docs-home-zh'],
+    ['/en/', 'docs-home-en'],
+    ['/guide/ontology.html', 'docs-ontology-zh'],
+    ['/en/guide/ontology.html', 'docs-ontology-en'],
+  ]
+  for (const [path, name] of pages) {
+    await page.goto(BASE + path, { waitUntil: 'networkidle0', timeout: 60000 })
+    await new Promise(r => setTimeout(r, 1200))
+    await page.screenshot({ path: join(OUT, `${name}.png`), fullPage: true })
+    const len = await page.evaluate(() => document.body.innerText.length)
+    console.log(`${name}: len=${len} errors=${errors.length}`)
+  }
+  if (errors.length) console.log('PAGE ERRORS:', errors.slice(0, 3).join('; '))
+}
+finally {
+  await browser.close().catch(() => {})
+}