@openvulcan/dsh-vulcancode 0.4.3 → 0.4.4

package/README.md

@@ -14,7 +14,7 @@
 
 **简体中文** | [English](README.en.md)
 
-[特色功能](#特色功能) · [架构与包结构](#架构与包结构) · [快速开始](#快速开始) · [开发](#开发)
+[特色功能](#特色功能) · [界面截图](#界面截图) · [架构与包结构](#架构与包结构) · [快速开始](#快速开始) · [开发](#开发)
 
 </div>
 
@@ -33,16 +33,27 @@ dsh-vulcancode 是 DeepSeek Harness（dsh）的社区插件套件。安装一个
 - **工具调用可审查**，Vulcan Decision 在执行前使用云端或本机模型判定，并支持配置复核和人工确认。
 - **技能与经验可复用**，LuaSkills 把技能发布为 AI 可调用的工具，Markdown 长期记忆保留用户、空间和项目经验。
 - **模型可单独配置思考级别**，pi-ai 模型的可选级别和接口传输值可按供应商、按模型设置。
+- **语音输入**使用 OpenVulcan 账号所属站点的免费转写服务，把口述内容插入对话草稿。
+
+## 界面截图
+
+### 暗色主题 · 工具分类卡片
+
+![Vulcan 暗色主题下，交互式回答以卡片展示工具分类](docs/assets/dsh-vulcan-dark.png)
+
+### 指挥舱主题 · 记忆工具验证
+
+![Vulcan 指挥舱主题下，交互式回答以统计卡片、检查清单和表格展示记忆工具验证结果](docs/assets/dsh-vulcan-command.png)
 
 ## 架构与包结构
 
-dsh 通过套件的 `cordis.patch.yml` 装载七个插件。自动审批调用判定引擎，使用云端判定时通过 `openvulcanAccount` 获取账号凭据。账号插件和判定引擎复用同一账号库。发布包随附这九个工作区依赖，用户只需安装套件。
+dsh 通过套件的 `cordis.patch.yml` 装载八个插件。自动审批和语音输入通过 `openvulcanAccount` 获取云端服务所需的凭据。账号插件和判定引擎复用同一账号库。发布包随附工作区依赖，用户只需安装套件。
 
 ### 套件入口
 
 #### `@openvulcan/dsh-vulcancode`
 
-负责声明 dsh 兼容范围和插件组。安装入口是 `dsh plugin add @openvulcan/dsh-vulcancode`，插件管理页可查看套件。源码在 [packages/dsh-vulcancode](packages/dsh-vulcancode)。
+套件通过 `dsh.bundle.patch` 声明插件组。dsh 加载各子插件的 `apply(ctx)` 入口，账号插件则导出 Cordis 服务类。安装后可在插件管理页查看套件及其组件。源码在 [packages/dsh-vulcancode](packages/dsh-vulcancode)。
 
 ### dsh 插件
 
@@ -74,6 +85,10 @@ dsh 通过套件的 `cordis.patch.yml` 装载七个插件。自动审批调用
 
 在「设置 › 通用设置」的「Vulcan 界面风格」选择跟随系统、亮色、暗色、指挥舱或 dsh 自带主题。直角开关可与任意主题搭配，覆盖 Windows 桌面内容区等界面边角。设置布局为模型目录、内置插件和 LuaSkills 等页面留出更多可用宽度。源码在 [packages/dsh-vulcan-style](packages/dsh-vulcan-style)。
 
+#### `@openvulcan/dsh-vulcan-voice-input`
+
+登录 OpenVulcan 后，将鼠标移到对话输入框的麦克风按钮，可选择所属站点发布的免费转写模型、优先语言、麦克风和录音快捷键。可在「设置 › OpenVulcan 语音输入」测试麦克风和查看服务状态。录音快捷键支持单独绑定右 Ctrl 等左右修饰键。按住麦克风按钮或在输入框内按住所设快捷键说话，松开后转写内容会回填当前草稿。连续录满 120 秒会自动停止并转写。源码在 [packages/dsh-vulcan-voice-input](packages/dsh-vulcan-voice-input)。
+
 ### 共享库与命令行
 
 #### `@openvulcan/vulcan-decision`
@@ -88,8 +103,18 @@ dsh 通过套件的 `cordis.patch.yml` 装载七个插件。自动审批调用
 
 套件声明兼容 dsh `>=0.2.1-rc.2 <0.3.0`。
 
+### 桌面版
+
+在 dsh 侧栏打开「插件」，点击「添加插件」，在安装框中粘贴以下 npm 包名并安装。
+
+```text
+@openvulcan/dsh-vulcancode
+```
+
+### 网页版
+
 ```sh
-dsh plugin add @openvulcan/dsh-vulcancode
+dsh plugin --profile web add @openvulcan/dsh-vulcancode
 ```
 
 ### 使用
@@ -116,7 +141,7 @@ pnpm run test
 pnpm run pack:dsh   # 生成 dist/openvulcan-dsh-vulcancode-<版本>.tgz
 ```
 
-本地安装打包结果使用 `dsh plugin add ./dist/openvulcan-dsh-vulcancode-<版本>.tgz`。
+在网页版配置中安装本地包时，执行 `dsh plugin --profile web add ./dist/openvulcan-dsh-vulcancode-<版本>.tgz`。
 
 ## 致谢
 

package/cordis.patch.yml

@@ -17,3 +17,5 @@
           name: '@openvulcan/dsh-vulcan-memory'
         - id: vulcan-reasoning
           name: '@openvulcan/dsh-vulcan-reasoning'
+        - id: vulcan-voice-input
+          name: '@openvulcan/dsh-vulcan-voice-input'

package/node_modules/@openvulcan/dsh-decision-guard/lib/client.js

@@ -323,6 +323,7 @@ window.__ModuleLoader__.load({
 			    'status.auto.standalone': '独立开关方式不使用该预设，所有会话都受判定',
 			    'status.decision.cloud': 'OpenVulcan 云端 · {model}',
 			    'status.decision.cloudNoModel': 'OpenVulcan 云端 · 没有可用的模型',
+			    'status.decision.cloudLoadFailed': 'OpenVulcan 云端 · 无法读取判定模型',
 			    'status.decision.signedOut': 'OpenVulcan 云端 · 未登录，受管控的调用会询问你',
 			    'status.decision.local': '本机 · {pack} 运行 {model}',
 			    'status.decision.localMissing': '本机 · 尚未选择运行包与模型，受管控的调用会询问你',
@@ -680,6 +681,7 @@ window.__ModuleLoader__.load({
 			    'status.auto.standalone': 'The standalone switch does not use the preset; every session is judged',
 			    'status.decision.cloud': 'OpenVulcan cloud · {model}',
 			    'status.decision.cloudNoModel': 'OpenVulcan cloud · no model available',
+			    'status.decision.cloudLoadFailed': 'OpenVulcan cloud · could not load decision models',
 			    'status.decision.signedOut': 'OpenVulcan cloud · not signed in; governed calls ask you',
 			    'status.decision.local': 'This machine · {pack} runs {model}',
 			    'status.decision.localMissing': 'This machine · no runtime pack and model chosen; governed calls ask you',
@@ -1076,26 +1078,45 @@ window.__ModuleLoader__.load({
 			    ctx.effect(() => ctx.locale.register(i18n_1.NAMESPACE, { zh: i18n_1.zh, en: i18n_1.en }), 'vulcan-decision-guard: dictionaries');
 			    ctx.effect(() => {
 			        let accountKey;
+			        // A reconnect can keep the same authorization ID while replacing the backend.
+			        // 重连可能更换宿主，但仍保留相同的授权标识。
+			        let refreshCloud = true;
+			        /**
+			         * Invalidate account-scoped data and read the new Host state after reconnect or plugin changes.
+			         * 重连或插件变更后清除账号相关数据，并读取新的宿主状态。
+			         */
 			        const refreshAll = () => {
+			            refreshCloud = true;
+			            services.panel.reset();
+			            services.cloudModels.reset();
+			            services.endpoints.reset();
 			            services.autoReview.refresh();
 			            services.autoListed.refresh();
 			            services.panel.refresh();
 			        };
 			        const stops = [
-			            ctx.remote.$on('plugin-manager/changed', () => { services.autoReview.refresh(); }),
+			            ctx.remote.$on('plugin-manager/changed', refreshAll),
 			            ctx.remote.$on('permission-presets/catalog-changed', () => { services.autoListed.refresh(); }),
 			            ctx.on('connection/reset', refreshAll),
-			            // Signing in and out happens in the account plugin; the models and endpoints belong to the account.
+			            // Load the model list when the first signed-in account arrives, without opening any UI.
+			            // 首次确认账号已登录时主动加载模型目录，无需打开界面。
 			            services.panel.subscribe(() => {
 			                const account = services.panel.getSnapshot()?.account;
 			                if (account === undefined)
 			                    return;
-			                const key = account.signedIn ? account.authorizationId ?? '' : null;
-			                if (accountKey !== undefined && key !== accountKey) {
+			                const key = account.signedIn ? `${account.site ?? ''}:${account.authorizationId ?? ''}` : null;
+			                if (!refreshCloud && key === accountKey)
+			                    return;
+			                const hadAccount = accountKey !== undefined;
+			                accountKey = key;
+			                refreshCloud = false;
+			                services.cloudModels.reset();
+			                services.endpoints.reset();
+			                if (account.signedIn) {
 			                    services.cloudModels.refresh();
-			                    services.endpoints.refresh();
+			                    if (hadAccount)
+			                        services.endpoints.refresh();
 			                }
-			                accountKey = key;
 			            }),
 			        ];
 			        refreshAll();
@@ -1279,8 +1300,8 @@ window.__ModuleLoader__.load({
 			        return null;
 			    const governed = value.mode === 'standalone' || permissions?.currentValue === shared_1.AUTO_PRESET;
 			    const unattended = view?.unattended === true;
-			    const decision = (0, settings_1.decisionStatus)(t, value, live, models?.kind === 'ready' ? models.models : undefined);
-			    const dot = !governed ? 'off' : decision.tone === 'ok' ? 'ok' : 'warn';
+			    const decision = (0, settings_1.decisionStatus)(t, value, live, models);
+			    const dot = !governed || decision.tone === 'outline' ? 'off' : decision.tone === 'ok' ? 'ok' : 'warn';
 			    return ((0, jsx_runtime_1.jsxs)("span", { className: "vdg", children: [(0, jsx_runtime_1.jsxs)("button", { ref: anchor, type: "button", className: "vdg-trigger", "aria-haspopup": "dialog", "aria-expanded": open, title: decision.text, onClick: () => {
 			                    if (!open) {
 			                        services.panel.refresh();
@@ -1568,16 +1589,25 @@ window.__ModuleLoader__.load({
 			// The sections appear in the same order in navigation and in the page.
 			// 分区在导航和正文中按同一顺序排列。
 			const SETTINGS_VIEWS = ['engine', 'policy', 'records'];
-			/** What the status section says about decisions, from the saved settings and this machine's state. */
-			function decisionStatus(t, value, live, models) {
+			/**
+			 * Describe the configured backend using the latest account and model-list response.
+			 * 使用最新账号和模型目录响应描述已配置的判定后端。
+			 */
+			function decisionStatus(t, value, live, list) {
 			    if (live == null)
 			        return { tone: 'outline', text: t('loading') };
 			    if (value.backend === 'cloud') {
 			        if (!live.account.signedIn)
 			            return { tone: 'warn', text: t('status.decision.signedOut') };
-			        const model = value.cloudModel === '' ? models?.[0] : value.cloudModel;
-			        if (model === undefined || (models !== undefined && !models.includes(model)))
+			        if (list === undefined)
+			            return { tone: 'outline', text: t('model.loading') };
+			        if (list.kind === 'failed')
+			            return { tone: 'warn', text: t('status.decision.cloudLoadFailed') };
+			        const model = value.cloudModel === '' ? list.models[0] : value.cloudModel;
+			        if (list.models.length === 0 || model === undefined)
 			            return { tone: 'warn', text: t('status.decision.cloudNoModel') };
+			        if (!list.models.includes(model))
+			            return { tone: 'warn', text: (0, i18n_1.fill)(t('model.disabled'), { model }) };
 			        return { tone: 'ok', text: (0, i18n_1.fill)(t('status.decision.cloud'), { model }) };
 			    }
 			    const pack = live.packs.find(item => item.id === value.localPack && item.installed !== null);
@@ -1590,7 +1620,7 @@ window.__ModuleLoader__.load({
 			    const heldByReview = (0, ui_1.useWatch)(services.autoReview);
 			    const listed = (0, ui_1.useWatch)(services.autoListed);
 			    const models = (0, ui_1.useWatch)(services.cloudModels);
-			    const decision = decisionStatus(t, value, live, models?.kind === 'ready' ? models.models : undefined);
+			    const decision = decisionStatus(t, value, live, models);
 			    let auto;
 			    if (value.mode === 'standalone')
 			        auto = { tone: 'outline', text: 'status.auto.standalone', badge: 'tone.off' };
@@ -1600,7 +1630,7 @@ window.__ModuleLoader__.load({
 			        auto = { tone: 'ok', text: 'status.auto.provided', badge: 'tone.ok' };
 			    else
 			        auto = { tone: 'outline', text: 'status.auto.pending', badge: 'status.auto.pending' };
-			    return ((0, jsx_runtime_1.jsx)(ui_1.Section, { title: t('status.title'), flush: true, children: (0, jsx_runtime_1.jsxs)("div", { className: "vdg-rows", children: [(0, jsx_runtime_1.jsxs)("div", { className: "vdg-row", children: [(0, jsx_runtime_1.jsx)("span", { className: "vdg-row-label", children: t('status.decision') }), (0, jsx_runtime_1.jsxs)("span", { className: "vdg-row-value", children: [decision.text, (0, jsx_runtime_1.jsx)(ui_1.Badge, { tone: decision.tone, children: t(decision.tone === 'ok' ? 'tone.ok' : 'tone.warn') })] })] }), (0, jsx_runtime_1.jsxs)("div", { className: "vdg-row", children: [(0, jsx_runtime_1.jsx)("span", { className: "vdg-row-label", children: t('status.auto') }), (0, jsx_runtime_1.jsxs)("span", { className: "vdg-row-value", children: [t(auto.text), (0, jsx_runtime_1.jsx)(ui_1.Badge, { tone: auto.tone, children: t(auto.badge) })] })] })] }) }));
+			    return ((0, jsx_runtime_1.jsx)(ui_1.Section, { title: t('status.title'), flush: true, children: (0, jsx_runtime_1.jsxs)("div", { className: "vdg-rows", children: [(0, jsx_runtime_1.jsxs)("div", { className: "vdg-row", children: [(0, jsx_runtime_1.jsx)("span", { className: "vdg-row-label", children: t('status.decision') }), (0, jsx_runtime_1.jsxs)("span", { className: "vdg-row-value", children: [decision.text, decision.tone === 'outline' ? null : (0, jsx_runtime_1.jsx)(ui_1.Badge, { tone: decision.tone, children: t(decision.tone === 'ok' ? 'tone.ok' : 'tone.warn') })] })] }), (0, jsx_runtime_1.jsxs)("div", { className: "vdg-row", children: [(0, jsx_runtime_1.jsx)("span", { className: "vdg-row-label", children: t('status.auto') }), (0, jsx_runtime_1.jsxs)("span", { className: "vdg-row-value", children: [t(auto.text), (0, jsx_runtime_1.jsx)(ui_1.Badge, { tone: auto.tone, children: t(auto.badge) })] })] })] }) }));
 			}
 			function OptionsSection({ t, value, disabled, save }) {
 			    const row = (field, prefix, values) => ((0, jsx_runtime_1.jsxs)("div", { className: "vdg-row", children: [(0, jsx_runtime_1.jsx)("span", { children: t(`${prefix}.title`) }), (0, jsx_runtime_1.jsx)(ui_1.Segments, { label: t(`${prefix}.title`), value: value[field], options: values.map(item => ({ value: item, title: t(`${prefix}.${item}`) })), disabled: disabled, onChoose: (next) => { save({ [field]: next }); } })] }));
@@ -1824,6 +1854,14 @@ window.__ModuleLoader__.load({
 			                this.#set(undefined);
 			        });
 			    }
+			    /**
+			     * Clear the previous Host value and discard reads still in flight, keeping subscribers.
+			     * 清除旧宿主值并丢弃未完成的读取，同时保留订阅。
+			     */
+			    reset() {
+			        ++this.#generation;
+			        this.#set(undefined);
+			    }
 			    /** Stop publishing answers that are still in flight. */
 			    close() {
 			        ++this.#generation;

package/node_modules/@openvulcan/dsh-decision-guard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openvulcan/dsh-decision-guard",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "Vulcan Decision permission guard for DeepSeek Harness: every tool call is judged before it runs.",
   "license": "MIT",
   "icon": "./assets/decision-guard-icon.png",
@@ -44,7 +44,7 @@
     }
   },
   "dependencies": {
-    "@openvulcan/vulcan-decision": "0.4.3"
+    "@openvulcan/vulcan-decision": "0.4.4"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5",

package/node_modules/@openvulcan/dsh-vulcan-account/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openvulcan/dsh-vulcan-account",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "OpenVulcan account for DeepSeek Harness: sign in once, used by every VulcanCode plugin.",
   "license": "MIT",
   "icon": "./assets/account-icon.png",
@@ -42,7 +42,7 @@
     }
   },
   "dependencies": {
-    "@openvulcan/openvulcan-account": "0.4.3"
+    "@openvulcan/openvulcan-account": "0.4.4"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5",