A_ComposableDigitalWorker

graph_horses · Composable Digital Workforce

在同一个平台 DeepSeek Harness（DSH）中，打造属于你所在行业的专属 AI 员工、团队与工作流，让每个岗位拥有自己的专业能力、认知与记忆。

Build the AI employees, teams, and workflows your industry needs—all within DeepSeek Harness (DSH), with role-specific capabilities, professional knowledge, and memory.

从一个岗位，到一支分工协作的团队，再到可执行、可验收的工作流。自带软件开发专业团队，也支持你围绕 AI 视频制作、内容策划、研究分析等场景，自定义岗位、组织能力与专业知识，让不同员工各司其职，在同一平台完成任务与交付。

Start with one specialist, assemble a team, and turn its responsibilities into a workflow with clear deliverables and review criteria. A software development team is included; you can also configure teams for AI video production, content planning, research, and other domains using the models and tools available in your DSH environment.

简体中文 · English · 安装 / Installation · 使用 / Usage · English quick start

下载插件 / Download plugin · SHA-256 · 版本说明 / Release notes

下载 .tgz 安装插件；GitHub 的 Source code ZIP 是开发源码。当前版本为带已知限制的预发布。

Install the .tgz plugin package. GitHub’s Source code ZIP contains development sources. This is a prerelease with documented limitations.

flowchart LR
    R["岗位定义 / Role definitions"] --> E["专业员工 / Specialists"]
    K["专业认知与记忆 / Knowledge & memory"] <--> E
    E --> T["协作团队 / Teams"]
    T --> W["任务工作流 / Workflows"]
    W --> D["成果与验收 / Deliverables & review"]
    D -->|"归档与核验 / Archive & verify"| K

简体中文

产品能力 · 内置软件团队 · 安装 · 完整使用流程 · 认知与记忆 · 卸载与数据 · 开发与贡献

一个平台，组织你需要的专业分工

graph_horses 是一个独立的 DSH 第三方插件。你可以为员工定义“负责什么、擅长什么、使用什么模型和工具、参考什么专业知识”，将员工组织为团队，再用工作流明确每一步由谁负责、交付什么、如何验收。

能力 · 你可以做什么 自定义专业员工 · 设置岗位使命、职责、工作规范与边界；按岗位选择模型、Skill、插件和 MCP 偏好。 组建协作团队 · 复用已有员工定义，设置团队内名称、上下级关系与职责分工；同一岗位可在不同团队中复用。 编排工作流 · 为步骤指定负责人、输入、交付物、验收标准和不合格退回目标，形成清晰的任务推进路径。 在原生对话中工作 · 在 DSH 项目对话选择工作流，当前负责人直接处理你的消息，沿用原生附件、历史、工具与审批。 积累专业认知与记忆 · 上传资料，浏览概念与实体关系、重组文章和原始证据，分别管理员工私库与团队共享知识。 跟踪交付与验收 · 查看阶段成果、任务与交付历史；验收后推进，退回后返工，保留原记录与修改依据。 分享与复用配置 · 使用 JSON 导入、导出员工、团队和工作流定义及必要依赖。

例如：打造一支 AI 视频制作团队

你可以根据自己的制作方式配置以下岗位，并为每个岗位补充专业资料与可用工具：

岗位示例 · 主要职责 · 专业认知与记忆示例 制片／策划 · 明确受众、主题、风格、周期与交付要求 · 品牌规范、受众资料、已确认的创作要求 编剧 · 设计叙事结构、脚本、对白与节奏 · 人物设定、世界观、脚本规范与已确认修改 分镜／视觉设计 · 把脚本转为镜头、画面和视觉要求 · 镜头语言、角色外观、色彩和构图规范 影像／音频制作 · 使用已接入的工具生成或处理素材 · 模型使用方法、素材规范、已验证的制作经验 剪辑／交付 · 组织镜头、音频、字幕及输出版本 · 剪辑规范、字幕样式、画幅与输出要求 质量审核 · 核对叙事、人物、视觉一致性及技术指标 · 审核清单、历史缺陷及验收标准

工作流可以是：创作简报 → 脚本 → 分镜 → 素材制作 → 剪辑 → 质量审核 → 交付。同样的方法也适用于其他行业：改变岗位、工具、知识和验收条件，即可建立自己的专业协作方式。

