@authinex/dsh-plugin
v0.3.5
Published
DeepSeek 里的 AuthineX 插件:问知识库、查工单、检索源码、只读定位,并用本人账号建单
Readme
AuthineX DS 插件
在 DeepSeek 里直接问产品、查工单、检索源码、做线上定位,并用你自己的 ONES / 氚云 / PMO 账号建单。GitLab 和这三家一样,配在同一份集成账号里。
装好后由你填访问地址和密钥完成绑定。插件本身不带任何默认地址、公司信息或密钥。
功能
绑定后,对话里会出现这些工具:
| 工具 | 做什么 | | --- | --- | | 咨询问题 | 检索云枢知识库(产品手册、专家经验、源码说明、版本说明)。用完整中文问句,可带版本收窄 | | 查询工单 | 按单号查 ONES、氚云或 PMO;没有单号时按标题筛 | | 查询相似工单 | 按现象检索历史上修过的相似工单,给出当时的根因和解决办法 | | 修复模式 | 按现象检索团队修复模式库:问题模式、根因、修复策略、关键文件 | | 代码检索 | 检索云枢代码索引,返回文件路径、行号和代码片段。可指定仓或分支 | | 问智能助手 | 把整个问题交给智能助手,返回答案和出处 | | 线上源码定位 | 按版本读线上源码做只读定位,返回根因和位置;通常 2–4 分钟 | | 查任务进度 | 查上面那条定位任务的进度和结论 | | 创建工单 | 起草 ONES、氚云或 PMO 工单,你确认后才提交 |
服务端如果下发了工具目录,上面这些以外的只读工具会跟着出现,不用发新插件。写操作仍然只有三把,而且建单、提交经验必须先点确认卡:
| 工具 / 命令 | 做什么 |
| --- | --- |
| 提交经验 submit_experience | 把这次的问题和办法交给服务端,确认卡上能看到标题和问题摘要。取消后同一草稿不会再提 |
| 反馈 report_feedback | 给一条工具结果记「错了 / 不完整 / 有用」。不弹确认卡 |
| /ax-context | 设置这一轮的产品线、版本、客户。例如 /ax-context 云枢 8.7 某客户,清空用 /ax-context 清空 |
配置页分两个页签:
概览
- 可用功能:这一把密钥当前能用哪些工具。
- 工作上下文:产品线(云枢 / 报表 / 打印)、版本、客户。保存后,模型调用工具时没填的版本和产品线会自动补上;建单没填客户也用这里的。也可以在对话里用
/ax-context改。 - 集成账号(可折叠):GitLab、ONES、氚云、PMO。每家前面是和个人设置一样的平台图标。与 AuthineX、运营台「个人设置」是同一份数据——已经配过的直接拉下来用,在这里新填的写回 AgentHub。每家可以单独启用或停用,填完先测连接再保存。默认收起,标题上直接写「几家已配置」;收起不影响查单建单。GitLab 只用来对齐这份凭据,不在插件里推代码。
- 更新:检查到新版本后可以直接在页面里更新,装完重启智能问答生效,绑定和账号都不动。
- 解除绑定:二次确认后清掉本机的地址和密钥,服务端作废这台设备。
技能
把 AgentHub 技能库里的技能装到本机,让 DeepSeek 在本机就能用上团队沉淀的定位/澄清/二开经验。宿主支持技能源时,页头会写「技能已由插件在线提供,无需安装」:目录和正文由插件按当前产品线和版本在线取,不必再装一遍。下载和装到本机仍留着,宿主没有技能源、或服务端暂时连不上时用它兜底。
- 列表:从服务端技能库分页拉取,一页 8 条,标题下直接显示「适用场景」,右侧是使用频次(被召回的次数),默认从高到低。满 5 次的标「高频」并描一圈强调色,一次都没有的写「未使用」。可按「平台技能 / 待审核 / 全部」筛。平台技能是审核通过、可以装的;待审核里能看到还没定稿的,包括别人交上来的个人技能。
- 个人技能:点「导入个人技能」,粘贴或选择一篇
SKILL.md提交。先进入待审核,后台审核通过后才出现在平台技能里,其他用户可以下载、装到本机,模型也能用。这一行会标成「某某 上传」。同名的平台技能不会被盖掉;自己那条还在待审核时,再交一次是更新。 - 检索:搜技能名、适用场景,或直接填编号(
2470/skill-2470)。筛选和分页都在服务端做,不把全表拖到本机。 - 展开:点一行展开,看编号、使用频次、适用范围(产品线 × 版本,空的就是通用)、更新时间、来源。
- 下载:存成
<编号>-SKILL.md,自己放进任何编辑器的技能目录。 - 装到本机:落到
$DSH_HOME/skills/<编号>/SKILL.md(默认~/.dsh/skills/),DSH 下次起会话就能读到。已装的行会标「已装」。只有审核通过的平台技能能装——待审核和已下线的不装,避免模型吃到没定稿的口径。
技能只写 DSH 自己的技能目录:不进你的工作区、不碰仓库、不改项目文件。
插件只做「看和判断」,外加把集成账号写回 AgentHub:不改你工作区里的文件、不推代码。要动本机用桌面端 AuthineX。GitLab 的 Token 和 ONES / 氚云 / PMO 一样,只进 AgentHub,配置页上不留明文。
权限由运营台角色和签发的密钥共同决定,角色不够的工具不会出现在列表里。
安装
包名 @authinex/dsh-plugin,已发布到 npm。
方式一:插件页
左侧「插件」→ 右上「添加插件」→ 输入 @authinex/dsh-plugin → 安装。
国内网络在对话框的「安装源」里选中国镜像源(registry.npmmirror.com)。npm run release 会在官方源能下载后通知这个镜像来拉。若仍提示找不到,选「自定义地址」填下面任意一个:
https://mirrors.cloud.tencent.com/npm/https://mirrors.huaweicloud.com/repository/npm/
方式二:命令行
dsh plugin --profile <你的 profile> add @authinex/dsh-plugin国内网络加 --registry=https://registry.npmmirror.com/。
装完重启智能问答。插件清单只在 Host 启动那一刻拼出来,不重启看不到。
刚发布完可能提示「未找到相关插件」——官方源的安装包有时要几分钟才下到 CDN。
npm run release会等到官方源和中国镜像都能拉到这一版再结束。
刚发布不到 24 小时的版本会被 pnpm 的供应链策略(
minimumReleaseAge)暂缓,直接装会拿到上一个版本。要新版本就装精确版本号@authinex/[email protected];插件页会先卸掉当前版本再装。
装好之后,插件页里这一行左边就是 AuthineX 的四色块图标:添加插件、安装确认、插件列表、插件详情用的是同一张。图标来自清单顶层的 icon 字段,Host 直接读包里的 icon.svg,不需要先启用插件。换图标只改 icon.svg 和 package.json 里的路径,记得把它留在 files 里,否则发包之后图标会丢。
绑定
左侧「插件」→ 点这一行右侧的「Configure」,页面上有两个输入框:
- 访问地址:你所在环境的 AgentHub 地址,必须是完整的
http://或https://,不能带账号密码。 - 密钥:管理员签发的
auds-t-…(测试)或auds-p-…(生产)。
两个都填对才能绑上。几个约定:
- 密钥一次性,兑换成功即作废。
- 服务端默认测试、生产密钥都收;运营台若显式配了
DS_PLUGIN_ENV,前缀和它对不上只显示「密钥无效」。 - 绑定成功后地址和私钥一起存进本机凭据,重启自动登录,不用重填。
- 已经连上时再贴一把新密钥,也会拿去兑换。运营台要重新打开「DS 插件密钥」,状态才会从「待绑定」变成「已绑定」。
- 换地址要先「解除绑定」再重填。
- 验证通过后才会出现使用者、功能列表和账号;没通过之前这些都不显示。
集成账号
在配置页展开某一家填字段,「测试连接」通过才能保存。GitLab 填账号、地址和 Token,状态是「已配置」,不写「可建单」。
- 卡片上的账号一律打码:邮箱
z****@example.com,手机号158****3***。展开表单才能看到完整值,因为保存时要按原值回写。 - 密码 / Token 框留空表示不修改原来的。
- 角色只给了读权限时,那一家显示「已配置,只能查」。
- 停用某一家后,它不再参与建单和查单。
更新
点「检查更新」先取服务端清单;服务端没配更新源(清单 404)时,退回 npm 的 latest 标签比较版本,这时只能发现版本号,安装仍让 DeepSeek 的安装器按 @authinex/[email protected] 去 npm 取。
点「更新到 x.y.z」并确认,插件会调用 DeepSeek 自己的安装器装新版本。装完重启智能问答生效,绑定和账号都不动。
在对话里用
直接说人话就行,模型会自己选工具:
- 「云枢 8.7 表单设计器的显示条件为什么不生效」→ 查知识库
- 「DTS-1234 这个单什么情况」→ 查工单
- 「登录页白屏,帮我看下大概在哪个文件」→ 线上源码定位,然后用「查任务进度」取结论
- 「给 ONES 建个单,标题是登录失败」→ 起草,弹出确认卡,你点创建才提交
取消确认卡之后,同一个草稿不会再自动提交。
