针对 IntelliJ IDEA 环境推出 PostIn 插件，版本号1.0.1， PostIn 插件是一个针对 IntelliJ IDEA 环境的工具，集成到 IDEA 侧面板中，便于快速访问，帮助开发人员高效地管理API定义。插件可自动生成 API 文档并一键同步到 PostIn 的项目中。

一键智能解析：在IDEA中扫描JAVA代码，通过添加的注释自动识别接口路径、参数、返回值，无需手动整理！

全格式文档生成：秒级导出API标准文档，无缝对接PostIn平台！

动态同步更新：代码改动后，文档实时同步更新，杜绝“代码更新、文档滞后”产生的一系列问题！

自定义模板：支持团队统一配置文档样式、字段注释规范，让协作更专业！

省时省力：3秒生成100个接口文档，避免手工复制粘贴占用开发时间！

简单易用：无需配置复杂环境，安装即用，操作简单！

零误差：代码即文档，逻辑与描述100%一致，避免人为错误！

高效协作：代码与文档实时同步，解决了文档滞后代码、沟通成本高等一系列问题！

本节将详细介绍 PostIn 插件下载、安装。

方式1：在 IntelliJ IDEA 中安装 PostIn 插件。打开 IDEA 设置，进入 Plugins（插件）页面，搜索 “PostIn” 并安装 “PostIn” 插件。

方式2：在 Jetbrains Marketplace 中下载后通过本地安装

，打开 IDEA 设置，进入 Plugins（插件）页面，点击Installed右侧的设置按钮，选择"install plugin from disk... "，从磁盘安装插件。

插件仅支持 IntelliJ IDEA 2024.1.7 版本。

安装结束后，在idea右侧侧边栏显示PostIn。

本节将详细介绍 PostIn 插件配置。

进入插件后，显示扫描接口， 上报接口，设置三个按钮。

配置PostIn插件，点击“设置”按钮，进入PostIn插件的配置。

需要配置PostIn服务的URL（注意配置的URL尾部不需要带"/"），以及上报接口的所属空间ID，上报接口的所属空间ID可以在PostIn空间详情。

至此，PostIn上报接口的IDEA插件已全部下载、安装、配置结束。

本节将详细介绍怎么使用PostIn插件上报接口，生成详细的接口文档。

首先需要在接口文件controller 中添加注释，包含接口协议、导入接口文件夹名称、接口地址。

● @pi.protocol：定义了接口的协议。

● @pi.groupName：定义了接口的文件夹名称。

● @pi.path：定义了该接口的基本 URL 路径。

其次，需要在接口前添加接口详细信息的注释，包含接口名称、接口详细URL、请求方式、请求类型、请求参数。通过请求类型的不同，可以分为两种。

 * @pi.param: model=io.tiklab.postin.workspace.model.WorkspaceFollow

● @pi.name：定义了接口的名称。

● @pi.url：和@pi.path共同组成了接口的完整路径，举例接口的完整路径：/workspaceFollow/createWorkspaceFollow

● @pi.methodType：定义了接口请求方式。

● @pi.request-type：定义了接口请求类型。

 * @pi.param: name=id;dataType=string;value=workspaceId;desc=当前删除的id

 * @pi.param: name=id2;dataType=string;value=workspaceId2;desc=当前删除的id2

● @pi.url：和@pi.path共同组成了接口的完整路径，举例接口的完整路径：/workspaceFollow/deleteWorkspaceFollow

注释添加完成后，在PostIn插件点击“扫描接口”按钮，扫描当前项目所有接口。

扫描出接口后，用户可单选、多选或全选接口后提交上报。例如，接口总共有7个，按Ctrl选择其中3个，点击“上传接口”按钮，系统弹出”确认上传接口“二次确认弹窗。

点击“是”，选择的接口上传到PostIn系统。

当接口进行更新之后，还可以利用PostIn插件对接口进行更新。

接口成功上传PostIn后，对接口信息进行修改，只要接口路径（即@pi.path和@pi.url组成的路径）未进行修改，再次上传接口，会对当前接口进行更新。