这是自定义配置示例。仓库当前预置的是软件开发团队；视频生成、配音、剪辑等模型或服务需要在 DSH 中另行接入。员工的能力取决于实际可用的模型、Skill、插件、MCP 和工具。

开箱提供软件开发专业团队

全新 profile 首次启动时提供六个完整岗位，以及对应团队和两条工作流：

岗位 · 主要职责 · 必备 Skill 产品负责人 · 需求、范围、优先级、验收与需求覆盖 · requirements-acceptance 技术负责人／架构师 · 架构、接口、技术取舍、工作分解与独立审查 · architecture-design UX/UI 设计师 · 用户路径、交互状态、视觉与可访问性 · ux-design-review 开发人员 · 增量实现、问题定位与回归测试 · incremental-implementation 测试负责人 · 功能、边界、性能、回归与质量证据 · quality-verification 运维负责人 · 打包、安装升级、运行交接、回滚与卸载验证 · release-readiness

• 软件工程 · 10 步：需求与验收基线 → 交互与体验定义 → 架构与实施契约 → 测试与性能计划 → 增量开发 → 独立代码审查 → 功能与性能复测 → 打包与运行交接 → 需求覆盖与用户验收 → 复盘与知识交接。
• 缺陷修复 · 5 步：复现与根因定位 → 最小修复 → 独立审查 → 功能与性能回归 → 修复交付。

每个岗位包含职责与边界、模型继承、必备／优先技能、工作方法、证据与记忆规范、协作及交付定义；每个步骤包含负责人、输入、产物、验收与退回规则。插件共提供 22 项内置技能，覆盖需求、架构、设计、实现、测试、代码审查、发布和工程收尾。详见软件岗位技能。

默认内容可编辑、复用或替换，不包含【演示】工作流、模拟完成记录或伪造的已确认记忆。安装不自动执行业务任务；升级已有 profile 不静默覆盖用户配置，也不自动补入默认对象。

安装与第一次使用

准备条件

项目 · 当前范围 DSH · 官方 DeepSeek Harness `0.2.1-alpha.2`；其他版本需要重新验证。 Node.js · 声明范围 ^22.19.0 · >=24；当前验收使用 24.21.0。 界面 · DSH Web 客户端；插件界面跟随 DSH 的中文／English 设置，业务内容保持原文。 模型 · 在 DSH 中配置可用模型；员工可继承 DSH 默认值或选择单独的岗位模型。 安装包 · 维护者提供的 dsh-plugin-composable-workforce-0.27.0.tgz 及对应 SHA-256。

正式安装只需要受支持的官方 DSH 和插件 .tgz，无需克隆、修改或重建 Harness。先核对归档校验和并停止目标宿主，再使用自己的 DSH_HOME 与 profile：

# 替换为你的 DSH 数据目录、profile 和插件归档绝对路径。
DSH_HOME=/absolute/dsh-home dsh plugin --profile web add \
  /absolute/dsh-plugin-composable-workforce-0.27.0.tgz \
  --config.auto-install-peers=false \
  --config.strict-peer-dependencies=false \
  --ignore-scripts

安装或更新后，重新启动目标 Harness，并刷新已打开的页面。版本兼容性以实际官方发行版和同一归档哈希的验收为准；安装命令的包管理参数不代表其他版本已兼容。

最快体验路径： 打开左侧 graph_horses → 查看内置六岗位与软件开发团 → 在 DSH 中打开一个项目及其原生对话 → 选择 工作流：软件工程 → 向当前负责人描述任务 → 从顶部 详情 查看交付并验收。

安装、更新、数据归属与完整清理说明见接入与生命周期指南。

从员工到交付：完整使用流程

1. 创建或调整专业员工

在 graph_horses → 自由职业人库 中选择已有岗位，或新建一个岗位。这里的“自由职业人”是可复用的员工定义；项目执行时才建立具体员工实例。

配置入口 · 使用方法 模型配置 · 跟随 DSH 当前默认模型，或指定岗位的 provider、model 与推理力度。账号和凭据仍由 DSH 管理。 岗位定义 · 填写岗位使命、职责、工作规范和边界。可使用“AI 智填”生成可编辑草稿，检查后保存。 能力组合 · 添加必备／优先 Skill、优先插件与优先 MCP。必备 Skill 每份工作单开始时加载；优先 Skill 在任务匹配时按需读取。 认知记忆 · 上传专业资料，浏览知识关系、文章和原文，管理自动归档设置。

