# 用户指南

## 初始化项目

1. 在 DSH 中打开 Workspace。
2. 点击左下角 **Workforce**。
3. 点击 **Go!**，将当前 Workspace 初始化为 Workforce Project。

初始化后，项目根目录会创建 `.workforce/`。它属于项目事实，应随项目一起备份，但通常不提交到代码仓库。

## 创建 Agent

打开 **WorkforceCenter**，创建 Agent 并填写名称、Title 和能力简介。高级配置可以选择 DSH 提供的模型、Tools、Skills，并填写 Persona。

- 模型来源由 DSH 管理，Workforce 不要求输入 Key。
- Agent Skills 默认继承当前 Project 可见 Skills；手工选择后使用精确 allow-list。
- Persona 最多 4,000 字符，不要写入凭据或真实敏感数据。

## 管理会话与 Work 会话

- 管理会话：了解进展、调整优先级、登记待办和修改方向。
- Work 会话：执行项目工作并查看具体过程。

V0.1.1 中，每个 Project × Agent 各保留一个管理会话和一个 Work 会话。会话显示在 DSH Workspace 的普通会话列表中。

## Meeting

Meeting 用于组织多个 Agent 围绕同一议题协作。它提供主持人、参会成员、公开讨论、意见征集、明确回应、结论确认与可追踪的会议记录。Meeting 数据保存在当前 Project，不需要安装外部 Room 插件。

## 数据与备份

建议同时备份：

- Project 根目录的 `.workforce/`；
- 用户 DSH Home 下的 `workforce-center/center.sqlite`。

不要只复制其中一项后声称完成了完整恢复。Project 事实以项目目录为权威，长期 Agent 档案以 WorkforceCenter 为权威。

## 常见问题

### Workforce 入口存在，但面板为空

先确认当前 DSH 会话已选择 Workspace。空白新会话使用浮动面板；已有对话使用可调宽度的右侧 details 栏。

### Agent 模型需要重新绑定

这通常表示 DSH 中原 Provider/Model 来源已不可用。到 WorkforceCenter 重新选择当前 DSH 可用模型，不需要在 Workforce 中重填 Key。

### Meeting 一直显示等待回复

先确认参会 Agent 已有可见 Work 会话。Meeting 只记录成员明确提交的意见，不会把沉默解释为同意，也不会自动创建隐藏会话。