创建
Foundry是作为CLI分发的AI-native本地个人工作台. 内容
设置、提供者、抓取、抓取任务、加密数据传输和捆绑
特工技能副本作为JSON CLI命令可供人员和特工使用.
foundry web 准备本地存储, 启动 Hono 服务器, 为捆绑的服务器服务
反应Web UI,并在默认浏览器中打开.
套装是故意的只使用CLI. 它不会暴露 JavaScript 库 进入点.
特征
- 使用 OpenAI 响应、 Anthropic 信件或 OpenAI相容的聊天补全协议.
- 发现提供商模式,并保留自定义模式ID与远程模式并列.
- 抓取与Firecrawl或DeepSeek的链接,运行背景任务与回溯, 并审查历史 并抓获了Markdown.
- 配置外观,语言和地区,捕捉行为,和货币.
- 导出并导入加密
.foundry-backup载有 数据库和应用程序设置. - 将捆绑的代理技能复制到
<home>/.agents/skills/foundry, (中文(简体) ),<home>/.claude/skills/foundry,或两者均来自 CLI 或设置 > 先进.
所需资源
- 24.22.1节点或更新
- pnpm 12.15 或更新
项目使用 better-sqlite3,所以 pnpm 必须允许运行本地软件包
构建脚本。 所需的许可列表已在
pnpm-workspace.yaml。 。 。 .
从源头运行
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,并打开
默认浏览器 :
foundry web
foundry web --no-open
foundry --help
foundry --version
光着身子跑 foundry 只有指纹帮助。 它没有初始化存储或启动
网络用户界面。 Web 主机和端口是固定的;没有CLI或
环境可变端口覆盖.
国 际
特性命令将 JSON 写入 stdout 并错误写入 stderr :
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 <id> --status disabled
foundry captures list
foundry captures create https://example.com/article --note "Read later"
foundry captures get <capture-id>
foundry captures jobs list <capture-id>
foundry captures jobs get <capture-id> <job-id>
foundry captures jobs recapture <capture-id>
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 <path> 或者说 --input - jSON大型有效载荷。 数据传输
密码句可以用 --passphrase 或者说 FOUNDRY_PASSPHRASE。 。 。 .
data-transfer import 在
一个命令.
技能目标相对于用户主目录是固定的. 给 <home> 实值
~ 关于macOS/Linux和 %USERPROFILE% 在视窗上 :
.agents- > (中文)<home>/.agents/skills/foundry.claude- > (中文)<home>/.claude/skills/foundry
选择两个副本到两个位置。 替换一个选中的目标不 换另一个.
地方发展
将 API 和 Web UI 运行为两个独立的进程 :
pnpm dev:api
pnpm dev:web
- 网络用户界面 :
http://localhost:33333 - API : (英语)
http://localhost:22222
虚拟代理 /api 从Web dev服务器到API服务器. 有一个
故意不使用 CLI 开发命令; 使用两个开发服务器
测试页面行为,然后使用 pnpm build && pnpm start web 核查
生产服务器和静态资产.
数据和存储
Foundry 将用户数据保存在仓库外 <home>/.foundry。 。 。 . <home> 实值
~ 关于macOS/Linux和 %USERPROFILE% 在视窗上 :
foundry.sqlite: 提供者及其证书、抓取和刮取工作settings.json: 应用程序设置和抓取- fetcher 证书.data-transfer/: 临时导出和导入文件
特性命令初始化目录,打开 SQLite 数据库,并应用
出跑前有滴滴地迁移. foundry web 在服务器之前做同样的事情
启动。 由更新的 schema 版本创建的数据库被拒绝
正在修改.
在 POSIX 系统上, Foundry 创建了数据目录 0700 权限和
敏感文件与 0600 权限.
代理技能副本是用户级别而不是创建运行时间数据 :
<home>/.agents/skills/foundry<home>/.claude/skills/foundry
构建输出
pnpm build
该建筑产生:
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 或工程工具链 .
项目结构
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 库.
以 :
pnpm pack --dry-run
沥青球必须包括CLI、Web资产、Drizzle迁移和捆绑 特工技术.