v0.2.3

更新内容

• 新增公开集成入口 ./integration（dsh-data-analysis-integration/v1），支持 Workspace 绑定回调、Harness 管理的 datasource CredentialStore，以及经当前 Runtime schema 校验的受管 credential 引用名。
• 新增 ./client-composition，供组合方按需使用浏览器 apply、inject 和 RPC helper；原有 ./client 入口及普通 apply 保留默认行为。
• 增加 existingOnly Runtime 校验模式，只验证现有安装；Runtime 缺失或无效时明确失败，不创建安装目录或锁。
• Workspace 初始化回调失败会拒绝该次绑定并允许重试，不会污染其他 Workspace 的绑定。

兼容性

• Node.js：^22.19.0 || >=24.0.0。
• DeepSeek Harness：>=0.1.7-rc.1。
• Marivo：0.5.5。

验证范围

本地 npm run check、构建、分发包验证和 npm tarball dry-run 均通过。外部扩展的完整真实 Harness 生命周期验收不属于本次验证范围。

v0.2.2

更新内容

• 适配 DeepSeek Harness 0.1.7 的插件接入与原生文件交付：生成的 CSV、PNG 继续通过原生 present 交付；已有 CSV、TSV、XLSX 可打开 Harness 的只读表格预览。
• 延长报告来源读取的受控超时，并补充超时诊断；来源失败或取消时不会创建新的报告 Build 或更新当前报告。
• 报告阅读器在内网 HTTP 环境下也执行文件摘要校验；摘要不一致仍拒绝读取和下载。
• 更新中英文安装说明与兼容性声明。

兼容性

• Node.js：^22.19.0 || >=24.0.0。
• DeepSeek Harness：>=0.1.7-rc.1；本次原生表格预览验收覆盖 0.1.7-rc.1 与 0.1.7-rc.2。
• Marivo：0.5.5。

验证范围

发布流程检查代码质量、类型、测试、构建与分发内容，并通过 GitHub Actions OIDC 发布 npm 包。真实环境与模型验收范围见仓库 docs/validation.md；更高版本 Harness、后台长任务、XLSX 写入及旧 .xls 分析不在本次验收范围。

0.2.1

更新内容

• 修复数据源操作失败、取消或删除凭据后可能导致面板崩溃的问题。
• 在 Harness 插件设置中提供 Python 默认超时配置，执行时读取最新设置；统一设置卡片样式，并在保存失败或冲突时保留编辑内容。
• 明确普通问答、文件分析与报告交付的路由和职责；短文件对比也遵循文件 Skill，强化输入身份检查和交付指引。
• 优先复用已有业务语义，仅在任务需要或用户授权的范围内补齐定义，完成后回到原始问题。
• 更新功能说明，新增中英文 README，npm 包同时包含两种语言版本。

兼容性

• Node.js：^22.19.0 || >=24.0.0。
• DeepSeek Harness：>=0.1.5-rc.1。
• Marivo：0.5.5。

验证范围

发布流程检查代码质量、类型、测试、构建与分发内容，并通过 GitHub Actions OIDC 发布 npm 包。真实模型验收记录见仓库 docs/validation.md；原生 CSV 预览与授权语义对象创建未纳入本次已通过的验收范围。

v0.2.0

主要变化

• 数据源、语义层和报告统一使用 Harness 原生右侧标签页，支持 Workspace 快捷入口、报告目录、历史版本及后台更新提示。
• 支持在分析过程中打开数据源配置页，保存并测试成功后继续；完善连接配置、创建默认值、凭据管理及删除流程。
• 支持将语义对象和报告 Cell 加入提问，保留固定 Build 与阅读上下文；完善中文搜索、语义关系和诊断展示。
• 新增本地文件分析 Skill，使用 pandas 或 DuckDB 分析附件和 Workspace 文件，并通过 Harness 原生 present 交付普通分析文件。
• 报告支持完整 HTML、当前视图导出及可配置的 S3 兼容对象存储发布；新增 marivo_export_html 工具，可将已保存报告导出为自包含 HTML 文件。
• 改善 Python 执行卡片、报告来源展示、图表选项、KPI 数字格式及安装卸载可靠性，修复凭据监听拖慢报告读取的问题。

升级说明

• DeepSeek Harness 最低版本提升至 0.1.5-rc.1；兼容范围为 >=0.1.5-rc.1，实际开发与 Web 验收基线为 rc.1。
• Node.js 要求 ^22.19.0 || >=24.0.0；Marivo 固定为 0.5.5，默认安装包含 duckdb、trino 和 clickhouse extras。
• 首次启动使用本机 Python 创建独立虚拟环境；需 Python 3.10+ 及 venv/ensurepip。
• 插件界面跟随 Harness 语言；报告 locale 独立保存在报告中。报告 Draft v2 与 Document v3 必须声明 locale（zh-CN 或 en-US）；旧格式或缺少 locale 的报告需重新生成，历史 Build 不会被自动修改或删除。
• 报告默认保存 JSON，按需生成 HTML；新报告在右侧标签页打开，聊天中不再附加旧报告 block。升级后刷新浏览器页面以加载新客户端。

安装

dsh plugin --profile web add @chengxianglibra/dsh-data-analysis@0.2.0

详细用法与验证边界见仓库 README 和 docs/validation.md。

验证

