dsh-paoding 0.2.1 → 0.2.2

package/README.md

@@ -44,7 +44,7 @@ npx github:lifangjin/dsh-paoding   # 发布前从 GitHub 仓库直装，效果
 
 这一条等价于 `--auto --config-ui`：生成编排预设、写好基础配置模板，并把「庖丁配置」挂进 DSH 设置页。开箱默认只带 DSH 自带的基础工具，检测到的 MCP/host 工具不会自动写入——装完在**设置 → 庖丁配置**里按需勾选工具与角色，「保存并应用」即生效；想逐项过一遍就跑 `npx dsh-paoding --wizard`，想沿用自动分配就加 `--suggest`。
 
-偏好官方插件通道的话，`dsh plugin --profile web add dsh-paoding@0.2.0` 也能把「庖丁配置」按 profile 装进设置页（preset 本体仍走 npx / `./install.sh`），详见[安装文档](docs/installation.md)。
+偏好官方插件通道的话，`dsh plugin --profile web add dsh-paoding@latest` 也能把「庖丁配置」按 profile 装进设置页（preset 本体仍走 npx / `./install.sh`），详见[安装文档](docs/installation.md)。
 
 **克隆仓库安装**——老路线原样保留：
 

package/README_en.md

@@ -44,7 +44,7 @@ npx github:lifangjin/dsh-paoding   # before publishing: runs straight from GitHu
 
 This one command equals `--auto --config-ui`: it generates the orchestrator preset, writes the base config template, and mounts the config UI into the DSH Settings page. Out of the box the template only carries DSH's built-in base tools — detected MCP/host tools are not written in automatically. After installing, pick the tools and roles you need in **Settings → 庖丁配置 (Paoding Config)** and hit Save & Apply, or run `npx dsh-paoding --wizard` for a guided pass; add `--suggest` if you prefer the old auto-assignment.
 
-If you prefer the official plugin channel, `dsh plugin --profile web add dsh-paoding@0.2.0` installs the Paoding Config UI into Settings, scoped per profile (the preset itself still comes from npx / `./install.sh`) — see the [installation guide](docs/installation_en.md).
+If you prefer the official plugin channel, `dsh plugin --profile web add dsh-paoding@latest` installs the Paoding Config UI into Settings, scoped per profile (the preset itself still comes from npx / `./install.sh`) — see the [installation guide](docs/installation_en.md).
 
 **Clone and install** — the classic route, unchanged:
 

package/docs/installation.md

@@ -72,7 +72,7 @@ npm 包与命令同名：包 `dsh-paoding`，命令 `dsh-paoding`。这条默认
 npx 之外，配置 UI 还能走 DSH 的官方插件通道单独安装：
 
 ```bash
-dsh plugin --profile web add dsh-paoding@0.2.0
+dsh plugin --profile web add dsh-paoding@latest
 ```
 
 装完**重启 DSH（`dsh web`）**，设置页出现「庖丁配置」；卸载用 `dsh plugin --profile web remove dsh-paoding`。机制一句话：npm 包 `dsh-paoding` 在包根声明了 `dsh.bundle.patch`（一份 `cordis.patch.yml`，一行 insert：`id: paoding-config-ui` / `name: dsh-paoding`），安装后由 `reconcilePlugins` 自动并入该 profile 的启动层——与 npx 通道是同一个 npm 包，只是两种装法。
@@ -80,7 +80,7 @@ dsh plugin --profile web add dsh-paoding@0.2.0
 **这条通道只装 UI 这一件**（机制所限，编排 preset 与配置文件装不了，preset 那半边走 npx / `./install.sh`），想两步装齐全就这样搭配：
 
 ```bash
-dsh plugin --profile web add dsh-paoding@0.2.0   # 配置 UI，只在指定 profile 生效
+dsh plugin --profile web add dsh-paoding@latest   # 配置 UI，只在指定 profile 生效
 npx dsh-paoding@latest --no-ui                    # 编排 preset + 配置模板，--no-ui 防止 UI 重复挂载
 ```
 
