阿古瑶之家

写给第一次打开它的你：别被那些"Profile"、"Bundle"之类的术语吓到。你可以把 DeepSeek Harness（简称 DSH）想象成一个拥有超强动手能力的超级实习生。

你只需要告诉它"做什么"（用自然语言），它就能在你的电脑里帮你写代码、改文件、查资料、跑脚本。本文档的目标是让你在 10 分钟内 跑通第一个任务，并看懂它的工作界面。

📖 快速导航

- Part 1：先看疗效（它能帮你做什么？）
- Part 2：认识它的"工位"（界面长啥样？）
- Part 3：上手三把斧（预设、权限、命令）
- Part 4：新手避坑指南（常见疑问）

一、先看疗效：它能帮你做什么？

为了让你更有动力读下去，我们先跳过复杂的概念，直接看几个真实的使用场景：

你的需求	DSH 会怎么做
"帮我把这个文件夹里所有的 .txt 文件合并成一个"	自动扫描文件夹，读取内容，合并，生成新文件。（使用 PTC 模式 极速完成）
"解读一下这段代码是干什么的，顺便看看有没有 Bug"	逐行分析，给出通俗易懂的解释，并标出潜在的逻辑漏洞。（使用 标准模式 边看边聊）
"我想把项目里所有 var 改成 let，但只改 .js 文件"	先会列一个执行计划给你确认，你点头后，它再批量修改，绝不误删其他文件。
"去网上搜一下最新的 AI 新闻，总结成三条发给我"	自动联网搜索，筛选信息，归纳总结。

一句话总结：它不仅仅是"聊天机器人"，更是一个能直接操作你电脑文件系统的 AI 代理（Agent）。

二、认识它的"工位"（Web 界面速览）

当你启动 dsh web 后，你会看到这个工作窗口。新手上路，你只需要关注以下 4 个核心区域：

1. 左上角 - 工作区（Workspace）：这是最重要的信息！ 它显示当前 DSH 被允许操作的文件夹路径。比如显示 /Users/你的名字/项目，那它就只能读写这个文件夹里的内容（除非你给它更高权限）。

2. 左下角 - 预设模式（Preset）：显示当前助手的能力配置。新手请死磕「标准模式」，它最全能、最稳定。

3. 中间底部 - 输入框：在这里打字跟它聊天，或者敲 / 呼出魔法命令。

4. 右上角 - 会话（Session）：所有聊天记录会自动保存，关掉网页再打开，点这里就能继续上次的对话。

三、上手三把斧：模式、权限与命令

新手不需要了解全部功能，掌握这三个核心设定，你就能驾驭 90% 的工作。

🪓 第一把斧：选对"模式"（Preset）

这就是给助手选的"工种"。不同的工种，干活的方式完全不同。

模式名称	适合谁用	通俗解释
标准模式（默认）	所有人（新手首选）	"人类驾驶员"。助手一次只做一件事（读文件、写代码），做完等你确认再下一步。最适合写代码、修 Bug、探索性任务，过程完全可控。
PTC 模式	程序员 / 运维	"自动驾驶仪"。助手会一次性写好一个完整的程序脚本，然后一口气跑完。最适合批量改文件、数据清洗等步骤固定的脏活累活。
极简模式	进阶玩家	减肥版，省流量（Token），但能力有限。
创造模式	极客玩家	自定义模式，高手才能玩得转。

💡 给新手的建议：默认永远用 标准模式。只有当你要做"把 100 个文件的表头统一修改"这种机械劳动时，才临时在输入框打 /preset ptc 切过去。

🪓 第二把斧：管好"权限"（Permission）

助手在你电脑里干活，肯定不能让它乱翻东西。DSH 设计了三层"门禁卡"：

- 只读（Read-only）：只能看，不能改。适合让它帮你查资料、分析代码。

- 工作区可写（Workspace-write）：新手默认用这个。它只能在当前文件夹里随便改，外面的文件动不了。

- 危险全开放（Danger-full-access）：慎用！ 相当于把整台电脑的钥匙给它了，除非你非常清楚后果，否则别开。

✨ 临时换权限：如果在干活时提示"权限不足"，直接在输入框敲 /permission 就能切换，不需要重启。

🪓 第三把斧：用好"斜杠命令"（Slash Commands）

在输入框里敲 /，会弹出一个菜单。这 4 个命令是新手最常用的"快捷键"：

命令	什么时候用？
/plan	"先报方案，再动手"。当你想让它改代码但又怕它改错了，先敲 /plan，它只会出方案等你确认，你说"OK"它才会动手。
/compact	"清理脑容量"。如果聊天太久，它开始变慢或忘记前面的内容，敲这个给它"整理一下思绪"，省点 Token（流量费）。
/model	"换大脑"。如果你想换个更聪明或更快的模型，敲这个切换。
/permission	上面讲过的权限切换快捷入口。

四、新手避坑指南（FAQ）

Q：安装完后，我到底应该在哪个文件夹打开 dsh web？

A： 在你想让它干活的那个项目文件夹里打开终端/命令行，然后输入 dsh web。比如你想处理 D:/我的文档/毕业论文，就先 cd 到那里再启动。

Q：我在网页里跟它聊着聊着，它突然不干活了，说要我"允许"什么？

A： 这是安全机制。当它要执行"删除文件"、"修改系统设置"等敏感操作时，会弹出一个提示框（或要求你在输入框确认），你点"允许"它才会继续。

Q：标准模式 和 PTC 模式 执行同样的任务，有什么区别？

A： 举个例子，让它们把 10 个文件里的日期改掉。

- 标准模式：它会改 1 个文件 → 等你确认 → 再改第 2 个 → 等你确认……（很慢，但你能随时喊停）。

- PTC 模式：它会瞬间写出 1 段代码 → 你确认一次 → 代码自动跑完 10 个文件。（推荐用于这种批量操作）。

🎯 新手 3 分钟启动清单

如果你现在就想试试，按这个步骤来：

1. 在你的项目文件夹打开终端，输入 dsh web。

2. 在浏览器打开的页面中，确认左上角工作区路径是你当前的文件夹。

3. 确认左下角是 标准模式，权限保持默认的 Workspace-write。

4. 在底部输入框输入你的第一个需求，例如："帮我在这个文件夹里新建一个 readme.md 文件，内容写'这是我的第一个 AI 项目'"。

5. 看着它自动创建文件，恭喜你，入门成功！🎉

📎 附录：给好奇宝宝的"进阶概念"（看懂原版文档用）

如果你去翻官方的详细文档，可能会看到这几个词。这里用一句话帮你翻译：

官方术语	理解
Profile	就是"预设模式"的配置文件，比如标准模式、PTC 模式都算一个 Profile。
Bundle（插件包）	一组能力的集合，比如"文件读写能力"+"搜索能力"打包在一起。选 Profile 时其实就是选了一堆 Bundle 的组合。
Subagent（子代理）	你给助手下的"小弟"。比如让它同时开 3 个小助手分别去查不同资料，最后汇总给你。
Workflow（工作流）	预先写好的自动化脚本，适合跑定时任务或大批量处理。
Session（会话）	就是你和助手的每一次聊天记录，存在 ~/.dsh/sessions 里。
Ralph 循环	高级玩法：让 AI 自己迭代自己，用共享记忆做长期项目。新手暂时用不上。

📌 原文档说明：本文是基于 DeepSeek Harness 官方入门资料的二次创作版本，专为新手用户优化。官方完整参数与安装教程请以原文档为准。