认识与安装

用一句话解释 dsh 的定位，并说出「一切皆插件」在运行时到底意味着什么。

无。知道 API Key 与命令行即可。

1. DeepSeek Harness（dsh）是 DeepSeek 开源的 Agent Harness，MIT 许可、TypeScript 编写，目前是 0.2.x 预览版；它不训练模型，而是组织模型运行的环境。
2. Cordis 内核只负责插件的加载、卸载与依赖管理；模型、工具、会话、沙箱、存储、循环、调度、UI 都由插件提供。
3. 官方公式是 Agent = Model + Harness；四种运行模式只是四组预设插件，不是能力等级。
4. 可观测性是核心差异：模型看到的系统提示、思维链、工具调用与结果都写入仅追加会话日志，历史从日志派生，可回放与分叉。
5. 模型无关：DeepSeek 官方端点、已收录的目录提供方、自定义 OpenAI 兼容端点都可以接入。

根据操作系统与技术栈选一条安装路线，并完成一次可验证的启动。

会用终端；npm/源码路线的 Node.js 版本要求待核实，以所选 dsh 版本的官方安装文档为准。先用 node -v 查看本机版本。

1. 桌面版：Windows 64 位、macOS Apple 芯片，免装 Node，适合日常办公与文件处理。
2. npm：全局安装后用 dsh web，或直接 npx @deepseek-ai/dsh web；默认地址 http://127.0.0.1:3080。
3. 源码：准备 Git、pnpm 与符合官方安装文档要求的 Node.js；教程所写「Node 24.9+」待核实。依次执行 pnpm install、pnpm run build、pnpm dsh web。
4. Python SDK：Python 3.10+，自带运行时，不需要系统 Node；适合把 Agent 接进 Python 程序。
5. 预览版阶段，安装包、命令与界面都可能变化；生产使用要锁定版本，不要把「最新」当默认。

用桌面版完成一次只读工作区分析，并检查它实际读了哪些文件。

完成 1.2；准备一个专用测试目录。

1. 安装后先配置模型，再选择工作区；第一次不要用生产目录、密钥目录或含隐私的文件夹。
2. 首个任务只读：分析目录结构、说明文件用途，明确禁止修改、删除与安装。
3. 文件编辑、命令执行与后台任务可能改变本地数据；能力范围取决于当前版本与已安装插件。
4. 桌面版提供插件入口与工作区管理，但具体审批行为以当前版本为准。
5. 安装包要核对来源与签名；不要为了安装而关闭系统安全防护。

独立完成启动、模型配置、工作区选择与首条只读任务，并能定位常见失败。

完成 1.2；准备 DeepSeek 账号或 API Key。

1. 启动：npx @deepseek-ai/dsh@latest web；端口冲突用 --port 8080，或 --port 0 让系统选空闲端口。
2. 首次要登录或填 API Key；全新的 Web UI 不会自动选中工作区，未选中时输入框不可用。
3. 预设（标准 / PTC / 极简 / 创造）决定插件组合；权限模式（只读 / 工作区写 / 完全 / 自动审查）决定文件与命令边界，两者独立。
4. 第一条任务先只读，并要求它说明实际读取了哪个文件；去工具记录里核对路径，而不是只看回答。
5. 页面能打开只说明本地服务成功；401、无响应、无法发送分别对应凭据、模型、工作区三类问题。