@authinex/dsh-plugin 0.1.0 → 0.1.2

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.
package/README.md CHANGED
@@ -1,56 +1,97 @@
1
1
  # AuthineX DS 插件
2
2
 
3
- DeepSeek 桌面应用和网页客户端里的插件。装好后由用户自己填**访问地址和密钥**完成绑定,然后可以问产品、查 ONES / 氚云 / PMO、检索源码、做只读定位,并用本人账号建单。工单账号与 AuthineX、运营台个人设置是同一份:已经配过的直接拉下来用,在插件里新填的写回 AgentHub。
3
+ 在 DeepSeek 里直接问产品、查工单、检索源码、做线上定位,并用你自己的 ONES / 氚云 / PMO 账号建单。
4
4
 
5
- 插件本身**不带任何默认地址、公司信息或密钥**:包里没有组合包 `config` 段,Host 也不导出 `Config`;用户填的地址和私钥只进本机凭据。密钥验证通过之前不带出使用者或工单登录名;连续猜密钥会锁 IP,反复被锁会拉黑。插件不在本机保存业务系统密码,也不改本机、不推代码。
5
+ 装好后由你填**访问地址**和**密钥**完成绑定。插件本身不带任何默认地址、公司信息或密钥。
6
6
 
7
- 源码是 TypeScript(`src/`)。发给 npm 的是打包后的 JavaScript,安装的机器不用再构建。
7
+ ## 功能
8
8
 
9
- 实现约定见 [docs/DS插件-技术与产品实现.md](docs/DS插件-技术与产品实现.md),接口和里程碑见 [docs/DS插件-编码实施计划.md](docs/DS插件-编码实施计划.md)。安装、构建和本版验收见 [docs/安装与验收.md](docs/安装与验收.md)。
9
+ 绑定后,对话里会出现这些工具:
10
10
 
11
- ## 开发
11
+ | 工具 | 做什么 |
12
+ | --- | --- |
13
+ | 咨询问题 | 检索云枢知识库(产品手册、专家经验、源码说明、版本说明)。用完整中文问句,可带版本收窄 |
14
+ | 查询工单 | 按单号查 ONES、氚云或 PMO;没有单号时按标题筛 |
15
+ | 查询相似工单 | 按现象检索历史上修过的相似工单,给出当时的根因和解决办法 |
16
+ | 修复模式 | 按现象检索团队修复模式库:问题模式、根因、修复策略、关键文件 |
17
+ | 代码检索 | 检索云枢代码索引,返回文件路径、行号和代码片段。可指定仓或分支 |
18
+ | 问智能助手 | 把整个问题交给智能助手,返回答案和出处 |
19
+ | 线上源码定位 | 按版本读线上源码做只读定位,返回根因和位置;通常 2–4 分钟 |
20
+ | 查任务进度 | 查上面那条定位任务的进度和结论 |
21
+ | 创建工单 | 起草 ONES、氚云或 PMO 工单,你确认后才提交 |
12
22
 
