# @foundocs/foundocs-setup 中文文档

规范地址：https://npmcn.com/package/%40foundocs/foundocs-setup/

版本：0\.3\.20
npm 元数据更新时间：2026-11-10T22:41:46.094Z
中文译文更新时间：2026-11-15T10:27:11.288Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40foundocs/foundocs-setup
原文对照：https://npmcn.com/package/%40foundocs/foundocs-setup/?lang=original
项目主页：https://github.com/foundocs/foundocs-setup#readme
源码仓库：https://github.com/foundocs/foundocs-setup

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.7 MB，34 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.19\.0
- 运行依赖：3 个
- 首次发布：2026-10-09T17:28:56.532Z
- 最新版本发布：2026-11-10T22:41:45.700Z
- 近 30 天下载量：2769（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：23（近 12 个月 23 个）

## 中文简介

Foundocs 远程 MCP 服务器可重复的项目设置和代理技能

## 安装

```sh
npm install @foundocs/foundocs-setup
```

也可以使用：`pnpm add @foundocs/foundocs-setup`、`yarn add @foundocs/foundocs-setup`、`bun add @foundocs/foundocs-setup`

## README

# Foundocs 设置

使用您工程的 Foundocs 集成指南中的安装提示 。 它包含一个十分钟,单用接通代码,从不使用API密钥. 编码代理修正一个绝对工程根,并将提示的 JSON 发送到安装器 **私家侦探** 使用进程工具。 不要将 JSON 粘贴为 shell 命令文本、 argv、 日志或已承诺的文件 .

版本 **0.3.5 (中文(简体) )** 将可移植项目 MCP 设置扩展至 Claude Code 。 两个客户端运行共享的精确版本 npm 运行时间,而每个安装密钥都留在了私人本地存储中. 已拥有的 Codex 绝对路径和 Claude HTTP 帮助配置可以迁移,而无需交换代码或旋转一个密钥. 对于本地开发验证,构建此软件包并从其目录中运行:

```text
node src/cli.mjs install --root /absolute/project
node src/cli.mjs doctor --root /absolute/project
node src/cli.mjs rollback --root /absolute/project
node src/cli.mjs migrate --root /absolute/project
```

安装命令读取 stdin直到 EOF 。 命令从不将代码或API密钥作为参数. 这个软件包需要Node.js 22.19.0+以及当地安装的克洛德码或Codex CLI. 在交换代码之前,它检查已安装的 CLI 项目 stdio MCP 支持,解析已存在的设置并检查私人存储权限. 缺失或不相容的CLI需要安装/更新或手动指南. 没有它的 CLI , Codex 的桌面应用程序无法通过此自动特性检查.

输入 JSON 如下 `SetupInstallInput` 版本1: `client` (单位:千美元)`claude` 或者说 `codex`, (中文(简体) ), `projectId`, (中文(简体) ), `workspaceId`, (中文(简体) ), `attemptId`, (中文(简体) ), `code`, (中文(简体) ), `exchangeUrl`, (中文(简体) ), `mcpUrl`,以及 `version: 1`。代码交换一次以换取安装密钥;同一种尝试重新运行该私钥。 新发布的尝试可以替换被撤销的密钥,同时私下保留之前的密钥. 现有的密钥永远不会自动被取消 .

配置为本地到准确 `--root`数字 : `foundocs.json`,标记 `AGENTS.md` 块,或者 `.codex/config.toml` 或者说 `.mcp.json`克劳德还收到一个标记 `CLAUDE.md` 参考文献 `AGENTS.md`。该软件包还安装了英语 Foundocs 技能 `.agents/skills/foundocs/` 用于编码或 `.claude/skills/foundocs/` 包括梦中协议的参考文献 管理指令块指向选定的客户端的可发现技能 。 现有指令和外国MCP条目被保留. Skill 文件仅在安装器记录的版本不变时更新 。 新克隆中的字节-同声包文件在当地被采用;其他外国或用户编辑的技能停止了飞行前,回滚保存了后期用户编辑. 运行 `update-skills` 将捆绑的技能添加到一个没有新连接代码的旧安装中。 使用服务器发现的手动知识存档/恢复 `set_knowledge_status` 工具; 捆绑的 Foundocs 技能文件已编辑、存档查找和单独的 Dreaming 批准路径。 现有设施通过 `update-skills`; 普通抓取不授权归档. 桥能动态地发现工具,因此服务器工具添加不需要运行时间升级. 梦想本身需要连接的服务器曝光 `dream_memory` 财务报告和审定财务报表 `get_dream`; 安装无法启用不可用的服务器能力. 相冲突项目 ID、 错误的文件、 符号链接或不同的同名 `foundocs` 服务器在交换代码前停止安装。 明确解决冲突; 此安装器不会覆盖它 .