本地 Node.js 22.19.0 下完成 npm run check（663 项通过、4 项因既有运行前提跳过）、构建、包内容验证及 npm 发布 dry-run。真实环境验收范围见 docs/validation.md。

0.1.2

0.1.2

本版将分析展示统一为可编辑报告与自包含 HTML，新增语义对象浏览和引用输入，完善数据源创建、凭据管理与单次 Python 执行。

新增

• marivo_present 从 Draft 生成报告、JSON 和离线 HTML，并在对话中提供打开、下载入口。共享 reader 支持 Markdown、精确数值表格、18 类图表、KPI 比较卡片及作者声明的全局筛选；图表探索和筛选使用已有数据。
• 报告支持在线编辑、移动和删除内容、撤销／重做，以及同一 Report 的新 build 保存。Agent 可通过 report_id 与 expected_build_id 更新已有报告；并发版本冲突明确报错。
• 在线报告的 Ask DSH 将当前内容、图表探索与筛选上下文追加到原会话草稿，保留已有文字、引用和附件，不自动发送。离线 HTML 提供复制上下文。
• 会话标题旁提供“语义层”和“数据源与凭证”。语义层支持分类搜索、定义详情、关系浏览及报告来源跳转，仅读取 Catalog 元数据；输入框支持通过 @ 选择精确语义引用。
• 数据源管理支持从当前 Marivo 公开配置创建数据源、查看连接属性、配置凭据和测试连接。marivo_python 在本次调用中完成凭据准备与执行；Web 补齐凭据并测试成功后可继续原调用。
• 新增 dsh-data-analysis-presentation Skill、Python write_dataset helper 和 dsh-data-analysis-presentation-lint 静态预检命令。computed 数据可使用独立展示标签，并保留 int64／Decimal 精度。

修复与改进

• 完成后的报告卡片保持在最终回复旁；重新打开原卡片可读取同一报告最近保存的结果。
• 改进宽屏、窄屏、KPI 排列和图表布局；HTML 支持离线交互、无脚本阅读和打印。
• 来源页面展示保存的 Python／SQL 代码与精确数据，支持格式化和高亮；明确区分历史来源快照与当前语义定义。
• 数据集写入及 int64 校验错误提供字段、位置、原因和修复提示；数据源创建保留非法凭据引用的具体诊断。
• 共享 Runtime 校验随包 presentation-kit 的实际版本，避免插件更新后继续复用旧 helper。

兼容性与升级

• 要求 Node.js 24+、DeepSeek Harness 0.1.1-rc.2；Marivo 精确升级为 0.5.4，安装约束为 marivo[duckdb,trino,clickhouse]==0.5.4。随包 presentation-kit 为 1.1.0，Runtime marker 为 dsh-data-analysis-runtime/v3。
• 插件管理的旧 Runtime 会先保留诊断备份，再按新版本要求重建；使用自定义 pythonExecutable 时，管理员须安装匹配的 Marivo 与随包 presentation-kit，否则启动会明确报错。
• 展示接口有破坏性变化：移除旧 report-kit、dsh-data-analysis-report Skill、经典 JavaScript 资源、marivo_report_render、marivo_evidence_sources 与 ./evidence export。新展示使用 dsh-data-analysis-presentation 和 marivo_present；需要读取 Evidence 时使用 Marivo 公共 API。
• 执行接口有破坏性变化：移除 marivo_datasource_access 及跨调用 Shell lease 接口。依赖旧 prelude 的分析调用应改为 marivo_python({ code, datasources })，声明本次执行访问的全部精确数据源名称。
• 生成文档、receipt 和 delivery 使用 schema v2；Draft 与 typed dataset 保持 v1。旧报告不读取、不自动迁移，旧文件保留；需使用新 Draft 重新生成。已生成 HTML 保留生成时的内容与样式。

dsh-data-analysis 0.1.1

主要变化

• 首次通过 npm 公开发布个人维护的 DeepSeek Harness 社区插件。
• 收窄插件能力为 Runtime/Workspace、实时 Help、Datasource Credentials、Evidence 来源与 Agent-native 报告 primitives。
• 随包交付 dsh-data-analysis-report Skill、report-kit wheel 和 Marivo reader components。
• 明确兼容 DSH 0.1.1-rc.2 与 Marivo 0.5.3。
• 采用 MIT License。

安装

npm install @chengxianglibra/dsh-data-analysis@0.1.1

npm: https://www.npmjs.com/package/@chengxianglibra/dsh-data-analysis/v/0.1.1

SHA-256: 626c01053a57ed9f63f9cb28e8ab22096e8df6e97b5a34b93470f2aa3ceeea13

v0.1.0

dsh-data-analysis 首个稳定版本。

主要能力：

• Web profile 共享受管 Marivo Runtime，并保留逐 Workspace 的独立绑定与状态
• skill 激活后披露 Marivo 实时 Help
• 通过 DSH Credentials 安全解析 datasource 凭证，支持标准 Shell 的单次环境注入
• 提供 Marivo Evidence 精确引用与 Web 来源卡片
• 支持 native、code 和 both 工具模式

安装包：deepseek-ai-dsh-data-analysis-0.1.0.tgz
SHA-256：2e5dc8ed44ed78c17e0093797d9ab0d7df7840c6cd8d067aebd9256487dcaf99