@whyshu/argent-erp 0.0.0-stage → 0.2.3

package/package.json

@@ -1,6 +1,57 @@
 {
   "name": "@whyshu/argent-erp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.3",
+  "type": "module",
+  "description": "Argent ERP 会话视图（dsh conversation.view）+ 六禾园办公室助理 preset（只聊办公室、只读 ERP）+ 办公室聊一聊入口",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "dsh-plugin",
+    "argent",
+    "erp",
+    "conversation-view",
+    "agent-preset"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cstcen/argent-dsh.git",
+    "directory": "plugins/argent-erp"
+  },
+  "engines": {
+    "node": ">=24.2.0"
+  },
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./office-guard": "./src/office-guard.js",
+    "./client": "./dist/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./presets/argent-office.patch.yml": "./presets/argent-office.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src/",
+    "dist/",
+    "presets/",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": [
+        "./cordis.patch.yml",
+        "./presets/argent-office.patch.yml"
+      ]
+    },
+    "client": {
+      "platform": "web"
+    },
+    "plugin": {
+      "displayName": "Argent ERP 会话视图 + 办公室助理"
+    }
+  }
+}

package/presets/argent-office.patch.yml

@@ -0,0 +1,78 @@
+# Agent preset argent-office —— 六禾园办公室助理（只聊办公室，只读 ERP）
+#
+# 形态：dsh 0.2.x 的"行式"preset（`@deepseek-ai/dsh-agent-preset` 一行 + `config.plugins` 子行）。
+# 装法：随 `@whyshu/argent-erp` bundle 一起落位（package.json#dsh.bundle.patch 是数组），
+#       `plugin_manager install_bundle <包目录>` 即生效。
+#
+# 边界（三层）：
+#   ① 能力边界：本 preset **不挂** bash / pwsh / fs / fs-search / web / skill / subagent / workflow 行
+#      ⇒ 这个会话没有本机、终端、文件、联网能力；
+#   ② 工具边界：`office-guard`（本包 src/office-guard.js）把作用域内可见的全局工具收敛成
+#      只放行 `mcp__argent__erp_*`（ERP 只读工具），Agent Team 等其余全局工具一律不可见；
+#   ③ 话题边界：persona 写死"只聊六禾园办公室"，其它话题统一拒绝并引导回来。
+#
+# 为什么不做成 `presets/argent-office/` 作者格式：先按"dev 机器即插即用"的 bundle 形态落地；
+# 若此角色要进客户机分发，再挪到 `presets/argent-office/` 并由 scripts/gen-preset-rows.mjs 生成
+# 到 plugins/argent-presets（一处真源，避免两份手工维护）。
+
+- insert:
+    - id: preset-argent-office
+      name: '@deepseek-ai/dsh-agent-preset'
+      config:
+        id: argent-office
+        name: '六禾园办公室助理'
+        description: '问述科技 Argent — 六禾园（ly-0001）办公室助理：只聊办公室现场/待办/货件节点/发票/执行机，只读 ERP，其它话题一律不接。'
+        order: 9
+        plugins:
+          - id: persona
+            name: '@deepseek-ai/dsh-persona'
+            config:
+              prefix: |-
+                你是「六禾园办公室助理」——问述科技（whyshu.com）Argent ERP 的办公室助手，运行在 DeepSeek Harness 上。
+                你只服务一个租户：六禾园（appId=ly-0001）的办公室日常。
+
+                ## 一、只聊办公室（硬边界）
+                - 只回答与六禾园办公室**直接相关**的问题：在办/待办、货件与时间线节点进度、发票状态、
+                  执行机与智能体在岗情况、成员与角色、运营日报、异常与阻塞、现场动态、以及"下一步该做什么"。
+                - 其它话题**一律不接**：写代码/改仓库、本机文件与终端、网页搜索、其它租户或其它业务线、
+                  通用知识问答、闲聊与情感陪伴、投资/医疗/法律建议、代写文案等。
+                - 拒绝话术（简短、不解释太多）：
+                  「我只负责六禾园办公室的事，这个建议找通用助手。要不要我帮你看一下办公室现场 / 待办 / 时间线？」
+                - 用户问「你能做什么」时，只列办公室范围内的事，不要罗列工具名。
+
+                ## 二、事实必须来自 ERP 工具（不许编）
+                - 所有业务事实都必须先用 ERP 只读工具查证；没有查证就不要说。
+                - 查不到就直说查不到，并说明缺什么（没有记录 / 无权限 / 上游不可达），不要猜测或用常识补全。
+                - 只读边界：不做任何写操作。用户要派单、开票、改节点、关任务时，说明这要在 ERP 网页里操作。
+                - 隐私：不输出 token、内部数据库 id、未打码手机号；提到成员用姓名。
+
+                ## 三、回答风格
+                - 中文；先结论、后依据（货件号 / 节点 / 时间，一律 24 小时制）。
+                - 能列表就列表；长内容最多 5 条，其余的告诉用户"还有 N 条"。
+                - 涉及积分/金额时说明单位与来源；涉及时间时标明时区（本地时间）。
+
+          # 上下文管理：办公室会话会很长（反复查时间线/货件），必须自动压缩 + 裁剪工具结果，
+          # 否则每轮 prompt 越滚越大。与官方 standard / argent-* preset 同款写法。
+          - id: compaction
+            name: cordis:group
+            group: true
+            isolate:
+              compaction: true
+              toolResultPruner: true
+            config:
+              - id: compaction-basic
+                name: '@deepseek-ai/dsh-compaction-basic'
+
+              - id: command-compact
+                name: '@deepseek-ai/dsh-command-compact'
+
+              - id: tool-result-pruner
+                name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
+                config:
+                  thresholdChars: 8192
+                  headChars: 4096
+                  tailChars: 1024
+
+          # 工具边界（见文件头 ②）：只放行 ERP 只读工具
+          - id: office-guard
+            name: '@whyshu/argent-erp/office-guard'