接口路径（即@pi.path和@pi.url组成的路径）修改之后，再次上传接口，接口会按照新接口进行添加。

上报成功之后，可以在PostIn和 IntelliJ IDEA 环境信息对比。

下图为请求为字段，上报PostIn前后信息对比。

请检查配置的PostIn服务器URL是否正确，注意地址尾部不需要带"/"

PostIn V1.0.8版本发布，IDEA 插件支持一键扫描上报，让接口定义不再繁琐

富文本文档中表格支持合并单元格

ldap、企业微信、钉钉帐号集成及登录认证调整为社区版功能

企业微信消息通知调整为社区版本功能

进入知识库->文档模块，点击文档的更多按钮，即可看到导出为PDF和导出为Html功能

在富文本的表格中，选中想要合并的单元格，点击合并按钮，即可实现单元格合并。
合并后的单元格，选中后点击拆分，即可拆分为多个单元格



4、ldap、企业微信、钉钉帐号集成及登录认证

进入系统设置->用户->用户目录，可以选择配置并同步企业微信、钉钉、Ldap的用户。


用户目录页面，点击ldap后的配置按钮，填写配置信息。配置成功后点击开启，此时同步数据的按钮会亮起，点击同步数据，就会把ldap下的用户信息同步到kanass
若配置信息填写错误导致同步数据失败，点击禁止，配置按钮会再次亮起，可以修改配置信息。


用户目录页面，点击企业微信后的配置按钮，填写配置信息

配置信息填写完成后点击下一步，上传认证文件。
企业微信配置授权回调域的需要先配置网页授权及JS-SDK
先在企业微信下载授权文件，然后在上传即可


登录页面，选择企业微信登录，使用企业微信扫描登录二维码即可

用户目录页面，点击钉钉后的配置按钮，填写配置信息。配置成功后点击开启，此时同步数据的按钮会亮起，点击同步数据，就会把ldap下的用户信息同步到kanass
若配置信息填写错误导致同步数据失败，点击禁止，配置按钮会再次亮起，可以修改配置信息。


登录页面，选择钉钉登录，使用钉钉扫描登录二维码即可

进入系统设置->消息->发送方式页面下，点击企业微信后的配置

进入消息方案页面，点击任意事件名称进入消息方案配置详情页面。鼠标悬浮在通知方式区域，即可看到编辑按钮。点击编辑进入编辑模式，勾选企业微信即可

sward V2.1.5 版本发布，支持文档导出为html\PDF，社区版新增多种账号集成与认证

Arbess 是一款国产开源免费的 CI/CD 工具，产品开源免费，简洁易用。本周Arbess V2.1.7版本发布，新增任务AliYun OSS上传、下载功能，新增流水线评审功能，LDAP/企业微信/钉钉登录帐号集成及登录认证调整为社区版本功能。

新增任务AliYun OSS上传、下载功能。

LDAP/企业微信/钉钉登录帐号集成及登录认证调整为社区版本功能。

企业微信/钉钉消息通知调整为社区版本功能。

修复特定环境Node命令执行没有结果问题。

修复OpenEuler主机部署无法连接问题。

修复Maven构建部分主机找不到pom.xml文件问题。

新增制品上传AliYun OSS，或者从AliYun OSS下载制品进行构建的功能。具体添加任务点击工具添加AliYun OSS任务。


可以输入文件绝对路径进行上传，也可以使用模糊路径+上传文件匹配规则进行匹配后上传。

需要提前维护阿里云授权信息。

支持企业流水线运行评审，在流水线设置中配置评审信息。

启用评审后，流水线运行需要审批。点击运行按钮实际为发送流水线运行评审单。

提交评审后，评审人登录可看到评审单进行评审，通过后，可运行流水线。

4、LDAP、企业微信、钉钉帐号集成及登录认证

进入系统设置->用户->用户目录，可以选择配置并同步企业微信、钉钉、Ldap的用户。用户目录页面按钮说明。

用户目录页面，点击ldap后的配置按钮，填写配置信息。配置成功后点击开启，此时同步数据的按钮会亮起，点击同步数据，就会把ldap下的用户信息同步到用户列表。