密钥、备份和安装日记 `~/.local/share/foundocs/setup`在项目之外. `FOUNDOCS_SETUP_HOME` 可以在目标项目外选择另一个绝对私有目录,包括孤立的测试固定装置. 继续用同样的值 医生/回滚。 证书按工作空间、项目和犬类项目根进行隔离。 两个客户端都使用精确版本 npm 软件包 `mcp` 命令通过 `npx` 在 PATH 上; 它们的工程设置没有针对用户的路径。 较老的被复制的帮助者为了兼容性和回滚性而留在私人存储中,但可移植的MCP并不依赖于它们. 它的stdio适配器转发了MCP工具的发现,并用被保存的Bearer键调用同一种远程HTTP端点. 这个适配器保存了远程计数器,注释,结构化结果和出错,需要在每个调用时明确有效的项目ID. 更改后的有效项目ID不会被转发;远程服务器执行工作空间访问. 它没有增加远程服务。 macOS/Linux只使用用户目录/文件(0700/0600). Windows使用PowerShell应用并验证一个受保护的当前用户唯一的ACL;不支持的ACL文件系统在代码交换前停止.

帮助者倾向于保存的安装证书. 明确使用提供的程序 `FOUNDOCS_API_KEY`匹配 `FOUNDOCS_PROJECT_ID` 财务报告和审定财务报表 `FOUNDOCS_WORKSPACE_ID`。一个无关的 shell 密钥永远不会默默地覆盖所保存的工作空间密钥。 遗留的 HTTP 助手 stdout 中只包含主机 MCP 客户端的认证头; 不要通过记录 stdout 的工具引用它 。 共享的可移植运行时间只写出 MCP 消息来 stdout.

0.2.0版本确认记录的0.1.x设施在最初的私人地点。 Reinstallt 迁移项目文件名, 管理指令标记和选定的客户端服务器名, 同时保留证书路径和回滚日志 。 现有的医生和回滚命令可以发现旧位置. 两个已记录的默认地点被视为冲突;明确选择与 `FOUNDOCS_SETUP_HOME`。当未提供当前覆盖时,仍然支持历史自定义存储覆盖。 证书和助手目录永远不会自动移动 .

迁移拒绝不同的项目ID,外国或重复的服务器条目,错误的/混合的指令标记和不安全的文件,然后交换代码. 它在替换管理指令前写出新工程配置并删除最后的旧文件名 。 每个文件写入都是原子并被日记;多文件操作是可回收的而不是交易的. 重试重用同样保存的密钥 。 回滚保存了原有的安装基线,如果存在更古老的日记;否则会恢复文件在迁移前的状态. 手动修改或内入历史的TOML服务器定义需要明确的冲突解决. 私人相容模块也接受一个完整,相匹配的历史证书命名空间,只有在不存在当前证书变量时才会接受.

医生进行MCP初始化、工具发现和 `get_project_context` 和精确的项目ID. `diagnostic_passed` 意味着独立的诊断成功. 您仍然必须在选中的主机中信任/ 重新连接工程, 并调用它的 MCP 工具来验证该主机 。 设置从不单独报告文件创建中的主机连接 .

对于私人密钥存储前的响应丢失或失败,出错报告尝试ID并引导回收路径:检查/撤销仅该尝试发布密钥并生成出一个新的代码. 在密钥存储后,重新运行相同的安装输入. `rollback` 仅恢复仍然匹配安装者所写内容的文件;同时保留和报告编辑。 它保存私人证书进行再试. 进程中断后的 stale 操作锁永远不会被自动删除: 在删除所报告私有锁文件之前确认没有安装器正在运行 .

## 共享代码项目

