@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.
Files changed (4) hide show
  1. package/README.md +64 -48
  2. package/lib/client.js +235 -141
  3. package/lib/index.js +768 -112
  4. package/package.json +2 -2
package/README.md CHANGED
@@ -1,72 +1,88 @@
1
1
  # AuthineX DS 插件
2
2
 
3
- 在 DeepSeek 里直接问产品、查工单、检索源码、做线上定位,并用你自己的 ONES / 氚云 / PMO 账号建单。
3
+ 装进 DeepSeek 之后,在对话里问云枢、查工单、对源码、做升级评估,并用你自己的 ONES / 氚云 / PMO 账号建单。
4
4
 
5
- 插件基于云枢低代码平台,覆盖云枢最新产品版本及各历史版本,报表、打印两条产品线也在范围内。
5
+ 覆盖云枢最新版和各历史版本,报表、打印也在范围内。安装、绑定和更新步骤见 `docs/安装与验收.md`。更新后本机私钥还在,就沿用原来的绑定。
6
6
 
7
- 这篇只写能做什么、不做什么。安装、绑定、更新和对话里的用法见 `docs/安装与验收.md`。
7
+ ## 产品结构
8
8
 
9
- ## 功能
9
+ DeepSeek Harness 负责对话,并安装、启用本插件。插件把**技能**和**工具**放进同一次对话。技能是服务端已审核的做法,说明这类问题先看什么;工具按当前角色出现,调用服务端和个人 MCP 同一套入站处理。更新后,对话里就是这一批。
10
10
 
11
- 绑定后,对话里会出现这些工具:
11
+ 多数问题不进 Agent,工具直接查三处:
12
12
 
13
- | 工具 | 做什么 |
14
- | --- | --- |
15
- | 咨询问题 | 检索云枢知识库(产品手册、专家经验、源码说明、版本说明)。用完整中文问句,可带版本收窄 |
16
- | 查询工单 | 按单号查 ONES、氚云或 PMO;没有单号时按标题筛 |
17
- | 查询相似工单 | 按现象检索历史上修过的相似工单,给出当时的根因和解决办法 |
18
- | 修复模式 | 按现象检索团队修复模式库:问题模式、根因、修复策略、关键文件 |
19
- | 代码检索 | 检索云枢代码索引,返回文件路径、行号和代码片段。可指定仓或分支 |
20
- | 线上源码定位 | 按版本读线上源码做只读定位,返回根因和位置,通常 2–4 分钟;用「查任务进度」取结论 |
21
- | 问智能助手 | 把整个问题交给智能助手,返回答案和出处。服务端会先给一个任务号,插件在同一次调用里等约 85 秒;没答完就交回进度,用「查任务进度」取答案。助手名额满时直接回「当前繁忙」 |
22
- | 创建工单 | 起草 ONES、氚云或 PMO 工单,你确认后才提交 |
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
- **覆盖工单系统**:可查 ONES、氚云、PMO;可建单也是这三家。
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
- - 不改你工作区里的文件、不碰仓库、不推代码。要动本机用桌面端 AuthineX。
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
- - 知识库命中带编号 `[S1]`、代码命中带 `[C1]`,答复里标同一个号就能对回具体哪一条。
62
- - 回答末尾分「已引用」与「仅检出」两组:撑住结论的排前面,检索到但没用上的也不藏。
63
- - 没有真正检索过就不写来源——不出处是**机制**,不是自律。
64
- - 要通读某一篇,把它行尾的 `doc_id` 传回去就能取全文。
65
- - 觉得某一条出处不对,可以只针对那一条反馈(`search_kb#S3`),不必把整段结果判错。
77
+ 两种模式的测试(易中难六题,开和关各跑一遍,看模型实际怎么调工具)见
78
+ [深度分析-两模式测试.md](docs/深度分析-两模式测试.md)。
66
79
 
67
- **检索按需要分档**
80
+ ## 使用时记住
68
81
 
69
- - 只想确认有没有写过用浅档(`depth=fast`),要一段能贴进答复的正文才用深档。
70
- - 代码检索有 `detail=stats/snippet/full` 三档,先看命中面再决定读哪个文件。
71
- - 线上定位的结论按「根因 / 文件 / 证据 / 置信度 / 反证 / 过程」分块,
72
- 会写明读了几个文件、耗时多久——结论是怎么来的可以查。
82
+ - 不填版本时,用该产品线的默认版本。对外号、清单号和分支名由服务端识别。
83
+ - 查知识、查单、查代码、定位都只读。写操作只有建单和提交经验,都先出确认卡;反馈只记一条「错了 / 不完整 / 有用」。
84
+ - 改本机工作区、推代码、拉官方包,用桌面端 AuthineX。技能写在 DeepSeek 的技能目录(默认 `~/.dsh/skills/`)。
85
+ - 访问地址和密钥在配置页填写,私钥留在本机。ONES / 氚云 / PMO 的账号写回服务端,页面显示登录名和已配置,不显示密码。
86
+ - 知识命中标 `[S1]`,代码命中标 `[C1]`,答复里用同一个号对回那一条。出处来自当次检索。
87
+ - 没查到会说明没找到,并给出下一步,例如换说法、放宽条件或换一个工具。
88
+ - 深度分析开着时再问「这版为什么」,答案会带文件行号;只查单号或配置路径时关掉更省时间。