网易首页 > 网易号 > 正文 申请入驻

reladraw:一种声明元素位置的文字图表语言

0
分享至

  一个只有168颗星的开源项目,做了一件主流图表语言没做的事:把"东西放哪儿"写进文件里。

  它叫reladraw,目前版本0.5.0。作者给它的定位很直接——一种文字图表语言,你在里面说清楚东西放在哪里。

  

  它和Mermaid们差在哪

  Mermaid、Graphviz、D2这一派的做法是:你声明实体和连接,布局全部由算法决定。作者承认这是超能力,对大多数图表来说也是正确选择。但当你心里已经有一张具体的图、并且在意东西摆哪儿的时候,它就不再合适了。

  比如你正在通过画图来建立对一个系统的理解,想让某个模块待在右边、它的连线也按你的意思走——自动布局语言没有表达这件事的方式。

  另一头是draw.io、Excalidraw、Figma这类绝对定位工具。它们给你完全的摆放控制权,代价是复杂图表每改一次都是慢工。对人来说慢,对代理来说更贵——它得先从坐标里把图反推出来,才能决定改哪几个数字。

  reladraw瞄准的是中间地带。文件里没有任何坐标,每个位置都相对于别的东西来声明:

  node app "Web app"

  node app.ui "Interface"

  node app.api "API" below app.ui

  node store "Database" right of app level with app

  edge app.api -> store "queries" from: right to: left

  没有嵌套结构,所以没有任何一行依赖另一行的位置或缩进。

  改图才是真正的日常

  作者点出了一个常被忽略的事实:常见场景不是画一张图,而是改一张图。让认证服务往左挪,让一个队列排到它后面。

  用像素坐标,代理得先从数字里重建整张图,才能算出该改哪些数字。用自动布局,压根没东西可读——布局从来没被写下来过,它只能改源文件再重新渲染。而用声明式位置,布局就以句子的形式躺在文件里,改图就是改那句"东西放哪儿"的话。

  写代码也是同样的形状。一个代理输出Mermaid,是在猜一个稍后由算法敲定的布局,它唯一能确认的办法就是渲染出来看一眼——这一趟往返回来的是张图,而不是一份"哪里错了"的清单。

  作者把这条界线划得很清楚:意图可以确认,结果不能。代理可以重读自己的文件,看到数据库在API下面、四台机器都挂在同步中枢上。但它看不到两个锚定在不同东西上的集群现在重叠了、某段文字溢出了节点、某条边穿过了另外四条——这些是从语句里解算出来的,不是被写出来的,所以需要诊断信息来兜底。

  给代理装一份语言说明书

  reladraw太新,不在任何模型的训练数据里。代理必须先被告知这门语言,才能写它。仓库里带了一个agent skill,做的就是这件事:语法、什么时候该用这门语言、重读自己的源码能确认什么和不能确认什么。

  安装命令是 npx skills add reladraw/reladraw -g,会装到你用的那个代理上——Claude Code、Codex、Cursor、Copilot等各自装进自己的skills目录。去掉-g就装进当前项目。想只给某一个代理装,用-a指定名字。

  要注意的是,skill是安装那一刻的副本,不是实时链接,语法变更的版本发布后得重新跑一遍命令。它本身是纯Markdown加旁边的语法参考,手动复制目录同样可行。

  0.5.0这个版本还很早期,但能跑:TypeScript写的解析器、求解器和SVG渲染器,没有运行时依赖,外加一个命令行工具,吃文本文件、吐独立SVG。作者自己说,目前肉眼可见还不到位的是排版,不是位置。

特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。

Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.

相关推荐
热点推荐
顿平方被查

顿平方被查

北疆新闻
2026-09-29 17:17:10
造纸厂储罐发现3具女尸,法医:三人为亲姐妹,生前骨盆均被破坏

造纸厂储罐发现3具女尸,法医:三人为亲姐妹,生前骨盆均被破坏

罪案洞察者
2025-10-28 15:33:21
悲惨!因辅导作业,情绪失控,母女相继跳楼,双双坠亡!

悲惨!因辅导作业,情绪失控,母女相继跳楼,双双坠亡!

闲侃闲侃
2026-06-25 07:43:49
湖人官宣训练营21人名单:东契奇里夫斯凯斯勒领衔 布朗尼在列

湖人官宣训练营21人名单:东契奇里夫斯凯斯勒领衔 布朗尼在列

醉卧浮生
2026-09-29 00:07:36
曼城或遭强制降级!皇马欲趁机引进哈兰德,姆巴佩迎来最强搭档!

曼城或遭强制降级!皇马欲趁机引进哈兰德,姆巴佩迎来最强搭档!

