完成第一个任务
教程 · Next: 提供精确的项目上下文
安装并启动
全局安装命令，进入希望 Agent 理解的项目目录，再从这里启动 omdsh：
npm install --global @agi-fans/oh-my-dsh
cd /path/to/your/project
omdsh如果只想临时体验当前版本而不进行全局安装，可以使用 npx @agi-fans/oh-my-dsh。启动目录会成为会话工作区；如果外层存在 Git 仓库，状态栏会同时解析对应的项目上下文。
安全登录
运行 /login。对于 DeepSeek，omdsh 会打开 API Key 页面，通过遮罩输入框接收 Key，验证后将其保存到 Harness 凭据存储中。若已挂载的提供方注册了 Harness 授权流程，/login 会列出该流程及其方法（例如浏览器登录），终端只渲染流程要求的通知和提问。不要把 Key 追加到命令后：程序会主动拒绝 /login <key>，避免密钥进入命令历史或 Transcript。
外部管理的 DEEPSEEK_API_KEY 仍然可以作为回退来源。通过 /login 主动选择的 Key 会在后续请求及重启后保持更高优先级；/logout 只会删除由 omdsh 管理的选择，并在环境变量可用时回退到环境变量。
在第一条 Prompt 前配置会话
omdsh 将四个概念分别建模，而不是折叠成一个 Mode：
| 概念 | 命令 | 选项 |
|---|---|---|
| Agent | /agent | Standard 是完整 Coding Agent；PTC 默认使用程序化工具调用；Minimal 只保留持久 Bash 与 str_replace_editor；Cordis 增加运行时检查与插件实验能力。 |
| Workflow | /workflow | Default 直接工作；Plan 先调查并提交可审阅计划，再进入实现。 |
| Tools | /tool-mode | Native 暴露函数；Code 通过 run_code 暴露生成的 TypeScript SDK；Both 同时暴露两种形式。 |
| Access | /permission | Read only、Workspace write 或 Full access；/permission 继续作为别名。 |
Agent 与 Tools 会改变模型可见的组合，因此要在第一条 Prompt 前选择；产生模型历史后，它们会被锁定。PTC 默认选择 Code Tools，但仍可在空白会话中通过独立 Tools 选择器覆盖。Workflow 与 Access 是持久化的 Harness 会话状态，之后仍可切换。
选择安全的 Access
在可能修改文件的任务前运行 /permission。交互式选择器提供三种策略：
| 模式 | 适用场景 |
|---|---|
| Read only | 只检查而不写入工作区；提权仍然需要审批。 |
| Workspace write | 允许修改当前工作区，但访问更大范围时仍然需要审批。 |
| Full access | 你信任当前工作区，并明确需要不经审批的完整文件系统访问。 |
Full access 需要二次确认。Access 才是实际的执行边界；Plan Workflow 只提供工作流指导，不能代替 Sandbox 或审批策略。
发送具体任务
第一条消息最好同时说明结果、范围和验证方式。例如：
找出用户设置无法持久化的原因，只修改负责该行为的最小模块，并运行对应测试。不要修改 refs/ 下的文件。Agent 工作时，Deep Driving 表示当前回合仍在运行。Tool Card 会分别展示 Input 与 Output；按 Ctrl+O 可以展开或折叠最近一次工具输出。两行 Status Line 会持续展示 Agent、Workflow、Tools、模型、推理强度、工作区、Git 状态、上下文压力、Token 用量、延迟、缓存率和活动数据，Composer 边界则显示 Access；这些内容都不会被写入对话。
教程 · Next: 提供精确的项目上下文