dsh-mcloud 0.2.1 → 0.3.1

package/CHANGELOG.md

@@ -6,7 +6,8 @@
 
 | 插件版本 | 支持的 DeepSeek Harness | 支持的 Node |
 | --- | --- | --- |
-| **0.2.x** | **>= 0.2.1-rc.5，< 0.3.0** | >= 22 |
+| **0.3.x** | **>= 0.2.1-rc.5，< 0.3.0** | >= 22 |
+| 0.2.x | >= 0.2.1-rc.5，< 0.3.0 | >= 22 |
 | 0.1.x | >= 0.2.1-rc.5，< 0.3.0 | >= 22 |
 
 > 插件用到了 `tools/pre-execute`（写入审批闸）和 `webServer.register`（HTTP 路由）
@@ -16,6 +17,80 @@
 
 ---
 
+## 0.3.1
+
+**安全修复：`/api/dsh-mcloud/*` 现在有 Host / Origin 准入。**
+
+DSH 的 `webServer.register` 只按路径分发，**不做**准入。插件原来只查了「连接是不是来自
+环回地址」，而你自己浏览器里开着的任意网页发出的请求，`remoteAddress` 一样是 `127.0.0.1`。
+于是任意网页都能读 `/list`、`/search`、`/status`，也能打 `/mkdir`、`/remove`、`/move`、
+`/upload` 等写接口。原有的 `x-dsh-mcloud: 1` **不是安全边界**，静态请求头任何网页都能自己加。
+
+现在所有路由统一过一道闸（`lib/request-guard.js`）：
+
+- **Host** 必须是本部署自己的 authority（环回 / 监听器绑定 IP / `allowedAuthorities`），
+  端口要对得上监听器；解析不出、带 userinfo、带路径的一律拒
+- **Origin** 必须与 Host 同源；`null`（沙箱 iframe、`file:` 页面）直接拒
+- **`Sec-Fetch-Site: cross-site`** 一票否决
+
+新增 24 项回归测试（`npm test`）。其中 4 条攻击路径用例在 0.3.0 上全部失败，本版全部通过。
+
+**新增配置**：`allowedAuthorities`，只有挂了反代或用自定义域名访问时才需要。
+
+0.3.0 的功能与界面不变。
+
+---
+
+## 0.3.0
+
+**界面重做为资源管理器风格**（登录页保持不变）。
+
+**布局**
+
+- 左边是文件夹树，可以逐级展开；点哪个文件夹，右边就显示它的内容
+- 左上角显示账号、授权有效期和下载目录；右上角是操作按钮，顺序为：传输记录 / 授权 / 退出 / 刷新
+- 顶部栏底部有一条贯通全宽的容量条，容量数值居中压在条里（白字加深色描边，已用段和未用段上都看得清，亮暗主题均适配）
+- 文件夹树与右侧列表之间有可拖动的分隔线（热区 14px，悬停才显形，双击恢复默认宽度）
+- 文件列表的「大小」列左右各有一条竖线，从表头贯穿到列表里的每一行；两条竖线都能拖动调整列宽，双击恢复默认
+- 列宽拖动有上下限（大小列 ≥64px、时间列 ≥88px，且永远给名称列留出 ≥120px），怎么拖都不会把某一列压成一条线
+- 左右两条表头横线（左树「文件夹」与右侧「名称」）高度一致，能对齐
+- 窄面板（右侧主栏宽度 <620px）时自动收起「修改时间」列；判断依据是主栏自身宽度而不是视口宽度，所以对话区只占窗口一小块时也能正确收起
+- 面板会实测父容器的像素高度来撑满，不再依赖 `height:100%`（后者在 flex 子项里会静默失效，导致整个面板被内容撑长、列表滚不动、底部进度条被顶到最下面）
+- 高度测量做了四级跨浏览器兜底：父级 clientHeight → getBoundingClientRect → 再上一层父级 → visualViewport 估算；并监听 resize、orientationchange、visualViewport 变化和 ResizeObserver，窗口缩放、横竖屏切换、移动端地址栏伸缩都能跟上
+- 页面自适应：不同尺寸都能撑满，窄屏自动收起侧栏
+
+**文件浏览**
+
+- 列表滚动到底自动加载下一批，不再需要点按钮
+- 列表行无边框，靠整行底色区分悬停与选中
+- 新增文件搜索（在当前目录及子目录内按文件名查找）
+- 点击目录时复核「有没有下一级」，空目录不会显示展开箭头
+
+**传输**
+
+- 底部一条传输进度条：空闲时是一条窄线，传输时变粗变蓝并显示文件名与百分比
+- 完成后停留 5 秒，再用 1.5 秒缓缓褪色融入背景
+- 进度条至少显示 1.2 秒，小文件下载也不会一闪而过
+- **目录分页从每页 10 项改为 50 项**：实测每次请求的固定开销才是瓶颈，一次多拿几十条几乎不要钱。几百张图片的大目录现在翻页次数少了约 5 倍
+- 右上角「传输记录」可查看本次会话的记录（进行中 / 已完成 / 失败 / 已取消分组，多时列表内滚动）
+- 记录里上传显示向上箭头、下载显示向下箭头
+- 支持一键清空记录：只删列表，网盘和本地文件都不受影响，正在传输的任务保留
+
+**其他**
+
+- 修复「只有文件、没有子文件夹」的目录仍然显示展开箭头的问题（之前判的是「目录里有没有东西」，现在只认「有没有子文件夹」，并会翻最多 3 页确认）
+- 修复目录被清空后箭头仍然显示：判定缓存 45 秒过期，增删改和手动刷新会立即作废重建
+- 修复小文件下载时传输进度条完全不出现的问题（起任务时就点亮进度条，即使任务瞬间完成也能看到完整过程）
+- 修复大目录下「滚到底就不动了」：客户端请求加了 30 秒超时、加载标志加了 40 秒兜底，避免一次卡住的请求让后续加载永久停摆
+- 传输进度条改为**浮在面板底部**的固定条：无论当前在哪个目录、列表滚到哪里都一定看得见（之前它会跟着布局被挤出可视区）
+- 传输时浮层会显示文件名和百分比，带不透明背景和阴影，压在内容之上也读得清
+- 修复在云盘面板里滚动时会把外层对话页一起带着滚的问题（滚动区加 overscroll 隔离；不使用 JS 拦截滚轮，避免影响列表滚动）
+- 拖动左右分隔线时不会再触发页面拖动或选中文本
+- 下载目录缩为小按钮，点开可手填路径或用系统对话框选目录
+- 移除「返回上级」按钮（面包屑和左树都能回退）
+- 文件夹右键菜单为「复制路径」和「重命名」；左树里的文件夹也支持右键
+- 亮色 / 暗色主题自动跟随 DSH
+
 ## 0.2.1
 
 修正 DSH 兼容性上界：原先写的 `< 0.4.0` 没有依据，改为 `< 0.3.0`。

