samectx 1.0.0

package/.env.example

@@ -0,0 +1,15 @@
+# GitHub Token Configuration
+# Generate a token at: https://github.com/settings/tokens
+# Required scope: gist
+
+GITHUB_TOKEN=your_github_token_here
+
+# Local Notes Directory (Optional)
+# Specify a custom directory for storing notes locally
+# Can be absolute path or relative path (relative to skill directory)
+# Examples:
+# LOCAL_NOTES_DIR=/Users/ethanhuang/Documents/Notes
+# LOCAL_NOTES_DIR=./notes
+# LOCAL_NOTES_DIR=../../data/notes
+
+# LOCAL_NOTES_DIR=./notes

package/README.md

@@ -0,0 +1,116 @@
+# samectx
+
+Context sync tool - 整理对话上下文并同步到 GitHub Gist
+
+用于多台设备使用 TRAE、Cursor、Claude Code 等 AI 工具时，整理对话上下文并同步到工程本地文件夹和 GitHub Gist 中。
+
+## 安装
+
+```bash
+# 全局安装
+npm install -g samectx
+
+# 或使用 npx（无需安装）
+npx samectx --help
+```
+
+## 快速开始
+
+```bash
+# 1. 配置 GitHub Token
+samectx config --token ghp_your_token_here
+
+# 2. 同步上下文
+samectx sync
+
+# 3. 查看笔记列表
+samectx list
+```
+
+## 命令
+
+### `sync` (别名: `s`) - 同步上下文
+
+```bash
+samectx sync [options]
+# 或简写
+samectx s
+
+选项:
+  -p, --project <name>  指定项目名称（默认从当前目录提取）
+  -d, --dir <path>      指定笔记存储目录
+```
+
+### `list` (别名: `l`) - 列出笔记
+
+```bash
+samectx list [options]
+# 或简写
+samectx l
+
+选项:
+  -p, --project <name>  筛选指定项目的笔记
+  -l, --local           只显示本地笔记
+```
+
+### `config` (别名: `c`) - 配置
+
+```bash
+samectx config [options]
+# 或简写
+samectx c
+
+选项:
+  -t, --token <token>   设置 GitHub Token
+  -s, --show            显示当前配置
+```
+
+### `init` (别名: `i`) - 初始化项目
+
+```bash
+samectx init
+# 或简写
+samectx i
+```
+
+## 获取 GitHub Token
+
+1. 访问 https://github.com/settings/tokens/new
+2. Note: `samectx`
+3. Expiration: 选择 `Custom` → 设置 1 年后
+4. Select scopes: ✅ `gist`
+5. 点击 Generate token，复制保存
+
+## 目录结构
+
+```
+~/.samectx/                    # 全局配置目录
+├── config.json                # 配置文件（Token）
+└── gist-mapping.json          # 项目-Gist 映射
+
+your-project/
+└── samectx-notes/             # 本地笔记
+    ├── context_2026-03-20.json
+    └── ...
+```
+
+## 跨工具支持
+
+| 工具 | 使用方式 |
+|------|---------|
+| TRAE CN | `npx samectx sync` |
+| Cursor | `npx samectx sync` |
+| Claude Code | `npx samectx sync` |
+| 终端 | `samectx sync` |
+
+## 故障排除
+
+| 问题 | 解决方案 |
+|------|---------|
+| Token 未配置 | 运行 `samectx config --token <your-token>` |
+| 笔记位置错误 | 检查项目根目录下的 `samectx-notes/` |
+| Gist 上传失败 | 检查 Token 权限和有效期；本地笔记仍可用 |
+
+---
+
+**GitHub**: https://github.com/ethanhuangcst/gctx

