@whyshu/argent-erp 0.2.3 → 0.3.0

package/README.md

@@ -1,9 +1,9 @@
-# @whyshu/argent-erp（v0.2.0）
+# @whyshu/argent-erp（v0.3.0）
 
 **两件东西，一个货**：
 
-1. **DSH 会话视图插件**：会话顶部 Chat / 轨迹 旁加一个「ERP」tab，把 Argent ERP 的
-   办公室现场 / 待办 / 时间线 / 货件 / 聊一聊入口渲染进 dsh，看 ERP 不用离开当前会话；
+1. **左侧栏 ERP 入口 + 主视图面板**：侧栏多一个「ERP」图标，点一下主视图（会话区）整页切到 ERP——
+   办公室现场 / 待办 / 时间线 / 货件 / 聊一聊；点会话行或面板里的「← 会话」即可回到对话；
 2. **「六禾园办公室助理」preset**：让「和办公室聊一聊」变成一个**真正的 dsh 会话**
    （原生 Chat，含轨迹/统计/中断），但**边界写死在 preset 里**——只聊办公室、只读 ERP、无本机能力。
 
@@ -18,31 +18,40 @@ src/data.mjs              数据层：whoami / overview / timeline / flow / ship
 src/office-guard.js       办公室会话的**工具边界**（preset 内挂载：只放行 mcp__argent__erp_*）
 src/vendor/               account-token.mjs + redact.mjs 的**副本**（插件可发布，不能相对 import core/lib）
 presets/argent-office.patch.yml   「六禾园办公室助理」preset 声明行（dsh 0.2.x 行式 preset）
-dist/client.js            客户端 bundle（手写维护）：注册 conversation.view（id=erp）+ 视图实现
+dist/client.js            客户端 bundle（手写维护）：注册 sidebar.panellist（id=erp，图标）+ main（key=erp，面板）
 test/                     客户端 bundle + preset 边界冒烟测试（纯夹具，不启 dsh、不联网）
 ```
 
 `package.json#dsh.bundle.patch` 是**数组**：`[cordis.patch.yml, presets/argent-office.patch.yml]`
 ⇒ 一次 `install_bundle` 同时落「ERP 视图」与「办公室助理 preset」。
 
-## 2. 它是「会话视图」而不是「侧栏面板」
+## 2. 它是「左侧栏入口 + 主视图面板」，不是会话 tab、也不是右侧栏
 
-dsh 0.2.x 的 `conversation.view` 槽 = 对话顶部那排 **Chat / 轨迹 / 统计** 的注册位。
-本插件向该槽注册一项：
+dsh 0.2.x 的两项原生扩展点（`dsh-client-ui-sidebar` / `dsh-client-ui-layout`）：
+
+- `sidebar.panellist`：左侧栏那排**全局面板图标**（插件、定时任务…）；列表条目的 `id` 就是"对应哪个主视图"；
+- `main`（keyed）：主视图区，`activePanelId` 命中哪个 key 就渲染哪个；`null` = 显示对话。
+
+本插件注册两项，**id 与 key 必须相同**：
 
 ```js
-ctx.slots.inject("conversation.view", () => ctx.slots.register({
-  name: "conversation.view",
-  id: "erp",
-  order: 5,                 // Chat=0，本视图=5，轨迹=10
-  label: () => "ERP",
-  inject: () => ({ sessions, workspaceNav, remote }),   // 建会话 / 跳转 / 钉模型
+// ① 左侧栏图标（owner props: { size, active }）
+ctx.slots.inject("sidebar.panellist", () => ctx.slots.register({
+  name: "sidebar.panellist", id: "erp", order: 15, label: () => "ERP",
+}, ErpIcon))
+
+// ② 主视图面板（root 作用域：没有 Session 绑定）
+ctx.slots.inject("main", () => ctx.slots.register({
+  name: "main", key: "erp",
+  inject: () => ({ sessions, workspaceNav, remote, closePanel }),  // 给「聊一聊」建会话 / 返回按钮用
 }, ErpView))
 ```
 
-- 纯 UI 视图**不需要**注册 `ctx.uiConversation.views.register({ target })`
-  —— 那个 registry 是"消费 Session 事件"的 target 才需要的；ERP 视图读的是自己的宿主端点。
-- 视图随会话存在：切会话 → 视图重挂；切 tab 不丢别的 tab 状态。
+- 点击侧栏图标由 sidebar 调 `ctx.layout.selectPanel("erp")`；点任意会话行由 workspace 调
+  `selectPanel(null)` 回到对话；面板内再给一个「← 会话」按钮（同样走 `selectPanel(null)`）。
+- 主视图面板是 **root 作用域**（没有 `sessionId`）："在哪个 workspace 建办公室会话"取
+  `useWorkspaces` 的第 1 个 workspace（有当前会话时优先当前会话所属 workspace）。
+- 面板只在被选中时挂载 ⇒ 轮询/请求随关闭自动停。
 
 ## 3. 视图内容
 
