前言¶
在用 DeepSeek Harness（DSH）做智能体开发时，会话、审批、子智能体状态往往在 Desktop 或 Web 界面里完成。若你更习惯在终端里盯进度、快速批复，再起一套独立 Harness 或单独登录并不必要。dsh-attach 由 lotuc 维护，归类为客户端插件，通过本机 socket 或命名管道接到已在运行的 Host，在终端里呈现与 Web UI 同源的 session、轮次、审批与提问，不额外开 TCP 端口，也不要第二套账号。
这是什么¶
dsh-attach 是一套 DSH 插件：Host 侧暴露 sessionController，客户端 dsh-attach 经本地传输层挂上终端 UI（TUI）。桥接仅限本机，并使用按进程划分的 token 做鉴权。当前 npm 包版本为 2026.1110.1406，许可证 MIT。
Host process ◀── local socket / named pipe ──▶ dsh-attach
sessionController terminal UI
核心功能¶
README 中列出的能力如下，均建立在「附着到既有 Host」之上，而非新建 Harness。
会话：列出、恢复、创建、fork、归档/取消归档、固定/取消固定、预设。
实时视图：流式文本、推理与工具输出；轮次折叠；时间戳、活动标签；token、上下文与权限状态。
交互：审批、提问、goals、plan mode、待办列表、队列。
检索与历史：/find；Ctrl+R 或 /history；可分页读取更早记录（默认加载约 300 条消息）。
子智能体：谱系、只读历史、继续/中断、回到父会话导航。
命令：/ 补全本地与 Host 命令及参数；Host 命令透传。
旁路提问：/btw overlay；f 以完整工具访问 fork。
详情级别：Ctrl+G 或 /detail compact|standard|verbose。
Jobs 与 Herdr：后台任务输出；Herdr 状态、标题与预览窗格（Herdr 集成仅 Unix）。
重连：Host 重启后自动重试；需要时 /reconnect。
跨平台：Unix socket 或 Windows 命名管道；Windows 上 TUI 需 ConPTY 终端（如 Windows Terminal）。
安装与启用¶
环境要求：已有正在运行的 DSH Desktop 或 Web Host、同一 OS 用户，以及 Node.js ^22.19.0 || >=24.0.0。
官方 Quick start 中的安装与首次调用如下。首次安装需由 DSH 加载；之后可通过 Plugin Manager、profile 重组合或 HMR 升级，而不必整应用重启。
dsh plugin --profile desktop add ./dsh-attach
dsh-attach --list
dsh-attach
在 Windows 上，应从 Windows Terminal/ConPTY 运行，可执行文件路径为：
%USERPROFILE%\.dsh\profiles\desktop\node_modules\.bin\dsh-attach.cmd
更细的安装与 CLI 说明见仓库内 docs/getting-started.md。
典型用法¶
- 确认 DSH Host 已在当前用户下运行。
- 按 profile 将插件加入后，用
dsh-attach --list查看可连接的 Host/会话入口。 - 执行
dsh-attach进入 TUI，与 Web 侧同一套 session 操作审批、提问与 slash 命令。 - Host 异常退出或重启后，客户端会尝试自动重连；也可在 TUI 内使用
/reconnect。
键盘与 slash 命令完整表见 docs/keybindings.md；会话、提示、审批与子智能体行为见 docs/usage.md；Host 选项、环境变量与主题见 docs/configuration.md。
安全与限制¶
安全（README 摘要）：传输仅本机 Unix socket 或 Windows 命名管道，无 TCP listener；32 字节 token 采用 timing-safe 比对；Unix 侧 socket/描述符为属主权限，Windows 依赖 ACL 与 token；Host/模型输出经清理以防终端控制序列；能连上该通道者即可操作对应 Harness。详见 docs/security.md。
限制：
- 图片输入仅剪贴板；无
@文件索引或上传。 - 每个终端一个会话视图，其他会话仍在 Host 中运行。
- 子智能体历史只读；控制限于跟进消息与中断。
- Herdr 集成仅 Unix。
- 已加载历史默认 300 条，更早内容靠分页读取。
适用场景与注意¶
适合已在 DSH Desktop/Web 上跑 Host、又希望在 SSH 或本机终端里获得与 Web 等价交互的开发者。不适合期望在 TUI 内做完整文件上传/索引的场景。
DSH 生态主张「一切皆插件」；SkillHub 上的插件目录为社区站点，与 DeepSeek、幻方无官方从属关系。安装任意插件前，插件在本机以当前 dsh 进程权限运行，应自行审阅源码与 MIT 许可证后再加入 profile。