“AI 智填”使用当前草稿的姓名和模型，生成结果不会自动保存为正式配置。选中某个插件或 MCP 只表达使用偏好，不会自动安装、连接或授予权限；需要先在 DSH 中准备好相应能力。

2. 组建团队

在 团队 中引入已配置的员工，设置团队内名称及上下级关系。员工定义可被多个团队复用，同一岗位也可作为不同成员加入团队。

团队的 资料管理员 开关控制团队共享及成员长期知识的使用与整理。共享资料管理员跟随团队唯一负责人的模型；员工私库使用该员工的模型和独立整理提示，不额外占用业务岗位。

3. 定义工作流

在 工作流 中新建或编辑流程，先引入团队，再为每一步选择该团队内的负责人。当前编辑器提供步骤说明、交付内容、验收标准和退回目标；输入资料与依赖可写入步骤说明：

• 步骤说明与输入：这一阶段要解决什么问题、依据什么资料。
• 交付内容：应产生的文件、结果或说明。
• 验收标准：如何判断完成，哪些情况需要退回。
• 不合格退回目标：本步骤或之前的有效步骤。

保存后，顺序与返工路径会在流程图中显示。步骤尝试次数和运行参数保持有界，避免没有结束条件的重试。

员工和团队引入项目时保存独立配置。当前工作流库则是流程定义的来源：编辑通过版本校验同步到项目引用，项目继续独立保存人员绑定、进度与交付历史。涉及已有交付的破坏性修改会被限制；契约变更可能使后续结果需要重新验证。不要把“编辑模板”理解为自动重做已执行任务。

4. 在项目对话中选择工作流

先在 DSH 中打开项目，再打开该项目的原生对话。输入区初始显示 工作流：无，菜单首项也是“无”。

首次选择某个工作流时，会创建其项目团队、员工和人员关系，不执行任务。该项目首次非空选择会成为项目默认，并清除之前的空覆盖，让项目对话统一继承；之后在某个对话改选其他工作流或“无”，只改变该对话的选择。同项目、同工作流共享步骤进度与验收记录。

直接输入任务即可由当前步骤负责人接手，无需 @。需要单独派工时，可在行首输入 @，选择当前项目已启用的员工；输入中间的 @ 继续使用 DSH 原生引用功能。

顶部步骤条以 灰色 表示未完成、蓝色 表示当前步骤、白色 表示已验收。点击步骤只切换当前步骤与负责人，不会把之前步骤标成完成。执行期间会限制身份与流程切换。原生空白对话的顶部区域在首次发言后显示。

5. 查看成果、验收与返工

点击顶部 详情，左侧查看完整步骤和负责人，右侧查看步骤要求、阶段文件、交付记录、任务摘要及验收结果。工作流 / 项目知识库 页签支持只读查看当前流程团队的跨阶段知识与来源。

查看其他步骤不会激活它，明确点击 设为当前 才会切换。通过当前负责人真实交付的人工验收后，流程才推进；退回需要填写意见，并按配置返回相应步骤。旧交付与验收记录保留，失效结果不再作为本轮有效成果。

选择 无 后恢复 DSH 原生对话行为，移除工作流负责人上下文和模型覆盖；它不会清空历史、重置原生最近使用模型，或改写全局模型默认。更多规则见工作流详情与验收。

专业认知与记忆如何工作

每位员工可以拥有自己的专业资料和可见记忆，团队也可以形成共享知识。专业认知不只是一段角色提示词，还包含能回到原文核对的资料、知识重组和关系结构。

层次 · 内容 · 用途 A · 原始资料 · 上传原件、阅读文本、版本、哈希与来源 · 核实原文、精确引用、比较变化与冲突。 B · 知识重组 · 基于来源整理的文章、解释及引用 · 按任务读取专业细节；模型综合保持候选状态。 C · 导航与关系 · 概览、概念／实体及有证据的语义关系 · 定位相关知识，再按需读取 B 或 A。

图谱支持搜索、拖动、缩放、关联展开与同屏阅读。连线来自有证据的语义关系，不因两个页面共用来源就虚构关系。员工私库、团队库和不同项目之间保持作用域隔离；共享同一套知识程序不等于共享全部数据。

资料管理： 在“专业知识”中上传 PDF、DOCX、UTF-8 文本、Markdown、JSON、CSV、YAML 或日志。单文件最多 6 MiB，每次最多 8 个文件／12 MiB。原件与提取文本分别保存；扫描 PDF 和图片文字不做隐式 OCR。抽取或整理失败会保留已归档资料，并提供状态与重试。

