dsh-kdocs-connector

Readme

# dsh-kdocs-connector

[![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-plugin-4b8bf5?logo=github)](https://github.com/deepseek-ai/deepseek-harness)
[![topic: dsh-plugin](https://img.shields.io/badge/topic-dsh--plugin-2ea44f)](https://github.com/topics/dsh-plugin)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

**金山文档（WPS 个人账号）连接器** —— 一个 DeepSeek Harness 永久插件：用户在浏览器中自行登录 WPS / 金山文档账号，即可在 DSH 里查看、引用、编辑、导出个人云文档，并可用自然语言对文档进行对话式处理。

基于金山官方 [`kdocs-cli`](https://github.com/kdocs-app/kdocs-skill)（个人账号专用，凭据存系统钥匙串，不落明文）。

## 功能

| 模块 | 说明 |
|---|---|
| 🔐 登录 | 浏览器 OAuth 网页登录（个人账号），或从 kdocs.cn 复制 Token 粘贴登录；凭据存系统钥匙串 |
| 📁 浏览 | 我的云文档（文件夹导航 + 面包屑）、最近访问、⭐ 星标、👥 共享（收到的 / 我分享的）、关键词搜索 |
| 📄 文件操作 | 打开（浏览器在线查看/编辑）、链接（复制到剪贴板）、**引用**、下载（浏览器下载） |
| 💬 引用到对话 | 点击「引用」→ 自动关闭设置页回到对话，输入框只插入一行 `📄金山文档「文件名」链接` 标记；输入自然语言（如"帮我总结"）发送后，模型通过 `kdocs_read` 按链接读取文档并执行指令 |
| ➕ 新建 | 空白在线文档（otl / docx / xlsx / ksheet / dbt / pptx / xls / doc / ppt）与文件夹 |
| 🧠 模型工具 | `kdocs_status` / `kdocs_list` / `kdocs_search` / `kdocs_read`（支持链接）/ `kdocs_link` / `kdocs_download` / `kdocs_create` |
| 🧭 位置记忆 | 面板关闭（含「引用」自动关闭）后重新打开，恢复到上次的标签页 / 文件夹路径 / 搜索结果 |

## 安装

依赖：官方 `kdocs-cli`（首次使用前安装）：

```sh
curl -fsSL https://raw.githubusercontent.com/kdocs-app/kdocs-skill/master/scripts/setup.sh -o /tmp/setup.sh \
  && KDOCS_CLI_VERSION=2.5.29 bash /tmp/setup.sh
```

安装本插件（需重启 harness 生效）：

```sh
dsh plugin --profile web add https://github.com/Tang-mm95/dsh-kdocs-connector
```

或直接在对话里让 Agent 安装：

```
帮我安装这个插件 https://github.com/Tang-mm95/dsh-kdocs-connector
```

装好后：**设置 → 金山文档** → 点「🌐 网页登录」，用 WPS 个人账号完成授权（企业账号不支持）。

## 结构

| 部件 | 文件 | 作用 |
|---|---|---|
| Bundle 清单 | `package.json` | 声明 `dsh.bundle.patch`（host 层）+ `dsh.client`（浏览器模块） |
| Patch 层 | `cordis.patch.yml` | 把插件 host 行插入 Loader 树 |
| Host 半 | `lib/index.js` | 封装 kdocs-cli（认证 / 云盘 / 读取 / 下载 / 新建）、同源路由 `POST /api/kdocs/call`、`kdocs_*` 模型工具 |
| Client 半 | `lib/client.js` | `__ModuleLoader__` bundle：设置页「金山文档」面板 + 输入区引用桥（渲染 null） |

## 说明与限制

- 仅支持 **WPS 个人账号**；企业账号请使用 [WPS365 CLI](https://github.com/wps365-open/cli)
- 「下载」通过浏览器下载链接完成（服务器直连下载需要浏览器登录态，会 403）
- 「引用」会把文件标记写入**插件所在会话**的输入框；在其它会话打开设置面板时若桥接不可用，会降级为面板内预览
- 每次更新需重启 harness

## License

[MIT](LICENSE)