apiskill 0.1.5 → 0.1.6

package/dist/assets/index-CHOQ6xhP.css

@@ -0,0 +1 @@
+:root{color-scheme:light;font-family:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif;background:#eef1f4;color:#18202a;font-synthesis:none;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased}*{box-sizing:border-box}body{margin:0;min-width:320px;min-height:100vh}button,input,select{font:inherit}button{cursor:pointer}.app-shell{display:flex;flex-direction:column;height:100svh;min-height:100vh;padding:18px 18px 0;overflow:hidden}.topbar{display:flex;align-items:center;justify-content:space-between;gap:20px;padding:16px 20px;border:1px solid #d7dde4;border-radius:8px;background:#fff}.eyebrow{margin:0 0 4px;color:#667282;font-size:12px;font-weight:700;letter-spacing:0;text-transform:uppercase}h1,h2,h3,h4,p{margin-top:0}.topbar h1{margin:0;font-size:24px;line-height:1.2}.topbar-actions{display:flex;align-items:center;justify-content:flex-end;flex-wrap:wrap;gap:14px;min-width:0}.version-switcher{display:inline-flex;align-items:center;gap:8px;color:#647182;font-size:12px;font-weight:800}.version-switcher select{width:min(320px,32vw);min-height:36px;padding:0 10px;border:1px solid #cfd7e1;border-radius:6px;outline:0;color:#15202c;background:#fff}.version-manager{min-width:min(420px,38vw)}.version-manager-trigger{display:grid;grid-template-columns:auto minmax(0,1fr);align-items:center;gap:9px;width:100%;min-height:44px;padding:7px 10px;border:1px solid #cfd7e1;border-radius:7px;color:#23303e;background:#fff;text-align:left}.version-manager-trigger:disabled{cursor:not-allowed;opacity:.72}.version-manager-trigger span{display:grid;gap:2px;min-width:0}.version-manager-trigger strong,.version-manager-trigger small{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.version-manager-trigger strong{font-size:13px}.version-manager-trigger small{color:#657181;font-size:11px;font-weight:800}.version-manager-dialog{width:min(900px,100%);max-height:calc(100vh - 40px);overflow:auto;border-radius:8px;border:1px solid #d7dde4;background:#fff;box-shadow:0 18px 60px #12192338}.version-manager-body{display:grid;gap:12px;padding:16px 20px 20px;background:#f7f9fb}.version-message{padding:9px 11px;border:1px solid #cbe5df;border-radius:7px;color:#176b4f;background:#eef9f5;font-size:13px;font-weight:800}.version-message.error{border-color:#f1c1bd;color:#9a2d27;background:#fff4f3}.version-item{display:grid;gap:12px;padding:13px;border:1px solid #dfe5eb;border-radius:8px;background:#fff}.version-item.active{border-color:#7ab6ad;box-shadow:inset 3px 0 #1b6b65}.version-item-main{display:grid;grid-template-columns:minmax(0,1fr) auto;gap:12px;align-items:start}.version-item-title{display:flex;align-items:center;gap:8px;min-width:0}.version-item-title strong{overflow:hidden;color:#202a36;text-overflow:ellipsis;white-space:nowrap}.version-item-title span{padding:3px 7px;border-radius:999px;color:#176b4f;background:#e5f6ef;font-size:11px;font-weight:900}.version-item-main p{margin:4px 0 0;overflow-wrap:anywhere;color:#657181;font-family:SFMono-Regular,Consolas,monospace;font-size:12px}.version-item-stats{display:flex;flex-wrap:wrap;justify-content:flex-end;gap:6px}.version-item-stats span,.version-env-summary span{padding:5px 7px;border-radius:6px;color:#4d5b6c;background:#eef2f6;font-size:12px;font-weight:800}.version-env-summary{display:grid;grid-template-columns:auto minmax(0,1fr);align-items:center;gap:8px}.version-env-summary code{overflow:hidden;padding:7px 9px;border:1px solid #dfe5eb;border-radius:6px;color:#2f3d4d;background:#fbfcfd;text-overflow:ellipsis;white-space:nowrap}.version-env-editor{display:grid;grid-template-columns:minmax(160px,.5fr) minmax(0,1fr);gap:10px}.version-env-editor label{display:grid;gap:5px;min-width:0;color:#647182;font-size:12px;font-weight:800}.version-env-editor input{width:100%;min-height:36px;padding:0 10px;border:1px solid #cfd7e1;border-radius:6px;outline:0;color:#15202c;background:#fff}.version-item-actions{display:flex;flex-wrap:wrap;gap:8px;justify-content:flex-end}.sync-meta{display:flex;flex-wrap:wrap;justify-content:flex-end;gap:8px;color:#5c6877;font-size:13px}.sync-meta span{padding:5px 8px;border:1px solid #dce2e9;border-radius:6px;background:#f7f9fb}.primary-button,.copy-inline-button{display:inline-flex;align-items:center;justify-content:center;gap:8px;min-height:36px;border:0;border-radius:6px;color:#fff;background:#1b6b65;font-weight:700;white-space:nowrap}.primary-button{padding:0 14px}.primary-button:disabled{cursor:wait;opacity:.72}.copy-inline-button{padding:0 12px;background:#202a36}.secondary-button{display:inline-flex;align-items:center;justify-content:center;gap:8px;min-height:36px;padding:0 14px;border:1px solid #ccd5df;border-radius:6px;color:#22303d;background:#fff;font-weight:700;white-space:nowrap}.secondary-button:disabled{cursor:wait;opacity:.72}.danger-button{display:inline-flex;align-items:center;justify-content:center;gap:8px;min-height:36px;padding:0 14px;border:1px solid #efcbc8;border-radius:6px;color:#b63831;background:#fff7f6;font-weight:700;white-space:nowrap}.icon-secondary-button{display:inline-flex;align-items:center;justify-content:center;width:34px;height:34px;padding:0;border:1px solid #ccd5df;border-radius:6px;color:#22303d;background:#fff}.source-panel{display:grid;gap:10px;margin-top:12px;padding:12px;border:1px solid #d7dde4;border-radius:8px;background:#fff}.source-panel-header{display:flex;align-items:center;justify-content:space-between;gap:10px}.source-panel-actions{display:inline-flex;flex-wrap:wrap;gap:8px;justify-content:flex-end}.document-toolbar{grid-template-columns:minmax(0,1fr) auto;align-items:center}.document-source-summary{display:grid;min-width:0;gap:3px}.document-source-summary>span{color:#6a7685;font-size:12px;font-weight:700}.document-source-summary strong,.document-source-summary small{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.document-source-summary strong{color:#1d2936;font-size:13px}.document-source-summary small{color:#176b4f;font-size:12px}.document-toolbar>.version-message{grid-column:1 / -1}.source-tabs{display:inline-flex;width:fit-content;gap:4px;padding:3px;border:1px solid #d4dce5;border-radius:7px;background:#fff}.source-tabs button{display:inline-flex;align-items:center;justify-content:center;gap:6px;min-height:32px;padding:0 12px;border:0;border-radius:5px;color:#566373;background:transparent;font-size:13px;font-weight:800}.source-tabs button.active{color:#fff;background:#1b6b65}.source-form{display:grid;grid-template-columns:minmax(0,1fr) auto auto;gap:10px}.document-dialog{width:min(760px,100%);max-height:calc(100vh - 40px);overflow:auto;border:1px solid #d7dde4;border-radius:8px;background:#fff;box-shadow:0 18px 60px #12192338;animation:dialog-enter .16s ease-out}.document-dialog-tabs{display:flex;gap:2px;overflow-x:auto;padding:10px 20px 0;border-bottom:1px solid #e5eaf0}.document-dialog-tabs button{display:inline-flex;flex:0 0 auto;align-items:center;justify-content:center;gap:6px;min-height:38px;padding:0 12px;border:0;border-bottom:2px solid transparent;color:#5c6877;background:transparent;font-size:13px;font-weight:800}.document-dialog-tabs button.active{border-bottom-color:#1b6b65;color:#155a55}.document-dialog-body{min-height:174px;padding:20px;background:#f7f9fb}.blank-document-fields{display:grid;gap:12px}.document-source-input{min-height:46px;background:#fff}.document-file-picker{display:grid;grid-template-columns:auto minmax(0,1fr);align-content:center;min-height:134px;padding:22px;background:#fff}.document-file-picker>svg{grid-row:1 / span 2}.document-file-picker small{color:#748091}.document-dialog-actions{gap:8px;padding-top:18px}.document-dialog-actions .clear-document-source{margin-right:auto}.source-input,.source-file-picker{display:flex;align-items:center;gap:8px;min-width:0;min-height:38px;padding:0 12px;border:1px solid #cfd7e1;border-radius:7px;background:#f9fafb}.source-file-picker{cursor:pointer}.source-file-picker input{display:none}.source-file-picker span{overflow:hidden;min-width:0;color:#15202c;text-overflow:ellipsis;white-space:nowrap}.source-input input{width:100%;min-width:0;border:0;outline:0;background:transparent;color:#15202c}.source-input textarea{width:100%;min-width:0;min-height:118px;resize:vertical;border:0;outline:0;background:transparent;color:#15202c;font-family:SFMono-Regular,Consolas,monospace;font-size:12px;line-height:1.5}.source-input-multiline{align-items:flex-start;padding-top:10px;padding-bottom:10px}.source-input-multiline svg{margin-top:2px}.source-auth{grid-column:1 / -1;display:grid;grid-template-columns:auto minmax(0,1fr);align-items:center;gap:10px}.source-auth-fields{display:grid;grid-template-columns:repeat(2,minmax(0,220px));gap:8px}.source-auth-fields label{display:flex;align-items:center;gap:8px;min-width:0;min-height:36px;padding:0 10px;border:1px solid #cfd7e1;border-radius:7px;background:#f9fafb}.source-auth-fields input{width:100%;min-width:0;border:0;outline:0;background:transparent;color:#15202c}.source-meta{grid-column:1 / -1;overflow:hidden;color:#657181;font-size:12px;text-overflow:ellipsis;white-space:nowrap}.source-meta span{color:#2f3d4d;font-family:SFMono-Regular,Consolas,monospace}.source-meta small{margin-left:8px;color:#728094;font-weight:800}.workspace{display:grid;flex:1 1 auto;grid-template-columns:minmax(320px,380px) minmax(0,1fr);gap:16px;min-height:0;margin-top:16px}.sidebar,.detail-pane{min-height:0;border:1px solid #d7dde4;border-radius:8px;background:#fff}.sidebar{display:flex;flex-direction:column;padding:14px}.search-box{display:flex;align-items:center;gap:8px;min-height:42px;padding:0 12px;border:1px solid #cfd7e1;border-radius:7px;background:#f9fafb}.search-box input{width:100%;min-width:0;border:0;outline:0;background:transparent;color:#15202c}.search-clear-button{display:inline-flex;align-items:center;justify-content:center;flex:0 0 auto;width:24px;height:24px;padding:0;border:0;border-radius:5px;color:#647182;background:transparent}.search-clear-button:hover{color:#b63831;background:#fff0ef}.filters{display:grid;grid-template-columns:1fr auto;gap:10px;margin-top:12px}.filters label:first-child{display:flex;align-items:center;gap:8px;min-width:0;padding:0 10px;border:1px solid #d5dce5;border-radius:7px;background:#fff}.filters select{width:100%;min-height:38px;border:0;outline:0;background:transparent}.checkbox-line{display:inline-flex;align-items:center;gap:6px;color:#566373;font-size:13px;white-space:nowrap}.method-tabs{display:grid;grid-template-columns:repeat(6,minmax(0,1fr));gap:6px;margin-top:12px}.method-tabs button{min-height:32px;border:1px solid #d5dce5;border-radius:6px;color:#536171;background:#fff;font-size:12px;font-weight:800}.method-tabs button.active{color:#fff;border-color:#1b6b65;background:#1b6b65}.endpoint-count{margin:12px 2px 8px;color:#6b7582;font-size:13px}.endpoint-list{flex:1 1 auto;min-height:0;overflow:auto;display:flex;flex-direction:column;gap:6px;padding-right:4px}.endpoint-item{display:grid;grid-template-columns:64px minmax(0,1fr);align-items:start;gap:10px;width:100%;min-height:66px;padding:10px;border:1px solid transparent;border-radius:7px;text-align:left;background:#fff}.endpoint-item:hover{background:#f6f8fa}.endpoint-item.selected{border-color:#1b6b65;background:#edf7f5}.endpoint-main{min-width:0}.endpoint-main strong,.endpoint-main small{display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.endpoint-main strong{margin-bottom:4px;color:#1d2732;font-size:14px}.endpoint-main small{color:#647182;font-family:SFMono-Regular,Consolas,monospace;font-size:12px}.method{display:inline-flex;align-items:center;justify-content:center;width:58px;height:24px;border-radius:5px;color:#fff;font-size:11px;font-weight:900}.method-get{background:#246bce}.method-post{background:#168456}.method-put{background:#9a6200}.method-delete{background:#c23131}.method-patch{background:#7953b8}.method-options,.method-head{background:#52606f}.detail-pane{overflow:auto}.opened-api-tabs{position:sticky;top:0;z-index:5;display:flex;align-items:flex-end;gap:4px;overflow-x:auto;overflow-y:hidden;min-height:47px;padding:10px 12px 0;border-bottom:1px solid #dfe5eb;background:#f7f9fb}.opened-api-tab{--tab-accent: #52606f;--tab-soft: #eef2f6;display:inline-grid;grid-template-columns:auto minmax(100px,210px) 20px;align-items:center;gap:7px;min-width:180px;max-width:280px;height:36px;padding:7px 8px 8px;border:1px solid color-mix(in srgb,var(--tab-accent) 45%,#d5dce5);border-bottom-color:#dfe5eb;border-radius:7px 7px 0 0;text-align:left;background:var(--tab-soft);cursor:pointer}.opened-api-tab-get{--tab-accent: #246bce;--tab-soft: #eef5ff}.opened-api-tab-post{--tab-accent: #168456;--tab-soft: #edf8f2}.opened-api-tab-put{--tab-accent: #9a6200;--tab-soft: #fff5e4}.opened-api-tab-delete{--tab-accent: #c23131;--tab-soft: #fff0f0}.opened-api-tab-patch{--tab-accent: #7953b8;--tab-soft: #f4efff}.opened-api-tab-options,.opened-api-tab-head{--tab-accent: #52606f;--tab-soft: #f0f3f6}.opened-api-tab.active{position:relative;margin-bottom:-1px;border-color:var(--tab-accent);border-bottom-color:#fff;background:#fff;box-shadow:inset 0 3px 0 var(--tab-accent)}.opened-api-tab-text{min-width:0}.opened-api-tab-text strong{display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.opened-api-tab-text strong{color:#1d2732;font-size:12px;font-weight:800}.opened-api-tab-method{display:inline-flex;align-items:center;justify-content:center;min-width:34px;height:18px;padding:0 5px;border-radius:4px;color:#fff;font-size:9px;font-weight:900;line-height:1}.opened-api-tab-close{display:inline-flex;align-items:center;justify-content:center;width:20px;height:20px;padding:0;border:0;border-radius:5px;color:var(--tab-accent);background:transparent;cursor:pointer}.opened-api-tab-close:hover{color:#b63831;background:#fff0ef}.endpoint-detail{padding:22px}.detail-header{display:flex;align-items:flex-start;justify-content:space-between;gap:18px;padding-bottom:18px;border-bottom:1px solid #e1e6ec}.detail-actions{display:flex;align-items:center;gap:8px;margin-left:auto}.endpoint-title-line{display:flex;align-items:center;gap:10px}.endpoint-title-line h2{margin:0;color:#121923;font-size:22px;line-height:1.25}.path-row{display:flex;align-items:center;gap:8px;min-width:0;margin-top:10px}.path-line{display:block;min-width:0;color:#354253;font-size:13px;white-space:normal;word-break:break-all}.path-copy-button{display:inline-flex;align-items:center;justify-content:center;flex:0 0 auto;gap:4px;min-height:28px;padding:0 8px;border:1px solid #d4dce5;border-radius:6px;color:#415166;background:#fff;font-size:12px;font-weight:800}.path-copy-button:hover{border-color:#9fb0c1;background:#f7f9fb}.tag-row{display:flex;flex-wrap:wrap;gap:6px;margin-top:12px}.tag-row span{padding:4px 8px;border-radius:5px;color:#475364;background:#edf1f5;font-size:12px;font-weight:700}.description{margin:16px 0 0;color:#4f5c6a;line-height:1.7}.copy-preview{margin-top:18px;border:1px solid #d9e0e7;border-radius:8px;background:#f8fafb}.copy-preview-toolbar{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:10px;border-bottom:1px solid #dfe5eb}.copy-tabs{display:inline-flex;gap:4px;padding:3px;border:1px solid #d4dce5;border-radius:7px;background:#fff}.copy-tabs button{display:inline-flex;align-items:center;gap:6px;min-height:30px;padding:0 10px;border:0;border-radius:5px;color:#566373;background:transparent;font-size:13px;font-weight:800}.copy-tabs button.active{color:#fff;background:#1b6b65}.copy-preview-content{overflow:auto;min-height:calc(3 * 1.6em + 28px);max-height:calc(25.6em + 28px);margin:0;padding:14px;color:#e5edf6;background:#111827;font-family:SFMono-Regular,Consolas,monospace;font-size:12px;line-height:1.6;white-space:pre-wrap;overflow-wrap:anywhere}.request-tester{display:grid;gap:14px;padding:14px;background:#fff}.endpoint-links-config{display:grid;gap:12px;padding:14px;background:#fff}.links-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px}.links-actions,.link-editor-actions{display:flex;flex-wrap:wrap;gap:8px;justify-content:flex-end}.link-editor-panel{min-width:0}.link-button{text-decoration:none}.request-line{display:grid;grid-template-columns:auto minmax(0,1fr) auto;align-items:end;gap:10px}.request-actions{display:flex;flex-wrap:wrap;gap:8px;justify-content:flex-end}.request-line label,.tester-form-grid label,.param-editor label{display:grid;gap:5px;min-width:0;color:#647182;font-size:12px;font-weight:800}.request-line input,.tester-form-grid input,.tester-form-grid select,.param-editor input{width:100%;min-height:36px;padding:0 10px;border:1px solid #cfd7e1;border-radius:6px;outline:0;color:#15202c;background:#fff}.request-preview{display:block;overflow:hidden;padding:9px 10px;border:1px solid #dfe5eb;border-radius:6px;color:#334254;background:#f7f9fb;font-size:12px;text-overflow:ellipsis;white-space:nowrap}.tester-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px}.tester-panel{min-width:0;padding:12px;border:1px solid #dfe5eb;border-radius:7px;background:#fbfcfd}.tester-panel-title{display:flex;align-items:center;gap:6px;margin-bottom:10px;color:#243242;font-size:13px;font-weight:900}.tester-form-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:10px}.param-editor+.param-editor{margin-top:12px}.param-editor h4{margin:0 0 8px;color:#516070;font-size:12px}.param-editor label+label{margin-top:8px}.param-editor span{display:inline-flex;align-items:center;gap:3px}.param-editor b{color:#c23131}.tester-panel textarea{width:100%;min-height:168px;resize:vertical;padding:10px;border:1px solid #cfd7e1;border-radius:6px;outline:0;color:#1f2b38;background:#fff;font-family:SFMono-Regular,Consolas,monospace;font-size:12px;line-height:1.5}.tester-panel textarea:disabled{color:#8792a1;background:#f2f5f8}.response-panel{background:#fff}.response-meta-line{display:flex;flex-wrap:wrap;gap:8px;margin-bottom:10px}.response-meta-line span{padding:5px 8px;border-radius:5px;color:#536171;background:#eef2f6;font-size:12px;font-weight:800}.response-meta-line .status-ok{color:#176b4f;background:#e5f6ef}.response-meta-line .status-error{color:#a8322b;background:#fff0ef}.response-panel pre{overflow:auto;max-height:360px;margin:0;padding:12px;border-radius:6px;color:#202a36;background:#f7f9fb;font-family:SFMono-Regular,Consolas,monospace;font-size:12px;line-height:1.55}.detail-section{padding:20px 0;border-bottom:1px solid #e8edf2}.section-title{display:flex;align-items:center;justify-content:space-between;margin-bottom:10px}.section-title h3{margin:0;font-size:16px}.section-title span{min-width:28px;padding:3px 8px;border-radius:999px;color:#1b6b65;background:#e7f4f2;text-align:center;font-size:12px;font-weight:800}.media-block+.media-block,.response-block+.response-block{margin-top:18px}.media-block h4{margin:0 0 8px;color:#516070;font-family:SFMono-Regular,Consolas,monospace;font-size:13px}.response-heading{display:flex;align-items:center;gap:10px;margin-bottom:10px}.response-heading strong{padding:4px 8px;border-radius:5px;color:#fff;background:#202a36;font-size:12px}.response-heading span{color:#657181;font-size:13px}.table-wrap{overflow:auto;border:1px solid #dfe5eb;border-radius:7px}table{width:100%;min-width:920px;border-collapse:collapse;font-size:13px}th,td{padding:10px 12px;border-bottom:1px solid #edf1f4;text-align:left;vertical-align:top}th{position:sticky;top:0;z-index:1;color:#526171;background:#f7f9fb;font-size:12px;font-weight:800}tr:last-child td{border-bottom:0}td code{color:#17202b;font-family:SFMono-Regular,Consolas,monospace;font-size:12px}.muted{margin:0;color:#798596}.inline-error{display:flex;align-items:center;gap:8px;margin-top:12px;padding:10px 12px;border:1px solid #f1c1bd;border-radius:7px;color:#9a2d27;background:#fff4f3}.modal-backdrop{position:fixed;top:0;right:0;bottom:0;left:0;z-index:30;display:grid;place-items:center;padding:20px;background:#1219237a;animation:backdrop-enter .14s ease-out}.import-dialog{width:min(720px,100%);max-height:calc(100vh - 40px);overflow:auto;border-radius:8px;border:1px solid #d7dde4;background:#fff;box-shadow:0 18px 60px #12192338}.auth-dialog{width:min(560px,100%);max-height:calc(100vh - 40px);overflow:auto;border-radius:8px;border:1px solid #d7dde4;background:#fff;box-shadow:0 18px 60px #12192338}.cache-settings-dialog{width:min(680px,100%);max-height:calc(100vh - 40px);overflow:auto;border:1px solid #d7dde4;border-radius:8px;background:#fff;box-shadow:0 18px 60px #12192338}.cache-settings-body{display:grid;gap:16px;padding:18px 20px}.cache-location-row,.cache-settings-details>div{display:grid;grid-template-columns:150px minmax(0,1fr);align-items:start;gap:14px}.cache-location-row>span,.cache-settings-details dt{color:#657181;font-size:12px;font-weight:800}.cache-location-row code,.cache-settings-details dd{min-width:0;margin:0;overflow-wrap:anywhere;color:#1d2a36;font-size:12px}.cache-settings-field{display:grid;gap:7px;color:#334152;font-size:12px;font-weight:800}.cache-settings-field input{width:100%;min-height:40px;padding:0 11px;border:1px solid #bdc8d4;border-radius:6px;outline:0;color:#15202c;background:#fff}.cache-settings-field input:focus{border-color:#1b6b65;box-shadow:0 0 0 3px #1b6b651f}.cache-settings-notice{display:grid;grid-template-columns:auto minmax(0,1fr);gap:10px;padding:12px 0;border-block:1px solid #dbe7e4;color:#285c55}.cache-settings-notice.warning{border-color:#ead9ad;color:#765b16}.cache-settings-notice strong{font-size:13px}.cache-settings-notice p{margin:4px 0 0;color:#657181;font-size:12px;line-height:1.55}.cache-settings-details{display:grid;gap:9px;margin:0}.cache-settings-actions{justify-content:space-between}.cache-settings-actions>div{display:flex;gap:8px}.api-config-dialog{width:80vw;min-width:1000px;max-width:80vw;max-height:calc(100vh - 40px);overflow:auto;border-radius:8px;border:1px solid #d7dde4;background:#fff;box-shadow:0 18px 60px #12192338}.import-dialog-header{display:flex;align-items:flex-start;justify-content:space-between;gap:16px;padding:18px 20px 14px;border-bottom:1px solid #e5eaf0}.import-dialog-header h2{margin:0;font-size:20px}.import-badge{display:inline-flex;align-items:center;min-height:28px;padding:0 10px;border-radius:999px;font-size:12px;font-weight:800;white-space:nowrap}.import-badge.running{color:#8a5b00;background:#fff4d8}.import-badge.success{color:#176b4f;background:#e5f6ef}.import-badge.error{color:#a8322b;background:#fff0ef}.progress-track{height:8px;margin:16px 20px 0;overflow:hidden;border-radius:999px;background:#e9eef3}.progress-bar{height:100%;border-radius:inherit;background:#1b6b65;transition:width .24s ease}.progress-bar.running{background:linear-gradient(90deg,#1b6b65,#4f8fcb)}.progress-bar.success{background:#168456}.progress-bar.error{background:#c23131}.import-summary{display:grid;gap:12px;padding:18px 20px}.auth-dialog-body{display:grid;gap:14px;padding:18px 20px}.api-config-body{display:grid;gap:14px;padding:18px 20px;background:#f7f9fb}.api-config-tabs{display:inline-flex;width:fit-content;gap:4px;padding:3px;border:1px solid #d4dce5;border-radius:7px;background:#fff}.api-config-tabs button{display:inline-flex;align-items:center;justify-content:center;gap:6px;min-height:32px;padding:0 12px;border:0;border-radius:5px;color:#566373;background:transparent;font-size:13px;font-weight:800}.api-config-tabs button.active{color:#fff;background:#1b6b65}.api-config-errors{display:flex;align-items:flex-start;gap:10px;padding:10px 12px;border:1px solid #efcbc8;border-radius:7px;color:#8f2f29;background:#fff7f6}.api-config-errors strong{display:block;margin-bottom:4px;font-size:13px}.api-config-errors p{margin:0;font-size:12px;line-height:1.45}.api-cli-editor{width:100%;min-height:calc(4.65em + 24px);max-height:calc(24.8em + 24px);overflow-y:auto;resize:vertical;padding:12px;border:1px solid #334155;border-radius:7px;outline:0;color:#e5edf6;background:#111827;font-family:SFMono-Regular,Consolas,monospace;font-size:12px;line-height:1.55}.api-cli-editor::placeholder{color:#94a3b8}.api-cli-editor:focus{border-color:#5aa69d;box-shadow:0 0 0 3px #5aa69d38}.api-config-section{display:grid;gap:12px;padding:14px;border:1px solid #dfe5eb;border-radius:8px;background:#fff}.section-title-row{display:flex;align-items:flex-start;justify-content:space-between;gap:12px}.section-title-row h3{margin:0;color:#243242;font-size:15px}.section-title-row p{margin:4px 0 0;color:#657181;font-size:12px}.section-title-row code{max-width:420px;overflow:hidden;padding:5px 7px;border:1px solid #dce2e9;border-radius:6px;color:#415166;background:#f7f9fb;text-overflow:ellipsis;white-space:nowrap}.api-config-grid{display:grid;grid-template-columns:140px repeat(2,minmax(0,1fr));gap:10px}.api-config-grid.compact{grid-template-columns:repeat(3,minmax(0,1fr)) auto}.api-config-grid label,.field-config-row label{display:grid;gap:5px;min-width:0;color:#647182;font-size:12px;font-weight:800}.api-config-grid input,.api-config-grid select,.api-config-grid textarea,.field-config-row input,.field-config-row select{width:100%;min-height:36px;padding:0 10px;border:1px solid #cfd7e1;border-radius:6px;outline:0;color:#15202c;background:#fff}.api-config-grid textarea{min-height:82px;padding:10px;resize:vertical;line-height:1.45}.span-2{grid-column:span 2}.span-all{grid-column:1 / -1}.inline-check{display:inline-flex;align-items:center;gap:6px;min-height:32px;color:#415166;font-size:13px;font-weight:800}.field-config-table{display:grid;gap:8px;overflow-x:auto}.field-config-item{display:grid;gap:8px}.field-config-head,.field-config-row{display:grid;grid-template-columns:minmax(150px,1.1fr) 120px 58px minmax(180px,1.2fr) minmax(120px,.8fr) 38px;gap:8px;align-items:center;min-width:760px}.field-config-head.with-location,.field-config-row.with-location{grid-template-columns:98px minmax(150px,1.1fr) 120px 58px minmax(180px,1.2fr) minmax(120px,.8fr) 38px}.field-config-head{color:#657181;font-size:12px;font-weight:900}.field-check{place-items:center}.field-check input,.inline-check input{width:16px;min-height:16px}.icon-danger-button{display:inline-flex;align-items:center;justify-content:center;width:36px;height:36px;border:1px solid #efcbc8;border-radius:6px;color:#b63831;background:#fff7f6}.field-add-row{display:inline-flex;align-items:center;justify-content:center;gap:6px;min-height:34px;border:1px dashed #b8c4d0;border-radius:6px;color:#415166;background:#fbfcfd;font-weight:800}.child-field-config{display:grid;gap:8px;margin-left:18px;padding:10px;border-left:3px solid #b9d7d3;border-radius:0 7px 7px 0;background:#f7fbfa}.child-field-title{color:#415166;font-size:12px;font-weight:900}.response-config{display:grid;gap:10px;padding:12px;border:1px solid #e3e8ee;border-radius:7px;background:#fbfcfd}.auth-message{display:flex;align-items:flex-start;gap:8px;padding:10px 12px;border:1px solid #d9e0e7;border-radius:7px;color:#2f3d4d;background:#f7f9fb}.auth-target{display:grid;gap:4px}.auth-target span,.auth-fields label{color:#657181;font-size:12px;font-weight:800}.auth-target strong{overflow-wrap:anywhere;color:#1f2b38;font-family:SFMono-Regular,Consolas,monospace;font-size:13px;line-height:1.5}.auth-fields{display:grid;gap:10px}.auth-fields label{display:grid;gap:6px}.auth-fields input{width:100%;min-height:38px;padding:0 10px;border:1px solid #cfd7e1;border-radius:6px;outline:0;color:#15202c;background:#fff}.import-summary div:not(.import-counts):not(.import-error){display:grid;gap:4px}.import-summary span{color:#657181;font-size:12px;font-weight:700}.import-summary strong{overflow-wrap:anywhere;color:#1f2b38;font-family:SFMono-Regular,Consolas,monospace;font-size:13px;line-height:1.5}.import-counts{display:flex;flex-wrap:wrap;gap:8px}.import-counts span{padding:6px 9px;border-radius:6px;color:#1b6b65;background:#e7f4f2}.import-error{display:flex;align-items:flex-start;gap:8px;padding:10px 12px;border:1px solid #f1c1bd;border-radius:7px;color:#9a2d27;background:#fff4f3}.import-dialog-actions{display:flex;justify-content:flex-end;padding:0 20px 18px}.state-screen,.empty-state{display:grid;place-items:center;align-content:center;min-height:100vh;padding:24px;text-align:center}.empty-state{min-height:60vh}.state-icon{width:42px;height:42px;margin-bottom:14px;color:#1b6b65}.state-icon.error{color:#b8312d}.state-screen h1,.empty-state h2{margin-bottom:8px}.spin{animation:spin 1s linear infinite}@keyframes spin{to{transform:rotate(360deg)}}@keyframes backdrop-enter{0%{opacity:0}}@keyframes dialog-enter{0%{opacity:0;transform:translateY(8px)}}@media(max-width:980px){.app-shell{height:auto;padding:12px;overflow:visible}.topbar{align-items:flex-start;flex-direction:column}.topbar-actions{width:100%;justify-content:space-between}.version-switcher,.version-switcher select{width:100%}.version-manager{width:100%;min-width:0}.version-item-main,.version-env-editor,.version-env-summary{grid-template-columns:1fr}.version-item-stats,.version-item-actions{justify-content:flex-start}.source-panel{grid-template-columns:1fr}.source-panel-header{align-items:stretch;flex-direction:column}.source-panel-header>.secondary-button,.source-panel-actions,.source-tabs{width:100%}.source-panel-actions{justify-content:stretch}.source-panel-actions .secondary-button{flex:1 1 180px}.source-tabs{flex-wrap:wrap}.document-dialog-tabs{width:100%}.source-form,.source-auth,.source-auth-fields,.api-config-grid,.api-config-grid.compact{grid-template-columns:1fr}.span-2,.span-all{grid-column:auto}.workspace{grid-template-columns:1fr;flex:none;height:auto}.sidebar{max-height:46vh}.detail-pane{min-height:60vh}.detail-header{flex-direction:column}.copy-preview-toolbar{align-items:stretch;flex-direction:column}.copy-tabs,.copy-inline-button{width:100%}.copy-tabs button{flex:1;justify-content:center}.request-line,.tester-grid,.links-grid,.tester-form-grid{grid-template-columns:1fr}}@media(max-width:640px){.filters{grid-template-columns:1fr}.method-tabs{grid-template-columns:repeat(3,minmax(0,1fr))}.topbar-actions,.sync-meta{align-items:stretch;flex-direction:column;width:100%}.primary-button,.secondary-button,.copy-inline-button,.source-tabs{width:100%}.source-tabs button{flex:1}.document-dialog{max-height:calc(100vh - 20px)}.document-dialog-tabs{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));overflow:visible;padding-inline:12px}.document-dialog-tabs button{min-width:0;padding-inline:6px}.document-dialog-body{min-height:210px;padding:16px}.document-dialog-actions .clear-document-source{margin-right:0}.import-dialog-actions .secondary-button{width:100%}.import-dialog-actions{flex-direction:column-reverse;gap:8px}.cache-location-row,.cache-settings-details>div{grid-template-columns:1fr;gap:5px}.cache-settings-actions,.cache-settings-actions>div{display:grid;width:100%}.endpoint-title-line{align-items:flex-start;flex-direction:column}}

package/dist/index.html

@@ -4,8 +4,8 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>API Skill Console</title>
-    <script type="module" crossorigin src="/assets/index-CV6e3HAP.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-slFOragU.css">
+    <script type="module" crossorigin src="/assets/index-B_wAJLu_.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-CHOQ6xhP.css">
   </head>
   <body>
     <div id="root"></div>

package/docs/cli.md

@@ -35,6 +35,19 @@ You can also run the executable directly:
 node scripts/apiskill-cli.mjs --help
 ```
 
+## Cache Settings
+
+Web, CLI, and MCP share the saved default in `~/.apiskill/config.json`:
+
+```bash
+apiskill cache show
+apiskill cache show --json
+apiskill cache set /absolute/path/to/apiskill-cache
+apiskill cache reset
+```
+
+Changing the default never moves or deletes existing files. Future CLI and MCP processes use the new location immediately; restart Web or use Update Cache Location in version management to copy selected versions. `APISKILL_CACHE_DIR` has priority over the saved setting.
+
 ## Import Documents
 
 Check whether a usable cache is available:

package/docs/cli.zh.md

@@ -35,6 +35,19 @@ npm run cli -- --help
 node scripts/apiskill-cli.mjs --help
 ```
 
+## 缓存设置
+
+Web、CLI 和 MCP 共用保存在 `~/.apiskill/config.json` 中的默认缓存地址：
+
+```bash
+apiskill cache show
+apiskill cache show --json
+apiskill cache set /absolute/path/to/apiskill-cache
+apiskill cache reset
+```
+
+修改默认地址不会移动或删除已有缓存文件。后续 CLI、MCP 进程会直接使用新地址，Web 需要重启；也可以在 Web 版本管理中选择“更新缓存地址”，将需要的版本复制到新目录。`APISKILL_CACHE_DIR` 环境变量优先于保存的默认设置。
+
 ## 导入文档
 
 先检查当前是否有可用缓存：

package/docs/web.md

@@ -20,6 +20,8 @@ npm run dev
 
 Open the local URL printed by the terminal.
 
+Cache Settings in the upper-right corner shows the active session location and changes the saved default. Existing files are never moved or deleted. Restart Web to use the new location; Update Cache Location on a version shows the source and destination before copying while retaining the source file.
+
 ## Import Sources
 
 The web app supports four import paths:

package/docs/web.zh.md

@@ -20,6 +20,8 @@ npm run dev
 
 打开终端输出的本地地址。
 
+页面右上角“缓存设置”用于查看当前会话位置和修改默认缓存地址。修改设置不会移动或删除已有文件；Web 重启后使用新地址。版本管理中每个版本的“更新缓存地址”会先展示当前位置和目标位置，确认后复制该版本，并保留源文件。
+
 ## 导入来源
 
 “新建文档”弹窗通过 Tab 支持空白文档和四种导入方式：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apiskill",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "type": "module",
   "files": [
     "src",
@@ -34,13 +34,13 @@
     "lucide-react": "^0.468.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
+    "typescript": "^5.8.3",
     "vite": "^6.0.7",
     "yaml": "^2.8.3"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",
     "@types/react": "^18.3.18",
-    "@types/react-dom": "^18.3.5",
-    "typescript": "^7.0.2"
+    "@types/react-dom": "^18.3.5"
   }
 }