提交 `foundocs.json`,项目 `.codex/config.toml`,以及团队共享时的管理指令/技能. 新生成的条目使用此传输( 实际文件还列出支持的环境变量) **名称**,永远不要他们的价值观:

```toml
[mcp_servers.foundocs]
command = "npx"
args = ["--yes", "@foundocs/foundocs-setup@0.3.5", "mcp", "--project-id", "YOUR-PROJECT-UUID"]
env_vars = ["FOUNDOCS_SETUP_HOME", "FOUNDOCS_API_KEY", "FOUNDOCS_PROJECT_ID", "FOUNDOCS_WORKSPACE_ID", "STEERDOCS_SETUP_HOME", "STEERDOCS_API_KEY", "STEERDOCS_PROJECT_ID", "STEERDOCS_WORKSPACE_ID"]
startup_timeout_sec = 60
```

每个队友都会为自己的克隆人运行一次集成提示. 这创造了一个本地的私人清单/按键, 其范围可追溯到该单词检出; 它保留了现有的有效的可移植 TOML 字节用于字节 。 复制、移动或克隆检查不转移其认证。 缺失的本地安装返回一个编辑错误, 解释如何安装或诊断它 。 没有 `.env` 需要加载器,而代理从不读取API密钥.

主机必须在其PATH上有Node.js 22.19.0+和npm/npx. 没有您 shell 的 PATH 启动的桌面可能需要配置环境或重启 。 第一次无所事事 `npx` 发射需要npm注册访问;后发射使用npm的普通缓存. 运行时间版本被固定在精确的发布中,以便再出. 使用更新型安装器进行补充/校正,保留现有的有效接头; `update-skills` 从未升级 MCP 运行时间 。 有意的运行时间更新是经过审查的对共享接针的更改,再由本地安装/移动和主机验证. 被绑定的登记命令要求发布必须已经发布;当地发布前的核查使用安装在孤立固定装置中的被包装文物.

运行时间从主机的工作目录开始并选择最近的 `foundocs.json`。它停止在一个 Git 检查出边界、一个不正确的接近文件或项目ID不匹配。 它从不为工作证明再查一次离职单 它在打开远程连接前验证了cononical root,Project/workspace ID,端点,被记录的尝试,预期的私人证书路径和文件权限. 明确 `--project-id` 保护被嵌入的工程不被默默地继承其母体的运输. 这些是启动身份检查: 工具呼叫仍然通过明确 `project_id` 不变,远程服务器保留其现有的工作空间授权规则.

`FOUNDOCS_SETUP_HOME` 通过主机环境选择自定义的私人存储。 在安装,启动Codex,诊断,迁移和回滚时保持相同的值. 支持的 API- key 覆盖名称和历史等同物通过 `env_vars`; 数值留在 Git. per- server 之外 `cwd`, (中文(简体) ), `env` 和 URL 覆盖被设置/博士拒绝,因为它们可以默默地更改安装选择. 保留了工具许可列表和超时.

### 现有编码装置

发行后:

```text
npx --yes @foundocs/foundocs-setup@0.3.5 migrate --root /absolute/project
npx --yes @foundocs/foundocs-setup@0.3.5 doctor --root /absolute/project
```

`migrate` 下线,不需要连接代码,并保留证书字节。 它对照原始的绝对传输来验证私人的表单和日记,只编辑自有服务器的传输字段,并保存无关的TOML,评论,工具设置和超时. 缺少所有权证据, 更改了执行设置, 并且不支持内行表, 原文件完好无损 。 安装重跑可以执行相同的迁移,同时重用所保存的同试键. `update-skills` 仍然只有技能.

写作使用现有的锁,原子替换,货币检查和回滚日记. 如果中断, 请保留日记并重运行相同的命令; 在清除 stale 锁前确认没有进程运行 . `rollback` 恢复未变的设置编辑到所记录的基准,并保存后期用户编辑和证书. 基线可能早于迁移,因为一个安装已经有一个日记。 迁移后, 重新启动/ 重新连接可信任的 Codex 项目并调用 `get_project_context` 通过其MCP服务器. 医生报告遗留的运输迁移与相冲突的便携式配置分开;独立的医生呼叫并不能证明宿主连接.

## 共享克洛德代码项目(0.3.5)

提交工程 `.mcp.json` 并行 `foundocs.json`,指令和 `.claude/skills` 当共享一个克劳德项目。 新的 Claude 安装生成:

