agentworkshop 0.7.71 → 0.8.0

package/app/pages/ontology/types.ts

@@ -0,0 +1,122 @@
+/** 本体管理台类型(与服务端 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
+  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[]
+}

package/config.yml

@@ -12,7 +12,7 @@
 app:
   name: AgentWorkShop
   title: AgentWorkShop
-  version: 0.7.71
+  version: 0.8.0
   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.0 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.0` (`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.0 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.0`（`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.0**. `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.0**。`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.0) —
 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.0)
 **各自独立演进** —— 常数不同步是预期行为,不要拿 `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,63 @@ 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',
+    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' },
+  },
   toolsPage: {
     title: 'Tools',
     subtitle: 'A unified catalog of built-in and plugin-registered tools: source, roles, availability, parameter schema, and which Channels disabled them.',

package/i18n/locales/zh-CN.ts

@@ -27,6 +27,7 @@ export default {
       ops: '运维',
       system: '系统',
     },
+    ontology: '本体模型',
     dashboard: '仪表盘',
     workshop: 'Agent 工作台',
     town: '数字孪生',
@@ -1678,6 +1679,63 @@ 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: '校验未通过',
+    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: '变更的规则' },
+  },
   toolsPage: {
     title: '工具管理',
     subtitle: '内置工具与插件注册工具的统一目录：来源、角色、可用性、参数 Schema，以及被哪些 Channel 停用。',

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,40 @@ export function buildToolDefs() {
       },
     },
 
+    // ── 工业本体(ONT;只读三件)──
+    // 写面(起草/编译预览/发布提议)刻意不暴露在本面:本面是用户身份的 REST 投影,
+    // 没有 channel 上下文,治理(引用面/收权即失活/HITL)不生效。写路径请用频道 Agent
+    // 工具桥(host 面 8 工具)或 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_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.0",
   "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(() => {})
+}