create-windy 0.9.1 → 0.10.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-windy",
-  "version": "0.9.1",
+  "version": "0.10.1",
   "description": "创建单组织、单租户、私有部署优先的 Windy 企业 Dashboard Starter",
   "type": "module",
   "bin": {
@@ -36,6 +36,6 @@
   },
   "private": false,
   "dependencies": {
-    "@inquirer/checkbox": "^5.2.1"
+    "@inquirer/checkbox": "^5.2.8"
   }
 }

package/template/.agents/skills/windy-business-module/SKILL.md

@@ -24,7 +24,9 @@ description: "在 Windy 或 create-windy 生成项目中新增或修改业务 Mo
    Route、Audit Action，以及需要的 Migration/Schema Export、Task、Provider、JSON
    Schema、Tool、AI Operation、Secret 和 Data Policy。Feature 使用能力基础 Key，
    Permission 在同一 Key 后追加动作；非匿名入口和 Handler 只能引用已声明且同基础 Key
-   的治理能力。**完成标准：Manifest 声明和 Host 实现双向枚举无缺失、未知或重复 Key。**
+   的治理能力。预览、校验等只读 API 即使使用 POST，也要声明已注册的 Audit Action。
+   按行为选择动作，读取当前配置并计算差异的预览可复用 `data.read`，实际写入使用对应更新动作。
+   **完成标准：Manifest 声明和 Host 实现双向枚举无缺失、未知或重复 Key。**
 4. 数据层使用 Drizzle Schema、前向 Migration 和 Repository；Service 持有业务规则，
    其它模块只能通过 Service、公开 Port 或注册机制协作。Manifest 与 Migration Bundle
    版本、顺序、依赖和 Schema Export 必须一致；已发布 Migration ID/checksum 不改写。
@@ -92,6 +94,36 @@ description: "在 Windy 或 create-windy 生成项目中新增或修改业务 Mo
     一次 `release:verify`。仅当项目提供 `lint` 脚本时运行 lint；一个 cohesive slice 一个
     Conventional Commit。**完成标准：验证层级、未执行项和提交 SHA 均可审计。**
 
+### 启动与人工验收交接
+
+用户要求启动服务做人工验收时，先确认端口归属和数据库目标。迁移独立验收库后，核对
+API、Web 代理及相关独立服务的就绪端点。模块装配失败时，从报错的 Manifest 绑定查起，
+修复后重新走正常启动入口。交接时用发布标签和实际候选 SHA 界定差异，逐模块列出入口、
+操作、预期结果和依赖环境，分别记录服务就绪与实际业务验收结果。
+
+## 环境适配与可选能力
+
+业务能力需要 GPU、模型、外部服务或可选软件时，先读
+[环境能力评估与构建预设](../../../docs/operations/environment-capabilities.md)，
+将环境评估与能力声明一起设计：
+
+- 分别记录硬件/操作系统证据、软件/Adapter 的真实支持、readiness 和功能质量验收。
+  没有 GPU 不能直接推出 OCR 不可用；探测不到设备或服务也不能写成已确认不支持。
+- 构建模块选择决定实际交付内容；运行时 Feature 开关控制已有能力的可用性。
+  环境 YAML 的 `features` 仅生成评估建议，不能把它当作已执行的启停配置。
+  `build.modules` 必须接到生成器/打包器已经支持的裁剪入口，并检查源码、依赖、路由、
+  服务与数据库对象。仅隐藏入口或写入 YAML，不算物理裁剪。
+- 评估报告给出可用、缺依赖或未验证的证据与原因；停用/恢复按用户已授权策略执行，
+  没有策略时先呈现具体受影响功能，再由用户确认。不要因探测失败自动改写功能开关。
+- CPU OCR 项目选用 `system.media-runtime`，通过 `build.runtimes` 决定独立应用交付范围，
+  通过 `runtime` 决定 Server 启动装配。业务 UI 和服务入口使用对应的
+  `system.agent`、`system.document`、`system.speech` 或 `system.embedding` Feature。
+- 病毒扫描独立使用 `antivirus` 配置。需要扫描的项目负责交付执行器和病毒库，并通过项目
+  Composition 将就绪检查与实际入库流程接通。验证时分别检查启动状态和文件处理结果。
+
+**完成标准：构建内容、运行时预设、环境证据和人工决定可以分别核对；已验证与待验收
+项明确，普通业务能力不被共享 AI 开关误伤。**
+
 ## Client Agent Workflow 重复故障解法
 
 - 跨层 opaque ID 必须选一个 canonical prefix，并同步 Server 生成器、public SDK、客户端

