拓冰网站定制 
Posting 终端 API 客户端演进全览基于 CHANGELOG 的能力地图与源码印证【免费下载链接】postingThe modern API client that lives in your terminal.项目地址: https://gitcode.com/gh_mirrors/po/posting导读Posting 是一款活在终端里的现代 API 客户端其官方变更记录 docs/CHANGELOG.md 完整刻画了项目从 1.11.0 到 2.9.x 的功能演进轨迹。本文以该变更记录为骨架逐版本梳理脚本化请求、OpenAPI/Postman/curl 导入、路径参数、主题系统、键位映射等核心能力并结合仓库源码与测试用例给出实现层面的印证帮助你快速建立对 Posting 能力边界的完整认知并将其作为选择、配置与深度使用 Posting 的技术参考。一、项目背景与变更记录的价值Posting 是一个基于 TextualPython 终端 UI 框架构建的开源 API 客户端请求以 YAML 文件形式保存在磁盘上的集合collection目录中天然具备版本管理与多工具协作优势。CHANGELOG.md从 1.11.02024 年 8 月开始记录覆盖了导入体系、脚本引擎、主题系统、键盘交互与性能优化等多个重大演进是观察该项目架构决策最直接的技术史料。本文涉及的核心模块与仓库路径对应关系如下能力域源码位置请求模型与 curl 导出src/posting/collection.py脚本执行引擎src/posting/scripts.py配置系统src/posting/config.pycurl / OpenAPI / Postman 导入src/posting/importing/路径参数与 URL 处理src/posting/urls.py主题系统src/posting/themes.py命令面板src/posting/commands.py二、最新开发版本Unreleased的修复与增强当前变更记录头部描述了尚未正式发布的改动反映出项目最前沿的方向主题文件软链接热重载修复此前以 symlink 方式指向主题文件时文件改动无法触发 UI 自动刷新现在已支持对 symlink 的监听。结合 src/posting/config.py 中watch_themes配置默认true主题文件的实时重载链路已经打通——这一能力最早在 2.3.0 引入。可视化模式下 yank 丢失末尾字符修复解决了在编辑器/脚本输出的 visual 模式下复制文本时最后一个字符被遗漏的问题。OpenAPI 3.0 规范导入支持此前仅支持 3.1现在 3.0 亦可导入。src/posting/importing/open_api.py 中的_get_openapi_models函数按openapi字段版本分发到openapi_pydantic.v3.v3_0与 3.1 两套 pydantic 模型两种规范版本均可解析。MethodSelector 交互增强支持用大写字母快速切换方法、禁用 Textual 内置的type_to_search行为并支持通过下划线字母导航选择层。PostingSelect 键位扩展可用j/k/l/空格 导航选项k/j上下移动光标l与空格选中高亮项。三、2.9.x 系列路径参数与内置主题3.1 路径参数:param语法2.9.0 引入的路径参数支持是请求编辑体验的重要补强。在 URL 路径中使用:id这样的占位符即可声明路径参数。src/posting/urls.py 定义了匹配规则(?!:):([A-Za-z_][A-Za-z0-9_]*)即匹配单个冒号引导的标识符同时通过否定式向后断言避开::id这样的转义令牌转义后的::会在替换后还原为单个冒号用于表达字面量。substitute_path_paramssrc/posting/urls.py只对 URL 的 path 部分做替换query 与 fragment 不受影响未提供值的占位符原样保留。而在 src/posting/collection.py 中apply_template在完成变量替换后会调用substitute_path_params将路径参数回填进 URL并随后调用ensure_protocol自动补全协议。2.9.2 修复了路径参数跨请求互相干扰的问题确保每个请求维护独立的path_params列表RequestModel.path_params。3.2 新内置主题与 YAML 导出新增hypernova、synthwave两个内置主题。主题系统定义于 src/posting/themes.py支持primary、secondary、accent、dark等顶层字段以及text_area、syntax、variable、method等细分样式HTTP 方法在侧边栏中的默认色值GET 蓝、POST 绿、DELETE 红等也定义于此src/posting/themes.py。命令面板新增export: copy as YAML可将当前请求含未保存的 UI 状态以 YAML 形式复制到剪贴板。该命令在 src/posting/commands.py 中注册调用app.command_copy_request_yaml。YAML 的落盘格式可见 src/posting/collection.py 的save_to_disk——使用model_dump(exclude_defaultsTrue, exclude_noneTrue)剔除默认值保持文件精简。3.3 性能与兼容性维护2.9.1 将textual-autocomplete升级至 4.0.6修复了 CPU 占用异常偏高的问题。2.8.0 将 Textual 从 3.0.0 升级至 6.1.0并移除了新建并打开请求时的通知弹窗。2.7.1 将 tree-sitter 锁定在0.25.0规避其破坏性 API 变更导致的崩溃。四、2.7.x 系列三方导入体系成型2.7.0 是导入能力最密集的版本几乎奠定了 Posting 现在的导入矩阵Postman 集合导入解析postman_collection.json支持变量{{var}}转换为$VAR、请求体、header、query 与目录结构。src/posting/importing/postman.py 中的sanitize_variables会把userId转换为$USER_IDsanitize_str则负责将{{...}}语法批量改写为$VAR形式集合级变量会生成独立的.env文件create_env_filesrc/posting/importing/postman.py。posting.env自动加载当前目录存在posting.env且未通过--env指定环境文件时自动加载无需手动配置。OpenAPI 导入增强为每个 server 生成独立.env文件含BASE_URL及 server 变量解析见 extract_server_variables按application/jsonschema 生成带默认值的 JSON 请求体JsonBodyGenerator字符串取default or 、数字取default or 0、布尔取default or False、对象递归生成属性用 operation 的tags拆分出子集合目录。curl 导入扩展-d、--data-raw、--data-binary、--data-urlencode、-F等多种数据选项均被支持。src/posting/importing/curl.py 使用argparse的parse_known_intermixed_args解析令牌流可容忍未知参数-u/--user与Authorizationheader 会被解析为 Basic/Digest/Bearer 认证curl.py。-c简写别名--collection选项新增-c简写。2.7.x 的行为变更与修复数据表headers、query 等进入编辑模式由单击改为双击避免误触发。请求体编辑器中的Form data菜单项标注了(x-www-form-urlencoded)后缀。导出的 curl 对表单数据改用-d而非-F对应application/x-www-form-urlencoded与 Posting 实际发送行为一致见 RequestModel.to_curl 对form_data的-d namevalue输出。修复了 URL 栏在应用变量前就尝试添加协议的问题修复了脚本路径与自定义函数的执行问题修复了默认User-Agent未被使用的问题用户自定义的User-Agent优先见 2.5.4 的修复。五、2.6.x 系列编辑体验与 UI 细节5.1 表格编辑模式2.6.0 允许直接编辑 headers、form data 与 query 参数而无需删除重建按enter或单击行进入编辑模式当前行高亮焦点移到 key/name 输入框提交后覆盖原行按v进入编辑模式并直接聚焦 value 输入框按escape取消编辑按enter保存并退出编辑模式输入框背景色会随编辑模式变化作为视觉提示。5.2 基于 header 名的值自动补全当输入Content-Type这类 header 的值时会弹出常见取值如各类 MIME 类型的补全列表。这一机制与 2.4.0 扩充 header 补全清单新增Accept-Charset、Sec-Fetch-*等一脉相承底层由重写后的自动补全系统统一驱动2.6.0 中重写了 header 名、header 值、URL、变量的补全系统。5.3 布局与状态栏新增spacing: compact|standard配置默认standard可在命令面板中随时切换见 src/posting/commands.py 的spacing: Enable compact mode命令。集合浏览器聚焦时按/即可打开请求搜索面板ctrlshiftp保持全局可用。URL 栏新增响应状态码标签与 trace 标记并列展示。脚本输出日志支持基础 Vim 移动键hjkl。当无响应 cookie 时cookie 区显示提示消息而非空白。5.4 关键修复修复了on_startup配置为url时启动即回车导致崩溃的问题根源是 UI 懒加载尚未完成便尝试发送请求。修复了 header 编辑器中回车接受补全的同时又添加了该 header 的竞态——现在第一次回车接受补全、第二次回车才添加 header。修复了请求描述错误解析 Textual markup 的问题PR #243 相关改动。六、2.5.x 系列认证、校验与启动性能6.1 认证能力补强2.5.0 在Auth标签页新增bearer token 认证支持并在 OpenAPI 导入中支持securitySchemes的解析。src/posting/importing/open_api.py 中httpbasic方案生成$NAME_USERNAME/$NAME_PASSWORD变量与 BasicAuthhttpbearer方案生成$NAME_BEARER_TOKEN变量与 BearerTokenAuth请求级security声明也会被转换为对应认证open_api.py。认证模型Auth支持basic/digest/bearer_token三种类型并通过to_httpx_auth映射为 httpx 的认证实现src/posting/collection.py。6.2 导入健壮性OpenAPI 改用外部库openapi-pydantic解析2.5.02.7.0 起仅在执行posting import时才导入该库懒加载节省约 63ms 启动时间。curl 导入支持max-time选项2.5.1 修复。从 curl 导入时请求元数据name、description不再被覆盖2.5.1。6.3 表单校验与启动优化2.5.2 为 New Request 弹窗加入校验与对应 UI 反馈红色指示条修复了可创建空名请求以及删除磁盘上不存在的请求会崩溃的问题。2.5.3 则是一轮彻底的启动性能优化隐藏标签页内容懒加载省约 100ms、openapi-pydantic延迟导入省 63ms、httpx的_main打补丁避免慢导入省 20ms、watchfiles延迟到应用运行时导入省 6ms、HelpScreen用到才导入省 10ms。七、2.4.x 系列curl 导出与请求搜索2.4.0 与 2.4.1 让 curl 导出成为一等公民行启用/禁用表格行可通过space或复选框切换启用状态。导出的 curl 会尊重启用状态——被禁用的 header、参数不会出现在命令中src/posting/collection.py 对header.enabled的判断。导出到剪贴板命令面板新增Export to curl将当前请求复制为 curl 命令。RequestModel.to_curlsrc/posting/collection.py会按需附加-X、-H、-d、-u/--digest、--cookie、--no-location、--insecure、--max-time、--proxy并以\换行拼接提高可读性——这一输出被 tests/test_curl_export.py 的断言精确验证。curl_export_extra_args配置可向复制到剪贴板的 curl 命令注入额外参数定义于 src/posting/config.py。导出时是否执行 setup 脚本可控命令面板同时提供export: copy as curl默认执行 setup 脚本与export: copy as curl (no setup scripts)跳过见 src/posting/commands.py。变量会代入导出的命令未定义的变量保持$foo原样。请求搜索与跳转ctrlshiftp打开按名称搜索请求的弹窗键位可通过search-requests配置默认ctrlshiftp。外部编辑器/分页器键位可定制open-in-editor与open-in-pager键位可自定义。八、2.3.x2.1.x 系列主题系统与收藏浏览器8.1 主题的实时性与错误处理2.3.0 起编辑磁盘上的主题文件会让 UI 实时刷新反映改动配合watch_themes配置。2.3.1 将命令面板的Change theme更名为Preview theme明确其仅预览当前会话、持久化需写配置文件同时修复了无效语法主题导致崩溃的问题——现在会批量收集错误并一次性展示主题含非法语法或取值时优雅退出。2.2.0 引入 15 个新主题4 个 Posting 专属、11 个继承自 Textual 主题系统主题进入命令面板子菜单语法高亮色、URL 栏高亮、侧边栏 HTTP 方法色均由当前主题自动派生键位助手可侧边栏化实时教学footer 悬停出现集合浏览器键位 tooltip。8.2 集合浏览器优化2.2.1 修复空集合时浏览器消息不可见的问题并优化空状态文案提示切换浏览器快捷键。2.1.0 起浏览器宽度随内容自适应避免大屏浪费空间Info标签页对未保存请求显示Request not saved to disk。2.1.0 还支持把 curl 命令直接粘贴进 URL 栏完成导入与posting import命令行导入互为补充。九、2.0.0 里程碑脚本引擎与键位映射2.0.0 是 Posting 从终端 curl 封装走向可编程 API 客户端的分水岭9.1 脚本引擎Scripting请求可关联setup、pre-requeston_request、post-requeston_response三类 Python 函数路径相对集合根目录模型定义见 src/posting/collection.py 的Scripts。脚本在外部编辑器中修改后会被自动重新加载基于模块缓存失效机制src/posting/scripts.py 的clear_module_cache与_MODULE_CACHE。脚本可通过posting对象直接操作请求、读写会话变量set_variable/get_variable/clear_variable/clear_all_variablessrc/posting/scripts.py变量设置后立即同步到请求解析环境notify可弹出 toast 通知scripts.py。2.3.1 修复了文档中描述了但未实现的get_variable方法。脚本输出被捕获并展示在Scripts标签页variables属性返回包含环境文件变量与脚本会话变量的完整字典。9.2 键位映射与焦点控制通过config.yaml的keymap段可为所有全局动作发送请求、打开 jump mode 等重绑键位src/posting/config.py 的keymap: dict[str, str]。新增heading.hostname配置支持 Rich markup可在生产/开发环境展示不同样式的 hostnameconfig.py。新增focus.on_request_open配置打开请求时自动把焦点移到指定标签headers、body、query、info、url、method、path之一见 config.py。altenter新增为发送请求快捷键与ctrlj并存自动根据 Body 类型设置content-typeheader推荐安装方式从 rye 切换为 uv。9.3 其余演进1.13.0 引入collection_browser.show_on_startup配置、对已加载 dotenv 文件的改动监听与 UI 热更新1.12.0 起侧边栏按 HTTP 方法着色1.11.0 引入本变更记录文件本身并支持集合浏览器中的复制d、快速复制shiftd、删除backspace带确认、快速删除shiftbackspacecollection_browser.position: right | left控制侧栏位置非法输入以红色左条标记galaxy 成为默认主题。十、从变更记录看 Posting 的技术演进主线纵览各版本可以归纳出四条清晰的技术主线从终端 curl到可编程客户端导入curl/Postman/OpenAPI与导出curl/YAML能力双向打通脚本引擎与变量系统支撑起 token 注入、请求预处理等真实工作流。终端 UI 的精细打磨基于 Textual 的持续升级0.76 → 0.83 → 3.0 → 6.1、跳转模式、紧凑布局、编辑模式、主题实时热更均在键盘优先、鼠标可选的交互哲学下展开。启动性能的反复优化2.5.3 与 2.9.1 两次集中优化涉及懒加载、依赖导入时机与第三方库版本锁定说明 TUI 应用同样重视冷启动体验。配置驱动的可扩展性config.yaml含 src/posting/config.py 定义的完整配置项theme、spacing、layout、pager、editor、ssl、focus、keymap、curl_export_extra_args等与磁盘上的请求 YAML、.env环境文件共同构成配置即代码的工作方式。如果你正在评估或上手 Posting建议按导入集合docs/guide/importing.md→ 配置环境docs/guide/environments.md→ 编写脚本docs/guide/scripting.md→ 定制键位docs/guide/keymap.md的路径深入仓库内的示例集合如 tests/sample-collections/jsonplaceholder/posts/get-one.posting.yaml与快照测试tests/snapshots/则是观察其真实数据形态与 UI 行为的最佳教材。【免费下载链接】postingThe modern API client that lives in your terminal.项目地址: https://gitcode.com/gh_mirrors/po/posting创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Posting 终端 API 客户端演进全览：基于 CHANGELOG 的能力地图与源码印证
Posting 终端 API 客户端演进全览基于 CHANGELOG 的能力地图与源码印证【免费下载链接】postingThe modern API client that lives in your terminal.项目地址: https://gitcode.com/gh_mirrors/po/posting导读Posting 是一款活在终端里的现代 API 客户端其官方变更记录 docs/CHANGELOG.md 完整刻画了项目从 1.11.0 到 2.9.x 的功能演进轨迹。本文以该变更记录为骨架逐版本梳理脚本化请求、OpenAPI/Postman/curl 导入、路径参数、主题系统、键位映射等核心能力并结合仓库源码与测试用例给出实现层面的印证帮助你快速建立对 Posting 能力边界的完整认知并将其作为选择、配置与深度使用 Posting 的技术参考。一、项目背景与变更记录的价值Posting 是一个基于 TextualPython 终端 UI 框架构建的开源 API 客户端请求以 YAML 文件形式保存在磁盘上的集合collection目录中天然具备版本管理与多工具协作优势。CHANGELOG.md从 1.11.02024 年 8 月开始记录覆盖了导入体系、脚本引擎、主题系统、键盘交互与性能优化等多个重大演进是观察该项目架构决策最直接的技术史料。本文涉及的核心模块与仓库路径对应关系如下能力域源码位置请求模型与 curl 导出src/posting/collection.py脚本执行引擎src/posting/scripts.py配置系统src/posting/config.pycurl / OpenAPI / Postman 导入src/posting/importing/路径参数与 URL 处理src/posting/urls.py主题系统src/posting/themes.py命令面板src/posting/commands.py二、最新开发版本Unreleased的修复与增强当前变更记录头部描述了尚未正式发布的改动反映出项目最前沿的方向主题文件软链接热重载修复此前以 symlink 方式指向主题文件时文件改动无法触发 UI 自动刷新现在已支持对 symlink 的监听。结合 src/posting/config.py 中watch_themes配置默认true主题文件的实时重载链路已经打通——这一能力最早在 2.3.0 引入。可视化模式下 yank 丢失末尾字符修复解决了在编辑器/脚本输出的 visual 模式下复制文本时最后一个字符被遗漏的问题。OpenAPI 3.0 规范导入支持此前仅支持 3.1现在 3.0 亦可导入。src/posting/importing/open_api.py 中的_get_openapi_models函数按openapi字段版本分发到openapi_pydantic.v3.v3_0与 3.1 两套 pydantic 模型两种规范版本均可解析。MethodSelector 交互增强支持用大写字母快速切换方法、禁用 Textual 内置的type_to_search行为并支持通过下划线字母导航选择层。PostingSelect 键位扩展可用j/k/l/空格 导航选项k/j上下移动光标l与空格选中高亮项。三、2.9.x 系列路径参数与内置主题3.1 路径参数:param语法2.9.0 引入的路径参数支持是请求编辑体验的重要补强。在 URL 路径中使用:id这样的占位符即可声明路径参数。src/posting/urls.py 定义了匹配规则(?!:):([A-Za-z_][A-Za-z0-9_]*)即匹配单个冒号引导的标识符同时通过否定式向后断言避开::id这样的转义令牌转义后的::会在替换后还原为单个冒号用于表达字面量。substitute_path_paramssrc/posting/urls.py只对 URL 的 path 部分做替换query 与 fragment 不受影响未提供值的占位符原样保留。而在 src/posting/collection.py 中apply_template在完成变量替换后会调用substitute_path_params将路径参数回填进 URL并随后调用ensure_protocol自动补全协议。2.9.2 修复了路径参数跨请求互相干扰的问题确保每个请求维护独立的path_params列表RequestModel.path_params。3.2 新内置主题与 YAML 导出新增hypernova、synthwave两个内置主题。主题系统定义于 src/posting/themes.py支持primary、secondary、accent、dark等顶层字段以及text_area、syntax、variable、method等细分样式HTTP 方法在侧边栏中的默认色值GET 蓝、POST 绿、DELETE 红等也定义于此src/posting/themes.py。命令面板新增export: copy as YAML可将当前请求含未保存的 UI 状态以 YAML 形式复制到剪贴板。该命令在 src/posting/commands.py 中注册调用app.command_copy_request_yaml。YAML 的落盘格式可见 src/posting/collection.py 的save_to_disk——使用model_dump(exclude_defaultsTrue, exclude_noneTrue)剔除默认值保持文件精简。3.3 性能与兼容性维护2.9.1 将textual-autocomplete升级至 4.0.6修复了 CPU 占用异常偏高的问题。2.8.0 将 Textual 从 3.0.0 升级至 6.1.0并移除了新建并打开请求时的通知弹窗。2.7.1 将 tree-sitter 锁定在0.25.0规避其破坏性 API 变更导致的崩溃。四、2.7.x 系列三方导入体系成型2.7.0 是导入能力最密集的版本几乎奠定了 Posting 现在的导入矩阵Postman 集合导入解析postman_collection.json支持变量{{var}}转换为$VAR、请求体、header、query 与目录结构。src/posting/importing/postman.py 中的sanitize_variables会把userId转换为$USER_IDsanitize_str则负责将{{...}}语法批量改写为$VAR形式集合级变量会生成独立的.env文件create_env_filesrc/posting/importing/postman.py。posting.env自动加载当前目录存在posting.env且未通过--env指定环境文件时自动加载无需手动配置。OpenAPI 导入增强为每个 server 生成独立.env文件含BASE_URL及 server 变量解析见 extract_server_variables按application/jsonschema 生成带默认值的 JSON 请求体JsonBodyGenerator字符串取default or 、数字取default or 0、布尔取default or False、对象递归生成属性用 operation 的tags拆分出子集合目录。curl 导入扩展-d、--data-raw、--data-binary、--data-urlencode、-F等多种数据选项均被支持。src/posting/importing/curl.py 使用argparse的parse_known_intermixed_args解析令牌流可容忍未知参数-u/--user与Authorizationheader 会被解析为 Basic/Digest/Bearer 认证curl.py。-c简写别名--collection选项新增-c简写。2.7.x 的行为变更与修复数据表headers、query 等进入编辑模式由单击改为双击避免误触发。请求体编辑器中的Form data菜单项标注了(x-www-form-urlencoded)后缀。导出的 curl 对表单数据改用-d而非-F对应application/x-www-form-urlencoded与 Posting 实际发送行为一致见 RequestModel.to_curl 对form_data的-d namevalue输出。修复了 URL 栏在应用变量前就尝试添加协议的问题修复了脚本路径与自定义函数的执行问题修复了默认User-Agent未被使用的问题用户自定义的User-Agent优先见 2.5.4 的修复。五、2.6.x 系列编辑体验与 UI 细节5.1 表格编辑模式2.6.0 允许直接编辑 headers、form data 与 query 参数而无需删除重建按enter或单击行进入编辑模式当前行高亮焦点移到 key/name 输入框提交后覆盖原行按v进入编辑模式并直接聚焦 value 输入框按escape取消编辑按enter保存并退出编辑模式输入框背景色会随编辑模式变化作为视觉提示。5.2 基于 header 名的值自动补全当输入Content-Type这类 header 的值时会弹出常见取值如各类 MIME 类型的补全列表。这一机制与 2.4.0 扩充 header 补全清单新增Accept-Charset、Sec-Fetch-*等一脉相承底层由重写后的自动补全系统统一驱动2.6.0 中重写了 header 名、header 值、URL、变量的补全系统。5.3 布局与状态栏新增spacing: compact|standard配置默认standard可在命令面板中随时切换见 src/posting/commands.py 的spacing: Enable compact mode命令。集合浏览器聚焦时按/即可打开请求搜索面板ctrlshiftp保持全局可用。URL 栏新增响应状态码标签与 trace 标记并列展示。脚本输出日志支持基础 Vim 移动键hjkl。当无响应 cookie 时cookie 区显示提示消息而非空白。5.4 关键修复修复了on_startup配置为url时启动即回车导致崩溃的问题根源是 UI 懒加载尚未完成便尝试发送请求。修复了 header 编辑器中回车接受补全的同时又添加了该 header 的竞态——现在第一次回车接受补全、第二次回车才添加 header。修复了请求描述错误解析 Textual markup 的问题PR #243 相关改动。六、2.5.x 系列认证、校验与启动性能6.1 认证能力补强2.5.0 在Auth标签页新增bearer token 认证支持并在 OpenAPI 导入中支持securitySchemes的解析。src/posting/importing/open_api.py 中httpbasic方案生成$NAME_USERNAME/$NAME_PASSWORD变量与 BasicAuthhttpbearer方案生成$NAME_BEARER_TOKEN变量与 BearerTokenAuth请求级security声明也会被转换为对应认证open_api.py。认证模型Auth支持basic/digest/bearer_token三种类型并通过to_httpx_auth映射为 httpx 的认证实现src/posting/collection.py。6.2 导入健壮性OpenAPI 改用外部库openapi-pydantic解析2.5.02.7.0 起仅在执行posting import时才导入该库懒加载节省约 63ms 启动时间。curl 导入支持max-time选项2.5.1 修复。从 curl 导入时请求元数据name、description不再被覆盖2.5.1。6.3 表单校验与启动优化2.5.2 为 New Request 弹窗加入校验与对应 UI 反馈红色指示条修复了可创建空名请求以及删除磁盘上不存在的请求会崩溃的问题。2.5.3 则是一轮彻底的启动性能优化隐藏标签页内容懒加载省约 100ms、openapi-pydantic延迟导入省 63ms、httpx的_main打补丁避免慢导入省 20ms、watchfiles延迟到应用运行时导入省 6ms、HelpScreen用到才导入省 10ms。七、2.4.x 系列curl 导出与请求搜索2.4.0 与 2.4.1 让 curl 导出成为一等公民行启用/禁用表格行可通过space或复选框切换启用状态。导出的 curl 会尊重启用状态——被禁用的 header、参数不会出现在命令中src/posting/collection.py 对header.enabled的判断。导出到剪贴板命令面板新增Export to curl将当前请求复制为 curl 命令。RequestModel.to_curlsrc/posting/collection.py会按需附加-X、-H、-d、-u/--digest、--cookie、--no-location、--insecure、--max-time、--proxy并以\换行拼接提高可读性——这一输出被 tests/test_curl_export.py 的断言精确验证。curl_export_extra_args配置可向复制到剪贴板的 curl 命令注入额外参数定义于 src/posting/config.py。导出时是否执行 setup 脚本可控命令面板同时提供export: copy as curl默认执行 setup 脚本与export: copy as curl (no setup scripts)跳过见 src/posting/commands.py。变量会代入导出的命令未定义的变量保持$foo原样。请求搜索与跳转ctrlshiftp打开按名称搜索请求的弹窗键位可通过search-requests配置默认ctrlshiftp。外部编辑器/分页器键位可定制open-in-editor与open-in-pager键位可自定义。八、2.3.x2.1.x 系列主题系统与收藏浏览器8.1 主题的实时性与错误处理2.3.0 起编辑磁盘上的主题文件会让 UI 实时刷新反映改动配合watch_themes配置。2.3.1 将命令面板的Change theme更名为Preview theme明确其仅预览当前会话、持久化需写配置文件同时修复了无效语法主题导致崩溃的问题——现在会批量收集错误并一次性展示主题含非法语法或取值时优雅退出。2.2.0 引入 15 个新主题4 个 Posting 专属、11 个继承自 Textual 主题系统主题进入命令面板子菜单语法高亮色、URL 栏高亮、侧边栏 HTTP 方法色均由当前主题自动派生键位助手可侧边栏化实时教学footer 悬停出现集合浏览器键位 tooltip。8.2 集合浏览器优化2.2.1 修复空集合时浏览器消息不可见的问题并优化空状态文案提示切换浏览器快捷键。2.1.0 起浏览器宽度随内容自适应避免大屏浪费空间Info标签页对未保存请求显示Request not saved to disk。2.1.0 还支持把 curl 命令直接粘贴进 URL 栏完成导入与posting import命令行导入互为补充。九、2.0.0 里程碑脚本引擎与键位映射2.0.0 是 Posting 从终端 curl 封装走向可编程 API 客户端的分水岭9.1 脚本引擎Scripting请求可关联setup、pre-requeston_request、post-requeston_response三类 Python 函数路径相对集合根目录模型定义见 src/posting/collection.py 的Scripts。脚本在外部编辑器中修改后会被自动重新加载基于模块缓存失效机制src/posting/scripts.py 的clear_module_cache与_MODULE_CACHE。脚本可通过posting对象直接操作请求、读写会话变量set_variable/get_variable/clear_variable/clear_all_variablessrc/posting/scripts.py变量设置后立即同步到请求解析环境notify可弹出 toast 通知scripts.py。2.3.1 修复了文档中描述了但未实现的get_variable方法。脚本输出被捕获并展示在Scripts标签页variables属性返回包含环境文件变量与脚本会话变量的完整字典。9.2 键位映射与焦点控制通过config.yaml的keymap段可为所有全局动作发送请求、打开 jump mode 等重绑键位src/posting/config.py 的keymap: dict[str, str]。新增heading.hostname配置支持 Rich markup可在生产/开发环境展示不同样式的 hostnameconfig.py。新增focus.on_request_open配置打开请求时自动把焦点移到指定标签headers、body、query、info、url、method、path之一见 config.py。altenter新增为发送请求快捷键与ctrlj并存自动根据 Body 类型设置content-typeheader推荐安装方式从 rye 切换为 uv。9.3 其余演进1.13.0 引入collection_browser.show_on_startup配置、对已加载 dotenv 文件的改动监听与 UI 热更新1.12.0 起侧边栏按 HTTP 方法着色1.11.0 引入本变更记录文件本身并支持集合浏览器中的复制d、快速复制shiftd、删除backspace带确认、快速删除shiftbackspacecollection_browser.position: right | left控制侧栏位置非法输入以红色左条标记galaxy 成为默认主题。十、从变更记录看 Posting 的技术演进主线纵览各版本可以归纳出四条清晰的技术主线从终端 curl到可编程客户端导入curl/Postman/OpenAPI与导出curl/YAML能力双向打通脚本引擎与变量系统支撑起 token 注入、请求预处理等真实工作流。终端 UI 的精细打磨基于 Textual 的持续升级0.76 → 0.83 → 3.0 → 6.1、跳转模式、紧凑布局、编辑模式、主题实时热更均在键盘优先、鼠标可选的交互哲学下展开。启动性能的反复优化2.5.3 与 2.9.1 两次集中优化涉及懒加载、依赖导入时机与第三方库版本锁定说明 TUI 应用同样重视冷启动体验。配置驱动的可扩展性config.yaml含 src/posting/config.py 定义的完整配置项theme、spacing、layout、pager、editor、ssl、focus、keymap、curl_export_extra_args等与磁盘上的请求 YAML、.env环境文件共同构成配置即代码的工作方式。如果你正在评估或上手 Posting建议按导入集合docs/guide/importing.md→ 配置环境docs/guide/environments.md→ 编写脚本docs/guide/scripting.md→ 定制键位docs/guide/keymap.md的路径深入仓库内的示例集合如 tests/sample-collections/jsonplaceholder/posts/get-one.posting.yaml与快照测试tests/snapshots/则是观察其真实数据形态与 UI 行为的最佳教材。【免费下载链接】postingThe modern API client that lives in your terminal.项目地址: https://gitcode.com/gh_mirrors/po/posting创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考