Yinxiang CLI

中国大陆版印象笔记安全自动化 CLI 与 Claude Code Plugin

Yinxiang Biji · 印象笔记 · YXBJ · Evernote China

---

Important

本项目仅支持中国大陆版印象笔记（Yinxiang Biji / YXBJ）， 服务域名 app.yinxiang.com。 不支持国际版 Evernote（evernote.com）。

✨ 功能

• 🔑 中国大陆版印象笔记 Developer Token 认证与诊断
• 📋 笔记、笔记本与标签的只读查询（JSON/Table/NDJSON/Markdown）
• ✍️ Markdown、HTML、TXT、JSON 批量导入
• 🏷️ 标签分类计划、验证与安全更新
• 📁 笔记本分类重组（Stack + Notebook，WAL + 崩溃恢复）
• 📸 规范化 Snapshot + 全量 Verify
• ⏱️ EDAM errorCode=19 有界限流重试
• 🔄 Rollback 与 Cleanup 幂等恢复
• 📥 通用 Confluence、Jira、GitLab 数据源适配
• 🤖 Claude Code Plugin 集成

🚀 快速开始

Claude Code 用户

/plugin install kirk-haodong/yinxiang-cli
/yinxiang-cli:setup

CLI 用户

pipx install yinxiang-cli
evernote auth setup
evernote doctor

🔑 认证

1. 访问 https://app.yinxiang.com/api/DeveloperToken.action
2. 创建 Token，复制以 S= 开头的字符串
3. 设置环境变量：export EVERNOTE_TOKEN='S=...'
4. 验证：evernote auth status
5. Token 泄露后在同一页面撤销

Warning

Developer Token 等同于账号密码。不要提交 Git、写进日志或分享。

📁 项目结构

yinxiang-cli/
├── README.md
├── LICENSE
├── SECURITY.md
├── pyproject.toml
├── src/evernote_toolkit/      # Python 内部包
├── skills/evernote/            # Claude Code Skill（中文）
├── .claude-plugin/             # Claude Plugin 元数据
├── bin/                        # 辅助脚本
├── tests/                      # 测试（伪造 fixture，不含真实数据）
└── docs/                       # 公开中文文档

🛡️ 安全

• 所有批量写操作默认 dry-run，需 --confirm
• 笔记本重组前强制 Snapshot + WAL
• 配置和备份文件权限 0600
• 公开仓库不含任何真实 Token、内部域名或用户数据
• CI 包含 gitleaks、detect-secrets 和自定义隐私扫描

📄 许可证

MIT © kirk-haodong

🔍 项目别名

• Yinxiang CLI
• Yinxiang Biji
• 印象笔记 CLI
• YXBJ
• Evernote China CLI