前言¶

用 deepseek-harness（下称 DSH）搭一个终端编程智能体，装完核心的 dsh 只是第一步：还需要挑一个终端前端、选一个 preset，再逐项确认首请求暴露哪些工具、自动注入哪些上下文。这些组件分散在不同的包里，组合与调配置要花时间，稍不注意改动还会落到 DSH 核心上。

社区项目 dshX 针对的就是这个组合问题：它把 DSH 核心、一个分叉的终端前端和一个内置 preset 打包成一个 npm 包，用一条 dshx 命令启动，全程零 DSH 核心改动。下面介绍它的定位、核心行为、安装与使用。

这是什么¶

dshX 由 NoNshiranai 维护，MIT 协议，npm 包名 @dshx/dshx，当前版本 0.2.4，依赖 @deepseek-ai/dsh 0.1.0-rc.7 与 @dshx/tui 0.1.5。需要说明：这是社区项目，与 DeepSeek 官方无关联、未获背书；基于 deepseek-harness（MIT）开发，遵循官方插件生态指南，仓库带 dsh-plugin topic。

一句话定位：基于 deepseek-harness + @dshx/tui（dsh-TUI 的分叉）、内置 prefab-anchored-standard 的 Claude Code / opencode 风格终端编程应用。

实现上，dshX 不是 fork，而是一个「profile bundle + launcher + 内置 preset」分发层。dshx 命令等价于 dsh --profile dshx，组合三部分：

• dsh-base：deepseek-harness 核心；
• @dshx/tui：dsh-TUI 的分叉终端前端；
• dshx patch：把默认 preset 设为 prefab-anchored-standard。

核心能力由 deepseek-harness 提供，dshX 只做组合，零 deepseek-harness 核心改动。

核心功能¶

默认 preset：prefab-anchored-standard¶

dshX 内置默认 preset prefab-anchored-standard，思路是先把新会话预填充成一段已验证的轨迹，再把首请求的工具目录和注入上下文收窄到最小集合，之后逐步恢复。

1、会话预填充：新会话用 compact prefab 模板预填充已验证的 anchored 轨迹（prefab-session-seed）；

2、首请求仅暴露官方 Minimal preset 的 REAL 工具对（持久 bash + str_replace_editor），输出预算为 adapter 默认（无 1024 cap）；

3、context-gate：首请求剥离技能目录、AGENTS.md、时间/tmux、hooks 等自动注入，只放行用户主动的 / 技能手势。

晋升与发现工具¶

preset 采用 promoteOn: either：首个持久工具调用或首个助手回复之后，目录收窄为 Minimal 对 + 三个发现工具（dev_tool_search / skill_search / skill_load）+ 显式解锁的工具。

也就是说，晋升后目录仍是小的，其余工具经发现工具按需解锁。

skill-catalog-gate 与内置 j-space skill¶

skill-catalog-gate：prefab 会话不广播 host skill catalog。j-space 经 skill_search + skill_load 或 /j-space 手势按需加载。

dshX 随包内置 j-space skill（J-Space Cognition Suite V3.6）。launcher 以 marker+checksum 幂等同步到 $DSH_HOME/skills/j-space，绝不覆盖用户目录。

子代理、compaction 与 resume¶

这套策略同样作用于子代理（includeSubagents: true）。compaction 之后，会话回到受控相位；resume/reload 保持相位。

安装与启用¶

前置条件：Node ^22.19 || >=24、pnpm 10+（首次初始化 profile 需要）、DEEPSEEK_API_KEY。dsh CLI 已随包内置，无需单独安装 @deepseek-ai/dsh；装了 dshx 之后再单独装官方 dsh 会冲突，不要这么做。

npm install -g @dshx/dshx

全局安装 dshx，自动带上内置 dsh、TUI、preset 和 j-space skill。

dshx

启动应用。首次运行会自动初始化 dshx profile 与内置 preset：执行 dsh plugin --profile dshx add @dshx/tui@<v> @dshx/dshx@<v>（<v> 为对应包版本），并幂等同步内置 preset 与 j-space skill。

典型用法¶

先做环境自检，再按需恢复会话：

# 环境自检
dshx doctor

# 恢复上次会话
dshx --resume

dshx 会透传内置 CLI，dsh plugin --profile X add <pkg>、dsh --version 等命令可直接使用。

preset 切换¶

会话内用 /preset 可切换官方 standard / code / minimal / cordis。优先级为：CC_TUI_PRESET 环境变量 > 持久化选择 > roster default。

注意：minimal 仅 Linux 可用——Windows 上 persistent-bash 无法创建。dshX 默认的 prefab-anchored-standard 在 Windows 用 custom-bash（Git Bash 路径），无此问题。

从 dsh-TUI 迁移¶

dshX 的终端前端 @dshx/tui 是 dsh-TUI 的分叉，与 dsh-TUI 共享 $DSH_HOME/sessions 会话库与 ~/.dsh-cc 偏好目录。从 dsh-TUI 迁移无需搬数据，已有会话和偏好直接可见。

适用场景与注意¶

适合这些场景：

• 想要 Claude Code / opencode 风格的终端编程体验，且基于 deepseek-harness；
• 不想自己组合 dsh、终端前端与 preset；
• 已在用 dsh-TUI，希望默认获得 prefab-anchored-standard 且不搬数据。

使用前注意以下几点：

1、沙箱默认 workspace-write + ask，写入操作会弹审批。workspace-write 只限制写入，不限制读取、网络与进程可见性，Linux 与 Windows 皆然；Windows 的写边界更弱（windows-acl 部分约束、NTFS 硬链接可 alias 外部路径、可写目录须 caller-owned）。

2、可信环境可用 DSHX_SANDBOX_MODE=danger-full-access 进入完整访问（无审批），但默认永远是 workspace-write + ask。

3、遥测默认关闭（session-telemetry-otel 行禁用，无端点）。

4、preset 安装在用户根 $DSH_HOME/.agent-presets（trust: user），安装前可自行审阅 preset/ 下的文件。

5、从 dshX ≤ 0.2.1 升级：旧默认 preset anchored-standard 不会被删除，会留在 /preset 列表；已有 agent-preset 会覆盖 roster default，想用新默认请先 /preset 切回。

6、已知问题见仓库 KNOWN_BUGS.md。

最后是通用提醒：插件以当前 dsh 进程权限运行，dshX 是社区项目，安装前建议检查源码与许可证。协议为 MIT；preset/ 派生自 dsh-anchored-standard 的 prefab 模式（含 DeepSeek Harness Standard preset 改编），原始版权与 MIT 声明保留在 NOTICE。

小结¶

dshX 的价值在于把「DSH 核心 + 终端前端 + preset」的组合固化成一条 dshx 命令：零核心改动、不覆盖用户数据、默认沙箱与遥测关闭，并内置一套首请求收窄的 prefab-anchored-standard preset。如果你在用 deepseek-harness 做终端编程，可以先跑 dshx doctor 检查环境，再决定是否采用。

仓库与目录页：

• GitHub：https://github.com/NoNshiranai/dshX
• 插件目录页：https://www.skillhub.cn/plugins/NoNshiranai/dshX （社区独立目录，与 DeepSeek / 幻方无官方从属关系）