package/CONTRIBUTING.md

@@ -8,7 +8,7 @@
 - Node.js **>= 22**（插件用了内置 `fetch`、`AbortSignal.timeout`、`node:stream/promises`）
 - Windows（宿主端用 Puppeteer 无依赖的 PowerShell + WinForms 处理系统对话框与 DPAPI；
   macOS / Linux 上凭据改用文件权限，但部分功能未验证）
-- DeepSeek Harness `0.2.x`
+- DeepSeek Harness `>= 0.2.1-rc.5, < 0.3.0`（插件 0.3.x 的兼容范围）
 
 ## 本地开发
 

package/FAQ.md

@@ -105,19 +105,21 @@
 
 先确认是不是这几种情况：
 
-- **目录条目特别多**（几千项）→ 需要多次「加载更多」
 - **网络不稳** → 面板会给出错误提示，等几秒重试即可
 - **刚登录后第一次访问** → 首次要解析服务地址，会稍慢
+- **目录里图片特别多** → 首屏只拉第一页，往下滚才会继续加载
 
 如果某个目录每次都很慢，把目录名和大概条目数告诉我。
 
-### 为什么一次只显示 10 项
+### 列表是怎么加载的
 
-为了打开目录更快。点底部的「加载更多」看剩下的内容。
+每页取 50 项，**滚动到底会自动加载下一批**，不需要点任何按钮。
+每次请求的耗时主要花在网络往返上，一次多取一些反而更划算，所以页大小调成了 50。
 
 ### 回到看过的目录会很快
 