@@ -117,7 +126,7 @@ ERP 网页里那个「办公室聊一聊」**保持原样**（服务端 SSE +
 
 | 路径 | 作用 |
 |---|---|
-| `/api/argent-erp/health` | 存活 + 版本 + `erpTools`（ERP 工具数；0=缺 @whyshu/argent）+ `officePreset` + `clientPingAt`（bundle 加载）/ `viewPingAt`（视图渲染）|
+| `/api/argent-erp/health` | 存活 + 版本 + `erpTools`（ERP 工具数；0=缺 @whyshu/argent）+ `officePreset` + `clientPingAt`（bundle 加载）/ `viewPingAt`（面板打开/渲染）|
 | `/api/argent-erp/whoami` | 账号 + 租户列表 + 默认租户 |
 | `/api/argent-erp/overview?tenant=` | 办公室现场（KPI/在岗/执行机/待办 20/动态 10，脱敏） |
 | `/api/argent-erp/timeline?tenant=&days=` | 时间线（`/sku-flows`，按天分组） |
@@ -142,7 +151,7 @@ dsh 设置 → 插件（Plugins）→ 安装 bundle → @whyshu/argent-erp
 ```
 
 - 装完**重启 dsh**（bundle patch 的宿主行与 preset 行在启动时装配）；
-- 之后新建会话的 **preset 选择器**里会出现「六禾园办公室助理」，对话顶部出现「ERP」tab；
+- 之后**左侧栏出现「ERP」图标**（点击切主视图），新建会话的 **preset 选择器**里出现「六禾园办公室助理」；
 - ⚠️ **同机需要 `@whyshu/argent`**（≥0.2.0）：它提供 `mcp__argent__erp_*` 工具与 `whyshu` provider。
   缺它时插件仍能装、视图仍能看（端点会报 no_token），但办公室角色会被 `office-guard` **安全降级为无工具**；
   宿主 `/api/argent-erp/health` 的 `erpTools` 会返回 `0`（= 没有 ERP 工具），`-1` = 读不到 tools 服务。
@@ -159,9 +168,11 @@ curl -s http://127.0.0.1:3080/api/argent-erp/health      # {"ok":true,"version":
 # 3) preset 行是否落了（应含 include:preset-argent-office）
 #    cordis_inspect_query host/Config/listConfigs name='@deepseek-ai/dsh-agent-preset'
 
-# 4) 客户端 tab 是否注册
-#    cordis_inspect_query client/Slots/listSubTree root='conversation.view'
-#    ⇒ occupants 含 { registrant: "argent-erp-client", id: "erp", order: 5, active: true }
+# 4) 客户端两处注册
+#    cordis_inspect_query client/Slots/listSubTree root='sidebar.panellist'
+#    ⇒ occupants 含 { registrant: "argent-erp-client", id: "erp", order: 15, active: true }
+#    cordis_inspect_query client/Slots/listSubTree root='main'
+#    ⇒ occupants 含 { registrant: "argent-erp-client", key: "erp", active: true }
 
 # 5) 单测（15 项，含 preset 边界断言）
 node plugins/argent-erp/test/client-bundle.test.mjs

package/dist/client.js

@@ -1,10 +1,12 @@
 /**
  * argent-erp · 客户端（dsh browser bundle 格式，**手写维护**）
  *
- * 形态：一个 `conversation.view` tab（对话顶部的 Chat / 轨迹 / **ERP** 切换项），
+ * 形态：**左侧栏一个「ERP」图标**（`sidebar.panellist`，id=erp）+ **主视图面板**（`main`，key=erp）——
+ * 点侧栏图标，主视图（会话区）切到 ERP；点会话行或面板里的「← 会话」回到对话。
  * 渲染 ERP 的只读视图：办公室现场 / 待办 / 时间线 / 货件 / 聊一聊。
  *
- * 为什么不是侧栏面板：会话视图与"正在做的那一单"同屏——看 ERP 不用离开会话。
+ * 为什么不是右侧栏：ERP 是"一整页工作台"（KPI/待办/时间线/货件/聊天入口），塞进窄侧栏只能看数字；
+ * 主视图面板能给它完整宽度，同时左侧栏一点就回来，不打断会话。
  *
  * 数据全部来自宿主端点 `/api/argent-erp/*`（token 在宿主侧，浏览器拿不到）。
  * ⛔ 不做写操作；重编辑一律跳 ERP web。
@@ -521,7 +523,7 @@ window.__ModuleLoader__.load({
       const [tenant, setTenant] = React.useState("")
       const [detail, setDetail] = React.useState(null) // { kind:'flow'|'shipment', id }
       const [nonce, setNonce] = React.useState(0)     // 刷新时让各自取数的面板重挂
-      // 渲染信标：只有切到 ERP tab 才会打 ⇒ /health 的 viewPingAt 能证明"真的渲染了"
+      // 渲染信标：只有打开 ERP 面板才会打 ⇒ /health 的 viewPingAt 能证明"真的渲染了"
       React.useEffect(() => { try { fetch(API + "/ping?from=view") } catch { /* noop */ } }, [])
       const who = useApi("/whoami")
       const health = useApi("/health")