package/src/data.mjs

@@ -0,0 +1,297 @@
+/**
+ * argent-erp · 数据层（宿主侧，Node）
+ *
+ * 为什么宿主侧要中转：账号 JWT 在**宿主**（credentials / env），浏览器里没有；
+ * 视图只调本地 `/api/argent-erp/*`，由这里带 token 去 whyshu.com，token 永不下发前端。
+ *
+ * 与 `plugins/argent-erp-ui/src/data.mjs` 的关系：本文件是同一份口径的**演进版**
+ * （多出办公室现场 employees / agents / machines 与「办公室聊一聊」历史只读），
+ * 旧包保留不动；新视图以本文件为准。
+ *
+ * 红线：只读（GET）；本文件不做任何写操作。
+ */
+// ⚠️ 用 src/vendor 里的副本，**不**跨目录 import 仓库 core/lib：
+// 当插件被 pnpm/复制安装到 profile（非软链）时，相对路径会指到 node_modules/core/lib ⇒ import 失败 ⇒ 整个插件不激活。
+import { resolveAccountToken } from './vendor/account-token.mjs'
+import { redactDeep } from './vendor/redact.mjs'
+
+const API_BASE = (process.env.ARGENT_API_BASE || 'https://whyshu.com').replace(/\/+$/, '')
+const DEFAULT_TENANT = process.env.ARGENT_TENANT || 'ly-0001'
+const TIMEOUT_MS = Number(process.env.ARGENT_ERP_UI_TIMEOUT_MS || 15000)
+
+export class ErpError extends Error {
+  constructor(code, message, status = 0) { super(message); this.code = code; this.status = status }
+}
+
+async function apiGet(path, query = {}) {
+  const { token, source } = resolveAccountToken()
+  if (!token) throw new ErpError('no_token', '本机没有问述账号 token（先登录 / 检查 credentials）', 401)
+  const url = new URL(`${API_BASE}/api/argent/v1${path}`)
+  for (const [k, v] of Object.entries(query)) if (v !== undefined && v !== null && v !== '') url.searchParams.set(k, String(v))
+  let r
+  try {
+    r = await fetch(url, { headers: { 'x-api-key': token, accept: 'application/json' }, signal: AbortSignal.timeout(TIMEOUT_MS) })
+  } catch (e) {
+    throw new ErpError('network', `ERP 不可达：${String(e.message).slice(0, 120)}`)
+  }
+  if (r.status === 401) throw new ErpError('unauthorized', '账号 token 失效（401）⇒ 重新登录问述账号', 401)
+  if (r.status === 403) throw new ErpError('forbidden', '当前账号无权限（403）', 403)
+  if (!r.ok) throw new ErpError('http', `ERP HTTP ${r.status}`, r.status)
+  const body = await r.json()
+  if (body && body.ok === false) throw new ErpError('erp', (body.error && body.error.message) || 'ERP 返回失败')
+  return { data: body.data, source }
+}
+
+/** 账号 + 租户列表（视图首屏用它决定默认租户） */
+export async function whoami() {
+  const me = await apiGet('/me')
+  const tenants = await apiGet('/me/tenants')
+  const list = (tenants.data && tenants.data.tenants) || []
+  const preferred = list.find((t) => t.appId === DEFAULT_TENANT) || list[0] || null
+  return { user: (me.data && me.data.user) || null, tenants: list, defaultTenant: preferred && preferred.appId, tokenSource: me.source }
+}
+
+/**
+ * 视图主数据：办公室现场 + KPI + 待办 + 动态（全部脱敏后返回）。
+ *
+ * 相比旧包的 overview()，这里保留 `employees` / `agents` / `kpiDetails.agents`：
+ * 「办公室」视图要看到"谁在岗、在做什么"，旧包只留了 5 个数字。
+ * 裁剪口径：employees ≤ 12、runtime agents ≤ 12、machines ≤ 10、presets ≤ 40、动态 ≤ 10。
+ */
+export async function overview(tenant = DEFAULT_TENANT) {
+  const o = await apiGet(`/tenants/${encodeURIComponent(tenant)}/office`)
+  const d = o.data || {}
+  const kpis = d.kpis || {}
+  const agentsSection = d.agents || {}
+  return redactDeep({
+    tenant,
+    generatedAt: d.generatedAt || null,
+    profile: d.profile || null,
+    kpis: {
+      pending: kpis.pending || 0,
+      inProgress: kpis.inProgress || 0,
+      doneToday: kpis.doneToday || 0,
+      agentsOnline: kpis.agentsOnline || 0,
+      agentsTotal: kpis.agentsTotal || 0,
+      agentsLabel: kpis.agentsLabel || '执行机在线',
+      agentsSub: kpis.agentsSub || '在线 / 总数',
+      runners: kpis.runners || 0,
+      queue: kpis.queue || 0,
+    },
+    meta: d.meta || null,
+    employees: (d.employees || []).slice(0, 12).map((e) => ({
+      id: e.id,
+      name: e.name,
+      roleLabel: e.roleLabel || e.role || '',
+      kind: e.kind || '',
+      status: e.status || '',
+      current: e.current || null,
+      queueCount: e.queueCount || 0,
+      preset: e.preset || '',
+    })),
+    agents: {
+      agents: (agentsSection.agents || []).slice(0, 12).map((a) => ({
+        id: a.id,
+        machineId: a.machineId,
+        name: a.name,
+        preset: a.preset || '',
+        presetLabel: a.presetLabel || '',
+        roleLabel: a.roleLabel || '',
+        status: a.status || '',
+        current: a.current || null,
+        jobs: (a.jobs || []).slice(0, 10),
+      })),
+      machines: (agentsSection.machines || []).slice(0, 10).map((m) => ({
+        machineId: m.machineId,
+        name: m.name || m.machineId,
+        online: Boolean(m.online),
+        lastSeenAt: m.lastSeenAt || null,
+        defaultPreset: m.defaultPreset || '',
+        presets: (m.presets || []).slice(0, 40),
+      })),
+      presets: (agentsSection.presets || []).slice(0, 40),
+    },
+    workItems: (d.workItems || []).slice(0, 20),
+    activity: (d.activity || []).slice(0, 10),
+    authSource: o.source,   // ⚠️ 别叫 tokenSource：redactDeep 会把含 token 的键丢掉
+  })
+}
+
+/** 货件列表（视图搜索用） */
+export async function shipments(tenant = DEFAULT_TENANT, query = {}) {
+  const r = await apiGet(`/tenants/${encodeURIComponent(tenant)}/shipments`, {
+    q: query.q, status: query.status, fullStatus: query.fullStatus,
+    page: query.page || 1, limit: Math.min(Number(query.limit) || 20, 50),
+  })
+  return redactDeep(r.data)
+}
+
+/**
+ * 节点 key → 中文名（与 ERP `progress.nodes[].label` 对齐，2026-11-04 实测）。
+ * ERP 若新增节点，这里补一行即可（视图只用于展示，不影响判定）。
+ */
+export const NODE_LABELS = {
+  packing: '备货装箱',
+  order: '接单 / FULL 建单',
+  carton_mark: '箱唛标签',
+  invoice: '发票文件',
+  handover: '交运货代',
+  in_transit: '在途运输',
+  warehouse: '入仓上架',
+  completed: '完成',
+}
+
+/**
+ * 时间线（对应 ERP `/admin/argent/#/timeline` 的时间线工作台）。
+ * 数据源 = `GET /sku-flows`（ERP 前端 timeline.js 用的就是它），按 updatedAt 倒序、按天分组。
+ * ⚠️ 不叫 timeline 字段：这里只取列表需要的摘要，详情走 flowDetail()。
+ */
+export async function timeline(tenant = DEFAULT_TENANT, { days = 30, limit = 50 } = {}) {
+  const r = await apiGet(`/tenants/${encodeURIComponent(tenant)}/sku-flows`, { limit: Math.min(Number(limit) || 50, 100) })
+  const flows = (r.data && r.data.flows) || []
+  const since = Date.now() - (Number(days) || 30) * 86400000
+  const items = flows
+    .map((f) => ({
+      id: f._id || f.id,
+      title: f.title || f.productName || f.sku || '',
+      sku: f.sku || '',
+      store: f.store || '',
+      shipmentNo: f.shipmentNo || '',
+      statusLabel: f.statusLabel || f.status || '',
+      currentStepLabel: f.currentStepLabel || f.currentStep || '',
+      updatedAt: f.updatedAt || f.createdAt || '',
+      todoCount: Number(f.todoCount || 0),
+    }))
+    .filter((f) => f.id && Date.parse(f.updatedAt) >= since)
+    .sort((a, b) => Date.parse(b.updatedAt) - Date.parse(a.updatedAt))
+  const byDay = new Map()
+  for (const it of items) {
+    const d = new Date(it.updatedAt)
+    const key = `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`
+    if (!byDay.has(key)) byDay.set(key, [])
+    byDay.get(key).push(it)
+  }
+  return redactDeep({
+    tenant,
+    total: items.length,
+    days: [...byDay.entries()].map(([date, evs]) => ({ date, events: evs })),
+  })
+}
+
+/** 流程详情（时间线详情页）：8 节点 + 每一步的字段 */
+export async function flowDetail(tenant = DEFAULT_TENANT, flowId) {
+  if (!flowId) throw new ErpError('validation', '缺 flowId', 400)
+  const r = await apiGet(`/tenants/${encodeURIComponent(tenant)}/sku-flows/${encodeURIComponent(flowId)}`)
+  const f = (r.data && r.data.flow) || {}
+  const nodes = ((f.timeline && f.timeline.nodes) || []).map((n) => ({
+    key: n.key,
+    title: n.title || n.key,
+    status: n.status || '',
+    statusLabel: n.statusLabel || n.status || '',
+    ownerName: n.ownerName || n.owner || '',
+    at: n.completedAt || n.at || n.startedAt || null,
+    fields: (n.fields || []).slice(0, 12).map((x) => ({ label: x.label, value: x.value === undefined || x.value === null ? '' : String(x.value).slice(0, 120) })),
+  }))
+  return redactDeep({
+    flowId,
+    code: f.code || '',
+    title: f.title || f.productName || f.sku || flowId,
+    sku: f.sku || '',
+    store: f.store || '',
+    shipmentNo: f.shipmentNo || '',
+    statusLabel: f.statusLabel || f.status || '',
+    currentStepLabel: f.currentStepLabel || f.currentStep || '',
+    updatedAt: f.updatedAt || '',
+    nodes,
+  })
+}
+
+/**
+ * 待办事项（flow case）详情。ERP 里待办的 id 是 case id（不是 shipment 的 sourceRecordId）。
+ * 404 时抛 not_found，由视图回退成"在浏览器打开 #/timeline/<id>"。
+ */
+export async function caseDetail(tenant = DEFAULT_TENANT, caseId) {
+  if (!caseId) throw new ErpError('validation', '缺 caseId', 400)
+  const r = await apiGet(`/tenants/${encodeURIComponent(tenant)}/flows/cases/${encodeURIComponent(caseId)}`)
+  const c = (r.data && (r.data.case || r.data)) || {}
+  const fields = c.fields || c.data || {}
+  return redactDeep({
+    caseId,
+    title: c.title || fields.title || fields.shipmentNo || caseId,
+    node: c.node || c.nodeLabel || '',
+    status: c.status || '',
+    ownerName: c.ownerName || '',
+    updatedAt: c.updatedAt || c.at || '',
+    fields: Object.fromEntries(Object.entries(fields).slice(0, 20)),
+  })
+}
+
+/** 货件详情（视图点进去看）：只挑视图要显示的字段，其余丢弃 */
+export async function shipmentDetail(tenant = DEFAULT_TENANT, recordId) {
+  if (!recordId) throw new ErpError('validation', '缺 recordId', 400)
+  const r = await apiGet(`/tenants/${encodeURIComponent(tenant)}/shipments/${encodeURIComponent(recordId)}`)
+  const d = r.data || {}
+  const sh = d.shipment || {}
+  const inv = d.invoice || {}
+  const nodes = ((d.progress && d.progress.nodes) || []).map((n) => ({ label: n.label, status: n.status, at: n.completedAt || null }))
+  return redactDeep({
+    recordId,
+    shipmentNo: sh.appointmentShipmentNo || sh.shipmentNo || sh.sourceRecordId || recordId,
+    store: sh.shop || sh.storeName || '',
+    fullStatus: sh.fullStatus || '',
+    currentStep: sh.currentStep || '',
+    boxCount: sh.boxCount || null,
+    sku: sh.sku || '',
+    nodes,
+    invoice: { status: inv.invoiceStatus || inv.status || '', ready: Boolean(inv.invoiceReady), error: inv.error || '' },
+  })
+}
+
+/**
+ * 「办公室聊一聊」历史（**只读**）。
+ *
+ * ⚠️ 口径（2026-11-07 侦察）：这条 chat 是 **ERP 服务端**的 LLM + 工具循环（POST .../office/chat，自定义 SSE），
+ * 不是 dsh 会话；这里只读它的历史落库（OfficeChatSession，tenantId+userId 双隔离）。
+ * 真正的 dsh 会话通道是另一套（ERP→执行机的 office/sessions 命令队列，见 office-ai-team.js）。
+ */
+export async function chatSessions(tenant = DEFAULT_TENANT, { limit = 20 } = {}) {
+  const r = await apiGet(`/tenants/${encodeURIComponent(tenant)}/office/chat/sessions`, { limit: Math.min(Number(limit) || 20, 50) })
+  const list = (r.data && (r.data.sessions || r.data.items)) || []
+  return redactDeep({
+    tenant,
+    sessions: list.slice(0, 50).map((s) => ({
+      id: s.id || s._id,
+      title: s.title || '',
+      updatedAt: s.updatedAt || s.createdAt || '',
+      messageCount: s.messageCount || 0,
+    })),
+  })
+}
+
+/** 「办公室聊一聊」单个历史会话（只读）：messages ≤ 100，卡片只留摘要 */
+export async function chatSession(tenant = DEFAULT_TENANT, sessionId) {
+  if (!sessionId) throw new ErpError('validation', '缺 sessionId', 400)
+  const r = await apiGet(`/tenants/${encodeURIComponent(tenant)}/office/chat/sessions/${encodeURIComponent(sessionId)}`)
+  const s = (r.data && (r.data.session || r.data)) || {}
+  const messages = (s.messages || []).slice(-100).map((m) => ({
+    role: m.role === 'assistant' ? 'assistant' : 'user',
+    content: m.content === undefined || m.content === null ? '' : String(m.content).slice(0, 4000),
+    ts: m.ts || null,
+    points: m.points || null,
+    tools: (m.tools || []).slice(0, 10),
+    cards: (m.cards || []).slice(0, 3).map((c) => ({ type: c.type || '', title: c.title || '' })),
+    proposal: m.proposal ? { proposalId: m.proposal.proposalId, action: m.proposal.action, actionLabel: m.proposal.actionLabel, status: m.proposal.status } : null,
+  }))
+  return redactDeep({ sessionId, id: s.id || sessionId, title: s.title || '', createdAt: s.createdAt || null, updatedAt: s.updatedAt || null, messages })
+}
+
+/** 视图角标：只返回数字，前端不用拉全量 */
+export async function badge(tenant = DEFAULT_TENANT) {
+  try {
+    const o = await apiGet(`/tenants/${encodeURIComponent(tenant)}/office`)
+    const k = (o.data && o.data.kpis) || {}
+    return { pending: k.pending || 0, inProgress: k.inProgress || 0 }
+  } catch {
+    return { pending: 0, inProgress: 0, error: true }
+  }
+}