-已访问过的目录会被缓存，再次进入基本是瞬间打开。
+已访问过的目录会被缓存（约 5 分钟），再次进入基本是瞬间打开；
+缓存期间仍会在后台悄悄刷新，内容变了也能看到。
 
 ## 权限与安全
 

package/README.md

@@ -1,239 +1,271 @@
-# dsh-mcloud
-
-把 **中国移动云盘（139）** 接进 DeepSeek Harness：在会话页顶部加一个「移动云盘」页签，
-可以直接浏览、上传、下载、转移网盘文件；同时给模型提供一整套 `mcloud_*` 工具。
-
-📖 [常见问题 FAQ](FAQ.md) · 📝 [更新日志](CHANGELOG.md) · 🤝 [贡献指南](CONTRIBUTING.md)
-
-[![npm](https://img.shields.io/npm/v/dsh-mcloud?color=cb3837&logo=npm&logoColor=white)](https://www.npmjs.com/package/dsh-mcloud)
-[![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-
-## 快速开始
-
-**环境要求**
-
-| 项目 | 要求 |
-| --- | --- |
-| DeepSeek Harness | **>= 0.2.1-rc.5，< 0.3.0** |
-| Node.js | >= 22 |
-| 系统 | Windows |
-
-**五步用起来**
-
-1. 装插件（见下方「安装」）
-2. 重启 DSH —— 插件在 profile 启动时加载
-3. 会话页顶部标签栏点「**移动云盘**」
-4. 用**扫码**或**账号密码**登录（全新安装一定是未登录状态）
-5. 看到容量和文件列表 → 可以用了
-
-之后可以直接让 AI 操作网盘，也可以右键菜单自己动手。
-
-## 安装
-
-最省事：在 DSH 的「添加插件」里输入包名：
-
-```
-dsh-mcloud
-```
-
-或者用命令行：
-
-```powershell
-dsh plugin --profile desktop add dsh-mcloud
-```
-
-也可以从 GitHub 装：
-
-```powershell
-dsh plugin --profile desktop add github:GIYN-S/dsh-mcloud
-```
-
-或下载 Release 里的 tgz：
-
-```powershell
-dsh plugin --profile desktop add https://github.com/GIYN-S/dsh-mcloud/releases/download/v0.2.0/dsh-mcloud-0.2.0.tgz
-```
-
-本地开发用 link：
-
-```powershell
-dsh plugin --profile desktop add "link:/path/to/dsh-mcloud"
-```
-
-装完**重启 DSH** 才生效。
-
-## 登录
-
-打开面板会看到登录页，两种方式任选。
-
-### 扫码登录（推荐）
-
-点「**开始扫码登录**」→ 弹出一个浏览器窗口 → 手机扫码 → 完成。
-
-- 不需要输密码
-- 凭据会自动续期，日常**不需要反复扫码**
-- 弹出的是独立 profile 的浏览器，不影响你日常用的 Edge
-
-### 账号密码登录
-
-在「账号密码」页签填手机号/邮箱和密码。
-
-- **密码默认只用一次**，登录成功后立刻丢弃
-- 勾选「**记住密码**」才会保存，用 Windows DPAPI 加密存在本机
-
-### 退出登录
-
-面板里点「退出登录」，会清掉本机凭据，回到未登录状态。
-
-### 凭据存在哪
-
-`%USERPROFILE%\.dsh-mcloud\authorization.dpapi` —— 当前用户的 DPAPI 加密，
-换用户或换机器都解不开。想换位置在配置里写 `credentialDir`。
-
-**不要把凭据贴到 Issue、聊天记录或截图里。**
-
-## 功能
-
-### 面板内操作
-
-| 操作 | 说明 |
-| --- | --- |
-| 浏览目录 | 点击文件夹进入，顶部面包屑可回退 |
-| 容量 | 显示总量 / 已用 / 剩余 |
-| 上传 | 右键 → 上传文件 / 上传文件夹 / 拖动上传 |
-| 下载 | 右键 → 下载到本地 / 打开下载直链 / 下载整个文件夹 |
-| 转移 | 右键 → 转移到…（选择目标文件夹） |
-| 复制路径 | 右键 → 复制路径 |
-| 重命名 / 删除 | 右键菜单 |
-
-### 模型工具
-
-| 工具 | 用途 |
-| --- | --- |
-| `mcloud_quota` | 查询容量 |
-| `mcloud_list` | 列目录 |
-| `mcloud_search` | 按文件名搜索 |
-| `mcloud_upload` | 上传本地文件（按路径，直接从磁盘读） |
-| `mcloud_upload_folder` | 上传整个本地文件夹 |
-| `mcloud_download` | 下载到本地 |
-| `mcloud_download_folder` | 递归下载整个文件夹 |
-| `mcloud_download_link` | 获取下载直链 |
-| `mcloud_mkdir` | 新建文件夹 |
-| `mcloud_rename` | 重命名 |
-| `mcloud_move` | 转移 |
-| `mcloud_remove` | 删除（进回收站） |
-
-## 使用提醒
-
-- **大文件或整个目录**：让模型调用 `mcloud_upload`，走本机路径直传，效率最高。
-  面板里的上传需要经过浏览器中转一次。
-- **下载整个文件夹**不是压缩包：移动云盘没有打包下载接口，插件会递归遍历后逐个下载。
-- **删除进回收站**，可以在网盘里恢复。
-- **写入类操作会弹审批**，这是 DSH 的安全机制，不是出错。
-- **一次只显示 10 项**，点「加载更多」翻页；看过的目录会被缓存，再次进入很快。
-- 如果长时间不用，登录凭据可能过期，届时重新登录即可。
-
-## 配置
-
-可选，在 profile 的 `cordis.patch.yml` 里：
-
-```yaml
-- id: dsh-mcloud
-  name: 'dsh-mcloud'
-  config:
-    credentialDir: '/custom/credential/dir'   # 凭据目录
-    enableWrites: false                        # 设为 false 则关闭写入审批闸（不建议）
-```
-
-## 文件结构
-
-```
-lib/index.js      宿主端：网盘客户端、工具、HTTP 路由、凭据存储
-lib/login.js      账号密码登录
-lib/scan-login.js 扫码登录
-lib/transfer.js   上传下载的传输层
-lib/client.js     会话页面板（登录页、文件浏览、右键菜单、传输进度）
-cordis.patch.yml  bundle patch
-locale/*.json     面板标题与描述
-```
-
-## 免责声明
-
-**使用本项目即表示你已阅读、理解并同意以下全部内容。如果你不同意，请不要安装或使用。**
-
-### 1. 与官方无关
-
-本项目是一个**第三方社区项目**，由个人开发者在业余时间编写，**不是中国移动、中国移动云盘（139）
-或其任何关联公司的官方产品**。我们与中国移动：
-
-- 没有任何隶属、合作、赞助、背书或授权关系；
-- 没有获得中国移动的任何许可、技术支持或数据访问权限；
-- 不代表中国移动的立场，也不承担其任何义务。
-
-「中国移动」「移动云盘」「139」等名称与标识是其各自权利人的商标，本项目仅作**描述性使用**
-（说明本工具连接的是哪个服务），不主张任何商标权利。
-
-### 2. 技术实现方式
-
-本项目通过**非官方接口**与移动云盘通信。这些接口并非公开 API，而是社区通过观察网页端
-行为整理得出（参考了 [OpenList](https://github.com/OpenListTeam/OpenList) 与
-[cloud_driver_sdk](https://github.com/kong-hen/cloud_driver_sdk) 的开源实现）。
-
-这意味着：
-
-- 接口**没有任何稳定性承诺**，中国移动可以随时修改、限制或关闭，且无需通知；
-- 接口变更可能导致本插件**完全失效**，且不保证能及时修复；
-- 部分行为（如分页上限、请求频率限制）是观察到的现象，**不保证在所有账号上一致**。
-
-### 3. 账号与合规风险
-
-**你需要自行确认使用本插件不违反你与中国移动之间的服务协议。**
-
-需要注意的现实风险包括但不限于：
-
-- 服务协议通常禁止使用非官方客户端或自动化工具访问服务；
-- 高频或异常调用可能触发风控，导致**账号被限制、临时封禁或功能受限**；
-- 中国移动可能随时调整政策，使此类第三方工具不再可用。
-
-**因使用本插件导致的任何账号处置、服务中断、数据丢失或协议违约后果，由使用者自行承担。**
-
-### 4. 数据与隐私
-
-- **你的凭据只存在你自己的机器上**，使用 Windows DPAPI（当前用户级）加密，
-  不会上传到任何第三方服务器，本项目的开发者也无法获取。
-- 插件只与 `*.yun.139.com`、`*.10086.cn`（登录）及文件 CDN 通信，
-  **不含任何统计、埋点或遥测代码**。
-- 账号在界面上以脱敏形式显示（只露前 3 位与末 2 位）。
-- ⚠️ **但请注意**：本项目对凭据的保管仅做到「本机 DPAPI 加密」这一层。
-  如果你的电脑本身被入侵、被他人物理接触、或登录了不受信任的账号环境，
-  凭据仍可能被读取。**请自行评估你所在环境的安全水平。**
-
-### 5. 数据完整性
-
-本插件会**真实地修改你的网盘内容**（上传、移动、重命名、删除）。
-
-- 删除操作走的是回收站，通常可以恢复，但**不保证**（例如回收站被清空、或服务端策略变化）；
-- 上传、移动等操作可能因网络中断、接口异常而产生**不完整或重复**的文件；
-- **请勿把本插件用于你无法承受丢失的数据。重要数据请自行另行备份。**
-
-### 6. 无担保
-
-本项目按「**现状**」（AS IS）提供，**不附带任何明示或暗示的担保**，包括但不限于
-适销性、特定用途适用性、以及不侵权的担保。
-
-作者**不对任何直接、间接、偶然、特殊、惩罚性或后果性损害承担责任**，
-包括但不限于数据丢失、利润损失、业务中断、账号损失——
-无论这些损害是如何产生的、基于何种责任理论，也无论作者是否已被告知此类损害的可能性。
-
-### 7. 关于 Issue 与支持
-
-- 本项目**不提供任何形式的商业支持或 SLA**；
-- 因接口变更导致的问题，作者**没有义务**修复；
-- 提交 Issue 时**绝不要附带凭据（Authorization / cookie / token）或截图中的敏感信息**。
-
-## 许可
-
-本项目以 [MIT 许可](LICENSE) 发布。你可以在许可条款范围内自由使用、修改与分发，
-但**必须保留原版权声明与许可声明**。MIT 许可同样包含上述免责条款。
-
-详见 [LICENSE](LICENSE)。
+# dsh-mcloud
+
+把 **中国移动云盘（139）** 接进 DeepSeek Harness：在会话页顶部加一个「移动云盘」页签，
+可以直接浏览、上传、下载、转移网盘文件；同时给模型提供一整套 `mcloud_*` 工具。
+
+📖 [常见问题 FAQ](FAQ.md) · 📝 [更新日志](CHANGELOG.md) · 🤝 [贡献指南](CONTRIBUTING.md)
+
+[![npm](https://img.shields.io/npm/v/dsh-mcloud?color=cb3837&logo=npm&logoColor=white)](https://www.npmjs.com/package/dsh-mcloud)
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+## 快速开始
+
+**环境要求**
+
+| 项目 | 要求 |
+| --- | --- |
+| DeepSeek Harness | **>= 0.2.1-rc.5，< 0.3.0** |
+| Node.js | >= 22 |
+| 系统 | Windows |
+
+**五步用起来**
+
+1. 装插件（见下方「安装」）
+2. 重启 DSH —— 插件在 profile 启动时加载
+3. 会话页顶部标签栏点「**移动云盘**」
+4. 用**扫码**或**账号密码**登录（全新安装一定是未登录状态）
+5. 看到容量和文件列表 → 可以用了
+
+之后可以直接让 AI 操作网盘，也可以右键菜单自己动手。
+
+## 安装
+
+最省事：在 DSH 的「添加插件」里输入包名：
+
+```
+dsh-mcloud
+```
+
+或者用命令行：
+
+```powershell
+dsh plugin --profile desktop add dsh-mcloud
+```
+
+也可以从 GitHub 装：
+
+```powershell
+dsh plugin --profile desktop add github:GIYN-S/dsh-mcloud
+```
+
+或下载 Release 里的 tgz：
+
+```powershell
+dsh plugin --profile desktop add https://github.com/GIYN-S/dsh-mcloud/releases/download/v0.2.0/dsh-mcloud-0.2.0.tgz
+```
+
+本地开发用 link：
+
+```powershell
+dsh plugin --profile desktop add "link:/path/to/dsh-mcloud"
+```
+
+装完**重启 DSH** 才生效。
+
+## 登录
+
+打开面板会看到登录页，两种方式任选。
+
+### 扫码登录（推荐）
+
+点「**开始扫码登录**」→ 弹出一个浏览器窗口 → 手机扫码 → 完成。
+
+- 不需要输密码
+- 凭据会自动续期，日常**不需要反复扫码**
+- 弹出的是独立 profile 的浏览器，不影响你日常用的 Edge
+
+### 账号密码登录
+
+在「账号密码」页签填手机号/邮箱和密码。
+
+- **密码默认只用一次**，登录成功后立刻丢弃
+- 勾选「**记住密码**」才会保存，用 Windows DPAPI 加密存在本机
+
+### 退出登录
+
+面板里点「退出登录」，会清掉本机凭据，回到未登录状态。
+
+### 凭据存在哪
+
+`%USERPROFILE%\.dsh-mcloud\authorization.dpapi` —— 当前用户的 DPAPI 加密，
+换用户或换机器都解不开。想换位置在配置里写 `credentialDir`。
+
+**不要把凭据贴到 Issue、聊天记录或截图里。**
+
+## 功能
+
+### 面板内操作
+
+界面是资源管理器风格：左边文件夹树，右边文件列表。
+
+| 操作 | 说明 |
+| --- | --- |
+| 浏览目录 | 左侧点文件夹，右侧显示它的内容；也可双击右侧文件夹进入 |
+| 返回上级 | 点面包屑跳回任意一层，或点左侧文件夹树 |
+| 调整侧栏宽度 | 拖动文件夹树与列表之间的分隔线，双击恢复默认 |
+| 容量 | 顶部栏底部的一条通栏进度线，数值居中显示 |
+| 调整列宽 | 拖动「大小」两侧的竖线，双击恢复默认 |
+| 搜索 | 顶部搜索框，在当前目录及子目录中按文件名查找 |
+| 上传 | 右键 → 上传文件 / 上传文件夹 / 拖动上传 |
+| 下载 | 右键 → 下载到本地 / 打开下载直链 / 下载整个文件夹 |
+| 转移 | 右键 → 转移到…（选择目标文件夹） |
+| 复制路径 | 右键 → 复制路径 |
+| 重命名 / 删除 | 右键菜单（文件夹的右键菜单只有「复制路径」和「重命名」） |
+
+**下载目录**：左上角「下载到」按钮，点开可以手填路径，或点「选择目录」用系统对话框逐级选。
+
+**传输进度**：面板底部有一条固定的进度条，空闲时是一条淡色细线。传输时变粗变蓝，
+显示文件名与百分比；完成后保持 5 秒再缓缓淡出。
+
+### 模型工具
+
+| 工具 | 用途 |
+| --- | --- |
+| `mcloud_quota` | 查询容量 |
+| `mcloud_list` | 列目录 |
+| `mcloud_search` | 按文件名搜索 |
+| `mcloud_upload` | 上传本地文件（按路径，直接从磁盘读） |
+| `mcloud_upload_folder` | 上传整个本地文件夹 |
+| `mcloud_download` | 下载到本地 |
+| `mcloud_download_folder` | 递归下载整个文件夹 |
+| `mcloud_download_link` | 获取下载直链 |
+| `mcloud_mkdir` | 新建文件夹 |
+| `mcloud_rename` | 重命名 |
+| `mcloud_move` | 转移 |
+| `mcloud_remove` | 删除（进回收站） |
+
+## 使用提醒
+
+- **大文件或整个目录**：让模型调用 `mcloud_upload`，走本机路径直传，效率最高。
+  面板里的上传需要经过浏览器中转一次。
+- **下载整个文件夹**不是压缩包：移动云盘没有打包下载接口，插件会递归遍历后逐个下载。
+- **删除进回收站**，可以在网盘里恢复。
+- **写入类操作会弹审批**，这是 DSH 的安全机制，不是出错。
+- **列表滚动到底会自动加载下一批**，不需要点按钮；看过的目录会被缓存，再次进入很快。
+- 如果长时间不用，登录凭据可能过期，届时重新登录即可。
+
+## 配置
+
+可选，在 profile 的 `cordis.patch.yml` 里：
+
+```yaml
+- id: dsh-mcloud
+  name: 'dsh-mcloud'
+  config:
+    credentialDir: '/custom/credential/dir'   # 凭据目录
+    enableWrites: false                        # 设为 false 则关闭写入审批闸（不建议）
+    # 仅当你在 DSH 前面挂了反代 / 用自定义域名访问时才需要：
+    allowedAuthorities: ['dsh.example.com']
+```
+
+## 安全说明
+
+`/api/dsh-mcloud/*` 是一组挂在本机 webServer 上的接口，能读写你已登录的云盘。
+DSH 的 `webServer.register` 只按路径分发、**不做** Host / Origin 准入，所以插件自己
+带了一道闸（`lib/request-guard.js`），每条路由都会过：
+
+- **Host** 必须是本部署自己的 authority（环回 / 监听器绑定 IP / `allowedAuthorities`），
+  且端口要对得上监听器；
+- **Origin** 必须与 Host 同源，`null` 直接拒；
+- **`Sec-Fetch-Site: cross-site`** 一票否决。
+
+这挡住的是 DNS rebinding 和「你用浏览器打开恶意网页、它替你打本机接口」这两类攻击。
+注意 `x-dsh-mcloud: 1` 这个请求头**只是标记，不是安全边界** —— 任何网页都能自己加，
+真正起作用的是上面三条。
+
+`npm test` 跑安全回归（24 项，含 4 条攻击路径）。
+
+## 文件结构
+
+```
+lib/index.js         宿主端：网盘客户端、工具、HTTP 路由、凭据存储
+lib/request-guard.js 请求闸：Host / Origin / DNS rebinding 防护
+lib/login.js         账号密码登录
+lib/scan-login.js    扫码登录
+lib/transfer.js      上传下载的传输层
+lib/client.js        会话页面板（登录页、文件浏览、右键菜单、传输进度）
+cordis.patch.yml     bundle patch
+locale/*.json        面板标题与描述
+test/                安全回归测试（node --test）
+```
+
+## 免责声明
+
+**使用本项目即表示你已阅读、理解并同意以下全部内容。如果你不同意，请不要安装或使用。**
+
+### 1. 与官方无关
+
+本项目是一个**第三方社区项目**，由个人开发者在业余时间编写，**不是中国移动、中国移动云盘（139）
+或其任何关联公司的官方产品**。我们与中国移动：
+
+- 没有任何隶属、合作、赞助、背书或授权关系；
+- 没有获得中国移动的任何许可、技术支持或数据访问权限；
+- 不代表中国移动的立场，也不承担其任何义务。
+
+「中国移动」「移动云盘」「139」等名称与标识是其各自权利人的商标，本项目仅作**描述性使用**
+（说明本工具连接的是哪个服务），不主张任何商标权利。
+
+### 2. 技术实现方式
+
+本项目通过**非官方接口**与移动云盘通信。这些接口并非公开 API，而是社区通过观察网页端
+行为整理得出（参考了 [OpenList](https://github.com/OpenListTeam/OpenList) 与
+[cloud_driver_sdk](https://github.com/kong-hen/cloud_driver_sdk) 的开源实现）。
+
+这意味着：
+
+- 接口**没有任何稳定性承诺**，中国移动可以随时修改、限制或关闭，且无需通知；
+- 接口变更可能导致本插件**完全失效**，且不保证能及时修复；
+- 部分行为（如分页上限、请求频率限制）是观察到的现象，**不保证在所有账号上一致**。
+
+### 3. 账号与合规风险
+
+**你需要自行确认使用本插件不违反你与中国移动之间的服务协议。**
+
+需要注意的现实风险包括但不限于：
+
+- 服务协议通常禁止使用非官方客户端或自动化工具访问服务；
+- 高频或异常调用可能触发风控，导致**账号被限制、临时封禁或功能受限**；
+- 中国移动可能随时调整政策，使此类第三方工具不再可用。
+
+**因使用本插件导致的任何账号处置、服务中断、数据丢失或协议违约后果，由使用者自行承担。**
+
+### 4. 数据与隐私
+
+- **你的凭据只存在你自己的机器上**，使用 Windows DPAPI（当前用户级）加密，
+  不会上传到任何第三方服务器，本项目的开发者也无法获取。
+- 插件只与 `*.yun.139.com`、`*.10086.cn`（登录）及文件 CDN 通信，
+  **不含任何统计、埋点或遥测代码**。
+- 账号在界面上以脱敏形式显示（只露前 3 位与末 2 位）。
+- ⚠️ **但请注意**：本项目对凭据的保管仅做到「本机 DPAPI 加密」这一层。
+  如果你的电脑本身被入侵、被他人物理接触、或登录了不受信任的账号环境，
+  凭据仍可能被读取。**请自行评估你所在环境的安全水平。**
+
+### 5. 数据完整性
+
+本插件会**真实地修改你的网盘内容**（上传、移动、重命名、删除）。
+
+- 删除操作走的是回收站，通常可以恢复，但**不保证**（例如回收站被清空、或服务端策略变化）；
+- 上传、移动等操作可能因网络中断、接口异常而产生**不完整或重复**的文件；
+- **请勿把本插件用于你无法承受丢失的数据。重要数据请自行另行备份。**
+
+### 6. 无担保
+
+本项目按「**现状**」（AS IS）提供，**不附带任何明示或暗示的担保**，包括但不限于
+适销性、特定用途适用性、以及不侵权的担保。
+
+作者**不对任何直接、间接、偶然、特殊、惩罚性或后果性损害承担责任**，
+包括但不限于数据丢失、利润损失、业务中断、账号损失——
+无论这些损害是如何产生的、基于何种责任理论，也无论作者是否已被告知此类损害的可能性。
+
+### 7. 关于 Issue 与支持
+
+- 本项目**不提供任何形式的商业支持或 SLA**；
+- 因接口变更导致的问题，作者**没有义务**修复；
+- 提交 Issue 时**绝不要附带凭据（Authorization / cookie / token）或截图中的敏感信息**。
+
+## 许可
+
+本项目以 [MIT 许可](LICENSE) 发布。你可以在许可条款范围内自由使用、修改与分发，
+但**必须保留原版权声明与许可声明**。MIT 许可同样包含上述免责条款。
+
+详见 [LICENSE](LICENSE)。