```json
{
  "mcpServers": {
    "foundocs": {
      "type": "stdio",
      "command": "npx",
      "args": ["--yes", "@foundocs/foundocs-setup@0.3.5", "mcp", "--project-id", "YOUR-PROJECT-UUID"]
    }
  }
}
```

每个队友都会在他们的克隆中运行一次集成提示来保存自己的安装密钥. 共享的 JSON 当它已经有一个有效的支持针时, 仍然保持字节相同 。 Claude的stdio进程继承了主机环境:在PATH上以节点/npm/npx启动Claude,并在适用的情况下以相同的开始 `FOUNDOCS_SETUP_HOME` 并匹配范围验证的覆盖变量。 不属于私有环境值 `.mcp.json`4\. 第一次无标记发射需要登记册访问。 在连接前批准 Claude 的 MCP 服务器项目 .

Claude使用与Codex相同的工作-指令解析度,项目ID守护,私人的出货单/信誉检查和被编辑出的错误. `CLAUDE_PROJECT_DIR` 不覆盖根选择。 运行时0.3.5是第一个接受克洛德安装清单的版本;一个克洛德针到0.3.4被拒绝. 现有的编码0.3.4针仍然支持,不通过再安装升级或 `update-skills`。 。 。 .

对于现有的 Claude HTTP `headersHelper` 安装, 运行相同 `migrate --root /absolute/project` 以上为0.3.5。 迁移验证所记录的帮助者命令,私人证书范围和终点后再转换为stdio. 它不执行密钥交换或远程请求,保留无关的JSON值和服务器设置,并支持重试和回滚. 已修改的端点/ 帮助, 额外的认证或执行覆盖, 缺少的所有权证据是冲突 。 JSON 白空间在转换时可能实现常态化;一个已可携带的配置为字节不变. `doctor` 点拥有HTTP安装到迁移,区分配置冲突,独立检查MCP连接. `update-skills` 既不改变连接设置,也不改变密钥.

在发布前,通过客户的私人安装记录和真实的HTTP MCP测试了0.3.5焦油球. macOS Claude CLI 装入生成的 `.mcp.json` 已连接; 使用同一生成命令的协议客户端已完成发现 `get_project_context`。真正的Codex主机也发现了这些工具并完成了一个读取呼叫。 Claude没有被登录,所以模型驱动的Claude工具选择没有被验证. npm公开发布和Linux/Windows主机验证是单独的放行检查.

## 核查状况

实施包括两种配置格式的单位/整合测试,保存,重跑,冲突,证书隔离,编辑,恢复,回滚,协议诊断,路径引用和ACL命令生成. 本地特征检查通过macOS,使用Codex CLI 01.49.1和克洛德代码2.1.284. Windows/Linux命令路径被执行,但在声称这些操作系统被验证之前仍然需要对这些操作系统进行实时运行验证. 包式自动化测试使用孤立的主机能力固定装置. 在macOS上的产品存储库中,还额外核实了0.3.4打包的文物,其中有一个真正的Codex主机,一个孤立的可信赖的CODEXCHOME,生成的项目配置,以及一个实际的HTTP MCP get project context呼叫. 这无法验证 Linux/ Windows 或公开 npm 发布 .

发展: `npm ci`, (中文(简体) ), `npm test`,以及 `npm run typecheck`。 。 。 .

## 知识技能(0.3.1)

0.3.1 来源包括英语 `foundocs-capture-knowledge` 技能和写作指南 `foundocs` 梦想技巧与协议参考. `install` 复制同样的捆绑到 `.agents/skills/` 用于编码或 `.claude/skills/` 给Claude Code 加上一个紧凑的靴子 上面有精确的技巧联系 并触发条件 配置验证、文件/知识政策、更新检查和 " 梦想 " 程序仅在需要时才从选定的技能及其参考文献中读取。 靴子保留了同调的知识捕捉和明确的"梦想"触发器,外加管理配置位置;无关的任务不需要完整的程序. Claude还收到了现有的CLAUDE参考. 明确的用户目的地和存储器规格惯例优先于默认的Foundocs存储.

现有记录设施可以更新技能和管理指令,而不提供连接代码、联系服务或旋转证书:

