signal-desktop

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Signal Desktop Skill

Signal Desktop 技能

Overview

概述

Automates Signal Desktop interactions for secure messaging, group management, and private communications while maintaining end-to-end encryption through desktop app automation.
通过桌面应用自动化,实现Signal Desktop交互的自动化,支持安全消息发送、群组管理和私密通信,同时保持端到端加密。

Quick Install

快速安装

bash
curl -sSL https://canifi.com/skills/signal-desktop/install.sh | bash
Or manually:
bash
cp -r skills/signal-desktop ~/.canifi/skills/
bash
curl -sSL https://canifi.com/skills/signal-desktop/install.sh | bash
或手动安装:
bash
cp -r skills/signal-desktop ~/.canifi/skills/

Setup

设置

Configure via canifi-env:
bash
undefined
通过 canifi-env 进行配置:
bash
undefined

First, ensure canifi-env is installed:

首先,确保canifi-env已安装:

canifi-env set SIGNAL_LINKED "true" canifi-env set SIGNAL_APP_PATH "/Applications/Signal.app"
undefined
canifi-env set SIGNAL_LINKED "true" canifi-env set SIGNAL_APP_PATH "/Applications/Signal.app"
undefined

Privacy & Authentication

隐私与认证

Your credentials, your choice. Canifi LifeOS respects your privacy.
你的凭据,由你掌控。 Canifi LifeOS 尊重你的隐私。

Option 1: Manual Browser Login (Recommended)

选项1:手动浏览器登录(推荐)

If you prefer not to share credentials with Claude Code:
  1. Complete the Browser Automation Setup using CDP mode
  2. Login to the service manually in the Playwright-controlled Chrome window
  3. Claude will use your authenticated session without ever seeing your password
如果你不想与Claude Code共享凭据:
  1. 使用CDP模式完成 浏览器自动化设置
  2. 在Playwright控制的Chrome窗口中手动登录该服务
  3. Claude将使用你的已认证会话,且绝不会获取你的密码

Option 2: Environment Variables

选项2:环境变量

If you're comfortable sharing credentials, you can store them locally:
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.
如果你愿意共享凭据,可以将其存储在本地:
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
注意:存储在canifi-env中的凭据仅可在你的本地机器上访问,绝不会被传输。

Capabilities

功能特性

  • Send and receive encrypted messages
  • Create and manage groups
  • Share encrypted media files
  • Search message history
  • Manage disappearing messages
  • Handle note to self
  • Manage blocked contacts
  • Configure privacy settings
  • 发送和接收加密消息
  • 创建和管理群组
  • 共享加密媒体文件
  • 搜索消息历史
  • 管理阅后即焚消息
  • 处理自我备注
  • 管理已屏蔽联系人
  • 配置隐私设置

Usage Examples

使用示例

Example 1: Send an Encrypted Message

示例1:发送加密消息

User: "Send a Signal message to James about the confidential project"
Claude: I'll send that secure message via Signal.
- Launch Signal Desktop application
- Search for James in contacts
- Open conversation
- Type and send message
- Confirm delivery (checkmarks)
用户:“给James发送一条关于保密项目的Signal消息”
Claude:我将通过Signal发送这条安全消息。
- 启动Signal Desktop应用
- 在联系人中搜索James
- 打开对话窗口
- 输入并发送消息
- 确认送达(查看对勾标记)

Example 2: Create a Secure Group

示例2:创建安全群组

User: "Create a Signal group called 'Secure Team' with Ana and Carlos"
Claude: I'll create that encrypted group.
- Open Signal Desktop
- Start new group
- Add Ana and Carlos
- Name group "Secure Team"
- Confirm group created with encryption
用户:“创建一个名为‘安全团队’的Signal群组,添加Ana和Carlos”
Claude:我将创建这个加密群组。
- 打开Signal Desktop
- 开始创建新群组
- 添加Ana和Carlos
- 将群组命名为“安全团队”
- 确认群组已加密创建

Example 3: Enable Disappearing Messages

示例3:启用阅后即焚消息

User: "Set disappearing messages to 1 week for my chat with Alex"
Claude: I'll configure disappearing messages.
- Open chat with Alex
- Access conversation settings
- Enable disappearing messages
- Set timer to 1 week
- Confirm setting applied
用户:“将我与Alex的聊天设置为1周后自动消失”
Claude:我将配置阅后即焚消息设置。
- 打开与Alex的聊天窗口
- 进入会话设置
- 启用阅后即焚消息
- 将计时器设置为1周
- 确认设置已应用

Example 4: Search Secure Messages

示例4:搜索安全消息

User: "Find all Signal messages mentioning 'contract'"
Claude: I'll search your Signal messages.
- Open Signal search
- Search for "contract"
- Collect matching messages
- Present results with context (maintaining privacy)
用户:“查找所有提到‘合同’的Signal消息”
Claude:我将搜索你的Signal消息。
- 打开Signal搜索功能
- 搜索“合同”关键词
- 收集匹配的消息
- 在保护隐私的前提下呈现带上下文的结果

Authentication Flow

认证流程

  1. Launch Signal Desktop via system command
  2. If not linked, show QR code for phone scanning
  3. Notify user via iMessage to scan QR with Signal mobile
  4. Wait for device linking confirmation
  5. Verify contact list access
  6. Maintain linked status for future sessions
  1. 通过系统命令启动Signal Desktop
  2. 若未关联,显示二维码供手机扫描
  3. 通过iMessage通知用户使用Signal移动端扫描二维码
  4. 等待设备关联确认
  5. 验证联系人列表访问权限
  6. 保持关联状态以便后续会话使用

Error Handling

错误处理

  • App Not Found: Verify Signal Desktop installation path
  • Not Linked: Prompt user to link via QR code scanning
  • Session Expired: Re-link device through phone app
  • Contact Not Found: Search by phone number format variations
  • Group Creation Failed: Check contact permissions
  • Media Failed: Verify file format and size limits
  • Connection Lost: Wait for Signal servers reconnection
  • Rate Limited: Implement backoff for message sending
  • 应用未找到:验证Signal Desktop的安装路径
  • 未关联:提示用户通过扫描二维码进行关联
  • 会话过期:通过手机应用重新关联设备
  • 联系人未找到:尝试不同格式的电话号码进行搜索
  • 群组创建失败:检查联系人权限
  • 媒体文件发送失败:验证文件格式和大小限制
  • 连接丢失:等待Signal服务器重新连接
  • 请求受限:实现消息发送退避机制

Self-Improvement Instructions

自我改进说明

When encountering new Signal features:
  1. Document desktop app UI changes
  2. Add support for new message features
  3. Log group management patterns
  4. Update for new privacy features
当遇到Signal新功能时:
  1. 记录桌面应用的UI变化
  2. 添加对新消息功能的支持
  3. 记录群组管理模式
  4. 针对新隐私功能进行更新

Notes

注意事项

  • Signal Desktop requires linking to mobile app
  • All messages remain end-to-end encrypted
  • Desktop app must remain open for real-time messaging
  • Some features require both parties to update
  • Group video calls not automatable
  • Safety numbers should be verified manually
  • Registration lock may require PIN
  • Signal Desktop需要与移动端应用关联
  • 所有消息始终保持端到端加密
  • 桌面应用必须保持开启才能进行实时消息通信
  • 部分功能需要双方都进行更新
  • 群组视频通话无法自动化
  • 安全号码需手动验证
  • 注册锁定可能需要PIN码