# 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 的对话流渲染成原生聊天界面。对话、会话、历史全部留在你自己的机器上。

Version License Platforms Built with Flutter CI

`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)。