```text
node /absolute/path/to/foundocs-setup/src/cli.mjs update-skills --root /absolute/project
```

此释放的等效命令是 `npx --yes @foundocs/foundocs-setup@latest update-skills --root /absolute/project`。上面的本地命令运行此检查出;一个被绑定的 npm 命令要求存在注册释放.

更新保存了 MCP 设置,项目配置,认证助手和私人密钥,包括仍然使用历史配置文件名的设备. 私人 `skills.json` 已安装/待处置资产散列以进行中断回收。 外国同名文件和本地技能编辑在项目写入前停止安装/更新;明确移动或调和所报文件,再重试. 保留不相关的技能和指示. `rollback` 包括技能资产,并保留同时编辑.

`doctor` 缺少、过时或相互矛盾的技能文件与MCP诊断分开,并指出 `update-skills`成功 `skills.status: installed` 仅验证文件;在需要重新连接/重启后,所选主机仍必须发现技能. 无论是设置还是医生都没有声称一个模型执行了这种技能,或者将永远遵循这种技能. 安装了SessionStart技能更新钩;没有安装背景知识收藏.

包裹 `skills/` 财务报告和审定财务报表 `templates/` 每个焦油丸必须包含目录. 发布前进行包装测试并进行包装的CLI烟雾检查;将制作的准确版本固定在注册验证的放行上.

梦想中的对抗性固定装置和跟踪检查 `eval/`; 见 `eval/README.md`这些检查并不要求进行真正的模型质量评价.

## 知识文件夹(0.3.8)

捆绑的抓取技能可重复使用固定下的现有主题文件夹 `knowledge/rules/`, (中文(简体) ), `knowledge/learnings/` 财务报告和审定财务报表 `knowledge/decisions/` 树根。 直接在根下嵌入的主题文件夹和文件均有效. 相关事实保持不变,而不是成为碎片或重复的浅薄文件夹。 同一回合记录了经核实的、可重复使用的纠正代理人本身错误的教训;排除了排版和未经核实的补救.

梦想检查其现有六个阶段的分散知识和类似文件夹。 合并比较具体的主题组,目的文件夹和检索好处,包括仍然直接放在一个类别根下的文件. 仅凭明确的文件名并不能证明不进行评估是有理由的;提交了合理的步骤,同时记录了候选人团体为何应留在原地。 审查避免了分化和化妆花样,而不需要移动配额.

在同一类中,只能自动应用服务器验证的唯一路径更新:正文,标题,TL;DR,所订购的标记,创建日期和其他元数据必须保持不变. 语义、类别和混合变化保留所有者审查。 没有明确自动移动支持的老服务器接收审查候选人。 之前的动作和提议历史指南 复制,所以重复运行 避免化妆品重命名.

这些技能解释了稳定的ID,前行-路径别名,相对链接基础,移动收件和版本请求. 普通移动撤消使用已发现 `get_content_moves` 编号 : `undo_content_move` 在明确请求时使用工具 `revert`。将动态地发现新的服务器工具。 此版本更新了引导, 而不是更老的服务器能力 。 现有设施通过 `update-skills` 或它们启用的会话启动更新钩.

## 会话发现

Foundocs 技能通过管理的拖曳来引导代理解决配置的项目并读取 `get_project_context({ project_id, view: "index" })` 在一次会中首次使用每个项目。 紧凑索引结合了经常检索、最近有用和最近更新的文件和知识。 这是一种发现快捷键:如果一个条目缺失或不足,代理继续通过元数据,路径和身体搜索贯穿活动内容. 索引曝光不会添加检索记录.

没有索引模式的旧服务器仍然可以通过现有的上下文调用和搜索工具使用。 索引检索仍然是代理指导;单独的SessionStart hook只更新技能文件. 新设施中的同一指示舰和 `update-skills`。 。 。 .

## 自动更新技能

设置和 `update-skills` 安装一个 `SessionStart` 命令钩入 `.codex/hooks.json` (编码)或 `.claude/settings.json` (Claude Code),保存无关的钩和设置. 在启动,恢复,清除或分叉时,它检查公共npm元数据,并使用它的确切版本自动安装更新的稳定放出. 每个事件都会进行新的检查,而不是重用手动检查器的24小时缓存. 只有 Foundocs 技能, 管理指令和此勾通更新; MCP 运行时针, 连接设置和密钥保持不变 .

