# @archymedes/friday 中文文档 规范地址：https://npmcn.com/package/%40archymedes/friday/ 版本：3\.13\.0 npm 元数据更新时间：2026-11-07T01:12:17.028Z 中文译文更新时间：2026-11-07T08:32:02.206Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40archymedes/friday 原文对照：https://npmcn.com/package/%40archymedes/friday/?lang=original 项目主页：https://github.com/chrisnkuno/archymedes-cli/tree/master/packages/friday-cli#readme 源码仓库：https://github.com/chrisnkuno/archymedes-cli ## 关键信息（来自 npm 元数据） - 包体积（解压后）：4.2 MB，27 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=22\.5 - 运行依赖：0 个 - 首次发布：2026-10-18T13:45:07.770Z - 最新版本发布：2026-11-07T01:12:16.833Z - 近 30 天下载量：1983（2026-10-07 至 2026-11-05，npm 官方下载统计） - 已发布版本数：14（近 12 个月 14 个） ## 中文简介 星期五——您终端的编码代理,显示它的工作,在它改变任何东西之前询问,并证明一个改变的作品. 任何型号:十个供应商,免费型号,你的克洛德订阅或者你的ChatGPT计划. ## 安装 ```sh npm install @archymedes/friday ``` 也可以使用：`pnpm add @archymedes/friday`、`yarn add @archymedes/friday`、`bun add @archymedes/friday` ## README # 星期五 **您终端的编码代理 .** 它展示它的工作, 问之前它改变什么 证明一个改变工作 之前它叫它做。 带任何模特儿来: 10个人的钥匙 提供商,免费模型,你的克劳德订阅,或你的ChatGPT计划. ```bash npm install -g @archymedes/friday cd your-project friday ``` 就这样 第一次跑步会帮助你选择一个模型,然后输入要完成的工作. * * * **目录** - 前进: [为什么是星期五](https://npmcn.com/package/%40archymedes/friday/#readme-why-friday) • 妇女 [三步开始](https://npmcn.com/package/%40archymedes/friday/#readme-start-in-three-steps) • 妇女 [选择您的模型](https://npmcn.com/package/%40archymedes/friday/#readme-choose-your-model) - 用它来: [请求如何运行](https://npmcn.com/package/%40archymedes/friday/#readme-how-a-request-runs) • 妇女 [模式](https://npmcn.com/package/%40archymedes/friday/#readme-modes-how-much-it-may-do-alone) • 妇女 [帮助者](https://npmcn.com/package/%40archymedes/friday/#readme-helpers-several-agents-at-once) • 妇女 [接口](https://npmcn.com/package/%40archymedes/friday/#readme-the-interface) • 妇女 [图标](https://npmcn.com/package/%40archymedes/friday/#readme-commands) - 相信这一点: [是什么让你的密码安全](https://npmcn.com/package/%40archymedes/friday/#readme-what-keeps-your-code-safe) • 妇女 [把它给你](https://npmcn.com/package/%40archymedes/friday/#readme-make-it-yours) - 其它东西: [脚本和编辑器](https://npmcn.com/package/%40archymedes/friday/#readme-scripts-and-editors) • 妇女 [问 题](https://npmcn.com/package/%40archymedes/friday/#readme-questions) • 妇女 [所需资源](https://npmcn.com/package/%40archymedes/friday/#readme-requirements) ## 为什么是星期五 | | 你得到的东西 | | --- | --- | | 🔌 **任何型号** | 10个提供商用你自己的钥匙,免费的模型 通过OpenRouter,Ollama在你的机器上, **您的克劳德订阅** 通过你自己的克洛德代码,或 **您的 ChatGPT 计划** 通过 Codex. 切换中间对调 `/model`对话还在继续. | | 🛡️ **在行动前问** | 四种模式,从"只读并求婚"到"独自跑步,但为了任何有风险的东西停下来". 每一个编辑和命令都可以通过一次,总是,或者通过模式. | | ✅ **"死"之前的证据** | 除非有东西显示它有效,否则改变不会完成。 默认是星期五先写测试,看到测试失败,再写代码. | | 🤝 **并行帮助者** | 周五将任务的部分交给帮手:探险家一次搜索多地,计划员,审查员,核查员. 帮助在背景中编辑自己的 git 分支 . | | 💬 **一边说一边说** | 运行时键入:"使用标签,而不是空格"在下次编辑之前到达,而不是在转弯之后. | | 💾 **什么都没有丢失** | 每个步骤都省了下来。 关闭终端,或让它坠毁 `friday --resume latest` 继续,包括帮助者. | | 🖥️ **您终端中的桌面** | 用于聊天的Windows,文件,更改,会话和模型,由箭头键和鼠标驱动. | | 🔒 **守护模式** | 一个安全工程师,跟踪游戏本,扫描被泄露的秘密,并用其文件,行和撞击报告每个发现. | | 🧩 **在你工作的地方工作吗** | 在 Zed 和其他编辑器中浏览代理客户端协议,或使用脚本 `--json`。 。 。 . | ## 三步开始 1. **安装它.** `npm install -g @archymedes/friday` 单曲 `friday` 命令在您的机器上. 2. **在一个项目中运行它.** `cd` 输入有代码和类型的文件夹 `friday`。一个简短的行走问题 对于您的名称,一个主题和一个模式,然后使用哪个模式。 挑个供货商,贴上钥匙,然后 从它发回的列表中选择一个模型。 通过这些工具选择克洛德或Codex 换句话说. 3. **问甚么.** 输入请求并按下输入 : ```bash friday # open a session in this folder friday "fix the failing test in src/parser.ts" # open it with a request already sent friday --resume latest # carry on where you left off friday --free # free models only, never a paid one ``` `friday --help` 列出每个选项,以及 `/` 在会话中列出每个命令. ## 选择您的模型 | 提供者 | 你需要的东西 | | --- | --- | | 安东尼 | `ANTHROPIC_API_KEY` | | 开放AI | `OPENAI_API_KEY` | | 打开路透社 | `OPENROUTER_API_KEY` | | 谷歌双子座 | `GOOGLE_API_KEY` | | 页:1 大赦国际 | `XAI_API_KEY` | | 深层搜索 | `DEEPSEEK_API_KEY` | | 迷雾 | `MISTRAL_API_KEY` | | 格罗克 | `GROQ_API_KEY` | | Ollama(当地) | 无: Ollama 在这个电脑上运行 | | 任意 OpenAI 兼容的终点 | `OPENAI_COMPATIBLE_API_KEY` 财务报告和审定财务报表 `OPENAI_COMPATIBLE_BASE_URL` | | 免费模型( E)`--free`(中文(简体) ) | `OPENROUTER_API_KEY`; 仅使用免费模型 | | **克劳德(你的订阅)** | 个人的克洛德密码,签名于(`claude auth login`(中文(简体) ) | | **代码( 您的 ChatGPT 计划)** | 已签名的您自己的 Codex CLI ()`codex login`(中文(简体) ) | **钥匙去哪.** 将其粘贴到供应商( E)`alt+p`)或(或) `friday settings`,或设置在您的 环境. `_MODEL` 选择供应商的模型,和 `_SMALL_MODEL` 一个便宜的 用于搜索、检查和摘要. **你的克洛德计划.** 克洛德被选中了,你自己的克洛德代码负责工作,按你的计划计费. 周五的回答,将许可问题放在周五的审批对话框中,并保留 交换模型时的对话。 星期五从不见你的Claude和ChatGPT账户. ## 请求如何运行 1. **它看起来第一.** 周五阅读和搜索项目,经常有帮助者探索 地点马上. 2. **它计划工作** 作为清单,你可以看到(`/todos`) (中文(简体) ). 3. **先写测试**运行他们,并看到他们失败的原因. 4. **它改变代码**,在每次编辑或命令前询问您的模式不允许. 每个工具调用在聊天中随其发生而显示,结果. 5. **证明改变是可行的** 通过测试,然后项目自己的检查。 一个建筑 单靠自己是不够的. 6. **它提出了下一步:** 下三个步骤,每个步骤都有原因. `alt+1`, (中文(简体) ), `alt+2` 或者说 `alt+3` 输入一个. 您可以在任何时间输入: 您发送到星期五的下个步骤 。 Esc停止转弯. ## 模式:它单独能做多少 | 模式 | 它会做什么 | 切换为 | | --- | --- | --- | | **计划** | 阅读和提议;它没有能够改变任何东西的工具 | `/plan` | | **构建** (默认) | 每个编辑和每个不只读的命令都先问你 | `/build` | | **自动** | 自行编辑和命令; 任何风险仍然要求 | `/auto` | | **辩护人** | 安全工作:发现并纠正脆弱性,每起变化都要求 | `/defender` | 转动+转动周期 `--plan`, (中文(简体) ), `--auto` 或者说 `--defender` 从一个开始。 只读 命令,例如: `git status`, (中文(简体) ), `ls` 或者说 `rg` 永远不要问,在任何模式. ## 帮手:数名代理 星期五在助手(子代理人)之间分工工作,并在任务需要时自行使用: - **探索** 在同一时间搜索工程的若干部分; - **计划** 在任何变化之前设计一种方法; - **审查** 用新眼睛读取变化; - **校验** 检查和报告过去的情况; - **常规** 做一个完整的工作. 帮助者可以在周五继续工作时在背景中运行. 在背景作品中编辑的作品 因此它从不编辑 周五的文件, 它的报告说如何取回它 工作时. `/subagents` 显示每个人在做什么。 自己写入 `.archymedes/agents/.md` (见 [写角色](https://github.com/chrisnkuno/archymedes-cli/blob/master/docs/engine/SUBAGENTS.md#writing-a-role)) (中文(简体) ). ## 接口 `friday` 在终端中打开一个小桌面。 键盘和鼠标都有效. | 密钥 | 打开 | 密钥 | 打开 | | --- | --- | --- | --- | | F1 导弹 | **聊天**: 谈话和每个工具呼叫 | F7 电话 | **密钥**: 每条快捷键 | | F2 请检查DATE=中的日期值 (帮助) F2 | **文件**: 浏览和预览 | F8型导弹 | **帮助** | | F3 联合国 | **搜索** 整个项目 | F9 联合国 | **状态**:每转弯时的标志、时间和工具 | | F4 联合国 | **会议**: 较早的对话 | F10 法语 | **变动**: 每个已更改的文件及其 diff | | F5 电话 | **模型**:每个模型,活,价格 | F12 请检查URL=值 (帮助) | **图片库**: 屏幕后的照片 | | F6 导弹 | **主题** | `alt+p` 编号 : `alt+s` | **供应商** 编号 : **设置** | - **单行一法.** 点击选择并打开第二次点击。 箭头会移动,会打开 埃斯克回到了酒吧。 轮回卷起指针下所取之物. - **寻取者.** `alt+g` 显示星期五可以作为图标打开的一切: 应用程序、命令、会话、文件、, 主题。 类型搜索所有它们. - **开始菜单.** `ctrl+space` 找到任何应用程序、动作、会话或文件. - **关于diff的评论.** 变化中, `[` 财务报告和审定财务报表 `]` 选一行 `c` 在上面写个字条 你的笔记 随您的下一封信件一起去, 随其文件、 行和代码一起去. - **输入时建议 .** 输入的上行提供命令, 更早的请求或 您似乎正在准备的文件; tab 把它拿走 . `ARCHYMEDES_SUGGEST=off` 关闭建议. - **让它看起来像你的.** `/theme` 财务报告和审定财务报表 `/wallpaper` 显示在移动时的预览. `alt+w` 重放首发出道. ## 图标 类型 `/` 在一个会议中看到他们全部。 你将使用最多的: | 命令 | 对 | | --- | --- | | `/model [name]` | 切换模型或提供者; 对话继续进行 | | `/plan` `/build` `/auto` `/defender` | 更改模式 | | `/todos` | 星期五的任务清单 | | `/subagents` | 援助者:每个人的行为或发现 | | `/tools` | 此模式中的每个工具, 它可能改变什么, 以及它是否要求 | | `/compact [focus]` | 将谈话总结为免费房间,保留您的名字 | | `/commit [guidance]` | 周五审查变革并做出承诺;从未推动 | | `/push`, (中文(简体) ), `/pr [guidance]` | 推动分支; `/pr` 然后用 `gh` | | `/worktree [name]` | 在自己的工作树上设立一个新的分会 | | `/resume`, (中文(简体) ), `/new`, (中文(简体) ), `/export` | 早先的会话; 新的会话; 此会话作为 Markdown | | `!command` | 运行 shell 命令; 输出未发送到星期五 | | `@path` | 在信件中提及一个文件 | | `/undo`, (中文(简体) ), `/rewind`, (中文(简体) ), `/diff` 回到最后转弯(文件、谈话或两者),回到任何转弯,看看有什么变化 | `/btw ` 一个侧面问题,即使周五工作;答案不在谈话中 | `/cost`, (中文(简体) ), `/subagents` 由交谈和每位助手使用 | `/skills`, (中文(简体) ), `/mcp`, (中文(简体) ), `/hooks`, (中文(简体) ), `/lsp` 星期五为这个项目找到的 | `/profile [name]`, (中文(简体) ), `/vim` qq 另一组密钥和设置; 输入中的 vim密钥 qq `/review`, (中文(简体) ), `/fork`, (中文(简体) ), `/goal`, (中文(简体) ), `/context` 财务报告和审定财务报表 `/memory` 仍然需要更早的TypeScript引擎. A 类 命令,如果无法使用,则会这么说,以及如何获得. ## 是什么让你的密码安全 - **你批准修改.** 可以从现在开始批准这项行动 用于安全模式,如命令前缀或文件夹. - **冒险行动总是停止.** 即使是在汽车模式,星期五问 任何触摸之前 证书、部署、出版、推动或特权命令。 一些命令被拒绝 直截了当: `rm -rf`, (中文(简体) ), `git reset --hard`, (中文(简体) ), `mkfs`。 。 。 . - **它永远不会覆盖它所没有看到的东西.** 从星期五开始更改的文件读取 重新编辑之前. - **你自己的规矩.** `.archymedes/rules.json` 说到哪个命令 `allow`永远 `ask`,或 `forbid`他们的第一话 每个规则可以带例,在加载时检查,所以规则 而不为所欲为 ```json { "rules": [ { "prefix": ["rm", ["-rf", "-fr"]], "decision": "forbid", "reason": "Use trash-put instead.", "match": ["rm -rf build"] }, { "prefix": ["git", "push"], "decision": "ask", "not_match": ["git pull"] }, { "prefix": ["npm", ["test", "run"]], "decision": "allow" } ] } ``` - **撤销.** 星期五在每个回合前(在git仓库)对项目进行快照 `/undo` 设置 返回文件, 创建已删除并删除已恢复的文件 。 剩下的是你自己的舞台改动 一个人. - **你的钩子.** 你们在每次行动之前和之后运行的指令 可以阻止一个,在同一个 作为 Claude 代码的格式. 周五守着你的密码 特工运行的机器是另一个问题: **参数**,从相同的 团队,看那台机器, 保存当地的证据 并说它看不到的东西。 免费的 Linux 服务器, Windows + WSL2 的桌面版在免费β中: [archivemedes.xyz/en/溶液/辩证](https://www.archymedes.xyz/en/solutions/argus/?utm_source=friday&utm_medium=npm-readme)。 。 。 . ## 把它给你 所有东西都住在下面 `.archymedes/` 在项目,所以它与寄存器一起旅行. | 文件 | 对 | | --- | --- | | `AGENTS.md` (或 `CLAUDE.md`, (中文(简体) ), `ARCHYMEDES.md`(中文(简体) ) | 项目指示,发给星期五,每次提出要求 | | `.archymedes/commands/audit.md` | 属于您的命令 : `/audit`· ; `$ARGUMENTS` 是您在它之后输入的 | | `.archymedes/agents/.md` | 自己的助手:其指示、工具、模型和限制 | | `.archymedes/rules.json` | 命令允许、询问或禁止 | | `.agents/skills//SKILL.md` (或 `.claude/skills/`) 技能: 指令 周五任务需要时加载 QQ | `.mcp.json` (或 `.archymedes/mcp.json`QQ MCP 服务器; 其工具在需要上下文之前不会花费上下文 QQ | `.claude/settings.json` 或者说 `.archymedes/hooks.json` QQ 钩子,以 Claude Code 格式 QQ 文件其他代理在这里读取的是: AGENTS.md, Claude Code 的技能, MCP 服务器和 钩子. 星期五也通知你,当转弯结束的时候,或者当你在别处等待的时候, 发送请求中命名的图片,并在每次编辑中添加语言服务器的错误(gopls, pyright,打字语言服务器,生锈分析器,克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克. ## 脚本和编辑器 **在编辑.** `friday acp` 在stdio上说代理客户协议。 在 Zed 的设置中: ```json { "agent_servers": { "Friday": { "command": "friday", "args": ["acp"] } } } ``` **在剧本中.** 星期五运行时没有接口并打印结果 : ``` friday --print "add a health check" one request; the answer on stdout, progress on stderr friday --json "add a health check" the same, as JSON lines for another program echo "add a health check" | friday a request from a pipe friday --provider groq --model openai/gpt-oss-120b friday settings keys, models, preferences friday history earlier sessions friday doctor what is wrong with your setup, if anything friday update install the newest Friday friday login | logout link this computer to your Friday account, or unlink it ``` ## 问 题 **哪个引擎运行我的会话?** 周五的引擎在Go上写着 然后在Go里面运行 `friday` 二进制. 仅需要 TypeScript 引擎的会话( Codex, 对于一个) 在那里独自运行。 设置 ~ 引擎为每个会话选择一个会话 . **我能不用付模特费就用吗?** 对: `friday --free` 带有免费 OpenRouter 密钥用途 免费模特 永远不要回到有报酬的模特 奥拉玛在自己的电脑上运行模型. **东西不起作用.** `friday doctor` 说说你的设置有什么问题 这个 [用户指南](https://github.com/chrisnkuno/archymedes-cli/blob/master/docs/engine/USER_GUIDE.md#troubleshooting) 盖取其余. **完整的文件在哪里?** [发动机](https://github.com/chrisnkuno/archymedes-cli/blob/master/docs/engine/README.md), (中文(简体) ), 页:1 [用户指南](https://github.com/chrisnkuno/archymedes-cli/blob/master/docs/engine/USER_GUIDE.md), (中文(简体) ), [配置](https://github.com/chrisnkuno/archymedes-cli/blob/master/docs/engine/CONFIGURATION.md), (中文(简体) ), [工具](https://github.com/chrisnkuno/archymedes-cli/blob/master/docs/engine/TOOLS.md), (中文(简体) ), [帮助者](https://github.com/chrisnkuno/archymedes-cli/blob/master/docs/engine/SUBAGENTS.md) 财务报告和审定财务报表 [编辑](https://github.com/chrisnkuno/archymedes-cli/blob/master/docs/engine/EDITORS.md)。 。 。 . ## 所需资源 - **Linux, macOS 或窗口**,在x64或arm64上。 这个 `friday` 二进制随包裹而来. - **节点22.5或更新**对于设置, `--json` 和关于 TypeScript 引擎的会议. - **可选 :** `git` 更改、背景助手和工作树; `gh` 页:1 `/pr`页: 1 claude Code或Codex使用这些计划. Apache -2.0 许可。 资料来源: [github.com/chrisnkuno/archymedes-cli 页面存档备份,存于互联网档案馆](https://github.com/chrisnkuno/archymedes-cli)。 。 。 . ## 常见问题 ### @archymedes/friday 是什么？ 星期五——您终端的编码代理,显示它的工作,在它改变任何东西之前询问,并证明一个改变的作品\. 任何型号:十个供应商,免费型号,你的克洛德订阅或者你的ChatGPT计划\. ### 如何安装 @archymedes/friday？ 在项目目录运行 npm install @archymedes/friday，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 friday，可以用 npx friday 直接运行。 ### @archymedes/friday 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/archymedes\_\_friday 是否存在。 ### @archymedes/friday 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @archymedes/friday 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22\.5。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @archymedes/friday 可以商用吗？ @archymedes/friday 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### @archymedes/friday 的下载量有多少？ 根据 npm 官方下载统计，@archymedes/friday 在 2026/10/07 – 2026/11/05 这 30 天内被下载 1,983 次，日均约 66 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @archymedes/friday 还在维护吗？ 最新版本 3\.13\.0 发布于 2026/11/07（今天）；至今共发布 14 个版本，其中过去 12 个月发布了 14 个；首次发布于 2026/10/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。