dsh-plugin-opc 0.1.25 → 0.1.27

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (31) hide show
  1. package/README.md +98 -165
  2. package/config/overlay.example.yml +1 -1
  3. package/docs/images/workbench/01-plugins.jpg +0 -0
  4. package/docs/images/workbench/02-install-menu.jpg +0 -0
  5. package/docs/images/workbench/03-install-package.jpg +0 -0
  6. package/docs/images/workbench/04-install-result.jpg +0 -0
  7. package/docs/images/workbench/05-plugin-enabled.jpg +0 -0
  8. package/docs/images/workbench/06-open-sidebar.jpg +0 -0
  9. package/docs/images/workbench/07-workbench-entry.jpg +0 -0
  10. package/docs/images/workbench/08-workbench-home.jpg +0 -0
  11. package/docs/images/workbench/09-platform-gateway.jpg +0 -0
  12. package/docs/images/workbench/10-switch-module.jpg +0 -0
  13. package/docs/images/workbench/11-knowledge-search.jpg +0 -0
  14. package/docs/images/workbench/12-knowledge-catalog.jpg +0 -0
  15. package/docs/images/workbench/13-knowledge-query-result.jpg +0 -0
  16. package/docs/images/workbench/14-skills.jpg +0 -0
  17. package/docs/images/workbench/15-mcp.jpg +0 -0
  18. package/docs/images/workbench/16-app-source.jpg +0 -0
  19. package/docs/images/workbench/17-app-platform-login.jpg +0 -0
  20. package/docs/images/workbench/18-app-source-selected.jpg +0 -0
  21. package/docs/images/workbench/19-app-analysis.jpg +0 -0
  22. package/docs/images/workbench/20-app-review-waiting.jpg +0 -0
  23. package/docs/images/workbench/21-app-package-ready.jpg +0 -0
  24. package/docs/images/workbench/22-app-deploy-review.jpg +0 -0
  25. package/docs/images/workbench/23-app-building.jpg +0 -0
  26. package/docs/images/workbench/24-app-verification.jpg +0 -0
  27. package/docs/images/workbench/25-app-login-page.jpg +0 -0
  28. package/lib/client.js +38 -19
  29. package/lib/index.js +37 -9
  30. package/package.json +2 -1
  31. package/runtime/app_delivery_migration.py +1 -1
package/README.md CHANGED
@@ -1,247 +1,180 @@
1
1
  # OPC 插件新手上手指南
2
2
 
3
- 把公司的知识库、技能和业务工具放进 DeepSeek Harness(下文简称 **DSH**)。安装后,点右侧的 **OPC 知识库 / OPC 技能 / OPC MCP** 就能开始。
3
+ 通过 DeepSeek Harness(DSH)安装 `dsh-plugin-opc`,在右侧打开 **OPC 工作台**,即可进入企业知识库、技能、MCP 和应用。首次使用按 **安装插件 → 打开工作台 → 配置网关 → 企业登录 → 选择空间** 的顺序操作。
4
4
 
5
- **第一次使用,建议先完成“安装 → 找到入口 → 登录 → 用知识库问一个问题”。** 技能和 MCP 可以之后再看。本文图片取自本机 DSH Desktop `0.2.2-rc.1`、OPC 插件 `0.1.4`,摄于 2026-11-06。全部配图保留完整的 DSH 客户端窗口,可点击图片查看大图。截图中的账号、公司空间、资源名称用于演示,你的列表以公司授权为准。
5
+ 本文配图于 2026-11-19 从 DeepSeek Harness 桌面客户端采集。安装示例使用 OPC 插件 `0.1.23`,应用部署示例使用 `0.1.26`。企业空间和资源列表以当前账号的授权为准。
6
6
 
7
- ## 先知道这三个功能是做什么的
8
-
9
- | 功能 | 用一句话理解 | 可以先试什么 |
10
- | --- | --- | --- |
11
- | **OPC 知识库** | 让 AI 查公司文档,再根据文档回答 | 报销材料、制度、流程、操作手册 |
12
- | **OPC 技能** | 给 AI 装一份特定任务的操作说明 | 比较两张 Excel 表有哪些差异 |
13
- | **OPC MCP** | 让 AI 通过公司提供的工具查询业务系统 | 根据商品内部 ID 查询价格,取决于公司开放的服务 |
14
-
15
- 知识库回答来自文档,实时商品价格来自业务系统。MCP 能否查询成功还取决于服务权限、参数和平台配置。
16
-
17
- ## 一、安装插件
18
-
19
- ### 第 1 步:打开「插件」页
20
-
21
- 打开 DSH,在窗口左侧点 **插件**。右上角可以看到黑色的 **添加插件** 按钮。
22
-
23
- ![第1步:左侧选择插件,右上角找到添加插件](docs/images/01-plugins.png)
24
-
25
- **已经装过?** 向下滚动,找 **已安装插件**。如果已有 `@opc/dsh-plugin-opc`,先看第 4 步核对版本和启用状态,避免反复安装同一版本。
26
-
27
- ### 第 2 步:选择「安装第三方插件」
28
-
29
- 点 **添加插件右边的小向下箭头**,在菜单中点 **安装第三方插件**。有些版本直接点击“添加插件”也会打开同一个窗口。
30
-
31
- ![第2步:在添加插件菜单中选择安装第三方插件](docs/images/02-install-menu.png)
32
-
33
- ### 第 3 步:输入包名,点「安装」
34
-
35
- 在弹出窗口的 **包名或地址** 输入框里直接输入 npm 包名(推荐),然后点底部黑色的 **安装**:
36
-
37
- ```text
38
- dsh-plugin-opc
39
- ```
40
-
41
- > 也可以通过 Git 地址安装:`https://github.com/shtokendance/dsh-plugin-opc.git#release`。但通过 npm 包名安装可在后续享受 DSH 内置的一键自动检测和在线更新功能。
42
-
43
- ![第3步:把包名输入框,点击底部安装](docs/images/03-install-address.png)
44
-
45
- 等待安装任务结束。网络慢时会花更长时间,可以展开 **查看安装详情** 查看进度。
46
-
47
- ### 第 4 步:确认装好了,再完整重启
48
-
49
- 回到 **插件 → 已安装插件**,找到并点击 `dsh-plugin-opc`。详细页应显示版本号,右上角的启用开关应处于打开状态。
50
-
51
- ![第4步:详细页显示插件名称、版本号和启用开关](docs/images/04-installed.png)
52
-
53
- 安装或更新后,**完整退出 DSH,再重新打开**。Mac 上可在屏幕最上方的 **DeepSeek Harness → 退出 DeepSeek Harness** 操作,或按 `⌘ Q`。只点窗口左上角红色圆点可能仅关闭窗口。
54
-
55
- ### 插件后续如何在线更新?
56
-
57
- 通过包名 `dsh-plugin-opc` 安装后,当有新版本发布时:
58
- 1. 打开 DSH 左侧 **插件** 页面。
59
- 2. 点击右上角的 **刷新** 按钮。
60
- 3. 如果有新版本,插件卡片及详情页右上角将直接亮起蓝色的 **【更新到 vX.X.X】** 按钮。
61
- 4. 点击更新按钮即可由客户端自动完成静默替换升级,**无需每次卸载重装**。
62
-
63
- > 本次截图时,本机已经装有同版本。重复安装任务显示“无法从依赖变更中确定安装了哪一个包”,随后在详细页核对到插件 `0.1.4` 已启用。首次安装成功请以任务结果、已安装列表和实际功能入口一起判断。遇到相同提示先核对版本,暂时无需反复重试。
64
-
65
- ## 二、装完以后,到哪里找?
66
-
67
- ### 第 5 步:进入聊天页,打开右侧栏
7
+ | 模块 | 可以做什么 |
8
+ | --- | --- |
9
+ | 知识库 | 查找企业文档,或在对话中让 AI 根据文档回答 |
10
+ | 技能 | 查找、安装和调用已开放的技能 |
11
+ | MCP | 查看企业服务和工具,按权限查询业务数据 |
12
+ | 应用 | 查看已部署应用,或导入本地源码部署新应用 |
68
13
 
69
- 点左侧 **新会话**,再点 **窗口右上角靠边的小侧栏图标**。这是“打开右侧边栏”,鼠标停在上面会显示名称。图中鼠标所在处就是这个按钮。
14
+ ## 一、按包名安装插件
70
15
 
71
- ![第5步:新会话界面右上角的侧栏图标](docs/images/05-open-sidebar.png)
16
+ 1. 打开 DSH,点击左侧 **插件**,然后点击右上角 **添加插件** 旁的下拉箭头。
72
17
 
73
- ### 第 6 步:认准三个 OPC 入口
18
+ ![DSH 插件页和右上角的添加插件按钮](docs/images/workbench/01-plugins.jpg)
74
19
 
75
- 右侧出现 **开始** 页面后,选择你要使用的功能。建议第一次先点 **OPC 知识库**。
20
+ 2. 点击 **安装第三方插件**。
76
21
 
