@roaming-ai/dsh-group-chat 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 localSummer
+
+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

@@ -0,0 +1,56 @@
+# dsh-group-chat
+
+DSH Web GUI 的「模型群聊」插件：多模型角色群组对话面板。
+
+## 功能
+
+- **群组管理**：新建、重命名、删除（至少保留一个群组）；左栏搜索框按群组名/会话名过滤
+- **会话目录树**：每个群组内多个会话，左栏以「群组 → 会话」目录树呈现（展开/收起、新建、重命名、删除）；消息挂在会话上，会话各有主题
+- **角色-模型绑定**：群组内每个角色绑定一个 provider/model（可各不相同），配置人设、标识色、Temperature、深度思考开关；开启深度思考时可选**推理级别**（选项取自 DSH 当前模型设置的推理选项，未配置则用默认）；角色为群组级，全会话共享；配置走右侧滑出抽屉
+- **群内共享对话**：所有消息对全群共享；发言以「【角色名】内容」形式注入每个角色的上下文，流式显示
+- **消息渲染**：角色发言以宿主同款 markdown 渲染（标题、列表、表格、代码块、公式）；开启「深度思考」的角色发言带可折叠的思考行（折叠时显示摘要，展开看全文，流式时实时跟随）
+- **多轮对话**：发送消息后选择参与角色按顺序自动多轮对话（1–10 轮），可随时停止
+- **@点名**：裸 `@` 弹出成员候选（↑↓ 选择、Enter/Tab 插入）；被 @ 的成员优先作为本轮参与角色。`@` 后继续键入则在群工作区内检索文件，插入 `@path` 芯片（只写入路径，不把文件正文再灌进 prompt）
+- **三区工作台**：左栏导航（搜索 + 目录树）；中栏会话流（色环头像 + 模型徽章 + 时间，贴底自动跟随、可回到底部）；右栏上下文（角色卡 + 工作区目录），可一键收起，窄面板时覆盖式呈现
+- **群组工作区目录**：每个群组指定一个目录（群级、全会话共享；无独立笔记或文件清单）。角色发言时自动读取目录**根下一层**文本文件（扩展名白名单、跳过隐藏项、最多 20 个；单文件 16k / 总量 48k 截断）注入全体角色 system 提示词的「共享资料」块；支持 `~`、绝对路径与相对 DSH 工作区根解析，右栏内置目录选择浏览器；未设置则不注入、不暴露工具
+- **工具执行（docs/TOOLS.md）**：设置工作区后角色可调用 `read_file` / `list_dir` 主动查看工作区（realpath 硬边界，逃逸/软链越界一律拒绝）；**权限档位**于消息输入框下方左下角芯片切换（对齐主会话 `/permission` 三档：仅可查看 / 工作区内修改 / 完全权限；默认仅可查看，按群组记忆持久化）——工作区内修改档角色可请求执行 shell 命令（cwd 固定为工作区、超时 120s），**每条命令在会话流内逐条确认**（允许 / 拒绝 / 停止，命令全文展示不截断）；完全权限档免确认直接执行，切换时经主会话同款风险确认弹窗；工具调用以折叠行内嵌于角色消息（含耗时与状态），摘要注入后续发言上下文；不支持 tools 的模型自动降级为纯文本
+- **设置启用**：设置页「模型群聊」分区提供启停开关（持久化于 settings.yaml）；关闭时隐藏侧边栏入口并中止进行中的对话
+
+## 架构
+
+双平面插件（对齐 [dsh-web](https://github.com/zhu1090093659/dsh-web) 家族的 dsh-usage 包形状）：
+
+- **源码与构建**：TypeScript 源码于 `src/`（`core/` 纯逻辑、`host/` 宿主半、`client/` 浏览器半）；`pnpm build` 先 `tsc` 产声明到 `lib/types/`，再 `tsdown`（`shared/tsdown.client.ts` 预设拷贝自 dsh-web）产出双半产物 `lib/index.js`（ESM）+ `lib/client.js`（闭包工厂）
+- **Host 半**（`src/index.ts` + `src/host/`，host 进程组合插件）：群组/会话/角色/工作区/消息内存状态机；群组与会话增删改；角色发言经 `llm` 服务按绑定路由流式生成，设置工作区后进入「生成⇄工具」循环（read_file/list_dir 自动执行，run_command 经 `confirmCommand` 逐条确认闸门）；工作区文本文件经 `fs` 服务读取并注入；经 `webServer` 暴露：
+  - `GET /api/group-chat/state` — 全量快照
+  - `POST /api/group-chat/action` — `{kind: mutate|send|stop|confirmCommand|models|efforts|browse|fileSearch, ...}`（`efforts` 查询 provider/model 的推理级别选项，60s 缓存；`browse` 为右栏目录浏览器；`fileSearch` 为输入框 @ 文件检索）
+  - `GET /api/group-chat/events` — SSE，状态变化推送（120ms 节流）
+  - 路由带回环 + 同源信任栏（`src/host/http.ts`，语义对齐 dsh-web 家族的 loopback fence）
+- **浏览器半**（`src/client/`，`dsh.client` 模块）：侧边栏 `sidebar.panellist` 入口 + `main` 键面板 + `settings.section` 设置页；经 fetch/SSE 访问 Host API；UI 使用宿主 DSW 原语（`@deepseek-ai/dsh-client-ui-primitives`，shell 静态种子模块）——Button/Input/Switch/Tooltip/统一描边图标与 `MarkdownText` 渲染器
+
+设计文档位于 `docs/`：`PRODUCT.md`（产品定义）、`DESIGN.md`（界面设计契约）、`PERSISTENCE.md`（持久化契约）、`TOOLS.md`（工具执行护栏）。
+
+## 安装（本 profile）
+
+`~/.dsh/profiles/web/package.json` 的 `dependencies` 已含 `"dsh-group-chat": "link:/home/.../plugins/dsh-group-chat"`，且 `dsh.profile.bundles` 已列 `dsh-group-chat`。本包改为 TS 源码 + 构建产物形态，修改源码后在本目录执行：
+
+```bash
+cd ~/.dsh/profiles/web/plugins/dsh-group-chat && pnpm install && pnpm build
+```
+
+重启 `dsh web` 生效。开发辅助：`pnpm watch`（tsdown 增量构建）、`pnpm test`（core/store 冒烟测试）、`pnpm typecheck`。
+
+## 数据与持久化
+
+- 会话级文件隔离持久化于 `~/.dsh/storages/group-chat/`（设计详见 `docs/PERSISTENCE.md`；gitignore 已覆盖）：
+  - `ledger.json` — 群组/会话清单（`schema: 2`，纯清单）
+  - `<group-id>/roles.json` — 群组角色定义（`schema: 1`）
+  - `<group-id>/workspaceDir` — 群组工作区目录设置（纯文本一行）
+  - `<group-id>/sessions/session-<uuid>.json` — 一个会话一个文件（自包含名称/主题/创建时间/消息）
+- 事件驱动写：变更按文件标脏，同一 tick 内合并，流式 partial 不落盘
+- 原子写（tmp + fsync + rename，每个实际发生 rename 的目录一次 fsync）、单实例 `.lock`（PID 存活检测，崩溃残留自动清理）
+- 写失败保留脏标记，下次 flush 自动重试；插件卸载时同步最终 flush 后再释放锁
+- 损坏处理：单会话文件坏仅丢该会话消息（隔离 `.corrupt-*`，每前缀保留最近 1 份）；ledger 坏可扫描群组目录回收；行级校验丢弃孤儿条目
+- v1 双文件布局（ledger.json + messages.json）首次启动自动迁移（幂等；旧 messages.json 归档为 `.migrated-*`，从不删除）
+- 锁不可得（双进程）时降级为内存态运行并告警
+- 设置页的 `enabled` 开关经 settings 服务持久化于 `settings.yaml`；进行中的对话运行态（run）不持久化

package/cordis.patch.yml

@@ -0,0 +1,12 @@
+# dsh-group-chat bundle layer: inserts the dual-face plugin row into the web
+# profile roster. Applied when the profile lists this package in
+# dsh.profile.bundles.
+#
+# The row is a bare plugin by package name: the node half (exports ".") runs
+# in the host process (group state machine + llm calls + fs material reads +
+# /api/group-chat HTTP API), and the `dsh.client` declaration in package.json
+# makes the browser half (exports "./client", served at
+# /plugins/<id>/client.js) load in the web GUI.
+- insert:
+    - id: group-chat
+      name: @roaming-ai/dsh-group-chat