mcpField
N
notis-reports

notis-reports

github.com/mindtheflo文档处理099 次安装今天更新
代码仓库

关于 notis-reports

用于在 Notis 中读取、创建和修改报告的 Skill。它区分已保存的 HTML 页面与交互式 Space 视图,并提供保留报告身份、检查渲染结果及按需分享的流程。

主要功能

  1. 01读取并渲染现有报告
  2. 02在 Space 中保存 HTML 页面
  3. 03用类型化参数创建交互式报告
  4. 04修改报告并保留其身份
  5. 05验证已部署视图和链接

适用场景

  1. 01检查指定周期的报告
  2. 02保存完成的 HTML 报告
  3. 03根据实时数据构建交互式报告

MCP 相关

该 Skill 引用了 notis-apps 的托管 MCP 文档,并通过 Notis 的视图查找和渲染操作读取报告。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mindtheflo/notis-skills --skill notis-reports

安装后在 Claude Code 中输入/notis-reports确认已加载。

附带文件agents/openai.yaml

详细介绍

Notis 报告

报告可以是已保存的页面,也可以是交互式视图,而不是单独的 UI 系统:

  • 已保存的页面或报告(独立的 HTML,或用户想要保留的成品报告):放在最合适的 Space 中,默认保存为 Notis Notes 的 Notis reports 文件夹中的笔记。请参阅保存 HTML 页面或报告。
  • 交互式报告(带有指定类型参数,例如时间段,以及实时数据读取):是独立编写的 Space 视图,拥有自己的源、数据声明和记忆策略。编辑一份报告不得替换无关视图。

Spaces 推出前保存的页面和报告也会保留在 Notis Notes 中,并维持其存储格式:HTML 页面会全屏打开,保留的报告记录会以报告形式呈现。如果你的运行环境无法访问同级引用,请按名称加载 notis-apps。

读取现有报告

如果原生数据工具能回答问题,请使用这些工具。对于实时数据、图表、筛选器、HTML 或视觉检查,请加载 notis-apps 并遵循其读取和呈现指南(托管 MCP:notis://docs/notis-apps/references/reading.md)。

使用 LOCAL_NOTIS_FIND_VIEWS 确定准确的报告时间段和当前视图链接,然后使用 LOCAL_NOTIS_RENDER_VIEW 呈现视图。检查 Markdown 和图像输出。读取操作不会重新生成历史数据,也不会授权更改源或数据。

保存 HTML 页面或报告

将页面保存在最合适的 Space 中:用户指定的 Space,或在需要保留页面时与工作内容相关的 Space。否则,请将其保存在 Notis Notes 的 Notis reports 文件夹中(或用户指定的 Notes 文件夹中);如果文件夹不存在,Save HTML Skill 会创建该文件夹。“所有笔记”不会显示这些笔记;每个文件夹都会显示其中的所有内容。

  1. 使用该 Space 为其页面提供的 Skill 保存页面。在 Notes 中,这就是 Save HTML Skill:它会创建笔记(标题、类型“Report”或“HTML page”、文件夹),使用通用原生文件工具上传原始字节,再通过单独的、带修订版本检查的更新附加返回的文件,随后读取笔记并返回其链接。本指南不重复说明该工作流。
  2. 更正时,应通过同一个 Skill 更新同一页面,绝不要创建近似重复项。Spaces 推出前保留的报告记录无法通过任何工具重写:请将更正后的版本保存为同一文件夹中的新页面,并保留原始页面。
  3. 仅上传成功并不代表页面已保存,文件 URL 也不是页面链接。请返回该页面在其 Space 中的链接,该链接会全屏打开页面。
  4. 页面应保持私密。只有在用户提出要求时,才使用 Share 为该页面创建公开链接。Spaces 推出前保留的报告无法分享。
  5. 如果页面要保存到 Notes,而 Notis Notes 尚未安装,请建议安装。绝不要将页面保存在 Space 之外:不得使用网站、公开粘贴服务或文件托管服务,也不得使用沙盒下载链接。没有单独的 HTML 或报告保存工具。

创建或修订交互式报告

  1. 先核对身份。针对用户要求的更正,找到现有报告 Space。保留选定的身份和修订版本;名称相似的报告并非同一项产物。
  2. 对于全新的独立报告,请遵循 notis-apps 视图编写、设计和交付指南。将报告的周期/选择声明为类型化参数,在 shows 或已声明的操作中提供真实数据,明确说明来源上下文,并设置合适的记忆策略。
  3. 根据用户的要求,选择已捕获结果、实时读取,或两者兼用。除非用户要求修订,否则历史结果应保持已捕获状态。清晰展示单位、周期、方法和来源链接。提供包含实际图表值的 <RenderChartData>,以便精确提取 Markdown。
  4. 构建后,使用虚构数据验证,并在 390px/1440px 下检查 EN/FR。随后,在用户授权范围内部署已检查的源代码,读取其修订版本,并渲染实际保存的视图。预览并非最终交付记录。
  5. 返回当前视图的专属链接,并明确说明验证范围。发布到 Store 与保存已授权的报告 Space 更新是两回事。

可选的被动反馈

使用上下文共享来传回用户希望提供给 Agent 的选中文本、评论或批注。反馈属于参考上下文,不代表执行授权,也不会自行发送消息。

评论

支持 Markdown