tana

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Tana Skill

Tana Skill

Overview

概述

Claude can manage your Tana workspace to capture thoughts, build structured data with supertags, and create a powerful knowledge base. A tool for structured note-taking and data management.
Claude可以管理你的Tana工作区,捕捉想法,使用supertag构建结构化数据,并创建强大的知识库。这是一个用于结构化笔记和数据管理的工具。

Quick Install

快速安装

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

Setup

设置

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

First, ensure canifi-env is installed:

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

canifi-env set TANA_EMAIL "your-email@example.com"
undefined
canifi-env set TANA_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 nodes and outlines
  • Use supertags for structure
  • Define fields on supertags
  • Build live searches
  • Create views and queries
  • Use commands and AI
  • Build templates
  • Create bidirectional links
  • Add date references
  • Use inline references
  • Build dashboards
  • Share workspaces
  • 创建节点和大纲
  • 使用supertag构建结构
  • 在supertag上定义字段
  • 构建实时搜索
  • 创建视图和查询
  • 使用命令和AI
  • 构建模板
  • 创建双向链接
  • 添加日期引用
  • 使用内联引用
  • 构建仪表板
  • 共享工作区

Usage Examples

使用示例

Example 1: Add Node

示例1:添加节点

User: "Add a #task for reviewing the proposal"
Claude: Creates node with #task supertag.
        Confirms: "Task created: Review the proposal"
用户:"添加一个#task用于审核提案"
Claude:创建带有#task supertag的节点。
        确认:"任务已创建:审核提案"

Example 2: Create Supertag

示例2:创建Supertag

User: "Create a #project supertag with status and deadline fields"
Claude: Creates supertag with defined fields.
        Confirms: "Created #project supertag with 2 fields"
用户:"创建一个带有状态和截止日期字段的#project supertag"
Claude:创建带有定义字段的supertag。
        确认:"已创建#project supertag,包含2个字段"

Example 3: Live Search

示例3:实时搜索

User: "Show all tasks due this week"
Claude: Creates live search with date filter.
        Reports: "Found 8 tasks due this week"
用户:"显示所有本周到期的任务"
Claude:创建带有日期筛选的实时搜索。
        反馈:"找到8个本周到期的任务"

Example 4: Daily Notes

示例4:每日笔记

User: "Add to today's daily note: Met with the design team"
Claude: Opens today's date node, adds content.
        Confirms: "Added to today's daily note"
用户:"在今日的每日笔记中添加:与设计团队会面"
Claude:打开今日的日期节点,添加内容。
        确认:"已添加至今日的每日笔记"

Authentication Flow

认证流程

  1. Claude navigates to tana.inc via Playwright MCP
  2. Enters TANA_EMAIL for authentication
  3. Handles 2FA if required (notifies user via iMessage)
  4. Maintains session for operations
  1. Claude通过Playwright MCP导航至tana.inc
  2. 输入TANA_EMAIL进行认证
  3. 如需2FA则处理(通过iMessage通知用户)
  4. 维护会话以执行操作

Selectors Reference

选择器参考

javascript
// Main content
'.tana-editor'

// Node
'.node-container'

// Node content
'.node-content'

// Supertag
'.supertag'

// Field
'.field-container'

// Search
'.search-input'

// Daily notes
'.daily-notes'

// Live search
'.live-search'

// Command line
'.command-palette'

// References
'.references-panel'
javascript
// 主内容
'.tana-editor'

// 节点
'.node-container'

// 节点内容
'.node-content'

// Supertag
'.supertag'

// 字段
'.field-container'

// 搜索
'.search-input'

// 每日笔记
'.daily-notes'

// 实时搜索
'.live-search'

// 命令行
'.command-palette'

// 引用
'.references-panel'

Tana Syntax

Tana语法

#supertag           // Apply supertag
^date               // Date reference
>inline reference   // Inline node
[[link]]            // Page link
@mention            // Mention
/command            // Run command
#supertag           // 应用supertag
^date               // 日期引用
>inline reference   // 内联节点
[[link]]            // 页面链接
@mention            // 提及
/command            // 运行命令

Error Handling

错误处理

  • Login Failed: Retry 3 times, notify user via iMessage
  • Session Expired: Re-authenticate automatically
  • Node Not Found: Search with variations, ask user
  • Supertag Error: Check definition, suggest fix
  • Search Failed: Verify query syntax
  • Sync Failed: Wait and retry
  • 登录失败:重试3次,通过iMessage通知用户
  • 会话过期:自动重新认证
  • 节点未找到:使用变体搜索,询问用户
  • Supertag错误:检查定义,建议修复方案
  • 搜索失败:验证查询语法
  • 同步失败:等待并重试

Self-Improvement Instructions

自我改进说明

When you learn a better way to accomplish a task with Tana:
  1. Document the improvement in your response
  2. Suggest updating this skill file with the new approach
  3. Include specific supertag configurations
  4. Note useful live search patterns
当你学会了使用Tana完成任务的更好方法时:
  1. 在你的响应中记录改进内容
  2. 建议使用新方法更新此技能文件
  3. 包含具体的supertag配置
  4. 记录有用的实时搜索模式

Notes

注意事项

  • Supertags define structured data
  • Fields for consistent data capture
  • Live searches for dynamic views
  • AI commands built-in
  • Daily notes for journals
  • Commands for automation
  • Templates for patterns
  • Currently invite-only access
  • Supertag定义结构化数据
  • 字段用于一致的数据捕捉
  • 实时搜索用于动态视图
  • 内置AI命令
  • 每日笔记用于日志记录
  • 命令用于自动化
  • 模板用于模式复用
  • 当前仅支持邀请制访问