@chengxianglibra/dsh-data-analysis 0.2.1 → 0.2.3

package/README.en.md

@@ -26,7 +26,7 @@ This is an independently maintained community plugin. It is not an official Deep
 ### Prerequisites
 
 - Node.js `^22.19.0 || >=24.0.0`: version 22.19.0 or later in the 22.x series, or version 24.0.0 and above. Version 23.x is not supported.
-- DeepSeek Harness `>=0.1.5-rc.1`, installed and configured.
+- DeepSeek Harness `>=0.1.7-rc.1`, launched with `npx @deepseek-ai/dsh web` and configured.
 - `pnpm` available on the command line for Harness to install the plugin.
 - Python 3.10+, available as `python3` (`python` on Windows), with `venv`/`ensurepip` support. Some Linux distributions require the additional `python3-venv` package.
 
@@ -35,16 +35,18 @@ An internet connection is required to download dependencies; wait for setup to f
 
 ### Install and launch
 
+The commands below run Harness through `npx`; no global installation or `dsh` command on PATH is required.
+
 Install the plugin into the Web Profile:
 
 ```bash
-dsh plugin --profile web add @chengxianglibra/dsh-data-analysis
+npx @deepseek-ai/dsh plugin --profile web add @chengxianglibra/dsh-data-analysis
 ```
 
 Start the Web Profile after installation. If it is already running, exit and restart it:
 
 ```bash
-dsh --profile web
+npx @deepseek-ai/dsh web
 ```
 
 In the Web interface, select a Workspace, create a session, and send a message.
@@ -59,6 +61,7 @@ The examples below use the Web interface; Chinese labels are included to help yo
 No data source configuration or business definitions are required first.
 CSV, JSON, Parquet, and Excel `.xlsx` files are supported. Reading `.xlsx` for the first time requires an internet connection to download an extension.
 Convert older `.xls` files to `.xlsx`, CSV, or Parquet first.
+To view or deliver a CSV, TSV, or XLSX file, ask the assistant to use native `present`, then open the read-only DSH spreadsheet preview on the right. Tables with report filtering and linked interactions remain in the report reader. The plugin does not write XLSX or analyze older `.xls` files.
 
 **Databases**: Open Data Sources (数据源) beside the session title to view connections and their configuration status in the current workspace:
 

package/README.md

@@ -26,7 +26,7 @@
 ### 环境准备
 
 - Node.js `^22.19.0 || >=24.0.0`：22.x 需至少 22.19.0，或使用 24.0.0 及以上版本；不支持 23.x。
-- 已安装并配置好 DeepSeek Harness `>=0.1.5-rc.1`。
+- 已通过 `npx @deepseek-ai/dsh web` 启动并配置好 DeepSeek Harness `>=0.1.7-rc.1`。
 - 命令行中可使用 `pnpm`，供 Harness 安装插件。
 - Python 3.10+，命令行可运行 `python3`（Windows 为 `python`），且支持 `venv`/`ensurepip`；部分 Linux 发行版需额外安装 `python3-venv`。
 
@@ -34,16 +34,18 @@
 
 ### 安装并启动
 
+以下命令均通过 `npx` 运行 Harness，无需全局安装或将 `dsh` 添加到 PATH。
+
 将插件安装到 Web Profile：
 
 ```bash
-dsh plugin --profile web add @chengxianglibra/dsh-data-analysis
+npx @deepseek-ai/dsh plugin --profile web add @chengxianglibra/dsh-data-analysis
 ```
 
 安装后启动 Web Profile；如果已在运行，请先退出再重新启动：
 
 ```bash
-dsh --profile web
+npx @deepseek-ai/dsh web
 ```
 
 在 Web 界面选择分析使用的工作区（Workspace），新建会话并发送一条消息。
@@ -56,6 +58,7 @@ dsh --profile web
 **本地文件**：上传文件后直接提问，或指定工作区中已有文件，无需先配置数据源或建立业务定义。
 支持 CSV、JSON、Parquet 和 Excel `.xlsx`；首次读取 `.xlsx` 需要联网下载扩展。
 旧版 `.xls` 请先转换为 `.xlsx`、CSV 或 Parquet。
