开始任务之前，先弄清研究内容会放在哪里。

1. 把工作区看成一份研究记录

只要先弄清每个区域负责什么，界面就不会复杂：项目是长期保存研究内容的边界，会话承载一条具体工作线，来源文件提供输入，报告、表格、图片、脚本和日志等 artifact 则是需要检查的产物。

开始前先确认当前项目和会话。即使答案本身没错，放进错误的项目，之后也很难查找、复核和交接。

2. 区分项目状态与会话权限

项目会长期保存研究上下文，但不是所有能力都应该全局开启。当前版本中，本地计算始终可用；SSH 或 WSL 资源需要在确实使用它的会话里单独选择。

这样做的好处是，同一个项目中的不同会话可以面对不同的数据、工具和风险。授予远程环境或执行大量命令前，应再次确认当前会话。

3. 正式任务前先验证模型连接

开始耗时的文献调研或数据分析之前，先核对服务商、Endpoint、模型名称和凭据保存位置。用一个很小的请求测试连接，可以提前发现模型名错误、Endpoint 不可达或额度不足。

模型凭据只应填写在应用专门的密钥设置中；对于远程 MCP OAuth 连接，v0.15.0 会把访问令牌和刷新令牌保存在操作系统密钥环中。不要把 API Key 粘贴到 Prompt、项目文档、截图或代码仓库。

4. 按影响范围检查设置

第一次使用不需要把所有选项都配置一遍。优先检查那些会改变数据去向、Agent 可执行范围和单轮工作量的设置。

• 常规：为 Agent 设置合适的单轮迭代上限；v0.15.0 中 0 表示不限制。
• 环境：查看本地、SSH 或 WSL 能力，只为当前会话选择真正需要的资源。
• 远程访问：只有准备从飞书 / Lark 或微信继续会话时才启用对应入口。
• MCP 连接：添加可选远程服务前，检查目标地址与 OAuth 授权内容。

5. 用一分钟完成启动前检查

耗时或敏感任务开始前，依次确认项目、会话、模型、计算环境、授权边界、输入文件和预期产物，再用最小请求证明整条路径可以工作。

如果任务会连接外部模型、数据库、MCP 服务、远程计算机或即时通讯平台，应在第一次工具调用前判断这些数据是否适合发送到对应服务。

• 项目与会话选择正确。
• 模型连接通过一个小请求测试。
• 只启用任务需要的计算与远程服务。
• 输入路径稳定，预期产物说清楚。
• 敏感数据与凭据没有进入 Prompt 和共享产物。

6. 界面不一致时，回到对应版本说明

Wisp Science 持续更新，设置项和面板位置可能发生变化。画面与视频不同时，先确认已安装版本，再查看对应 Release Note 和当前文档，不要凭旧截图猜按钮位置。

视频负责帮助你建立整体认识，具体版本的行为则以发布说明为准。