@xiaoso/dsh-workflow-lite 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2026 xiaoso
+
+本许可证只覆盖本仓库自己的代码（`src/`、`tests/`、`locale/`、`assets/` 与构建脚本）。
+发布物 `lib/client.js` 里内联的第三方代码另有其许可证，逐条见 `THIRD_PARTY_NOTICES.md`。
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,84 @@
+<div align="center">
+  <img width="140" src="./assets/icon-full.webp" alt="dsh-workflow-lite icon"><br>
+  <img width="360" src="./assets/wordmark.png" alt="dsh-workflow-lite">
+</div>
+
+[简体中文](./README.md) | English
+
+A soft-workflow plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness): design a flow on a canvas, compile it into a plan prompt, and let the model carry it out.
+
+> **Experimental**: features and data formats are still changing, and any release may include breaking changes.
+
+[![npm version](https://img.shields.io/npm/v/@xiaoso/dsh-workflow-lite.svg)](https://www.npmjs.com/package/@xiaoso/dsh-workflow-lite)
+[![license](https://img.shields.io/npm/l/@xiaoso/dsh-workflow-lite.svg)](./LICENSE)
+[![node](https://img.shields.io/node/v/@xiaoso/dsh-workflow-lite.svg)](https://nodejs.org)
+[![DeepSeek Harness 0.2.0-x](https://img.shields.io/badge/DeepSeek%20Harness-0.2.0--x-4d6bfe.svg)](https://github.com/deepseek-ai/deepseek-harness)
+
+![dsh-workflow-lite: canvas → plan prompt → model execution](./assets/hero.en.png)
+
+## Install
+
+Works with DeepSeek Harness 0.2.0, including its preview builds (such as 0.2.0-rc.2).
+
+### Web
+
+Requires Node.js 22 or later.
+
+```bash
+dsh plugin --profile web add @xiaoso/dsh-workflow-lite
+dsh web
+```
+
+### Desktop
+
+1. Open **Plugins** in the sidebar, then click **Add plugin** → **Install a third-party plugin**.
+2. Enter `@xiaoso/dsh-workflow-lite` and click **Install**.
+3. Restart DeepSeek Harness.
+
+Once installed, a **Workflow** tab appears at the top of the session page.
+
+## Usage
+
+### Ask the model
+
+Describe the flow in one sentence in the conversation, for example:
+
+> Create a workflow: write the code, then review it; if the review fails, go back and fix it, at most three rounds.
+
+The model creates the workflow and the canvas shows it as it is built. When it looks right, click **Run** in the top-right corner, or ask the model to run it.
+
+### Edit by hand
+
+1. Open the **Workflow** tab and create a workflow.
+2. Drag steps from the library on the left onto the canvas, fill in their prompts, and connect them.
+3. Click **Run** in the top-right corner, or ask the model in the conversation to run the workflow.
+
+### Follow progress
+
+Turn on **Record run state** in **Workflow settings**. Every run then leaves a record and the canvas updates as the model works. Run records, workflows and versions are managed in the **Workflow hub**, opened from the top-left corner of the canvas.
+
+## Features
+
+| Feature | Description |
+|---|---|
+| Canvas editing | Drag steps and connect them, with pass / fail branches and loops; tidy the layout in one click |
+| Resources | Attach files, folders, URLs or Skills that a step reads or writes |
+| Pre-run questions | Collect the information a run needs from the user; answers are passed to the model with the plan |
+| Model co-editing | The model can create and edit workflows directly, and the canvas updates live |
+| Run state | Progress appears on the canvas as it happens; read each step's summary, adjust its state, and the model is notified |
+| Page preview | HTML files among the resources open as pages; make one a dashboard updated every round to follow a loop's output |
+| Versions | Save versions with notes, compare differences, switch back at any time |
+| Workflow hub | One place for run records across sessions, all workflows and their versions, and plugin settings |
+| Interface | Four light and four dark color themes that follow DSH light or dark mode; English / 中文 |
+
+## How it works
+
+1. **Design**: arrange steps on the canvas, write the prompt each executor receives, and describe the flow with branches and loops.
+2. **Compile**: the plugin turns the workflow into one plan prompt that states the order of work, loop conditions, and each step's inputs and outputs.
+3. **Run**: the model decides how to carry out the plan (working directly, dispatching subagents or forming a team) and reports progress back to the canvas.
+
+The plugin ships no execution engine and needs no extra service; scheduling and judgement stay with the model in your current session.
+
+## License
+
+[MIT](./LICENSE) © xiaoso

package/README.md

@@ -1,3 +1,84 @@
-# Temporary Holding Version
+<div align="center">
+  <img width="140" src="./assets/icon-full.webp" alt="dsh-workflow-lite 图标"><br>
+  <img width="360" src="./assets/wordmark.png" alt="dsh-workflow-lite">
+</div>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+简体中文 | [English](./README.en.md)
+
+[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的软工作流插件：在画布上设计流程，编译成计划提示词，由模型按计划执行。
+
+> **实验阶段**：功能和数据格式仍在调整，后续任何版本都可能包含不兼容的改动。
+
+[![npm version](https://img.shields.io/npm/v/@xiaoso/dsh-workflow-lite.svg)](https://www.npmjs.com/package/@xiaoso/dsh-workflow-lite)
+[![license](https://img.shields.io/npm/l/@xiaoso/dsh-workflow-lite.svg)](./LICENSE)
+[![node](https://img.shields.io/node/v/@xiaoso/dsh-workflow-lite.svg)](https://nodejs.org)
+[![DeepSeek Harness 0.2.0-x](https://img.shields.io/badge/DeepSeek%20Harness-0.2.0--x-4d6bfe.svg)](https://github.com/deepseek-ai/deepseek-harness)
+
+![dsh-workflow-lite：画布 → 计划提示词 → 模型执行](./assets/hero.zh.png)
+
+## 安装
+
+适配 DeepSeek Harness 0.2.0，包括它的各个预览版（如 0.2.0-rc.2）。
+
+### 网页版
+
+需要 Node.js 22 及以上。
+
+```bash
+dsh plugin --profile web add @xiaoso/dsh-workflow-lite
+dsh web
+```
+
+### 桌面端
+
+1. 在侧边栏打开「**插件**」，点击「**添加插件**」→「**安装第三方插件**」。
+2. 填入 `@xiaoso/dsh-workflow-lite`，点击「**安装**」。
+3. 重启 DeepSeek Harness。
+
+安装完成后，会话页顶部会出现「**工作流**」标签页。
+
+## 使用
+
+### 让模型创建
+
+在对话中用一句话描述流程，例如：
+
+> 建一个工作流：先写代码，再审查，审查不通过就回去修复，最多三轮。
+
+模型会创建工作流，画布上会同步显示。检查无误后，点击右上角「**执行**」，或让模型直接执行。
+
+### 手动编辑
+
+1. 打开「工作流」标签页，新建一个工作流。
+2. 从左侧步骤库将步骤拖到画布上，填写提示词并连线。
+3. 点击右上角「**执行**」，或在对话中请模型执行该工作流。
+
+### 跟踪进度
+
+在「工作流设置」中开启「**记录运行状态**」，此后每次执行都会生成一条记录，画布随进度更新。执行记录、工作流与版本统一在画布左上角的「**工作流中心**」中管理。
+
+## 功能
+
+| 功能 | 说明 |
+|---|---|
+| 画布编辑 | 拖拽步骤与连线，支持「通过 / 不通过」分支和循环，一键整理布局 |
+| 资源 | 为步骤指定要读写的文件、文件夹、网址或 Skill |
+| 执行前提问 | 执行前向用户收集必要信息，答案随计划交给模型 |
+| 模型协作编辑 | 模型可以直接创建、修改工作流，画布实时同步 |
+| 运行状态 | 执行进度实时显示在画布上；可查看每一步的摘要、调整状态并通知模型 |
+| 页面预览 | 资源里的 HTML 文件点开就是页面，可做成每轮更新的看板，随时查看循环产出 |
+| 版本管理 | 保存版本、添加说明、对比差异、随时切换 |
+| 工作流中心 | 集中管理各会话的执行记录、全部工作流与版本，以及插件设置 |
+| 界面 | 浅色、深色各四套配色主题，跟随 DSH 自动切换；中文 / English |
+
+## 工作原理
+
+1. **设计**：在画布上编排步骤，为每一步写好交给执行者的提示词，用分支和循环描述流程。
+2. **编译**：插件把工作流整理成一份计划提示词，写明执行顺序、循环条件、每一步的输入与产出。
+3. **执行**：模型按计划自行安排执行方式（直接完成、派发子代理或组建团队），并把进度同步回画布。
+
+插件本身不包含执行引擎，也无需额外服务；调度与判断交由当前会话中的模型完成。
+
+## License
+
+[MIT](./LICENSE) © xiaoso