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

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

  •  
  •   star7th · 317 天前 · 9456 次点击
    这是一个创建于 317 天前的主题,其中的信息可能已经有所发展或是发生改变。

    前言

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

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

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

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

    runapi 是可以免费部署到企业内网的。跟 apifox 不一样。相当多的企业对数据比较敏感。
    bigbigpark
        12
    bigbigpark  
       317 天前
    可否支持从 apifox 导入数据
    star7th
        13
    star7th  
    OP
       317 天前
    @bigbigpark

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

    支持的。在 运行调试 按钮 的下载,有 运行并下载文件的。
    star7th
        18
    star7th  
    OP
       317 天前
    @tanoak

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

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

    标签打开的机制不一样了。现在新建标签,是同步新建接口的。以前是异步新建接口的,会存在接口跟 tab 不一致的情况
    star7th
        26
    star7th  
    OP
       317 天前
    @jin7

    暂时不支持。后面看一下是否需求添加
    jin7
        27
    jin7  
       317 天前
    @star7th 可以参考 apipost
    caqiko
        28
    caqiko  
       317 天前 via Android
    是 electron 吗?
    star7th
        29
    star7th  
    OP
       317 天前
    @caqiko
    是的
    userm
        30
    userm  
       317 天前
    生成的接口文档里面我看没有显示 Content-Type 不是太方便。
    guguji5
        31
    guguji5  
       317 天前
    一直在用 apifox
    star7th
        32
    star7th  
    OP
       317 天前
    @userm

    后面考虑加一下
    wyx119911
        33
    wyx119911  
       317 天前
    一直用 Talend API Tester 浏览器插件,因为可以自动携带页面的 cookie ,不用自己手动导入。op 这个插件有什么好方法携带 cookie 吗
    star7th
        34
    star7th  
    OP
       317 天前
    @wyx119911

    runapi 的 cookie 是需要自己手动填写的。
    JustSong
        35
    JustSong  
       317 天前
    登录界面左边的 padding 是不是太大了啊
    star7th
        36
    star7th  
    OP
       316 天前
    @JustSong

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

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

    star7th
        42
    star7th  
    OP
       315 天前
    @ShuWei

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

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

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

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

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

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

    star7th
        47
    star7th  
    OP
       314 天前
    @vitovan

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

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

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

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

    这个我感觉还好吧。因为整体是性冷谈风格,所以才需要一些色彩提一下色吧。不过这只是我的猜测,设计师本意是如何,我没去问。但是我觉得这个还好。
    star7th
        54
    star7th  
    OP
       314 天前
    @sechi

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

    辛苦设计师了。
    Bingchunmoli
        56
    Bingchunmoli  
       307 天前 via Android
    目前在用 eolinker ,感觉这个也是 web 套壳技术,例如 apifox 和 apipost 两个不是 dpi 适配有问题就是太卡
    star7th
        57
    star7th  
    OP
       307 天前
    @Bingchunmoli

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

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