## 使用流程

1. 选中笔记中的文字（或在光标位置）
2. 按快捷键触发
3. AI编辑区域出现，实时预览diff
4. 确认后替换原文

- 传统的机器学习需要大量标注数据
+ 传统的机器学习需要大量标注数据，
+ 而迁移学习可以复用预训练模型的知识，
+ 大幅减少目标任务所需的标注样本数量。

## 触发方式

/  → 内置Skills（如/write、/edit、/debug）
$  → 用户自定义Skills

## 内置Skills

| Skill | 用途 |
|-------|------|
| /write | 写作助手 |
| /edit | 编辑修改 |
| /debug | 代码调试 |
| /explain | 解释代码 |
| /summarize | 总结内容 |

## 自定义Skills

用户可以在 vault 级别或笔记级别定义自己的Skills。

## @提及类型

@文件 → 让AI读取并处理指定文件
  示例: @project/proposal.md

@子Agent → 委托给专门的AI处理
  示例: @researcher 分析这个主题

@MCP服务器 → 调用外部工具
  示例: @filesystem 搜索包含关键词的文件

@外部目录 → 处理非笔记库的文件
  示例: @~/projects/code 分析代码库

## Plan Mode 工作流

1. 用户: "帮我重构这个项目"
2. AI (Plan Mode): 
   - 探索代码库结构
   - 分析依赖关系
   - 制定重构计划
   - 展示计划待批准
3. 用户审查计划
4. 用户: "批准"
5. AI (执行 Mode): 
   - 按计划执行重构
   - 逐步确认

## 使用方式

# 你想要的具体要求
# 示例：
# 用TypeScript重写
# 添加完整的类型注解
# 保持原有的函数签名

// Claude的MCP在app内管理
// Codex使用CLI管理的MCP配置

// settings中配置示例
{
  "mcp": {
    "servers": [
      {
        "name": "filesystem",
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-filesystem"],
        "cwd": "/path/to/vault"
      },
      {
        "name": "github",
        "command": "npx", 
        "args": ["-y", "@modelcontextprotocol/server-github"]
      }
    ]
  }
}

## 多会话功能

- 新建Tab: 创建独立的AI对话
- 切换Tab: 快速在不同任务间切换
- 合并Tab: 将多个对话合并

## 对话操作

| 操作 | 快捷键/方式 |
|------|-------------|
| 新建 | 工具栏+按钮 |
| 分叉 | 从当前对话创建分支 |
| 恢复 | 重新加载历史会话 |
| 压缩 | 精简上下文 |

## 存储位置

vault/.claudian/         # Claudian设置和会话元数据
vault/.claude/           # Claude提供商的会话文件
~/.claude/projects/       # Claude转录历史 (macOS/Linux)
~/.codex/sessions/       # Codex转录历史

## 数据保护

- 本地存储，不上传云端
- 加密敏感信息
- 可配置保留策略

# 1. 下载最新release
# 下载 main.js, manifest.json, styles.css

# 2. 创建插件目录
mkdir -p /path/to/vault/.obsidian/plugins/claudian

# 3. 复制文件到目录

# 4. 启用插件
# Settings → Community plugins → Enable "Claudian"

# 1. 安装BRAT插件
Settings → Community plugins → BRAT

# 2. 添加Claudian
Settings → BRAT → Add Beta plugin
URL: https://github.com/YishenTu/claudian

# 3. 自动更新
# BRAT会自动检查更新

# 克隆到插件目录
cd /path/to/vault/.obsidian/plugins
git clone https://github.com/YishenTu/claudian.git
cd claudian

# 安装依赖并构建
npm install
npm run build

# 启用插件
Settings → Community plugins → Enable "Claudian"

# 找到Claude CLI路径
# macOS/Linux
which claude
# 示例: /Users/you/.volta/bin/claude

# Windows
where.exe claude
# 示例: C:\Users\you\AppData\Local\Claude\claude.exe

# 如果遇到"CLI not found"
# 设置 → Advanced → Claude CLI path

src/
├── main.ts                 // 插件入口点
├── app/                   // 共享默认值和插件级存储
├── core/                  // Provider-neutral运行时
│   ├── runtime/           // ChatRuntime接口和审批类型
│   ├── providers/        // Provider注册和工作区服务
│   ├── security/          // 审批工具
│   └── ...                // commands, mcp, prompt, storage, tools, types
├── providers/
│   ├── claude/            // Claude SDK适配器
│   │   ├── runtime/       // ChatRuntime实现
│   │   ├── prompt/       // 提示词编码
│   │   ├── storage/      // 会话存储
│   │   └── mcp/         // MCP插件
│   └── codex/            // Codex应用服务器适配器
│       ├── runtime/      // JSON-RPC传输
│       └── history/      // JSONL历史
├── features/
│   ├── chat/            // 侧边栏聊天
│   │   ├── tabs/        // 多Tab管理
│   │   ├── controllers/ // 控制器
│   │   └── renderers/   // 渲染器
│   ├── inline-edit/      // 内联编辑
│   │   ├── modal/       // 编辑弹窗
│   │   └── diff/        // Diff预览
│   └── settings/        // 设置面板
├── shared/                // 可复用UI组件
├── i18n/                 // 国际化 (10种语言)
└── utils/                // 横切工具

## 数据流向

发送至API:
- 你的输入内容
- 附加的文件
- 图片
- 工具调用输出
- 默认: Anthropic (Claude) 或 OpenAI (Codex)
- 可配置

本地存储:
- Claudian设置 → vault/.claudian/
- Claude会话 → vault/.claude/
- 转录历史 → ~/.claude/projects/ (Claude)
- 转录历史 → ~/.codex/sessions/ (Codex)

无遥测:
- 不追踪任何分析数据

## 安全最佳实践

1. 敏感笔记 → 使用Obsidian加密
2. API密钥 → 存储在环境变量
3. 外部命令 → Plan Mode审批后再执行
4. 文件操作 → 定期备份笔记库

## macOS/Linux
which claude
# → /Users/you/.volta/bin/claude

## Windows (native)
where.exe claude
# → C:\Users\you\AppData\Local\Claude\claude.exe

## Windows (npm)
npm root -g
# → {root}\@anthropic-ai\claude-code\cli.js