技能 tsdown
📦

tsdown

內容修訂 r2 高風險 🔑 環境變數⚙️ 外部命令📁 檔案系統存取⚡ 包含腳本🌐 網路存取

使用 tsdown 建置 TypeScript 函式庫

TypeScript 函式庫建置通常需要多種格式、宣告檔，以及不依賴緩慢工具也能產生乾淨輸出的流程。tsdown skill 為 Claude、Codex 和 Claude Code 提供針對設定 tsdown 專案的聚焦指引。

支援: Claude Codex Code(CC)
Maintain this Skill? Claim it ⚠️ 38 差

使用我的智慧代理安裝

將此請求複製給你的智慧代理，其中包含權威 Skill 頁面和清單。

智能體請求
Review the Skillstore skill "tsdown" from https://skillstore.io/skills/antfu-tsdown.md and its manifest at https://skillstore.io/api/skills/antfu-tsdown/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.

你的智慧代理仍應顯示其計畫，並依安全政策請求必要確認。

Agent 可讀資源

當 AI Agent、爬蟲或腳本需要乾淨脈絡、而不是讀取完整頁面時，請使用這些連結。

Markdown 詳情 GET /skills/antfu-tsdown.md 已簽名 manifest GET /api/skills/antfu-tsdown/manifest 已簽名 lockfile GET /api/skills/antfu-tsdown/lockfile

測試它

正在使用「tsdown」。 I need ESM and CJS output with TypeScript declarations.

預期結果:

  • 建議的輸出格式與宣告設定。
  • 建議的 package export 行為。
  • 關於乾淨輸出和發布前驗證的注意事項。

正在使用「tsdown」。 I am moving a package from tsup to tsdown.

預期結果:

一份遷移計畫，將 entry points、format options、externals、declarations 和 package scripts 對應到 tsdown 的等效設定。

正在使用「tsdown」。 My build output contains unexpected files.

預期結果:

  • 檢查輸出目錄設定。
  • 清理與 watch-mode 指引。
  • 相依性 externalization 檢查步驟。

安全審計

高風險
v5 • 2026/7/23 開啟版本化報告

Review confirmed eight findings covering compile-time environment-file loading and an automated release example that deletes output and publishes to npm. The remaining 158 detections are documentation, template literals, fixed local operations, or public links without malicious behavior. No prompt injection, exfiltration intent, or concealed execution was found.

42
已掃描檔案
9,061
分析行數
3
複核項目
0
已忽略的誤報

已確認的安全問題 (5)

高
references/reference-cli.md:235
Environment file access
tsdown --env-file .env.production
The documented env-file option loads .env.production into compile-time definitions; secrets in that file can be embedded in distributable output.
高
references/reference-cli.md:243
Environment file access
tsdown --env-file .env --env-prefix APP_ --env-prefix TSDOWN_
This command loads .env and exposes values under broad prefixes; a misclassified secret can be embedded in generated output.
高
references/reference-cli.md:447
Environment file access
tsdown --env-file .env.production --env.BUILD_TIME=$(date +%s)
The example loads .env.production for compile-time replacement, which can disclose secrets if sensitive variables are included.
高
references/reference-cli.md:235
Environment variant files
tsdown --env-file .env.production
The production environment file may contain credentials, and compile-time loading can copy those values into published bundles.
高
references/reference-cli.md:447
Environment variant files
tsdown --env-file .env.production --env.BUILD_TIME=$(date +%s)
The production environment file is explicitly loaded during a build, creating a real risk of embedding sensitive values in output.
能力複核項目 (3)

這些是真實的本機能力，對此技能而言可能是預期行為，因此需要複核，但不會按已確認的惡意行為計分。

高
references/advanced-programmatic.md:179
Node.js child_process module
import { execSync } from 'child_process'
The release workflow imports child_process to run cleanup, tests, and publication commands; execution is intentional and includes destructive and external side effects.
高
references/advanced-programmatic.md:184
Synchronous process execution
execSync('rm -rf dist')
The example runs rm -rf dist, a destructive shell command; an unexpected working directory or copied modification could remove unintended data.
高
references/advanced-programmatic.md:201
Synchronous process execution
execSync('npm publish')
The npm publish command performs an authenticated external release with registry impact, and the example provides no confirmation or dry-run gate.