package/bin/samectx

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const pkg = require('../package.json');
+const cli = require('../src/cli');
+
+program
+  .name('samectx')
+  .description('Context sync tool - 整理对话上下文并同步到 GitHub Gist')
+  .version(pkg.version);
+
+program
+  .command('sync')
+  .alias('s')
+  .description('同步当前项目的对话上下文到本地和 GitHub Gist')
+  .option('-p, --project <name>', '指定项目名称（默认从当前目录提取）')
+  .option('-d, --dir <path>', '指定笔记存储目录')
+  .action(async (options) => {
+    await cli.sync(options);
+  });
+
+program
+  .command('list')
+  .alias('l')
+  .description('列出所有笔记')
+  .option('-p, --project <name>', '筛选指定项目的笔记')
+  .option('-l, --local', '只显示本地笔记')
+  .action(async (options) => {
+    await cli.list(options);
+  });
+
+program
+  .command('config')
+  .alias('c')
+  .description('配置 GitHub Token')
+  .option('-t, --token <token>', '设置 GitHub Token')
+  .option('-s, --show', '显示当前配置')
+  .action(async (options) => {
+    await cli.config(options);
+  });
+
+program
+  .command('init')
+  .alias('i')
+  .description('初始化项目配置')
+  .action(async () => {
+    await cli.init();
+  });
+
+program.parse();

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "samectx",
+  "version": "1.0.0",
+  "description": "Context sync tool - 整理对话上下文并同步到 GitHub Gist",
+  "main": "src/index.js",
+  "bin": {
+    "samectx": "./bin/samectx"
+  },
+  "files": [
+    "bin",
+    "src",
+    ".env.example"
+  ],
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "context",
+    "gist",
+    "sync",
+    "cli",
+    "trae"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.0.0",
+    "node-fetch": "^2.7.0"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}

package/src/cli.js

@@ -0,0 +1,114 @@
+/**
+ * CLI 命令实现
+ */
+
+const chalk = require('chalk');
+const fs = require('fs');
+const path = require('path');
+const core = require('./index');
+
+async function sync(options) {
+  console.log(chalk.blue('📦 正在同步上下文...'));
+  
+  const result = await core.sync(options);
+  
+  if (result.success) {
+    console.log(chalk.green('✅ 同步成功！'));
+    console.log(`   项目名称: ${result.projectName}`);
+    console.log(`   本地路径: ${result.localPath}`);
+    
+    if (result.gistUrl) {
+      console.log(`   Gist URL: ${result.gistUrl}`);
+    } else if (result.gistError) {
+      console.log(chalk.yellow(`   ⚠️ Gist 同步失败: ${result.gistError}`));
+    }
+    
+    if (result.analysis) {
+      console.log(`   分析: ${result.analysis.taskCount} 个任务, ${result.analysis.keyPointCount} 个关键点, ${result.analysis.decisionCount} 个决策`);
+    }
+  } else {
+    console.log(chalk.red(`❌ 同步失败: ${result.error}`));
+    process.exit(1);
+  }
+}
+
+async function list(options) {
+  console.log(chalk.blue('📋 笔记列表:\n'));
+  
+  const notes = core.listNotes(options);
+  
+  if (notes.length === 0) {
+    console.log(chalk.yellow('   没有找到笔记'));
+    return;
+  }
+  
+  notes.forEach((note, index) => {
+    console.log(`${index + 1}. ${chalk.cyan(note.fileName)}`);
+    console.log(`   项目: ${note.projectName}`);
+    console.log(`   时间: ${note.timestamp || '未知'}`);
+    if (note.summary) {
+      console.log(`   摘要: ${note.summary}`);
+    }
+    console.log('');
+  });
+  
+  console.log(chalk.gray(`共 ${notes.length} 条笔记`));
+}
+
+async function config(options) {
+  if (options.show) {
+    const currentConfig = core.loadConfig();
+    console.log(chalk.blue('📋 当前配置:\n'));
+    console.log(`   配置目录: ${core.CONFIG_DIR}`);
+    console.log(`   GitHub Token: ${currentConfig.githubToken ? '已配置' : chalk.red('未配置')}`);
+    return;
+  }
+  
+  if (options.token) {
+    const currentConfig = core.loadConfig();
+    currentConfig.githubToken = options.token;
+    core.saveConfig(currentConfig);
+    console.log(chalk.green('✅ GitHub Token 已保存'));
+    console.log(`   配置文件: ${core.CONFIG_FILE}`);
+    return;
+  }
+  
+  console.log(chalk.yellow('请指定配置选项:'));
+  console.log('   --token <token>  设置 GitHub Token');
+  console.log('   --show           显示当前配置');
+}
+
+async function init() {
+  console.log(chalk.blue('🚀 初始化项目配置...\n'));
+  
+  const notesDir = core.getProjectNotesDir();
+  console.log(`   笔记目录: ${notesDir}`);
+  
+  if (!fs.existsSync(notesDir)) {
+    fs.mkdirSync(notesDir, { recursive: true });
+    console.log(chalk.green('   ✅ 已创建笔记目录'));
+  } else {
+    console.log(chalk.gray('   笔记目录已存在'));
+  }
+  
+  const envExample = path.join(process.cwd(), '.env.example');
+  if (!fs.existsSync(envExample)) {
+    fs.writeFileSync(envExample, `# GitHub Token Configuration
+GITHUB_TOKEN=your_github_token_here
+`);
+    console.log(chalk.green('   ✅ 已创建 .env.example'));
+  }
+  
+  console.log(chalk.green('\n✅ 初始化完成！'));
+  console.log(chalk.yellow('\n下一步:'));
+  console.log('   1. 获取 GitHub Token: https://github.com/settings/tokens/new');
+  console.log('   2. 配置 Token: samectx config --token <your-token>');
+  console.log('   3. 同步上下文: samectx sync');
+}
+
+module.exports = {
+  sync,
+  list,
+  config,
+  init
+};