13
- ```bash
14
- npm install
15
- npm test
16
- ```
23
+ 配置页里还有:
24
+
25
+ - **工单账号**:ONES、氚云、PMO 三家。与 AuthineX、运营台「个人设置」是同一份数据——已经配过的直接拉下来用,在这里新填的写回 AgentHub。每家可以单独启用或停用,填完先测连接再保存。
26
+ - **更新**:检查到新版本后可以直接在页面里更新,装完重启智能问答生效,绑定和账号都不动。
27
+ - **解除绑定**:二次确认后清掉本机的地址和密钥,服务端作废这台设备。
28
+
29
+ 插件只做「看和判断」:不改你本机的文件、不推代码、不收你的 GitLab 凭据。要动本机用桌面端 AuthineX。
30
+
31
+ 权限由运营台角色和签发的密钥共同决定,角色不够的工具不会出现在列表里。
32
+
33
+ ## 安装
34
+
35
+ 包名 `@authinex/dsh-plugin`,已发布到 [npm](https://www.npmjs.com/package/@authinex/dsh-plugin)。
36
+
37
+ **方式一:插件页**
38
+
39
+ 左侧「插件」→ 右上「添加插件」→ 输入 `@authinex/dsh-plugin` → 安装。
40
+
41
+ 国内网络在对话框的「安装源」里选**中国镜像源**(`registry.npmmirror.com`)。镜像还没同步到时,选「自定义地址」填下面任意一个:
17
42
 
18
- `npm test` 会先做类型检查,再把 `src/*.ts` 打成 `lib/index.js`(Host)和 `lib/client.js`(配置页),然后跑测试。
43
+ - `https://mirrors.cloud.tencent.com/npm/`
44
+ - `https://mirrors.huaweicloud.com/repository/npm/`
19
45
 
20
- 看配置页长什么样,不用开 DeepSeek:
46
+ **方式二:命令行**
21
47
 
22
48
  ```bash
23
- npm run preview
49
+ dsh plugin --profile <你的 profile> add @authinex/dsh-plugin
24
50
  ```
25
51
 
26
- 浏览器打开 `http://127.0.0.1:4173`。左边切换未绑定、已绑定这些状态。这只是把客户端那一块单独挂出来,密钥不会真的去连 AgentHub。
52
+ 国内网络加 `--registry=https://registry.npmmirror.com/`。
27
53
 
28
- ## 它是怎么跑起来的
54
+ 装完**重启智能问答**。插件清单只在 Host 启动那一刻拼出来,不重启看不到。
29
55
 
30
- 这是一个 DeepSeek 组合包,不是独立网站。`cordis.patch.yml` 往 Host 里插入一行 `@authinex/dsh-plugin`。
56
+ > 刚发布完可能提示「未找到相关插件」——这是 npm 元数据还没扩散,等几分钟再试。
31
57
 
32
- 包里有两半:
58
+ ## 绑定
33
59
 
34
- - **Host**(`lib/index.js`,跑在 DeepSeek 的 Node 进程里)注册对话工具,并把「用户填的地址 + 私钥 + 安装号」放进 Host 凭据。配置页的请求打到同源的 `/authinex-ds/*`,由 Host 转发到用户填的那台 AgentHub。
35
- - **Client**(`lib/client.js`,跑在插件页里)通过 `window.__ModuleLoader__` 注册,同时挂到 DeepSeek 的 `plugins.bundle.config` 和 `plugins.row.config` 两个插槽。页面上只有两个输入框:访问地址和密钥。页面不保存公司、用户和密码。
60
+ 左侧「插件」→ 点这一行右侧的「Configure」,页面上有两个输入框:
36
61
 
37
- 更新也在这个页面完成:插件调 Host 的 `pluginManager.installBundle` 装新版本,服务端只提供一份 `manifest.json`。装完重启智能问答即生效,绑定和账号不动。
62
+ - **访问地址**:你所在环境的 AgentHub 地址,必须是完整的 `http://` 或 `https://`,不能带账号密码。
63
+ - **密钥**:管理员签发的 `auds-t-…`(测试)或 `auds-p-…`(生产)。
38
64
 
39
- 对话里的工具调用发生在 Host。建单会先弹出 DeepSeek 的确认卡,人点创建才发给 AgentHub。
65
+ 两个都填对才能绑上。几个约定:
40
66
 
41
- ## 发布和安装
67
+ - 密钥一次性,兑换成功即作废。
68
+ - 测试密钥只能连测试环境,前缀和服务对不上只显示「密钥无效」。
69
+ - 绑定成功后地址和私钥一起存进本机凭据,重启自动登录,不用重填。
70
+ - 换地址要先「解除绑定」再重填。
71
+ - 验证通过后才会出现使用者、功能列表和账号;没通过之前这些都不显示。
42
72
 
43
- 在有 `@authinex` 发布权限的账号下:
73
+ ## 工单账号
44
74
 
45
- ```bash
46
- npm login
47
- npm publish
48
- ```
75
+ 在配置页展开某一家填字段,「测试连接」通过才能保存。
49
76
 
50
- `npm publish` 会先跑测试。装到要用的机器上:
77
+ - 卡片上的账号一律打码:邮箱 `z****@example.com`,手机号 `158****3***`。展开表单才能看到完整值,因为保存时要按原值回写。
78
+ - 密码 / Token 框留空表示不修改原来的。
79
+ - 角色只给了读权限时,那一家显示「已配置,只能查」。
80
+ - 停用某一家后,它不再参与建单和查单。
51
81
 
52
- ```bash
53
- npm install @authinex/dsh-plugin
54
- ```
82
+ ## 更新
83
+
84
+ 点「检查更新」取清单,有新版本时卡片会给出新版本号、版本说明和校验值。
85
+
86
+ 点「更新到 x.y.z」并确认,插件会调用 DeepSeek 自己的安装器装新版本。装完重启智能问答生效,绑定和账号都不动。
87
+
88
+ ## 在对话里用
89
+
90
+ 直接说人话就行,模型会自己选工具:
91
+
92
+ - 「云枢 8.7 表单设计器的显示条件为什么不生效」→ 查知识库
93
+ - 「DTS-1234 这个单什么情况」→ 查工单
94
+ - 「登录页白屏,帮我看下大概在哪个文件」→ 线上源码定位,然后用「查任务进度」取结论
95
+ - 「给 ONES 建个单,标题是登录失败」→ 起草,弹出确认卡,你点创建才提交
55
96
 
56
- 装好的包里只有 `lib/`、`cordis.patch.yml` 和密钥测试向量,没有 TypeScript 源码。DeepSeek 按包里的 `cordis.patch.yml` 加载这一行插件。
97
+ 取消确认卡之后,同一个草稿不会再自动提交。
package/lib/client.js CHANGED
@@ -217,6 +217,27 @@ var ACCOUNT_FIELDS = {
217
217
  ]
218
218
  };
