Back to Details

craft-docs

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Craft Docs Skill

Craft Docs 技能

Overview

概述

Claude can manage your Craft documents to create beautiful documents, organize content, and collaborate with others. A native document editor with powerful block-based editing.
Claude 可以管理你的Craft文档，创建精美的文档、整理内容并与他人协作。这是一款原生文档编辑器，具备强大的基于块的编辑功能。

Quick Install

快速安装

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

Setup

设置

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

First, ensure canifi-env is installed:

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

curl -sSL https://canifi.com/install.sh | bash

curl -sSL https://canifi.com/install.sh | bash

canifi-env set CRAFT_EMAIL "your-email@example.com"
undefined
canifi-env set CRAFT_EMAIL "your-email@example.com"
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

功能特性

  • Create and edit documents
  • Organize with folders and spaces
  • Apply block styling
  • Add images and media
  • Create links between documents
  • Share and collaborate
  • Export in multiple formats
  • Use templates
  • Create tables and cards
  • Toggle blocks for organization
  • Add code blocks
  • Create backlinks
  • 创建和编辑文档
  • 使用文件夹和空间整理内容
  • 应用块样式
  • 添加图片和媒体
  • 创建文档间的链接
  • 共享与协作
  • 多种格式导出
  • 使用模板
  • 创建表格和卡片
  • 切换块以进行整理
  • 添加代码块
  • 创建反向链接

Usage Examples

使用示例

Example 1: Create Document

示例1：创建文档

User: "Create a new Craft doc for meeting notes"
Claude: Creates document "Meeting Notes" with date.
        Confirms: "Document created in default space"
用户："为会议记录创建一个新的Craft文档"
Claude：创建名为“会议记录”的文档并包含日期。
        确认："文档已在默认空间创建"

Example 2: Organize Content

示例2：整理内容

User: "Move my project docs to the Work folder"
Claude: Finds project documents, moves to Work folder.
        Confirms: "Moved 6 documents to Work folder"
用户："把我的项目文档移动到Work文件夹"
Claude：找到项目文档，移动到Work文件夹。
        确认："已将6份文档移动到Work文件夹"

Example 3: Share Document

示例3：共享文档

User: "Share the proposal document with the team"
Claude: Opens sharing settings, generates share link.
        Returns: "Share link created: [link]"
用户："把提案文档分享给团队"
Claude：打开共享设置，生成共享链接。
        返回："已创建共享链接：[链接]"

Example 4: Search Docs

示例4：搜索文档

User: "Find my docs about the marketing campaign"
Claude: Searches for "marketing campaign".
        Reports: "Found 3 documents: Campaign Strategy, Q4 Plan..."
用户："找到我关于营销活动的文档"
Claude：搜索“营销活动”相关内容。
        反馈："找到3份文档：营销活动策略、Q4计划..."

Authentication Flow

认证流程

  1. Claude navigates to craft.do via Playwright MCP
  2. Enters CRAFT_EMAIL for authentication
  3. Handles 2FA if required (notifies user via iMessage)
  4. Maintains session for document operations
  1. Claude 通过Playwright MCP导航至craft.do
  2. 输入CRAFT_EMAIL进行认证
  3. 如需2FA则处理（通过iMessage通知用户）
  4. 维持会话以进行文档操作

Selectors Reference

选择器参考

javascript
// Document list
'.documents-list'

// Document item
'.document-item'

// Editor
'.craft-editor'

// Block
'.block-container'

// Title
'.document-title'

// Folder sidebar
'.folders-sidebar'

// New document
'.new-document-button'

// Share button
'.share-button'

// Export menu
'.export-menu'

// Search
'.search-input'
javascript
// 文档列表
'.documents-list'

// 文档项
'.document-item'

// 编辑器
'.craft-editor'

// 块
'.block-container'

// 标题
'.document-title'

// 文件夹侧边栏
'.folders-sidebar'

// 新建文档
'.new-document-button'

// 分享按钮
'.share-button'

// 导出菜单
'.export-menu'

// 搜索
'.search-input'

Error Handling

错误处理

  • Login Failed: Retry 3 times, notify user via iMessage
  • Session Expired: Re-authenticate automatically
  • Document Not Found: Search with variations, ask user
  • Share Failed: Check permissions, retry
  • Export Failed: Try alternative format
  • Sync Failed: Wait and retry
  • 登录失败：重试3次，通过iMessage通知用户
  • 会话过期：自动重新认证
  • 文档未找到：使用变体关键词搜索，询问用户
  • 共享失败：检查权限并重试
  • 导出失败：尝试其他格式
  • 同步失败：等待后重试

Self-Improvement Instructions

自我优化说明

When you learn a better way to accomplish a task with Craft:
  1. Document the improvement in your response
  2. Suggest updating this skill file with the new approach
  3. Include specific document organization strategies
  4. Note useful block types
当你掌握了使用Craft完成任务的更优方法时：
  1. 在回复中记录该优化点
  2. 建议使用新方法更新此技能文件
  3. 包含具体的文档整理策略
  4. 记录实用的块类型

Notes

注意事项

  • Native Apple experience
  • Block-based editing
  • Beautiful typography
  • Markdown import/export
  • Real-time collaboration
  • Offline support
  • Backlinks for connections
  • Spaces for organization
  • Web version available
  • 原生Apple体验
  • 基于块的编辑
  • 精美的排版
  • Markdown导入/导出
  • 实时协作
  • 离线支持
  • 用于关联的反向链接
  • 用于整理的空间
  • 支持网页版本