@@ -556,6 +558,12 @@ window.__ModuleLoader__.load({
 
       return h("div", { className: "aerp-root" },
         h("div", { className: "aerp-head" },
+          props && typeof props.closePanel === "function"
+            ? h("button", {
+                type: "button", className: "aerp-btn", title: "回到会话",
+                onClick: () => { try { props.closePanel() } catch { /* noop */ } },
+              }, "← 会话")
+            : null,
           h("span", { className: "aerp-title" }, "Argent ERP"),
           tenants.length > 1
             ? h("select", {
@@ -581,26 +589,60 @@ window.__ModuleLoader__.load({
     const name = "argent-erp-client"
     const inject = ["slots"]
 
+    /** 侧栏入口 id 与主视图面板 key 必须一致（sidebar 用 id 去 main 槽取面板） */
+    const PANEL_ID = "erp"
+
+    /** 左侧栏「ERP」图标（owner props: { size, active }；用 currentColor，跟随主题） */
+    function ErpIcon(props) {
+      const size = (props && props.size) || 16
+      const active = Boolean(props && props.active)
+      const color = active ? "var(--dsw-alias-brand-primary)" : "currentColor"
+      return h("svg", {
+        width: size, height: size, viewBox: "0 0 24 24", fill: "none",
+        stroke: color, strokeWidth: 1.6, strokeLinecap: "round", strokeLinejoin: "round",
+        style: { display: "block" }, "aria-hidden": "true", focusable: "false",
+      },
+      h("path", { d: "M3.6 9.6 5.3 4.3h13.4l1.7 5.3" }),
+      h("path", { d: "M4.3 9.6h15.4v9.1a1.3 1.3 0 0 1-1.3 1.3H5.6a1.3 1.3 0 0 1-1.3-1.3V9.6Z" }),
+      h("path", { d: "M9.4 20v-4.7h5.2V20" }))
+    }
+
+    /** 取服务；没有/未注入时返回 undefined（动态插件 ctx 的白名单可能不含某个服务） */
+    const getService = (ctx, name) => { try { return ctx.get(name) } catch { return undefined } }
+
     function apply(ctx) {
       injectCss()
       // 自检信标：宿主 /health 会回报 clientPingAt ⇒ 能区分"bundle 没加载"与"加载了但没显示"
       try { fetch(API + "/ping?from=client").catch(() => {}) } catch { /* noop */ }
 
-      // ⛔ 永不抛出：注册失败只影响这个 tab，不能让 web boot 报 "entry did not activate"
+      // ⛔ 永不抛出：注册失败只影响 ERP 入口，不能让 web boot 报 "entry did not activate"
+
+      // ① 左侧栏入口（图标按钮）：点击后 sidebar 调 ctx.layout.selectPanel('erp') 切主视图
       try {
-        ctx.slots.inject("conversation.view", () => ctx.slots.register({
-          name: "conversation.view",
-          id: "erp",
-          order: 5,
+        ctx.slots.inject("sidebar.panellist", () => ctx.slots.register({
+          name: "sidebar.panellist",
+          id: PANEL_ID,
+          order: 15,
           label: () => "ERP",
+        }, ErpIcon))
+      } catch (e) {
+        console.warn("[argent-erp] 侧栏入口注册失败（不影响 dsh）:", (e && e.message) || e)
+      }
+
+      // ② 主视图面板：key 与侧栏 id 相同；root 作用域（没有 Session 绑定）
+      try {
+        ctx.slots.inject("main", () => ctx.slots.register({
+          name: "main",
+          key: PANEL_ID,
           inject: () => ({
-            sessions: (() => { try { return ctx.get("sessions") } catch { return undefined } })(),
-            workspaceNav: (() => { try { return ctx.get("uiWorkspace") } catch { return undefined } })(),
-            remote: (() => { try { return ctx.get("remote") } catch { return undefined } })(),
+            sessions: getService(ctx, "sessions"),
+            workspaceNav: getService(ctx, "uiWorkspace"),
+            remote: getService(ctx, "remote"),
+            closePanel: () => { try { getService(ctx, "layout")?.selectPanel?.(null) } catch { /* noop */ } },
           }),
         }, ErpView))
       } catch (e) {
-        console.warn("[argent-erp] conversation.view 注册失败（不影响 dsh）:", (e && e.message) || e)
+        console.warn("[argent-erp] 主视图面板注册失败（不影响 dsh）:", (e && e.message) || e)
       }
     }
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@whyshu/argent-erp",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "type": "module",
-  "description": "Argent ERP 会话视图（dsh conversation.view）+ 六禾园办公室助理 preset（只聊办公室、只读 ERP）+ 办公室聊一聊入口",
+  "description": "Argent ERP 左侧栏入口 + 主视图面板（dsh sidebar.panellist/main）+ 六禾园办公室助理 preset + 办公室聊一聊",
   "keywords": [
     "dsh",
     "deepseek-harness",