dsh-tool-notion

在 Harness 里处理 Notion 内容时，常见痛点是：API 返回的是区块数组，人想读的是 Markdown；要回写又要再变回 append 能吃的结构。中间若靠在线客户端，测试难写、token 过期整链断掉。dsh-tool-notion 只做本地转换：你递区块数组或 Markdown，它在进程内完成互转，不发起网络请求。

核心能力围绕四条工具展开。notion_status 先告诉你支持的块类型、注解键、callout 映射与工作目录路径，把「不支持」变成已知边界。notion_to_md 把区块（或 blocksJson 形式的 API 响应）转成 Notion 风格的 Markdown，遇到无法表示的结构会显式报告。notion_to_blocks 把 Markdown 转成可直接用于 Notion append 的区块数组。notion_validate 不转换，只检查结构错误、未知块类型、空 run 以及 callout 无法回读等会静默丢信息的问题，判断的是能否安全往返，而非 Notion 官方意义上的合法性。

实现上它认真处理了富文本 run 与 Markdown 行内标记的非对称：切分与合并、固定顺序的粗斜体与行内代码、反斜杠奇偶性与围栏加宽，以及 callout 语义标签与 emoji 的双射映射。插件无外部依赖，适合需要在 CI 或离线环境做 Notion 文档流水线、写往返测试、或在 Agent 工具链里稳定读写 Notion 区块的开发者与编辑者。