快速开始
快速开始
用 10 分钟在 Downcity 基础设施上跑通第一个本机 Agent
快速开始
1. 安装
npm install -g downcity
# 或
pnpm add -g downcity
town --version
city --version
downcity安装后会提供town和city两个命令。如果安装后仍然找不到
town，请先看 FAQ。后续升级可以直接执行
town update，它会更新你最初安装的那个包。
2. 初始化 Town（仅首次）
town init该命令会生成本地 Town 状态，并准备 City 连接层（位于 ~/.downcity/）。
3. 启动 Town
town start
town agent start依赖本地 Town runtime 先运行。
4. 初始化项目
cd /path/to/your-repo
town agent create .初始化后会生成：
PROFILE.md（必需）SOUL.md（可选）downcity.json.downcity/运行目录
5. 绑定模型
当前项目 agent 绑定的是 City AIService 暴露出来的模型 ID。模型目录由 city 管理，Town 通过 town city 连接到 City。
downcity.json 最小示例应为：
{
"name": "my-agent",
"version": "1.0.0",
"execution": {
"type": "api",
"modelId": "quality"
}
}说明：
modelId指向已连接 City AIService 暴露的某个模型- 项目把选中的模型记录在
execution.modelId - 如果你还没有连接 Town 与 City，请先执行
town city login再启动 Agent
6. 启动 Agent
启动（默认后台 daemon，适合长期运行）：
town agent start如果你当前不在已初始化的 agent 目录里，Downcity 会从已登记 agent 中提供交互式选择。
需要在当前终端前台观察日志时再用：
town agent start --foreground7. 验证 Agent 状态
town agent list
town agent status
town agent list --running说明：
- agent 端口由 console 自动分配，不建议在快速开始里固定写死端口。
- 多 agent 场景下，每个 agent 端口可能不同。
8. 可选：启动 Console UI
town start --console9. 可选：Chrome 扩展网页选区直发 Agent
如果你在使用仓库内的 chrome-extension：
- 在网页中选中文本后，选区右下角会出现消息按钮，点击后输入框会在选区左下角展开。
- 点击浏览器扩展图标会打开 Extension Popup；按
Cmd/Ctrl + U可直接打开页内输入框（Inline Composer）。 - Extension Popup 只保留极简输入框、发送按钮、本页发送历史，以及一个设置按钮。
- Extension Popup 中 Agent 切换为极简模式；Channel Chat 会按当前 Agent 自动选择首个可用会话。
- 点击历史记录可快速回填当前页面之前发送过的内容。
- 输入需求后按
Cmd/Ctrl + Enter或点击发送按钮提交（Enter换行）。 - 若当前没有选区，发送时会自动按页面全文模式投递。
- 按
Esc可关闭输入框。 - 全页模式会优先抓取最像正文的
main/article区块；若页面存在多个强相关主体区块，会合并正文并附带页面图片引用。