技能系统

技能是 Starnion AI 智能体的功能模块。每个技能都是一个独立的工具，负责特定功能，可以根据需要单独开启或关闭。

什么是技能？

技能是让 AI 能够真正执行操作（而不仅仅是对话）的功能单元。

例如：

午餐花了12,000韩元 → finance（财务）技能将其记录到消费追踪器
写今天的日记 → diary（日记）技能记录日记
收据照片 → image（图像）技能提取金额 → finance（财务）技能自动记录
本月运动目标达成！ → goals（目标）技能更新目标进度

即使用户没有明确提到技能名称，AI 也会读取上下文并自动选择合适的技能。

启用/禁用技能

您可以在设置 > 技能下单独切换每个技能。

禁用的技能即使 AI 收到相关请求也不会执行。
某些核心技能（系统技能）无法禁用。
技能设置按账户保存。

技能详情面板

设置 > 技能中每个技能卡片都有一个 ⓘ 按钮。点击后会打开侧边面板，显示：

说明 — 该技能的功能
触发关键词 — 消息中包含这些词时会自动激活该技能
使用示例 — 可直接复制发送到聊天的示例

您也可以直接从详情面板启用或禁用技能。

完整技能列表

财务

技能 ID	技能名称	说明	默认启用
`finance`	消费追踪器	自动记录收入和支出。响应”午餐12,000韩元”或”发工资了”等消息	✓

个人

技能 ID	技能名称	说明	默认启用
`diary`	日记	记录日常生活、情绪和想法。响应”我今天感觉很棒”或”会议拖堂了”等非财务消息	✓
`goals`	目标管理器	设置财务目标、待办事项、习惯和个人目标；跟踪进度	✓

媒体

技能 ID	技能名称	说明	默认启用
`image`	图像分析	分析图像，自动解析收据金额	✓

使用自然语言调用技能

您不需要明确指定技能名称。只需自然地说话，AI 就会自动选择合适的技能。

我：今天真的很糟糕，被经理骂了。
机器人：听起来很辛苦。我已将其记录到您的日记中。

我：午餐花了12,000韩元。
机器人：已记录午餐支出12,000韩元。

我：本月运动目标达成了！
机器人：太棒了！已更新您的目标进度。

我：这张图里有什么？（附加照片）
机器人：我分析了图像。看起来是一张咖啡店收据——美式咖啡4,500韩元。是否将其记录到消费追踪器中？

技能权限

某些技能需要外部 API 密钥或 OAuth 认证。

技能	所需配置
`image`	Anthropic API 密钥（图像分析）

API 密钥配置由服务器管理员在 .env 文件中处理。

即将推出的技能（第二阶段）

以下技能在开发路线图中：

技能	说明
`video`	实时流媒体分析
`slack`	Slack 频道集成

常见问题

Q：禁用技能会删除数据吗？ 不会。禁用技能不会删除现有数据。重新启用后，所有之前的数据都可以访问。

Q：什么是系统技能？ 智能体核心操作所需的技能。这些技能无法禁用。

Q：多个技能可以同时使用吗？ 可以。单条消息可以按顺序触发多个技能。例如，发送收据图片会使 image 技能识别金额，然后 finance 技能自动记录到消费追踪器。