概览
dsh-dschat
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- 依赖**本机浏览器 + 网页登录态**，没有 API Key 就不能工作；官网风控、改版或登录失效时会明确报错，而不是静默失败。 - 网页端一次只回答一个问题，所以第二条消息只能排队。 - 浏览器 profile 默认复用 `~/.dsh/dsh-webchat/browser-profile` —— 从 dsh-webchat 切过来不用重新登录； 两个插件同时开着会争同一份 profile。 - 网页端解析在 DOM 层，官网大改结构时可能读不到内容（此时会报解析失败）。 - 本地 HTTP 接口只接受**回环地址 + POST + 同源 + 每次运行生成的 CSRF 令牌**（面板会自动带上）。所以面板 之外的脚本要调用它，得先 `GET /api/dsh-dschat/state` 取 `csrfToken`，再在后续请求里带 `x-dschat-token` 头；这是为了挡住本机其他网页用一张 `<img>` 就把记录清掉。 - 附件只接受图片、文档与文本（有扩展名白名单），单个上限 24 MB、一次最多 10 个、单次总量 48 MB； `/send` 还要求路径落在插件自己的 `attachments/` 目录内（agent 的 `dschat_send` 不受目录限制，但同样 受类型与大小规则约束）。 - 同一份会话记录**同时只允许一个实例写入**：第一个 DSH 还开着时再开一个，第二个会转为只读并在「运行状态」 里说明原因与处置办法（否则两个实例会互相整份覆盖）。崩溃留下的锁会被自动接管，正常退出会交还。 - 面板的 1.5 秒轮询只取会话**摘要**（标题/时间/条数），正文按需从 `GET /api/dsh-dschat/chat?id=` 取 —— 这是把轮询流量从 MiB 级降到 KB 级的原因。脚本要搜会话请用 `GET /api/dsh-dschat/search-conversations?q=`，它返回会话 id，不返回正文。