V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
star7th
V2EX  ›  分享创造

这个 pc 客户端忙了两三个月,终于推出公测版,能配得上“高颜值”这个标签吗

  •  
  •   star7th · 2023-05-16 09:33:04 +08:00 · 10194 次点击
    这是一个创建于 565 天前的主题,其中的信息可能已经有所发展或是发生改变。

    前言

    runapi 是一个接口开发测试工具(功能上类似 postman ),搭配我们开源的服务端,可免费私有部署到企业内网(文末会附上免费私有部署教程链接)。

    runapi 在之前就已经有了一个版本,但是被用户说不够好看,不够“高颜值” 。于是果断把重写计划安排到日程,目标是: 高颜值,巨幅度提升用户体验。

    忙了两三个月,终于推出公测版,希望能配得上“高颜值”标签。

    预览图

    下载和部署链接

    runapi 3.0.0 版公测下载: https://www.showdoc.com.cn/runapi/10152635649730221

    runapi 旧版: https://www.showdoc.com.cn/runapi/30291

    如果你要免费私有部署到企业内网,则需要先部署我们开源的 showdoc 服务端: https://github.com/star7th/showdoc

    如果你不要求私有部署,则直接注册客户端即可使用。

    第 1 条附言  ·  2023-05-19 12:04:29 +08:00
    公测已经结束,正式发版了。不用再通过专门的公测链接去下载。直接下载正式版就行
    https://www.showdoc.com.cn/runapi
    62 条回复    2023-06-01 19:25:18 +08:00
    dashupc
        1
    dashupc  
       2023-05-16 09:35:02 +08:00
    “高颜值” 。看看 ,是干啥用的, 有没有官网介绍
    awesomes
        2
    awesomes  
       2023-05-16 09:36:59 +08:00   ❤️ 2
    个人认为这种工具就应该做成 web 的,参考 https://hoppscotch.io/(只不过这个工具的存储体验做得不好)
    star7th
        3
    star7th  
    OP
       2023-05-16 09:37:23 +08:00
    @dashupc

    runapi 是一个跟 postman 差不多的接口开发测试工具。考虑到 postman 在开发者群体的高度知名度,所以我就没特别介绍了。文末有一些链接,你可以点进去分别了解更多。
    Pantheoon
        4
    Pantheoon  
       2023-05-16 09:38:41 +08:00
    和 postman 的区别是啥?
    star7th
        5
    star7th  
    OP
       2023-05-16 09:38:59 +08:00
    @awesomes 做成 web 的话,也需要用户特定安装浏览器扩展,目前并没有明显比客户端方便。先看看吧,后面要开放也行,因为都是 web 技术栈开发的。
    Charod
        6
    Charod  
       2023-05-16 09:39:56 +08:00
    +1, 的确网页会更方便
    star7th
        7
    star7th  
    OP
       2023-05-16 09:40:49 +08:00
    @Pantheoon

    最大的亮点是自动生成 api 文档到 showdoc https://github.com/star7th/showdoc

    runapi 其实一开始是作为 showdoc 文档工具的附属存在的。近期开始想把 runapi 独立品牌宣传。
    xiaoz
        8
    xiaoz  
       2023-05-16 10:01:43 +08:00 via Android
    支持大佬,在用 showdoc ,之前安装了 runapi 界面确实有点。我试试新的客户端。
    christin
        9
    christin  
       2023-05-16 10:09:06 +08:00
    本来想安装体验一下的,但是想了想 webstorm 自带的接口调试工具就行
    mydebug
        10
    mydebug  
       2023-05-16 10:09:34 +08:00
    apifox 不好用吗
    star7th
        11
    star7th  
    OP
       2023-05-16 10:15:16 +08:00
    @mydebug

    runapi 是可以免费部署到企业内网的。跟 apifox 不一样。相当多的企业对数据比较敏感。
    bigbigpark
        12
    bigbigpark  
       2023-05-16 10:32:14 +08:00
    可否支持从 apifox 导入数据
    star7th
        13
    star7th  
    OP
       2023-05-16 10:37:39 +08:00
    @bigbigpark

    你从它那里导出 openapi 格式的 json 文件,再导入 runapi
    XGF
        14
    XGF  
       2023-05-16 10:41:07 +08:00
    原来是 showdoc 团队啊,支持一下
    qiubaowei
        15
    qiubaowei  
       2023-05-16 11:06:33 +08:00
    一直在用
    还和贵方技术邮件沟通过 bug 不知道公测版有没有修复
    至少看起来 “花里胡哨”(这里是褒义词 好看的意思)
    tanoak
        16
    tanoak  
       2023-05-16 11:11:17 +08:00
    支持文件下载吗,post 请求
    star7th
        17
    star7th  
    OP
       2023-05-16 11:16:39 +08:00
    @tanoak

    支持的。在 运行调试 按钮 的下载,有 运行并下载文件的。
    star7th
        18
    star7th  
    OP
       2023-05-16 11:16:55 +08:00
    @tanoak

    支持的。在 运行调试 按钮 的下拉菜单,有 运行并下载文件的。
    iblessyou
        19
    iblessyou  
       2023-05-16 11:46:34 +08:00   ❤️ 1
    apipost apifox eoapi insomnia(post cat)
    每看到一个类似新工具都会试试
    想找一个轻巧离线的工具好难
    postman 也渐渐膨胀了(物理)
    然后依然用我的 7 版本的 postman
    忍受着升级的小红点
    最上川
    rekulas
        20
    rekulas  
       2023-05-16 11:51:18 +08:00
    墙裂支持,runapi 确实不错一直在用
    不过说实话我也倾向于做成 web 扩展的要方便很多(特别可以配合调试非常方便),客户端确实没那么方便
    另外老版本有一些 bug 和不完善之处不知道修复没有,相对于 ui 来说,功能性更重要
    请求失败、请求异常标识不是很明显
    请求中标识不明显,有时候点击了然后没任何反应
    有时候失误请求了大文件或 bin 会卡死,建议做点限制
    偶尔会出现程序异常,无法发起请求,重启程序也不行,只能重启电脑(目前只遇到一次)
    star7th
        21
    star7th  
    OP
       2023-05-16 11:59:59 +08:00
    @rekulas

    新版里,请求接口的时候, 响应卡 那里会出现个 loading
    rekulas
        22
    rekulas  
       2023-05-16 12:01:58 +08:00
    刚测了下,上面的问题已经得到了优化
    另外做 web 扩展貌似存在个问题,web 上因为权限的原因某些 header 似乎无法覆盖(即使是扩展级别),那就需要做成 wasm ,可能也没那么方便
    rekulas
        23
    rekulas  
       2023-05-16 12:19:41 +08:00
    再提个建议
    参见第二张图,参数部分和响应部分的底色跟背景色完全一致,辨识度不够高也不够美观建议做点区分
    另外新版打开标签比老版本慢不少
    jin7
        24
    jin7  
       2023-05-16 12:22:33 +08:00
    支持测试 websocket 吗? @star7th
    star7th
        25
    star7th  
    OP
       2023-05-16 13:07:46 +08:00
    @rekulas

    标签打开的机制不一样了。现在新建标签,是同步新建接口的。以前是异步新建接口的,会存在接口跟 tab 不一致的情况
    star7th
        26
    star7th  
    OP
       2023-05-16 13:08:11 +08:00
    @jin7

    暂时不支持。后面看一下是否需求添加
    jin7
        27
    jin7  
       2023-05-16 13:22:05 +08:00
    @star7th 可以参考 apipost
    caqiko
        28
    caqiko  
       2023-05-16 13:30:34 +08:00 via Android
    是 electron 吗?
    star7th
        29
    star7th  
    OP
       2023-05-16 13:59:22 +08:00
    @caqiko
    是的
    userm
        30
    userm  
       2023-05-16 14:08:18 +08:00
    生成的接口文档里面我看没有显示 Content-Type 不是太方便。
    guguji5
        31
    guguji5  
       2023-05-16 14:09:19 +08:00
    一直在用 apifox
    star7th
        32
    star7th  
    OP
       2023-05-16 16:09:39 +08:00
    @userm

    后面考虑加一下
    wyx119911
        33
    wyx119911  
       2023-05-16 17:33:16 +08:00
    一直用 Talend API Tester 浏览器插件,因为可以自动携带页面的 cookie ,不用自己手动导入。op 这个插件有什么好方法携带 cookie 吗
    star7th
        34
    star7th  
    OP
       2023-05-16 17:36:28 +08:00
    @wyx119911

    runapi 的 cookie 是需要自己手动填写的。
    JustSong
        35
    JustSong  
       2023-05-16 22:37:30 +08:00
    登录界面左边的 padding 是不是太大了啊
    star7th
        36
    star7th  
    OP
       2023-05-17 09:21:55 +08:00
    @JustSong

    好像是我后来为了兼容小屏幕而调整了一点宽度。不过问题不大。
    fan123199
        37
    fan123199  
       2023-05-17 10:05:33 +08:00
    可以 append 一下旧版的对比图,效果就出来了~ 我去看了下旧版的,确实有比较大的提升。不过离高颜值应该还有很多细节要优化
    ShuWei
        38
    ShuWei  
       2023-05-18 08:59:59 +08:00
    MacOS 试了下,op 绝对是对“颜值”有什么误解
    star7th
        39
    star7th  
    OP
       2023-05-18 09:05:31 +08:00
    @ShuWei 愿闻其详
    star7th
        40
    star7th  
    OP
       2023-05-18 09:06:37 +08:00
    @ShuWei

    如果能用一个同类工具来类比一下 runapi 的 UI 缺陷在哪更好,我也蛮好奇
    ShuWei
        41
    ShuWei  
       2023-05-18 09:50:18 +08:00
    @star7th 哎呀,为了你这句话,我又重新装了一遍,其他就不说了,光这字体,就够看吐的

    star7th
        42
    star7th  
    OP
       2023-05-18 09:58:33 +08:00
    @ShuWei

    字体倒没什么问题,是设计师推荐的圆润字体,我也觉得蛮好看的。就你截图而言,我感觉是我没设置好大小和图标,有点不统一。
    但不论怎么说,这个字体绝对不丑。你如果坚持觉得丑,那没啥好讲了。
    ShuWei
        43
    ShuWei  
       2023-05-18 10:08:12 +08:00   ❤️ 2
    @star7th 你内心很强大,这么丑的字体,居然可以硬说不丑,实在不行,用系统默认字体吧,你们家这设计师可以开除了
    star7th
        44
    star7th  
    OP
       2023-05-18 10:14:02 +08:00
    @ShuWei

    我更相信专业设计师的建议。因为人家有很多好看的设计作品。这是人家的风格,人家觉得对于这种 UI 风格的客户端,使用圆润字体更好看。如果你不是专业设计师,没有很多设计作品,我觉得还是需要敬畏一下专业人士的建议。同时,其他用户也没怎么反应过字体难看的问题。这套字体在设计师的多个客户端作品已经通过了市场验证。
    star7th
        45
    star7th  
    OP
       2023-05-18 10:16:05 +08:00   ❤️ 1
    @ShuWei

    我觉得你可以有你独特的审美,你可以说你不习惯这种风格。但是我觉得你缺乏对 专业设计的尊重。人家这套风格已经经过多个作品的市场验证了的
    vitovan
        46
    vitovan  
       2023-05-18 17:23:02 +08:00
    @ShuWei #43 我也觉得字体丑。

    但是我更介意的是中英文之间没有空格(在 V2EX 发帖都会自动加上空格 /t/873359 ),而且:

    - runapi 而不是 RunAPI
    - markdown 而不是 Markdown

    然而挑毛病谁都会,这套设计和实现还是很难得的。

    star7th
        47
    star7th  
    OP
       2023-05-19 12:00:12 +08:00
    @vitovan

    这种菜单式的按钮,中英文间加空格就没必要了吧。对于正文,才比较合适。

    另外对于字体,我再次跟设计师确认了。他的建议是,不用管个别的看法,如果按每个人的看法都改一遍,就没有自己的产品主见了。
    如果说是很专业的建议,或者很多的用户反馈,才是值得斟酌的建议。

    我自己是同意设计师的观念的。对于风格,你不能单纯拿个放大镜来找细节字体的问题,要看整体的呈现效果。大概率是设计师觉得这个字体在这种 UI 风格下的整体的呈现效果更好
    wqq096737ink
        48
    wqq096737ink  
       2023-05-19 12:09:06 +08:00
    开源吗?不开源的话更喜欢用公司成熟的产品。在工具上瞎折腾就是浪费时间
    star7th
        49
    star7th  
    OP
       2023-05-19 12:11:12 +08:00
    @wqq096737ink

    客户端本身不开源,但可以离线使用。同时 服务端开源。 你如果搭建服务端在企业内网,配合离线的客户端,就可以免费私有部署使用。
    crazyweeds
        50
    crazyweeds  
       2023-05-19 17:21:02 +08:00
    业余选手来评价了,你的主页面明显想走性冷淡风格,但是 tag 之类的颜色,太突兀了。。感觉是不是可以增加一个透明度试试看效果?
    sechi
        51
    sechi  
       2023-05-19 17:50:13 +08:00   ❤️ 1
    @star7th #47 纯路人,平心而论,这 UI 确实是有些问题。上面的字直接被截掉了一些。这个“添”字也有些和其他的字格格不入。
    sechi
        52
    sechi  
       2023-05-19 17:51:54 +08:00
    @crazyweeds 同意,标签的颜色太重了
    star7th
        53
    star7th  
    OP
       2023-05-19 18:20:49 +08:00
    @crazyweeds
    @sechi

    这个我感觉还好吧。因为整体是性冷谈风格,所以才需要一些色彩提一下色吧。不过这只是我的猜测,设计师本意是如何,我没去问。但是我觉得这个还好。
    star7th
        54
    star7th  
    OP
       2023-05-19 18:21:49 +08:00
    @sechi

    被截取掉可能是一些高度设置值不对,我晚点看看。它不是字体本身的效果。
    vitovan
        55
    vitovan  
       2023-05-20 15:09:13 +08:00
    @star7th #47 所以做设计比较难,高端大气上档次,每个人的口味又不一样。

    辛苦设计师了。
    Bingchunmoli
        56
    Bingchunmoli  
       2023-05-26 08:50:16 +08:00 via Android
    目前在用 eolinker ,感觉这个也是 web 套壳技术,例如 apifox 和 apipost 两个不是 dpi 适配有问题就是太卡
    star7th
        57
    star7th  
    OP
       2023-05-26 08:58:05 +08:00
    @Bingchunmoli

    你可以试试 runapi ,比上一代性能优化很多,基本没听过用户反馈过新客户端卡。
    orclo
        58
    orclo  
       2023-05-29 09:05:05 +08:00
    我是设计师,我不喜欢换字体,尤其是这种多平台的产品,中文字体字体包都不小,用系统自带的效果其实都还行,工具类型的产品清晰直观就够了,每个系统字体都是经过亿万级别的检验,第三方字体不能够保证出现一些奇怪的基线或者缺失字体问题。
    star7th
        59
    star7th  
    OP
       2023-05-29 09:15:03 +08:00
    @orclo
    你说的是有道理的。目前来看,反馈字体的用户也没特别多,主要是 v 站的几个对产品特别挑剔的人说的。而且这几个挑剔的人,大概率也不是 runapi 的用户。在 runapi 用户群里,反馈字体的还真很少,所以我觉得这个问题还是可以先忽略不计吧。
    相比反馈字体类型,反馈字体大小的反而多一点。我现在在新版已经把字体设置大一点了。
    rekulas
        60
    rekulas  
       2023-06-01 11:25:47 +08:00
    再反馈个网页端的 bug markdown 里面输入",显示会变成中文例如“
    另外之前还遇到一些字符不显示,不算非常怪异的字符比较普通的那种,不过忘了是哪些了
    在其他正常的开闭源 markdown 编辑器里面显示是正常的
    star7th
        61
    star7th  
    OP
       2023-06-01 15:25:51 +08:00
    @rekulas

    网页版 showdoc 的编辑器是几年前的一个开源编辑器,原作者已经停止维护了。我自己搞的是魔改版。后面看要不要换掉编辑器吧
    rekulas
        62
    rekulas  
       2023-06-01 19:25:18 +08:00
    @star7th 原来如此,我一直以为你就是原作者
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2705 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 29ms · UTC 09:06 · PVG 17:06 · LAX 01:06 · JFK 04:06
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.