# Security Policy

## 报告漏洞

请**不要**用公开 issue 报告安全问题。用 GitHub 的 [私密漏洞报告](https://github.com/lpeixin/dsh-xiangqi-mate/security/advisories/new)，或直接邮件联系维护者（见仓库作者信息）。请附上：

- 受影响的版本与 DSH 版本（`package.json` 的 `version`，以及 DSH 的 `0.2.0-rc.x`）；
- 复现步骤或最小复现；
- 影响评估：能读到什么、能改到什么、是否需要用户交互。

## 本插件的信任边界

理解边界有助于判断一个问题是否真的是安全问题：

| 面 | 边界 |
| --- | --- |
| **模型** | 模型只能通过已注册的工具影响棋局。工具入参**由插件自己校验**（宿主不校验 `parameters`），非法着法只会被拒绝，不会越出棋局范围 |
| **浏览器半 → 宿主半** | 走 `connection.rpc` 的 `/xiangqi-mate` 通道，只能读写**指定会话**的棋局状态；不暴露文件系统、不暴露进程能力、不接受任意路径 |
| **对局数据** | 按会话写入**会话工作目录**下的 `<saveDir>/<sessionId>.json`。`sessionId` 经 `[^A-Za-z0-9_-]` 白名单清洗后才作为文件名，且 `saveDir` 校验为非空相对路径且不含 `..`，以阻止路径穿越 |
| **模型调用** | 只使用你已配置的模型路由（不申请凭据、不引入新的外部服务）。`maxTokensPerMove` / `maxTokensPerGame` 提供硬性花费上限 |
| **凭据** | 本插件不读取、不存储任何凭据 |

## 明确不在威胁模型内的情形

- 你的 DSH 会话本身已被攻破（插件无法防御同进程内的任意代码）；
- 任何通过鉴权的本机浏览器页面调用只读 RPC 通道（这是 DSH 的信任模型，插件侧只做会话隔离，不做跨页隔离）；
- 模型给出「坏棋」——那是能力问题，不是安全问题。

## 我们会做的事

- 确认收到报告后 72 小时内给出初步判断；
- 与报告者协商披露时间，修复发布后在本文件与 CHANGELOG 中致谢（除非你要求匿名）。