package/template/.windy-template.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "templateCommit": "65f35a9b300c836eafca56da477238edb0ee1cde",
-  "generatorVersion": "0.9.1",
+  "templateCommit": "266b77d1fad69f8cfa00f96fc09c7b494c1dc71d",
+  "generatorVersion": "0.10.1",
   "modules": [
     {
       "name": "system",
@@ -31,6 +31,10 @@
       "name": "system.storage",
       "version": "0.1.0"
     },
+    {
+      "name": "system.media-runtime",
+      "version": "0.1.0"
+    },
     {
       "name": "system.agent",
       "version": "0.1.2"

package/template/AGENTS.md

@@ -78,6 +78,8 @@
   或 MCP 暴露时使用的仓库内开发流程。
 - `docs/development/custom-login-page.md`：完整替换登录页的 ownership、认证复用和
   升级迁移说明。
+- 修改公共入口、懒加载、模块裁剪、缓存或慢查询时，读取
+  `docs/development/performance-engineering.md`。
 - `docs/development/custom-error-pages.md`：统一错误语义、Request ID 与业务页面
   替换方式。
 - `bun run dev`：复用 Docker 镜像启动 PostgreSQL、自动 migration、Server 与支持热更新的 Web。
@@ -86,5 +88,7 @@
 - `bun run dev:server`：启动 Server 开发服务。
 - `/admin/system/ai-runtime`：查看受治理的 Run、Provider Attempt 与脱敏 Trajectory。
 - `bun run lint`、`bun run typecheck`、`bun run test`、`bun run build`：执行基础验证；未选择 Oxc 时没有 lint 脚本。
+- `windy.environment.yaml`：构建模块记录与环境评估建议；接入与边界见
+  `docs/operations/environment-capabilities.md`。
 - `docs/README.md`：平台架构、模块接入和运维文档入口。
 - `.windy/generation.json`：本次生成器版本、所选模块和选项记录。

package/template/README.md

@@ -74,6 +74,7 @@ Skill 仍可用于普通业务模块开发。
 
 
 
+
 ## 页面与登录
 
 全新数据库的初始平台账号为 `admin`。初始密码不是所有项目共用的固定值，而是
@@ -119,6 +120,7 @@ create-windy 在本机 `.env` 中随机生成的 `WINDY_BOOTSTRAP_ADMIN_PASSWORD
 | `system.audit` | 未包含 | H2 | 审计查询、可靠写入和恢复。 |
 | `system.operations` | 未包含 | H2 | 服务、数据库、缓存、磁盘和会话监控。 |
 | `system.storage` | 未包含 | H2 | 上传、下载和对象生命周期。 |
+| `system.media-runtime` | 未包含 | H2 | 受治理的文档、语音、嵌入与公共文件引用。 |
 | `system.agent` | 未包含 | H2 | 受控 Agent 工具宿主。 |
 | `system.scheduler` | 未包含 | H2 | 任务、重试、历史和恢复。 |
 | `system.notification` | 未包含 | H2 | 通知定向与定时发布、用户偏好、外部渠道投递、修改历史、阅读、收藏和归档。 |

package/template/apps/agent-server/Dockerfile

@@ -1,7 +1,7 @@
 # syntax=docker/dockerfile:1
 # One application-owned Agent Server image; DSH is an npm workspace dependency.
 FROM oven/bun:1.3.14-slim@sha256:d56a2534ffd262e92c12fd3249d3924d296d97086da773f821d7d0477435ea04 AS bun
-FROM node:24.7.0-bookworm-slim@sha256:0104d9447ea3ddf7373643be7f9915fc7b7c896e41d0d33229338e457217cd78 AS node
+FROM node:24.9.0-bookworm-slim@sha256:3e69116c924bfcba6c6979aff60d966c37aef56d488ce091c69d442ebec9f103 AS node
 FROM bun AS dependencies
 WORKDIR /app
 COPY package.json bun.lock ./

package/template/apps/agent-server/README.md

@@ -1,6 +1,6 @@
 # Agent Server：内置 DSH
 
-官方 npm DSH 固定 `0.2.1-rc.2`、Cordis `4.0.5`，随 Bun workspace 安装，Node 24.7+ 执行。Python 仅用于镜像内固定文档工具。
+官方 npm DSH（`~0.2.2-rc.1`）和 Cordis（`^4.1.0`）随 Bun workspace 按锁文件安装，Node 24.9+ 执行。Python 仅用于镜像内固定文档工具。
 
 ```sh
 bun install --frozen-lockfile

package/template/apps/agent-server/native/EXTENSIONS.md

@@ -1,6 +1,6 @@
 # 当前用户的 DSH 扩展
 
-固定上游为 DSH `0.2.1-rc.2`。本轮只开放原生能力，不新增服务、公开端口或第二个管理站点。
+上游 DSH 使用 `~0.2.2-rc.1`，镜像按 Bun 锁文件安装。
 
 ## 插件入口与持久化
 
@@ -8,7 +8,7 @@
 - 插件自己的配置页在「插件」内；「设置」→「内置插件」提供全局运行清单。应用托管的共享模型地址、身份等配置仍由最后一层 deployment patch 固定，更改这些字段会被上游拒绝，不应绕开覆盖。
 - 上游 `plugin-manager`、`config-editor`、`settings`、`hmr` 和 `client-hmr` 原样组合。安装和启停由 HMR 实时应用，真正需要重启的情况由上游显示原因。
 - 插件安装写入每个用户 `DSH_HOME/profiles/web` 的 `package.json`、`pnpm-lock.yaml`、`node_modules`、`cordis.patch.yml` 等文件。worker 使用官方 `initProfile()` 仅补缺失文件，重启不清空个人清单、锁或两层个人 patch。
-- 安装器是镜像内固定的官方 npm 包 `pnpm@11.28.6`（MIT），由 Node 调用，不使用 curl 安装器。上游依赖 pnpm 的 `view/add/remove`、脚本批准和文件恢复语义；项目 monorepo 仍以 Bun 管理。Docker 补齐 Git 与 CA，便于上游 Git spec 安装。
+- 安装器是镜像内按 Bun 锁文件安装的官方 npm 包 `pnpm`（声明范围 `^11.28.11`）（MIT），由 Node 调用，不使用 curl 安装器。上游依赖 pnpm 的 `view/add/remove`、脚本批准和文件恢复语义；项目 monorepo 仍以 Bun 管理。Docker 补齐 Git 与 CA，便于上游 Git spec 安装。
 - `tool-plugin-manager` 保持禁用；技能文本不能静默安装插件代码。安装代码由用户在原生管理界面执行。
 
 开发阶段 `AGENT_DSH_USER_EXTENSIONS=1` 默认开启。设置为 `0` 并重启现有 Agent Server 会关闭扩展安装、配置及清单管理入口，同时关闭个人 Skills 默认根发现。此开关不会删除已安装文件，也不会停止已经保存为启用的可信插件；要撤销已有插件代码，应先在原生 UI 卸载或停用，再重启当前用户 worker / Agent Server。它不是恶意代码安全开关。

package/template/apps/agent-server/native/parallel-harness.ts

@@ -19,6 +19,7 @@ import LlmRuntime, {
   type StreamChunk,
 } from "@deepseek-ai/dsh-llm";
 import ToolRuntime from "@deepseek-ai/dsh-tools";
+import * as NativeToolExecutor from "@deepseek-ai/dsh-tool-executor-native";
 import SystemPrompt from "@deepseek-ai/dsh-system-prompt";
 import LocalFileSystem from "@deepseek-ai/dsh-fs-local";
 import WorkingDirectory from "@deepseek-ai/dsh-working-directory";
@@ -172,6 +173,7 @@ export async function harness(
     }),
   );
   fibers.push(await ctx.plugin(ToolRuntime));
