{"full_name":"ccch1mneyyy/dsh-TUI","owner":"ccch1mneyyy","name":"dsh-TUI","shard":"1","url":"https://github.com/ccch1mneyyy/dsh-TUI","description":"DSH's officially top-recommended TUI plugin — high performance, low overhead, cute pixel whale, smooth mouse interaction. One-command install via npm. / DSH 官方首推的 TUI 插件，高性能低占用，可爱像素鲸鱼，流畅鼠标交互，npm 一键安装","homepage":"https://dshtui.com/","topics":["claude-code","coding-agent","deepseek","deepseek-harness","dsh-plugin","ink","react","terminal","tui"],"tag_pages":["claude-code","coding-agent","deepseek","deepseek-harness","dsh-plugin","react","terminal","tui"],"language":"TypeScript","license":"MIT","avatar":"https://avatars.githubusercontent.com/u/268149062?u=6b8c7bba58214354b91e45e6cbbfae95ab85eabc&v=4","created_at":"2026-08-13T12:49:31Z","pushed_at":"2026-11-15T19:17:51Z","metrics":{"stars":7757,"forks":370,"watchers":9,"issues":823,"prs":1099,"releases":40,"issues_open":106,"issues_closed":717,"prs_open":55,"prs_closed":267,"prs_merged":777,"discussions":112},"growth":{"day":{"stars":47,"forks":0,"base_day":"2026-11-15"},"week":{"stars":480,"forks":19,"base_day":"2026-11-09"}},"history":{"dates":["2026-11-09","2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[7277,7367,7509,7578,7589,7665,7710,7757],"forks":[351,351,354,359,360,367,370,370],"watchers":[10,10,9,9,9,9,9,9],"issues_open":[null,null,110,107,112,114,112,106],"prs_open":[null,null,15,21,24,42,56,55]},"boards":{"weekly_rate":173},"same_owner":[{"full_name":"ccch1mneyyy/dsh-Go","name":"dsh-Go","shard":"1","boards":{"daily":9,"weekly":7,"monthly":13,"daily_rate":31,"weekly_rate":25,"monthly_rate":3,"daily_forks":43,"daily_watchers":163,"new":13}}],"issues":[{"number":1992,"title":"[Bug] 插件热重组后会话被误判 disposed：干到一半显示「会话已结束」，输入坞锁死","comments":4,"created_at":"2026-11-13T19:15:06Z"},{"number":1797,"title":"[Bug] 正文超链接单击无反应：折叠 onClick 抢先消费点击","comments":3,"created_at":"2026-10-28T07:52:50Z"},{"number":1839,"title":"[Bug] 一长串没有空白的文本会让路径链接退化成 O(n²)，btw / 子代理输出能把界面卡住数秒","comments":2,"created_at":"2026-11-01T05:23:00Z"},{"number":1832,"title":"[Bug] 助手/工具文本里的原始 OSC 8 被渲染成真链接：任意 scheme 与伪造显示文本，原生点击绕过 urlGuard","comments":2,"created_at":"2026-11-01T03:24:28Z"},{"number":1819,"title":"[Bug] host 发现不识别 vite-plus 的单一分发 shim，DSH 内核被判成「没有可用的已装 dsh」","comments":2,"created_at":"2026-10-31T17:22:43Z"},{"number":1802,"title":"[Bug] LLM API如果中途返回空，working/cancelPending 会永久卡住，Esc 也停不下来，一直显示“中断中…”","comments":2,"created_at":"2026-10-28T14:03:52Z"},{"number":1761,"title":"[Bug] Windows + DSH 桌面端：Electron 宿主无 TTY stdin，TUI 启动即崩 Raw mode（0.16.1 必现，0.17.0 代码未修）","comments":2,"created_at":"2026-10-25T07:38:50Z"},{"number":1651,"title":"[Bug] Disposed/completed foreground sessions remain busy and leave follow-up prompts queued indefinitely","comments":2,"created_at":"2026-10-20T09:08:14Z"}],"discussions":[{"number":2044,"title":"Idea: a quiet transcript - persist thinking-hidden and allow hiding tool cards","comments":0,"category":"Ideas","created_at":"2026-11-15T16:48:48Z"},{"number":1932,"title":"小米手机17pro hyper 02 4.06正式版不让安装DSH -go更新","comments":0,"category":"General","created_at":"2026-11-10T07:39:13Z"},{"number":1918,"title":"[前端优化] 长会话前端显示六层优化：按块加载 + 行内折叠 + 布局缓存（128 MB 会话首屏 27s → 4s）","comments":1,"category":"Ideas","created_at":"2026-11-09T06:56:50Z"},{"number":1910,"title":"[建议] 增加 DSH_TUI_MODEL_ROUTE / DSH_TUI_EFFORT 启动级覆盖（默认仍遵循 /model 的 last-used）","comments":0,"category":"Ideas","created_at":"2026-11-07T14:27:20Z"},{"number":1909,"title":"[建议] 长会话上翻时历史记录在眼前消失：渲染窗口 RENDERED_ROW_CAP 可配置（默认 120）","comments":0,"category":"Ideas","created_at":"2026-11-07T13:01:30Z"},{"number":1908,"title":"[功能] /vim 开关可持久化：把 vim 模式做成可保存的启动选项","comments":0,"category":"Ideas","created_at":"2026-11-07T05:15:25Z"},{"number":1904,"title":"Tool cards: let a settled card fold to its header, like thinking blocks","comments":4,"category":"Ideas","created_at":"2026-11-06T20:57:55Z"},{"number":1878,"title":"[Idea] 把 OSC 9;4 接上，让 Windows Terminal 任务栏显示运行进度","comments":0,"category":"Ideas","created_at":"2026-11-04T07:23:35Z"}],"latest_release":{"name":"v0.20.1","tag":"v0.20.1","published_at":"2026-11-14T14:12:23Z","body":"自 v0.20.0 以来，dsh-TUI 跟上 DSH `0.2.2-rc.3` 验证线（继续兼容 `0.2.2-rc.2` 及更早验证线），\n让插件往输入框的 `@` 补全里加行，修好迁移在全新 profile 上找不到宿主框架包、Claude 内核在 SDK\n未就绪时误报「未安装」，以及更新/退出时子进程 stderr 尾部引发的崩溃。\n\n## 亮点\n\n- **适配 DSH `0.2.2-rc.3`** — 主适配线前移到 `0.2.2-rc.3`，peer 范围同时保留 `0.2.2-rc.2`、`0.2.2-rc.1` 等旧验证线，停在 rc.2 的用户也能直接装这版。rc.3 是版本列车重发：共有包的 `.d.ts` 零变化，唯一 `.js` 变化是 `dsh-tool-cordis` 的 API 目录，宿主复刻指纹与 patch surface 内容都没变，本版没有 TUI 可见行为改动。上游新增的 `@deepseek-ai/dsh-deepseek-chat-import` 是 web-only bundle（浏览器端导入 DeepSeek 官网对话导出），TUI 没有对应入口，刻意不接入。([#2009](https://github.com/ccch1mneyyy/dsh-TUI/pull/2009) by @Lucas2011wastaken)\n- **插件可以往 `@` 补全里加行（实验性）** — 插件用 `ctx.tuiMentions.register({ id, title, complete(query, signal) })` 往输入框的 `@` 补全浮窗加行，与工作区文件共用一张卡：出现插件行时卡片标题从「文件」变成「提及」，插件行按与文件同一套模糊分并排（文件顺序不动、平分归文件）。行是 `{ label, detail?, insertText }`，选中后把纯文本 `insertText` 替换敲入的 `@query`，提交时不按路径解析、不当附件。每次查询单独一个 `AbortSignal`，继续打字即中止上一次，单次预算 300ms；每提供方每次 ≤50 行，每插件 ≤4 个、全局 ≤16 个。没有提供方时补全浮窗逐帧不变。类型 `TuiMentionProvider` / `TuiMentionItem` 进 `./extensions` 与 `./api`，规则表见[准入与开发指南](https://github.com/ccch1mneyyy/dsh-TUI/blob/main/tui-profile/docs/plugin-admission-and-development.md)接缝十五。([#1716](https://github.com/ccch1mneyyy/dsh-TUI/pull/1716) by @ccch1mneyyy)\n\n## 需要留意的行为变化\n\n- **`@` 补全的插件行只做文本插入** — 选中插件行只替换当前 token，不参与文件提及展开器；`insertText` 限纯文本、单行、≤200 字符，含 `@` 提及记号的在准入时丢弃。`register` 对非法输入、重复 id 或超额直接抛错，dispose 随插件 activation 回收。这是实验性接缝，仍可能随 TUI Profile 演进调整；没有插件行时补全浮窗与之前逐帧一致。\n- **Claude 内核行不再显示「未安装」** — SDK 未就绪但检测到 CLI 时，行显示 `claude-code vX.Y.Z · SDK 未就绪`（英文 `SDK unavailable`），Enter 仍打开 SDK 安装向导。SDK 仍是 Claude 后端的必要依赖，缺 SDK 时保持不可启动；CLI 路径查找、登录与模型调用逻辑不变。\n- **迁移失败提示分流** — profile 内编译产物缺失或过旧仍是 `needs the profile's compiled copy`，提示先跑 `dsh-tui update`；入口存在但依赖加载或执行失败改报 `could not run` 与具体包名/原因，不再一律要求升级 TUI。\n- **rc.3 与 `/update`** — rc.3 没有 TUI 可见变化；程序内 `/update` 会在目标 TUI 的 peer 范围内选已发布的最高版本，因此会把 dsh 引擎从 rc.1 / rc.2 对齐到 `0.2.2-rc.3`。\n\n## 修复\n\n- **更新/退出不再被子进程 stderr 尾部打断** — 子进程 stderr reporter 销毁即进入终态：迟到尾部立即丢弃，不再创建定时器或调用通知，并清空只属于它的冷却表；此前这种尾部会重新调度通知、访问已失效 Channel 并以 exit 7 崩溃。活动期的去重/冷却与真实 lease 错误语义保持不变：未销毁 reporter 的负对照仍以 exit 7 暴露 `Channel UI lifetime has ended`。([#1981](https://github.com/ccch1mneyyy/dsh-TUI/pull/1981) by @ccch1mneyyy；诊断与补丁建议来自 @frederick-wang 在 [#1979](https://github.com/ccch1mneyyy/dsh-TUI/issues/1979) 的记录)\n- **Claude 内核检测** — 已检测到的 Claude Code CLI（包括 Homebrew 安装）在 SDK 不可用时仍显示版本，不再笼统标成「未安装」；CLI 版本仍只探测一次，没有 CLI 或取不到版本时不编造版本，SDK 缺失仍不可启动并保留安装向导。([#1978](https://github.com/ccch1mneyyy/dsh-TUI/pull/1978) by @ccch1mneyyy)\n- **迁移在全新 profile 上可用** — `dsh-tui migrate` 与 TUI 内 `/migrate` 的子进程在第一次导入迁移模块前安装宿主（PATH 上的 `dsh`）的框架包解析，冷 profile 不再因缺少 `@deepseek-ai/dsh-session-persistence-jsonl` 等 peer 而失败。解析只使用宿主公开的 `createRuntimeResolution` 与 `PluginPackages`，不调用会改写 manifest/root 的 `loadProfileDirectory` / `prepareProfile`，也不组合用户插件，成功与失败都会释放 Cordis 作用域；旧 profile 只有 `cli.js` 时仍直接执行。([#1768](https://github.com/ccch1mneyyy/dsh-TUI/pull/1768) by @FlameTN7)\n- **`@` 补全的候选与按键** — 接受时读取当前草稿与光标位置、校验当前 query 后再替换当前 token；异步返回期间保留用户当前选择，迟到结果不覆盖高亮；同一 stdin 批次的 Enter/Tab 不再用旧草稿或越界索引，未实际接受候选时继续走原有的实时草稿提交路径。([#1716](https://github.com/ccch1mneyyy/dsh-TUI/pull/1716) by @ccch1mneyyy)\n\n## 兼容与升级\n\n- **DSH 主适配线**：`0.2.2-rc.3`；`0.2.2-rc.2`、`0.2.2-rc.1`、`0.2.1-rc.5`、`0.2.1-rc.4`、`0.2.1-rc.3`、`0.2.1-rc.2`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1` 以及更早的验证线仍在契约内，契约外版本打漂移警告。\n- **DSH 在 npm 上的 `latest` 仍是 `0.2.2-rc.1`**：`0.2.2-rc.3` 走 `next` 标签。程序内 `/update` 会在目标 TUI 的 peer 范围内选已发布的最高版本，因此会把 dsh 引擎对齐到 `0.2.2-rc.3`。\n- **从 v0.20.0 升级**：程序内 `/update`（本版会一并把 dsh 引擎对齐到 `0.2.2-rc.3`、并对齐全局启动器），或\n  `npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui@0.20.1`。\n- **`dst` 自动化 CLI 的验证线未同步前移**：仍验证到 `0.2.1-rc.5`；在 0.2.2 宿主上可用 `dst dsh` 原样转交官方参数。\n- **嫡系插件清单**：随包的 `tui-profile/feed/first-party.json` 钉到 `0.20.1`。\n- **DSH `0.2.2` 要求 Node `>=24.9`** — 本包自身仍声明 `^22.19 || >=24`；用更旧的 Node 运行 `0.2.2` 宿主属于上游未支持组合，升级前请先确认 `node -v`。\n- **Windows 离线安装器**：引擎验证范围随契约前移到 `0.2.2-rc.3`；已装更高的 RC 会降回验证线。\n\n## 安装\n\n```sh\nnpm install -g","is_prerelease":false},"readme":true,"readme_zh":false,"news":[{"title":"3小时破千！DeepSeek Harness移动端应用来了","url":"https://news.qq.com/rain/a/20261030A0E65W00","source":"腾讯网","lang":"zh","date":"2026-10-30"},{"title":"2860星的DSH终端界面火了！Claude Code同款鲸鱼顶栏，但这3个坑90%的人会踩","url":"https://blog.csdn.net/weixin_63007863/article/details/164450291","source":"blog.csdn","lang":"zh","date":"2026-09-07"},{"title":"dsh-tui：将AI编程助手无缝集成到终端工作流的实践指南","url":"https://blog.csdn.net/weixin_34268753/article/details/92759968","source":"blog.csdn","lang":"zh","date":"2026-08-21"},{"title":"太快了！聊聊 DeepSeek Harness 必装的插件。","url":"https://www.eet-china.com/mp/a517835.html","source":"电子工程专辑","lang":"zh","date":"2026-08-16"},{"title":"开发者打造 dsh-tui：为 DeepSeek Agent 提供终端可视化调试界面","url":"https://www.80aj.com/2026/08/16/deepseek-agent-tui-debug/","source":"80aj","lang":"zh","date":"2026-08-15"},{"title":"DeepSeek Harness插件在GitHub上引发创新热潮","url":"https://www.sohu.com/a/1063330851_122066678","source":"搜狐","lang":"zh","date":"2026-08-15"},{"title":"DeepSeek Harness（dsh）与 dsh-TUI 震撼开源：安装介绍及使用体验，以及它的终端界面","url":"https://blog.csdn.net/qq8864/article/details/163756445","source":"blog.csdn","lang":"zh","date":"2026-08-14"},{"title":"DeepSeek Harness必装的10个插件","url":"https://news.google.com/rss/articles/CBMiU0FVX3lxTFBTaklXbTdXaER5RE43NFhsX2pMYmM0OVY2c3dEdTJjSHdRTHN4d3RzUXdOOG41WEstaWJ5SzZsNE5GM1pJT1lIS3dtVVRvVDVSRnB3?oc=5","source":"电子工程专辑EE Times China","lang":"zh","date":"2026-08-25"},{"title":"16 个超火的 DeepSeek Harness 插件，大肥鱼已经落后 2 个版本了","url":"https://news.google.com/rss/articles/CBMiV0FVX3lxTE82WGVDRF9aanFZckhzRUxMUE1tQXV1NDhuV3BnRzB6cGktNWFQNjRtVm1LbVp0TUkzQmJkVVlLckM1amhONE5zNENWSm1PbzExd0c2dTQ5WQ?oc=5","source":"QQ News","lang":"zh","date":"2026-08-21"},{"title":"DeepSeek Harness Plugins: Install, Add & Build Your Own","url":"https://news.google.com/rss/articles/CBMiZkFVX3lxTE0yTDJEOHVJeno5VExrdEVMamxaUUh2dTJmVnRxRE9aNUxCY1E0eXVNcEhxNHByZk14ZEpkSDJrS18tLUxzR21mV3JITmxwdmI1ZnozMUh6d04xZ050MTFhaWRYSkI0QQ?oc=5","source":"OrcaRouter","lang":"en","date":"2026-08-17"},{"title":"DeepSeek Harness on Windows: How to Run dsh (Desktop App or CLI)","url":"https://news.google.com/rss/articles/CBMia0FVX3lxTFBIcXVPdDVvMERoaGhLSU1DVXZOQVNOYXBnSnRoS1lzY2ZSQ2ktWnNMcWpZUzg1WUJFNExWNFlvZ0dad3ZScVJidDlZQWVRaVA0eFZTa0JjS3NxclJJS19RQU5wNE1KVFRuWEhn?oc=5","source":"OrcaRouter","lang":"en","date":"2026-08-17"},{"title":"DeepSeek Harness插件一夜燃爆GitHub：长期记忆、电子宠物、4399小游戏全来了","url":"https://news.google.com/rss/articles/CBMiSEFVX3lxTFA5dmpZc3d3TC1HczNYOG1KNF9sN0psU0FLVm10Q2dHMGtYdjV4UXZZR3N4azBwSFhnYU5ZX2tpbF84OEYzZ01KRA?oc=5","source":"智源社区","lang":"zh","date":"2026-08-16"},{"title":"最新！DeepSeek Harness桌面版和CLI来了！","url":"https://news.google.com/rss/articles/CBMiU0FVX3lxTE1jSmdxMU9CR3d4VFJFeHpNcXRscW1YYjFDLWV3cElsTVF1WFczcGRDN3B4Vk5keFFGTzhGLWVMc2JDejVWRG5IdDI2bGU3azJMR2pv?oc=5","source":"搜狐网","lang":"zh","date":"2026-08-16"}],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}