# dsh-Chat
**Repository Path**: westanke/dsh-Chat
## Basic Information
- **Project Name**: dsh-Chat
- **Description**: DSH Chat — Flutter client for dsh-remote-bridge
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-03
- **Last Updated**: 2026-11-15
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# dsh-Chat
DSH Chat — Flutter client for dsh-remote-bridge
一套 Flutter 代码(Android + iOS),把本机 dsh-remote-bridge
的对话流渲染成原生聊天界面。对话、会话、历史全部留在你自己的机器上。
`dsh-Chat` 是 [`dsh-remote-bridge`](https://github.com/westanke/dsh-remote-bridge) 的 Flutter 客户端:
通过 REST `/api/v1` 取会话与历史,通过 WS `/ws/mobile`(子协议 `dsh-mobile-v1`,`hello.protocol=3`)
接收流式增量。本仓**只消费协议**,不改协议;协议的事实来源在 bridge 仓的 `docs/api/`。
**边界**:不是任何官方客户端的分支,不连接官方服务器,不复用其图标、字体或二进制资源。
界面尺寸与配色以官方 App 的实测像素为视觉基准(见 [`docs/design-tokens.md`](docs/design-tokens.md)),
但品牌触点(启动页标记、显示名、包名)全部是本工程自己的。
## 它能做什么
- **流式对话**:`chat.message.delta` 增量渲染 → `committed` 后重拉历史;外部端(REST)写入也会防抖刷新。
- **Markdown**:标题、嵌套列表、任务列表、代码块(Atom One Light 高亮 + 语言标签 + 复制)、
表格(官方通栏表头)、引用、行内与块级公式、链接角标,全部按 token 映射。
- **工具调用折叠**:连续调用收成一行摘要,点开展开逐条明细(参数、失败标记、耗时)。
- **思考流**:`已深度思考` 折叠块。
- **深色模式**:跟随系统,两套色板分别校准。
- **侧边抽屉**:即时搜索 + 日期分组 + 设备账号栏;凭证持久化,配对一次后自动重连。
- **失败可见**:`turn/end` 失败(限流、额度耗尽等)以错误条呈现,不静默。
- **重连**:退避 1→2→4→8→16s 封顶 30s,与 bridge 的 kotlin-sdk 参考实现一致。
## 当前状态
| 平台 | 状态 |
|---|---|
| APK | [`dsh-Chat-v1.0.17.apk`](https://gitee.com/westanke/dsh-Chat/releases/download/v1.0.17/dsh-Chat-v1.0.17.apk)
25,824,872 字节 · SHA-256 `2bc017a7949f34d94a91de7b910503dd4a5eb855a3803362fe20981283b005b1` |
| APK | [`dsh-Chat-v1.0.16.apk`](https://gitee.com/westanke/dsh-Chat/releases/download/v1.0.16/dsh-Chat-v1.0.16.apk)
25,824,872 字节 · SHA-256 `a1c1299c463c422e1e32b33dc875c1b5e9ee03fb4afb8312b7c05b17db524755` |
| APK | [`dsh-Chat-v1.0.13.apk`](https://gitee.com/westanke/dsh-Chat/releases/download/v1.0.13/dsh-Chat-v1.0.13.apk)
26,639,908 字节 · SHA-256 `98edbc351d5af37a6425005deba4f53e1d792ffb4f193858e39f4fec988eb162` |
| APK | [`dsh-Chat-v1.0.12.apk`](https://gitee.com/westanke/dsh-Chat/releases/download/v1.0.12/dsh-Chat-v1.0.12.apk)
26,639,844 字节 · SHA-256 `d89057ea6e8946235b2d230064d6d5af5cf3d0d2606ae80949e81ea4fab0daf1` |
| APK | [`dsh-Chat-v1.0.11.apk`](https://gitee.com/westanke/dsh-Chat/releases/download/v1.0.11/dsh-Chat-v1.0.11.apk)
26,639,844 字节 · SHA-256 `b74ced6a10dd42bea2bf0a8c0c7ea9ff578093da180d6d1bdb8040916944e878` |
| APK | [`dsh-Chat-v1.0.10.apk`](https://gitee.com/westanke/dsh-Chat/releases/download/v1.0.10/dsh-Chat-v1.0.10.apk)
26,574,196 字节 · SHA-256 `06efd026d3dd70e1a3c0f1a6b52ee37a00c691477c10045a0b6ceb9689faa68f` |
| APK | [`dsh-Chat-v1.0.9.apk`](https://gitee.com/westanke/dsh-Chat/releases/download/v1.0.9/dsh-Chat-v1.0.9.apk)
26,574,196 字节 · SHA-256 `a669ad8bde5a017a2a3d954a4f572dc1b716c9baf8c10cae4d75312b237d2918` |
| APK | [`dsh-Chat-v1.0.8.apk`](https://gitee.com/westanke/dsh-Chat/releases/download/v1.0.8/dsh-Chat-v1.0.8.apk)
26,574,196 字节 · SHA-256 `a8b3d0554aadee068606516852e7ebeb73e69c95928df430c1ccdc6decf23b2e` |
| APK | [`dsh-Chat-v1.0.8.apk`](https://gitee.com/westanke/dsh-Chat/releases/download/v1.0.8/dsh-Chat-v1.0.8.apk)
26,574,196 字节 · SHA-256 `a8b3d0554aadee068606516852e7ebeb73e69c95928df430c1ccdc6decf23b2e` |
| APK | [`dsh-Chat-v1.0.7.apk`](https://gitee.com/westanke/dsh-Chat/releases/download/v1.0.7/dsh-Chat-v1.0.7.apk)
26,574,196 字节 · SHA-256 `e469f1e1845fd6f7146195dfbd6594af08132f753cdfc9b1d49082aac1c013e4` |
| APK | [`dsh-Chat-v1.0.6.apk`](https://gitee.com/westanke/dsh-Chat/releases/download/v1.0.6/dsh-Chat-v1.0.6.apk)
26,573,644 字节 · SHA-256 `1afefe0e5b47f3a86ac3f02a3dc766dead92f0244aabba78870f2469a21e8430` |
| APK | [`dsh-Chat-v1.0.5.apk`](https://gitee.com/westanke/dsh-Chat/releases/download/v1.0.5/dsh-Chat-v1.0.5.apk)
26,505,619 字节 · SHA-256 `f7a1c0dd7e734cc4dfa4f3fc1b91d7cc06700715b0a4b52070a330483953ead0` |
| APK | [`dsh-Chat-v1.0.4.apk`](https://gitee.com/westanke/dsh-Chat/releases/download/v1.0.4/dsh-Chat-v1.0.4.apk)
75,568,821 字节 · SHA-256 `b720d607d016f9aeb0a4314538323cbcecf82f4423ce0243352f74d2eba9ffed` |
| APK | [`dsh-Chat-v1.0.3.apk`](https://gitee.com/westanke/dsh-Chat/releases/download/v1.0.3/dsh-Chat-v1.0.3.apk)
75,568,325 字节 · SHA-256 `1a222ae5b612cbaa8d95aaa2071eb14e4f22a4eca34a464eb1ae2ed53e86ee1b` |
| APK | [`dsh-Chat-v1.0.2.apk`](https://gitee.com/westanke/dsh-Chat/releases/download/v1.0.2/dsh-Chat-v1.0.2.apk)
73,897,157 字节 · SHA-256 `70f17e56a36a68f791f1d1f995bf759ffaec7d297014365d3be9a6c5a0e558ca` |
| APK | [`dsh-Chat-v1.0.1.apk`](https://gitee.com/westanke/dsh-Chat/releases/download/v1.0.1/dsh-Chat-v1.0.1.apk)
73,880,773 字节 · SHA-256 `25ad31f942451456238a25798cc0de91c14eee9049e25459ae38825610c190b5` |
| Android | **已装机验证**(vivo V2080A 真机):配对、自动重连、流式对话、Markdown 全家福、工具折叠、抽屉、深色模式 |
| iOS | **未验证**。`ios/Runner` 平台壳(IANA 时区通道、显示名、ATS 放行)已就位,但未在 iOS 设备或模拟器上构建运行过 |
| 版本 | `app/pubspec.yaml` 为 `1.0.17+18`;tag `v1.0.17`,产物见下方「下载安装」 |
未验证的功能不会被写成「已完成」。真机截图是唯一验收证据。
## 下载安装
正式产物随 tag 发布(Gitee 主站):
| 产物 | 说明 |
|---|---|
| APK | [`dsh-Chat-v1.0.17.apk`](https://gitee.com/westanke/dsh-Chat/releases/download/v1.0.17/dsh-Chat-v1.0.17.apk)
25,824,872 字节 · SHA-256 `2bc017a7949f34d94a91de7b910503dd4a5eb855a3803362fe20981283b005b1` |
| 校验 | `sha256sum -c` 前先比对上方 SHA-256;tag `v1.0.17` 内的 `artifacts/SHA256SUMS.txt` 为权威值 |
> 版本号以 [`app/pubspec.yaml`](app/pubspec.yaml) 的 `version` 为准(当前 `1.0.17+18`)。
## 怎么跑
```sh
export PUB_HOSTED_URL=https://pub.flutter-io.cn FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
cd app
flutter pub get # 依赖变更后必跑
flutter analyze # 提交前必绿
flutter test # 24 例
flutter build apk --debug # 真机验证前
```
首次启动进「连接到 DSH Bridge」页:填 bridge 地址(如 `http://192.168.1.126:3090`;
真机可先 `adb reverse tcp:3090 tcp:3090` 再填 `http://127.0.0.1:3090`),
加上桌面端「手机设置 → 远程访问」生成的一次性配对码。配对成功后凭证落本地,
之后自动连接。
Android 工具链在 `/media/wangke/OFFICE/workspace/android-toolchain/`(jdk17 + sdk),
真机安装时 vivo 会弹风险拦截页,需勾选确认后再点继续安装。
> ⚠️ 2026-11-03 实测:该工具链目录与 `~/flutter` 在开发机上**均不存在**,
> `flutter`/`dart`/`java` 也不在 PATH。上面的命令需先补齐工具链才能跑;
> 当前 `flutter analyze` 与 `flutter test` 由 CI(GitHub Actions)代为执行。
## CI
`.github/workflows/ci.yml` 两道闸门,每次推送都跑:
| 闸门 | 内容 |
|---|---|
| `docs-check` | `bash scripts/ci/docs-check.sh`:`app/lib/` 全部文件已登记进 `docs/STRUCTURE.md`、无死链、无旧仓名残留 |
| `analyze + test` | `flutter pub get` → `flutter analyze` → `flutter test`(100 例),stable 通道 |
刻意**不**跑 `flutter build apk`:产物不入库,验收在本机真机(见 `ci.yml` 头注释)。
GitHub 是本仓的镜像从站,日常推送目标在 Gitee(见 [AGENTS.md §10](AGENTS.md))。
## 仓库结构
```
dsh-Chat/
AGENTS.md ← 工程宪法:红线、命令、token 与协议纪律、文档同步表、坑位索引
docs/ ← STRUCTURE.md(文件清单)/ design-tokens.md(设计基准)/ project/(文档索引)
ref/ ← 官方界面基准截图、样式表与抓包记录,只读,不参与构建、不被 app/ 引用
app/ ← Flutter 工程根(lib/ 下仅 design/、bridge/、ui/ 三个子目录)
LICENSE ← AGPL-3.0 全文
```
`app/lib/` 的逐个文件职责见 [`docs/STRUCTURE.md`](docs/STRUCTURE.md)。
## 文档
| 文件 | 记的是 |
|---|---|
| [`AGENTS.md`](AGENTS.md) | 工程宪法,改任何东西之前先读 |
| [`docs/STRUCTURE.md`](docs/STRUCTURE.md) | 目录与文件清单、协议引用、踩过的协议坑 |
| [`docs/design-tokens.md`](docs/design-tokens.md) | 颜色/字号/间距的唯一事实来源 |
| [`docs/project/README.md`](docs/project/README.md) | 项目文档索引与待建清单 |
| [`docs/终版对比-官方vs本工程.png`](docs/终版对比-官方vs本工程.png) | 终版并排对照图 |
## 仓库地址
| 站点 | 地址 | 说明 |
|---|---|---|
| Gitee | | 主站 |
| AtomGit | | 备站 |
| GitHub | | 自动镜像从站,不手工推送 |
## 姊妹仓库
- [`dsh-remote-bridge`](https://github.com/westanke/dsh-remote-bridge) —— 本仓的上游,桌面端插件
(REST + WS + 手机设置面板);协议与最低版本要求以它为准(当前要求 ≥ 2.10.0 / 协议 v3)。
- [`dsh-companion`](https://github.com/westanke/dsh-companion) —— 同生态的 Kotlin/Compose 客户端,
与本仓共用同一套 bridge 协议。
## 许可证
[GNU Affero General Public License v3.0](LICENSE)。