现有设施可实现一次,但没有新的连接代码:

```sh
npx --yes @foundocs/foundocs-setup@latest update-skills --root /absolute/project
```

同样的命令是手动更新命令. 主机信任仍然适用:与 Codex 一起审查并信任新钩子 `/hooks`,并接受Claude Code中的项目设置/执行审查。 禁用或不信任的钩子不运行。 永远不要绕过主机的信任政策. 需要时重新启动/重新加载主机;安装不会证明主机执行. Claude的钩子请求在成功更新后进行技能再扫描;已经上载的Codex指令可能需要重新装入.

登记请求有5秒的超时,并包执行45秒的超时. 失败情况仍然是没有障碍的,不打印证书或生子产出。 设置锁定、 资产散列和钩子所有权 防止本地编辑的并行写作和覆盖; 新建的安装发布永远不会被降级 `update-skills`。通过手动解决报告的冲突,然后重运行命令。 删除或禁用主机中的 FoundocsSessionStart 处理器选择退出; 设置将保留一个被修改/删除的被管理钩子作为冲突, 而不是默默恢复它 .

捆绑起来 `check-update.mjs` 仍然是只读的手动版本检查器,其24小时缓存和延迟支持老客户。 它本身并不安装软件包。 自动钩子故意无视这些旧的提议/推迟决定。 私人检查状态下生活 `~/.local/share/foundocs/setup/update-checks` 或相应的 `FOUNDOCS_SETUP_HOME` 目录。 安装器管理两个脚本, `foundocs/release.json` 和钩子通过更新/回滚生命周期.

## 档案和梦想

捆绑的 Foundocs 技能使用实时工具发现 `set_content_status` (原子1-100文件/知识档案或恢复), `get_archive_candidates` (运行范围审查证据)和 `approve_archive_proposal` (一个只存档案的提案在聊天时得到人类的明确批准). 现有 `set_knowledge_status` 仍然兼容只保存单一知识档案的服务器。 Stdio Bridge 前进服务器工具的策略和动态响应;不需要硬编码工具列表或运行时间升级,只是为了曝光这些工具.

