前言¶
在 DeepSeek Harness（DSH）里做智能体，通常要接一家模型提供方，并尽量保留 tools / tool_calls、reasoning_content 等字段，让宿主工具循环能正常跑。WPS 灵犀（Lingxi Claw）面向桌面与网页用户，没有对外开放的官方 API；社区里也有经第三方网关转发的接入方式，但会多一跳，且不一定保留完整 agent 语义。
下面介绍维护者 xinstart-1 发布的 DSH 插件 dsh-connect-lingxi（社区分类：模型推理）。它把灵犀客户端实际使用的私有 app-server 协议接到 DSH，使官网侧的模型与模式出现在 DSH 模型选择器里，并支持原生工具调用与思考过程直通；同时在插件界面展示智点、签到与任务等账号侧信息。
这是什么¶
dsh-connect-lingxi 是 DSH 的模型提供方插件：DSH 通过本机回环上的 HTTP shim 与灵犀后端握手，把对话请求翻译为灵犀使用的链路（README 中概括为 /api/aioffice/v1/cowork/sessions → /api/public/v1/credits/runs → /api/public/v1/agent-runtime/chat/completions）。与「仅作问答通道」的接法不同，灵犀在此是完整 agent 通道——DSH 发出的 tool 定义由灵犀执行，返回的 tool_calls 回到 DSH，可当作 agent 后端使用。
协议细节见仓库内 docs/PROTOCOL.md。当前发行版本见 package.json：0.0.15，许可证 MIT；运行环境要求 Node ^22.19.0 || >=24.0.0，DSH >=0.2.1-rc.1 <0.3.0-0。
核心功能¶
模型目录与推理字段¶
- 模型清单与灵犀上游对齐：README 写明 11 个模型 + Pro / Max 两个模式，上下文、输出上限、倍率、徽标（
NEW/正式版/首发接入）、思考档位等来自真实/sessions/plans响应；未登录时使用静态兜底表，登录后动态拉取并随灵犀上下架变化。 - 思考档位按上游声明露出：9 个思考模型各 3 档（低 / 高 / 超高），4 个非思考模型无思考开关。
- 原生工具调用：上游
tool_calls直接进入 DSH 工具循环。 - 思考过程：
reasoning_content独立通道，不混入正文。 - 逐模型开关（模型页）：启用（是否出现在 DSH 模型选择器）与 image（是否接受图片输入），点选即生效；至少保留一个启用模型。
账号、智点与任务¶
- 凭证保存在本机
$DSH_HOME/lingxi-vault/credential.json（权限 0600），不进代码、仓库与日志，也不进入浏览器侧页面逻辑。 - 设置卡片显示智点余额，并单独统计 15 天内会过期 的临时积分部分。
- 每日签到与一次性任务：卡片可签到（已签到不重复发写请求）；一次性任务流程依赖
execution_status上报，详见docs/PROTOCOL.md§13。 - 账号池（较新版本 CHANGELOG）：多账号各存一份，可切换；支持逐账号勾选、批量签到与测试、每账号余额展示（做法对齐同作者的
dsh-connect-workbuddy）。
界面与操作¶
- 输入框左侧胶囊（如
灵犀 · 1,072）可查看余额与到期提醒，并进入「打开灵犀面板」。 - 可选侧栏整页「WPS 灵犀」（账号 / 模型 / 任务 / 设置 / 诊断），样式与
dsh-connect-workbuddy一致；关闭侧栏开关仅收起导航行，页面仍可通过胶囊打开。 - 界面开关包括自动签到、胶囊、侧栏入口、刷新间隔（1 / 5 / 10 / 30 / 60 分钟），点选即生效，无需单独「保存」。
本地架构（简述）¶
DSH
└─ PiAiAdapter (@deepseek-ai/dsh-llm-pi-ai)
└─ pi-ai provider (openAICompletionsApi)
└─ http://127.0.0.1:<随机端口>/v1/chat/completions ← 本地 shim（仅回环）
└─ 灵犀三步握手 + SSE 翻译
shim 使用 node:http 在 127.0.0.1 上随机端口监听，不占固定端口、不对外暴露；宿主路由仅接受回环 Host，cookie 不进入页面。
与同协议经 Magpie 网关的 @kevinfx/magpie-wps-lingxi 相比，本插件不依赖 Magpie，直连灵犀所用协议；与 dsh-connect-workbuddy 的差异见仓库 docs/CHANGELOG-0.0.1.md 中「与 workbuddy 的差异有意为之」一节。
安装与启用¶
在已安装 DSH 桌面侧的环境下，使用资料中的安装命令：
dsh plugin --profile desktop add dsh-connect-lingxi
装完后重启 DSH。插件在 DSH 进程权限下运行，安装前建议在 GitHub 仓库 查看源码与 MIT 许可证，自行评估是否满足你的环境与合规要求。
登录与典型用法¶
登录（无需手粘 cookie 为主路径）¶
插件按「用户成本」从低到高尝试登录态：
- 本机灵讯客户端（Windows 上为
%APPDATA%\kdesk）——已安装并登录时零交互。 - 日常浏览器（Edge / Chrome / Brave / 360）——在浏览器中使用过灵犀网页版即可。
- 卡片「登录灵犀」——拉起浏览器窗口由用户登录，插件只读取登录后的 cookie，不接触密码。
手粘 cookie 仍可作为最后兜底。若提示「库被浏览器独占锁定」，需先关闭占用 cookie 库的浏览器再刷新；与「未登录」的提示文案分开。
在 DSH 里使用¶
- 完成安装并重启后，在插件设置页确认已登录、智点与模型目录正常。
- 在 DSH 模型选择器中选用灵犀提供的模型与 Pro / Max 模式；按需在该插件模型页勾选「启用」与「图片」。
- 像使用其他支持 tools 的提供方一样发起对话；需要 agent 能力时，DSH 侧定义的 tools 会经灵犀执行，
tool_calls与reasoning_content按原生字段回传。 - 需要维护账号侧活动时，在设置卡片或侧栏「WPS 灵犀」页进行签到、任务与刷新；输入框胶囊可快速查看余额与到期提醒。
适用场景与注意¶
适合：已在用 DSH 做智能体或长对话开发、希望直接使用 WPS 灵犀账号与官网模型目录，且需要 tools / reasoning 直通 而非仅文本补全的用户；也可与多账号、签到领智点等运维需求一并放在插件 UI 中处理。
注意：
- 灵犀无公开开放平台 API，本插件依赖私有协议与登录态，上游变更可能影响行为；模型倍率与上下架以登录后拉取的目录为准。
- 插件随 DSH 进程权限访问本机 cookie 与
$DSH_HOME/lingxi-vault/，仅应在信任的环境中安装。 - 社区目录 skillhub.cn 插件页 与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方应用商店从属关系；星标与版本以你访问时页面与
package.json为准（撰写时仓库 README 描述能力自 v0.0.1 起逐步迭代至当前版本）。
结尾¶
dsh-connect-lingxi 把 WPS 灵犀接进 DSH 的模型与 agent 链路：11 个模型与双模式进选择器，工具与思考字段直通，本机 vault 存凭证，界面侧管智点、签到与模型开关。若要查看简介与归类，可打开社区目录页；若要安装命令、协议与 CHANGELOG，以 GitHub 仓库为准。
- 目录页：https://www.skillhub.cn/plugins/xinstart-1/dsh-connect-lingxi
- GitHub：https://github.com/xinstart-1/dsh-connect-lingxi
