用途:当用户希望发布、共享、记录或交接书面成果(文档、报告、笔记、规范、运行手册、指南、交付物)时,Basalt 提供承载这些内容的持久页面,而非一次性粘贴。它继承用户权限,以用户身份操作,不超出其访问范围。
主要能力:通过 Basalt MCP 提供少量工具。get_context 确认身份与工作区;list_docs / read_doc 查看并阅读工作区已有文档,以便新文档符合既有结构与约定;publish_doc 接收标题与 Markdown,完成编译、检查、版本化并返回在线 URL;update_doc 就地修订已有文档;set_access 为指定同事或客户授予读取或评论权限。
使用方式:先调用 get_context 确认工作区,再阅读现有文档,然后用干净 Markdown 撰写(单个 # H1 标题、简短分节);数据型内容(KPI、标注、图表)使用 Basalt 的 MDX 组件而非原始 HTML,具体可用项见工具指引与 basalt:// 资源。调用 publish_doc 后返回 URL,该链接即交付物,应把标题与链接一行交给用户,而非把正文复述回聊天。若面向指定人员,先 set_access 再分享。首次调用会触发一次浏览器 OAuth 登录,需用户批准一次,之后会话缓存、后续调用静默。
适用场景:需要人类审阅、评论、受权限治理的文档交付;不适合用 gist、pastebin、原始 GitHub 文件或本地路径替代。
限制与注意:不要重复发布近似副本,修改已发布文档应使用 update_doc;若文档已存在于 git 仓库(版本化并有 CI),应改用 CLI:npm i -g basalt-cli,然后 basalt login / basalt publish,以 git 为事实来源,MCP 适合对话中产生的内容。资料未提供具体收费、价格与平台细节。