+  fibers.push(await ctx.plugin(NativeToolExecutor));
   fibers.push(
     await ctx.plugin(AgentLoop, { maxParallelToolCalls: 2, agents: [] }),
   );

package/template/apps/agent-server/native/storage-lifecycle.test.ts

@@ -165,7 +165,8 @@ test("real file churn no longer stops a worker during quota inspection", async (
       await manager.close();
     }
   });
-});
+  // 100 次真实目录扫描与并发文件变动属于 I/O 集成验证，保留全部轮次与断言。
+}, 30_000);
 
 test("missing root still stops a worker through the real inspection path", async () => {
   await temporary(async (home) => {

package/template/apps/agent-server/package.json

@@ -4,7 +4,7 @@
   "private": true,
   "type": "module",
   "engines": {
-    "node": ">=24.7.0"
+    "node": ">=24.9.0"
   },
   "scripts": {
     "build": "bun build main.ts native/worker.ts --target=node --outdir dist --external '@deepseek-ai/*' --external ajv --external sharp",
@@ -16,48 +16,49 @@
     "test:coordinator": "bun scripts/test-coordinator.ts"
   },
   "dependencies": {
-    "@deepseek-ai/dsh": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-agent": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-agent-loop": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-session": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-llm": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-compaction-basic": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-agent-preset-registry": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-tools": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-session-projection": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-web-app": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-base": "0.2.1-rc.2",
-    "@deepseek-ai/cordis": "4.0.5",
-    "ajv": "8.20.0",
+    "@deepseek-ai/dsh": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-agent": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-agent-loop": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-session": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-llm": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-compaction-basic": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-agent-preset-registry": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-tools": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-session-projection": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-web-app": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-base": "~0.2.2-rc.1",
+    "@deepseek-ai/cordis": "^4.1.0",
+    "ajv": "^8.20.0",
     "@southwind-ai/ai-client": "workspace:*",
-    "@deepseek-ai/dsh-llm-pi-ai": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-launch-environment": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-mcp-client": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-client-connection": "0.2.1-rc.2",
-    "ws": "8.22.0",
-    "@deepseek-ai/dsh-scope": "0.2.1-rc.2",
-    "zod": "4.3.6",
-    "sharp": "0.35.5",
-    "@deepseek-ai/dsh-attachment": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-subprocess-local": "0.2.1-rc.2",
-    "@deepseek-ai/node-addon-system": "0.1.2",
-    "@deepseek-ai/dsh-app-boot": "0.2.1-rc.2",
-    "pnpm": "11.28.6",
-    "fflate": "0.8.3",
-    "yaml": "2.9.0",
-    "@deepseek-ai/dsh-subagent": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-subagent-spawn-in-process": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-tool-subagent": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-tool-subagent-control": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-working-directory": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-api-settings-controller": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-typert-protocol": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-skill": "0.2.1-rc.2"
+    "@deepseek-ai/dsh-llm-pi-ai": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-launch-environment": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-mcp-client": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-client-connection": "~0.2.2-rc.1",
+    "ws": "^8.22.1",
+    "@deepseek-ai/dsh-scope": "~0.2.2-rc.1",
+    "zod": "^4.6.7",
+    "sharp": "^0.35.5",
+    "@deepseek-ai/dsh-attachment": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-subprocess-local": "~0.2.2-rc.1",
+    "@deepseek-ai/node-addon-system": "^0.1.2",
+    "@deepseek-ai/dsh-app-boot": "~0.2.2-rc.1",
+    "pnpm": "^11.28.11",
+    "fflate": "^0.8.3",
+    "yaml": "^2.9.1",
+    "@deepseek-ai/dsh-subagent": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-subagent-spawn-in-process": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-tool-subagent": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-tool-subagent-control": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-working-directory": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-api-settings-controller": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-skill": "~0.2.2-rc.1"
   },
   "devDependencies": {
-    "@types/ws": "8.18.1",
-    "@deepseek-ai/dsh-fs-local": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-rc.2"
+    "@types/ws": "^8.18.2",
+    "@deepseek-ai/dsh-fs-local": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "~0.2.2-rc.1",
+    "@deepseek-ai/dsh-tool-executor-native": "~0.2.2-rc.1"
   }
 }

package/template/apps/agent-server/plugins/downloads/README.md

@@ -1,6 +1,6 @@
 # Native workbench downloads
 
-Thin project plugin for DSH `0.2.1-rc.2` (upstream MIT). It contributes to the
+Thin project plugin for DSH (upstream MIT). It contributes to the
 published `deliverables.file.actions` and `deliverables.review.file.actions`
 slots, preserving native preview/open controls. Download availability does not
 depend on a desktop opener being installed on the server.

package/template/apps/agent-server/plugins/drop-overlay/README.md

@@ -5,7 +5,7 @@
 18px 半粗标题和 14px 说明。颜色读取 DSH 语义 Token，跟随当前浅色/深色主题。
 上传图标采用项目既有 Lucide cloud-upload 的 ISC 图形路径；减少动态效果时禁用跳动。
 
-当前固定官方 MIT 包 `@deepseek-ai/dsh-client-ui-attachment@0.2.1-rc.2` 只公开整个
+实现最初依据的官方 MIT 包 `@deepseek-ai/dsh-client-ui-attachment@0.2.1-rc.2` 只公开整个
 `conversation.input.attachments` 插槽，没有导出的独立 DropOverlay 或装饰插槽。
 原生 React 页面不能直接挂载产品 Vue 组件；本插件只通过公开 `webserver/index-inject`
 追加范围限定的 CSS，不复制附件组件、不替换上传回调，也不新增任何 drag/drop 监听。

package/template/apps/agent-server/plugins/settings/README.md

@@ -1,6 +1,6 @@
 # Windy工作台设置策略
 
-适用于固定 DSH `0.2.1-rc.2`。使用官方 Host profile 禁用账号/API 登录 UI、官方 Session Log 上传实现和对应设置 UI，以及服务端打开本机应用能力。Windy统一认证和模型代理保持产品管理；独立的 SettingsController Adapter 在 RPC 层拒绝打开服务器配置文件。
+使用官方 Host profile 禁用账号/API 登录 UI、官方 Session Log 上传实现和对应设置 UI，以及服务端打开本机应用能力。Windy统一认证和模型代理保持产品管理；独立的 SettingsController Adapter 在 RPC 层拒绝打开服务器配置文件。
 
 Client 使用公开 slot 的 priority shadowing 隐藏 `settings.action/open-document` 与 `settings.general.item/current-version`。换行图标按钮位于配置预览框右上方，不占设置页标题栏；保留 `aria-pressed`、Tooltip 与 `Alt+Z`。默认换行，关闭后横向滚动。alpha.3 未提供预览工具栏插槽，因此适配器仅观察语义 `[role="dialog"] pre`，在代码块前插入自有工具栏，不移动或复制上游 React 节点，不匹配中文文案或打包类名。关闭对话框或卸载时清理按钮、快捷键与样式；升级 DSH 后需要核对这个窄 DOM 边界。
 

package/template/apps/agent-server/plugins/skill-library/client-chunks.test.ts

@@ -26,7 +26,10 @@ test("the official client module system loads this plugin's editor and use chunk
         __ModuleLoader__: {
           load(registration: ClientBundleRegistration) {
             Runtime = registration.factory(
-              Object.assign(() => ({}), { async: async () => ({}) }),
+              Object.assign(() => ({}), {
+                async: async () => ({}),
+                asset: (reference: string) => reference,
+              }),
             ) as typeof Runtime;
           },
         },

package/template/apps/agent-server/plugins/theme/README.md

@@ -1,6 +1,6 @@
 # Windy DSH 主题插件
 
-固定上游 DSH `0.2.1-rc.2`，使用公开 `dsh.client` 插件声明、`ctx.theme.overrideTokens`
+使用公开 `dsh.client` 插件声明、`ctx.theme.overrideTokens`
 和 Cordis effect 生命周期。`tokens.json` 由 `bun apps/agent-server/plugins/theme/sync-tokens.ts` 从现有 `apps/web/src/style.css` 的 `:root/.dark` 语义色生成，映射至
 DSH 的公开 `--dsw-*` token；不修改上游源码，不以高优先级全局 CSS 抢占其主题呈现器。
 
@@ -16,3 +16,7 @@ Host 仅经 `webserver/index-inject` 传递部署拥有的 token JSON。客户
 聚焦测试直接加载当前 npm 包的原生 ThemeRuntime，覆盖偏好切换、系统变更与卸载恢复。
 
 主题源变更后重新生成投影；Agent镜像仅携带生成JSON，不在运行时读取Web源码。原生加载状态也复用该投影，不另设配色或偏好。
+
+当前 DSH 侧栏悬停复用 `--dsw-alias-interactive-bg-hover`，对应 Windy 的 `--accent`；
+不再投影上游已移除的 `--dsw-specific-sidebar-nav-item-hover`。升级时继续由契约测试
+逐项检查投影 token 在当前上游主题中存在，避免注册已失效的覆盖项。

package/template/apps/agent-server/plugins/theme/source-tokens.ts

@@ -28,7 +28,6 @@ export const themeTokenSources: Readonly<Record<string, string>> = {
   "--dsw-specific-sidebar-fill": "--sidebar",
   "--dsw-specific-sidebar-nav-item-active": "--sidebar-accent",
   "--dsw-specific-sidebar-nav-item-active-accent": "--sidebar-accent",
-  "--dsw-specific-sidebar-nav-item-hover": "--sidebar-accent",
   "--dsw-specific-menu": "--popover",
   "--dsw-specific-input-major": "--card",
   "--dsw-specific-selector": "--muted",

package/template/apps/agent-server/plugins/theme/tokens.json

@@ -111,10 +111,6 @@
     "light": "oklch(0.97 0 0)",
     "dark": "oklch(0.269 0 0)"
   },
-  "--dsw-specific-sidebar-nav-item-hover": {
-    "light": "oklch(0.97 0 0)",
-    "dark": "oklch(0.269 0 0)"
-  },
   "--dsw-specific-menu": {
     "light": "oklch(1 0 0)",
     "dark": "oklch(0.205 0 0)"

package/template/apps/agent-server/plugins/tool-catalog/README.md

@@ -3,10 +3,13 @@
 工具事实来源是官方 MCP bridge 通过现有身份获得并注册的 `mcp__windy__*` 工具。
 不另建业务工具 allowlist，不复制输入输出 Schema，也不扩大业务 MCP 暴露面。
 
-alpha.3 的 MCP bridge 默认注册全部完整 Schema。当前 `openai-completions` 适配器
+DSH 的 MCP bridge 默认注册全部完整 Schema。当前 `openai-completions` 适配器
 没有可直接使用的通用延迟搜索协议；单独添加 `deferLoading` 会让工具被过滤且无法发现。
-本插件采用公开 `system-prompt/assemble` 裁剪本轮模型工具声明，配合 `tools.guard`
-拒绝未加载的调用；仅发现入口注册到同 Agent 的 `createScope`，原 MCP 定义保持不变。
+本插件在同 Agent 的 `createScope` 注册官方 `NativeToolExecutor`，仅在公开 `describe`
+边界裁剪本轮模型工具声明，执行仍委托官方 executor；配合 `tools.guard` 拒绝未加载的调用。
+发现入口也注册到该 Scope，原 MCP 定义、step admission 与授权限制保持不变。
+新版 `system-prompt/assemble` 只处理提示文本，不再承担工具声明裁剪；Windy native profile
+禁用 PTC，本插件不为其它 executor 提供兼容回退。
 每个 Agent 初始业务工具仅看到
 `discover_business_tools`，其目录预览最多 12 项、1600 字符。模型先搜索/翻页查询每页
 20 项的简洁目录，再从实际工具名称选择最多 8 项，在该 Agent 后续模型请求中声明所选工具的原始完整 Schema。

package/template/apps/agent-server/plugins/tool-catalog/discovery.mjs

@@ -1,5 +1,6 @@
 import { displayMetadata } from "./presentation.mjs";
 import { createScope } from "@deepseek-ai/dsh-scope";
+import { NativeToolExecutor } from "@deepseek-ai/dsh-tool-executor-native";
 export const DISCOVER = "discover_business_tools";
 const PREFIX = "mcp__windy__";
 export function businessTools(ctx, scope) {
@@ -192,6 +193,18 @@ export function installDiscovery(ctx, metadata = new Map()) {
       selected: new Set(),
       refresh: () => synchronize(state),
     };
+    const executor = new NativeToolExecutor(state.scope.ctx);
+    state.scope.ctx.tools.setExecutor({
+      describe(tools) {
+        return executor.describe(
+          tools.filter(
+            (tool) =>
+              !tool.name.startsWith(PREFIX) || state.selected.has(tool.name),
+          ),
+        );
+      },
+      execute: (input) => executor.execute(input),
+    });
     states.set(agent, state);
     state.refresh();
   }
@@ -221,16 +234,6 @@ export function installDiscovery(ctx, metadata = new Map()) {
     )
       return "TOOL_NOT_LOADED_DISCOVER_FIRST";
   });
-  ctx.on("system-prompt/assemble", async (_assembly, context, next) => {
-    const assembled = await next();
-    const selected = states.get(context.scope)?.selected;
-    return {
-      ...assembled,
-      tools: assembled.tools.filter(
-        (tool) => !tool.name.startsWith(PREFIX) || selected?.has(tool.name),
-      ),
-    };
-  });
   for (const agent of ctx.agents.list()) attach(agent);
   ctx.effect(() => async () => {
     updating = true;

package/template/apps/agent-server/plugins/tool-catalog/discovery.test.ts

@@ -2,6 +2,7 @@ import { afterEach, expect, test } from "bun:test";
 import { Context } from "@deepseek-ai/cordis";
 import SystemPrompt from "@deepseek-ai/dsh-system-prompt";
 import ToolRuntime from "@deepseek-ai/dsh-tools";
+import * as NativeToolExecutor from "@deepseek-ai/dsh-tool-executor-native";
 import { createScope } from "@deepseek-ai/dsh-scope";
 import { createMcpToolDefinition } from "@deepseek-ai/dsh-mcp-client";
 import { ToolCallId } from "@deepseek-ai/dsh-llm";
@@ -33,7 +34,10 @@ async function fixture(count = 76) {
   await prompt.await();
   const runtime = ctx.plugin(ToolRuntime);
   await runtime.await();
+  const executor = ctx.plugin(NativeToolExecutor);
+  await executor.await();
   cleanups.push(async () => {
+    await executor.dispose();
     await runtime.dispose();
     await prompt.dispose();
   });
@@ -82,14 +86,32 @@ async function fixture(count = 76) {
   });
   await discovery.await();
   cleanups.push(() => discovery.dispose());
-  const execute = (name: string, args: unknown, subject = agent) =>
-    ctx.tools.execute({
-      name,
-      arguments: args,
+  const execute = async (name: string, args: unknown, subject = agent) => {
+    const signal = new AbortController().signal;
+    const toolSet = await ctx.tools.resolve({
       agent: subject,
-      callId: ToolCallId(crypto.randomUUID()),
-      signal: new AbortController().signal,
+      modelSelection: { provider: "fixture", model: "fixture" },
+      signal,
     });
+    try {
+      const { results } = await ctx.tools.execute({
+        calls: [
+          {
+            type: "tool-call",
+            name,
+            arguments: JSON.stringify(args),
+            id: ToolCallId(crypto.randomUUID()),
+          },
+        ],
+        agent: subject,
+        signal,
+        toolSet,
+      });
+      return results[0]!.result;
+    } finally {
+      toolSet.dispose();
+    }
+  };
   return {
     ctx,
     agent,
@@ -227,3 +249,43 @@ test("loading cannot bypass an existing Agent tool restriction", async () => {
   expect(f.calls).toEqual([allowed]);
   await policy.dispose();
 });
+
+test("discovery selection cannot bypass upstream step admission", async () => {
+  const f = await fixture(0);
+  const name = "mcp__windy__conditional";
+  let calls = 0;
+  const unregister = f.ctx.tools.register(
+    {
+      name,
+      description: "Conditional business tool",
+      parameters: { type: "object" },
+      output: { schema: { type: "object" }, render: () => [] },
+      execute: async () => {
+        calls++;
+        return {};
+      },
+    },
+    { when: () => false },
+  );
+  try {
+    expect((await f.execute(DISCOVER, { names: [name] })).isError).toBe(false);
+    const toolSet = await f.ctx.tools.resolve({
+      agent: f.agent,
+      modelSelection: { provider: "fixture", model: "fixture" },
+      signal: new AbortController().signal,
+    });
+    try {
+      const assembly = await f.ctx.systemPrompt.assemble({
+        scope: f.agent,
+        toolSet,
+      });
+      expect(assembly.tools.map((tool) => tool.name)).toEqual([DISCOVER]);
+    } finally {
+      toolSet.dispose();
+    }
+    expect((await f.execute(name, {})).isError).toBe(true);
+    expect(calls).toBe(0);
+  } finally {
+    unregister();
+  }
+});

package/template/apps/agent-server/runtime/compatibility.ts

@@ -1,5 +1,11 @@
+import { createRequire } from "node:module";
 import { digest } from "./contracts.js";
-export const ENGINE_ID = "windy.dsh.0.2.1-rc.2";
+
+const require = createRequire(import.meta.url);
+const { version } = require("@deepseek-ai/dsh/package.json") as {
+  version: string;
+};
+export const ENGINE_ID = `windy.dsh.${version}`;
 export function compatibilityOffer() {
   const protocolVersions = [1];
   const protocolFeatures = [

package/template/apps/agent-server/runtime/dsh-engine.ts

@@ -6,6 +6,7 @@ import SessionStore, { SessionId } from "@deepseek-ai/dsh-session";
 import SessionProjections from "@deepseek-ai/dsh-session-projection";
 import LlmRuntime, { MessageId } from "@deepseek-ai/dsh-llm";
 import ToolRuntime from "@deepseek-ai/dsh-tools";
+import * as NativeToolExecutor from "@deepseek-ai/dsh-tool-executor-native";
 import SystemPrompt from "@deepseek-ai/dsh-system-prompt";
 import { SafeError, digest, type RunRequest } from "./contracts.js";
 import { GovernedModelAdapter, type ExecutionBudget } from "./model-plugin.js";
@@ -98,6 +99,7 @@ export async function executeDshRun(
       }),
     );
     fibers.push(await ctx.plugin(ToolRuntime));
+    fibers.push(await ctx.plugin(NativeToolExecutor));
     fibers.push(
       await ctx.plugin(AgentLoop, { maxParallelToolCalls: 1, agents: [] }),
     );

package/template/apps/agent-server/runtime/questions-workflow.nodecheck.ts

@@ -16,6 +16,7 @@ import LlmRuntime, {
   type StreamChunk,
 } from "@deepseek-ai/dsh-llm";
 import ToolRuntime from "@deepseek-ai/dsh-tools";
+import * as NativeToolExecutor from "@deepseek-ai/dsh-tool-executor-native";
 import SystemPrompt from "@deepseek-ai/dsh-system-prompt";
 import UserQuestions from "@deepseek-ai/dsh-user-questions";
 import * as AskUser from "@deepseek-ai/dsh-tool-ask-user";
@@ -87,6 +88,7 @@ async function scenario(tool: string, args: object, skillRoot?: string) {
     SessionProjections,
     AgentRegistry,
     ToolRuntime,
+    NativeToolExecutor,
     UserQuestions,
   ])
     fibers.push(await ctx.plugin(plugin));

package/template/apps/server/Dockerfile

@@ -27,7 +27,8 @@ COPY packages/server-sdk/package.json packages/server-sdk/package.json
 COPY packages/shared/package.json packages/shared/package.json
 COPY packages/storage/package.json packages/storage/package.json
 # windy-copy:deps end
-RUN --mount=type=cache,id=windy-bun-1.3.14,target=/root/.bun/install/cache,sharing=shared bun -e 'const child=Bun.spawn(["bun","install","--frozen-lockfile","--no-progress","--backend=copyfile","--linker=hoisted","--ignore-scripts"],{stdin:"inherit",stdout:"inherit",stderr:"inherit"});const heartbeat=setInterval(()=>console.log("[windy] Bun 依赖安装仍在进行"),15000);const exitCode=await child.exited;clearInterval(heartbeat);process.exit(exitCode)' && bun --cwd apps/server -e 'await import("argon2")'
+ARG WINDY_NPM_REGISTRY=https://registry.npmjs.org
+RUN --mount=type=cache,id=windy-bun-1.3.14,target=/root/.bun/install/cache,sharing=shared bun -e 'const child=Bun.spawn(["bun","install","--frozen-lockfile","--no-progress","--filter","*","--filter","!./apps/agent-server","--registry",process.env.WINDY_NPM_REGISTRY||"https://registry.npmjs.org","--backend=copyfile","--linker=hoisted","--ignore-scripts"],{stdin:"inherit",stdout:"inherit",stderr:"inherit"});const started=Date.now();const heartbeat=setInterval(()=>console.log("[windy] Bun 依赖安装尚未完成，已耗时 "+Math.round((Date.now()-started)/1000)+" 秒"),15000);const deadline=setTimeout(()=>{console.error("[windy] Bun 安装超过 300 秒，请检查 npm 下载网络或通过 WINDY_NPM_REGISTRY 指定可用源");child.kill("SIGKILL")},300000);const exitCode=await child.exited;clearInterval(heartbeat);clearTimeout(deadline);process.exit(exitCode)' && bun --cwd apps/server -e 'await import("argon2")'
 
 FROM deps AS runner
 # @windy-module system.storage begin

package/template/apps/server/package.json

@@ -11,8 +11,8 @@
   },
   "dependencies": {
     "@elysiajs/swagger": "^1.3.1",
-    "@modelcontextprotocol/sdk": "^1",
-    "@noble/ed25519": "^3.1.0",
+    "@modelcontextprotocol/sdk": "^1.32.2",
+    "@noble/ed25519": "^3.2.0",
     "@southwind-ai/config": "workspace:*",
     "@southwind-ai/database": "workspace:*",
     "@southwind-ai/example-work-order": "workspace:*",
@@ -24,20 +24,20 @@
     "@southwind-ai/storage": "workspace:*",
     "ajv": "^8.20.0",
     "argon2": "^0.44.0",
-    "drizzle-orm": "^0.45.2",
-    "elysia": "^1.4.29",
+    "drizzle-orm": "^0.45.4",
+    "elysia": "^1.4.31",
     "fflate": "^0.8.3",
-    "mysql2": "^3.22.6",
-    "nodemailer": "^9.0.3",
-    "pg": "^8.22.0",
-    "pino": "^10.3.1",
+    "mysql2": "^3.24.6",
+    "nodemailer": "^9.1.1",
+    "pg": "^8.23.1",
+    "pino": "^10.4.0",
     "unicode-case-folding": "1.1.1",
-    "ws": "^8.22.0",
+    "ws": "^8.22.1",
     "yaml": "^2.9.1",
-    "zod": "^4.4.3"
+    "zod": "^4.6.7"
   },
   "devDependencies": {
-    "@types/nodemailer": "^8.0.1",
+    "@types/nodemailer": "^8.0.2",
     "@types/ws": "^8.18.2"
   }
 }