@fooksky/lodestar 0.2.4 → 0.2.6

package/README.md

@@ -24,6 +24,8 @@ Lodestar 是 DeepSeek Harness（DSH）的开发工作流插件，帮助 Agent
 
 若需要模式入口，进入侧栏「插件」→「已安装」→ `@fooksky/lodestar` 详情，在「包含的组件」中启用默认关闭的 `dev-workflow-preset`，再于新会话开始前选择「Lodestar · 开发工作流」。已有会话可直接加载 skill；选择模式本身不构成实施授权。支持模式指南的宿主可展示「模式说明 / 如何使用」；旧宿主会忽略指南字段，仍可阅读随包文档。完整步骤、能力要求与恢复方法见 [使用指南：模式说明 / 如何使用](skills/dev-workflow/USER_GUIDE.md)。
 
+启用预设后，点击 `dev-workflow-preset` 行的配置入口即可勾选能力组、保存或恢复默认。更改用于新会话，已有会话保留原装配。详见 [能力开关](skills/dev-workflow/USER_GUIDE.md#能力开关)。
+
 ## 材料与工作区
 
 默认一个独立需求对应一个 change、一条分支、一个 worktree 和一个 Lead。由用户或外部助手先准备工作区；代码、知识、change 材料和需保留的证据均在本 worktree 内维护。

package/package.json

@@ -1,24 +1,67 @@
 {
   "name": "@fooksky/lodestar",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "license": "MIT",
-  "repository": { "type": "git", "url": "git+https://github.com/urzz/lodestar.git" },
-  "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org/", "provenance": false },
-  "keywords": ["dsh", "cordis", "agent", "development", "workflow", "worktree"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/urzz/lodestar.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "provenance": false
+  },
+  "keywords": [
+    "dsh",
+    "cordis",
+    "agent",
+    "development",
+    "workflow",
+    "worktree"
+  ],
   "type": "module",
   "description": "Native DSH development workflow skill and structured change state",
-  "engines": { "node": ">=24", "dsh": ">=0.2.2-rc.1 <0.3.0" },
+  "engines": {
+    "node": ">=24",
+    "dsh": ">=0.2.2-rc.1 <0.3.0"
+  },
   "exports": {
     ".": "./index.js",
     "./preset": "./src/preset.js",
+    "./client": "./src/client.js",
     "./cordis.patch.yml": "./cordis.patch.yml",
     "./package.json": "./package.json",
     "./locale/*.json": "./locale/*.json"
   },
-  "files": ["index.js", "src", "cordis.patch.yml", "skills", "locale", "icon.svg", "README.md", "LICENSE"],
-  "scripts": { "test": "node --test tests/*.test.js", "check": "node --check index.js && node --check src/state.js && node --check src/store.js && node --check src/tool.js && node --check src/schema.js && node --check src/workspace.js && node --check src/preset.js && node --check src/preset-capabilities.js", "prepack": "pnpm check && pnpm test" },
+  "files": [
+    "index.js",
+    "src",
+    "cordis.patch.yml",
+    "skills",
+    "locale",
+    "icon.svg",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test tests/*.test.js",
+    "check": "node --check index.js && node --check src/state.js && node --check src/store.js && node --check src/tool.js && node --check src/schema.js && node --check src/workspace.js && node --check src/preset.js && node --check src/preset-capabilities.js && node --check src/client.js",
+    "prepack": "pnpm check && pnpm test"
+  },
   "icon": "./icon.svg",
-  "dsh": { "bundle": { "patch": "./cordis.patch.yml" } },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-plugin-manager"
+      ]
+    }
+  },
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.1.0",
     "@deepseek-ai/dsh-skill": "0.2.2-rc.1",
@@ -32,16 +75,39 @@
     "@deepseek-ai/dsh-system-prompt": "0.2.2-rc.1"
   },
   "peerDependenciesMeta": {
-    "@deepseek-ai/cordis": { "optional": true },
-    "@deepseek-ai/dsh-skill": { "optional": true },
-    "@deepseek-ai/dsh-tools": { "optional": true },
-    "@deepseek-ai/dsh-fs": { "optional": true },
-    "@deepseek-ai/dsh-working-directory": { "optional": true },
-    "@deepseek-ai/dsh-sandbox-policy": { "optional": true },
-    "@deepseek-ai/dsh-subprocess": { "optional": true },
-    "@deepseek-ai/dsh-sandbox": { "optional": true },
-    "@deepseek-ai/dsh-agent-preset-registry": { "optional": true },
-    "@deepseek-ai/dsh-system-prompt": { "optional": true }
-  },
-  "dependencies": { "@deepseek-ai/schemastery": "~3.19.0", "zod": "^4.6.7" }
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-skill": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-fs": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-working-directory": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-sandbox-policy": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-subprocess": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-sandbox": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent-preset-registry": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-system-prompt": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "~3.19.0",
+    "zod": "^4.6.7"
+  }
 }

package/skills/dev-workflow/USER_GUIDE.md

@@ -25,7 +25,9 @@
 
 ### 能力开关
 
-在插件配置中编辑 `dev-workflow-preset` 组件的 `capabilities`；支持配置表单的宿主会显示布尔开关，也可在该组件的 `config` 中填写：
+在侧栏「插件」→「已安装」→ Lodestar 详情，先启用 `dev-workflow-preset` 组件，再点击该行的配置入口。页面提供 14 组能力勾选项，点击「保存更改」后生效；「恢复默认」会在保存时移除用户覆盖，继承部署配置（未配置时全部开启）。离开页面不会保存草稿；保存失败时会保留草稿并显示原因。配置冲突时可「放弃更改」后重新编辑。
+
+也可在该组件的 `config` 中填写：
 
 ```yaml
 capabilities:

package/src/client.js

@@ -0,0 +1,134 @@
+// Browser module delivered by DSH; React is supplied by the host module table.
+window.__ModuleLoader__.load({
+  id: '@fooksky/lodestar',
+  factory(require) {
+    const React = require('react');
+    const h = React.createElement;
+    const labels = {
+      context: '角色、项目规则和时间上下文', terminal: '终端和后台任务',
+      files: '文件读写、编辑和搜索', scheduling: '定时任务', skills: '技能发现和加载',
+      goals: '持续目标', planning: '原生计划模式', compaction: '上下文压缩',
+      delegation: '子 Agent 和 workflow', questions: '用户提问', todos: '任务进度',
+      web: '网页搜索和抓取', present: '文件交付', pluginManagement: '插件管理',
+    };
+    const enLabels = {
+      context: 'Role, project rules and time context', terminal: 'Terminal and background jobs',
+      files: 'File editing and search', scheduling: 'Scheduled tasks', skills: 'Skill discovery and loading',
+      goals: 'Persistent goals', planning: 'Plan mode', compaction: 'Context compaction',
+      delegation: 'Subagents and workflow', questions: 'User questions', todos: 'Task progress',
+      web: 'Web search and fetch', present: 'File delivery', pluginManagement: 'Plugin management',
+    };
+    const groups = [
+      { zh: '基础环境', en: 'Environment', keys: ['context', 'files', 'terminal', 'compaction'] },
+      { zh: '执行与协作', en: 'Execution and collaboration', keys: ['planning', 'goals', 'delegation', 'questions', 'todos'] },
+      { zh: '信息与交付', en: 'Information and delivery', keys: ['skills', 'web', 'present'] },
+      { zh: '扩展管理', en: 'Extensions', keys: ['scheduling', 'pluginManagement'] },
+    ];
+    // Scoped styles use the same semantic tokens and control dimensions as DSH.
+    const styles = `
+      .lodestar-config { width: 100%; max-width: 720px; color: var(--dsw-alias-label-primary); font: 14px/1.6 var(--dsw-font-family); }
+      .lodestar-config * { box-sizing: border-box; }
+      .lodestar-config p { margin: 0; }
+      .lodestar-config .lodestar-intro { color: var(--dsw-alias-label-tertiary); font-size: 13px; margin-bottom: 24px; max-width: 68ch; }
+      .lodestar-config .lodestar-group { border: 0; padding: 0; margin: 0 0 24px; min-width: 0; }
+      .lodestar-config .lodestar-group legend { padding: 0 0 8px; font-size: 15px; font-weight: 600; }
+      .lodestar-config .lodestar-row { display: flex; flex-direction: row-reverse; justify-content: space-between; align-items: center; gap: 24px; min-height: 48px; padding: 10px 0; border-bottom: 1px solid var(--dsw-alias-border-l1); cursor: pointer; overflow-wrap: anywhere; }
+      .lodestar-config .lodestar-row:has(input:disabled) { cursor: default; }
+      .lodestar-config .lodestar-switch { appearance: none; position: relative; flex: 0 0 36px; width: 36px; height: 20px; margin: 0; border: 0; border-radius: 999px; background: var(--dsw-alias-border-l3); cursor: inherit; }
+      .lodestar-config .lodestar-switch::before { content: ''; position: absolute; top: 2px; left: 2px; width: 16px; height: 16px; border-radius: 50%; background: var(--dsw-alias-switch-thumb); transition: transform .15s; }
+      .lodestar-config .lodestar-switch:checked { background: var(--dsw-alias-brand-primary); }
+      .lodestar-config .lodestar-switch:checked::before { transform: translateX(16px); background: var(--dsw-alias-label-primary-inverted); }
+      .lodestar-config .lodestar-switch:disabled { opacity: .5; }
+      .lodestar-config .lodestar-actions { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; padding-top: 16px; border-top: 1px solid var(--dsw-alias-border-l2); }
+      .lodestar-config .lodestar-button { min-height: 36px; padding: 6px 14px; border: 1px solid var(--dsw-alias-border-l2); border-radius: var(--dsw-radius-md); background: transparent; color: var(--dsw-alias-label-primary); font: inherit; cursor: pointer; }
+      .lodestar-config .lodestar-primary { background: var(--dsw-alias-button-primary-fill); color: var(--dsw-alias-label-primary-inverted); border-color: transparent; }
+      .lodestar-config .lodestar-reset { margin-inline-start: auto; }
+      .lodestar-config .lodestar-button:disabled { opacity: .4; cursor: default; }
+      .lodestar-config :is(input, button):focus-visible { outline: var(--dsw-focus-ring-width) solid var(--dsw-alias-state-business-primary); outline-offset: 3px; }
+      .lodestar-config .lodestar-message { font-size: 13px; color: var(--dsw-alias-label-secondary); margin-bottom: 12px; overflow-wrap: anywhere; }
+      .lodestar-config .lodestar-error { color: var(--dsw-alias-state-error-primary); }
+      @media (hover: hover) {
+        .lodestar-config .lodestar-button:not(:disabled):hover { background: var(--dsw-alias-interactive-bg-hover); }
+        .lodestar-config .lodestar-primary:not(:disabled):hover { background: var(--dsw-alias-button-primary-hover); }
+      }
+      @media (max-width: 400px) { .lodestar-config .lodestar-reset { margin-inline-start: 0; } }
+      @media (prefers-reduced-motion: reduce) { .lodestar-config .lodestar-switch::before { transition: none; } }
+    `;
+    const strings = {
+      zh: { title: '预设能力', summary: '选择开发工作流可使用的能力。',
+        intro: '保存后供新会话使用；已有会话保留原装配。开关仅控制此预设。',
+        unavailable: '请先启用 dev-workflow-preset 组件，再打开配置。', loading: '正在读取配置…',
+        readonly: '当前配置为只读。', save: '保存更改', saving: '正在保存…', reset: '恢复默认',
+        cancel: '放弃更改', saved: '已保存，新会话将使用更新后的能力。',
+        conflict: '未能保存。配置可能已变化，请放弃更改后重试。', resetHint: '恢复默认将在保存时应用。' },
+      en: { title: 'Preset capabilities', summary: 'Choose capabilities for the development workflow.',
+        intro: 'Changes apply to new sessions. Existing sessions keep their composition. These switches affect this preset only.',
+        unavailable: 'Enable the dev-workflow-preset component, then open configuration.', loading: 'Loading configuration…',
+        readonly: 'This configuration is read-only.', save: 'Save changes', saving: 'Saving…', reset: 'Restore defaults',
+        cancel: 'Discard changes', saved: 'Saved. New sessions will use the updated capabilities.',
+        conflict: 'Could not save. Configuration may have changed. Discard changes and try again.', resetHint: 'Defaults will be restored when you save.' },
+    };
+    return {
+      inject: ['slots', 'locale'],
+      apply(ctx) {
+        function Capabilities({ view, form }) {
+          const locale = React.useSyncExternalStore(listener => ctx.locale.subscribe(listener), () => ctx.locale.getSnapshot());
+          const zh = locale.active.startsWith('zh');
+          const t = strings[zh ? 'zh' : 'en'];
+          const [draft, setDraft] = React.useState(null);
+          const [busy, setBusy] = React.useState(false);
+          const [message, setMessage] = React.useState(null);
+          if (view === 'summary') return h('p', null, t.summary);
+          const state = form?.state;
+          if (!state || state.status === 'unavailable') return h('p', null, t.unavailable);
+          if (state.status === 'loading') return h('p', { role: 'status' }, t.loading);
+          const values = draft?.values ?? state.value.capabilities;
+          const editable = state.writable && !busy;
+          const begin = () => ({ values: { ...state.value.capabilities }, revision: state.revision, reset: false });
+          async function save(event) {
+            event.preventDefault();
+            setBusy(true);
+            setMessage(null);
+            try {
+              const ops = Object.keys(labels).map(key => draft.reset
+                ? { op: 'unset', path: ['capabilities', key] }
+                : { op: 'set', path: ['capabilities', key], value: draft.values[key] });
+              const accepted = await form.mutate(ops, draft.revision);
+              if (accepted) setDraft(null);
+              setMessage({ error: !accepted, text: accepted ? t.saved : t.conflict });
+            } catch (error) {
+              setMessage({ error: true, text: error.message });
+            } finally { setBusy(false); }
+          }
+          return h('form', { onSubmit: save, className: 'lodestar-config', 'aria-label': t.title, 'aria-busy': busy },
+            h('style', null, styles),
+            h('p', { className: 'lodestar-intro' }, t.intro),
+            !state.writable && h('p', { className: 'lodestar-message' }, t.readonly),
+            ...groups.map(group => h('fieldset', { key: group.en, disabled: !editable, className: 'lodestar-group' },
+              h('legend', null, zh ? group.zh : group.en),
+              ...group.keys.map(key => h('label', { key, className: 'lodestar-row' },
+                h('input', { type: 'checkbox', role: 'switch', className: 'lodestar-switch', checked: values[key], onChange: event => {
+                  const next = draft ?? begin();
+                  setDraft({ ...next, reset: false, values: { ...next.values, [key]: event.target.checked } });
+                  setMessage(null);
+                } }), (zh ? labels : enLabels)[key])))),
+            draft?.reset && h('p', { role: 'status', className: 'lodestar-message' }, t.resetHint),
+            message && h('p', { role: message.error ? 'alert' : 'status',
+              className: `lodestar-message${message.error ? ' lodestar-error' : ''}` }, message.text),
+            h('div', { className: 'lodestar-actions' },
+              h('button', { type: 'submit', className: 'lodestar-button lodestar-primary', disabled: !editable || !draft }, busy ? t.saving : t.save),
+              draft && h('button', { type: 'button', className: 'lodestar-button', disabled: busy, onClick: () => { setDraft(null); setMessage(null); } }, t.cancel),
+              h('button', { type: 'button', className: 'lodestar-button lodestar-reset', disabled: !editable, onClick: () => {
+                const base = state.base?.capabilities ?? {};
+                setDraft({ ...(draft ?? begin()), reset: true,
+                  values: Object.fromEntries(Object.keys(labels).map(key => [key, base[key] ?? true])) });
+                setMessage(null);
+              } }, t.reset)));
+        }
+        ctx.effect(() => ctx.slots.inject('plugins.row.config', () => ctx.slots.register({
+          name: 'plugins.row.config', key: '@fooksky/lodestar#dev-workflow-preset',
+        }, Capabilities)));
+      },
+    };
+  },
+});

package/src/preset.js

@@ -12,7 +12,7 @@ export const inject = ['tools', 'agentPresets', 'systemPrompt'];
 export const Config = z.object({
   entry: z.boolean().default(false).hidden(),
   capabilities: z.object(Object.fromEntries(Object.entries(capabilityGroups).map(([key, group]) =>
-    [key, z.boolean().default(true).description(group.label)]))).default(defaultCapabilities).description('能力开关；默认对齐标准模式，仅控制本 preset 装配'),
+    [key, z.boolean().default(true).description(group.label)]))).default(defaultCapabilities).description('能力开关；默认对齐标准模式，仅控制本 preset 装配').volatile(),
 });
 export const requiredTools = expectedTools(defaultCapabilities);
 export const modeText = '本会话采用开发工作流。开发变更先加载 lodestar，定位或创建 change，按当前阶段继续。只调查、解释或设计时遵守该范围；选择模式不构成实施、提交、发布或安装授权。受委派成员执行任务包并向 Lead 回报，不重复启动 Lead 需求确认流程。浏览器、记忆和 Teams 等扩展沿用宿主部署；普通 subagent 按任务需要使用。';
@@ -28,7 +28,11 @@ export function createDefinition(capabilities = defaultCapabilities) {
 }
 export const definition = createDefinition();
 export async function apply(ctx, config = {}) {
-  const { entry, capabilities } = Config(config);
+  // Cordis resolves Config before activation; direct callers provide raw config.
+  const resolved = config.capabilities?.get ? config : Config(config);
+  const { entry } = resolved;
+  const readCapabilities = () => resolved.capabilities.get();
+  const capabilities = readCapabilities();
   if (entry) {
     if (!ctx.systemPrompt) throw new Error('dev-workflow mode requires systemPrompt');
     const dispose = ctx.systemPrompt.section({
@@ -45,7 +49,29 @@ export async function apply(ctx, config = {}) {
     ctx.effect(() => dispose);
   } else {
     if (!ctx.agentPresets) throw new Error('dev-workflow preset requires agentPresets');
-    const dispose = await ctx.agentPresets.register(createDefinition(capabilities));
-    ctx.effect(() => dispose);
+    const registry = ctx.agentPresets;
+    await ctx.effect(async () => {
+      let dispose;
+      let closed = false;
+      const replace = async () => {
+        if (closed) return;
+        // Same-id registration is rejected. Retiring first preserves existing
+        // users of the old generation while new scopes join the replacement.
+        await dispose?.();
+        dispose = undefined;
+        if (!closed) dispose = await registry.register(createDefinition(readCapabilities()));
+      };
+      let pending = replace();
+      ctx.on('loader/volatile-update', paths => {
+        if (!paths.some(path => path[0] === 'capabilities')) return;
+        pending = pending.then(replace);
+        pending.catch(error => ctx.logger.error(error));
+      });
+      await pending;
+      return async () => {
+        closed = true;
+        try { await pending; } finally { await dispose?.(); }
+      };
+    });
   }
 }