前言¶

在 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 为主路径）¶

插件按「用户成本」从低到高尝试登录态：

1. 本机灵讯客户端（Windows 上为 %APPDATA%\kdesk）——已安装并登录时零交互。
2. 日常浏览器（Edge / Chrome / Brave / 360）——在浏览器中使用过灵犀网页版即可。
3. 卡片「登录灵犀」——拉起浏览器窗口由用户登录，插件只读取登录后的 cookie，不接触密码。

手粘 cookie 仍可作为最后兜底。若提示「库被浏览器独占锁定」，需先关闭占用 cookie 库的浏览器再刷新；与「未登录」的提示文案分开。

在 DSH 里使用¶

1. 完成安装并重启后，在插件设置页确认已登录、智点与模型目录正常。
2. 在 DSH 模型选择器中选用灵犀提供的模型与 Pro / Max 模式；按需在该插件模型页勾选「启用」与「图片」。
3. 像使用其他支持 tools 的提供方一样发起对话；需要 agent 能力时，DSH 侧定义的 tools 会经灵犀执行，tool_calls 与 reasoning_content 按原生字段回传。
4. 需要维护账号侧活动时，在设置卡片或侧栏「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