TalkCode 是什么
TalkCode 是一个「AI 生成应用 + 源码部署」平台。每个账号拥有一只专属 Agent(Cellium 内核),可以用它聊天、生成项目、部署上线,也能在 QQ、微信、飞书等通道里随时找到它。
产品特性
| 能力 | 说明 |
|---|---|
| AI 生成应用 | 用自然语言描述需求,Agent 直接产出可运行的项目代码 |
| 一键部署 | 生成的项目可部署为独立站点,支持绑定域名 |
| 专属 Agent | 每个账号一个独立实例,配置、记忆、人设互不干扰 |
| 多通道 | 网页对话、QQ、微信、企业微信、飞书、Telegram |
| 自学习 | 技能沉淀、用户画像自动复盘、跨会话检索 |
快速开始
1. 注册并进入控制台
登录后进入 /dashboard,左侧栏是主要功能入口。
2. 配置模型
平台自带默认模型,可直接对话;也可以在「模型配置」里添加自己的模型(见 配置模型)。
3. 开始对话
进入「Agent 对话」,输入需求即可。对话支持文件附件、流式输出、工具卡片与审批弹窗。
4. 生成第一个应用
在「项目」里新建项目,描述你要做的应用,Agent 会生成文件并给出预览/部署入口(见 创建项目)。
核心概念
| 概念 | 说明 |
|---|---|
| Agent 实例 | 每个账号一个独立进程,目录、配置、记忆、技能完全独立;实例空闲会被回收,下次访问自动拉起 |
| 项目 | 一个可生成、编辑、部署的应用工程,包含文件与构建产物 |
| 会话 | Agent 对话的一次完整上下文,超过窗口会自动压缩 |
| 记忆 / 画像 | 以 Markdown 保存(USER.md / MEMORY.md / personality.md),会话开始时注入 |
| AI 调用额度 | 每日次数,项目生成与对话共享;自有模型只计数不扣额度 |
账号与登录
支持邮箱注册与登录。登录态保存在浏览器本地,退出后清除。
AI 调用额度
额度是统一出口:项目生成、Agent 对话、代码修改都计入同一天额度。
- 新账号初始额度:100 次 / 天
- 通过「兑换中心 → 算力兑换」可永久提升每日上限
- 使用你自己的模型时:仍记录调用次数(可在 AI 调用记录里看到),但不扣额度
左侧栏左下角点头像,可以快速查看「今日 AI 调用 N / 上限」。
兑换中心
分为两页:
算力兑换
消耗算力余额提升每日 AI 调用上限,例如「每日 AI 调用 +10 / +50 / +200」。兑换后立即生效。
兑换码兑换
输入兑换码即可兑换算力或额度,兑换记录在下方表格中可查。
创建项目
在「项目」页新建项目并描述需求,Agent 会规划文件结构、逐个生成文件。
- 生成过程中可随时中断或追加修改要求
- 项目文件支持在线查看与编辑
- 每次生成/修改都会计入 AI 调用额度
部署与访问
项目完成后可以两种方式上线:在项目详情页点「部署」,或者直接让 Agent 部署——它生成完代码会调用内置的 deploy 组件,平台负责写目录、装依赖、起进程、分配端口与域名。
deploy.list_projects() 可列出可部署项目,deploy.deploy(project_name="...") 触发部署,返回 port / domain / url。它不会自己 sudo、改 nginx 或申请证书。部署状态与日志在项目详情页可查。部署目标(云服务器或本机)由平台配置决定,Agent 与用户都不需要选择:平台当前走云部署,会把项目发布到独立的部署服务器上。
网页对话
控制台的「Agent 对话」是主要入口:
- 流式输出:回复逐段出现,结束前可随时打断
- 文件附件:回形针按钮选择文件,发送后 Agent 会读取文件内容
- 工具卡片:一次回复里调用了哪些工具,可在折叠卡片中查看
- 审批弹窗:执行危险命令前会请求确认,可「允许一次 / 本会话允许 / 拒绝」
- 压缩提示:长对话触发上下文压缩时右上角会提示
配置模型
「模型配置」页管理你的模型:
| 操作 | 说明 |
|---|---|
| 添加模型 | 填写 Base URL、API Key、模型名,可添加多个 |
| 设为主模型 | 对话与生成默认使用该模型 |
| 设备用 | 主模型失败时自动降级使用 |
| 检测状态 | 测试连通性与可用性 |
| 共享 | 共享给社区(需审核),他人调用会计入你的共享次数 |
| 删除 | 卡片右上角垃圾桶,删除后不影响已产生的记录 |
人设 / 记忆 / 用户画像
三者都以 Markdown 保存,并在会话开始时注入:
| 文件 | 内容 | 写入方式 |
|---|---|---|
personality.md | 核心人设(名字、身份、说话风格) | 「人设」页手动编辑 |
USER.md | 用户画像(偏好、沟通风格) | 每 10 轮自动复盘 / 对话中主动记忆 |
MEMORY.md | 环境记忆(工具特性、项目约定) | 同上 |
两个文件都有字符上限(USER.md 1375、MEMORY.md 2200),超限会要求 Agent 合并精简,不会无限膨胀。
技能
技能是可复用的操作流程(SKILL.md),Agent 会按名称与一句话描述发现它们。
- 技能市场:搜索并安装他人分享的技能包
- 已安装:查看已装技能与使用次数
- 自进化:完成可复用流程后,Agent 可自行沉淀技能;长期不用的技能会被归档(不会删除)
定时任务
让 Agent 按固定时间自动执行任务(如每天汇总、定时部署)。
- 支持间隔任务与每日定时
- 可限制任务可用的工具(工具白名单),降低风险
- 任务失败会记录状态,可在任务详情里查看
历史对话与检索
所有对话按日期归档(memory/archive)。
- 「历史对话」页可查看、删除单条或清空全部
- Agent 可通过内置检索在历史对话中查找「上次怎么解决的」
通道 · QQ
绑定方式
在「对话通道」页填写 QQ 开放平台的 AppID / AppSecret,保存后实例会自动重启并连接。
| 状态 | 含义 |
|---|---|
| 未绑定 | 尚未填写凭证 |
| 已绑定未连接 | 凭证已保存,WebSocket 未连上(检查凭证、网络、是否被其他实例占用) |
| 已绑定 / 已连接 | 正常在线 |
群聊
群里 @ 机器人即可。群聊默认不显示「思考链 / 执行计划」,可在高级设置开启。
通道 · 微信 / 企业微信
微信通道通过扫码登录,二维码有效期有限,过期可在页面刷新重新获取。企业微信使用企微后台的凭证配置。
通道 · 飞书 / Telegram
飞书在开放平台创建应用后填入 AppID / AppSecret;Telegram 填写 BotFather 给的 Token。保存后自动连接。
高级设置
只影响你自己的实例,保存即时生效:
| 开关 | 作用 |
|---|---|
| 工具审批 | 危险命令执行前是否需要确认 |
| 审批模式 | policy(只拦危险)/ strict(全部确认)/ yolo(全部放行) |
| 对话修改人设 | 是否允许 Agent 在对话中改人设 |
| 对话写入记忆 | 是否允许 Agent 主动写 USER.md / MEMORY.md |
| 后台画像复盘 | 每 N 轮自动提炼画像与环境记忆(消耗一次模型调用) |
| 对话创建定时任务 | 是否允许 Agent 自己建任务 |
| 思考链 / 计划进度 | 对话中是否显示 💭 Thinking 与执行计划 |
| 工具链 | 是否显示「正在调用 xxx」工具卡片 |
| 技能自进化 | 是否允许 Agent 创建/追加技能 |
安全与审批
Agent 能执行 shell 命令,因此默认开启审批:
- 危险命令(
rm -rf /、mkfs、curl | sh等)直接拒绝 - 敏感命令(
sudo、chmod 777、写系统目录等)请求确认 - 审批记录写入
logs/approvals.jsonl,可按会话追溯 - 连续拒绝 3 次后会话进入只读模式
常见问题
对话一直转圈或提示实例启动失败?
实例空闲会被回收,首次访问需要 5–15 秒拉起。若持续失败,刷新重试或联系管理员。
AI 调用提示额度用完?
到「兑换中心 → 算力兑换」提升额度,或明天再试;使用自己的模型不扣额度。
QQ 显示已绑定但收不到消息?
检查是否被其他账号的实例占用同一 Bot;群聊需 @ 机器人;也可在通道页重新保存凭证触发重连。
记忆太多,会出现「无限累加」吗?
不会。记忆已改为两个固定上限的 Markdown 文件,超限强制合并;且默认不再把每轮问答写进记忆。
已知限制
- 同一 QQ Bot 仅支持一个实例在线
- 网页端流式输出在极端情况下可能短暂显示结构化片段,最终会以清洗后的内容覆盖
- 定时任务失败目前只记录状态,不会主动通知(后续会补)
- 实例共享同一份 Agent 代码,升级会同时影响所有账号
TalkCode 文档