应明确要求,人工确定执行目标。 "梦想永远不要自动存档":168小时/4个负评价阈值选择审查候选人,当前机构和受益用途也必须得到评估,只有具体的当前人类批准适用建议. 基于内容的低未来再利用价值也是提议将不必要的知识归档的理由,即使这种知识事实上是正确的,而且没有检索历史;罕见但有用的规则、决策背景和恢复经验教训仍然受到保护。 文件只获得存档建议。 见 [梦想协议](https://npmcn.com/package/%40foundocs/foundocs-setup/skills/foundocs/references/dreaming.md) 财务报告和审定财务报表 [评价个案](https://npmcn.com/package/%40foundocs/foundocs-setup/eval/README.md)。在孤立的固定装置中测试新的安装和技能更新;不覆盖开发者经编辑后安装的技能.

## 来源和释放

此寄存器包含安装器、 捆绑代理技能、 模板和测试 `@foundocs/foundocs-setup`。Foundocs应用程序和服务器分别维护。 使用此寄存器进行安装器更改并释放 .

GitHub Actions使用npm Trusted Publishing(OIDC)发布发行版本,没有存储npm写符. 公共寄存器允许npm出处将已公布的软件包与准确的出处承诺和工作流程相链接;它不认证代码的安全性. 在本工作流程之前公布的现有版本不会追溯到来源.

Npm 包中的一次性维护者设置 **设置 – 信任的出版商**数字 :

-   提供者: GitHub 动作
-   组织或用户: `foundocs`
-   仓库 : `foundocs-setup`
-   工作流程文件名 : `publish.yml`
-   环境:留空
-   允许直接出版方式 `npm publish`;仅限阶段出版需要人工审批.

在npm的配置验证窗口内完成第一次发布(目前为两天). 如果窗口过期, 在发布前重新创建发布器配置 .

在审查和合并软件包更改后发布 `main`数字 :

```sh
npm ci
npm test
npm run typecheck
npm version patch
git push origin main
git push origin --follow-tags
```

`npm version patch` 创建版本承诺并附加注释 `vX.Y.Z` 标签。 发布工作流程验证标签 `package.json`,运行测试,构建包并公开发布出处. 每个npm版本只能发布一次;如果当前版本已经存在,则使用新版本进行第一次自动发布.

见 [npm 受托出版](https://docs.npmjs.com/trusted-publishers/)。 。 。 .

## 可选效果测量(0.3.15)

安装的Foundocs技能在每次信息任务中自动检查项目政策。 当一个管理员已启用测量时,一个被支持的 shell 主机会冻结一个简短的预检索简报,并允许在其第一个索引/搜索/读取前列出本地源快照,然后在有益的检索后运行一对被测量的对. 用户不需要为每项任务输入命令 。 除非网站所有者/管理员明确改变政策,否则政策将停止执行.

经初步核实的探测跑道为克洛德代码2.1.312上macOS,现有克洛德登录并精确的型号ID等 `claude-haiku-5-5`Codex和克洛德壳主机可以协调. 编解码-内生探针,Linux/Windows待发平台金丝雀,无壳主机和缺失的隔离/认证被报告为无后退支持. 儿童工具在不同的快照中仅限于Read/Glob/Grep;只有协调员才能收到Foundocs证书. 监督员也会在其协调员崩溃时终止提供者的CLI.

`foundocs-setup measure prepare|run|flush --root ABSOLUTE_PATH` 接受私人 Stdin JSON. [已安装的程序](https://npmcn.com/package/%40foundocs/foundocs-setup/skills/foundocs/references/effect-measurement.md) 定义精确的输入和自动主机序列。 这是一种选入抽样的信息-获取比较,而不是全任务节省。 实际投入/产出/缓存使用和无效的估算美元分开保存,包括失败和注销的费用。 最大转弯和估计的美元设置不是硬的API/billing上限.

原始本地数据在制备+24h时过期;已规范的结算数据有自己的有限完成+24h寿命. 过期的原始数据无法通过同时的日记写入恢复 。 不确定报告传输在不重复模型推论的情况下重复相同的请求ID和有效载荷。 Raw CLI 笔录不是默认存储的.

维护者可以使用 `FOUNDOCS_EFFECT_LIVE_CHECK=1`数字 : `node eval/effect-isolation-check.mjs` 检查实际文件系统工具边界; `eval/effect-api-check.mjs`,使用产品检出 tsx 运行 `FOUNDOCS_PRODUCT_DIR` 和可选 `FOUNDOCS_EFFECT_CLI`,使用其孤立的PostgreSQL/HTTP固定. 这些检查涉及供应商的使用,绝不允许生产项目,并拆除其临时固定装置.

### 自动选择事件( 0. 3. 19)

新的编码和克劳德代码安装包括: `foundocs-capture-episode`页:1 `UserPromptSubmit` 检查站和有界限的检查站 `Stop` 倒计时。 审查和信任 通过主机安装了钩子定义( Codex) `/hooks` 或桌面钩子 ; Claude Code项目钩/设置审查)。 安装器永远不会改变 主机信任、批准或沙盒设置。 确认实际钩子执行和 远程 `capture_episode` 加当地 `episode_checkpoint` 工具发现后 重新连接; 单独安装的文件无法证明激活 .

现任东道法官的重要确认决定、核实结果和 发现,混凝土阻塞器和平时工作中的里程碑. 常规 转会在当地确认,而不创建远程候选人。 私营 检查站状态只包含最低限度的标识符;准备的请求包含 简单证据,从不记录 边框的发件箱保存精确 有效载荷/请求等待不确定的复试(32个请求,128个检查站,每个准备的请求14天); 清除使用)。 检查站所需元数据留待处理 在设立检查站后最多28天结算/期满;过期检查站 无法准备新请求。 停止可以要求每个检查点一个后续跟踪, 永远不要循环 无法写入 。 没有单独的推断 API 或新的模型密钥.

当地MCP `episode_checkpoint` 工具运行现有 stdio进程,因此普通的捕获不需要额外的 shell 文件系统访问. 只能使用新的便携运行时间和服务器广告 `capture_episode`。服务器的插曲工具仍然处理所有的远程写作. POSIX 私有存储被支持; Windows 目前跳过检查点捕获. 不支持/ 丢失的工具和失败保留了普通的工作, 从未转向 将一集插入文档。 证件同意和梦想同意不变.

**现有设施:** `update-skills` 并特意启动会话更新 保存被锁定的 MCP 运行时间 。 选择安装者拥有的便携式运行时间 此版本,运行新软件包的清晰升级,然后刷新技能:

```sh
npx --yes @foundocs/foundocs-setup@0.3.20 upgrade-runtime --root /absolute/project
npx --yes @foundocs/foundocs-setup@0.3.20 update-skills --root /absolute/project
```

遗产运输必须首先使用现有的 `migrate` 流动。 升级检查 保存外国设置和证书、日记 更改并支持中断的重试 。 0.3.20版本承认环境 列表由预集可移植运行时间写入,包括0.3.18; 更新运行时间 仍然需要插曲选择退出环境变量. 现有 冲突安全 `rollback` 恢复原安装日记基线, 它可以先于初始设置;它不是一个只运行时间的撤消命令. 重新连接MCP,并审查之后准确的新钩子散列. 技能更新完成 不静静地激活或升级运行时间 . `doctor` 运行时间支持 和现场/现场检查锁与主机核查分开。 如果坠毁 帮助者离开一个 stale 锁, 确认其进程已经结束, 只删除 已报告锁定;保存发件箱和证书.

在不编辑的情况下通过添加退出管理钩/技能 `"episodes": {"enabled": false}` 改为 `foundocs.json`,或以 `FOUNDOCS_EPISODES=off`. 删除/修改所管理钩作为更新处理 冲突;其他钩子和用户编辑的技能仍然保留.

对于选入的活包验证, `eval/episode-host-check.mjs` (运行与邦) 安装一个 `.tgz` 由 HTTP/PostgreSQL 产品支持的孤立项目 修补。 供应 `FOUNDOCS_EPISODE_LIVE=1`, (中文(简体) ), `FOUNDOCS_PRODUCT_DIR`, (中文(简体) ), `FOUNDOCS_EPISODE_PACKAGE`,以及测试数据库 URL。 它从不编辑主机信任. 审查每个实际东道方生成的项目,执行普通任务 一个微不足道的检查,然后发送 `verify` 以检查持续的事件。 这个固定 与定型单元测试分开,不主张模式执行 仅仅因为安装成功.

开始修补后, `eval/episode-host-run.mjs` 运行普通模型 转动并声明所观察到的工具路径。 设定 `FOUNDOCS_EPISODE_CLIENT` 改为 `codex` 或者说 `claude`,以及 `FOUNDOCS_EPISODE_CASE` 改为 `important` 或者说 `routine`。 。 。 . 编码还需要一个明确的 `FOUNDOCS_EPISODE_MODEL` 财务报告和审定财务报表 `FOUNDOCS_EPISODE_REVIEW_HOOKS=1` 在审查生成的命令后。 这个 选入测试使用主机精确的 hash 钩检定 RPC 在孤立的临时 CODE\\HOME,有工作空间写作和根据请求批准. 它永远不会改变 真实用户配置。 Claude 使用项目/ 本地设置和一个范围化工具 允许列表, 不允许绕行 . `eval/episode-api-check.mjs` 单独 检查脚本的API假想;这些假想不报告为主机模型证据.

## 常见问题

### @foundocs/foundocs-setup 是什么？

Foundocs 远程 MCP 服务器可重复的项目设置和代理技能

### 如何安装 @foundocs/foundocs-setup？

在项目目录运行 npm install @foundocs/foundocs-setup，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 foundocs-setup，可以用 npx foundocs-setup 直接运行。

### @foundocs/foundocs-setup 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/foundocs\_\_foundocs-setup 是否存在。

### @foundocs/foundocs-setup 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @foundocs/foundocs-setup 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.19\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @foundocs/foundocs-setup 可以商用吗？

@foundocs/foundocs-setup 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @foundocs/foundocs-setup 的下载量有多少？

根据 npm 官方下载统计，@foundocs/foundocs-setup 在 2026/10/16 – 2026/11/14 这 30 天内被下载 2,769 次，日均约 92 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @foundocs/foundocs-setup 还在维护吗？

最新版本 0\.3\.20 发布于 2026/11/11（4 天前）；至今共发布 23 个版本，其中过去 12 个月发布了 23 个；首次发布于 2026/10/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。