package/scripts/apiskill-cli.mjs

@@ -19,7 +19,7 @@ import {
 import { crawlOpenApi, importFromCurl, importFromLocalFile, importFromUrl } from './lib/openapi-importer.mjs';
 import { checkCache, formatCheckText, queryEndpoints } from './lib/apiskill-core.mjs';
 import { startMockServer } from './lib/mock-server.mjs';
-import { getDefaultCacheDir } from './lib/cache-paths.mjs';
+import { getCacheSettings, getDefaultCacheDir, resetDefaultCacheDir, setDefaultCacheDir } from './lib/cache-paths.mjs';
 
 const program = new Command();
 const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
@@ -41,6 +41,8 @@ Examples:
   apiskill import-file ./openapi.json
   apiskill import-curl --file ./request.curl
   apiskill run web
+  apiskill cache show
+  apiskill cache set ~/.apiskill/cache
   apiskill mock
   apiskill document create --title "My API" --doc-version 1.0.0
   apiskill check
@@ -59,6 +61,36 @@ CLI config format:
 `,
   );
 
+const cache = program.command('cache').description('View or change the shared default document cache directory.');
+
+cache
+  .command('show')
+  .description('Show the active and saved default cache directories.')
+  .option('-j, --json', 'Print JSON')
+  .action((options) => {
+    const settings = getCacheSettings();
+    print(options.json ? settings : formatCacheSettingsText(settings));
+  });
+
+cache
+  .command('set')
+  .description('Save the default cache directory used by future CLI, MCP, and Web processes. Existing files are not moved.')
+  .argument('<directory>', 'Absolute path or a path beginning with ~/')
+  .option('-j, --json', 'Print JSON')
+  .action(async (directory, options) => {
+    const settings = await setDefaultCacheDir(directory);
+    print(options.json ? settings : `${formatCacheSettingsText(settings)}\nExisting cached files were not moved.`);
+  });
+
+cache
+  .command('reset')
+  .description('Restore the built-in ~/.apiskill/cache default. Existing files are not moved.')
+  .option('-j, --json', 'Print JSON')
+  .action(async (options) => {
+    const settings = await resetDefaultCacheDir();
+    print(options.json ? settings : `${formatCacheSettingsText(settings)}\nExisting cached files were not moved.`);
+  });
+
 const run = program.command('run').description('Run API Skill local services.');
 
 run
@@ -301,7 +333,6 @@ async function runWeb(options) {
   const host = options.host || '127.0.0.1';
 
   process.env.APISKILL_ROOT = projectRoot;
-  process.env.APISKILL_CACHE_DIR = cacheDir;
 
   const { createServer } = await import('vite');
   const server = await createServer({
@@ -374,3 +405,16 @@ function print(value) {
   if (typeof value === 'string') console.log(value);
   else console.log(JSON.stringify(value, null, 2));
 }
+
+function formatCacheSettingsText(settings) {
+  return [
+    `Active cache: ${settings.cacheDir}`,
+    `Saved default: ${settings.defaultCacheDir}`,
+    `Built-in default: ${settings.builtInCacheDir}`,
+    `Source: ${settings.source}`,
+    settings.environmentOverride ? `Environment override: ${settings.environmentCacheDir}` : '',
+    `Config: ${settings.configPath}`,
+  ]
+    .filter(Boolean)
+    .join('\n');
+}

package/scripts/lib/cache-paths.mjs

@@ -1,7 +1,98 @@
 import { homedir } from 'node:os';
-import { resolve } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+import { mkdir, rename, rm, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+
+const CONFIG_FILE_NAME = 'config.json';
+
+export function getCacheSettings(env = process.env) {
+  const appDataDir = getAppDataDir(env);
+  const configPath = resolve(appDataDir, CONFIG_FILE_NAME);
+  const builtInCacheDir = resolve(homedir(), '.apiskill', 'cache');
+  const configuredCacheDir = readConfiguredCacheDir(configPath);
+  const defaultCacheDir = configuredCacheDir || builtInCacheDir;
+  const environmentCacheDir = env.APISKILL_CACHE_DIR ? normalizeCacheDir(env.APISKILL_CACHE_DIR) : '';
+
+  return {
+    cacheDir: environmentCacheDir || defaultCacheDir,
+    defaultCacheDir,
+    configuredCacheDir,
+    builtInCacheDir,
+    environmentCacheDir,
+    environmentOverride: Boolean(environmentCacheDir),
+    source: environmentCacheDir ? 'environment' : configuredCacheDir ? 'config' : 'default',
+    configPath,
+  };
+}
 
 export function getDefaultCacheDir(env = process.env) {
-  if (env.APISKILL_CACHE_DIR) return resolve(env.APISKILL_CACHE_DIR);
-  return resolve(homedir(), '.apiskill', 'cache');
+  return getCacheSettings(env).cacheDir;
+}
+
+export async function setDefaultCacheDir(value, env = process.env) {
+  const cacheDir = normalizeCacheDir(value);
+  const settings = getCacheSettings(env);
+  await mkdir(cacheDir, { recursive: true });
+  const writeProbePath = resolve(cacheDir, `.apiskill-write-test-${process.pid}-${Date.now()}`);
+  try {
+    await writeFile(writeProbePath, 'ok');
+  } finally {
+    await rm(writeProbePath, { force: true }).catch(() => {});
+  }
+  await mkdir(dirname(settings.configPath), { recursive: true });
+
+  const currentConfig = readConfig(settings.configPath);
+  const nextConfig = {
+    ...currentConfig,
+    cacheDir,
+    cacheDirUpdatedAt: new Date().toISOString(),
+  };
+  const temporaryPath = `${settings.configPath}.${process.pid}.${Date.now()}.tmp`;
+  await writeFile(temporaryPath, JSON.stringify(nextConfig, null, 2));
+  await rename(temporaryPath, settings.configPath);
+  return getCacheSettings(env);
+}
+
+export async function resetDefaultCacheDir(env = process.env) {
+  const settings = getCacheSettings(env);
+  const currentConfig = readConfig(settings.configPath);
+  delete currentConfig.cacheDir;
+  currentConfig.cacheDirUpdatedAt = new Date().toISOString();
+  await mkdir(dirname(settings.configPath), { recursive: true });
+  const temporaryPath = `${settings.configPath}.${process.pid}.${Date.now()}.tmp`;
+  await writeFile(temporaryPath, JSON.stringify(currentConfig, null, 2));
+  await rename(temporaryPath, settings.configPath);
+  return getCacheSettings(env);
+}
+
+export function normalizeCacheDir(value) {
+  const input = String(value || '').trim();
+  if (!input) throw new Error('缓存目录不能为空');
+  if (input === '~') return homedir();
+  if (input.startsWith('~/')) return resolve(homedir(), input.slice(2));
+  return resolve(input);
+}
+
+function getAppDataDir(env) {
+  return env.APISKILL_CONFIG_DIR ? normalizeCacheDir(env.APISKILL_CONFIG_DIR) : resolve(homedir(), '.apiskill');
+}
+
+function readConfiguredCacheDir(configPath) {
+  const value = readConfig(configPath).cacheDir;
+  if (typeof value !== 'string' || !value.trim()) return '';
+  try {
+    return normalizeCacheDir(value);
+  } catch {
+    return '';
+  }
+}
+
+function readConfig(configPath) {
+  if (!existsSync(configPath)) return {};
+  try {
+    const parsed = JSON.parse(readFileSync(configPath, 'utf8'));
+    return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
+  } catch {
+    return {};
+  }
 }

package/scripts/test-shared-cache.mjs

@@ -1,6 +1,7 @@
 import assert from 'node:assert/strict';
 import { createServer } from 'node:net';
-import { mkdtemp, rm } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { mkdir, mkdtemp, rm } from 'node:fs/promises';
 import { homedir, tmpdir } from 'node:os';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -9,11 +10,15 @@ import { getDefaultCacheDir } from './lib/cache-paths.mjs';
 
 const projectRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
 const cliPath = resolve(projectRoot, 'scripts/apiskill-cli.mjs');
-const cacheDir = await mkdtemp(join(tmpdir(), 'apiskill-shared-cache-'));
+const testRoot = await mkdtemp(join(tmpdir(), 'apiskill-shared-cache-'));
+const cacheDir = resolve(testRoot, 'active-cache');
+const defaultCacheDir = resolve(testRoot, 'default-cache');
+const configDir = resolve(testRoot, 'config');
 const port = await findFreePort();
 let webProcess;
 
 try {
+  await mkdir(cacheDir, { recursive: true });
   assert.equal(getDefaultCacheDir({ APISKILL_ROOT: '/tmp/another-project' }), resolve(homedir(), '.apiskill', 'cache'));
 
   const created = JSON.parse(
@@ -42,7 +47,7 @@ try {
     [cliPath, 'run', 'web', '--host', '127.0.0.1', '--port', String(port), '--strict-port', '--cwd', projectRoot],
     {
       cwd: projectRoot,
-      env: { ...process.env, APISKILL_CACHE_DIR: cacheDir },
+      env: { ...process.env, APISKILL_CACHE_DIR: cacheDir, APISKILL_CONFIG_DIR: configDir },
       stdio: ['ignore', 'pipe', 'pipe'],
     },
   );
@@ -76,20 +81,50 @@ try {
 
   const check = JSON.parse(await runCli(['check', '--json']));
   assert.equal(check.cacheDir, cacheDir);
-  console.log(`Shared cache test passed: CLI and Web both read and wrote ${cacheDir}.`);
+
+  const settingsResponse = await fetch(`http://127.0.0.1:${port}/api/cache-settings`, {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ cacheDir: defaultCacheDir }),
+  });
+  const settings = await settingsResponse.json();
+  assert.equal(settingsResponse.status, 200, JSON.stringify(settings));
+  assert.equal(settings.activeCacheDir, cacheDir);
+  assert.equal(settings.defaultCacheDir, defaultCacheDir);
+  assert.equal(settings.environmentOverride, true);
+
+  const syncResponse = await fetch(`http://127.0.0.1:${port}/api/openapi/version-sync-cache`, {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ versionId }),
+  });
+  const synced = await syncResponse.json();
+  assert.equal(syncResponse.status, 200, JSON.stringify(synced));
+  assert.equal(synced.targetCacheDir, defaultCacheDir);
+  assert.ok(existsSync(resolve(cacheDir, 'versions', `${versionId}.json`)), 'Sync removed the source document');
+  assert.ok(existsSync(resolve(defaultCacheDir, 'versions', `${versionId}.json`)), 'Sync did not create the target document');
+
+  const cliFromNewDefault = JSON.parse(
+    await runCli(['api', 'query', 'POST', '/api/v1/from-web'], { cacheOverride: false }),
+  );
+  assert.equal(cliFromNewDefault.path, '/api/v1/from-web');
+  console.log(`Shared cache test passed: Web and CLI synchronized ${versionId} from ${cacheDir} to ${defaultCacheDir}.`);
 } finally {
   if (webProcess && webProcess.exitCode === null) {
     webProcess.kill('SIGTERM');
     await new Promise((resolvePromise) => webProcess.once('close', resolvePromise));
   }
-  await rm(cacheDir, { recursive: true, force: true });
+  await rm(testRoot, { recursive: true, force: true });
 }
 
