🚀 温度笔记使用说明

Temp Notes 是一款辅助工具，可在多步骤或多会话任务中保存和恢复上下文，尤其适用于需跨多个对话完成复杂任务的场景。

🚀 快速开始

Temp Notes 操作简单，能快速上手。下面为你介绍基本使用步骤：

1. 初始化：

   // 初始化新笔记
   mcp_temp_note init
   

2. 写入内容：

   // 写入新的文本内容
   mcp_temp_note write "你的笔记内容"
   

3. 读取内容：

   // 读取当前笔记内容
   mcp_temp_note read
   

4. 清除内容：

   // 清除当前笔记内容
   mcp_temp_note clear
   

✨ 主要特性

• 持久化存储：笔记内容会在本地文件中长期保存，直到被明确清除。
• 独立会话：每个新对话都会创建一个新的空白笔记本，防止数据混杂。
• 文件路径：
  • macOS/Linux 系统：~/.mcp_config/temp_notes.txt（实际路径为 /Users/username/.mcp_config/temp_notes.txt）
  • Windows 系统：C:\Users\username\.mcp_config\temp_notes.txt

📦 安装指南

如果你想使用 Temp Notes 的命令行接口（CLI）工具，可通过以下命令进行安装：

// 安装 CLI 工具
npm install -g mcp-temp-note-cli

💻 使用示例

基础用法

作为任务检查清单

// 存储任务清单
await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "write_note",
  arguments: {
    content: "# 项目重构待办事项\n\n- [ ] 分析当前架构\n- [ ] 确定性能瓶颈\n- [ ] 创建新组件结构\n- [ ] 实现数据层更改\n- [ ] 更新 UI 组件\n- [ ] 编写测试用例\n- [ ] 更新文档"
  }
});

高级用法

恢复存储信息

// 在新的对话中恢复清单
const result = await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "read_note",
  arguments: {}
});

// 结果包含之前存储的清单内容

更新任务进度

// 更新笔记内容以反映进展
await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "append_note",
  arguments: {
    content: "## 架构分析完成\n\n关键发现：\n- 当前结构存在循环依赖\n- 数据获取效率低下\n- 组件复用度低\n\n建议：实现仓库模式和组件组合",
    include_separator: true
  }
});

清除笔记内容

// 完成任务后清除笔记
await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "clear_note",
  arguments: {}
});

📚 详细文档

使用场景

复杂编码任务

在处理复杂编码任务时，Temp Notes 可以帮助：

• 存储任务清单
• 包含每个子任务的详细描述
• 记录需要检查的具体文件
• 跟踪跨多个对话的任务进度

保持上下文跨越对话

随着对话长度增加，上下文窗口可能被填满。Temp Notes 允许：

• 总结当前任务状态
• 文档已完成步骤和剩余工作
• 存储重要信息以便后续参考
• 记录下一步骤以供新对话继续

跨存储库信息传输

在处理多个存储库或项目时，Temp Notes 可用于：

• 存储来自一个仓库的代码片段
• 保存文件内容作为参考资料
• 文档从一个项目到另一个项目的模式或做法
• 创建临时文档以连接不同项目

协作工作流

多用户协作时，Temp Notes 可帮助：

• 中央存储任务信息
• 分散团队成员的工作进度
• 确保所有参与者信息同步

配置说明

Temp Notes 服务器的配置信息如下：

示例配置

// 初始化 Temp Notes 服务
{
  "server_name": "temp-notes",
  "storage_path": "~/.mcp_config/",
  "encrypt_data": false
}

错误处理

常见错误及解决方案

1. 笔记文件无法打开：

   • 确保路径权限正确
   • 检查是否有其他进程占用该文件

2. 加密失败：

   • 确保加密密钥正确无误
   • 检查系统是否支持所需加密算法

3. 读取内容为空：

   • 确认写入操作成功执行
   • 检查是否有意外清除操作发生

安全注意事项

• 数据加密：所有存储内容都应进行加密处理，特别是在敏感环境中。
• 访问控制：限制对 Temp Notes 服务的访问权限，防止未授权访问。
• 备份策略：定期备份笔记文件，以防数据丢失。

升级指南

从旧版本升级到新版本时，请注意：

• 检查是否有配置参数的变化
• 确保兼容性，必要时调整客户端代码
• 执行升级前，先进行数据备份

命令行工具参考

Temp Notes 提供了命令行接口（CLI）工具，方便用户直接操作笔记文件。

使用示例

// 查看帮助信息
mcp_temp_note --help

// 写入内容到笔记
mcp_temp_note write "你的笔记内容"

// 读取当前笔记内容
mcp_temp_note read

// 清除笔记内容
mcp_temp_note clear

API 文档

Temp Notes 提供了 RESTful API，允许开发者集成到自定义应用中。

写入内容

POST /notes
Content-Type: text/plain

你的笔记内容

读取内容

GET /notes

清除内容

DELETE /notes

📄 许可证

文档中未提及相关许可证信息。

📞 联系方式

如有任何问题或反馈，请联系：

• 邮件：support@temp-notes.com
• GitHub：https://github.com/temp-notes

⚠️ 重要提示

使用 Temp Notes 时，请遵守相关法律法规，确保数据安全和隐私保护。