219
219
  var ACCOUNT_LABELS = { ones: "ONES", h3yun: "氚云", pmo: "PMO" };
220
+ function maskMobile(raw) {
221
+ const digits = String(raw || "").replace(/[\s-]/g, "");
222
+ if (!digits) return "";
223
+ if (/^\d{11}$/.test(digits)) return `${digits.slice(0, 3)}****${digits.slice(-4)}`;
224
+ if (digits.length <= 4) return "****";
225
+ return `${digits.slice(0, 3)}****${digits.slice(-2)}`;
226
+ }
227
+ function maskEmail(raw) {
228
+ const text = String(raw || "").trim();
229
+ const at = text.indexOf("@");
230
+ if (at <= 0) return text.length <= 1 ? "****" : `${text.slice(0, 1)}****`;
231
+ return `${text.slice(0, 1)}****@${text.slice(at + 1)}`;
232
+ }
233
+ function maskAccount(raw) {
234
+ const text = String(raw || "").trim();
235
+ if (!text) return "";
236
+ if (/^\d{11}$/.test(text)) return maskMobile(text);
237
+ if (text.indexOf("@") > 0) return maskEmail(text);
238
+ if (text.length <= 4) return `${text.slice(0, 1)}****`;
239
+ return `${text.slice(0, 2)}****${text.slice(-2)}`;
240
+ }
220
241
  function verified(state) {
221
242
  const phase = state?.phase;
222
243
  return phase === "bound" || phase === "caps-missing" || phase === "upgrade";
@@ -263,7 +284,8 @@ function viewModel(state) {
263
284
  state: String(row.state || "unconfigured"),
264
285
  status: String(row.label || "未配置"),
265
286
  hint: String(row.hint || ""),
266
- username: row.state === "unconfigured" ? "" : String(row.username || ""),
287
+ // 卡片上只展示打码后的账号;编辑表单另算,值来自 accountFields。
288
+ username: row.state === "unconfigured" ? "" : maskAccount(String(row.username || "")),
267
289
  enabled: row.enabled !== false,
268
290
  hasToken: Boolean(row.hasToken),
269
291
  fields: accountFields(id, row)
@@ -523,7 +545,16 @@ function AuthinexPanel() {
523
545
  /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "axds-actions", children: [
524
546
  /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "axds-muted", children: "地址和密钥都由你填;插件本身不带任何地址或密钥。" }),
525
547
  /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Button, { type: "submit", variant: "primary", size: "md", disabled: disabled || key.trim() === "", children: "绑定" })
526
- ] })
548
+ ] }),
549
+ model.endpoint ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "axds-actions", children: [
550
+ /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { className: "axds-muted", children: [
551
+ "本机还记着上次的地址 ",
552
+ model.endpoint
553
+ ] }),
554
+ /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Button, { size: "sm", variant: "outline", disabled, onClick: () => {
555
+ setConfirmUnbind(true);
556
+ }, children: "解除绑定" })
557
+ ] }) : null
527
558
  ] }) : null,