-function runCli(args) {
+function runCli(args, { cacheOverride = true } = {}) {
   return new Promise((resolvePromise, rejectPromise) => {
+    const env = { ...process.env, APISKILL_CONFIG_DIR: configDir };
+    if (cacheOverride) env.APISKILL_CACHE_DIR = cacheDir;
+    else delete env.APISKILL_CACHE_DIR;
     const child = spawn(process.execPath, [cliPath, ...args], {
       cwd: projectRoot,
-      env: { ...process.env, APISKILL_CACHE_DIR: cacheDir },
+      env,
       stdio: ['ignore', 'pipe', 'pipe'],
     });
     const output = collectProcessOutput(child);

package/src/App.tsx

@@ -44,9 +44,12 @@ import {
   VERSION_DELETE_API_URL,
   VERSION_META_API_URL,
   VERSION_SELECT_API_URL,
+  VERSION_SYNC_CACHE_API_URL,
   VERSIONS_API_URL,
 } from './swagger';
 import { AddApiDialog } from './AddApiDialog';
+import { CacheSettingsDialog, loadCacheSettings } from './CacheSettingsDialog';
+import type { CacheSettings } from './CacheSettingsDialog';
 import { DocumentVersionManager } from './DocumentVersionManager';
 import type { DocumentVersionMeta } from './DocumentVersionManager';
 import type { ManualApiOperationConfig } from './manualApiConfig';
@@ -125,6 +128,16 @@ type VersionDeleteResponse = {
   nextVersionId?: string;
 };
 
+type VersionCacheSyncResponse = {
+  status: 'synced' | 'already-current';
+  versionId: string;
+  sourceCacheDir: string;
+  sourceDocumentPath: string;
+  targetCacheDir: string;
+  targetDocumentPath: string;
+  syncedAt?: string;
+};
+
 type AuthCheckResponse = {
   requiresAuth: boolean;
   status?: number;
@@ -220,6 +233,7 @@ export function App() {
   const [editingApiTarget, setEditingApiTarget] = useState<{ method: HttpMethod; path: string } | undefined>(undefined);
   const [operationLinkDrafts, setOperationLinkDrafts] = useState<Record<string, EndpointAssociationLinks>>({});
   const [savingApi, setSavingApi] = useState(false);
+  const [cacheSettings, setCacheSettings] = useState<CacheSettings | undefined>(undefined);
   const uploadInputRef = useRef<HTMLInputElement | null>(null);
 
   useEffect(() => {
@@ -236,6 +250,7 @@ export function App() {
 
     loadInitialCache();
     void loadMockStatus();
+    void loadCacheSettings().then(setCacheSettings).catch(() => {});
   }, []);
 
   const endpoints = useMemo(() => (doc ? listEndpoints(doc) : []), [doc]);
@@ -756,6 +771,17 @@ export function App() {
     setLoadState('ready');
   }
 
+  async function syncVersionToDefaultCache(versionId: string) {
+    const response = await fetch(VERSION_SYNC_CACHE_API_URL, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ versionId }),
+    });
+    const payload = await response.json();
+    if (!response.ok) throw new Error(payload.error || '文档同步到默认缓存地址失败');
+    return payload as VersionCacheSyncResponse;
+  }
+
   async function loadMockStatus() {
     try {
       const response = await fetch(MOCK_STATUS_API_URL, { cache: 'no-store' });
@@ -940,6 +966,8 @@ export function App() {
             onPrepareUpdate={prepareVersionUpdate}
             onUpdateEnvironment={updateVersionEnvironment}
             onDelete={deleteVersion}
+            cacheSettings={cacheSettings}
+            onSyncCache={syncVersionToDefaultCache}
           />
           <button
             className="primary-button"
@@ -957,6 +985,7 @@ export function App() {
             <span>Schema {stats.schemas}</span>
             <span>{lastSync ? `同步 ${formatDate(lastSync)}` : '未加载文档'}</span>
           </div>
+          <CacheSettingsDialog settings={cacheSettings} onSettingsChange={setCacheSettings} />
         </div>
       </header>