PenguinHarness Web App 使用指南从聊天到 Agent、模型、用量一站式管理【免费下载链接】penguin-harness Unified and Stable RSI Platform项目地址: https://gitcode.com/gh_mirrors/pe/penguin-harnessPenguinHarness 是一个开源、本地优先的多 Agent 开发平台它的 Web App 让你在浏览器里一站式完成 AI Agent 聊天、智能体管理、模型配置与 Token 用量追踪。本文面向新手用户带你用最短的路径上手从启动 Web 服务、首次登录到发起对话、管理 Agent、配置模型、查看成本中心每个步骤都给出可操作的说明让你无需阅读源码就能把这套 Agent 平台跑起来。快速启动三条路径任选其一PenguinHarness 提供四条入口桌面应用、命令行 Web App、Docker、SDK对普通用户来说最常用的是前两条。路径适合人群是否需要终端️ 桌面应用把它当产品直接用的新手完全不需要打开即已登录⌨️ 命令行 Web App想装到服务器或远程机器安装时用一次桌面应用macOS / Windows 安装包均已签名双击安装后直接打开界面就是下图左侧那套 Web AppLinux 的 AppImage 首次启动前需授予执行权限。命令行一行安装脚本装好penguin命令后运行penguin web服务就绪后会打印地址并自动打开浏览器http://127.0.0.1:7364。首次启动时服务端会在终端里打印一条带边框的首次登录链接用内置的admin账号打开它、设置密码即可正式使用。更多路线Docker、SDK见官方文档 packages/docs/content/quickstart.zh.md。 所有路径共用同一个数据目录~/.penguin/dataAgent、模型配置和历史会话都保存在其中随时可以换路径继续用。认识界面布局侧边栏就是全部入口Web App 左侧的侧边栏集中了除对话之外的所有功能从上到下依次为入口作用对应文档新建对话打开一份新对话草稿packages/docs/content/chat.zh.md智能体创建和管理 Agent提示词、工具、Skill、记忆、定时任务packages/docs/content/agents.zh.md模型库配置模型的供应商、API key 与默认模型packages/docs/content/models.zh.md成本中心按 Agent、模型和时间范围查看 Token 用量与成本packages/docs/content/usage.zh.md评估中心用 Benchmark 评估并优化 Agentpackages/docs/content/evaluation-center.zh.md几个新手容易忽略的细节Project 切换器在侧边栏顶部一个 Project 包含它的 Agent、模型和对话可在此新建 Project 或管理成员。提醒圆点入口上出现圆点表示有事待处理——Agent 内核过旧、模型可同步、插件可更新、成本中心有新异常鼠标悬停即可看到说明。轨迹观测没有独立入口它是对话页右侧的一个侧边面板随时可以展开查看当前对话的执行轨迹。对话与 Agent 一起工作的地方点击新建对话草稿会默认使用 Project 的「新对话默认值」Agent、工作目录、审批模式、模型、思考等级发送第一条消息后才真正创建 Session。发送消息支持Enter 发送、ShiftEnter 换行直接粘贴图片或把文件拖进对话区作为附件超长文本20,000 字符或 400 行粘贴后自动变成.txt附件不塞进输入框。审批模式共四种在输入框上方选择全部放行allow-all、全部拒绝deny-all、放行只读read-only、总是询问always-ask。新手建议先用「放行只读」只读操作自动执行写操作每次让你确认兼顾效率与安全。常用斜杠命令输入/打开命令菜单命令作用/compact压缩上下文释放空间/agent把对话交接给另一个 Agent/model换用另一个模型开新对话延续/goal开启目标模式让 Agent 按 Token 预算自主循环直至完成Agent 运行期间你随时可以插话默认或排队插话会随 Agent 下一轮送达超过 10 秒的长命令还能一键转入后台执行不阻塞主流程。智能体Agent从一句话开始在侧边栏进入智能体页可以看到当前 Project 里的所有 Agent 卡片名称、Session 数、工具、Skill、记忆等统计一目了然点击任一数字直达对应设置标签页。用 AI 创建 Agent是最快的上手方式点用 AI 创建选一个示例随记智能体、金融 Copilot、文档 RAG 智能体、深度研究报告智能体、报告写作智能体描述你的需求后发送default_agent会替你完成创建、安装需要的 Skill 并报告结果。也可以手动创建从插件市场勾选要装的插件或从项目目录导入已有技能。每个 Agent 拥有独立的「Agent State」系统提示词、运行参数、工具、Skill、钩子、记忆、密钥保险柜和定时任务都集中存放在 packages/core/ 与 packages/server/ 中实现的服务端状态里可以整体导出为快照包复制到另一个 Project 或另一台机器。模型库最快配置模型的方法进入模型库页面模型按供应商分组列出DeepSeek、OpenAI、Anthropic、Google Gemini、OpenRouter、TokenDance、vLLM、Custom 等。配置一个新模型只需三步在目标分组点填写密钥粘贴 API key展开分组点击模型卡片打开模型配置核对上下文窗口与价格点设为默认模型——之后所有新对话默认使用它。想接自己的本地或第三方端点新建一个Custom分组填入 base URL 与 key还能直接导入模型PenguinHarness 会请求 OpenAI 兼容端点的模型列表一键批量导入全部模型。价格按每百万 Token 计可在设置里切换美元 / 人民币显示。成本中心Token 用量与成本一眼看清侧边栏的成本中心页面标题「成本与统计」地址/usage回答三个问题用了多少 Token、花了多少钱、哪些请求失败了。汇总卡片今日 / 近 7 天 / 累计的 Token 用量、请求数、成本四张图表各 Agent 请求与成功率、各模型请求与成功率、Token 变化、成本变化悬停任意柱段可查看该时间桶明细异常面板列出服务器记录的错误码与消息近 7 天出现未预期异常时侧边栏会亮圆点提醒。筛选器支持按 Agent、模型和时间范围组合日期范围自动决定图表精度最近一小时按分钟、近 7 天按天不用单独设置。轨迹观测与评估中心Agent 的每一次调用都可见对话页右下的侧边面板里藏着两个「可观测性」利器。轨迹观测展示当前对话的 Trace 文件全局统计轮次、输入 / 输出 Token、缓存命中、成本、TPS、每一轮的执行时间线思考、模型回复、工具调用逐段着色、逐条事件还可以一键导出。评估中心则面向「让 Agent 变强」内置的 Example Benchmark 开箱即用可以持续记录每次评估的 Score 曲线、模型版本与成本配合插件市场里的agent-tuning等插件形成「跑基准 → 找失分点 → 发新版本」的 Agent 自我进化闭环。插件源码见 plugins/agent-tuning/。小结PenguinHarness Web App 把 Agent 聊天的完整生命周期收进一个浏览器窗口启动快一行penguin web或双击桌面应用首次登录只需打开一条链接对话顺附件、插话、后台任务、斜杠命令一应俱全管理全Agent、模型、插件、Project 成员在同一套界面里管理花费明成本中心把 Token 与费用按 Agent / 模型 / 时间拆开过程透轨迹观测 评估中心让每一步都可见、可评估、可优化。想深入某个部分可以直接阅读对应的中文文档快速开始、对话、智能体、模型与供应商、成本中心。【免费下载链接】penguin-harness Unified and Stable RSI Platform项目地址: https://gitcode.com/gh_mirrors/pe/penguin-harness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考