海浪星体育
2026-09-29 09:47:15
普京曾数次痛批列宁:一生最大的错误,就是把统一国家改造成联盟

普京曾数次痛批列宁:一生最大的错误,就是把统一国家改造成联盟

非虚构人间
2026-09-20 10:15:03
伊朗最高领袖:伊朗现已变得独立、强大

伊朗最高领袖:伊朗现已变得独立、强大

极目新闻
2026-09-28 22:40:13
9月30号转运分水岭!这三大生肖被财神爷盯上,正财偏财一起旺

9月30号转运分水岭!这三大生肖被财神爷盯上,正财偏财一起旺

毅谈生肖
2026-09-28 11:05:17
李亚鹏回应嫣然医院房租问题:感谢房东 房租已经降了相当比例

李亚鹏回应嫣然医院房租问题:感谢房东 房租已经降了相当比例

快科技
2026-09-29 16:59:19
辞职不到1个月,深圳原市长覃伟中落马;受贿1.48亿,宋朝华被判死缓!

辞职不到1个月,深圳原市长覃伟中落马;受贿1.48亿,宋朝华被判死缓!

上观新闻
2026-09-28 14:52:44
大码模特现实里到底多大?

大码模特现实里到底多大?

飛娱日记
2026-05-12 08:27:55
4:0卫冕成功!中国队再夺一枚亚运金牌,马来西亚队成手下败将

4:0卫冕成功!中国队再夺一枚亚运金牌,马来西亚队成手下败将

娱圈办事处
2026-09-28 21:20:09
刚罚完郭德纲,又来个那英?演唱会临时加唱惹众怒 官方证实传噩耗

刚罚完郭德纲,又来个那英?演唱会临时加唱惹众怒 官方证实传噩耗

潋滟晴方DAY
2026-09-29 10:27:09
“希望4个老人长命百岁”,女子晒3万多退休金,普通人的心却凉了

“希望4个老人长命百岁”,女子晒3万多退休金,普通人的心却凉了

番外行
2026-09-22 16:10:14
全新升级“小仙女”!22岁女生择偶引热议:要求男友月入4-5万,自己不做饭不做家务

全新升级“小仙女”!22岁女生择偶引热议:要求男友月入4-5万,自己不做饭不做家务

火山詩话
2026-09-26 05:45:40
陈妤颉最后一棒太燃!没有她中国女子接力未必稳赢,混接还会上吗

陈妤颉最后一棒太燃!没有她中国女子接力未必稳赢,混接还会上吗

杨华评论
2026-09-28 23:25:27
U23国足VS韩国:吴曦朱辰杰坐镇,依木兰临危受命,张玉宁冲锋

U23国足VS韩国:吴曦朱辰杰坐镇,依木兰临危受命,张玉宁冲锋

零度眼看球
2026-09-29 07:23:34
普京:所有试图干涉俄内政的企图都已彻底失败

普京:所有试图干涉俄内政的企图都已彻底失败

看看新闻Knews
2026-09-29 17:03:57
不加价、不延长资质报价时间!杜伦与活塞迎来最后决胜时刻。

不加价、不延长资质报价时间!杜伦与活塞迎来最后决胜时刻。

属于自己的光
2026-09-29 11:40:29
马伊琍无故缺席金鹰奖仪式,要步刘亦菲后尘?疑无声回应提名争议

马伊琍无故缺席金鹰奖仪式,要步刘亦菲后尘?疑无声回应提名争议

挂肚逍遥心
2026-09-29 13:20:56
2026-09-29 22:20:49
Ping值焦虑
Ping值焦虑
有态度网友ytd
212文章数 105关注度
往期回顾 全部

科技要闻

82亿美元收购!李飞飞将与苏姿丰并肩做AI

头条要闻

老夫妻开包子铺28年想退休 儿子纠结是否接班:太辛苦

头条要闻

老夫妻开包子铺28年想退休 儿子纠结是否接班:太辛苦

体育要闻

石雨豪:亚运金牌与背后的十年

娱乐要闻

赌王四房婚礼,何超琼带三房成员现身

财经要闻

央行调整完善若干货币政策工具

汽车要闻

京北"小兰博"/限时售9.99万起 北京现代艾尼氪V上市

态度原创

游戏
本地
数码
房产
公开课

继中国电竞亚运会夺金两枚 《和平精英》强劲摘银

本地新闻

中秋逛白塔寺,体验国医妙荟雅集

数码要闻

火影T5A 2026款游戏本发售:酷睿i5-13420H + RTX 3050,5499元起

房产要闻

山海悦·壹号院喜封金顶 第五代住宅重塑自贸港人居新标杆

公开课

李玫瑾:为什么性格比能力更重要?

无障碍浏览 进入关怀版