dsh-connect-lingxi 0.0.0-stage → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xinstart-1
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,105 @@
-# Temporary Holding Version
+# dsh-connect-lingxi
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> 把 **WPS 灵犀（Lingxi Claw）** 接入 **DeepSeek Harness**：原生 `tools` / `tool_calls` /
+> `reasoning_content` / `usage` 直通，14 个模型直接出现在 DSH 的模型选择器里。
+> **v0.0.1 起**，插件详情页还会告诉你智点余额、快过期的临时积分、今天签没签到，
+> 输入框左侧有一枚可点的读数。
+
+## 它是什么
+
+灵犀**没有开放平台 API**。本插件走的是灵犀桌面客户端自己使用的私有 app-server 协议
+（`/api/aioffice/v1/cowork/sessions` → `/api/public/v1/credits/runs` →
+`/api/public/v1/agent-runtime/chat/completions`），协议细节见 [`docs/PROTOCOL.md`](docs/PROTOCOL.md)。
+
+与「问问 ima」那种模型通道不同，灵犀是**完整 agent 通道**：DSH 发过去的 tool 定义会
+被灵犀执行，返回的 `tool_calls` 会回到 DSH —— 可以真正当 agent 后端用。
+
+## 能力
+
+- **14 个模型**：DeepSeek V4.1 Flash（1M 上下文，0.12x 倍率）、V4 Pro、Kimi-K3、
+  GLM-5.3 / 5.3-Flash、Qwen3.8-Max / Flash、minimax-M3、Doubao-Seed-2.1 Pro、
+  MiMo-V2.6 Pro、Auto / Pro / Max 模式。
+- **原生工具调用**：上游返回的 `tool_calls` 直接进 DSH 的工具循环。
+- **思考过程**：`reasoning_content` 独立通道，不混进正文。
+- **动态模型目录**：登录后从 `/api/aioffice/v1/sessions/plans` 拉取账号真实目录，
+  跟随灵犀上下架；未登录时用静态兜底表。
+- **凭证不出本机**：只存 DSH 凭据库（加密落盘），不进代码、不进仓库、不打日志。
+- **智点余额**：设置卡片实时显示剩余额度。**新增**：还会单独算出「15 天内会过期」的
+  那部分——总额里看不出「有多少马上作废」，而那是真正该急着用的。
+- **每日签到 / 一次性任务**（新）：卡片上有签到按钮，点一下就领。已签到不会重复发写请求。
+  三个一次性任务**都能做**：专家模式与客户端由一次带 `client_type` / `session_mode`
+  的对话带出，群聊任务走「WS 使用信号 → 建群 → 立刻解散」——都靠
+  `execution_status` 生命周期上报，`docs/PROTOCOL.md` §13 有完整流程。
+- **模型目录与倍率**（新）：卡片列出每个模型的名称、倍率、上下文、思考/图片支持与启用状态。
+- **输入框读数**（新）：输入框左侧一枚胶囊（`灵犀 · 1,072`），点了弹出余额与到期提醒。
+- **界面开关**（新）：自动签到 / 胶囊 / 侧栏入口 / 刷新间隔（1·5·10·30·60 分钟），
+  点一下即生效，不走「保存」。
+
+## 安装
+
+```bash
+dsh plugin --profile desktop add dsh-connect-lingxi
+```
+
+装完**重启 DSH**。
+
+### 登录：不需要手粘 cookie
+
+插件按「用户成本」从低到高自己找登录态：
+
+1. **本机灵犀客户端**（`%APPDATA%\kdesk`）—— 装了并登录过，零交互。
+2. **你日常的浏览器**（Edge / Chrome / Brave / 360）—— 在浏览器里用过灵犀网页版就够。
+3. **点一下登录** —— 卡片上的「登录灵犀」拉起一个浏览器窗口，你自己登录，
+   插件只读登录后的 cookie。**从不接触密码。**
+
+手粘 cookie 仍然保留，但只是**最后的兜底**，不是主路径。
+
+> 如果插件提示「库被浏览器独占锁定」：那是浏览器正在运行，关掉它再刷新即可。
+> 这与「没登录」是两件事，提示文案会分开说。
+
+## 架构
+
+```
+DSH
+ └─ PiAiAdapter (@deepseek-ai/dsh-llm-pi-ai)
+     └─ pi-ai provider (openAICompletionsApi)
+         └─ http://127.0.0.1:<随机端口>/v1/chat/completions   ← 本地 shim（仅回环）
+             └─ 灵犀三步握手 + SSE 翻译
+
+浏览器（设置卡片 / 输入框胶囊）
+   ├─ GET  /plugins/dsh-connect-lingxi/status    ← 已归一好的展示数据
+   └─ POST /plugins/dsh-connect-lingxi/action    ← 白名单动作（refresh / 签到 / 领取 / 开关）
+```
+
+shim 用 `node:http` 监听 `listen(0, "127.0.0.1")`——内核随机分配端口、只连回环，
+不占固定端口、不对外暴露。宿主路由同样只接受回环 `Host`，cookie 永远不进页面。
+
+## 与其它 provider 的关系
+
+| 插件 | 定位 |
+| --- | --- |
+| `dsh-connect-lingxi`（本插件） | WPS 灵犀 → DSH，原生 agent 通道 + 智点/签到卡片 |
+| `dsh-connect-workbuddy` | WorkBuddy → DSH，原生 agent 通道 + 账号池/积分/签到 |
+| `@kevinfx/magpie-wps-lingxi` | 同一协议，但走 Magpie 网关（多一跳） |
+
+本插件不依赖 Magpie。与 workbuddy 的功能差异见
+[`docs/CHANGELOG-0.0.1.md`](docs/CHANGELOG-0.0.1.md#与-workbuddy-的差异有意为之)。
+
+## 开发
+
+```bash
+node scripts/test-report.mjs    # 逐文件跑测试，结论写进 test-report.txt
+node node_modules/typescript/bin/tsc --noEmit -p tsconfig.json
+node node_modules/tsdown/dist/run.mjs && node scripts/copy-client.mjs   # = npm run build
+```
+
+- `src/client/bundle.js` 是**手写的经典脚本**（不是 TS、不进 bundler）：
+  宿主用 `<script>` 加载它，`require('react')` 解析到宿主自己的 React。
+  被打包就会变成两份 React，hooks 立刻炸。
+- 客户端槽位契约（哪个槽位用 `id`、哪个用 `key`、props 有哪些）见
+  [`docs/CLIENT-API.md`](docs/CLIENT-API.md)——全部从本机 DSH 的 asar 与三个
+  已在跑的同级插件产物里交叉验证过。
+
+## 许可
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,7 @@
+# dsh-connect-lingxi bundle patch: one row, dual-face (node half = the package's
+# default export, browser half = ./client via the `dsh.client` declaration).
+# The row name MUST equal the package name — the client-modules node half
+# resolves `require.resolve('<row-name>/package.json')` to find the package.
+- insert:
+    - id: dsh-connect-lingxi
+      name: 'dsh-connect-lingxi'