77
- ![第6步:开始页中的OPC知识库、OPC技能、OPC MCP三个入口](docs/images/06-opc-entries.png)
22
+ ![添加插件菜单中的安装第三方插件选项](docs/images/workbench/02-install-menu.jpg)
78
23
 
79
- 已经打开一个功能时,可以点右侧面板顶部的 **+(新标签页)** 回到入口页,再打开另一个功能。三个功能可各占一个标签页,直接点击标签切换。
24
+ 3. 在 **包名或地址** 输入 `dsh-plugin-opc`,确认 **安装源** 为 **npm 官方源**,点击 **安装**。
80
25
 
81
- ## 三、登录公司账号和选择空间
26
+ ![输入 dsh-plugin-opc,安装源为 npm 官方源](docs/images/workbench/03-install-package.jpg)
82
27
 
83
- ### 第 7 步:完成企业登录
28
+ 4. 等待弹窗显示 **已安装**,然后点击 **立即启用**。以结果弹窗中的版本为准。此次安装器显示新版仍在供应链观察期,按包名实际安装了 `0.1.23`。
84
29
 
85
- 第一次打开 OPC 面板,会看到 **连接 OPC 工作空间** 和 **企业微信 / SSO 登录** 按钮。
30
+ ![安装完成弹窗显示实际版本和立即启用按钮](docs/images/workbench/04-install-result.jpg)
86
31
 
87
- 1. 点击 **企业微信 / SSO 登录**。
88
- 2. 默认浏览器会打开公司的登录页面。按页面提示扫码或完成公司登录。
89
- 3. 登录完成后,回到 DSH。面板显示账号和公司空间,表示登录成功。
90
- 4. 如果浏览器被关掉,可点面板中的 **重新打开授权页**。
32
+ 5. 回到 **插件 → 已安装插件**,确认 `dsh-plugin-opc` 右侧开关已打开。已经装好的用户可在这里直接核对状态。有更新时,插件页会标记 **可更新**。
91
33
 
92
- 如果你已经登录,面板会直接显示资源列表,可继续下一步。DSH 自己的模型账号和 OPC 企业账号各自登录;聊天生成回答还需要 DSH 中有可用模型。
34
+ ![已安装插件列表中 dsh-plugin-opc 的启用开关](docs/images/workbench/05-plugin-enabled.jpg)
93
35
 
94
- ### 第 8 步:选择有资源的企业空间
36
+ ## 二、打开 OPC 工作台
95
37
 
96
- 面板上方的下拉框用于选择企业空间,例如 **本来生活**、**技术交付中心**。切换后,知识库、技能和 MCP 列表随之更新。没有资源时先确认选对了空间,再联系公司管理员核对授权。
38
+ 1. 点击左侧 **新会话**,再点客户端右上角的 **打开右侧边栏** 图标。
97
39
 
98
- ![第8步:OPC面板顶部选择空间,下方查看当前空间的资源](docs/images/07-space-and-knowledge.png)
40
+ ![新会话右上角的右侧边栏入口](docs/images/workbench/06-open-sidebar.jpg)
99
41
 
100
- ## 四、先试一个最简单的知识库问题
42
+ 2. 在右侧 **开始** 页点击 **OPC 工作台**。右栏已有该标签时,直接点击 **OPC 工作台** 标签。
101
43
 
102
- ### 第 9 步:在聊天框输入 @ 和库名
44
+ ![右侧开始页中的 OPC 工作台入口](docs/images/workbench/07-workbench-entry.jpg)
103
45
 
104
- 点击**聊天输入框**,先输入 `@`,再输入你知道的库名,例如 `财务`。出现菜单后,点击 **OPC 知识库** 分组里的 **财务制度与SOP**。如果你的公司使用其他名称,就输入那个名称。
46
+ ## 三、配置正式网关并登录
105
47
 
106
- ![第9步:输入@财务后,点击OPC知识库分组中的候选](docs/images/10-mention-menu.png)
48
+ 1. 在 OPC 工作台点右上角 **设置**。如果还没登录,也可以点登录页上的 **平台设置**。
49
+ 2. 在 **统一平台网关** 下,把 **网关服务地址 (Platform Base)** 填为 `https://aiwork.benlai.com`。
50
+ 3. 点击 **测试连接**。看到 **连接成功(HTTP 200)** 后,点击 **保存并立即生效**,再点 **返回**。
107
51
 
108
- ### 第 10 步:选中后,继续写问题,点蓝色发送箭头
52
+ ![正式网关地址、连接测试结果和保存按钮](docs/images/workbench/09-platform-gateway.jpg)
109
53
 
110
- 选中库后,输入框会出现库名引用。**保留这段引用,在后面写问题**。可以复制这句作为第一次练习:
54
+ 4. 显示 **连接 OPC 工作空间** 时,点击 **企业微信 / SSO 登录**,在浏览器完成授权后回到 DSH。浏览器关闭时,可点 **重新打开授权页**。如果切换了平台网关,使用新平台的账号重新登录。
111
55
 
112
- > 请告诉我差旅报销需要准备哪些材料,并列出依据文档的名称。
56
+ ![OPC 工作台登录入口及当前正式网关](docs/images/workbench/17-app-platform-login.jpg)
113
57
 
114
- 然后点输入框**右下角的蓝色向上箭头**。
58
+ 5. 登录后,从工作台首页进入 **知识库、技能、MCP** 或 **应用**。点击面板左上角的 **当前模块名称及下拉箭头**,可以在同一个标签页内切换模块或返回首页。
115
59
 
116
- ![第10步:引用后面填写问题,右下角蓝色箭头发送](docs/images/11-mention-question.png)
60
+ ![OPC 工作台首页的四个模块入口](docs/images/workbench/08-workbench-home.jpg)
117
61
 
118
- ### 第 11 步:看回答,也看依据文档
62
+ ![展开 OPC 工作台左上角的模块切换菜单](docs/images/workbench/10-switch-module.jpg)
119
63
 
120
- 等待 AI 回答。它会先检索文档,再读取相关内容。建议第一次要求它列出来源文档,方便自己核对。
64
+ 6. 在知识库、技能或 MCP 页面,从右上角选择 **企业空间**。如列表未更新,点击 **刷新**。在 DSH 对话里提问时,还需要选择可用的模型,并按客户端提示完成模型登录。
121
65
 
122
- ![第11步:实际回答末尾列出了依据文档](docs/images/12-answer-sources.png)
66
+ ## 四、使用企业知识库
123
67
 
124
- 图中回答来自本次本机实测。你也可以展开对话里的 **已调用工具**,查看 `opc_knowledge_search`(检索)和 `opc_knowledge_read`(读取)的结果。
68
+ 从工作台首页或左上角菜单进入 **知识库**。
125
69
 
126
- **下一条还要查同一个库?** 再选一次 `@库名`。一次提问选择一个库。希望本会话持续固定在某个库时,在右侧点击该库的 **限定问答范围**;取消时点 **取消限定**。引用是本轮选择,面板固定是本会话的持续选择。
70
+ - **文档全文检索模式**用于找文档。选择检索范围,输入关键词,点击 **开始检索**。看到结果后点击文档标题,可打开正文。
71
+ - **知识库目录筛选模式**用于找库。按库名或描述筛选,在目标卡片上点击 **检索此库**,即可切回全文检索并选定该库。
127
72
 
128
- ## 五、自己查文档,不让 AI 总结
73
+ ![知识库全文检索模式及检索范围](docs/images/workbench/11-knowledge-search.jpg)
129
74
 
130
- ### 第 12 步:选库,填关键词,点击「检索」
75
+ ![按名称或描述筛选知识库目录](docs/images/workbench/12-knowledge-catalog.jpg)
131
76
 
132
- 在右侧 **OPC 知识库** 面板中,找到目标库,点 **检索此库**。下方的“检索知识库”会切换到该库。在 **输入要查找的内容** 框里填 `差旅` 等关键词,点旁边蓝色 **检索**。
77
+ 在 DSH 对话中使用知识库时,输入 `@` 和库名,在 **OPC 知识库** 候选中选中目标库,再继续输入问题。可试问「差旅报销需要准备哪些材料?请列出依据文档的名称」。如需让当前会话持续使用某个库,可在卡片上点 **限定问答范围**,使用完毕后点 **取消限定**。
133
78
 
134
- ![第12步:检索此库、关键词输入框和检索按钮的位置](docs/images/08-search-results.png)
79
+ 本次正式环境的测试账号没有可见知识库。在 **当前空间全部知识库** 下尝试检索「报销流程」,客户端显示 `INVALID_REQUEST`。
135
80
 
136
- 注意区分两个输入框:上面的 **按名称搜索** 用于找“库”,下面的 **输入要查找的内容** 用于查“库里的文档”。
81
+ ![本次测试账号的空目录与全文检索错误](docs/images/workbench/13-knowledge-query-result.jpg)
137
82
 