package/src/index.js

@@ -0,0 +1,406 @@
+/**
+ * gctx - Context sync tool
+ * 整理对话上下文并同步到 GitHub Gist
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const CONFIG_DIR = path.join(os.homedir(), '.samectx');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const GIST_MAPPING_FILE = path.join(CONFIG_DIR, 'gist-mapping.json');
+
+function ensureConfigDir() {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+}
+
+function loadConfig() {
+  ensureConfigDir();
+  if (fs.existsSync(CONFIG_FILE)) {
+    try {
+      return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
+    } catch (e) {
+      return {};
+    }
+  }
+  return {};
+}
+
+function saveConfig(config) {
+  ensureConfigDir();
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+
+function getGistMapping() {
+  ensureConfigDir();
+  if (fs.existsSync(GIST_MAPPING_FILE)) {
+    try {
+      return JSON.parse(fs.readFileSync(GIST_MAPPING_FILE, 'utf8'));
+    } catch (e) {
+      return {};
+    }
+  }
+  return {};
+}
+
+function saveGistMapping(mapping) {
+  ensureConfigDir();
+  fs.writeFileSync(GIST_MAPPING_FILE, JSON.stringify(mapping, null, 2));
+}
+
+function extractProjectName(customName) {
+  if (customName) {
+    return customName.replace(/[^a-zA-Z0-9_-]/g, '_');
+  }
+  const cwd = process.cwd();
+  let projectName = path.basename(cwd);
+  return projectName.replace(/[^a-zA-Z0-9_-]/g, '_');
+}
+
+function getProjectNotesDir(customDir) {
+  if (customDir) {
+    if (path.isAbsolute(customDir)) {
+      return customDir;
+    }
+    return path.join(process.cwd(), customDir);
+  }
+  
+  if (process.env.LOCAL_NOTES_DIR) {
+    const notesDir = process.env.LOCAL_NOTES_DIR;
+    if (path.isAbsolute(notesDir)) {
+      return notesDir;
+    }
+    return path.join(process.cwd(), notesDir);
+  }
+  
+  return path.join(process.cwd(), 'samectx-notes');
+}
+
+function analyzeContext(conversationHistory) {
+  const keyPoints = [];
+  const tasks = [];
+  const decisions = [];
+  
+  try {
+    const jsonData = JSON.parse(conversationHistory);
+    
+    if (jsonData.completedTasks) {
+      jsonData.completedTasks.forEach(task => {
+        if (typeof task === 'string') tasks.push(task);
+      });
+    }
+    
+    if (jsonData.pendingTasks || jsonData.tasks) {
+      const pendingTasks = jsonData.pendingTasks || jsonData.tasks;
+      pendingTasks.forEach(task => {
+        if (typeof task === 'string') tasks.push(task);
+      });
+    }
+    
+    if (jsonData.keyDecisions || jsonData.decisions) {
+      const decs = jsonData.keyDecisions || jsonData.decisions;
+      decs.forEach(dec => {
+        if (typeof dec === 'string') decisions.push(dec);
+      });
+    }
+    
+    if (jsonData.importantNotes || jsonData.keyPoints) {
+      const notes = jsonData.importantNotes || jsonData.keyPoints;
+      notes.forEach(note => {
+        if (typeof note === 'string') keyPoints.push(note);
+      });
+    }
+    
+    if (tasks.length > 0 || decisions.length > 0 || keyPoints.length > 0) {
+      const summary = `对话包含 ${tasks.length} 个任务、${keyPoints.length} 个关键点和 ${decisions.length} 个决策`;
+      
+      return {
+        summary,
+        keyPoints,
+        tasks,
+        decisions,
+        rawContent: conversationHistory,
+        timestamp: new Date().toISOString(),
+        conversationLength: JSON.stringify(jsonData).split('\n').length,
+        metadata: {
+          version: '1.0.0',
+          tool: 'samectx',
+          format: 'json'
+        }
+      };
+    }
+  } catch (e) {
+  }
+  
+  const lines = conversationHistory.split('\n');
+  let currentSection = '';
+  
+  lines.forEach(line => {
+    const trimmedLine = line.trim();
+    
+    if (trimmedLine.startsWith('### ')) {
+      currentSection = trimmedLine.replace('### ', '');
+      return;
+    }
+    
+    if (trimmedLine.match(/^\d+\./) ||
+        trimmedLine.startsWith('- ') ||
+        trimmedLine.includes('任务') ||
+        trimmedLine.includes('需要') ||
+        trimmedLine.includes('要') ||
+        trimmedLine.includes('计划') ||
+        trimmedLine.includes('完成')) {
+      if (trimmedLine.length > 5 && !trimmedLine.startsWith('###')) {
+        tasks.push(trimmedLine);
+      }
+    }
+    
+    if (trimmedLine.includes('重要') || trimmedLine.includes('关键') ||
+        trimmedLine.includes('注意') || trimmedLine.includes('记住') ||
+        (currentSection && currentSection.includes('关键'))) {
+      if (trimmedLine.length > 5) {
+        keyPoints.push(trimmedLine);
+      }
+    }
+    
+    if (trimmedLine.includes('决定') || trimmedLine.includes('确定') ||
+        trimmedLine.includes('选择') || trimmedLine.includes('采用') ||
+        trimmedLine.startsWith('- ') && currentSection && currentSection.includes('决策')) {
+      if (trimmedLine.length > 5) {
+        decisions.push(trimmedLine);
+      }
+    }
+  });
+  
+  const summary = `对话包含 ${tasks.length} 个任务、${keyPoints.length} 个关键点和 ${decisions.length} 个决策`;
+  
+  return {
+    summary,
+    keyPoints,
+    tasks,
+    decisions,
+    rawContent: conversationHistory,
+    timestamp: new Date().toISOString(),
+    conversationLength: lines.length,
+    metadata: {
+      version: '1.0.0',
+      tool: 'trae-context-gist',
+      format: 'text'
+    }
+  };
+}
+
+function saveNoteToLocal(content, fileName, notesDir) {
+  if (!fs.existsSync(notesDir)) {
+    fs.mkdirSync(notesDir, { recursive: true });
+  }
+  
+  const notePath = path.join(notesDir, fileName);
+  fs.writeFileSync(notePath, JSON.stringify(content, null, 2));
+  
+  return {
+    fileName,
+    localPath: notePath,
+    savedAt: new Date().toISOString()
+  };
+}
+
+const MAX_GIST_FILES = 50;
+
+async function uploadToGist(content, fileName, projectName, token) {
+  let fetchFn;
+  if (typeof fetch !== 'undefined') {
+    fetchFn = fetch;
+  } else {
+    try {
+      fetchFn = require('node-fetch');
+    } catch (e) {
+      throw new Error('无法找到 fetch 函数，请安装 node-fetch: npm install node-fetch');
+    }
+  }
+  
+  const description = `TRAE CN - ${projectName}`;
+  const mapping = getGistMapping();
+  const existingGistId = mapping[projectName];
+  
+  if (existingGistId) {
+    try {
+      const getResponse = await fetchFn(`https://api.github.com/gists/${existingGistId}`, {
+        headers: {
+          'Authorization': `token ${token}`,
+          'User-Agent': 'TRAE-CN-ContextManager'
+        }
+      });
+      
+      if (getResponse.ok) {
+        const existingGist = await getResponse.json();
+        const existingFiles = Object.keys(existingGist.files || {});
+        
+        const files = {};
+        
+        if (existingFiles.length >= MAX_GIST_FILES) {
+          const filesToDelete = existingFiles.slice(0, existingFiles.length - MAX_GIST_FILES + 1);
+          filesToDelete.forEach(f => {
+            files[f] = null;
+          });
+        }
+        
+        files[fileName] = {
+          content: JSON.stringify(content, null, 2)
+        };
+        
+        const updateResponse = await fetchFn(`https://api.github.com/gists/${existingGistId}`, {
+          method: 'PATCH',
+          headers: {
+            'Authorization': `token ${token}`,
+            'Content-Type': 'application/json',
+            'User-Agent': 'TRAE-CN-ContextManager'
+          },
+          body: JSON.stringify({
+            description: description,
+            files: files
+          })
+        });
+        
+        if (updateResponse.ok) {
+          return await updateResponse.json();
+        }
+      }
+    } catch (e) {
+      console.warn(`更新现有 Gist 失败，将创建新 Gist: ${e.message}`);
+    }
+  }
+  
+  const files = {};
+  files[fileName] = {
+    content: JSON.stringify(content, null, 2)
+  };
+  
+  const response = await fetchFn('https://api.github.com/gists', {
+    method: 'POST',
+    headers: {
+      'Authorization': `token ${token}`,
+      'Content-Type': 'application/json',
+      'User-Agent': 'TRAE-CN-ContextManager'
+    },
+    body: JSON.stringify({
+      description: description,
+      public: false,
+      files: files
+    })
+  });
+  
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`上传失败 (${response.status}): ${errorText}`);
+  }
+  
+  const gistInfo = await response.json();
+  mapping[projectName] = gistInfo.id;
+  saveGistMapping(mapping);
+  
+  return gistInfo;
+}
+
+async function sync(options = {}) {
+  const config = loadConfig();
+  const token = config.githubToken;
+  
+  if (!token) {
+    return {
+      success: false,
+      error: 'GitHub Token 未配置，请运行: trae-context-gist config --token <your-token>'
+    };
+  }
+  
+  const projectName = extractProjectName(options.project);
+  const notesDir = getProjectNotesDir(options.dir);
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+  const fileName = `context_${timestamp}.json`;
+  
+  let content;
+  if (options.content) {
+    content = analyzeContext(options.content);
+  } else {
+    content = {
+      projectName,
+      timestamp: new Date().toISOString(),
+      summary: '手动同步',
+      metadata: {
+        version: '1.0.0',
+        tool: 'trae-context-gist'
+      }
+    };
+  }
+  
+  const localInfo = saveNoteToLocal(content, fileName, notesDir);
+  
+  let gistInfo = null;
+  let gistError = null;
+  
+  try {
+    gistInfo = await uploadToGist(content, fileName, projectName, token);
+  } catch (error) {
+    gistError = error.message;
+  }
+  
+  return {
+    success: true,
+    projectName,
+    localPath: localInfo.localPath,
+    gistUrl: gistInfo ? gistInfo.html_url : null,
+    gistError,
+    analysis: {
+      taskCount: content.tasks ? content.tasks.length : 0,
+      keyPointCount: content.keyPoints ? content.keyPoints.length : 0,
+      decisionCount: content.decisions ? content.decisions.length : 0
+    }
+  };
+}
+
+function listNotes(options = {}) {
+  const notesDir = getProjectNotesDir(options.dir);
+  
+  if (!fs.existsSync(notesDir)) {
+    return [];
+  }
+  
+  const files = fs.readdirSync(notesDir).filter(f => f.endsWith('.json'));
+  const notes = [];
+  
+  files.forEach(file => {
+    const filePath = path.join(notesDir, file);
+    try {
+      const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+      notes.push({
+        fileName: file,
+        localPath: filePath,
+        projectName: content.projectName || 'unknown',
+        timestamp: content.timestamp,
+        summary: content.summary
+      });
+    } catch (e) {
+    }
+  });
+  
+  if (options.project) {
+    return notes.filter(n => n.projectName === options.project);
+  }
+  
+  return notes.sort((a, b) => (b.timestamp || '').localeCompare(a.timestamp || ''));
+}
+
+module.exports = {
+  sync,
+  listNotes,
+  loadConfig,
+  saveConfig,
+  extractProjectName,
+  getProjectNotesDir,
+  analyzeContext,
+  CONFIG_DIR,
+  CONFIG_FILE
+};