dsh-task-dispatch-table 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cq-guojia
+
+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.md

@@ -0,0 +1,49 @@
+# dsh-task-dispatch-table
+
+一个 **dsh（DeepSeek Harness）host 层插件**：用**一张任务定义表**驱动周期性任务，按时间窗与依赖关系把每个任务派发成一个**独立的 dsh 会话**去执行。
+
+> ⚠️ **项目状态：设计阶段。** 尚无可用版本，请勿安装。进度见 [`docs/PROGRESS.md`](docs/PROGRESS.md)。
+
+## 它要解决什么
+
+起因是四类周期性自动化需求：
+
+| # | 需求 | 核心难点 |
+|---|---|---|
+| 1 | 每 N 小时巡检容器与主机资源，异常立即上报 | 高频、纯阈值判断，不该烧 token |
+| 2 | 每天查镜像升级，汇报「更新了什么 + 是否建议升」 | 需要**判断**（读 release notes 评风险） |
+| 3 | 每天汇报 GitHub 上自己的 PR / Issue 进展 | 归纳 |
+| 4 | 每天列 GitHub 趋势项目，给出「新增 / 替换 / 观望」建议 | 重度判断 |
+
+这四件事本身不是重点，重点是：**这类任务以后会有很多，需要一套通用的调度体系**——能拆解、有依赖、可复用、可无人值守。
+
+其中 3 件事的价值在「判断」，而判断只有 agent 能做；**调度本身是纯程序逻辑，一行 token 都不该烧**。
+
+## 设计要点
+
+- **表驱动**：任务定义是一份 JSON 文件，人改、可 review、进 Git。
+- **调度器零大模型介入**：定时 tick → 判时间 → 判前置 → 派发，全部是程序逻辑。
+- **下依赖由下游声明**：加下游不改上游（Airflow / GitHub Actions `needs` 的模型）。
+- **控制平面与数据平面分离**：agent 只写产物，**任务状态只由调度器写**。
+- **状态存 SQLite**（原子领取），任务定义存 JSON。
+
+完整的 13 条决策与理由见 [`docs/design/decisions.md`](docs/design/decisions.md)。
+
+## 文档
+
+| 想看什么 | 去哪 |
+|---|---|
+| 项目进度、未决项、下一步 | [`docs/PROGRESS.md`](docs/PROGRESS.md) |
+| 三层架构与职责边界 | [`docs/design/architecture.md`](docs/design/architecture.md) |
+| 决策与理由 | [`docs/design/decisions.md`](docs/design/decisions.md) |
+| 状态机、依赖语义、必补机制 | [`docs/design/state-machine.md`](docs/design/state-machine.md) |
+| 为什么任务手册是 MD 而不是 skill | [`docs/design/task-manual-vs-skill.md`](docs/design/task-manual-vs-skill.md) |
+
+## 项目信息
+
+- 包名规划：采用 scoped 包名（npm 上 dsh 插件多为 scoped 包），命名与查重记录见决策文档附录。
+- 当前最缺拍板的几个问题列在 [`docs/PROGRESS.md`](docs/PROGRESS.md) 的「未决项」。
+
+## License
+
+[MIT](LICENSE) © 2026 cq-guojia

package/index.js

@@ -0,0 +1,7 @@
+// dsh-task-dispatch-table — placeholder package (design phase).
+//
+// This is an empty stub published only to reserve the npm name.
+// The real implementation is not released yet.
+//
+// Design docs: https://github.com/cq-guojia/dsh-task-dispatch-table
+export default {};

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "dsh-task-dispatch-table",
+  "version": "0.0.0",
+  "description": "一个 dsh host 层插件：用一张任务定义表驱动周期性任务，按时间窗与依赖把任务派发成独立会话执行（调度层零大模型介入）",
+  "keywords": [
+    "deepseek",
+    "harness",
+    "dsh",
+    "dsh-plugin",
+    "task-dispatch"
+  ],
+  "homepage": "https://github.com/cq-guojia/dsh-task-dispatch-table",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cq-guojia/dsh-task-dispatch-table.git"
+  },
+  "author": "cq-guojia",
+  "license": "MIT",
+  "type": "module",
+  "main": "index.js",
+  "files": [
+    "README.md",
+    "LICENSE",
+    "index.js"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}