138
- ### 第 13 步:点击结果中的文档名,打开正文
83
+ ## 五、安装并使用技能
139
84
 
140
- 检索结果会显示文档名称和命中片段。点击**文档名按钮**,正文显示在面板下方;需要时在右侧面板内向下滚动。阅读结束,点击 **关闭正文**。
85
+ 1. 进入 **技能**,输入技能名称或关键词,点击 **立即检索**。可以用 **全部 / 已安装 / 未安装** 切换列表。
86
+ 2. 有可用技能时,在技能卡片点 **下载安装**,等待卡片显示 **已启用**。
87
+ 3. 回到 DSH 对话,输入 `/` 和技能名,从候选中选中它,再描述任务。例如安装了 `excel-compare` 后,输入 `/excel-compare`,上传两份表格并说明按哪一列比对。
141
88
 
142
- ![第13步:正文预览和关闭正文按钮](docs/images/09-document.png)
89
+ ![OPC 技能页的搜索框和安装状态筛选](docs/images/workbench/14-skills.jpg)
143
90
 
144
- ## 六、安装并使用一项技能
91
+ ## 六、查看并调用 MCP 工具
145
92
 
146
- 技能适合完成具体任务。第一次建议选 **excel-compare** 这样的表格比对技能。
93
+ 1. 进入 **MCP**,按服务或工具名称搜索。可用 **全部 / 已连接 / 未挂载** 筛选状态。
94
+ 2. 在可见服务的卡片上展开 **查看可用工具与调试**,核对工具名、用途和参数。选择已连接的只读工具做第一次查询。
95
+ 3. 在 DSH 对话里说明要用哪个服务、哪个工具以及查询条件。需要排查单个工具时,可展开 **在线调试调用**,按工具定义输入 JSON,再点 **调用**。查看工具返回中的业务数据或实际错误。若客户端弹出审批,先阅读操作和参数。
147
96
 
148
- ### 第 14 步:打开 OPC 技能,点击「下载安装」
97
+ ![OPC MCP 页的服务搜索和连接状态筛选](docs/images/workbench/15-mcp.jpg)
149
98
 
150
- 点面板顶部 **+ → OPC 技能**。在当前空间的列表里找到技能,先阅读用途说明,再点该技能下面的 **下载安装**。下图用尚未安装的 PPT 技能展示按钮位置;后两张图用已经安装的 excel-compare 展示启用和调用效果。
99
+ 如果需要显式调用 `opc_mcp_invoke`,应提供准确的 `service_id`、`tool_name` 和 `arguments`。缺少服务 ID 时,可以向平台管理员查询。
151
100
 
152
- ![第14步:完整客户端中未安装技能的下载安装按钮](docs/images/13-skills-install.png)
101
+ **本次验证范围**:正式网关返回 HTTP 200。在测试账号唯一可选的企业空间内,知识库、技能和 MCP 目录均显示 0 项。已操作三个模块的页面和检索入口,技能安装、MCP 工具调用和知识库问答需要有可见资源的账号才能继续验证。
153
102
 
154
- ### 第 15 步:确认显示「已启用」
103
+ ## 七、部署应用
155
104
 
156
- 安装完成后,技能下方应显示 **已启用 · 输入 / 调用**,操作按钮变为 **停用** 和 **卸载**。只安装一次即可,之后可反复使用。停用后能重新启用,卸载后需要重新下载。
105
+ 以下以 `supplier-audit-tech-handoff` 源码文件夹为例。配图来自 DeepSeek Harness 的 OPC 插件 `0.1.26`,平台网关为 `https://aiwork.benlai.com`,演示应用标识为 `supplier-audit-doc-demo`。请根据自己的应用填写名称和唯一标识。
157
106
 
158
- ![第15步:安装完成后的已启用状态和管理按钮](docs/images/14-skill-enabled.png)
107
+ ### 1. 选择应用和源码
159
108
 
160
- ### 第 16 步:回到聊天框,输入 / 和技能名
109
+ 在 **OPC 工作台 → 应用** 打开应用中心,点击 **新建应用**。填写应用名称和访问子域名,选择分析模型。选择 **源码文件夹** 或 **ZIP 压缩包**,也可输入本机完整路径。确认源码已选中,再点击 **创建并开始 AI 分析**。
161
110
 
162
- 输入 `/excel-compare`,在弹出的 **技能** 候选中选择 `excel-compare`。该菜单显示 `[OPC]`,帮助你识别公司技能。
111
+ ![新建并部署应用向导中的源码文件夹与 ZIP 入口](docs/images/workbench/16-app-source.jpg)
163
112
 
164
- ![第16步:聊天框输入斜杠唤起已安装技能](docs/images/15-skill-slash.png)
113
+ ![供应商审厂系统已选中本机源码,可以开始 AI 分析](docs/images/workbench/18-app-source-selected.jpg)
165
114
 
166
- 选择后,描述你的任务,例如:
115
+ ### 2. 与 AI 改造应用
167
116
 
168
- > 请按商品编码比对这两张 Excel,列出只在第一张表、只在第二张表和字段不同的记录。缺少文件时请先问我。
117
+ OPC 在独立源码副本上分析应用。左侧分析会话显示 AI 的进展,右侧向导显示导入、方案校验和交付包准备状态。需要补充业务要求时,在左侧分析会话回复。看到 **交付包已生成,可以核对部署内容** 后,点击 **下一步:核对部署内容**。
169
118
 
170
- 需要处理文件时,点击聊天输入框左下角 **+** 按 DSH 提示添加文件,并告诉 AI 比较哪一列。图中只演示技能安装和唤起,文件处理结果取决于实际文件与所选技能。
119
+ ![供应商审厂系统的源码副本已导入,AI 正在分析](docs/images/workbench/19-app-analysis.jpg)
171
120
 
172
- ## 七、MCP:查看公司业务系统提供了哪些工具
121
+ 如果页面显示 **有事项需要你决定**,先在左侧分析会话核对待确认项。例如,这份交接源码含开发演示账号,首次分析在确认管理员登录方式时暂停。部署演示应使用独立的账号配置,保留应用原有的权限检查。
173
122
 
174
- MCP 是公司开放给 AI 的业务工具入口,例如查商品价格。下面的步骤适合在管理员已提供服务 ID 和查询参数后使用。
123
+ ![供应商审厂系统首次分析停在管理员登录方式确认](docs/images/workbench/20-app-review-waiting.jpg)
175
124
 
176
- ### 第 17 步:打开 OPC MCP,选对空间
125
+ 本例重新导入清除了默认管理员的交付副本,通过了方案及交付包检查。应用所需的管理员可按需在运行配置中初始化。原始交接目录保留原样。
177
126
 
178
- 点右侧顶部 **+ → OPC MCP**。有些空间没有 MCP 服务,可以先切换到公司管理员指定的空间。本机示例在 **技术交付中心**,可见 **搜索服务** 和 **erp 商品价格服务**。
127
+ ![供应商审厂系统的交付包检查已完成](docs/images/workbench/21-app-package-ready.jpg)
179
128
 
180
- ![第17步:选择提供MCP服务的空间,查看服务列表](docs/images/16-mcp-list.png)
129
+ ### 3. 核对部署内容并发布
181
130
 
182
- ### 第 18 步:展开服务,阅读工具说明
131
+ 核对应用地址、容器端口、运行配置、数据卷和必填环境变量。带登录的应用应检查鉴权方式和初始账号来源。确认部署所需资源后,点击 **确认配置并发布上线**。
183
132
 
184
- 点击服务名前面的 **小三角**。下方会显示工具名、用途和参数。例如 `post_ProductPrice_Get` 的参数是 `productSysNo`,要求商品内部的整数 ID。
133
+ 本例使用 Node.js 20、容器端口 `8080` 和默认本地存储。`/app/data`、`/app/uploads`、`/app/reports` 和 `/app/backups` 分别挂载持久化卷。管理员初始化变量留空,部署时保持登录保护,受保护功能待单独验收。
185
134
 
186
- ![第18步:展开商品价格服务,查看工具名、参数和在线调试入口](docs/images/17-mcp-tool.png)
135
+ ![发布前核对供应商审厂系统的运行配置、端口和持久化卷](docs/images/workbench/22-app-deploy-review.jpg)
187
136
 
188
- ### 第 19 步:第一次使用,请先向管理员要这三项
137
+ ### 4. 查看部署和验证结果
189
138
 
190
- | 需要的信息 | 如何理解 |
191
- | --- | --- |
192
- | 服务 ID(service_id) | 平台里登记的准确服务标识,请管理员复制完整值 |
193
- | 工具名(tool_name) | 上图的 `post_ProductPrice_Get` 就是工具名 |
194
- | 必填参数 | 比如商品内部 ID,以工具说明为准 |
139
+ 在 **部署与使用** 查看构建、启动和验证进度,可展开 **查看服务器部署日志**。若页面显示 **应用已运行 · 技能待验证**,可检查业务验证错误,再按向导提示重试。纯页面应用按提示打开应用并确认页面可用。若出现 **带鉴权凭据重新验证**,填写该应用的测试账号或会话后点击 **仅重试业务验证**。
195
140
 