四类知识： 专业知识、任务档案、复盘经验、工作约束。后三类有独立自动归档开关；关闭分类开关停止后续自动收录，已有资料仍可阅读，重新开启不会立即补扫。团队资料管理员总开关关闭时，则停止该团队及成员长期知识的读取、写入和整理，保留数据。

增量整理： 来源更新后只处理变更及必要依赖，保留未受影响内容；重复上传或无变化重试不产生新的模型编纂。自动资料按任务稳定阶段合批，首次启动只本地归档。需要编纂时会通过 DSH 模型服务调用模型，可能产生模型费用；打开已有图谱或阅读文章不会因此发起编纂。

事实与候选分开： 模型提案、临时聊天和未验收产物不会自动变成已确认长期事实。失败复盘保留现象、证据、原因假设、建议与验证步骤；不会自行确认原因、修改 Skill 或执行建议。出现冲突时保留版本、适用条件和来源，自然语言冲突识别仍受模型能力与证据范围限制。

详见团队知识库、严格增量规则及共享 LLM Wiki。

分享、迁移与配置复用

员工、团队和工作流标题栏提供导入／导出；使用兼容 JSON 格式交换当前对象及必要依赖。导入先更新草稿，检查并保存后才写入，保留当前对象身份；依赖重新映射为新 ID，不覆盖无关对象。

• 格式标识为 graph_horses，formatVersion: 1，最大 1 MiB；JSON 配置文件不是插件安装包。
• 不导出项目路径、私有记忆、凭据、执行日志或项目工作台任务／成果历史；自由文本仍可能包含你填写的信息，分享前应检查。
• Skill、插件、MCP 和工具保存的是引用，接收环境仍需具备实际能力；导入不会自动安装或扩权。
• 兼容的项目实例配置导入默认暂停，不恢复或重放历史任务。

详见对象设置交换。

官方扩展边界、数据与卸载

插件不修改 DSH 源码、构建产物、内置插件或安装目录，只使用目标官方版本已有的 Cordis、bundle/profile、公开服务及 UI 插槽。岗位、Skill、知识和员工之间的消息不会扩大权限；执行继续遵循 DSH 原生预设、沙箱与审批。插件是第三方项目，不代表 DeepSeek 官方出品或背书。

默认专属数据位置为：

$DSH_HOME/composable-workforce/state.json
$DSH_HOME/composable-workforce/knowledge/state.json/

状态文件保存员工与团队定义、项目实例、记忆、运行及兼容业务记录；知识目录保存资料、原件、版本和派生知识。自定义 statePath 会改变对应位置，完整归属清单见生命周期指南。

保留数据卸载： 先停止目标宿主，执行官方命令，之后重启并刷新页面。专属配置与数据保留，便于重装恢复。

DSH_HOME=/absolute/dsh-home dsh plugin --profile web remove \
  dsh-plugin-composable-workforce --config.auto-install-peers=false

插件专属文件与配置清理： 使用随包脚本先预览，再在目标宿主已停止的条件下执行。请在移除插件前保留该脚本的可用位置；purge 会自行调用官方 remove。

# 指向实际官方 npm 安装和目标数据目录，不是 Harness 源码目录。
export DSH_INSTALLATION_MANIFEST=/official/install/node_modules/@deepseek-ai/dsh/package.json

node /installed/plugin/scripts/plugin.mjs purge \
  --home /absolute/dsh-home --profile web --dry-run

node /installed/plugin/scripts/plugin.mjs purge \
  --home /absolute/dsh-home --profile web --host-stopped

清理只处理经归属校验的插件配置、状态、知识、空专属目录及显式指定的自建服务日志。自定义外部状态需要 --owned-state-path；本仓库开发服务清理需要按指南指定 --service-root。用户项目、已交付成果、共享凭据、其他插件数据及不明文件保留。

当前未满足项： 官方 DSH 0.2.1-alpha.2 没有会话持久记录删除接口，员工创建的专属原生会话历史仍会保留。因此，目前通过的是插件运行能力、专属文件和配置级清理，尚未满足全部插件专属持久记录清除的严格要求；0.27.0 是带保留项的验收候选，不能标记为无保留合规成品。 详见ADR-001和版本验收记录。