monotykamary/dsh-factory

🏭 dsh-factory

为 DeepSeek Harness 提供持久化任务图和周期性 Agent 工作

_从一个提示词到一条感知依赖关系的生产线——具备隔离检出、实时 Session 和可审查的结果。_

checks
npm
DeepSeek Harness
TypeScript
license

dsh-factory 将普通的 DSH Session 工作流转变为一个持久化的本地任务工厂。人们可以从 New Session 中捕获工作，模型可以直接构建依赖图，而一个通过租约选举产生的调度器会通过原生 DSH Agent 运行符合条件的节点，且不会引入第二套 Agent 循环、工具注册表或对话存储。

为什么选择 Factory？

| | 能力 | 它能解锁什么 |
| :-: | --- | --- |
| 🕸️ | 依赖图 | 在一个命名流程中实现并行分支、顺序链、汇合以及始终运行的终结器。 |
| 🏃 | 原生 Agent 运行 | 每个分配都作为普通的持久化 DSH Session 执行，并使用所选模型和预设。 |
| 🛤️ | 安全的检出通道 | 基于受管 Git worktree 的当前、隔离和前任复用通道，并具备脏工作和实时 Session 保护。 |
| ⏰ | 一次性 + 周期性调度 | 延迟启动和由 Croner 支持的周期性执行，具备租约安全的激活和不重叠的发生实例。 |
| 🔁 | 自动失败重试 | 突然失败的运行会以指数退避重新排队——默认从三十秒开始重试三次——并支持工作区和按任务的选择退出。 |
| 🏷️ | 项目范围标识符 | 每个工作区都会派生自己的大写键和独立计数器——DOCS-3 与 SR-2 并列——因此跨项目依赖不会出错，同时旧版 FAC 编号仍可解析。 |
| 💬 | 一流的讨论 | 已发布的提示词、引导消息、可重新排序的排队后续消息、图片和 Factory 笔记，汇聚在一个按时间顺序排列的信息流中。 |
| 🔎 | 分类和产物 | 未读和失败的运行结果、变更回执，以及在每次运行的 .artifacts/ 目录下发现的图片和视频。 |
| ✨ | 白手套式接入 | 一个紧凑的 Task/Flow 选择器扩展了 New Session，而不是复制其 Workspace、模型、权限、附件和草稿控件。 |

它如何融入

flowchart LR
Human[Human 或 model] --> Intake[新会话 + Factory 工具]
Intake --> Graph[(任务与流程图)]
Graph --> Scheduler[租约选举调度器]
Scheduler --> Lanes[串行化检出通道]
Lanes --> Agents[DSH 代理]
Agents --> Sessions[(持久会话)]
Sessions --> Triage[分诊 + 工件]
Sessions --> Graph

Factory 是 DSH 之上的控制平面，而非其替代品。Factory SQLite 拥有项目、任务、流程、计划、运行和审查状态。DSH 仍然是代理执行、模型可见消息、待处理提示顺序、工具、附件、会话和工作树安全性的权威来源。

工作流

1. 捕获 — 正常发送以创建实时会话，选择 稍后运行 以创建草稿任务，或将提示放入新的或现有的流程中。
2. 编排 — 添加可搜索的依赖项、并行分支、汇合点、终结器、标签、优先级、计划和模型覆盖。
3. 运行 — 调度器认领就绪的工作，解析安全的检出通道，启动 DSH 代理，并记录带有依赖项和变更账本上下文的分配。
4. 协作 — 队列和引导通过代理收件箱发布；待处理行在被认领之前保持可编辑和可重新排序。
5. 完成 — 缺失的报告会收到一条已记录的下一步提醒；factory_finish 之后会有一条简洁的面向用户的结果，并且仅在会话日志刷新后才结算。
6. 审查 — 分诊保留每个终端事件，包括重复运行、回执、摘要、失败和 .artifacts/ 媒体。

包

| 包 | 职责 |
| --- | --- |
| dsh-factory-protocol | 与宿主无关的任务、流程、运行、计划、观察和图记录。 |
| dsh-factory-store | 持久化服务定义。 |
| dsh-factory-store-sqlite | 事务性文档、存在性、修订和调度器租约。 |
| dsh-factory-domain | 状态转换、元数据结算、工件和 Typert 远程方法。 |
| dsh-factory-tools | 模型图工具、显式完成和捆绑的 Factory 技能。 |
| dsh-factory-scheduler | 依赖项、通道、cron、清理和 DSH 代理协调。 |
| dsh-factory-client-ui | 工作、任务详情、分诊、新会话入口和项目设置。 |
| dsh-factory | 可安装的 Cordis 补丁层捆绑包。 |

安装

Monotykamary DSH 版本

Factory 与 Fabric 和 Fovea 一同随自定义 Web 配置文件提供：

npm install --global @monotykamary/dsh@latest
dsh --profile web

添加到另一个兼容配置文件

dsh plugin --profile web add dsh-factory@latest

安装后重启所选配置文件。Factory 会作为附加侧边栏应用出现，并将其 SQLite 数据库存储在 DSH 主目录下。

在本地安装此检出

bash
git clone https://github.com/monotykamary/dsh-factory.git
cd dsh-factory
bun install
当针对同级 ../deepseek-harness 检出进行协同开发时可选
bun run link:harness
bun run check
bun run install:local -- --profile web --skip-build

安装程序会链接全部八个工作区包，校验组合后的 Factory 行，并且绝不会启动或重启 DSH。

安全模型

一个检出就是一个串行化的写入通道。Factory 绝不会强制移除工作树，绝不会删除脏工作内容，也绝不会在共享存在状态报告存在活动 Session 时释放通道。它拒绝移除主检出和未托管的检出。发布仍然是一项显式任务，并且清理无法改写流程结果。

重复任务在每次发生后都会返回 Scheduled 状态，并在 Triage 中保留每一次成功或失败。调度器接管仅恢复调度器拥有的派发，因此对外部 Session 的观察不会创建重复运行。

浏览器体验

Work 先显示 Emerging work，然后显示按图排序的流程。任务详情结合了属性、依赖关系、调度、模型选择、运行输出、讨论、变更回执和评审媒体。已关联的 Session 可以被结算或归档；从未获取过 Session 的已取消任务可以在显式确认后被永久删除。关系轨道从中性的待处理节点变为蓝色运行中的旋转指示器、绿色完成勾选或红色突发失败叉号。

粘贴的图片复用 DSH 附件库和全屏灯箱。任务详情和精确运行 Triage 会在所属检出的 .artifacts/ 目录中发现图片和视频，并打开一个键盘可访问的轮播，而不会将媒体复制到 Factory 状态中。

开发

要求：Node.js ^22.19.0 || >=24 和 Bun 1.4+。
bash
bun install
当针对同级 ../deepseek-harness 检出进行协同开发时可选
bun run link:harness
bun run check

bun run check 还会打包全部八个包，并使用标准 npm 安装它们，而不使用旧版 peer 模式。面向浏览器的更改还会针对组装好的 Factory Web 配置文件运行 bun run test:e2e。本地截图应放在 .artifacts/screenshots/ 下，并被排除在 Git 和 npm 之外。

有关持久权威、接收、元数据、调度、执行、Triage、清理和浏览器状态归属的信息，请参阅 docs/architecture.md。