196
- 当前插件的聊天工具需要准确的服务 ID,面板没有显示这个字段,模型也没有服务目录查询工具。**请直接找管理员索要完整值**;只告诉 AI“商品中心”会使它缺少调用信息。
141
+ ![供应商审厂系统提交发布后,服务器正在构建镜像](docs/images/workbench/23-app-building.jpg)
197
142
 
198
- 拿到信息后,在聊天框发送下面的话,把 `实际服务ID` 替换成管理员给你的值:
143
+ 本例已发布 `v1`。服务器日志显示镜像构建成功,应用首页探测返回 HTTP 200,应用中心显示 **运行中**。在浏览器中可以打开登录页,应用自带的 `/api/health` 返回 `ok: true`。
199
144
 
200
- > 请使用 opc_mcp_invoke,service_id 为「实际服务ID」,tool_name 为 post_ProductPrice_Get,arguments 为 {"productSysNo":2427240}。查询商品价格,调用失败就显示实际错误,请不要猜测服务ID或工具名。
145
+ ![浏览器打开服务器上的供应商审厂系统登录页](docs/images/workbench/25-app-login-page.jpg)
201
146
 
202
- 其中 `2427240` 只是示例,请换成管理员确认的商品内部 ID。
147
+ 插件要求交付契约中的 `/healthz` 返回此应用的身份标识。本例通过部署域名访问 `/healthz` 时返回 `Not found`,向导显示 **应用健康身份验证失败** 和 **应用已运行 · 技能待验证**。实际验收完成到容器启动和登录页可访问,管理员登录、受保护业务接口和技能调用仍待验证。
203
148
 
204
- ### 第 20 步:如何判断查询有没有成功
149
+ ![服务器构建和启动成功,插件仍提示健康身份验证失败](docs/images/workbench/24-app-verification.jpg)
205
150
 
206
- 展开对话里的 **已调用工具**,找到 `opc_mcp_invoke`。检查返回的是实际业务数据还是错误。平台要求审批时,先阅读工具和参数,再决定是否允许。高敏操作的审批是否出现,由平台策略决定。
151
+ 业务验证通过且本地技能启用后,在 DSH 对话中输入 `/app-<应用标识>` 调用技能。普通 HTTP/JSON 接口可作为技能调用,写操作会触发 DSH 审批。应用卡片可启用或停用本地技能,升级和回滚会保留该设置。
207
152
 
208
- 右侧 **在线调试调用** 适合管理员排查:在参数框填写 JSON,再点 **调用**。普通使用者优先按上一段在聊天框提问。
153
+ ### 管理已部署的应用
209
154
 
210
- 目前测试服缺少审批参数加密配置,需要审批的调用可能返回 `INTEGRATION_ARGS_KEY_REQUIRED`,需要平台管理员补齐配置。**本指南的 MCP 截图演示目录和参数查看,尚无真实业务成功结果截图。**
155
+ 应用创建者可从应用卡片进入 **详情** 或 **版本与回退**,查看日志、版本和存储卷,下载历史制品、单卷备份或整应用备份。平台文件直接保存到运行 DSH 的电脑的下载目录。向导内导出的本地交付包仍有 64 MiB 单文件上限。配置变化后重新验证业务。回滚恢复应用版本和运行配置,保留卷中的业务数据。
211
156
 
212
- ## 八、常见问题:先看这里
157
+ ## 八、常见问题
213
158
 
214
- | 遇到的情况 | 先做什么 |
159
+ | 遇到的情况 | 处理方法 |
215
160
  | --- | --- |
216
- | 安装页说“无法从依赖变更中确定安装了哪一个包” | 先回“插件 → 已安装插件”查看是否已装同版本。已装好就完整重启后查看功能入口。 |
217
- | 装完却看不到右边的 OPC | 点左侧“新会话”,点窗口右上角侧栏图标,再在“开始”页找 OPC。仍没有时核对插件启用开关,然后完整重启。 |
218
- | 没有可用工作区 | 使用 DSH 左侧“工作区”旁的添加按钮,按客户端引导选一个本机文件夹。公司已有工作区时可直接选择。 |
219
- | 输入 @ 后找不到知识库 | 确认 OPC 已登录、空间正确,再输入库名的一部分。更新后完整重启 DSH。 |
220
- | 只看到文件和对话候选 | 确认 OPC 插件版本与后台已更新。0.1.4 对旧宿主会隐藏 OPC 候选,完整退出再打开。 |
221
- | 点击登录提示 HTTP 404 | 更新 OPC 插件后完整重启 DSH,让后台注册新版登录路由。 |
222
- | 浏览器没有打开或被关了 | 看 OPC 面板中的“重新打开授权页”,或取消后重新发起登录。 |
223
- | 登录后是空列表 | 核对企业空间。仍为空时请管理员确认账号和资源授权。 |
224
- | 聊天框提示选择模型 | 在输入框下方选择模型,并按 DSH 自身引导登录模型账号。 |
225
- | AI 一直问 service_id | 请公司管理员提供准确服务 ID。当前聊天工具需要这个字段。 |
226
- | MCP 返回 INTEGRATION_ARGS_KEY_REQUIRED | 把错误截图发给平台管理员处理;稍后再试,避免反复提交同一次操作。 |
227
-
228
- ## OPC 应用部署
229
-
230
- 从已打开的 DSH 对话进入右侧的 **OPC 应用**,选择 **部署新应用**,导入源码 ZIP 或填写本机源码目录。AI 在独立副本上分析和提出容器改造。核对文件改动后生成部署包,再填写运行配置、按字段选择 Platform 开放的资源,并确认发布。
231
-
232
- 可以单独选择改造模型。向导会保存部署配置草稿,并可在发布前预览完整应用技能。服务器启动后,向导自动发起首次业务验证,也可手动检查。应用版本、制品摘要、健康身份和只读业务验证都通过后,在对话框输入 `/app-<应用标识>` 选择技能。纯页面应用需要打开页面并确认。普通 HTTP/JSON 接口可作为技能调用,写操作会触发 DSH 审批。应用卡片可启用或停用本地技能,升级和回滚会保留该设置。
233
-
234
- 改造阶段会识别应用的登录方式和权限规则。受保护的接口在部署后填写应用账号、密码或现有会话,点击 **仅重试业务验证** 即可复测。默认仅用于本次验证。勾选保存后,通过验证的凭据由 DSH 凭据服务保管,可用于对话调用。
161
+ | 安装结果显示的版本比预期旧 | 查看安装器的版本说明。若提示 `minimumReleaseAge`,以安装结果及已安装插件详情显示的版本为准。 |
162
+ | 右侧找不到 OPC 工作台 | 核对 **插件 → 已安装插件** 的启用开关,再进入新会话打开右侧边栏。在 **开始** 页仍找不到入口时,完整退出 DSH 后重新打开。 |
163
+ | 企业授权页关闭了 | 点 **重新打开授权页**,或取消后重新发起企业登录。 |
164
+ | 登录后列表为空,或输入 `@` 找不到库 | 核对右上角的企业空间并刷新。如仍无资源,请管理员确认当前账号的资源授权。 |
165
+ | 知识库检索显示 `INVALID_REQUEST` | 确认列表中有可见知识库,选择具体库再检索。如果选库后仍报错,请提供操作时间、空间和错误码供管理员查看。 |
166
+ | MCP 返回 `INTEGRATION_ARGS_KEY_REQUIRED` | 把错误码和工具名交给平台管理员排查。 |
167
+ | 对话无法发送 | 检查 DSH 是否已选择可用模型,并按客户端提示完成模型登录。 |
235
168
 
236
- 应用创建者可在 **管理与回退** 查看日志、版本和存储卷,下载历史制品、单卷备份或整应用备份。平台文件直接保存到运行 DSH 的电脑的下载目录。向导内导出的本地交付包仍有 64 MiB 单文件上限。配置变化后重新验证业务。回滚恢复应用版本和运行配置,保留卷中的业务数据。
169
+ ## 九、管理员和开发者
237
170
 
238
- 需要支持 `/integration/v1/apps` 的 Platform。企微登录后即可部署,所有登录用户共享应用列表。部署资源由 Platform 的 `app_deploy.enterprise_deploy_resources` 配置提供。应用目录和部署任务独立于知识空间。DSH Desktop 使用自带 Python,独立 Web 运行需在 PATH 提供 Python 3.9 或更新版本。
171
+ ### 平台配置与部署要求
239
172
 
240
- ## 给管理员和开发者
173
+ 插件通过公开接口接入 DSH。企业认证使用独立凭据命名空间,OPC 服务地址由 `platformBaseUrl` 配置。默认域名是 `https://aiwork.benlai.com`。参见[配置示例](config/overlay.example.yml)、[一期验收记录](docs/acceptance-matrix.md)。
241
174
 
