# DSH Workforce

[English](README.md) | 中文

DSH Workforce 是 DeepSeek Harness（DSH）上的本机 Agent 组织与项目协作插件。它把长期 Agent、项目成员关系、工作会话、管理会话和结构化 Meeting 组织在同一个 Workforce 体验中，同时继续使用 DSH 提供的模型、Tools、Skills、Session 与运行时能力。

当前版本：`V0.1.1`

## 主要能力

- WorkforceCenter：跨项目管理长期 Agent 档案、Persona、模型绑定、Tools 与 Skills。
- Project Sidebar：查看当前 Workspace 对应的 Workforce Project、Agent、Work 和 Meeting。
- Agent 对话：每个 Project × Agent 提供一个可复用 Work 会话和一个管理会话。
- Project 隔离：项目事实保存在项目目录，长期 Agent 档案保存在用户级 WorkforceCenter。
- Meeting 协作：提供参会人员、讨论轮次、明确回应和可持久追踪的结论，不依赖外部 Room 插件。
- 本机优先：V0.1.1 面向单用户、本机 DSH Web Profile，持久化使用 SQLite。

## 运行要求

- Node.js 24
- DeepSeek Harness `>=0.1.1-rc.2`

Workforce 不要求用户在插件中填写模型 Provider、API Key 或模型名称。Agent 的模型目录和基础来源由 DSH 提供；如果 DSH 中的来源失效，Workforce 会提示重新绑定。

## 安装

建议固定版本标签，避免上游更新在未验证时改变本机运行结果：

```bash
dsh plugin --profile web add github:esonx/dsh-workforce#v0.1.1
dsh web
```

也可以安装 GitHub Release 中的 tarball：

```bash
dsh plugin --profile web add ./dsh-workforce-0.1.1.tgz
dsh web
```

完整步骤见 [安装与升级](docs/INSTALLATION.md)。

## 开始使用

1. 正常启动 DSH Web，并打开一个 Workspace。
2. 点击左下角 **Workforce**。
3. 如果当前 Workspace 尚未启用 Workforce，点击 **Go!**。
4. 打开 **WorkforceCenter** 创建或配置 Agent。
5. 将 Agent 加入当前项目，然后打开管理会话、Work 会话或创建 Meeting。

项目中的 `.workforce/` 保存项目事实；用户级 DSH Home 下的 `workforce-center/center.sqlite` 保存长期 Agent 档案。两者都不保存 Provider API Key。备份与恢复建议见 [用户指南](docs/USER_GUIDE.md)。

## 安全边界

- V0.1.1 假设 DSH 由一个本机用户操作，不提供多人登录、企业级 RBAC 或远程服务部署。
- DSH 与同一 Profile 内的插件属于可信宿主范围；不要在同一 Profile 安装来源不可信的插件。
- loopback/Origin/`trustedHosts` 只约束浏览器传输来源，不是 Host 用户认证。
- DSH 的 `allowed-once` 只授权当前执行，不是可持久或可重放的 Host 管理 capability。
- Workspace、Session 和 Preset 的外部 ID 不作为 Workforce 的组织主键。
- 浏览器不能自行指定 Project root、Session ID、Provider Key 或运行时授权身份。
- 跨 Project 访问默认拒绝；未知或部分成功的外部操作不会自动重放。

安全问题请参阅 [SECURITY.md](SECURITY.md)。

## V0.1.1 已知限制

- 仅支持单用户、本机运行；不支持多人账号、多实例或共享数据库部署。
- 每个 Project × Agent 同时最多一个 Work 会话和一个管理会话；历史会话扩展将在后续版本提供。
- Meeting 是项目内的结构化协作记录；V1 正式产品不提供自由群聊 Room 或私聊 Room 入口。
- PRD 与 Dev/Taskboard 在 Sidebar 中仍是后续功能入口。
- Memory V1 提供按作用域隔离的 Agent 长期记忆提炼、整理、检索与用户确认后的 Global 晋升；暂不包含知识库导入。
- DSH 仍处于快速演进阶段；升级 DSH 后应先在测试 Profile 验证插件兼容性。

## 架构边界

Workforce 拥有长期 Agent、Project Membership、Work、Meeting、外部 binding 与 V1 Memory；DSH 继续拥有模型运行时和 Session，任务事实由对应 Project 插件保持权威。详细说明见 [架构概览](docs/ARCHITECTURE.md)。

## 卸载

```bash
dsh plugin --profile web remove dsh-workforce
```

卸载插件不会主动删除项目 `.workforce/` 或 WorkforceCenter SQLite 数据，便于重新安装和恢复。确认不再需要这些数据后再由用户自行备份或清理。

## 许可证与第三方组件

DSH Workforce 使用 [Apache License 2.0](LICENSE)。第三方运行时与 companion 信息见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。

维护者：`esonx`

公开仓库：[github.com/esonx/dsh-workforce](https://github.com/esonx/dsh-workforce)