風險因素

🔑 環境變數 (13)
references/advanced-ci.md:7 references/advanced-ci.md:7 references/advanced-hooks.md:172 references/advanced-hooks.md:243 references/advanced-hooks.md:172 references/advanced-hooks.md:243 references/advanced-plugins.md:176 references/advanced-plugins.md:176 references/advanced-programmatic.md:146 references/advanced-programmatic.md:294 references/advanced-programmatic.md:146 references/advanced-programmatic.md:294 references/reference-cli.md:228
⚙️ 外部命令 (50)
references/advanced-hooks.md:40-44 references/advanced-hooks.md:101-109 references/advanced-hooks.md:136-145 references/advanced-hooks.md:159-163 references/advanced-hooks.md:189-193 references/advanced-hooks.md:205-209 references/advanced-hooks.md:209-214 references/advanced-programmatic.md:179 references/advanced-programmatic.md:234 references/advanced-programmatic.md:236 references/advanced-programmatic.md:184 references/advanced-programmatic.md:197 references/advanced-programmatic.md:201 references/option-css.md:75-86 references/option-css.md:95-102 references/option-css.md:102-105 references/option-minification.md:76-77 references/recipe-react.md:51-56 references/recipe-vue.md:85-104 references/reference-cli.md:447 SKILL.md:12 SKILL.md:16 SKILL.md:30-45 SKILL.md:45-49 SKILL.md:49-58 SKILL.md:58-70 SKILL.md:70 SKILL.md:74 SKILL.md:80-81 SKILL.md:81-82 SKILL.md:82 SKILL.md:83 SKILL.md:84 SKILL.md:85 SKILL.md:86-87 SKILL.md:87 SKILL.md:88 SKILL.md:89-90 SKILL.md:90-91 SKILL.md:91 SKILL.md:97-98 SKILL.md:98-99 SKILL.md:99-100 SKILL.md:100-107 SKILL.md:107-108 SKILL.md:108 SKILL.md:109-110 SKILL.md:110 SKILL.md:111 SKILL.md:112-113
📁 檔案系統存取 (7)
references/guide-getting-started.md:68 references/option-exe.md:106 references/option-exe.md:106 references/option-shims.md:150 references/option-shims.md:154 references/option-watch-mode.md:235 SKILL.md:70
⚡ 包含腳本 (2)
references/option-cleaning.md:149 references/option-output-format.md:14
🌐 網路存取 (5)
references/reference-cli.md:225 SKILL.md:413 SKILL.md:414 SKILL.md:415 SKILL.md:416
審計單位: codex 檢視審計紀錄 →
分享與引用此報告

分享版本化評估報告、中性徽章、嵌入卡片與引用。Skillstore 只報告證據，不判斷該 Skill 是否安全。

開啟版本化報告
安全評估

複製報告連結

https://skillstore.io/skills/antfu-tsdown/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/antfu-tsdown/security.svg)](https://skillstore.io/skills/antfu-tsdown?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/antfu-tsdown?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/antfu-tsdown/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/antfu-tsdown.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
學術引用 (APA · BibTeX · CFF)

APA 引用

antfu. (2026). tsdown security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/antfu-tsdown/audits/5

BibTeX 引用