@@ -290,7 +290,7 @@ cd dsh-paoding
 
 从 npx/npm 入口安装时没有仓库目录可链：安装器改为把整包复制到 `$DSH_HOME/dsh-paoding`（见第 2 节），再从那里挂载；只有克隆仓库跑 `./install.sh` 才走上面的符号链接直连。两种形态对 DSH 都是同一个 `paoding-config-ui` 包，下一节的加载机制完全一致。
 
-除了 `--config-ui`，还有一条路通向同一个分区：DSH 官方插件通道 `dsh plugin --profile web add dsh-paoding@0.2.0`，只装 UI、按 profile 生效（详见第 2 节）。它与这里的全局挂载勿并存，否则设置页会出现重复的「庖丁配置」。
+除了 `--config-ui`，还有一条路通向同一个分区：DSH 官方插件通道 `dsh plugin --profile web add dsh-paoding@latest`，只装 UI、按 profile 生效（详见第 2 节）。它与这里的全局挂载勿并存，否则设置页会出现重复的「庖丁配置」。
 
 ### 加载机制
 
@@ -305,7 +305,7 @@ cd dsh-paoding
 
 ### 面板能力
 
-- **状态与操作**：顶部按钮「**保存并应用**」「预览生成」「重新检测」；检测摘要与 chips（当前 profile、每个 MCP 服务器及工具数、插件 chips、技能数等）。
+- **状态与操作**：检测摘要与 chips（当前 profile、每个 MCP 服务器及工具数、插件 chips、技能数等）；操作按钮「**保存并应用**」「预览生成」「重新检测」固定在面板底部悬浮操作坞（sticky bottom），滚动任意位置都可直接点击。
 - **Agent 工具分配卡片**：主 agent 一张固定卡（基础工具取消勾选 = 加入 `main_agent_remove` 从主 agent 剔除；Host 工具勾选 = 加入 `main_agent_extra`；技能「read 按需」与「内联全文」两组勾选；另有「人设追加」编辑区，可改、清空、恢复默认）＋ `search_external` / `design` / `implement` 三张内置角色卡 ＋ 任意自定义角色卡（带删除按钮）；每张角色卡可勾选/取消基础工具与 Host 工具、编辑 persona。底部「新建自定义 agent 角色」。
 - **技能分配**：每个 skill 一行，勾选分配给哪些 agent（写入对应 persona 的 `Available skills` 软引导；角色技能软引导，主 agent 技能另有 read 按需/内联两组）。
 - **预览生成**：不写盘生成 `agent.cordis.yml`，显示每个角色 allow 的 intent → kept 计数与生成全文。

package/docs/installation_en.md

@@ -72,7 +72,7 @@ When it finishes, **restart DSH (`dsh web`)**; the remaining steps are covered i
 Besides npx, the config UI can also be installed on its own through DSH's official plugin channel:
 
 ```bash
-dsh plugin --profile web add dsh-paoding@0.2.0
+dsh plugin --profile web add dsh-paoding@latest
 ```
 
 Restart DSH (`dsh web`) afterwards and the「庖丁配置」(Paoding Config) section appears in Settings; uninstall with `dsh plugin --profile web remove dsh-paoding`. The mechanism in one line: the `dsh-paoding` npm package declares a `dsh.bundle.patch` at its root (a `cordis.patch.yml` with one insert row, `id: paoding-config-ui` / `name: dsh-paoding`), and `reconcilePlugins` folds it into that profile's startup layer — the same npm package as the npx channel, just a second way to install it.