242
- 插件通过公开接口接入 DSH。企业认证使用独立凭据命名空间,OPC 服务地址由 `platformBaseUrl` 配置。默认域名是 `https://shtokendance.benlai.com`。参见[配置示例](config/overlay.example.yml)、[一期验收记录](docs/acceptance-matrix.md)。
175
+ 应用部署需要支持 `/integration/v1/apps` 的 Platform。企微登录后即可部署,所有登录用户共享应用列表。部署资源由 Platform 的 `app_deploy.enterprise_deploy_resources` 配置提供。应用目录和部署任务独立于知识空间。DSH Desktop 使用自带 Python,独立 Web 运行需在 PATH 提供 Python 3.9 或更新版本。
243
176
 
244
- ## 本地开发
177
+ ### 本地开发
245
178
 
246
179
  需要 Node.js 24.9 或更高版本、npm,以及一个已安装依赖、生成了 Host/Client 类型和 Web 构建的 DSH 源码目录。以下示例假定两个仓库位于同一父目录:
247
180
 
@@ -255,4 +188,4 @@ npx tsc -p tsconfig.client.json
255
188
  npm run build
256
189
  ```
257
190
 
258
- 链接和类型配置都生成在插件目录内。重新执行 `npm ci` 后需要重新链接。开发时可通过 DSH CLI 的 `web --patch` 加载外部 YAML,把插件入口指向构建后的 `lib/index.js`。OPC 服务域名由 `platformBaseUrl` 配置,默认是 `https://shtokendance.benlai.com`。参见[配置示例](config/overlay.example.yml)和[一期验收记录](docs/acceptance-matrix.md)。
191
+ 链接和类型配置都生成在插件目录内。重新执行 `npm ci` 后需要重新链接。开发时可通过 DSH CLI 的 `web --patch` 加载外部 YAML,把插件入口指向构建后的 `lib/index.js`。
@@ -3,7 +3,7 @@
3
3
  # 本地开发替换为插件 lib/index.js 的绝对路径。
4
4
  name: 'dsh-plugin-opc'
5
5
  config:
6
- platformBaseUrl: https://shtokendance.benlai.com
6
+ platformBaseUrl: https://aiwork.benlai.com
7
7
  clientId: work-desktop
8
8
  # 留空使用 DSH home;可显式指定本机受管技能目录。
9
9
  dataHome: ''
