@michengai/dsh-automation 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,9 @@
+dsh-automation
+Copyright 2026 MichengAI contributors
+
+本项目的 TypeScript 源码、构建脚本与项目文档采用 Apache License 2.0。
+
+产品模型参考了 DeepSeek Harness 社区中的独立自动化实践：
+- 独立 Session 调度与审计历史（titanwings/dsh-automation，MIT）
+
+上述参考实现的许可证与版权仍归其原作者所有；本仓库实现为独立编写，不复制其专有代码。

package/README.md

@@ -0,0 +1,136 @@
+<h1 align="center">DSH Automation</h1>
+
+<p align="center">
+  <strong>A DeepSeek Harness Web plugin for running standalone coding tasks on a schedule.</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/MichengAI/dsh-automation/issues">Report an issue</a>
+  · <a href="https://www.npmjs.com/package/@michengai/dsh-automation">View on npm</a>
+  · <a href="README.zh-CN.md">简体中文</a>
+</p>
+
+<p align="center">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue.svg" alt="Apache License 2.0"></a>
+  <a href="https://www.npmjs.com/package/@michengai/dsh-automation"><img src="https://img.shields.io/npm/v/%40michengai/dsh-automation?label=npm" alt="npm package"></a>
+  <img src="https://img.shields.io/badge/DSH-Web%20Plugin-10b981" alt="DSH Web Plugin">
+  <img src="https://img.shields.io/badge/Node.js-%E2%89%A522.19-339933?logo=nodedotjs&logoColor=white" alt="Node.js 22.19 or later">
+</p>
+
+> DSH Automation is a community-maintained plugin, not an official DeepSeek AI product.
+
+## Features
+
+- Manages scheduled tasks from **Settings → Scheduled Tasks**.
+- Creates, pauses, resumes, runs now, and deletes rules from the Web UI or Agent tools.
+- Starts each occurrence in a fresh root Agent and Session. Source-chat history is not inherited.
+- Supports once, interval, hourly, daily, weekly, monthly, and custom-every-N-days schedules.
+- Lets you pick workspace, model, skills, and `read-only` / `workspace-write` permission in the create dialog.
+- Fills a chat draft from **Create in chat**: `I want to create a scheduled task that runs every [interval] and does [the actual task]`.
+- Keeps durable run history with `queued`, `running`, `succeeded`, `failed`, `skipped`, and `cancelled`.
+- Adds a sidebar **Scheduled** tab. Folders are task names and child sessions are run times. On stock DSH it wraps the official workspace tree instead of replacing it, and it does not depend on `dsh-codex-ui`.
+
+## Prerequisites
+
+- A working DeepSeek Harness Web installation with `dsh` available in PowerShell.
+- Examples use the `web` profile; replace it with the target profile.
+- Source installation and development require Node.js 22.19+. npm installation does not require running `npm install` in an arbitrary directory.
+
+## Installation
+
+### Install from npm
+
+Run this from any PowerShell directory. Install into the DSH profile through `dsh plugin`:
+
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+dsh plugin --profile web add @michengai/dsh-automation
+dsh --profile web --dump-config
+```
+
+Restart DSH Web or reload the active Web profile. If a package mirror is behind, append `--registry=https://registry.npmjs.org/`.
+
+### Install from source
+
+Use this for debugging or unpublished changes. The cloned directory becomes the plugin source path:
+
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+Set-Location D:\Repository\deepseek-harness-plugin
+git clone https://github.com/MichengAI/dsh-automation.git
+Set-Location .\dsh-automation
+pnpm install
+pnpm test
+pnpm build
+dsh plugin --profile web add .
+dsh --profile web --dump-config
+```
+
+Restart DSH Web or reload the active Web profile. Local installation reads and applies `cordis.patch.yml`; do not copy `lib` files manually.
+
+## Usage
+
+Open **Settings → Scheduled Tasks**, then use the panel as follows:
+
+| Goal | Action | Scope |
+| --- | --- | --- |
+| Create a rule | Select **New scheduled task**, then set name, schedule, prompt, workspace, model, skills, and permission. | Host-wide |
+| Create from chat | Select **Create in chat**. Settings close and the composer is filled with a template prompt. | Current conversation |
+| Pause or resume | Use the switch on a task card. | One rule |
+| Run now | Open the card menu and select **Run now**. | One rule |
+| Delete | Open the card menu and select **Delete task**. Run history is kept. | Definition only |
+| Inspect runs | Open **Run history**, then filter by day, week, month, task, or status. | Host-wide |
+
+Each dispatched run uses the saved prompt, workspace, model, and permission boundary. It does not reuse approvals from the source chat.
+
+## Safety boundary
+
+| Item | Behavior |
+| --- | --- |
+| Permission | Default is `read-only`. File writes require an explicit `workspace-write` choice. |
+| Full access | Unattended `danger-full-access` is not offered. |
+| Approval | Unattended runs use fail-closed `never` and do not wait for a missing human. |
+| Retry | No automatic retry after a started run. |
+| Host restart | Leftover `queued` / `running` records become `failed(host_interrupted)`. |
+| Overlap | One active run per rule. A colliding occurrence is recorded as `skipped(overlap)`. |
+
+A schedule stores future intent. It is not a cached permission grant.
+
+## Development
+
+Current sources live in `src` and build into `lib`:
+
+- [src\index.ts](src/index.ts): Host plugin, tools, and RPC.
+- [src\service.ts](src/service.ts): Durable definitions, clock, and run admission.
+- [src\client\index.ts](src/client/index.ts): Settings page and chat prefill.
+- `tests\*.test.ts`: Domain, recurrence, service, client, and package-contract tests.
+
+After changing files, run tests, rebuild, and reinstall from the local directory:
+
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+pnpm check
+dsh plugin --profile web add .
+```
+
+Keep the at-most-once dispatch policy, workspace scoping for Agent tools, and fail-closed unattended approval when changing execution code.
+
+## Verification
+
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+pnpm test
+pnpm build
+```
+
+`pnpm check` runs typecheck, tests, and build together.
+
+## Project docs and license
+
+Start from the [documentation entry](docs/00-交接入口/00-阅读导航.md) for project status, architecture, and the current iteration. Product notes live in NOTICE.
+
+This project uses [Apache License 2.0](LICENSE).

package/README.zh-CN.md

@@ -0,0 +1,136 @@
+<h1 align="center">DSH Automation</h1>
+
+<p align="center">
+  <strong>在独立 Session 中按计划执行编码任务的 DeepSeek Harness Web 插件。</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/MichengAI/dsh-automation/issues">反馈问题</a>
+  · <a href="https://www.npmjs.com/package/@michengai/dsh-automation">在 npm 查看</a>
+  · <a href="README.md">English</a>
+</p>
+
+<p align="center">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue.svg" alt="Apache License 2.0"></a>
+  <a href="https://www.npmjs.com/package/@michengai/dsh-automation"><img src="https://img.shields.io/npm/v/%40michengai/dsh-automation?label=npm" alt="npm 包"></a>
+  <img src="https://img.shields.io/badge/DSH-Web%20Plugin-10b981" alt="DSH Web Plugin">
+  <img src="https://img.shields.io/badge/Node.js-%E2%89%A522.19-339933?logo=nodedotjs&logoColor=white" alt="Node.js 22.19 或更高版本">
+</p>
+
+> DSH Automation 是社区维护的插件，并非 DeepSeek AI 官方产品。
+
+## 功能概览
+
+- 在「设置 → 定时任务」集中管理规则和运行历史。
+- 支持从 Web 或 Agent 工具创建、暂停、恢复、立即运行和删除。
+- 每次到期都启动全新 root Agent 和 Session，不继承来源对话。
+- 计划类型包括不重复、间隔、每小时、每天、每周、每月和自定义间隔天数。
+- 新建弹窗可选择工作目录、模型、技能，以及 `read-only` / `workspace-write`。
+- 「通过对话创建」会关闭设置页，并在输入框填入：`我要创建一个定时任务，每【时间间隔】执行【具体任务】`。
+- 运行状态包含 `queued`、`running`、`succeeded`、`failed`、`skipped`、`cancelled`。
+- 侧栏提供「定时」页签：文件夹是任务名称，子会话是执行时间。原生下只包裹官方任务树，不替换搜索和工作区，也不依赖 `dsh-codex-ui`。
+
+## 前置条件
+
+- 已可正常运行 DeepSeek Harness Web，且可在 PowerShell 中使用 `dsh`。
+- 以下示例使用 `web` profile；请替换为实际目标 profile。
+- 从源码安装或二次开发需要 Node.js 22.19+；仅从 npm 安装无需在任意目录执行 `npm install`。
+
+## 安装
+
+### 从 npm 安装
+
+在任意 PowerShell 目录执行。请通过 `dsh plugin` 安装到 DSH profile：
+
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+dsh plugin --profile web add @michengai/dsh-automation
+dsh --profile web --dump-config
+```
+
+安装或升级后重启 DSH Web，或重新加载当前 Web profile。若镜像未同步最新版本，可在安装命令末尾追加 `--registry=https://registry.npmjs.org/`。
+
+### 从源码安装
+
+适用于调试或使用未发布改动。克隆后的目录会直接作为插件安装路径：
+
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+Set-Location D:\Repository\deepseek-harness-plugin
+git clone https://github.com/MichengAI/dsh-automation.git
+Set-Location .\dsh-automation
+pnpm install
+pnpm test
+pnpm build
+dsh plugin --profile web add .
+dsh --profile web --dump-config
+```
+
+完成后重启 DSH Web 或重新加载当前 Web profile。`dsh plugin ... add .` 会自动读取并应用 `cordis.patch.yml`；不要手工复制 `lib` 文件。
+
+## 使用
+
+打开「设置 → 定时任务」，再按下表操作：
+
+| 目标 | 操作 | 范围 |
+| --- | --- | --- |
+| 创建规则 | 点击「新建定时任务」，填写名称、计划、任务说明、工作目录、模型、技能和权限。 | 当前 Host |
+| 通过对话创建 | 点击「通过对话创建」。设置页关闭，输入框填入模板提示词。 | 当前对话 |
+| 暂停或恢复 | 使用任务卡片上的开关。 | 单条规则 |
+| 立即运行 | 打开卡片菜单，选择「立即执行」。 | 单条规则 |
+| 删除 | 打开卡片菜单，选择「删除任务」。运行历史会保留。 | 仅定义 |
+| 查看记录 | 打开「执行记录」，再按天、周、月、任务或状态筛选。 | 当前 Host |
+
+每次派发都使用保存的任务说明、工作区、模型和权限边界，不会复用来源对话中的批准。
+
+## 权限与安全边界
+
+| 项目 | 行为 |
+| --- | --- |
+| 权限 | 默认 `read-only`。改文件必须显式选择 `workspace-write`。 |
+| 完全访问 | 不提供无人值守 `danger-full-access`。 |
+| 审批 | 无人值守使用 fail-closed 的 `never`，不会等待一个不存在的人。 |
+| 重试 | 已经开始的运行不会自动重试。 |
+| Host 重启 | 遗留的 `queued` / `running` 会变成 `failed(host_interrupted)`。 |
+| 重叠 | 同一规则同时最多一个 active run。冲突 occurrence 记为 `skipped(overlap)`。 |
+
+计划只表达未来意图，不是缓存下来的授权。
+
+## 二次开发
+
+当前源码在 `src`，构建产物在 `lib`：
+
+- [src\index.ts](src/index.ts)：Host 插件、工具和 RPC。
+- [src\service.ts](src/service.ts)：持久化定义、时钟和运行准入。
+- [src\client\index.ts](src/client/index.ts)：设置页和对话预填。
+- `tests\*.test.ts`：领域、周期、服务、客户端和包契约测试。
+
+修改后运行测试、重新构建，并以本地目录安装验证：
+
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+pnpm check
+dsh plugin --profile web add .
+```
+
+修改执行逻辑时必须保留 at-most-once 派发、Agent 工具的工作区边界，以及无人值守 fail-closed 审批。
+
+## 验证
+
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+pnpm test
+pnpm build
+```
+
+`pnpm check` 会连续执行类型检查、测试和构建。
+
+## 项目文档与许可证
+
+项目状态、使用边界、技术架构和迭代记录从[文档交接入口](docs/00-交接入口/00-阅读导航.md)开始。补充说明见 NOTICE。
+
+本项目采用 [Apache License 2.0](LICENSE)。

package/cordis.patch.yml

@@ -0,0 +1,9 @@
+# 一次安装同时挂载 Host 服务并发布 Web 客户端。
+- insert:
+    - id: dsh-automation
+      name: '@michengai/dsh-automation'
+      config:
+        maxConcurrentRuns: 2
+        runTimeoutMinutes: 60
+        misfireGraceMinutes: 15
+        historyLimit: 200

package/docs/00-/344/272/244/346/216/245/345/205/245/345/217/243/00-/351/230/205/350/257/273/345/257/274/350/210/252.md

@@ -0,0 +1,11 @@
+# 阅读导航
+
+更新时间：2026-08-16 18:30（Asia/Shanghai）
+
+1. [项目概览](01-项目概览.md) — 先看插件定位和稳定边界。
+2. [当前状态](02-当前状态.md) — 再看当前阶段和有效风险。
+3. [待办与阻塞](03-待办与阻塞.md) — 只看尚未关闭的事项。
+4. [迭代路线图](04-迭代路线图.md) — 只看迭代顺序。
+5. [技术架构基线](05-技术架构基线.md) — 看当前生效的硬约束。
+6. [调度与执行模型](..\03-技术架构\01-调度与执行模型.md) — 看领域设计。
+7. [I001 迭代总览](..\01-当前工作\I001-任务自动化插件\00-迭代总览.md) — 看本次交付范围。

package/docs/00-/344/272/244/346/216/245/345/205/245/345/217/243/01-/351/241/271/347/233/256/346/246/202/350/247/210.md

@@ -0,0 +1,22 @@
+# 项目概览
+
+更新时间：2026-08-16 18:30（Asia/Shanghai）
+
+`@michengai/dsh-automation` 是 DeepSeek Harness Web Profile 的社区插件，用于创建独立、可审计的定时编码任务。
+
+## 当前阶段
+
+首个可安装版本：支持设置页、Agent 工具，以及单次/间隔/每天/每周计划。
+
+## 核心能力
+
+- 每次到期都创建全新 root Agent 和 Session，不继承来源对话。
+- 规则、修订号和运行历史持久化。
+- 同一条规则同时最多一个 active run；超时、重叠和 Host 中断都有明确终态。
+- 默认只读；可显式选择 `workspace-write`。禁止无人值守 `danger-full-access`。
+
+## 稳定边界
+
+- 不替代 DSH Core Schedule 的同会话提醒。
+- 不是操作系统守护进程，Host 必须正在运行。
+- 不提供 raw cron、DAG、外部通知或 worktree 生命周期。

package/docs/00-/344/272/244/346/216/245/345/205/245/345/217/243/02-/345/275/223/345/211/215/347/212/266/346/200/201.md

@@ -0,0 +1,9 @@
+# 当前状态
+
+更新时间：2026-08-16 22:40（Asia/Shanghai）
+
+- 阶段：I001 任务自动化插件首版实现，已补原生侧栏「定时」页签。
+- 活动迭代：[I001-任务自动化插件](..\01-当前工作\I001-任务自动化插件\00-迭代总览.md)
+- 有效风险：
+  - Host 未运行时不会补跑历史 backlog。
+  - 无人值守工具 allowlist 无法覆盖全部第三方 DSH tool。

package/docs/00-/344/272/244/346/216/245/345/205/245/345/217/243/03-/345/276/205/345/212/236/344/270/216/351/230/273/345/241/236.md

@@ -0,0 +1,7 @@
+# 待办与阻塞
+
+更新时间：2026-08-16 18:30（Asia/Shanghai）
+
+| 事项 | 负责人 | 优先级 | 下一步 | 解除条件 |
+| --- | --- | --- | --- | --- |
+| 真实 DSH Web 组合验收 | 维护者 | 高 | 用 `dsh plugin --profile web add` 安装后做一次立即运行 | 能从 Web 创建、到期触发并打开结果 Session |

package/docs/00-/344/272/244/346/216/245/345/205/245/345/217/243/04-/350/277/255/344/273/243/350/267/257/347/272/277/345/233/276.md

@@ -0,0 +1,5 @@
+# 迭代路线图
+
+更新时间：2026-08-16 18:30（Asia/Shanghai）
+
+- I001 任务自动化插件：进行中。交付独立 Session 调度、设置页与 Web/Agent 双入口。

package/docs/00-/344/272/244/346/216/245/345/205/245/345/217/243/05-/346/212/200/346/234/257/346/236/266/346/236/204/345/237/272/347/272/277.md

@@ -0,0 +1,10 @@
+# 技术架构基线
+
+更新时间：2026-08-16 18:30（Asia/Shanghai）
+
+- 包名：`@michengai/dsh-automation`
+- 运行时：Node.js 22.19+ / 24+，Cordis Host + DSH Web client
+- 持久化：`ctx.storageDomain`，domain 名 `dsh_automation`
+- 调度语义：at-most-once dispatch；无自动重试
+- 权限：`read-only` / `workspace-write`；审批策略 `never`
+- 构建：`scripts\build.mjs` 产出 Host ESM 与 `__ModuleLoader__` Web bundle

package/docs/00-/344/272/244/346/216/245/345/205/245/345/217/243/06-/346/226/207/346/241/243/347/274/226/345/206/231/350/247/204/350/214/203.md

@@ -0,0 +1,8 @@
+# 文档编写规范
+
+更新时间：2026-08-16 18:30（Asia/Shanghai）
+
+1. 文档使用简体中文和 UTF-8。
+2. 同一信息只保留一个权威位置。
+3. 当前工作只放未完成迭代；完成后移入 `docs\07-迭代归档`。
+4. 不创建空模板文档。

package/docs/01-/345/275/223/345/211/215/345/267/245/344/275/234/I001-/344/273/273/345/212/241/350/207/252/345/212/250/345/214/226/346/217/222/344/273/266/00-/350/277/255/344/273/243/346/200/273/350/247/210.md

@@ -0,0 +1,47 @@
+# I001 任务自动化插件
+
+- 状态：进行中
+- 负责人：维护者
+- 优先级：高
+- 更新时间：2026-08-16 22:40（Asia/Shanghai）
+
+## 目标与业务边界
+
+实现 DeepSeek Harness 的独立任务自动化：用户或 Agent 保存一条自包含任务，Host 到期后在全新 Session 中执行，并留下可审计历史。设置页提供任务列表、执行记录和新建模态。
+
+## 任务清单
+
+- [x] 领域模型、周期计算
+- [x] Service / Executor / Tools / RPC
+- [x] Web Automations 页
+- [x] 原生侧栏定时页签：包裹官方任务树，不依赖 dsh-codex-ui
+- [x] 单测与包契约
+- [ ] 真实 Web Profile 组合验收
+
+## 阻塞事项
+
+无。
+
+## 验收标准
+
+1. Web 和 Agent 都能创建、列出、暂停、恢复、立即运行和删除。
+2. 到期后创建新 Session，消息 source 为 `automation`。
+4. 重启不会偷偷重跑遗留 running。
+5. 删除定义不删除运行历史。
+
+## 已完成内容
+
+仓库内已落地 Host 插件、Web 客户端、原生侧栏定时页签、文档和单测。
+
+## 待处理事项
+
+真实 DSH Host 上的一次立即运行验收。
+
+## 关联提交
+
+尚未发布提交。
+
+## 阅读顺序
+
+1. [项目概览](..\..\00-交接入口\01-项目概览.md)
+2. [调度与执行模型](..\..\03-技术架构\01-调度与执行模型.md)

package/docs/03-/346/212/200/346/234/257/346/236/266/346/236/204/00-/351/242/206/345/237/237/347/264/242/345/274/225.md

@@ -0,0 +1,5 @@
+# 技术架构索引
+
+更新时间：2026-08-16 18:30（Asia/Shanghai）
+
+1. [调度与执行模型](01-调度与执行模型.md)

package/docs/03-/346/212/200/346/234/257/346/236/266/346/236/204/01-/350/260/203/345/272/246/344/270/216/346/211/247/350/241/214/346/250/241/345/236/213.md

@@ -0,0 +1,30 @@
+# 调度与执行模型
+
+更新时间：2026-08-16 22:40（Asia/Shanghai）
+
+## 分层
+
+- Store：只保存 definition 与 run。
+- Clock：只回答下次到期时间。
+- Executor：只执行已经认领的 run。
+- Tools / RPC：只调用 service。
+- Web client：只展示快照并提交明确 mutation。
+
+## 调度
+
+- `once` / `interval` / `daily` / `weekly` 会编译为校验过的 RRULE。
+- `interval` 最短 5 分钟，创建后不会立刻跑第一次。
+- 每天/每周使用 IANA 本地 `HH:mm`；夏令时中不存在的本地时间会被跳过。
+- 立即运行不受计划时间限制。
+
+## 恢复
+
+- 先持久化 `queued`，再创建 Agent。
+- Host 重启后，遗留 `queued`/`running` 变为 `failed(host_interrupted)`。
+- 补跑窗口默认 15 分钟，只物化最新一条 overdue occurrence。
+
+## 侧栏
+
+- 有 `dsh-codex-ui` 时只填充 `sidebar.schedule`。
+- 没有 Codex UI 时不换掉官方任务树，只在外面套「任务 / 定时」页签；官方搜索、工作区和会话菜单都保留。若存在 `sidebar.channels` 再显示「频道」。
+- 定时树按任务名称分组，子会话标题为 `YYYY-MM-DD HH:mm - 任务名`。