使用场景与配方

当你已经清楚希望 OpenSquilla 做什么，但不确定应该先阅读哪份功能指南时，请使用本页面。

首次成功运行

目标：安装 OpenSquilla，配置一个 provider，并发出一条真实消息。

opensquilla onboard
opensquilla gateway run

然后打开：

http://127.0.0.1:18791/control/

如果你更喜欢使用终端：

opensquilla chat

延伸阅读：

• quickstart.md
• web-ui.md
• providers-and-models.md

降低模型成本

目标：让简单工作运行在更便宜的模型上,并将更强的模型保留给困难的 turn。

opensquilla configure router --router recommended
opensquilla cost --by-model

需要查看 routing 与运行时行为时,使用诊断：

opensquilla diagnostics on

延伸阅读：

• features/squilla-router.md
• features/tool-compression.md
• features/compaction-and-cache.md

处理大型 tool 结果

目标：让 agent 检查日志、网页、表格、搜索结果或 diff,同时不让模型上下文被淹没。

从一个受限的 workspace 运行开始：

opensquilla agent \
  --workspace /path/to/project \
  --workspace-strict \
  -m "Inspect the latest logs and summarize the actionable failures"

如果该 turn 显得过慢或过于昂贵：

opensquilla cost
opensquilla diagnostics on

延伸阅读：

• features/tool-compression.md
• tools-and-sandbox.md
• troubleshooting.md

构建可重复的 workflow

目标：将重复性工作转化为可复用的 skill 或 MetaSkill。

查找已有 skill：

opensquilla skills search report
opensquilla skills view <skill-name>

在运行前查看一个 MetaSkill：

opensquilla skills inspect <meta-skill-name>

查看历史 MetaSkill 运行记录：

opensquilla skills meta runs list
opensquilla skills meta runs show <run-id>

延伸阅读：

• features/skills.md
• features/meta-skills.md
• artifacts-and-media.md

记住有用的上下文

目标：保留偏好、项目笔记或可复用的任务上下文,以便未来的 turn 能找到它们。

opensquilla memory status
opensquilla memory search "project preference"
opensquilla memory list

查看已存储的记忆文件：

opensquilla memory show <path>

延伸阅读：

• features/memory.md
• features/compaction-and-cache.md

连接消息 channel

目标：在保留 gateway 作为本地控制中心的同时,从受支持的消息接入面使用 OpenSquilla。

opensquilla channels types
opensquilla channels describe telegram
opensquilla channels add telegram --name personal
opensquilla gateway restart
opensquilla channels status personal --json

延伸阅读：

• channels.md
• configuration.md
• tools-and-sandbox.md

调度周期性任务

目标：让 OpenSquilla 周期性地运行某项任务,而无需手动打开 chat。

opensquilla cron add \
  --every 1h \
  --text "Summarize important project updates" \
  --name hourly-project-check

查看任务与运行记录：

opensquilla cron list
opensquilla cron status <job-id>
opensquilla cron runs <job-id>

延伸阅读：

• operations.md
• channels.md
• scheduling.md

发布用户可见的 artifact

目标：让 agent 产出一个你可以检查与分享的文件、报告、幻灯片、HTML 页面、图像或媒体资产。

opensquilla agent -m "Create a short HTML report from the current notes"
opensquilla sessions export <session-key>

延伸阅读：

• artifacts-and-media.md
• features/skills.md
• features/meta-skills.md

从一次失败的运行中恢复

目标：弄清发生了什么、降低风险并安全地继续。

opensquilla doctor
opensquilla gateway status
opensquilla sessions show <session-key>
opensquilla cost

如果某个 tool 被拒绝,或 agent 拥有了过多权限：

opensquilla sandbox status
opensquilla agent --permissions restricted -m "Read only"

延伸阅读：

• troubleshooting.md
• tools-and-sandbox.md
• approvals-and-permissions.md
• diagnostics-and-replay.md
• operations.md

文档索引 · 产品指南 · 改进此页面 · 报告文档问题