528
559
  model.user ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
529
560
  /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "axds-row", children: [
@@ -646,14 +677,14 @@ function AuthinexPanel() {
646
677
  setConfirmUnbind(true);
647
678
  }, children: "解除绑定" }),
648
679
  /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "axds-muted", children: "解除后地址和密钥都会清掉,要重新填" })
649
- ] }),
650
- confirmUnbind ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "axds-confirm", children: [
651
- /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: "确认解除这台设备的绑定?" }),
652
- /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Button, { size: "sm", variant: "outline", onClick: () => {
653
- setConfirmUnbind(false);
654
- }, children: "取消" }),
655
- /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Button, { size: "sm", variant: "primary", disabled, onClick: onUnbind, children: "确认解除" })
656
- ] }) : null
680
+ ] })
681
+ ] }) : null,
682
+ confirmUnbind ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "axds-confirm", children: [
683
+ /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: "确认解除这台设备的绑定?" }),
684
+ /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Button, { size: "sm", variant: "outline", onClick: () => {
685
+ setConfirmUnbind(false);
686
+ }, children: "取消" }),
687
+ /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Button, { size: "sm", variant: "primary", disabled, onClick: onUnbind, children: "确认解除" })
657
688
  ] }) : null,
658
689
  /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("footer", { className: "axds-foot", children: [
659
690
  /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { children: [
package/lib/index.js CHANGED
@@ -215,7 +215,7 @@ var ROW_ID = "authinex-ds-plugin";
215
215
  var ROW_KEY = `${PACKAGE_NAME}#${ROW_ID}`;
216
216
 
217
217
  // src/controller.ts
218
- var VERSION = true ? "0.1.0" : "0.1.0";
218
+ var VERSION = true ? "0.1.2" : "0.1.0";
219
219
  var CREDENTIAL_REF = "AUTHINEX_DS_DEVICE";
220
220
  var ALLOWED_DETAILS = /* @__PURE__ */ new Set([
221
221
  "密钥无效",
@@ -499,14 +499,16 @@ function createController(options) {
499
499
  if (!parsed) {
500
500
  return { ok: false, message: PHRASES.invalid, state: fail("invalid") };
501
501
  }
502
- memory.endpoint = endpoint;
503
- if (memory.token && memory.phase === "bound") {
502
+ if (memory.token && memory.phase === "bound" && memory.endpoint === endpoint) {
504
503
  return { ok: true, state: snapshot() };
505
504
  }
505
+ memory.endpoint = endpoint;
506
506
  const existing = await readSecret();
507
- if (existing?.privateJwk && existing.deviceId) {
507
+ const samePlace = Boolean(existing?.endpoint) && existing?.endpoint === endpoint;
508
+ if (samePlace && existing?.privateJwk && existing.deviceId) {
508
509
  const restored = await restore();
509
510
  if (memory.token) return { ok: true, state: restored };
511
+ memory.endpoint = endpoint;
510
512
  }
511
513
  memory.phase = "binding";
512
514
  memory.detail = "";
@@ -541,9 +543,12 @@ function createController(options) {
541
543
  } catch (error) {
542
544
  const known = phaseError(error);
543
545
  const retryAfter = known?.retryAfter || 0;
544
- fail(known?.phase || "unreachable", known?.detail || "");
546
+ const phase = known?.phase || "unreachable";
547
+ fail(phase, known?.detail || "");
545
548
  memory.retryAfter = retryAfter;
546
- return { ok: false, message: phrase(known?.phase || "invalid"), state: snapshot() };
549
+ const text = phrase(phase);
550
+ const message = phase === "unreachable" && memory.endpoint ? `${text}(${memory.endpoint})` : text;
551
+ return { ok: false, message, state: snapshot() };
547
552
  }
548
553
  }
549
554
  async function unbind() {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@authinex/dsh-plugin",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "DeepSeek 里的 AuthineX 插件:问知识库、查工单、检索源码、只读定位,并用本人账号建单",
5
5
  "type": "module",
6
6
  "main": "./lib/index.js",