Binary file
package/lib/client.js CHANGED
@@ -55723,6 +55723,17 @@ var appsCss = `
55723
55723
  min-width: 0;
55724
55724
  }
55725
55725
  .oa-source-form > .oa-form-card { max-width: none; margin: 0; }
55726
+ .oa-deploy-review {
55727
+ display: flex;
55728
+ flex-direction: column;
55729
+ gap: 14px;
55730
+ width: 100%;
55731
+ min-width: 0;
55732
+ }
55733
+ .oa-deploy-review .oa-form-card {
55734
+ max-width: none;
55735
+ margin: 0;
55736
+ }
55726
55737
  .oa-source-label { margin: 0; font-size: 13px; font-weight: 600; }
55727
55738
  .oa-source-label > span { color: var(--oa-danger); }
55728
55739
  .oa-source-icon {
@@ -56142,7 +56153,7 @@ var SLUG_RE = /^[a-z][a-z0-9-]{2,39}$/;
56142
56153
  var MAX_ZIP_BYTES = 64 * 1024 * 1024;
56143
56154
  var DRAFT_DISMISS_STORAGE_PREFIX = "opc-apps-dismissed-draft:";
56144
56155
  var DEFAULT_OPC_CONFIG = {
56145
- appDomainRoot: "10.101.102.116.nip.io:8080",
56156
+ appDomainRoot: "ai.benlai.com",
56146
56157
  defaultPort: 8080,
56147
56158
  platformBaseUrl: ""
56148
56159
  };
@@ -57703,7 +57714,7 @@ function AppsPanel({
57703
57714
  onInvalidate: () => void refreshWizardJob(wizardJob.id),
57704
57715
  onStepStateChange: setStep2State
57705
57716
  }
57706
- ), wizardStep === 3 && wizardJob && /* @__PURE__ */ import_react8.default.createElement("div", { style: { display: "flex", flexDirection: "column", gap: 14 } }, /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-form-card" }, /* @__PURE__ */ import_react8.default.createElement("div", { style: { display: "flex", alignItems: "center", justifyContent: "space-between", flexWrap: "wrap", gap: 10 } }, /* @__PURE__ */ import_react8.default.createElement("div", null, /* @__PURE__ */ import_react8.default.createElement("div", { style: { display: "flex", alignItems: "center", gap: 8, flexWrap: "wrap" } }, /* @__PURE__ */ import_react8.default.createElement("strong", { style: { fontSize: 15, color: "#0f172a" } }, wizardJob.name), /* @__PURE__ */ import_react8.default.createElement("span", { className: "oa-code" }, wizardJob.slug), /* @__PURE__ */ import_react8.default.createElement("span", { className: "oa-pill oa-pill-accent" }, "\u7AEF\u53E3 ", wizardJob.port ?? opcConfig.defaultPort), wizardJob.proposal?.contract?.runtime?.language && /* @__PURE__ */ import_react8.default.createElement("span", { className: "oa-pill oa-pill-teal" }, wizardJob.proposal.contract.runtime.language, " ", wizardJob.proposal.contract.runtime.version || "")), /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-hint", style: { marginTop: 4 } }, "\u8BBF\u95EE\u5730\u5740\uFF1A", /* @__PURE__ */ import_react8.default.createElement("span", { className: "oa-mono" }, wizardJob.url))), /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-segmented" }, /* @__PURE__ */ import_react8.default.createElement(
57717
+ ), wizardStep === 3 && wizardJob && /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-deploy-review" }, /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-form-card" }, /* @__PURE__ */ import_react8.default.createElement("div", { style: { display: "flex", alignItems: "center", justifyContent: "space-between", flexWrap: "wrap", gap: 10 } }, /* @__PURE__ */ import_react8.default.createElement("div", null, /* @__PURE__ */ import_react8.default.createElement("div", { style: { display: "flex", alignItems: "center", gap: 8, flexWrap: "wrap" } }, /* @__PURE__ */ import_react8.default.createElement("strong", { style: { fontSize: 15, color: "#0f172a" } }, wizardJob.name), /* @__PURE__ */ import_react8.default.createElement("span", { className: "oa-code" }, wizardJob.slug), /* @__PURE__ */ import_react8.default.createElement("span", { className: "oa-pill oa-pill-accent" }, "\u7AEF\u53E3 ", wizardJob.port ?? opcConfig.defaultPort), wizardJob.proposal?.contract?.runtime?.language && /* @__PURE__ */ import_react8.default.createElement("span", { className: "oa-pill oa-pill-teal" }, wizardJob.proposal.contract.runtime.language, " ", wizardJob.proposal.contract.runtime.version || "")), /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-hint", style: { marginTop: 4 } }, "\u8BBF\u95EE\u5730\u5740\uFF1A", /* @__PURE__ */ import_react8.default.createElement("span", { className: "oa-mono" }, wizardJob.url))), /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-segmented" }, /* @__PURE__ */ import_react8.default.createElement(
57707
57718
  "button",
57708
57719
  {
57709
57720
  type: "button",
@@ -57727,6 +57738,14 @@ function AppsPanel({
57727
57738
  onClick: () => setConfigSubTab("artifacts")
57728
57739
  },
57729
57740
  "\u6539\u9020\u4E0E\u68C0\u67E5"
57741
+ ), /* @__PURE__ */ import_react8.default.createElement(
57742
+ "button",
57743
+ {
57744
+ type: "button",
57745
+ className: `oa-segmented-btn ${configSubTab === "mounts" ? "active" : ""}`,
57746
+ onClick: () => setConfigSubTab("mounts")
57747
+ },
57748
+ "\u6302\u8F7D\u4FE1\u606F"
57730
57749
  ))), /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-field", style: { marginTop: 12 } }, /* @__PURE__ */ import_react8.default.createElement("label", { className: "oa-label", htmlFor: `${formId}-version-note` }, "\u7248\u672C\u53D1\u5E03\u8BF4\u660E\uFF08\u53EF\u9009\uFF09"), /* @__PURE__ */ import_react8.default.createElement(
57731
57750
  "input",
57732
57751
  {
@@ -57736,10 +57755,18 @@ function AppsPanel({
57736
57755
  placeholder: wizardJob.upgrade ? "\u4F8B\u5982\uFF1A\u65B0\u589E\u5BA1\u6279\u5BFC\u51FA\u63A5\u53E3\u3001\u4FEE\u590D\u73AF\u5883\u53D8\u91CF\u8BFB\u53D6" : "\u4F8B\u5982\uFF1A\u9996\u6B21\u4E0A\u7EBF\u53D1\u5E03",
57737
57756
  onChange: (e) => handleStep3NoteChange(e.target.value)
57738
57757
  }
57739
- ))), missingConfigAlert ? /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-alert oa-alert-warn" }, /* @__PURE__ */ import_react8.default.createElement(AppIcon, { name: "warning", size: 16 }), /* @__PURE__ */ import_react8.default.createElement("div", null, missingConfigAlert)) : /* @__PURE__ */ import_react8.default.createElement("div", { role: "status", className: "oa-alert oa-alert-ok" }, /* @__PURE__ */ import_react8.default.createElement(AppIcon, { name: "check", size: 16 }), /* @__PURE__ */ import_react8.default.createElement("div", null, "\u8FD0\u884C\u914D\u7F6E\u4E0E\u4F9D\u8D56\u8D44\u6E90\u5DF2\u6821\u9A8C\u5C31\u7EEA\uFF0C\u53EF\u70B9\u51FB\u53F3\u4E0B\u89D2\u6309\u94AE\u786E\u8BA4\u5E76\u53D1\u5E03\u4E0A\u7EBF\u3002")), configSubTab === "configs" && /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-form-card" }, volumeMounts.length > 0 && /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-subcard" }, /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-subcard-head" }, "\u6301\u4E45\u5316\u76EE\u5F55\u4E0E\u5B58\u50A8\u8D44\u6E90"), volumeMounts.map((mount) => {
57758
+ ))), missingConfigAlert ? /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-alert oa-alert-warn" }, /* @__PURE__ */ import_react8.default.createElement(AppIcon, { name: "warning", size: 16 }), /* @__PURE__ */ import_react8.default.createElement("div", null, missingConfigAlert)) : /* @__PURE__ */ import_react8.default.createElement("div", { role: "status", className: "oa-alert oa-alert-ok" }, /* @__PURE__ */ import_react8.default.createElement(AppIcon, { name: "check", size: 16 }), /* @__PURE__ */ import_react8.default.createElement("div", null, "\u8FD0\u884C\u914D\u7F6E\u4E0E\u4F9D\u8D56\u8D44\u6E90\u5DF2\u6821\u9A8C\u5C31\u7EEA\uFF0C\u53EF\u70B9\u51FB\u53F3\u4E0B\u89D2\u6309\u94AE\u786E\u8BA4\u5E76\u53D1\u5E03\u4E0A\u7EBF\u3002")), configSubTab === "configs" && /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-form-card" }, /* @__PURE__ */ import_react8.default.createElement(
57759
+ AppDeliveryConfig,
57760
+ {
57761
+ configs: configDrafts,
57762
+ originals: originalConfigs,
57763
+ resources,
57764
+ onChange: handleStep3ConfigsChange
57765
+ }
57766
+ )), configSubTab === "mounts" && /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-form-card" }, volumeMounts.length === 0 ? /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-hint" }, "\u6B64\u5E94\u7528\u6CA1\u6709\u76EE\u5F55\u6302\u8F7D\u3002") : /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-subcard" }, /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-subcard-head" }, /* @__PURE__ */ import_react8.default.createElement("span", null, "\u6301\u4E45\u5316\u76EE\u5F55\u4E0E\u5B58\u50A8\u8D44\u6E90"), /* @__PURE__ */ import_react8.default.createElement("span", { className: "oa-pill oa-pill-ok" }, volumeMounts.length, " \u9879")), /* @__PURE__ */ import_react8.default.createElement("div", { style: { display: "flex", flexDirection: "column", gap: 10 } }, volumeMounts.map((mount) => {
57740
57767
  const existing = existingStorage.find((old) => old.container_path === mount.container_path);
57741
57768
  const options = volumeOptions(mount);
57742
- return /* @__PURE__ */ import_react8.default.createElement("div", { key: mount.container_path, className: "oa-hint" }, /* @__PURE__ */ import_react8.default.createElement("label", null, /* @__PURE__ */ import_react8.default.createElement("code", null, mount.container_path), " ", mount.purpose || "", existing ? /* @__PURE__ */ import_react8.default.createElement("span", null, " \xB7 \u590D\u7528 ", existing.storage_location || existing.host_path || existing.volume_name || "\u73B0\u6709\u6302\u8F7D") : /* @__PURE__ */ import_react8.default.createElement(
57769
+ return /* @__PURE__ */ import_react8.default.createElement("div", { key: mount.container_path, className: "oa-hint" }, /* @__PURE__ */ import_react8.default.createElement("label", { style: { display: "flex", alignItems: "center", justifyContent: "space-between", flexWrap: "wrap", gap: 8 } }, /* @__PURE__ */ import_react8.default.createElement("span", null, /* @__PURE__ */ import_react8.default.createElement("code", null, mount.container_path), " ", mount.purpose || ""), existing ? /* @__PURE__ */ import_react8.default.createElement("span", null, "\u590D\u7528 ", existing.storage_location || existing.host_path || existing.volume_name || "\u73B0\u6709\u6302\u8F7D") : /* @__PURE__ */ import_react8.default.createElement(
57743
57770
  "select",
57744
57771
  {
57745
57772
  "aria-label": `\u5B58\u50A8\u8D44\u6E90 ${mount.container_path}`,
@@ -57754,15 +57781,7 @@ function AppsPanel({
57754
57781
  options.length === 0 && /* @__PURE__ */ import_react8.default.createElement("option", { value: "" }, mount.kind === "sqlite" ? "\u7B49\u5F85\u7BA1\u7406\u5458\u914D\u7F6E\u672C\u5730\u78C1\u76D8\u5377" : "\u7B49\u5F85\u7BA1\u7406\u5458\u914D\u7F6E\u5B58\u50A8"),
57755
57782
  options.map((resource) => /* @__PURE__ */ import_react8.default.createElement("option", { key: resource.id, value: resource.id }, resource.name, " \xB7 ", resource.type === "aliyun-oss-volume" ? "\u963F\u91CC\u4E91 OSS" : "\u672C\u5730\u78C1\u76D8", resource.is_default ? "\uFF08\u9ED8\u8BA4\uFF09" : ""))
57756
57783
  )));
57757
- })), /* @__PURE__ */ import_react8.default.createElement(
57758
- AppDeliveryConfig,
57759
- {
57760
- configs: configDrafts,
57761
- originals: originalConfigs,
57762
- resources,
57763
- onChange: handleStep3ConfigsChange
57764
- }
57765
- )), configSubTab === "skill" && /* @__PURE__ */ import_react8.default.createElement(AppSkillPreview, { api, contextId, job: wizardJob }), configSubTab === "artifacts" && /* @__PURE__ */ import_react8.default.createElement("div", { style: { display: "flex", flexDirection: "column", gap: 12 } }, (wizardJob.preparationChecks ?? []).length > 0 && /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-subcard" }, /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-subcard-head" }, /* @__PURE__ */ import_react8.default.createElement("span", null, "\u4EA4\u4ED8\u5305\u751F\u6210\u4E0E\u81EA\u68C0\u7ED3\u679C"), /* @__PURE__ */ import_react8.default.createElement("span", { className: "oa-pill oa-pill-ok" }, wizardJob.preparationChecks.length, " \u9879")), /* @__PURE__ */ import_react8.default.createElement("div", { style: { display: "flex", flexDirection: "column", gap: 8 } }, wizardJob.preparationChecks.map((chk, idx) => /* @__PURE__ */ import_react8.default.createElement("div", { key: idx, style: { display: "flex", alignItems: "flex-start", gap: 8, fontSize: 12.5 } }, /* @__PURE__ */ import_react8.default.createElement("span", { className: `oa-pill ${chk.status === "passed" ? "oa-pill-ok" : "oa-pill-warn"}` }, chk.status === "passed" ? "\u901A\u8FC7" : chk.status), /* @__PURE__ */ import_react8.default.createElement("div", null, /* @__PURE__ */ import_react8.default.createElement("strong", { style: { color: "#0f172a" } }, chk.label), /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-hint" }, chk.detail)))))), wizardJob.artifacts && Object.keys(wizardJob.artifacts).length > 0 && /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-subcard" }, /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-subcard-head" }, /* @__PURE__ */ import_react8.default.createElement("span", null, "\u672C\u5730\u5F85\u4EA4\u4ED8\u6587\u4EF6"), /* @__PURE__ */ import_react8.default.createElement("span", { className: "oa-hint" }, "\u70B9\u51FB\u53EF\u5BFC\u51FA\u5230\u672C\u5730\u68C0\u67E5")), /* @__PURE__ */ import_react8.default.createElement("div", { style: { display: "flex", flexWrap: "wrap", gap: 8 } }, Object.keys(wizardJob.artifacts).map((filename) => /* @__PURE__ */ import_react8.default.createElement(
57784
+ })))), configSubTab === "skill" && /* @__PURE__ */ import_react8.default.createElement(AppSkillPreview, { api, contextId, job: wizardJob }), configSubTab === "artifacts" && /* @__PURE__ */ import_react8.default.createElement("div", { style: { display: "flex", flexDirection: "column", gap: 12 } }, (wizardJob.preparationChecks ?? []).length > 0 && /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-subcard" }, /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-subcard-head" }, /* @__PURE__ */ import_react8.default.createElement("span", null, "\u4EA4\u4ED8\u5305\u751F\u6210\u4E0E\u81EA\u68C0\u7ED3\u679C"), /* @__PURE__ */ import_react8.default.createElement("span", { className: "oa-pill oa-pill-ok" }, wizardJob.preparationChecks.length, " \u9879")), /* @__PURE__ */ import_react8.default.createElement("div", { style: { display: "flex", flexDirection: "column", gap: 8 } }, wizardJob.preparationChecks.map((chk, idx) => /* @__PURE__ */ import_react8.default.createElement("div", { key: idx, style: { display: "flex", alignItems: "flex-start", gap: 8, fontSize: 12.5 } }, /* @__PURE__ */ import_react8.default.createElement("span", { className: `oa-pill ${chk.status === "passed" ? "oa-pill-ok" : "oa-pill-warn"}` }, chk.status === "passed" ? "\u901A\u8FC7" : chk.status), /* @__PURE__ */ import_react8.default.createElement("div", null, /* @__PURE__ */ import_react8.default.createElement("strong", { style: { color: "#0f172a" } }, chk.label), /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-hint" }, chk.detail)))))), wizardJob.artifacts && Object.keys(wizardJob.artifacts).length > 0 && /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-subcard" }, /* @__PURE__ */ import_react8.default.createElement("div", { className: "oa-subcard-head" }, /* @__PURE__ */ import_react8.default.createElement("span", null, "\u672C\u5730\u5F85\u4EA4\u4ED8\u6587\u4EF6"), /* @__PURE__ */ import_react8.default.createElement("span", { className: "oa-hint" }, "\u70B9\u51FB\u53EF\u5BFC\u51FA\u5230\u672C\u5730\u68C0\u67E5")), /* @__PURE__ */ import_react8.default.createElement("div", { style: { display: "flex", flexWrap: "wrap", gap: 8 } }, Object.keys(wizardJob.artifacts).map((filename) => /* @__PURE__ */ import_react8.default.createElement(
57766
57785
  "button",
57767
57786
  {
57768
57787
  key: filename,
@@ -58318,11 +58337,11 @@ function OpcSettingsPanel({
58318
58337
  const [loading, setLoading] = (0, import_react9.useState)(true);
58319
58338
  const [saving, setSaving] = (0, import_react9.useState)(false);
58320
58339
  const [testing, setTesting] = (0, import_react9.useState)(false);
58321
- const [platformBase, setPlatformBase] = (0, import_react9.useState)("https://shtokendance.benlai.com");
58340
+ const [platformBase, setPlatformBase] = (0, import_react9.useState)("https://aiwork.benlai.com");
58322
58341
  const [appDomainRoot, setAppDomainRoot] = (0, import_react9.useState)("");
58323
58342
  const [appDefaultPort, setAppDefaultPort] = (0, import_react9.useState)("8080");
58324
- const [defaultPlatformBase, setDefaultPlatformBase] = (0, import_react9.useState)("https://shtokendance.benlai.com");
58325
- const [defaultAppDomainRoot, setDefaultAppDomainRoot] = (0, import_react9.useState)("10.101.102.116.nip.io:8080");
58343
+ const [defaultPlatformBase, setDefaultPlatformBase] = (0, import_react9.useState)("https://aiwork.benlai.com");
58344
+ const [defaultAppDomainRoot, setDefaultAppDomainRoot] = (0, import_react9.useState)("ai.benlai.com");
58326
58345
  const [testResult, setTestResult] = (0, import_react9.useState)(null);
58327
58346
  const [error62, setError] = (0, import_react9.useState)("");
58328
58347
  const [notice, setNotice] = (0, import_react9.useState)(null);
@@ -58335,9 +58354,9 @@ function OpcSettingsPanel({
58335
58354
  setError("");
58336
58355
  try {
58337
58356
  const cfg = JSON.parse(await api.opcConfigGet());
58338
- setDefaultPlatformBase(cfg.default_platform_base || "https://shtokendance.benlai.com");
58339
- setDefaultAppDomainRoot(cfg.default_app_domain_root || "10.101.102.116.nip.io:8080");
58340
- setPlatformBase(cfg.platform_base || cfg.default_platform_base || "https://shtokendance.benlai.com");
58357
+ setDefaultPlatformBase(cfg.default_platform_base || "https://aiwork.benlai.com");
58358
+ setDefaultAppDomainRoot(cfg.default_app_domain_root || "ai.benlai.com");
58359
+ setPlatformBase(cfg.platform_base || cfg.default_platform_base || "https://aiwork.benlai.com");
58341
58360
  setAppDomainRoot(cfg.app_domain_root ?? "");
58342
58361
  setAppDefaultPort(String(cfg.app_default_port ?? 8080));
58343
58362
  } catch (e) {
package/lib/index.js CHANGED
@@ -213,6 +213,27 @@ var TokenRefresh = class {
213
213
  function text(value) {
214
214
  return typeof value === "string" ? value : "";
215
215
  }
216
+ var LOGIN_ERROR_MESSAGES = {
217
+ SUBJECT_NOT_PROVISIONED: "\u5F53\u524D\u8D26\u53F7\u672A\u540C\u6B65\u5230 OPC \u5E73\u53F0\u6216\u5DF2\u88AB\u7981\u7528\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u5728\u7EDF\u4E00\u8D26\u6237\u4E2D\u5FC3\u542F\u7528\u8D26\u53F7\u5E76\u6267\u884C\u5168\u91CF\u540C\u6B65\u540E\u91CD\u8BD5\u3002",
218
+ SUBJECT_CONFLICT: "\u5F53\u524D\u8D26\u53F7\u5B58\u5728\u8EAB\u4EFD\u7ED1\u5B9A\u51B2\u7A81\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u5728\u7EDF\u4E00\u8D26\u6237\u4E2D\u5FC3\u6838\u5BF9\u8D26\u53F7\u4FE1\u606F\u3002",
219
+ WECOM_EXCHANGE_FAILED: "\u4F01\u4E1A\u5FAE\u4FE1\u8EAB\u4EFD\u6821\u9A8C\u5931\u8D25\uFF0C\u8BF7\u91CD\u8BD5\uFF1B\u5982\u6301\u7EED\u5931\u8D25\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u68C0\u67E5\u4F01\u4E1A\u5FAE\u4FE1\u5E94\u7528\u914D\u7F6E\u3002",
220
+ ACCOUNT_CENTER_UNAVAILABLE: "\u7EDF\u4E00\u8D26\u6237\u4E2D\u5FC3\u6682\u4E0D\u53EF\u7528\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\uFF1B\u5982\u6301\u7EED\u5931\u8D25\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u3002",
221
+ AUTH_STATE_MISMATCH: "\u767B\u5F55\u4F1A\u8BDD\u5DF2\u5931\u6548\u6216\u72B6\u6001\u4E0D\u5339\u914D\uFF0C\u8BF7\u8FD4\u56DE DSH \u91CD\u65B0\u53D1\u8D77\u4F01\u4E1A\u767B\u5F55\u3002",
222
+ AUTH_CODE_REPLAYED: "\u6388\u6743\u7801\u5DF2\u5931\u6548\u6216\u5DF2\u88AB\u4F7F\u7528\uFF0C\u8BF7\u8FD4\u56DE DSH \u91CD\u65B0\u53D1\u8D77\u4F01\u4E1A\u767B\u5F55\u3002",
223
+ INTERNAL_ERROR: "OPC \u5E73\u53F0\u8BA4\u8BC1\u670D\u52A1\u5F02\u5E38\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\u6216\u8054\u7CFB\u7BA1\u7406\u5458\u3002",
224
+ AUTHORIZATION_DENIED: "\u4F01\u4E1A\u6388\u6743\u672A\u5B8C\u6210\u6216\u672A\u8FD4\u56DE\u6388\u6743\u7801\uFF0C\u8BF7\u91CD\u8BD5\u3002",
225
+ access_denied: "\u4F01\u4E1A\u6388\u6743\u5DF2\u53D6\u6D88\u6216\u672A\u901A\u8FC7\uFF0C\u8BF7\u91CD\u8BD5\u3002",
226
+ INVALID_TOKEN_RESPONSE: "\u5E73\u53F0\u8FD4\u56DE\u7684\u767B\u5F55\u4EE4\u724C\u683C\u5F0F\u65E0\u6548\uFF0C\u8BF7\u91CD\u8BD5\u6216\u8054\u7CFB\u7BA1\u7406\u5458\u3002",
227
+ INVALID_SESSION_RESPONSE: "\u5E73\u53F0\u8FD4\u56DE\u7684\u4F1A\u8BDD\u4FE1\u606F\u65E0\u6548\uFF0C\u8BF7\u91CD\u8BD5\u6216\u8054\u7CFB\u7BA1\u7406\u5458\u3002",
228
+ PLATFORM_REQUEST_FAILED: "\u5E73\u53F0\u767B\u5F55\u8BF7\u6C42\u5931\u8D25\uFF0C\u8BF7\u68C0\u67E5\u5E73\u53F0\u7F51\u5173\u914D\u7F6E\u540E\u91CD\u8BD5\u3002"
229
+ };
230
+ function normalizeCallbackErrorCode(rawError) {
231
+ const trimmed = rawError?.trim() ?? "";
232
+ return /^[A-Za-z0-9_.-]{1,64}$/.test(trimmed) ? trimmed : "AUTHORIZATION_DENIED";
233
+ }
234
+ function describeLoginError(code) {
235
+ return LOGIN_ERROR_MESSAGES[code] ?? LOGIN_ERROR_MESSAGES[code.toUpperCase()] ?? (code === "LOGIN_FAILED" ? "\u4F01\u4E1A\u767B\u5F55\u672A\u5B8C\u6210\uFF0C\u8BF7\u91CD\u8BD5\u3002" : `\u4F01\u4E1A\u767B\u5F55\u672A\u5B8C\u6210\uFF08${code}\uFF09\uFF0C\u8BF7\u91CD\u8BD5\u3002`);
236
+ }
216
237
  function check(response) {
217
238
  if (response.status >= 400) {
218
239
  const error = response.body.error;
@@ -387,17 +408,24 @@ var AuthManager = class extends EventEmitter {
387
408
  return;
388
409
  }
389
410
  consumed = true;
390
- const code = url.searchParams.get("code");
411
+ const code = url.searchParams.get("code")?.trim();
412
+ const callbackError = url.searchParams.get("error");
391
413
  void (async () => {
392
414
  try {
393
- if (!code) throw new OpcError("AUTHORIZATION_DENIED");
415
+ if (callbackError !== null && callbackError.trim() !== "") {
416
+ const errorCode = normalizeCallbackErrorCode(callbackError);
417
+ throw new OpcError(errorCode, describeLoginError(errorCode));
418
+ }
419
+ if (!code) throw new OpcError("AUTHORIZATION_DENIED", describeLoginError("AUTHORIZATION_DENIED"));
394
420
  const result = check(await this.http.request("/integration/v1/auth/token", { signal: controller.signal, body: { grant_type: "authorization_code", client_id: this.clientId, code, code_verifier: verifier, device: this.device, audience: "work" } }));
395
421
  if (controller.signal.aborted) throw new OpcError("LOGIN_CANCELLED");
396
422
  await this.accept(result, revision, true);
397
423
  response.writeHead(200, { "Content-Type": "text/plain; charset=utf-8", "Cache-Control": "no-store" }).end("\u767B\u5F55\u6210\u529F\uFF0C\u8BF7\u8FD4\u56DE DSH\u3002");
398
424
  } catch (error) {
399
- if (revision === this.#revision) this.#error = { code: error instanceof OpcError ? error.code : "LOGIN_FAILED", message: "\u4F01\u4E1A\u767B\u5F55\u672A\u5B8C\u6210\uFF0C\u8BF7\u91CD\u8BD5\u3002" };
400
- response.writeHead(400).end("Login failed");
425
+ const errorCode = error instanceof OpcError ? error.code : "LOGIN_FAILED";
426
+ const message = describeLoginError(errorCode);
427
+ if (revision === this.#revision) this.#error = { code: errorCode, message };
428
+ response.writeHead(400, { "Content-Type": "text/plain; charset=utf-8", "Cache-Control": "no-store" }).end(`\u767B\u5F55\u5931\u8D25\uFF1A${message}\uFF08${errorCode}\uFF09\u8BF7\u8FD4\u56DE DSH\u3002`);
401
429
  } finally {
402
430
  if (this.#login?.server === server) this.cancelLogin();
403
431
  }
@@ -1253,8 +1281,8 @@ import { randomUUID as randomUUID3 } from "node:crypto";
1253
1281
  import { existsSync, readFileSync } from "node:fs";
1254
1282
  import { mkdir as mkdir2, rename as rename2, writeFile as writeFile2 } from "node:fs/promises";
1255
1283
  import { join as join2 } from "node:path";
1256
- var DEFAULT_PLATFORM_BASE = "https://shtokendance.benlai.com";
1257
- var DEFAULT_APP_DOMAIN_ROOT = "10.101.102.116.nip.io:8080";
1284
+ var DEFAULT_PLATFORM_BASE = "https://aiwork.benlai.com";
1285
+ var DEFAULT_APP_DOMAIN_ROOT = "ai.benlai.com";
1258
1286
  var DEFAULT_APP_DEFAULT_PORT = 8080;
1259
1287
  function normalizePlatformBaseUrl(raw) {
1260
1288
  const input = typeof raw === "string" ? raw.trim() : "";
@@ -1264,7 +1292,7 @@ function normalizePlatformBaseUrl(raw) {
1264
1292
  function sanitizeDomainRoot(raw) {
1265
1293
  const trimmed = String(raw ?? "").trim().replace(/^https?:\/\//i, "").replace(/\/+$/, "").trim();
1266
1294
  if (trimmed && /[\s/?#]/.test(trimmed)) {
1267
- throw new Error("\u5E94\u7528\u5185\u7F51\u6839\u57DF\u540D\u540E\u7F00\u683C\u5F0F\u65E0\u6548\uFF0C\u8BF7\u586B\u5199\u5982 10.101.102.116.nip.io:8080");
1295
+ throw new Error("\u5E94\u7528\u5185\u7F51\u6839\u57DF\u540D\u540E\u7F00\u683C\u5F0F\u65E0\u6548\uFF0C\u8BF7\u586B\u5199\u5982 ai.benlai.com");
1268
1296
  }
1269
1297
  return trimmed;
1270
1298
  }
@@ -2283,7 +2311,7 @@ ${combinedLog}` : combinedLog).slice(-24e3);
2283
2311
  }