若配置信息填写错误导致同步数据失败，点击禁止，配置按钮会再次亮起，可以修改配置信息。

用户目录页面，点击企业微信后的配置按钮，填写配置信息。

配置信息填写完成后点击下一步，上传认证文件。
企业微信配置授权回调域的需要先配置网页授权及JS-SDK，先在企业微信下载授权文件，然后在上传即可。

登录页面，选择企业微信登录，使用企业微信扫描登录二维码即可。

用户目录页面，点击钉钉后的配置按钮，填写配置信息。配置成功后点击开启，此时同步数据的按钮会亮起，点击同步数据，就会把ldap下的用户信息同步到用户列表。
若配置信息填写错误导致同步数据失败，点击禁止，配置按钮会再次亮起，可以修改配置信息。

登录页面，选择钉钉登录，使用钉钉扫描登录二维码即可。

进入系统设置->消息->发送方式页面下，点击企业微信后的配置。

进入消息方案页面，点击任意事件名称进入消息方案配置详情页面。鼠标悬浮在通知方式区域，即可看到编辑按钮。点击编辑进入编辑模式，勾选企业微信即可。

Arbess V2.1.7版本发布，新增任务AliYun OSS上传、下载功能，新增流水线评审功能

PostIn是一款国产开源免费的接口管理工具，包含项目管理、接口调试、接口管理、接口用例、接口计划等模块，支持常见的HTTP协议、websocket协议。本周PostIn V1.3.4版本发布，新增性能测试执行明细，ldap/企业微信/钉钉登录调整为社区版本功能。

性能测试新增压力配置，以及压力预估图。

修复接口管理调试界面中，body为formdata或urlencoded中添加任何数据保存为用例失败。

修复接口管理变量提取优先级问题 ，环境变量优先级>项目变量。

修复接口场景用例测试历史刷新不及时。

场景测试执行效果优化、性能测试执行效果优化。

2、性能测试压力预估图、执行明细图表

接口性能测试新增压力配置，以及压力预估图。执行性能测试显示执行明细图表。进入性能测试配置，增加Ramp-Up和Step参数。

例如并发量100，Ramp-Up设置10，Step设置2，那么100个并发分2步启动，每一步启动50个并发，10秒内启动100个并发。实现阶梯增压。


例如并发量100，Ramp-Up设置0，Step设置0，那么100个并发瞬间并发启动。


例如并发量100，Ramp-Up设置10，Step设置0，那么100个并发10秒内线性增压。


压力配置完成后，点击测试，展示接口性能测试执行明细图。

执行明细图显示性能测试运行时间内接口每秒接口请求数、平均响应时间、请求失败率、并发用户数等信息。

3、LDAP、企业微信、钉钉帐号集成及登录认证

PostIn V1.3.4版本发布，新增性能测试执行明细，LDAP/企业微信/钉钉登录调整为社区版本功能

GitPuk是一款国产开源免费的代码管理工具，工具简洁易用，开源免费，本周GitPuk发布v1.1.9版本，新增推送规则设置、分支保护与推送合并、支持Gitea、URL第三方库导入以及钉钉、企业微信等账号集成、登入认证、消息通知调整为社区版本功能。

钉钉、企业微信等账号集成、登入认证、消息通知调整为社区版本功能

优化了代码展示界面，添加了树形结构

在提交详情树结构中添加变动文件数量

1.进入GitPuk后，点击你所创建的仓库

2.进入创建仓库后，点击左下角设置按钮来到设置页面

3.点击分支设置，来到分支设置该页面

4.点击添加分支规则，输入需要保护的分支名称，选择指定角色或成员才能推送到该分支，选择成功后点击确定即可

5.点击确定后，页面提示创建成功设置完成后只有该指定成员或者角色可向保护分支推送代码，其余成员无法推送

3.点击合并设置，进入合并设置页面

4.点击合并模式，打开合并模式后所有分支都会变成保护分支，往任意分支推送都会自动创建合并请求

4.点击合并评审规则，打开合并评审规则后可根据需求选择审核通过人数、审核人数、默认评审人等点击确定即可保存