@@ -80,7 +80,7 @@ Restart DSH (`dsh web`) afterwards and the「庖丁配置」(Paoding Config) sec
 **This channel carries the UI only** (by design it cannot install the orchestrator preset or the config file — that half goes through npx / `./install.sh`), so the full setup takes two steps:
 
 ```bash
-dsh plugin --profile web add dsh-paoding@0.2.0   # the config UI, effective in the given profile only
+dsh plugin --profile web add dsh-paoding@latest   # the config UI, effective in the given profile only
 npx dsh-paoding@latest --no-ui                    # the preset + config template; --no-ui avoids mounting the UI twice
 ```
 
@@ -293,7 +293,7 @@ Then **restart DSH (`dsh web`)**; the "庖丁配置" (Paoding Config) section ap
 
 On the npx/npm entry there is no repository directory to link: the installer instead copies the whole package to `$DSH_HOME/dsh-paoding` (see §2) and mounts from there; only the clone-and-run-`./install.sh` route uses the symlink shown above. Both forms present the same `paoding-config-ui` package to DSH, so the loading mechanism in the next subsection is identical.
 
-Another route to the same section is DSH's official plugin channel: `dsh plugin --profile web add dsh-paoding@0.2.0` installs the UI on its own, per profile (see §2). Don't keep that mount side by side with `--config-ui`'s global one, or the Settings page ends up with a duplicate Paoding Config section.
+Another route to the same section is DSH's official plugin channel: `dsh plugin --profile web add dsh-paoding@latest` installs the UI on its own, per profile (see §2). Don't keep that mount side by side with `--config-ui`'s global one, or the Settings page ends up with a duplicate Paoding Config section.
 
 ### Loading mechanism
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-paoding",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "庖丁 — DSH (DeepSeek Harness) 编排模式安装器：host 感知的角色工具过滤 + Web 设置页可视化配置器",
   "type": "module",
   "license": "MIT",

package/plugins/paoding-config-ui/lib/base.css

@@ -98,11 +98,28 @@
   color: var(--dsw-alias-state-error-primary);
 }
 