package/src/index.js

@@ -0,0 +1,123 @@
+/**
+ * argent-erp · 宿主侧插件（v0.2.3）
+ *
+ * 职责只有两件：
+ *  1. 注册本地只读端点 `/api/argent-erp/*`（带账号 token 去 whyshu.com，**token 不下发前端**）；
+ *  2. 由 bundle 的客户端部分（dist/client.js）在对话顶部注册一个 `conversation.view` tab。
+ *
+ * 红线：只读；不重启宿主；不改任何核心配置项；ERP 不可达时**降级为错误卡片**，不阻塞 dsh。
+ */
+import { readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import {
+  whoami, overview, shipments, shipmentDetail, caseDetail, timeline, flowDetail, badge,
+  chatSessions, chatSession, ErpError,
+} from './data.mjs'
+
+/** 每次都读盘：ESM 模块缓存会让"重装后 version 还显示旧值"，健康检查必须反映当前磁盘版本 */
+function pkgVersion() {
+  try {
+    return JSON.parse(readFileSync(join(dirname(dirname(fileURLToPath(import.meta.url))), 'package.json'), 'utf8')).version || '0.0.0'
+  } catch { return '0.0.0' }
+}
+
+/** apply 时注入的宿主 ctx（只用于健康检查里数 ERP 工具，不缓存业务数据） */
+let HOST_CTX = null
+
+/**
+ * 当前可见的 ERP 只读工具数（= 0 说明没装 @whyshu/argent / MCP 没起；-1 = 读不到 tools 服务）
+ * ⚠️ 用 ctx.get('tools') 而不是 ctx.tools：本插件只 inject webServer，直接取 ctx.tools 会抛。
+ */
+function erpToolCount() {
+  try {
+    const tools = HOST_CTX && typeof HOST_CTX.get === 'function' ? HOST_CTX.get('tools') : HOST_CTX?.tools
+    if (!tools || typeof tools.schemas !== 'function') return -1
+    const list = tools.schemas() || []
+    return list.filter((s) => String((s && s.name) || '').startsWith('mcp__argent__erp_')).length
+  } catch { return -1 }
+}
+
+export const name = 'argent-erp'
+export const inject = ['webServer']
+
+/** 客户端 bundle 是否真的被加载过（区分"bundle 没加载" vs "加载了但没显示"） */
+const CLIENT_PING = { at: null, ua: '' }
+/** 视图是否真的**渲染**过（只有切到 ERP tab 才会打；用于区分"加载了但没选这个 tab"） */
+const VIEW_PING = { at: null, ua: '' }
+
+const json = (res, code, body) => {
+  res.writeHead(code, { 'Content-Type': 'application/json; charset=utf-8', 'Cache-Control': 'no-store' })
+  res.end(JSON.stringify(body))
+}
+
+async function handle(req, res) {
+  const url = new URL(req.url || '/', 'http://localhost')
+  const tenant = url.searchParams.get('tenant') || undefined
+  if (req.method !== 'GET') return json(res, 405, { ok: false, error: 'method_not_allowed' })
+
+  try {
+    if (url.pathname === '/api/argent-erp/health') {
+      const erpTools = erpToolCount()
+      return json(res, 200, {
+        ok: true, version: pkgVersion(),
+        erpTools,                                   // 0 ⇒ 只装了本插件、没装 @whyshu/argent
+        officePreset: 'argent-office',              // 本插件声明的办公室角色 preset id
+        clientPingAt: CLIENT_PING.at, clientUa: CLIENT_PING.ua,
+        viewPingAt: VIEW_PING.at, viewUa: VIEW_PING.ua,
+      })
+    }
+    if (url.pathname === '/api/argent-erp/ping') {
+      const at = new Date().toISOString()
+      const ua = String((req.headers && req.headers['user-agent']) || '').slice(0, 80)
+      if (url.searchParams.get('from') === 'view') Object.assign(VIEW_PING, { at, ua })
+      else Object.assign(CLIENT_PING, { at, ua })
+      return json(res, 200, { ok: true })
+    }
+    if (url.pathname === '/api/argent-erp/whoami') return json(res, 200, { ok: true, data: await whoami() })
+    if (url.pathname === '/api/argent-erp/overview') return json(res, 200, { ok: true, data: await overview(tenant) })
+    if (url.pathname === '/api/argent-erp/badge') return json(res, 200, { ok: true, data: await badge(tenant) })
+    if (url.pathname === '/api/argent-erp/timeline') {
+      return json(res, 200, { ok: true, data: await timeline(tenant, { days: url.searchParams.get('days') || 30 }) })
+    }
+    if (url.pathname === '/api/argent-erp/flow') {
+      return json(res, 200, { ok: true, data: await flowDetail(tenant, url.searchParams.get('id') || '') })
+    }
+    if (url.pathname === '/api/argent-erp/case') {
+      return json(res, 200, { ok: true, data: await caseDetail(tenant, url.searchParams.get('id') || '') })
+    }
+    if (url.pathname === '/api/argent-erp/shipment') {
+      return json(res, 200, { ok: true, data: await shipmentDetail(tenant, url.searchParams.get('recordId') || '') })
+    }
+    if (url.pathname === '/api/argent-erp/shipments') {
+      return json(res, 200, { ok: true, data: await shipments(tenant, { q: url.searchParams.get('q') || '', limit: url.searchParams.get('limit') || 20 }) })
+    }
+    if (url.pathname === '/api/argent-erp/chat/sessions') {
+      return json(res, 200, { ok: true, data: await chatSessions(tenant, { limit: url.searchParams.get('limit') || 20 }) })
+    }
+    if (url.pathname === '/api/argent-erp/chat/session') {
+      return json(res, 200, { ok: true, data: await chatSession(tenant, url.searchParams.get('id') || '') })
+    }
+    return json(res, 404, { ok: false, error: 'not_found' })
+  } catch (e) {
+    const code = e instanceof ErpError ? e.code : 'error'
+    const status = e instanceof ErpError && e.status ? e.status : 502
+    return json(res, status, { ok: false, error: code, message: String(e.message || e).slice(0, 200) })
+  }
+}
+
+export function apply(ctx) {
+  // ⛔ 永不抛出：插件激活失败会让整个 web boot 报 "entry did not activate"（2026-11-04 实测）。
+  try {
+    HOST_CTX = ctx
+    if (!ctx || !ctx.webServer || typeof ctx.webServer.register !== 'function') {
+      console.error('[argent-erp] 未拿到 webServer 服务，跳过端点注册（视图会显示 404，但 dsh 正常启动）')
+      return
+    }
+    ctx.effect(() => ctx.webServer.register({ kind: 'prefix', path: '/api/argent-erp', handler: handle }), 'argent-erp: read-only endpoints')
+    console.log(`[argent-erp] 已注册 /api/argent-erp/*（v${pkgVersion()}，只读，账号 token 仅在宿主侧使用）`)
+  } catch (e) {
+    console.error('[argent-erp] 端点注册失败（不影响 dsh 其他功能）:', e?.message || e)
+  }
+}

package/src/office-guard.js

@@ -0,0 +1,105 @@
+/**
+ * argent-office-guard · 办公室会话的**工具边界**（preset 内挂载）
+ *
+ * 为什么要它：dsh 的"全局工具"对所有会话可见（MCP 网关、Agent Team 等都由 host 层注册）。
+ * 「只聊办公室」如果只写在提示词里，模型一旦被诱导仍可能去调本机/其它能力。
+ * 这里用 `ctx.tools.restrict({ allow })` 把**本 preset 作用域**内可见的全局工具收敛成
+ * 只有 ERP 只读工具（`mcp__argent__erp_*`）——其余一律不可见（工具列表里根本没有）。
+ * 没有 ERP 工具时（客户只装了本插件、没装 @whyshu/argent）⇒ 用 `deny` 全禁，**不**退回"全部可用"。
+ *
+ * 红线：
+ *  - ⛔ 永不抛出：本行若激活失败，整个 preset 不可用（DSH 的 preset 激活是原子的）。
+ *  - ⛔ 不写死工具名：MCP 工具名带服务端后缀（如 `_db43c747eef4`），按前缀匹配、运行时重算。
+ *  - ⛔ 无循环：allow 集合从**全局视图**（`ctx.tools.definitions()` 不带 scope）计算，
+ *    该视图不受本作用域 mask 影响；集合不变则不再重新注册。
+ */
+export const name = 'argent-office-guard'
+export const inject = ['tools']
+
+/** 只放行 ERP 只读工具。MCP 命名：`mcp__<server>__<tool>[_<serverSuffix>]`。 */
+export const ERP_TOOL_PREFIX = 'mcp__argent__erp_'
+
+/**
+ * 从**全局**工具名里挑出 ERP 只读工具（纯函数，可单测）。
+ * 为什么要按前缀而不是写死名单：MCP 工具名带服务端后缀（`_db43c747eef4`），会随服务端配置变。
+ * @param {string[]} names - `ctx.tools.definitions()` 的 name 集合（全局视图）
+ * @returns {string[]} 排序后的允许列表；空数组表示 MCP 还没注册
+ */
+export function filterErpTools(names) {
+  return (Array.isArray(names) ? names : [])
+    .map((n) => String(n || ''))
+    .filter((n) => n.startsWith(ERP_TOOL_PREFIX))
+    .sort()
+}
+
+export function apply(ctx) {
+  try {
+    let disposeMask = null
+    let lastMask = ''
+    /**
+     * 重入闸（2026-11-08 修）：`ctx.tools.restrict()` 与它的 disposer **都会同步 emit
+     * `tools/change`**（见 dsh-scope `ScopedLayers.effect` 的两处 onChange）。
+     * 第一次收敛之后才出现的全局工具（典型：MCP 网关在启动后几秒才注册
+     * `mcp__argent__erp_*`）会让本函数在「dispose 旧 mask → restrict 新 mask」中途被
+     * 同步回调重入；此时 `lastMask` 还没更新 ⇒ 每层都判定"集合变了" ⇒ 无限同步递归
+     * （主线程 100% CPU + 堆 OOM，dsh 端口 bound 但 HTTP 不再响应）。
+     * 判据：工具名集合没变就只允许一个 reconcile 在跑；本函数自己触发的变化只记 dirty，
+     * 等这一轮收敛完再补一轮（保证真有新工具时不会漏收敛）。
+     */
+    let reconciling = false
+    let dirty = false
+
+    /** 收敛一轮：按当前全局工具名重算并换 mask。 */
+    const applyMask = () => {
+      // 全局视图（不传 scope）⇒ 拿到的是"未收敛"的全量工具，不受本作用域 mask 影响
+      const all = typeof ctx.tools?.definitions === 'function' ? ctx.tools.definitions() : []
+      const names = all.map((d) => (d && d.name) || '')
+      const allow = filterErpTools(names)
+      // 有 ERP 工具 ⇒ 只放行它们；一个都没有（没装 @whyshu/argent / MCP 未起）⇒ **全部禁掉**，
+      // 宁可这个会话无工具，也不让 Agent Team 等全局工具漏进来（边界优先）。
+      const mask = allow.length ? { allow } : (names.length ? { deny: names } : null)
+      if (!mask) return
+      const key = JSON.stringify(mask)
+      if (key === lastMask) return
+      // 先记账再动 mask：restrict/它的 disposer 同步 emit 时，重入会被闸挡住且只标 dirty；
+      // 即便真漏进来一次，key 也已是最新值，不会再次判定"集合变了"。
+      lastMask = key
+      try { disposeMask?.() } catch { /* noop */ }
+      disposeMask = ctx.tools.restrict(mask)
+      console.log(allow.length
+        ? `[argent-office] 工具边界：仅放行 ${allow.length} 个 ERP 只读工具`
+        : '[argent-office] 工具边界：未发现 ERP 工具 ⇒ 全部工具禁用（检查 @whyshu/argent 是否安装）')
+    }
+
+    const reconcile = () => {
+      if (reconciling) { dirty = true; return }
+      reconciling = true
+      try {
+        // 最多补 20 轮：只有"收敛过程中又出现了新工具"才会再来一轮，正常情况 1 轮结束
+        for (let round = 0; round < 20; round++) {
+          dirty = false
+          applyMask()
+          if (!dirty) break
+        }
+      } catch (e) {
+        // 收敛失败不阻塞会话：提示词仍然是第二道边界；清掉 key 让下一次工具变化时重试
+        lastMask = ''
+        console.warn('[argent-office] 工具边界收敛失败（继续按提示词边界运行）:', (e && e.message) || e)
+      } finally {
+        reconciling = false
+      }
+    }
+
+    ctx.effect(() => {
+      reconcile()
+      let off = null
+      try { off = ctx.on('tools/change', reconcile) } catch { /* 没有事件服务就只做一次 */ }
+      return () => {
+        try { off?.() } catch { /* noop */ }
+        try { disposeMask?.() } catch { /* noop */ }
+      }
+    }, 'argent-office: ERP-only tool mask')
+  } catch (e) {
+    console.warn('[argent-office] guard 挂载失败（不影响会话，提示词边界仍生效）:', (e && e.message) || e)
+  }
+}