1.进入GitPuk后，点击右上角创建仓库选择导入仓库

2.点击Gitea，输入对应Gitea地址、Access Token点击确定即可

2.点击URL导入，输入源代码库地址后系统会自动选择仓库名称、仓库路径

3.认证类型分为三种无需认证、账号密码、Access Token根据自身需求来选择即可

1.进入GitPuk后，点击左侧设置按钮进入设置页面

2.进入设置页面后，点击消息来到消息页面

3.点击发送方式，选择企业微信点击配置

4.输入需要的内容后点击确定即可，也可以点击测试试一下查看是否配置成功

2.进入设置页面后，点击用户在点击用户目录跳转至用户目录界面

3.点击你需要配置的软件，点击配置输入完对应内容后点击确定即可

4.配置完成后点击开启，在点击同步数据即可，这样钉钉的用户/用户组即可导入至GitPuk中

GitPuk V1.1.9版本发布，新增分支保护、推送合并等功能，有效保障代码质量与安全

sourcefare 是一款国产开源免费的代码分析工具，旨在帮助开发团队快速识别代码中的安全漏洞、编码缺陷和合规性问题。本周sourcefare V1.1.9版本发布，新增代码扫描实时日志，ldap/企业微信/钉钉登录调整为社区版本功能。

新增实时日志，显示每个阶段的运行状态、运行时间。

修复重复度、复杂率不显示问题。

针对服务器扫描，新增实时日志，显示每个阶段的运行状态、运行时间。例如创建代码包上传代码扫描项目。


创建完成后，上传Java代码包，上传完成之后，点击扫描按钮进行代码扫描。


开始代码扫描后，自动展示扫描日志。

sourcefare V1.1.9版本发布，新增代码扫描实时日志，LDAP/企业微信/钉钉登录调整为社区版本功能

Hadess是一款国产开源免费的制品管理工具，包含制品库管理、制品搜索等模块，支持常见的制品类型如Maven、npm、Docke等，产品功能完善、界面简洁、开源免费。本周Hadess v1.2.5版本发布，新增推送规则设置、制品扫描以及钉钉、企业微信等账号集成、登入认证、消息通知调整为社区版本功能

rpm类型制品支持本地上传拉取、代理库拉取

1.进入Hadess后，点击你所创建的制品库

2.进入制品库后，点击左侧设置按钮来到设置界面

3.点击推送设置，来到页面后打开此功能选择可以推送的角色或者成员点击保存即可

4.设置成功后，没有权限的用户往该制品库进行推送就无法推送

1.进入Hadess后，点击左侧制品扫描

2.进入制品扫描页面后，点击右上角添加计划

3.点击添加计划输入对应内容点击确定即可

4.进入你刚刚创建的扫描计划，进入后点击添加制品，选择你需要扫描的制品点击确定

5.添加完后点击右上角扫描，等待扫描完成即可

1.进入Hadess后，点击右上角新建制品库然后点击本地库创建，输入对应的内容点击确定即可远程库和组合库则是同理

2.进入你刚刚创建的制品库中，点击操作指南可以根据指南中的步骤来进行推送与拉取

1.进入Hadess后，点击左侧设置按钮进入设置页面

4.配置完成后点击开启，在点击同步数据即可，这样钉钉的用户/用户组即可导入至Hadess中

Hadess V1.2.5版本发布，新增推送规则、制品扫描等，有效保障制品质量与安全

系统全面支持各种附件的上传，上传后文件可以再次下载到本地，对部分文件支持在线预览

（1）登录系统后，选择您想要存储文件的知识库，并进入该知识库的文档页面，点击添加按钮即可找到上传本地文件链接。

找到”上传本地文件“的链接并点击

（2）点击链接后，会弹出选择本地文件的窗口，找到您想要上传的文件后，双击或者选中文件后点击打开按钮，文件自动上传到系统并展示在知识库左侧。

（3）您还可以按照自己的习惯新建目录，并将文件移动至特定目录，便于进一步整理和分类文件。

（4）上传后的文件可以继续下载到本地或分享给他人。

对于未解析文件，系统提供存储和下载