2284
2312
  const defaultPort = Number.isInteger(this.options.appDefaultPort) && this.options.appDefaultPort >= 1 && this.options.appDefaultPort <= 65535 ? this.options.appDefaultPort : 8080;
2285
2313
  return {
2286
- appDomainRoot: appDomainRoot || "10.101.102.116.nip.io:8080",
2314
+ appDomainRoot: appDomainRoot || DEFAULT_APP_DOMAIN_ROOT,
2287
2315
  defaultPort,
2288
2316
  platformBaseUrl: this.core.auth?.http?.base?.toString()?.replace(/\/+$/, "") ?? ""
2289
2317
  };
@@ -4454,7 +4482,7 @@ var TYPERT = { package: contribution.package, face: "host", schemas: [], invocat
4454
4482
  // src/index.ts
4455
4483
  var name = "dsh-plugin-opc";
4456
4484
  var inject = ["credentials", "authorization", "skills", "tools", "agents", "approval", "typert", "llm"];
4457
- var Config = z2.object({ platformBaseUrl: z2.string().default("https://shtokendance.benlai.com"), clientId: z2.string().default("work-desktop"), dataHome: z2.string().default(""), appDomainRoot: z2.string().default(""), appDefaultPort: z2.number().default(8080) });
4485
+ var Config = z2.object({ platformBaseUrl: z2.string().default("https://aiwork.benlai.com"), clientId: z2.string().default("work-desktop"), dataHome: z2.string().default(""), appDomainRoot: z2.string().default(""), appDefaultPort: z2.number().default(8080) });
4458
4486
  function apply(ctx, config) {
4459
4487
  const key = credentialKey(name, "enterprise");
4460
4488
  const home = config.dataHome || resolveDshHome();
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-plugin-opc",
3
- "version": "0.1.25",
3
+ "version": "0.1.27",
4
4
  "description": "OPC Enterprise Plugin for DeepSeek Harness (DSH)",
5
5
  "type": "module",
6
6
  "publishConfig": {
@@ -52,6 +52,7 @@
52
52
  "LICENSE-Inter.txt",
53
53
  "runtime",
54
54
  "README.md",
55
+ "docs/images/workbench/*.jpg",
55
56
  "config/overlay.example.yml"
56
57
  ],
57
58
  "dsh": {
@@ -23,7 +23,7 @@ from app_delivery.scripts import delivery
23
23
 
24
24
  def fetch_platform_dockerfile_template(platform_url: str, language: str, version: str = "") -> dict:
25
25
  """Step 2 helper: fetch Dockerfile template for (language, version) from platform-opc deploy-opc DB."""
26
- base = (platform_url or "https://shtokendance.benlai.com").rstrip("/")
26
+ base = (platform_url or "https://aiwork.benlai.com").rstrip("/")
27
27
  query = urllib.parse.urlencode({"language": language.strip(), "version": version.strip()})
28
28
  url = f"{base}/api/v1/apps/dockerfile-templates?{query}"
29
29
  req = urllib.request.Request(url, headers={"Accept": "application/json"}, method="GET")