@authinex/dsh-plugin 0.3.10 → 0.3.12
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 +64 -48
- package/lib/client.js +235 -141
- package/lib/index.js +768 -112
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,72 +1,88 @@
|
|
|
1
1
|
# AuthineX DS 插件
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
装进 DeepSeek 之后,在对话里问云枢、查工单、对源码、做升级评估,并用你自己的 ONES / 氚云 / PMO 账号建单。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
覆盖云枢最新版和各历史版本,报表、打印也在范围内。安装、绑定和更新步骤见 `docs/安装与验收.md`。更新后本机私钥还在,就沿用原来的绑定。
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
## 产品结构
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
DeepSeek Harness 负责对话,并安装、启用本插件。插件把**技能**和**工具**放进同一次对话。技能是服务端已审核的做法,说明这类问题先看什么;工具按当前角色出现,调用服务端和个人 MCP 同一套入站处理。更新后,对话里就是这一批。
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
多数问题不进 Agent,工具直接查三处:
|
|
12
12
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
13
|
+
- **知识库**:手册、专家经验、版本说明。
|
|
14
|
+
- **代码索引**:GitLab 源码建成的检索,返回路径、行号和片段。
|
|
15
|
+
- **工单**:ONES、氚云、PMO。本地已有快照时先读快照。
|
|
16
|
+
|
|
17
|
+
两条 Agent 只接整段任务。委派后工具立刻返回,本机订阅进度,完成后结果回到这次对话:
|
|
18
|
+
|
|
19
|
+
- **客服 Agent**(问智能助手)自己再查知识库、代码索引和工单,答案带出处。名额和 Web 客服共用,记在 Redis。要读真实源码时,再交给编码执行。
|
|
20
|
+
- **编码 Agent**(线上定位)按版本检出源码,只读定位。多名额同时跑时,排队和分流都在编码 Agent 里完成。
|
|
21
|
+
|
|
22
|
+
四个系统是数据来源。ONES、氚云、PMO 提供工单,历史问题提炼成相似单和修复模式。GitLab 提供代码索引,定位时再检出对应版本的源码。知识库里还有手册和经验,不只有这四家同步来的内容。
|
|
23
23
|
|
|
24
|
-
|
|
24
|
+
### 直接查,还是交给线上 Agent
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
| 怎么走 | 什么时候用 | 代价 |
|
|
27
|
+
| --- | --- | --- |
|
|
28
|
+
| 直接查 | 默认。查事实、单号、代码位置、某版有没有某功能 | 秒级。本机带着整段对话连查连答 |
|
|
29
|
+
| 客服 Agent | 要跨知识、代码、工单几处才能拼出答案,或本机连查几次仍对不上 | 一两分钟。只收到这一句问题,看不到前面的对话;名额和 Web 客服共用 |
|
|
30
|
+
| 编码 Agent | 要在某一版真实源码里确认根因 | 几分钟。按版本检出源码读码 |
|
|
27
31
|
|
|
28
|
-
|
|
32
|
+
宿主有后台任务时,委派会立刻返回,结果自动回到对话。`brief` 把本机已查到的依据交给线上。没有后台任务的旧版 DeepSeek 仍在这次调用里轮询。方案见 `docs/本机查询与线上Agent协同-执行方案.md`。
|
|
29
33
|
|
|
30
|
-
|
|
34
|
+
一次提问:你用中文发问 → 插件按技能选工具 → 能直接查的就查知识库、代码索引或工单 → 整段问题才交给客服 Agent,要读源码才交给编码 Agent。回答带回出处。建单和提交经验先给你确认。
|
|
35
|
+
|
|
36
|
+
## 能做什么
|
|
37
|
+
|
|
38
|
+
| 你想 | 得到什么 |
|
|
39
|
+
| --- | --- |
|
|
40
|
+
| 问产品、手册、版本差异 | 知识库命中。用完整问句,可带版本 |
|
|
41
|
+
| 把整段问题交给助手 | 带出处的答案。提交后先继续聊,结果回到这次对话;名额满了直接说当前繁忙 |
|
|
42
|
+
| 按单号或标题查工单 | ONES、氚云、PMO 的单据 |
|
|
43
|
+
| 找历史上修过的同类问题 | 相似工单的根因和办法;或修复模式里的策略和关键文件 |
|
|
44
|
+
| 找某段实现 | 代码路径、行号和片段,可指定仓或分支 |
|
|
45
|
+
| 按报错或现象定位 | 只读结论:根因、文件、证据、置信度。结果回到这次对话 |
|
|
46
|
+
| 估算升级人天 | 先给模板,填完放回对话,回人天区间、风险和时间消耗点 |
|
|
47
|
+
| 建单 | 起草 ONES、氚云或 PMO 工单,你确认后才提交 |
|
|
31
48
|
|
|
32
|
-
|
|
49
|
+
服务端若下发了更多只读工具,会随目录出现,不用另装插件。
|
|
33
50
|
|
|
34
|
-
|
|
51
|
+
### 升级评估
|
|
35
52
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
53
|
+
1. 问「云枢 8.2 升 8.6 要多少人天」,拿到模板。
|
|
54
|
+
2. 填版本、数据库、二开规模等项目特征。
|
|
55
|
+
3. 把填好的文件放回对话,再说「按这个评估」。
|
|
56
|
+
4. 摘要给人天区间、置信度、风险和下一步;全文另给下载地址。
|
|
39
57
|
|
|
40
|
-
|
|
58
|
+
材料放在对话附件里,收 md、txt、docx、pdf、xml、json、yml,单个 12MB、合计 36MB。评估要几分钟,没跑完交回 `eval:` 任务号,用「查任务进度」接着取。
|
|
41
59
|
|
|
42
|
-
|
|
43
|
-
- 技能只写 DSH 自己的技能目录(默认 `~/.dsh/skills/`),不进项目。
|
|
60
|
+
### 工作上下文
|
|
44
61
|
|
|
45
|
-
|
|
62
|
+
配置页填「产品线 / 版本 / 客户」,或对话里用 `/ax-context 云枢 8.7 某客户`。
|
|
63
|
+
设好之后模型调工具时自动按这个版本和产品线查,建单自动带客户名,技能列表也跟着收窄。
|
|
64
|
+
留空就是自己判断。详见 [工作上下文-使用说明.md](docs/工作上下文-使用说明.md)。
|
|
46
65
|
|
|
47
|
-
|
|
48
|
-
- 升级插件不会让已经绑定的密钥失效。本机私钥还在就直接连上;页面如果又问密钥,把原来那把再贴一次,同一台机器会接回原来的绑定。
|
|
49
|
-
- ONES / 氚云 / PMO / GitLab 的账号只写回 AgentHub,配置页上不留明文。
|
|
50
|
-
- 权限由运营台角色和签发的密钥共同决定,角色不够的工具不会出现在列表里。
|
|
66
|
+
### 深度分析
|
|
51
67
|
|
|
52
|
-
|
|
68
|
+
配置页的开关(默认关闭),或对话里用 `/ax-deep 开` / `/ax-deep 关`。
|
|
53
69
|
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
- 没查到时会同时给下一步(换说法、放宽条件、换哪个工具),不只回一句「没查到」。
|
|
70
|
+
开着时每一轮都先用源码核实再答,答复按「结论 / 源码依据(路径:行号)/ 旁证 /
|
|
71
|
+
反证或未核实点 / 置信度」列;知识库和文档只作背景。**关着不是禁用源码分析**:
|
|
72
|
+
工具一个不少,只是不再强制每轮看代码,回到按问题复杂度自动选工具。
|
|
58
73
|
|
|
59
|
-
|
|
74
|
+
代价是更慢,换来的是证据更全。开关存在本机,和工作上下文分开。
|
|
75
|
+
详见 [深度分析-使用说明.md](docs/深度分析-使用说明.md)。
|
|
60
76
|
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
- 没有真正检索过就不写来源——不出处是**机制**,不是自律。
|
|
64
|
-
- 要通读某一篇,把它行尾的 `doc_id` 传回去就能取全文。
|
|
65
|
-
- 觉得某一条出处不对,可以只针对那一条反馈(`search_kb#S3`),不必把整段结果判错。
|
|
77
|
+
两种模式的测试(易中难六题,开和关各跑一遍,看模型实际怎么调工具)见
|
|
78
|
+
[深度分析-两模式测试.md](docs/深度分析-两模式测试.md)。
|
|
66
79
|
|
|
67
|
-
|
|
80
|
+
## 使用时记住
|
|
68
81
|
|
|
69
|
-
-
|
|
70
|
-
-
|
|
71
|
-
-
|
|
72
|
-
|
|
82
|
+
- 不填版本时,用该产品线的默认版本。对外号、清单号和分支名由服务端识别。
|
|
83
|
+
- 查知识、查单、查代码、定位都只读。写操作只有建单和提交经验,都先出确认卡;反馈只记一条「错了 / 不完整 / 有用」。
|
|
84
|
+
- 改本机工作区、推代码、拉官方包,用桌面端 AuthineX。技能写在 DeepSeek 的技能目录(默认 `~/.dsh/skills/`)。
|
|
85
|
+
- 访问地址和密钥在配置页填写,私钥留在本机。ONES / 氚云 / PMO 的账号写回服务端,页面显示登录名和已配置,不显示密码。
|
|
86
|
+
- 知识命中标 `[S1]`,代码命中标 `[C1]`,答复里用同一个号对回那一条。出处来自当次检索。
|
|
87
|
+
- 没查到会说明没找到,并给出下一步,例如换说法、放宽条件或换一个工具。
|
|
88
|
+
- 深度分析开着时再问「这版为什么」,答案会带文件行号;只查单号或配置路径时关掉更省时间。
|