# @dhzh/foundry 中文文档 规范地址：https://npmcn.com/package/%40dhzh/foundry/ 版本：4\.0\.1 npm 元数据更新时间：2026-10-29T16:39:43.671Z 中文译文更新时间：2026-11-13T04:32:41.802Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40dhzh/foundry 原文对照：https://npmcn.com/package/%40dhzh/foundry/?lang=original 项目主页：https://github.com/tinywaves/foundry 源码仓库：https://github.com/tinywaves/foundry ## 关键信息（来自 npm 元数据） - 包体积（解压后）：2.3 MB，46 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - 运行依赖：7 个 - 首次发布：2026-07-01T16:47:46.932Z - 最新版本发布：2026-10-29T16:39:43.267Z - 近 30 天下载量：2320（2026-10-12 至 2026-11-10，npm 官方下载统计） - 已发布版本数：40（近 12 个月 40 个） ## 中文简介 一个人工智能本地个人工作室 ## 安装 ```sh npm install @dhzh/foundry ``` 也可以使用：`pnpm add @dhzh/foundry`、`yarn add @dhzh/foundry`、`bun add @dhzh/foundry` ## README # 创建 Foundry是作为CLI分发的AI-native本地个人工作台. 内容 设置、提供者、抓取、抓取任务、加密数据传输和捆绑 特工技能副本作为JSON CLI命令可供人员和特工使用. `foundry web` 准备本地存储, 启动 Hono 服务器, 为捆绑的服务器服务 反应Web UI,并在默认浏览器中打开. 套装是故意的只使用CLI. 它不会暴露 JavaScript 库 进入点. ## 特征 - 使用 OpenAI 响应、 Anthropic 信件或 OpenAI相容的聊天补全协议. - 发现提供商模式,并保留自定义模式ID与远程模式并列. - 抓取与Firecrawl或DeepSeek的链接,运行背景任务与回溯, 并审查历史 并抓获了Markdown. - 配置外观,语言和地区,捕捉行为,和货币. - 导出并导入加密 `.foundry-backup` 载有 数据库和应用程序设置. - 将捆绑的代理技能复制到 `/.agents/skills/foundry`, (中文(简体) ), `/.claude/skills/foundry`,或两者均来自 CLI 或设置 > 先进. ## 所需资源 - 24.22.1节点或更新 - pnpm 12.15 或更新 项目使用 `better-sqlite3`,所以 pnpm 必须允许运行本地软件包 构建脚本。 所需的许可列表已在 `pnpm-workspace.yaml`。 。 。 . ## 从源头运行 ```bash pnpm install pnpm build pnpm start web ``` `pnpm start` 运行已建 CLI 从 `dist/index.mjs`· ; `pnpm start web` 开始 网络用户界面。 更改 CLI、 服务器或 Web UI 后先构建 . `foundry web` 监听 `http://127.0.0.1:11111`,打印 URL,并打开 默认浏览器 : ```bash foundry web foundry web --no-open foundry --help foundry --version ``` 光着身子跑 `foundry` 只有指纹帮助。 它没有初始化存储或启动 网络用户界面。 Web 主机和端口是固定的;没有CLI或 环境可变端口覆盖. ## 国 际 特性命令将 JSON 写入 stdout 并错误写入 stderr : ```bash foundry settings get foundry settings update --input '{"theme":"dark"}' foundry providers list foundry providers create --input '{"name":"Local","protocol":"openai-compatible-chat-completions","baseURL":"http://127.0.0.1:11434/v1","apiKey":"","customModels":[]}' foundry providers set-status --status disabled foundry captures list foundry captures create https://example.com/article --note "Read later" foundry captures get foundry captures jobs list foundry captures jobs get foundry captures jobs recapture foundry data-transfer status foundry data-transfer export --output ./foundry.foundry-backup foundry data-transfer inspect ./foundry.foundry-backup foundry data-transfer import ./foundry.foundry-backup foundry settings download-skill --target .agents,.claude ``` 使用 `--input-file ` 或者说 `--input -` jSON大型有效载荷。 数据传输 密码句可以用 `--passphrase` 或者说 `FOUNDRY_PASSPHRASE`。 。 。 . `data-transfer import` 在 一个命令. 技能目标相对于用户主目录是固定的. 给 `` 实值 `~` 关于macOS/Linux和 `%USERPROFILE%` 在视窗上 : - `.agents` - > (中文) `/.agents/skills/foundry` - `.claude` - > (中文) `/.claude/skills/foundry` 选择两个副本到两个位置。 替换一个选中的目标不 换另一个. ## 地方发展 将 API 和 Web UI 运行为两个独立的进程 : ```bash pnpm dev:api pnpm dev:web ``` - 网络用户界面 : `http://localhost:33333` - API : (英语) `http://localhost:22222` 虚拟代理 `/api` 从Web dev服务器到API服务器. 有一个 故意不使用 CLI 开发命令; 使用两个开发服务器 测试页面行为,然后使用 `pnpm build && pnpm start web` 核查 生产服务器和静态资产. ## 数据和存储 Foundry 将用户数据保存在仓库外 `/.foundry`。 。 。 . `` 实值 `~` 关于macOS/Linux和 `%USERPROFILE%` 在视窗上 : - `foundry.sqlite`: 提供者及其证书、抓取和刮取工作 - `settings.json`: 应用程序设置和抓取- fetcher 证书 - `.data-transfer/`: 临时导出和导入文件 特性命令初始化目录,打开 SQLite 数据库,并应用 出跑前有滴滴地迁移. `foundry web` 在服务器之前做同样的事情 启动。 由更新的 schema 版本创建的数据库被拒绝 正在修改. 在 POSIX 系统上, Foundry 创建了数据目录 `0700` 权限和 敏感文件与 `0600` 权限. 代理技能副本是用户级别而不是创建运行时间数据 : - `/.agents/skills/foundry` - `/.claude/skills/foundry` ## 构建输出 ```bash pnpm build ``` 该建筑产生: ```text dist/ |-- index.mjs |-- drizzle/ | |-- *.sql | `-- meta/ |-- skills/ | `-- foundry/ | |-- SKILL.md | `-- references/ `-- web/ |-- assets/ |-- index.html `-- favicon.png ``` `tsdown` 干净 `dist`,并复制 Drizzle 迁移和 特工技术 Vite 然后直接将网络用户界面写入 `dist/web`不添加一个 用于 Web UI 的手动复制步骤. ## 图标 | 命令 | 目的 | | --- | --- | | `pnpm dev:api` | 运行 API 服务器 `22222` | | `pnpm dev:web` | 运行 Vite 网络用户界面 `33333` | | `pnpm build` | 构建 CLI 和 Web UI | | `pnpm start web` | 运行制作 Web 用户界面 `11111` | | `pnpm start` | 打印已建的 CLI 帮助 | | `pnpm test` | 运行行为测试 | | `pnpm test:coverage` | 运行覆盖 V8 的测试 | | `pnpm db:generate` | 在计划改变后生成 Drizzle 迁移 | | `pnpm db:migrate` | 手动将迁移应用到本地数据库 | 用已声明的节点.js版本运行工程脚本 `package.json`。 。 。 . 旧的Node.js版本无法运行已安装的 pnpm 或工程工具链 . ## 项目结构 ```text app/web/ React, Vite, Astryx, and StyleX Web UI src/ |-- cli/ CLI commands, JSON I/O, and browser opening |-- features/ Feature services, validation, repositories, and routes |-- lib/ Small server-side utilities |-- server/ Hono API, static serving, and server entry points `-- storage/ SQLite, Drizzle schema, paths, and migrations skills/foundry/ Agent-facing CLI usage skill and references drizzle/ Generated migration SQL and metadata test/ Behavioral API and feature tests ``` `skills/foundry/SKILL.md` 是代理化的创始人CLI使用技巧. 内容 特性引用存在 `skills/foundry/references`。 。 。 . API 挂载在 `/api`。生产服务器服务文件 `dist/web` 并回到 `dist/web/index.html` 为客户端路线. ## 包装 已发布的软件包只包含 `dist`编辑 `bin` 进入点 `dist/index.mjs`,以及 `exports` 仅曝光 `./package.json`; 消费者不能 导入创建器为 JavaScript 库. 以 : ```bash pnpm pack --dry-run ``` 沥青球必须包括CLI、Web资产、Drizzle迁移和捆绑 特工技术. ## 许可证 [阿帕奇 - 2.0](https://npmcn.com/package/%40dhzh/foundry/LICENSE) ## 常见问题 ### @dhzh/foundry 是什么？ 一个人工智能本地个人工作室 ### 如何安装 @dhzh/foundry？ 在项目目录运行 npm install @dhzh/foundry，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 foundry，可以用 npx foundry 直接运行。 ### @dhzh/foundry 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/dhzh\_\_foundry 是否存在。 ### @dhzh/foundry 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @dhzh/foundry 可以商用吗？ @dhzh/foundry 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### @dhzh/foundry 的下载量有多少？ 根据 npm 官方下载统计，@dhzh/foundry 在 2026/10/12 – 2026/11/10 这 30 天内被下载 2,320 次，日均约 77 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @dhzh/foundry 还在维护吗？ 最新版本 4\.0\.1 发布于 2026/10/30（14 天前）；至今共发布 40 个版本，其中过去 12 个月发布了 40 个；首次发布于 2026/07/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。