+需要查看或交付 CSV、TSV、XLSX 文件时，可让助手通过原生 `present` 交付，随后在右侧打开 DSH 的只读表格预览；报告中可筛选联动的表格仍使用报告阅读器。插件不提供 XLSX 写入或旧 `.xls` 分析。
 
 **数据库**：在会话标题旁打开“数据源”，查看当前工作区的连接与配置状态：
 

package/lib/client/credentials/create-datasource.js

@@ -14,7 +14,7 @@ function credentialLabel(field) {
         http_headers_env: 'marivo.credentials.header-credential-value',
     }[field] ?? field.replace(/_env$/, ''));
 }
-function credentialRows(schema, backend, values = {}) {
+function credentialRows(schema, backend, values = schema.creationDefaults?.[backend] ?? {}) {
     return (schema.backends.find((item) => item.name === backend)?.fields ?? [])
         .filter((field) => field.name.endsWith('_env'))
         .flatMap((field) => field.type === 'json'

package/lib/client/credentials/install.js

@@ -307,7 +307,7 @@ export function installCredentials(ctx, rpc, changes) {
                 : t('marivo.credentials.awaiting-credentials'), type: "button", onClick: () => model.openRequest(request.id), children: t('marivo.credentials.configuration-needed') })) : null;
     })));
     ctx.slots.inject('shell.overlay', () => ctx.slots.register({ locale: 'marivo.navigation', name: 'shell.overlay', id: 'marivo-credential-observer' }, localized(ctx, function Observer({ useSessions, useWorkspaces }) {
-        const sessionId = useSessions((state) => state.current) ?? '';
+        const sessionId = useSessions((state) => state.ids.find((id) => state.byId[id]?.retainedBy.mainView)) ?? '';
         const workspaces = useWorkspaces((state) => state.items);
         const currentWorkspace = workspaces.find((item) => item.sessionIds.includes(sessionId))?.workspaceId ?? '';
         useEffect(() => model.session(sessionId), [sessionId]);

package/lib/client/input-context.js

@@ -3,7 +3,7 @@ export function ownedInput(host, sessionId, workspaceId) {
     const owners = workspaces.items.filter((item) => item.sessionIds.includes(sessionId));
     if (!sessionId ||
         !workspaceId ||
-        host.sessions.list.getSnapshot().current !== sessionId ||
+        !host.sessions.list.getSnapshot().byId[sessionId]?.retainedBy.mainView ||
         workspaces.phase !== 'ready' ||
         workspaces.state === 'error' ||
         owners.length !== 1 ||

package/lib/client/python-tool/card.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { CodeBlock, DisclosureRow, IconCodeOutline16, writeClipboard, } from '@deepseek-ai/dsh-client-ui-primitives';
+import { CodeBlock, DisclosureRow, IconCodeOutlineRegular, writeClipboard, } from '@deepseek-ai/dsh-client-ui-primitives';
 import { useMemo, useState } from 'react';
 import { useCopy } from "../i18n/context.js";
 import { pythonToolModel } from "./model.js";
@@ -29,7 +29,7 @@ export function PythonToolCard({ block, inspect }) {
         const ok = await writeClipboard(code).catch(() => false);
         setCopy({ code, ok });
     };
-    return (_jsxs("div", { className: "mp-tool", "data-state": model.state, children: [_jsx("style", { children: styles }), _jsx(DisclosureRow, { icon: _jsx(IconCodeOutline16, {}), title: "marivo_python", open: open, expandable: true, expandOnRowClick: true, keepContentWhenOpen: true, onToggle: () => setOpen((value) => !value), collapsedContent: _jsxs(_Fragment, { children: [_jsx("span", { className: "mp-summary", children: model.summary }), _jsx("span", { className: "mp-state", children: t(`marivo.python.${model.state}`) })] }), children: open && (_jsxs("div", { className: "mp-body", children: [_jsxs("section", { "aria-label": t('marivo.python.input'), children: [_jsxs("div", { className: "mp-input-heading", children: [_jsx("h4", { children: t('marivo.python.input') }), model.code !== undefined && (_jsx("button", { type: "button", className: "mp-inspect", onClick: () => void copySource(), children: t(copy?.code === model.code && copy.ok
+    return (_jsxs("div", { className: "mp-tool", "data-state": model.state, children: [_jsx("style", { children: styles }), _jsx(DisclosureRow, { icon: _jsx(IconCodeOutlineRegular, { size: 16 }), title: "marivo_python", open: open, expandable: true, expandOnRowClick: true, keepContentWhenOpen: true, onToggle: () => setOpen((value) => !value), collapsedContent: _jsxs(_Fragment, { children: [_jsx("span", { className: "mp-summary", children: model.summary }), _jsx("span", { className: "mp-state", children: t(`marivo.python.${model.state}`) })] }), children: open && (_jsxs("div", { className: "mp-body", children: [_jsxs("section", { "aria-label": t('marivo.python.input'), children: [_jsxs("div", { className: "mp-input-heading", children: [_jsx("h4", { children: t('marivo.python.input') }), model.code !== undefined && (_jsx("button", { type: "button", className: "mp-inspect", onClick: () => void copySource(), children: t(copy?.code === model.code && copy.ok
                                                 ? 'marivo.python.copied'
                                                 : 'marivo.python.copy') }))] }), copy && copy.code === model.code && !copy.ok && (_jsx("p", { role: "status", className: "mp-notice", children: t('marivo.python.copy-failed') })), _jsx("div", { className: "mp-scroll", children: model.code === undefined ? (_jsx("pre", { children: model.input })) : (_jsx(CodeBlock, { code: `${model.code}\n`, lang: "python", className: "mp-code", copyLabel: t('marivo.python.copy'), copiedLabel: t('marivo.python.copied') })) })] }), _jsxs("dl", { className: "mp-facts", children: [model.datasources !== undefined && (_jsxs("div", { children: [_jsx("dt", { children: "datasources" }), _jsx("dd", { children: JSON.stringify(model.datasources) })] })), model.timeoutMs !== undefined && (_jsxs("div", { children: [_jsx("dt", { children: "timeoutMs" }), _jsxs("dd", { children: [model.timeoutMs, " ms"] })] })), model.facts.map(({ name, value }) => (_jsxs("div", { children: [_jsx("dt", { children: name }), _jsx("dd", { children: value })] }, name)))] }), model.notices.map((notice) => (_jsx("p", { className: "mp-notice", children: notice }, notice))), model.facts.some((fact) => fact.name === 'truncated' && fact.value === 'true') && (_jsx("p", { className: "mp-notice", children: t('marivo.python.truncated') })), ['stdout', 'stderr'].map((name) => model[name] === undefined ? null : (_jsxs("section", { "aria-label": name, children: [_jsx("h4", { children: name }), _jsx("pre", { className: "mp-scroll", children: model[name] })] }, name))), model.fallback !== undefined && (_jsxs("section", { "aria-label": t('marivo.python.output'), children: [_jsx("h4", { children: t('marivo.python.output') }), _jsx("pre", { className: "mp-scroll", children: model.fallback })] })), _jsxs("details", { children: [_jsx("summary", { children: t('marivo.python.raw') }), _jsx("h4", { children: t('marivo.python.input') }), _jsx("pre", { className: "mp-scroll", children: model.input }), model.output !== undefined && (_jsxs(_Fragment, { children: [_jsx("h4", { children: t('marivo.python.output') }), _jsx("pre", { className: "mp-scroll", children: model.output })] }))] }), inspect && (_jsx("div", { children: _jsx("button", { type: "button", className: "mp-inspect", onClick: inspect, children: t('marivo.python.inspect') }) }))] })) })] }));
 }

package/lib/client/python-tool/model.js

@@ -15,7 +15,7 @@ function parse(text) {
 /** Read only the frozen Harness call; never fetch results or infer execution from settlement. */
 export function pythonToolModel(block) {
     const done = 'kind' in block;
-    const input = (done ? block.call?.argsRaw : block.argsRaw) ?? '';
+    const input = (done ? block.call?.argsRaw : block.phase === 'start' ? block.argsRaw : undefined) ?? '';
     const args = parse(input);
     const code = typeof args?.code === 'string' ? args.code : undefined;
     const output = done

package/lib/client/right-tabs/install.js

@@ -31,6 +31,7 @@ export const inject = [
     'conversation',
     'sidebarRight',
     'sidebarRightTabs',
+    'uiWorkspace',
 ];
 const labels = workspaceDirectories;
 /** Default browser integration. Layout belongs to Harness; mutable content belongs to occurrences. */
@@ -78,7 +79,7 @@ export function installRightTabs(ctx, { diagnostics = false } = {}) {
             state.phase !== 'ready' ||
             state.state === 'error' ||
             workspaceFor(sessionId) !== workspaceId ||
-            (foreground && ctx.sessions.list.getSnapshot().current !== sessionId))
+            (foreground && !ctx.sessions.list.getSnapshot().byId[sessionId]?.retainedBy.mainView))
             throw new Error('marivo.navigation.the-owning-session-or-workspace-changed-return-to-its');
     };
     const changed = (workspaceId, reportId) => {
@@ -213,7 +214,7 @@ export function installRightTabs(ctx, { diagnostics = false } = {}) {
             }),
         };
         return (_jsxs("section", { className: "rt-page", "data-rt-tab": tab.id, "data-rt-panel": panelId, "data-rt-kind": page.target.kind, "data-rt-workspace": page.target.workspaceId, "data-rt-build": report.document?.buildId, "data-rt-current": page.target.kind === 'report' && !page.target.buildId ? 'true' : undefined, children: [_jsx("style", { children: catalogStyles + credentialStyles + rightTabStyles }), state.error ? (_jsx("p", { role: "alert", children: t(state.error) })) : (_jsxs(_Fragment, { children: [page.target.kind === 'reports' && (_jsxs(_Fragment, { children: [_jsxs("div", { className: "rt-heading-row", children: [_jsx("h2", { className: "rt-heading", children: t(labels[page.target.kind]) }), page.target.kind === 'reports' && (_jsx("button", { type: "button", disabled: catalog.loading, onClick: () => void page.refresh(), children: t('marivo.presentation.refresh') }))] }), _jsx("p", { className: "rt-caption", children: workspaces.find((w) => w.workspaceId === page.target.workspaceId)?.title ??
-                                        page.target.workspaceId })] })), state.newer && (_jsxs("p", { role: "status", className: "rt-notice", children: [t('marivo.navigation.a-newer-version-exists-the-current-view-is-unchanged'), _jsx("button", { type: "button", onClick: () => void page.refresh(), children: t('marivo.navigation.view-new-version') })] })), state.notice && _jsx("p", { role: "status", children: t(state.notice) }), page.target.kind === 'reports' && (_jsx(ReportCatalogView, { model: page.catalog, reader: catalogReader, sessions: sessions, onOpenSession: (id) => ctx.sessions.open(id) })), page.target.kind === 'semantic' && (_jsx(SemanticBrowserPanel, { model: page.semantic, onAsk: canAsk ? () => page.semantic.addToQuestion(ctx, page.sessionId) : undefined, workspaces: workspaces })), page.target.kind === 'datasources' && (_jsx(CredentialPanel, { model: page.datasources, workspaces: workspaces, onRefresh: () => void page.refresh() })), page.target.kind === 'report' && (_jsxs(_Fragment, { children: [report.editing && (_jsxs("div", { className: "rt-toolbar", role: "toolbar", "aria-label": t('marivo.presentation.report-editing-actions'), children: [_jsx("button", { type: "button", disabled: report.saving || !report.editing.undo.length, onClick: () => page.reader.undoEdit(), children: t('marivo.presentation.undo') }), _jsx("button", { type: "button", disabled: report.saving || !report.editing.redo.length, onClick: () => page.reader.redoEdit(), children: t('marivo.presentation.redo') }), _jsx("button", { type: "button", disabled: report.saving, onClick: () => act(page, () => save(page, tab)), children: report.saving
+                                        page.target.workspaceId })] })), state.newer && (_jsxs("p", { role: "status", className: "rt-notice", children: [t('marivo.navigation.a-newer-version-exists-the-current-view-is-unchanged'), _jsx("button", { type: "button", onClick: () => void page.refresh(), children: t('marivo.navigation.view-new-version') })] })), state.notice && _jsx("p", { role: "status", children: t(state.notice) }), page.target.kind === 'reports' && (_jsx(ReportCatalogView, { model: page.catalog, reader: catalogReader, sessions: sessions, onOpenSession: (id) => ctx.uiWorkspace.openSession(id) })), page.target.kind === 'semantic' && (_jsx(SemanticBrowserPanel, { model: page.semantic, onAsk: canAsk ? () => page.semantic.addToQuestion(ctx, page.sessionId) : undefined, workspaces: workspaces })), page.target.kind === 'datasources' && (_jsx(CredentialPanel, { model: page.datasources, workspaces: workspaces, onRefresh: () => void page.refresh() })), page.target.kind === 'report' && (_jsxs(_Fragment, { children: [report.editing && (_jsxs("div", { className: "rt-toolbar", role: "toolbar", "aria-label": t('marivo.presentation.report-editing-actions'), children: [_jsx("button", { type: "button", disabled: report.saving || !report.editing.undo.length, onClick: () => page.reader.undoEdit(), children: t('marivo.presentation.undo') }), _jsx("button", { type: "button", disabled: report.saving || !report.editing.redo.length, onClick: () => page.reader.redoEdit(), children: t('marivo.presentation.redo') }), _jsx("button", { type: "button", disabled: report.saving, onClick: () => act(page, () => save(page, tab)), children: report.saving
                                                 ? t('marivo.presentation.saving')
                                                 : t('marivo.presentation.save-edits') }), _jsx("button", { type: "button", disabled: report.saving, onClick: () => {
                                                 if (!page.reader.dirty ||
@@ -221,7 +222,7 @@ export function installRightTabs(ctx, { diagnostics = false } = {}) {
                                                     page.reader.cancelEdit();
                                             }, children: t('marivo.presentation.cancel-edits') }), _jsx("span", { children: page.reader.dirty
                                                 ? t('marivo.presentation.unsaved-edits')
-                                                : t('marivo.presentation.edit-mode') })] })), report.editError && _jsx("p", { role: "alert", children: t(report.editError) }), report.notice && _jsx("p", { role: "status", children: t(report.notice) }), report.publicationUrl && (_jsx("p", { children: _jsx("a", { href: report.publicationUrl, target: "_blank", rel: "noopener noreferrer", children: t('marivo.presentation.open-published-report') }) })), report.loading && _jsx("p", { role: "status", children: t('marivo.navigation.loading-report') }), report.error && (_jsxs("div", { role: "alert", children: [_jsx("p", { children: t(report.error) }), _jsx("button", { type: "button", onClick: () => void page.refresh(), children: t('marivo.navigation.reload-report') })] })), report.historyOpen && (_jsx(ReportHistoryPanel, { state: report, model: historyModel, sessions: sessions, onOpenSession: (id) => ctx.sessions.open(id) })), report.document && (_jsx(HostPresentationReader, { document: report.document, closeSourceOnNavigate: true, viewMemory: page.viewMemory, exportActions: {
+                                                : t('marivo.presentation.edit-mode') })] })), report.editError && _jsx("p", { role: "alert", children: t(report.editError) }), report.notice && _jsx("p", { role: "status", children: t(report.notice) }), report.publicationUrl && (_jsx("p", { children: _jsx("a", { href: report.publicationUrl, target: "_blank", rel: "noopener noreferrer", children: t('marivo.presentation.open-published-report') }) })), report.loading && _jsx("p", { role: "status", children: t('marivo.navigation.loading-report') }), report.error && (_jsxs("div", { role: "alert", children: [_jsx("p", { children: t(report.error) }), _jsx("button", { type: "button", onClick: () => void page.refresh(), children: t('marivo.navigation.reload-report') })] })), report.historyOpen && (_jsx(ReportHistoryPanel, { state: report, model: historyModel, sessions: sessions, onOpenSession: (id) => ctx.uiWorkspace.openSession(id) })), report.document && (_jsx(HostPresentationReader, { document: report.document, closeSourceOnNavigate: true, viewMemory: page.viewMemory, exportActions: {
                                         downloadFullReport: () => void page.reader.downloadDisplayed(),
                                         publishing: report.publishingName
                                             ? {
@@ -257,7 +258,7 @@ export function installRightTabs(ctx, { diagnostics = false } = {}) {
     function Body({ sessionId, useTabInfo, useWorkspaces, useSessions }) {
         const t = useCopy();
         const { tab, panel } = useTabInfo();
-        const workspaces = useWorkspaces((s) => s.items), sessions = useSessions((s) => s.byId), currentSession = useSessions((s) => s.current), workspaceReady = useWorkspaces((s) => s.phase === 'ready' && s.state !== 'error');
+        const workspaces = useWorkspaces((s) => s.items), sessions = useSessions((s) => s.byId), currentSession = useSessions((s) => s.ids.find((id) => s.byId[id]?.retainedBy.mainView)), workspaceReady = useWorkspaces((s) => s.phase === 'ready' && s.state !== 'error');
         const [page, setPage] = useState(), [error, setError] = useState('');
         useEffect(() => {
             if (tab.signal.aborted)
@@ -383,7 +384,9 @@ export function installRightTabs(ctx, { diagnostics = false } = {}) {
     const bind = () => {
         if (!ctx.connection.generation.getSnapshot())
             return stopFeeds();
-        const current = ctx.sessions.list.getSnapshot().current;
+        const current = ctx.sessions.list
+            .getSnapshot()
+            .ids.find((id) => ctx.sessions.list.getSnapshot().byId[id]?.retainedBy.mainView);
         const workspaces = ctx.workspaces.list.getSnapshot();
         if (workspaces.phase !== 'ready' || workspaces.state === 'error')
             return stopFeeds();
@@ -414,14 +417,14 @@ export function installRightTabs(ctx, { diagnostics = false } = {}) {
                     check(id, workspaceId);
                 }
                 catch (error) {
-                    if (ctx.sessions.list.getSnapshot().current === id)
+                    if (ctx.sessions.list.getSnapshot().byId[id]?.retainedBy.mainView)
                         fail(error);
                     return;
                 }
                 changed(workspaceId, reportId);
                 // Publication invalidation is Workspace-wide. Foreground navigation
                 // alone is gated, and background deliveries are never queued.
-                if (ctx.sessions.list.getSnapshot().current !== id)
+                if (!ctx.sessions.list.getSnapshot().byId[id]?.retainedBy.mainView)
                     return;
                 try {
                     navigate(id, { kind: 'report', workspaceId, reportId, buildId }, ctx.sidebarRight, true);

package/lib/client/settings/install.js

@@ -2,9 +2,13 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { localized } from "../i18n/host.js";
 import { PythonSettingsCard } from "./card.js";
 export function installSettings(ctx) {
-    const scope = ctx.settingsScope.bind({ namespace: 'dsh-data-analysis' });
+    const scope = ctx.configForms.get('dsh-data-analysis');
     const Card = localized(ctx, PythonSettingsCard);
-    ctx.slots.inject('settings.plugin.item', () => ctx.slots.register({ name: 'settings.plugin.item', key: 'dsh-data-analysis', locale: 'marivo.settings' }, function SettingsCard() {
+    ctx.effect(() => ctx.configForms.whileServed(['dsh-data-analysis'], () => ctx.slots.inject('plugins.bundle.config', () => ctx.slots.register({
+        name: 'plugins.bundle.config',
+        key: '@chengxianglibra/dsh-data-analysis',
+        locale: 'marivo.settings',
+    }, function SettingsCard() {
         return _jsx(Card, { scope: scope });
-    }));
+    }))));
 }