@techreport{antfu-antfu-tsdown-2026, author = {antfu}, title = {tsdown security audit report (audit version 5)}, institution = {Skillstore}, year = {2026}, number = {5}, url = {https://skillstore.io/skills/antfu-tsdown/audits/5}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "tsdown security audit report (audit version 5)" version: "unspecified" type: report authors: - name: "antfu" date-released: "2026-07-23" url: "https://skillstore.io/skills/antfu-tsdown/audits/5" identifiers: - type: other value: "skillstore:antfu-tsdown:audit:5" description: "Skillstore immutable audit report identifier"

Skillstore 評分

評分依據 證據置信度: 中
59
架構
85
可維護性
87
內容
72
社群
83
規範符合度

你可以打造什麼

建立函式庫建置流程

設定具備 ESM、CJS、宣告檔、乾淨輸出和 package exports 的 TypeScript 套件。

從 tsup 遷移

將現有 tsup 設定轉換為 tsdown，同時保留 entry points、formats 和相依性行為。

打包框架元件

為 React、Vue、Solid 或 WASM 套件設定建置，包含 external dependencies 和宣告輸出。

試試這些提示

建立基本函式庫建置 
Set up tsdown for a TypeScript library with ESM, CJS, declarations, and a clean dist output. Explain each choice.
從 tsup 遷移 
Review my current tsup setup and convert it to tsdown. Keep entry points, formats, declarations, and external dependencies equivalent.
最佳化框架套件 
Design a tsdown config for a React component library. Include peer dependency externalization, declaration files, source maps, and package exports.
規劃發布工作流程 
Plan a tsdown-based build and validation workflow for a monorepo package. Include CI-only checks, hooks, and manual publish safeguards.

最佳實務

  • 為公開的 TypeScript 函式庫產生宣告檔。
  • 將 peer dependencies（例如 React 或 Vue）設為 external。
  • 發布前使用僅限 CI 的驗證來檢查套件。

避免

  • 不要預設打包框架的 peer dependencies。
  • 不要在未過濾 secrets 的情況下，將 production environment files 載入瀏覽器建置。
  • 不要在未經人工核准的情況下，從產生的 scripts 自動發布套件。

常見問題

這個 skill 可以協助什麼？
它協助為 TypeScript 和 JavaScript 函式庫建置設定 tsdown，包括 formats、declarations、plugins 和遷移工作。
它可以遷移 tsup 專案嗎？
可以。它包含將常見 tsup 設定轉換為 tsdown options 的指引。
它支援宣告檔嗎？
可以。它說明 declaration generation、declaration maps、compiler options 和相關建置行為。
它可以處理 React 或 Vue 函式庫嗎？
可以。它包含 React、Vue、Solid 的框架套件模式，以及相關 plugin 使用方式。
它會自動執行 build 或 publish commands 嗎？
不會。它提供指引和範例。執行命令應該需要明確的使用者核准。
tsdown 的 CSS 支援穩定嗎？
不是。內含參考資料將 CSS 支援描述為實驗性功能，且不建議在生產環境中依賴。

開發者詳細資訊

作者

antfu

授權

MIT

Skillstore 修訂

r2

版本提示

作者未聲明版本。

儲存庫

https://github.com/antfu/skills/tree/main/skills/tsdown/

引用

89edfdc710d0846129dcee6a929477b04f08052c

維護新鮮度

2026/7/25

使用量

9 次下載 · 353 次瀏覽

檔案結構

📄 LICENSE.md

📄 README.md

📁 references/

📄 advanced-benchmark.md

📄 advanced-ci.md

📄 advanced-hooks.md

📄 advanced-plugins.md

📄 advanced-programmatic.md

📄 advanced-rolldown-options.md

📄 guide-getting-started.md

📄 guide-introduction.md

📄 guide-migrate-from-tsup.md

📄 option-cjs-default.md

📄 option-cleaning.md

📄 option-config-file.md

📄 option-css.md

📄 option-dependencies.md

📄 option-dts.md

📄 option-entry.md

📄 option-exe.md

📄 option-lint.md

📄 option-log-level.md

📄 option-minification.md

📄 option-output-directory.md

📄 option-output-format.md

📄 option-package-exports.md

📄 option-platform.md

📄 option-root.md

📄 option-shims.md

📄 option-sourcemap.md

📄 option-target.md

📄 option-tree-shaking.md

📄 option-unbundle.md

📄 option-watch-mode.md

📄 README.md

📄 recipe-react.md

📄 recipe-solid.md

📄 recipe-svelte.md

📄 recipe-vue.md

📄 recipe-wasm.md

📄 reference-cli.md

📄 SKILL.md

📄 SYNC.md

antfu 的更多技能

查看全部

相關技能

查看全部