-.omd-actions {
+/* Sticky bottom action dock: keeps the primary buttons reachable at the
+   bottom of the scroll container while the user edits lower groups. */
+.omd-actionBar {
+  position: sticky;
+  bottom: 8px;
+  z-index: 6;
   display: flex;
   flex-wrap: wrap;
   gap: 8px;
   align-items: center;
+  padding: 10px 12px;
+  box-sizing: border-box;
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 14px;
+  background: var(--dsw-alias-bg-layer-3);
+  box-shadow: 0 8px 24px -12px rgba(0, 0, 0, 0.35);
+}
+
+/* 主操作（保存并应用）推到操作坞最右；窄屏换行时落到次行右缘。 */
+.omd-applyDock {
+  margin-left: auto;
+  display: inline-flex;
 }
 
 .omd-chips {

package/plugins/paoding-config-ui/lib/client.js

@@ -31,7 +31,7 @@ window.__ModuleLoader__.load({
 
     var React = require("react");
     var h = React.createElement;
-    var useState = React.useState, useEffect = React.useEffect, useCallback = React.useCallback;
+    var useState = React.useState, useEffect = React.useEffect, useCallback = React.useCallback, useRef = React.useRef;
     var P = require("@deepseek-ai/dsh-client-ui-primitives");
 
     // ── 样式注入（幂等）─────────────────────────────────────────────────
@@ -267,6 +267,9 @@ window.__ModuleLoader__.load({
       var _mg = useState(null), modelGroups = _mg[0], setModelGroups = _mg[1]; // 模型目录 groups（/api/paoding/models）
       var _mgok = useState(false), modelGroupsOk = _mgok[0], setModelGroupsOk = _mgok[1]; // 目录可用 = 下拉模式；false = 降级双 input
       var _mgerr = useState(""), modelGroupsErr = _mgerr[0], setModelGroupsErr = _mgerr[1]; // 目录拉取失败原因（降级 hint 一句话展示）
+      var rootRef = useRef(null); // 面板根节点（重新检测后回顶用）
+      var previewRef = useRef(null); // 预览生成组根节点（条件渲染，预览成功后定位用）
+      var _sr = useState(null), scrollReq = _sr[0], setScrollReq = _sr[1]; // 滚动请求："preview" | "top" | null
 
       var api = useCallback(function (path, body) {
         var opts = body === undefined ? {} : {
@@ -357,6 +360,14 @@ window.__ModuleLoader__.load({
 
       useEffect(loadModels, [loadModels]);
 
+      // 滚动请求：preview 需等条件渲染挂载后生效（effect 在 commit 后运行），top 立即生效。
+      useEffect(function () {
+        if (!scrollReq) return;
+        var el = scrollReq === "preview" ? previewRef.current : rootRef.current;
+        if (el && el.scrollIntoView) el.scrollIntoView({ behavior: "smooth", block: "start" });
+        setScrollReq(null);
+      }, [scrollReq, preview]);
+
       function setRoleTools(name, tool, on) {
         setAssign(function (prev) {
           var next = JSON.parse(JSON.stringify(prev));
@@ -511,6 +522,7 @@ window.__ModuleLoader__.load({
         setPreview(null);
         api("preview", { assignments: assign }).then(function (r) {
           setPreview(r);
+          setScrollReq("preview"); // 预览成功后自动滚动定位到预览生成区
           setNote("");
         }).catch(function (err) { setError(err.message); }).finally(function () {
           setBusy(false);
@@ -537,6 +549,7 @@ window.__ModuleLoader__.load({
       function doRescan() {
         setBusy(true);
         setBusyOp("rescan");
+        setScrollReq("top"); // 立即滚动回面板顶部看状态说明（不等接口返回）
         api("rescan", {}).then(function (d) {
           setData(d);
           setAssign(buildAssignments(d));
@@ -1051,7 +1064,7 @@ window.__ModuleLoader__.load({
 
       var pluginChips = data ? pluginChipsOf(data) : { primary: [], secondary: [] };
 
-      return h("div", { className: "omd-section" },
+      return h("div", { className: "omd-section", ref: rootRef },
         h("p", { className: "omd-intro" }, INTRO),
 
         // 状态与操作
@@ -1061,7 +1074,6 @@ window.__ModuleLoader__.load({
             h("span", null, "状态与操作")),
           statusBarOf(),
           runtimeNoteOf(data),
-          h("div", { className: "omd-actions" }, applyBtn, previewBtn, rescanBtn),
           h("div", { className: "omd-chips" },
             h(P.Pill, null, "profile " + (data.effectiveProfile || "web")),
             (data.mcpReports || []).map(function (m) {
@@ -1116,7 +1128,7 @@ window.__ModuleLoader__.load({
           skillsBlock()),
 
         // 预览生成（预览成功后才出现）
-        preview ? h("div", { className: "omd-group" },
+        preview ? h("div", { className: "omd-group", ref: previewRef },
           h("div", { className: "omd-groupHeading" },
             h("span", { className: "omd-groupIcon" }, ic(P.IconDataOutline16, 14)),
             h("span", null, "预览生成")),
@@ -1124,7 +1136,12 @@ window.__ModuleLoader__.load({
             "✅ 生成成功（未写盘）" + (preview.roleResults || []).map(function (r) {
               return " · " + r.role + ": " + r.intent.length + " → " + r.kept.length;
             }).join("")),
-          h("pre", { className: "omd-pre" }, preview.text)) : null);
+          h("pre", { className: "omd-pre" }, preview.text)) : null,
+
+        // 悬浮操作坞（sticky bottom：按钮常驻滚动容器底部，改完配置无需滚回顶部再操作）
+        h("div", { className: "omd-actionBar" },
+          previewBtn, rescanBtn,
+          h("span", { className: "omd-applyDock" }, applyBtn)));
     }
 
     // ── cordis client 插件：注册到设置页 settings.section 槽位 ──────────────

package/plugins/paoding-config-ui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paoding-config-ui",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "private": true,
   "type": "module",
   "main": "index.mjs",