指南：基于官方 CLI 的 S3 兼容對象存儲 Agent 化封裝)
CLI-Anything Tigris Agent Harness 實戰(zhàn)指南基于官方 CLI 的 S3 兼容對象存儲 Agent 化封裝【免費下載鏈接】CLI-AnythingCLI-Anything: Making ALL Software Agent-Native -- CLI-Hub: https://clianything.cc/項目地址: https://gitcode.com/GitHub_Trending/cl/CLI-Anything本篇技術(shù)指南圍繞倉庫tigris/agent-harness/TIGRIS.md展開系統(tǒng)講解 CLI-Anything 項目如何將 Tigris全球分布式、S3 兼容、免出口流量費的對象存儲服務(wù)的官方命令行工具封裝為面向編碼 Agent 的標準操作流程SOP工具包。讀完本文你將掌握該 Harness 的安裝配置、七大類命令組auth / bucket / object / presign / snapshot / access-key / iam的完整用法、兩種輸出模式人類可讀與--json機器可讀的取舍以及如何結(jié)合子進程封裝、環(huán)境變量注入等源碼機制讓 Claude Code、Codex 等 Agent 安全地管理快照、IAM、作用域訪問密鑰等 Tigris 原生能力。設(shè)計定位為什么是包裝 CLI而不是重寫 S3 協(xié)議Tigris 是一個全球分布式、S3 兼容的對象存儲服務(wù)其顯著特點是無出口流量費no egress fees。CLI-Anything 的 Tigris Harness 在設(shè)計上做出了一個關(guān)鍵決策直接包裝官方tigrisCLI而不是用 Python 重新實現(xiàn) S3 協(xié)議。這一決策帶來了兩個直接收益見 tigris/agent-harness/cli_anything/tigris/tigris_cli.py 與 utils/tigris_backend.py 的模塊注釋Agent 能觸達 Tigris 的全部原語快照snapshots、IAM、作用域訪問密鑰scoped access keys、組織organizations、OAuth——這些是通用 S3 端點不具備的 Tigris 獨有能力自動繼承上游新命令上游 CLI 發(fā)布新命令后Harness 無需改動即可使用。同時TIGRIS.md 明確劃定了使用邊界這是 Tigris CLI 專用工具不要把它當作通用 S3 端點封裝也不要當作 MinIO、Cloudflare R2、AWS S3 或其他任意 S3 兼容端點的管理工具——它只會向官方tigris二進制發(fā)起子進程調(diào)用并遵循該 CLI 的認證與命令模型。從源碼結(jié)構(gòu)看整個 Harness 的核心調(diào)用鏈是click命令組tigris_cli.py→TigrisBackendutils/tigris_backend.py→subprocess.run([tigris, ...])。setup.py的依賴聲明中特意注明no boto3見 setup.py進一步印證了零協(xié)議重實現(xiàn)、純子進程封裝的架構(gòu)取向。環(huán)境要求與安裝TIGRIS.md 列出的前置條件如下Python 3.10代碼使用 PEP 604 聯(lián)合類型語法如str | None與 PEP 585 泛型。macOS 系統(tǒng)自帶 Python 為 3.9需使用pyenv、uv或brew install python3.12升級tigrisCLI 必須在 PATH 上二選一安裝npm install -g tigrisdata/cli brew install tigrisdata/tap/tigris安裝后執(zhí)行一次tigris login完成瀏覽器 OAuth 認證。安裝 Harness 本身則通過cd tigris/agent-harness pip install -e .[dev]安裝后獲得cli-anything-tigris控制臺入口見 setup.py 的entry_points配置同時支持python -m cli_anything.tigris模塊入口見main.py。二進制可用性的優(yōu)雅降級TigrisBackend.init通過shutil.which(cli_path)解析二進制路徑若找不到會拋出TigrisCliError并附帶安裝提示。而在 CLI 入口中這個錯誤被延遲處理——ctx.obj[backend]置為None從而保證即使沒有安裝tigris二進制--help依然可用見 tigris_cli.py。這是一個值得借鑒的 CLI 設(shè)計細節(jié)。全局入口與命令行選項Harness 的根命令cli是一個click分組支持四個全局選項見 tigris_cli.py選項默認值說明--jsonFalse以 JSON 格式輸出透傳上游--format json--cli-pathtigristigris二進制路徑二進制別名t3也可用--access-keyNone可選訪問密鑰 ID導出到子進程環(huán)境變量--secret-keyNone可選秘密密鑰導出到子進程環(huán)境變量調(diào)用方式cli-anything-tigris --json bucket list cli-anything-tigris object put --bucket my-bucket --key hello.txt --text hello此外入口還設(shè)置了auto_envvar_prefixTIGRIS_CLI意味著所有參數(shù)都可以通過TIGRIS_CLI_*前綴的環(huán)境變量注入。不帶任何子命令啟動時會進入交互式 REPL內(nèi)置help/quit/exit命令并提供一份完整的命令速查表見 tigris_cli.py。后端原理子進程封裝與雙環(huán)境變量認證TigrisBackend._run 是整條鏈路的發(fā)動機其工作方式完全呼應(yīng) TIGRIS.md 的 Backend Description每條命令構(gòu)建tigris args --format json調(diào)用--format json追加在末尾避免與子命令解析沖突通過subprocess.run執(zhí)行默認checkTrue非零退出碼拋出TigrisCliError并攜帶 stderr 信息jsonTrue時解析 stdout 為 JSON若上游命令不支持 JSON 輸出如login、cp解析失敗則回退為原始文本captureFalse時如login直接流式輸出到調(diào)用方 TTY。認證機制方面默認情況下憑證由tigrisCLI 自身解析——即tigris login建立的 OAuth 會話。若顯式傳入--access-key/--secret-key則會在子進程環(huán)境中同時注入四組變量見 tigris_backend.pyTIGRIS_STORAGE_ACCESS_KEY_ID / TIGRIS_STORAGE_SECRET_ACCESS_KEY AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY同時注入TIGRIS_STORAGE_*與AWS_*兩組前綴是為了兼容依賴環(huán)境變量認證的混合部署場景。大部分用戶應(yīng)優(yōu)先使用tigris login。路徑歸一化t3://與tigris://后端模塊中的_path_to_t3工具函數(shù)統(tǒng)一將tigris://...、裸bucket/key、/bucket/key歸一化為t3://...見 tigris_backend.py對應(yīng)的單元測試在 tests/test_core.py 中覆蓋了全部四種輸入形態(tài)。對象層還提供了_parse_tigris_uri將 URI 拆解為(bucket, key)二元組并拒絕非法路徑見 core/object.py。七大命令組全解1.auth登錄 / 登出 / 身份查詢包裝tigris login/logout/whoami見 core/auth.pycli-anything-tigris auth login # 瀏覽器 OAuth 登錄流式輸出到終端 cli-anything-tigris auth logout cli-anything-tigris auth whoami # 打印當前用戶 / 組織whoami在--json下輸出帶縮進的 JSON否則以section/status的皮膚樣式展示鍵值對。2.bucket存儲桶生命周期管理包裝tigris buckets ...見 core/bucket.pycli-anything-tigris bucket list cli-anything-tigris bucket create --name my-bucket cli-anything-tigris bucket delete --name my-bucket --yes # 必須顯式 --yes cli-anything-tigris bucket info my-bucket # 即 tigris buckets get關(guān)鍵安全語義delete命令在未傳--yes時直接拒絕執(zhí)行輸出錯誤并退出碼 1見 bucket.py。列表與 info 輸出會同時兼容小寫name/created與首字母大寫Name/CreationDate兩種字段命名以適配上游 CLI 的 JSON 結(jié)構(gòu)差異。3.object對象讀寫與復制包裝tigris ls/cp/rm/stat見 core/object.py# 列出支持前綴過濾 客戶端側(cè) limit 截斷 cli-anything-tigris object list --bucket my-bucket [--prefix logs/] [--limit 100] # 上傳文件或內(nèi)聯(lián)文本二選一 cli-anything-tigris object put --bucket my-bucket --key data.json --file ./data.json cli-anything-tigris object put --bucket my-bucket --key note.txt --text hello world # 下載與刪除 cli-anything-tigris object get --bucket my-bucket --key data.json --output ./out.json cli-anything-tigris object delete --bucket my-bucket --key data.json # 元數(shù)據(jù)stat cli-anything-tigris object info --bucket my-bucket --key data.json # 復制本地?t3 或 t3?t3支持 -r 遞歸 cli-anything-tigris object cp ./local.txt t3://my-bucket/remote.txt cli-anything-tigris object cp -r t3://src-bucket/dir/ t3://dst-bucket/dir/實現(xiàn)細節(jié)值得注意--file與--text必須且只能提供其一否則退出碼 2 并報錯見 object.py內(nèi)聯(lián)文本上傳通過tempfile.NamedTemporaryFile落盤后走tigris cpfinally中清理臨時文件見 tigris_backend.pycp命令要求 src/dst 至少一側(cè)是t3://或tigris://URI否則拒絕執(zhí)行見 object.py對象刪除實際調(diào)用tigris rm ... --yes。4.presign預簽名 URL包裝tigris presign見 core/presign.pycli-anything-tigris presign get --bucket my-bucket --key data.json [--expires 3600] cli-anything-tigris presign put --bucket my-bucket --key upload.bin [--expires 3600] [--access-key KEY_ID]--expires默認 3600 秒--access-key可選指定簽名用的訪問密鑰 ID默認自動解析后端兼容兩種上游返回形態(tài)JSON 字典中的url字段或裸字符串 URL見 tigris_backend.py--json模式輸出{url: ..., method: GET, expires_in: ...}信封。Agent 場景價值預簽名 URL 可以把對象訪問權(quán)臨時移交給其他工具或下游 Agent全程不共享任何憑證。5.snapshot存儲桶快照包裝tigris snapshots list/take見 core/snapshot.py?？煺帐谴鎯ν盃顟B(tài)的時間點只讀副本屬于 Tigris 獨有、通用 S3 兼容廠商不提供的 Agent 存儲原語cli-anything-tigris snapshot list my-bucket cli-anything-tigris snapshot take my-bucket [--name pre-migration]TIGRIS.md 的 Agent 使用規(guī)范建議在破壞性操作之前先snapshot take建立恢復點之后用snapshot list找到要恢復的快照。6.access-key作用域訪問密鑰包裝tigris access-keys見 core/access_key.py是 Harness 中最完整的命令組cli-anything-tigris access-key list cli-anything-tigris access-key create agent-run-42 # 密鑰僅顯示一次 cli-anything-tigris access-key get KEY_ID cli-anything-tigris access-key delete KEY_ID --yes # 必須 --yes cli-anything-tigris access-key assign KEY_ID --bucket my-bucket --role Editor cli-anything-tigris access-key rotate KEY_ID --yes # 必須 --yes源碼中的安全細節(jié)create與rotate在人類可讀模式下會明確提示secret shown ONCE, save it now見 access_key.pydelete與rotate均設(shè)有--yes防線未顯式確認時拒絕調(diào)用后端見 access_key.pyassign通過--bucket--role如Editor、Viewer把密鑰作用域收窄到單個桶實現(xiàn)最小權(quán)限。Agent 場景價值每次 Agent 運行可以access-key create鑄造一把臨時作用域密鑰 →assign限定桶與角色 → 任務(wù)結(jié)束delete撤銷做到一次運行、一把密鑰、用完即銷。7.iam策略與用戶管理包裝tigris iam policies與tigris iam users見 core/iam.py# 策略 cli-anything-tigris iam policy list cli-anything-tigris iam policy create my-policy --document ./policy.json # 用戶 cli-anything-tigris iam user list cli-anything-tigris iam user invite someoneexample.com [--role member]user invite的--role默認member。IAM 策略配合access-key assign讓 Agent / 組織可以向程序化客戶端授予狹窄、可審計的權(quán)限見 iam.py 模塊注釋。輸出模式人類可讀與機器可讀TIGRIS.md 將輸出模式分為兩類人類可讀默認通過ReplSkin渲染表格、顏色與格式化文本。各命令組都做了字段名兼容如桶列表同時識別name/Name、created/CreationDate并將結(jié)果整理為 Name / Created、Key / Size / Modified 等表頭機器可讀--json透傳上游 CLI 的--format json原始輸出對不支持 JSON 的原生命令如cp則包一層薄信封例如{src: ..., dst: ..., status: copied}。錯誤路徑在--json下輸出{error: ...}結(jié)構(gòu)。REPL 皮膚來自倉庫中未修改復用的ReplSkin見 utils/repl_skin.py對應(yīng) TIGRIS.md 架構(gòu)圖中的 unified REPL skin。Agent 使用規(guī)范SOPTIGRIS.md 為編碼 Agent 總結(jié)了一套可直接落地的操作規(guī)范輸出可解析調(diào)用時傳--json檢查返回碼0 表示成功讀 stderr錯誤信息從 stderr 獲取服務(wù)端復制使用object cp t3://src/key t3://dst/key做服務(wù)端拷貝——數(shù)據(jù)不流經(jīng) Agent不產(chǎn)生出口流量費預簽名移交用presign get/put把對象訪問權(quán)移交給其他工具或下游 Agent不共享憑證快照兜底破壞性操作前snapshot take建立恢復點snapshot list查找恢復目標臨時密鑰access-key createaccess-key assign --bucket B --role Editor為單次 Agent 運行鑄造作用域密鑰結(jié)束后access-key delete撤銷顯式確認桶刪除、訪問密鑰刪除、密鑰輪換都必須顯式傳--yes否則 Harness 拒絕調(diào)用后端——這是 Harness 內(nèi)置的最后一道安全閘門。測試體系從 Mock 單測到真實 E2ETIGRIS.md 與 tests/TEST.md 共同定義了兩層測試單元測試層tests/test_core.pycd tigris/agent-harness pip install -e .[dev] pytest cli_anything/tigris/tests/test_core.py -vsubprocess.run被完全 Mock模塊加載時連shutil.which也被 patch因此無需安裝tigrisCLI、無需網(wǎng)絡(luò)即可跑通適合任何 CI 環(huán)境覆蓋范圍包括URI/路徑歸一化、二進制解析失敗、憑證環(huán)境變量導出、七組命令的參數(shù)拼裝、非零退出碼拋TigrisCliError、CLI 集成層的--json輸出等。端到端測試層tests/test_full_e2e.py默認跳過需要三把鑰匙同時滿足npm install -g tigrisdata/cli tigris login export CLI_ANYTHING_TIGRIS_TEST_BUCKETyour-test-bucket export CLI_ANYTHING_TIGRIS_RUN_E2E1 pytest cli_anything/tigris/tests/test_full_e2e.py -vE2E 覆蓋whoami會話非空、測試桶存在、對象 put/get/head/list/delete 全鏈路回環(huán)、預簽名 URL 格式正確且包含 key 末段、snapshots list成功等場景。每個測試用 per-run UUID 前綴避免多開發(fā)者 / CI 并發(fā)撞鍵finally塊兜底清理。目錄結(jié)構(gòu)速覽TIGRIS.md 給出了完整的架構(gòu)布局倉庫實際目錄與之完全對應(yīng)tigris/agent-harness/ ├── setup.py # cli, prompt-toolkit; 無 boto3 ├── TIGRIS.md # 本文檔 └── cli_anything/tigris/ ├── __main__.py # python -m 入口 ├── tigris_cli.py # click CLI REPL 分發(fā)器 ├── core/ # auth / bucket / object / presign / snapshot / access_key / iam ├── utils/ # tigris_backend.py子進程封裝 repl_skin.py統(tǒng)一皮膚 ├── skills/SKILL.md # Agent 技能文檔 └── tests/ # test_core.pyMock 單測 test_full_e2e.py環(huán)境門控 E2E小結(jié)CLI-Anything 的 Tigris Harness 用包裝官方 CLI、絕不重寫協(xié)議這一克制的架構(gòu)選擇換來了全量原語覆蓋 零維護升級 OAuth 原生認證三大優(yōu)勢。對 Agent 開發(fā)者而言它提供了一條把對象存儲變成 Agent 原生能力的成熟路徑--json機器可讀輸出保證可解析性--yes防線保證破壞性操作可控快照 作用域密鑰 預簽名 URL 三件套則分別覆蓋了回滾、最小權(quán)限、憑證隔離三大 Agent 存儲安全訴求。結(jié)合 Mock 單測與真實 E2E 雙測試體系這套 Harness 可以放心地嵌入任何 Agent 工作流。【免費下載鏈接】CLI-AnythingCLI-Anything: Making ALL Software Agent-Native -- CLI-Hub: https://clianything.cc/項目地址: https://gitcode.com/GitHub_Trending/cl/CLI-Anything創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 CLI-Anything Tigris Agent Harness 實戰(zhàn)指南：基于官方 CLI 的 S3 兼容對象存儲 Agent 化封裝
CLI-Anything Tigris Agent Harness 實戰(zhàn)指南基于官方 CLI 的 S3 兼容對象存儲 Agent 化封裝【免費下載鏈接】CLI-AnythingCLI-Anything: Making ALL Software Agent-Native -- CLI-Hub: https://clianything.cc/項目地址: https://gitcode.com/GitHub_Trending/cl/CLI-Anything本篇技術(shù)指南圍繞倉庫tigris/agent-harness/TIGRIS.md展開系統(tǒng)講解 CLI-Anything 項目如何將 Tigris全球分布式、S3 兼容、免出口流量費的對象存儲服務(wù)的官方命令行工具封裝為面向編碼 Agent 的標準操作流程SOP工具包。讀完本文你將掌握該 Harness 的安裝配置、七大類命令組auth / bucket / object / presign / snapshot / access-key / iam的完整用法、兩種輸出模式人類可讀與--json機器可讀的取舍以及如何結(jié)合子進程封裝、環(huán)境變量注入等源碼機制讓 Claude Code、Codex 等 Agent 安全地管理快照、IAM、作用域訪問密鑰等 Tigris 原生能力。設(shè)計定位為什么是包裝 CLI而不是重寫 S3 協(xié)議Tigris 是一個全球分布式、S3 兼容的對象存儲服務(wù)其顯著特點是無出口流量費no egress fees。CLI-Anything 的 Tigris Harness 在設(shè)計上做出了一個關(guān)鍵決策直接包裝官方tigrisCLI而不是用 Python 重新實現(xiàn) S3 協(xié)議。這一決策帶來了兩個直接收益見 tigris/agent-harness/cli_anything/tigris/tigris_cli.py 與 utils/tigris_backend.py 的模塊注釋Agent 能觸達 Tigris 的全部原語快照snapshots、IAM、作用域訪問密鑰scoped access keys、組織organizations、OAuth——這些是通用 S3 端點不具備的 Tigris 獨有能力自動繼承上游新命令上游 CLI 發(fā)布新命令后Harness 無需改動即可使用。同時TIGRIS.md 明確劃定了使用邊界這是 Tigris CLI 專用工具不要把它當作通用 S3 端點封裝也不要當作 MinIO、Cloudflare R2、AWS S3 或其他任意 S3 兼容端點的管理工具——它只會向官方tigris二進制發(fā)起子進程調(diào)用并遵循該 CLI 的認證與命令模型。從源碼結(jié)構(gòu)看整個 Harness 的核心調(diào)用鏈是click命令組tigris_cli.py→TigrisBackendutils/tigris_backend.py→subprocess.run([tigris, ...])。setup.py的依賴聲明中特意注明no boto3見 setup.py進一步印證了零協(xié)議重實現(xiàn)、純子進程封裝的架構(gòu)取向。環(huán)境要求與安裝TIGRIS.md 列出的前置條件如下Python 3.10代碼使用 PEP 604 聯(lián)合類型語法如str | None與 PEP 585 泛型。macOS 系統(tǒng)自帶 Python 為 3.9需使用pyenv、uv或brew install python3.12升級tigrisCLI 必須在 PATH 上二選一安裝npm install -g tigrisdata/cli brew install tigrisdata/tap/tigris安裝后執(zhí)行一次tigris login完成瀏覽器 OAuth 認證。安裝 Harness 本身則通過cd tigris/agent-harness pip install -e .[dev]安裝后獲得cli-anything-tigris控制臺入口見 setup.py 的entry_points配置同時支持python -m cli_anything.tigris模塊入口見main.py。二進制可用性的優(yōu)雅降級TigrisBackend.init通過shutil.which(cli_path)解析二進制路徑若找不到會拋出TigrisCliError并附帶安裝提示。而在 CLI 入口中這個錯誤被延遲處理——ctx.obj[backend]置為None從而保證即使沒有安裝tigris二進制--help依然可用見 tigris_cli.py。這是一個值得借鑒的 CLI 設(shè)計細節(jié)。全局入口與命令行選項Harness 的根命令cli是一個click分組支持四個全局選項見 tigris_cli.py選項默認值說明--jsonFalse以 JSON 格式輸出透傳上游--format json--cli-pathtigristigris二進制路徑二進制別名t3也可用--access-keyNone可選訪問密鑰 ID導出到子進程環(huán)境變量--secret-keyNone可選秘密密鑰導出到子進程環(huán)境變量調(diào)用方式cli-anything-tigris --json bucket list cli-anything-tigris object put --bucket my-bucket --key hello.txt --text hello此外入口還設(shè)置了auto_envvar_prefixTIGRIS_CLI意味著所有參數(shù)都可以通過TIGRIS_CLI_*前綴的環(huán)境變量注入。不帶任何子命令啟動時會進入交互式 REPL內(nèi)置help/quit/exit命令并提供一份完整的命令速查表見 tigris_cli.py。后端原理子進程封裝與雙環(huán)境變量認證TigrisBackend._run 是整條鏈路的發(fā)動機其工作方式完全呼應(yīng) TIGRIS.md 的 Backend Description每條命令構(gòu)建tigris args --format json調(diào)用--format json追加在末尾避免與子命令解析沖突通過subprocess.run執(zhí)行默認checkTrue非零退出碼拋出TigrisCliError并攜帶 stderr 信息jsonTrue時解析 stdout 為 JSON若上游命令不支持 JSON 輸出如login、cp解析失敗則回退為原始文本captureFalse時如login直接流式輸出到調(diào)用方 TTY。認證機制方面默認情況下憑證由tigrisCLI 自身解析——即tigris login建立的 OAuth 會話。若顯式傳入--access-key/--secret-key則會在子進程環(huán)境中同時注入四組變量見 tigris_backend.pyTIGRIS_STORAGE_ACCESS_KEY_ID / TIGRIS_STORAGE_SECRET_ACCESS_KEY AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY同時注入TIGRIS_STORAGE_*與AWS_*兩組前綴是為了兼容依賴環(huán)境變量認證的混合部署場景。大部分用戶應(yīng)優(yōu)先使用tigris login。路徑歸一化t3://與tigris://后端模塊中的_path_to_t3工具函數(shù)統(tǒng)一將tigris://...、裸bucket/key、/bucket/key歸一化為t3://...見 tigris_backend.py對應(yīng)的單元測試在 tests/test_core.py 中覆蓋了全部四種輸入形態(tài)。對象層還提供了_parse_tigris_uri將 URI 拆解為(bucket, key)二元組并拒絕非法路徑見 core/object.py。七大命令組全解1.auth登錄 / 登出 / 身份查詢包裝tigris login/logout/whoami見 core/auth.pycli-anything-tigris auth login # 瀏覽器 OAuth 登錄流式輸出到終端 cli-anything-tigris auth logout cli-anything-tigris auth whoami # 打印當前用戶 / 組織whoami在--json下輸出帶縮進的 JSON否則以section/status的皮膚樣式展示鍵值對。2.bucket存儲桶生命周期管理包裝tigris buckets ...見 core/bucket.pycli-anything-tigris bucket list cli-anything-tigris bucket create --name my-bucket cli-anything-tigris bucket delete --name my-bucket --yes # 必須顯式 --yes cli-anything-tigris bucket info my-bucket # 即 tigris buckets get關(guān)鍵安全語義delete命令在未傳--yes時直接拒絕執(zhí)行輸出錯誤并退出碼 1見 bucket.py。列表與 info 輸出會同時兼容小寫name/created與首字母大寫Name/CreationDate兩種字段命名以適配上游 CLI 的 JSON 結(jié)構(gòu)差異。3.object對象讀寫與復制包裝tigris ls/cp/rm/stat見 core/object.py# 列出支持前綴過濾 客戶端側(cè) limit 截斷 cli-anything-tigris object list --bucket my-bucket [--prefix logs/] [--limit 100] # 上傳文件或內(nèi)聯(lián)文本二選一 cli-anything-tigris object put --bucket my-bucket --key data.json --file ./data.json cli-anything-tigris object put --bucket my-bucket --key note.txt --text hello world # 下載與刪除 cli-anything-tigris object get --bucket my-bucket --key data.json --output ./out.json cli-anything-tigris object delete --bucket my-bucket --key data.json # 元數(shù)據(jù)stat cli-anything-tigris object info --bucket my-bucket --key data.json # 復制本地?t3 或 t3?t3支持 -r 遞歸 cli-anything-tigris object cp ./local.txt t3://my-bucket/remote.txt cli-anything-tigris object cp -r t3://src-bucket/dir/ t3://dst-bucket/dir/實現(xiàn)細節(jié)值得注意--file與--text必須且只能提供其一否則退出碼 2 并報錯見 object.py內(nèi)聯(lián)文本上傳通過tempfile.NamedTemporaryFile落盤后走tigris cpfinally中清理臨時文件見 tigris_backend.pycp命令要求 src/dst 至少一側(cè)是t3://或tigris://URI否則拒絕執(zhí)行見 object.py對象刪除實際調(diào)用tigris rm ... --yes。4.presign預簽名 URL包裝tigris presign見 core/presign.pycli-anything-tigris presign get --bucket my-bucket --key data.json [--expires 3600] cli-anything-tigris presign put --bucket my-bucket --key upload.bin [--expires 3600] [--access-key KEY_ID]--expires默認 3600 秒--access-key可選指定簽名用的訪問密鑰 ID默認自動解析后端兼容兩種上游返回形態(tài)JSON 字典中的url字段或裸字符串 URL見 tigris_backend.py--json模式輸出{url: ..., method: GET, expires_in: ...}信封。Agent 場景價值預簽名 URL 可以把對象訪問權(quán)臨時移交給其他工具或下游 Agent全程不共享任何憑證。5.snapshot存儲桶快照包裝tigris snapshots list/take見 core/snapshot.py?？煺帐谴鎯ν盃顟B(tài)的時間點只讀副本屬于 Tigris 獨有、通用 S3 兼容廠商不提供的 Agent 存儲原語cli-anything-tigris snapshot list my-bucket cli-anything-tigris snapshot take my-bucket [--name pre-migration]TIGRIS.md 的 Agent 使用規(guī)范建議在破壞性操作之前先snapshot take建立恢復點之后用snapshot list找到要恢復的快照。6.access-key作用域訪問密鑰包裝tigris access-keys見 core/access_key.py是 Harness 中最完整的命令組cli-anything-tigris access-key list cli-anything-tigris access-key create agent-run-42 # 密鑰僅顯示一次 cli-anything-tigris access-key get KEY_ID cli-anything-tigris access-key delete KEY_ID --yes # 必須 --yes cli-anything-tigris access-key assign KEY_ID --bucket my-bucket --role Editor cli-anything-tigris access-key rotate KEY_ID --yes # 必須 --yes源碼中的安全細節(jié)create與rotate在人類可讀模式下會明確提示secret shown ONCE, save it now見 access_key.pydelete與rotate均設(shè)有--yes防線未顯式確認時拒絕調(diào)用后端見 access_key.pyassign通過--bucket--role如Editor、Viewer把密鑰作用域收窄到單個桶實現(xiàn)最小權(quán)限。Agent 場景價值每次 Agent 運行可以access-key create鑄造一把臨時作用域密鑰 →assign限定桶與角色 → 任務(wù)結(jié)束delete撤銷做到一次運行、一把密鑰、用完即銷。7.iam策略與用戶管理包裝tigris iam policies與tigris iam users見 core/iam.py# 策略 cli-anything-tigris iam policy list cli-anything-tigris iam policy create my-policy --document ./policy.json # 用戶 cli-anything-tigris iam user list cli-anything-tigris iam user invite someoneexample.com [--role member]user invite的--role默認member。IAM 策略配合access-key assign讓 Agent / 組織可以向程序化客戶端授予狹窄、可審計的權(quán)限見 iam.py 模塊注釋。輸出模式人類可讀與機器可讀TIGRIS.md 將輸出模式分為兩類人類可讀默認通過ReplSkin渲染表格、顏色與格式化文本。各命令組都做了字段名兼容如桶列表同時識別name/Name、created/CreationDate并將結(jié)果整理為 Name / Created、Key / Size / Modified 等表頭機器可讀--json透傳上游 CLI 的--format json原始輸出對不支持 JSON 的原生命令如cp則包一層薄信封例如{src: ..., dst: ..., status: copied}。錯誤路徑在--json下輸出{error: ...}結(jié)構(gòu)。REPL 皮膚來自倉庫中未修改復用的ReplSkin見 utils/repl_skin.py對應(yīng) TIGRIS.md 架構(gòu)圖中的 unified REPL skin。Agent 使用規(guī)范SOPTIGRIS.md 為編碼 Agent 總結(jié)了一套可直接落地的操作規(guī)范輸出可解析調(diào)用時傳--json檢查返回碼0 表示成功讀 stderr錯誤信息從 stderr 獲取服務(wù)端復制使用object cp t3://src/key t3://dst/key做服務(wù)端拷貝——數(shù)據(jù)不流經(jīng) Agent不產(chǎn)生出口流量費預簽名移交用presign get/put把對象訪問權(quán)移交給其他工具或下游 Agent不共享憑證快照兜底破壞性操作前snapshot take建立恢復點snapshot list查找恢復目標臨時密鑰access-key createaccess-key assign --bucket B --role Editor為單次 Agent 運行鑄造作用域密鑰結(jié)束后access-key delete撤銷顯式確認桶刪除、訪問密鑰刪除、密鑰輪換都必須顯式傳--yes否則 Harness 拒絕調(diào)用后端——這是 Harness 內(nèi)置的最后一道安全閘門。測試體系從 Mock 單測到真實 E2ETIGRIS.md 與 tests/TEST.md 共同定義了兩層測試單元測試層tests/test_core.pycd tigris/agent-harness pip install -e .[dev] pytest cli_anything/tigris/tests/test_core.py -vsubprocess.run被完全 Mock模塊加載時連shutil.which也被 patch因此無需安裝tigrisCLI、無需網(wǎng)絡(luò)即可跑通適合任何 CI 環(huán)境覆蓋范圍包括URI/路徑歸一化、二進制解析失敗、憑證環(huán)境變量導出、七組命令的參數(shù)拼裝、非零退出碼拋TigrisCliError、CLI 集成層的--json輸出等。端到端測試層tests/test_full_e2e.py默認跳過需要三把鑰匙同時滿足npm install -g tigrisdata/cli tigris login export CLI_ANYTHING_TIGRIS_TEST_BUCKETyour-test-bucket export CLI_ANYTHING_TIGRIS_RUN_E2E1 pytest cli_anything/tigris/tests/test_full_e2e.py -vE2E 覆蓋whoami會話非空、測試桶存在、對象 put/get/head/list/delete 全鏈路回環(huán)、預簽名 URL 格式正確且包含 key 末段、snapshots list成功等場景。每個測試用 per-run UUID 前綴避免多開發(fā)者 / CI 并發(fā)撞鍵finally塊兜底清理。目錄結(jié)構(gòu)速覽TIGRIS.md 給出了完整的架構(gòu)布局倉庫實際目錄與之完全對應(yīng)tigris/agent-harness/ ├── setup.py # cli, prompt-toolkit; 無 boto3 ├── TIGRIS.md # 本文檔 └── cli_anything/tigris/ ├── __main__.py # python -m 入口 ├── tigris_cli.py # click CLI REPL 分發(fā)器 ├── core/ # auth / bucket / object / presign / snapshot / access_key / iam ├── utils/ # tigris_backend.py子進程封裝 repl_skin.py統(tǒng)一皮膚 ├── skills/SKILL.md # Agent 技能文檔 └── tests/ # test_core.pyMock 單測 test_full_e2e.py環(huán)境門控 E2E小結(jié)CLI-Anything 的 Tigris Harness 用包裝官方 CLI、絕不重寫協(xié)議這一克制的架構(gòu)選擇換來了全量原語覆蓋 零維護升級 OAuth 原生認證三大優(yōu)勢。對 Agent 開發(fā)者而言它提供了一條把對象存儲變成 Agent 原生能力的成熟路徑--json機器可讀輸出保證可解析性--yes防線保證破壞性操作可控快照 作用域密鑰 預簽名 URL 三件套則分別覆蓋了回滾、最小權(quán)限、憑證隔離三大 Agent 存儲安全訴求。結(jié)合 Mock 單測與真實 E2E 雙測試體系這套 Harness 可以放心地嵌入任何 Agent 工作流。【免費下載鏈接】CLI-AnythingCLI-Anything: Making ALL Software Agent-Native -- CLI-Hub: https://clianything.cc/項目地址: https://gitcode.com/GitHub_Trending/cl/CLI-Anything創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考