@chengxianglibra/dsh-data-analysis 0.1.2 → 0.2.1

package/skills/dsh-data-analysis-presentation/references/interaction.md

@@ -8,7 +8,7 @@
 
 ## 声明
 
-Draft schemaVersion 1、Document schemaVersion 2 均支持以下可选字段：
+Draft schemaVersion 2、Document schemaVersion 3 均支持以下可选字段：
 
 ```typescript
 interaction?: {

package/skills/dsh-data-analysis-presentation/references/narrative.md

@@ -24,7 +24,7 @@ Top N、过滤或预聚合必须说明选取规则、排序方向与覆盖范围
 
 先给已经得到的主要结论，再放最能支撑它的数据和比较。结论尚未成立时说明现有证据和缺口，不用图形复杂度替代分析。
 
-正文使用 markdown，关键单值用 metric，变化或比较用 line/bar，需要核对原值时用 table。来源面板提供精确 Artifact 和公开事实；只为当前问题读取必要 Finding，不强制遍历整个 SessionGraph。
+正文使用 markdown，关键单值用 metric，变化或比较用 line/bar，需要核对原值时用 table。各图表、表格和指标的数据源入口提供精确 Artifact 和公开事实，报告末尾默认不再添加独立的数据源段落或 `source` block；用户明确要求独立来源面板时再添加。保留 dataset 的来源声明与关联；只为当前问题读取必要 Finding，不强制遍历整个 SessionGraph。
 
 ## 看板
 

package/skills/dsh-data-analysis-presentation/references/publishing.md

@@ -0,0 +1,3 @@
+# 发布报告链接
+
+当用户明确要求发布到对象存储且实时工具中存在 `marivo_publish_report` 时，用已保存 receipt 的 `report_id` 和 `build_id` 调用。成功后返回工具确认的 URL；凭据缺失时引导用户到“数据源与凭证 → 报告发布凭证”配置，不索取或传递密钥。上传结果未确认不宣称成功；可重试同一保存版本。开启发布时，在线报告菜单将完整报告和当前视图的 HTML 下载替换为上传；当前筛选视图由用户在阅读器发布，不通过 Tool 猜测。

package/skills/dsh-data-analysis-presentation/references/schema.md

@@ -1,10 +1,14 @@
 # 草稿 schema 与文件边界
 
-这是插件的 presentation v1 写入契约。所有对象只接受列出的字段；不要把生成文档或 receipt 当作草稿。Marivo 的分析 API 与 semantic schema 以 bound Runtime 的 Skill 和 live Help 为准。
+这是插件的 Draft v2 写入契约。所有对象只接受列出的字段；不要把生成文档或 receipt 当作草稿。Marivo 的分析 API 与 semantic schema 以 bound Runtime 的 Skill 和 live Help 为准。
+
+## 报告语言与版本
+
+报告展示语言由 Draft 的 `locale` 决定，Document 使用 `schemaVersion: 3` 并原样保留语言。系统语言仅控制插件操作界面。保存、重开、打印和离线 HTML 均保持报告语言；用户要求改语言时更新完整 Draft，并按既有并发保存契约生成新 Build。旧 Draft v1、Document v2 或缺少语言的报告不受支持，必须重新生成；不修改已有不可变 Build。
 
 ## 顶层与引用
 
-顶层必须有 `schemaVersion: 1`、非空 `title`、`datasets`、`sources`、`blocks`。即使没有 dataset 或来源，也保留空数组；至少一个 block。datasets、sources、blocks 各自的 `id` 不重复，所有引用必须存在。
+顶层必须有 `schemaVersion: 2`、`locale: "zh-CN" | "en-US"`、非空 `title`、`datasets`、`sources`、`blocks`。即使没有 dataset 或来源，也保留空数组；至少一个 block。datasets、sources、blocks 各自的 `id` 不重复，所有引用必须存在。
 
 | 对象 | 必填字段 | 可选字段 |
 | --- | --- | --- |
@@ -16,6 +20,26 @@
 
 `draft_path` 与 computed 的 `path` 均相对于当前绑定 Workspace 根目录，**不是相对于草稿文件目录**。使用根目录内的 JSON 文件；不使用绝对路径、`..`、`.` 路径段、反斜杠、空路径段或通向 Workspace 外的符号链接。不从其他项目、解释器或数据源补齐失败的引用。
 
+## 从报告 cell 引用继续
+
+Ask DSH 与离线复制提供所属 Workspace、Report ID、实际显示的 Build ID、Cell ID，以及
+相对于该 Workspace 的固定 Build `presentation.json` 路径。先用普通文件读取该路径，核对身份，
+再按 `blocks[].id` 定位 cell；正文、数据、单位、精确值、比较和来源限制均从文件读取，不依赖旧对话。
+`Workspace`、`Cell` 和 `Prepared view` 的字段值使用 JSON 字符串编码；先按 JSON 解码再精确匹配，
+保留 ID 中的换行、引号和反斜杠，不取首行、不做 trim。`Report title` 仅为辅助标题，不参与身份匹配。
+文件较长时按读取工具的分页提示继续；单行被截断时使用已有 Workspace 文件能力定向读取 JSON 字段，
+不将截断内容当成完整文档。路径属于原 Workspace，单独分享 HTML 不授予访问原文件的能力。
+
+引用的 Filters 按 filter ID 与 option ID 匹配该 Build 的 `interaction.slices`，从对应 dataset 的
+`rowIndices` 取已有数据。Prepared view 按目标 chart 的 `preparedViews[].id` 读取；若附有
+Current chart view override，则替换显示配置，再应用 Hidden series。Table sort 只改变显示顺序；
+表格引用包含全部筛选结果，不限当前分页。未附覆盖时沿用保存配置。这些均为临时显示状态，不能宣称已保存。
+
+解释时以引用 Build 为准，不能静默换成 current。修改时还需按下面的报告更新契约读取 current，
+比较引用与当前内容，保留已有编辑；有歧义时澄清具体修改目标，不能只替换 expected ID 重试。
+临时探索状态只有在用户要求保存或据此修改时才进入修改范围。目标 Workspace 或文件不可访问时明确说明，
+不猜测其他报告、不通过重新查询或执行分析补齐。
+
 ## 报告更新
 
 新建报告调用 `marivo_present({ draft_path })`。修改已有报告时使用：
@@ -39,6 +63,9 @@ marivo_present({ draft_path, report_id, expected_build_id })
 再以该已读取版本提交；不能只替换 expected ID 重试。响应丢失时也先读取 current 核对内容，避免重复提交。
 已有 Report 之间不自动合并，历史 Build 不覆盖或清理。
 
+用户可在宿主阅读器编辑呈现并保存同一报告，支持 cell 移动、删除（可删空）及撤销。读取当前保存内容
+后保留用户需要的编辑；固定 Build 链接与离线 HTML 保留原快照。筛选选择只是临时展示，不进入保存或下载。
+
 ## 生成代码
 
 `marivo_python` 成功执行后自动保存该次提交的 Python 原文，并在结果中返回 `codeRef: {executionId, sha256}`。

package/lib/types/client/presentation/install.d.ts

@@ -1,15 +0,0 @@
-export declare function PresentationCards({ matched, sessionId, workspaces, model }: {
-    matched: any;
-    sessionId: any;
-    workspaces: any;
-    model: any;
-}): import("react").JSX.Element | null;
-export declare function PresentationOverlay({ model, sessionId, workspaceId, workspaceUnavailable, openSemanticObject, onAskDsh, }: {
-    model: any;
-    sessionId: any;
-    workspaceId: any;
-    workspaceUnavailable?: boolean | undefined;
-    openSemanticObject: any;
-    onAskDsh: any;
-}): import("react").JSX.Element | null;
-export declare function installPresentation(ctx: any, rpc: any, openSemanticObject: any): void;