🧠 NotaMy

NotaMy 是一个基于终端的层级化技术笔记管理器，旨在减少长期分析任务（渗透测试、逆向工程、战争游戏）中上下文切换的心理成本。

🎯 为何创建 NotaMy

当我开始从事渗透测试和二进制分析工作时，我很快意识到一件事：

问题不在于做笔记——而在于长期管理它们。

一项分析可能持续数天或数月。期间，你会积累内存地址、测试输出、反汇编结果、可疑行为、失败尝试、待验证的想法——而这些往往散落在文件和文件夹中。

结果呢？混乱。不断在散落的文件中搜索信息会打断思维流，拖慢调查进度。

NotaMy 的创建就是为了消除这种摩擦：降低上下文切换的成本，同时让所有信息在 shell 中可访问、可组织、可搜索。

🧩 NotaMy 是什么

NotaMy 不是一个文本编辑器。 它不是 Markdown 系统。 它不是图形化应用。

它是一个极简的、终端优先的系统，用于将技术知识组织成笔记文件（上下文）和标签的层级树结构。

⚙️ 主要功能：

• 多个笔记文件（上下文），支持快速切换
• 层级节点结构，包含标签、注释、扩展文本、关键字和文件引用
• 结构化搜索（按标签、关键字、内容）
• 完全键盘驱动的操作流程
• 专为长期复杂技术工作流设计

🗂️ 核心概念

每个笔记文件代表一个项目或调查。切换文件即切换思维空间。

示例：

ntm view file

你可以通过以下命令切换上下文：

ntm setting 2

🌳 层级结构

笔记以节点形式组织在树中。每个节点可以包含：

• 标签（主要关键字）
• 注释（树中可见的便签）
• 长文本正文
• 文件引用
• 用于搜索的关键字

你可以存储一条便签或一整本书。都在同一个地方。

示例：

ntm view note

# 表示该节点包含可展开的文本。

你可以展开每个节点以查看其内容：

ntm view note -b

🔄 工作流程（我的使用方式）

• 创建或选择笔记文件（上下文）。
• 添加一个带有标签和注释的节点：

ntm add note -t "标签" -c "简短注释"

• 如果需要，使用配置的编辑器（默认 vim）编写更长的文本：

ntm add note -t "标签" -c "注释" -b

编辑器打开，保存并退出后，正文即被插入到笔记中。

• 将文件（漏洞利用、二进制、配置）直接链接到笔记，并使用关键字快速检索所有内容。

👤 适用人群

NotaMy 专为以下人群设计：

• 常驻终端
• 从事长期复杂的技术任务
• 同时管理多个项目
• 期望结构化但又无需图形界面
• 偏爱键盘而非鼠标

🚫 不适用人群

如果你符合以下情况，它可能不适合你：

• 需要云同步
• 需要多用户协作
• 需要现代图形界面
• 想要编写 Markdown 文档

NotaMy 追求极简且专注。

📝 简短历史

NotaMy 源于一个个人需求：

降低上下文切换的心理成本。

笔记不是问题，复杂性才是。

2020 年，我从一个名为 "Note Management" 的基础版本开始：简单的结构化文本。当时已经很有用。接着是 MemoKeeper 和 MemoKeeperX，加入了独立文件和标签。随着时间的推移，它成为我日常工作流程的一部分：渗透测试、学习、想法和小项目。

NotaMy 是这个工作流程的成熟版本：极简、可靠，并适应我的工作方式。

想了解 NotaMy 诞生背后的原因和过程？请阅读项目的 PHILOSOPHY。

🚀 安装

git clone https://github.com/IMprojtech/NotaMy.git
cd NotaMy
make
./bin/ntm

将 NotaMy 添加到 PATH

编译 ntm 后，你可能希望无需输入完整路径即可从任何位置运行它。以下是常见方法：

安装到 PATH 中已有的目录

1. 将编译后的二进制文件复制或移动到标准位置，例如：

sudo cp ./bin/ntm /usr/local/bin/
sudo cp ./bin/ntm_nc /usr/local/bin/

或者，如果你更喜欢本地安装（无需 sudo）：

mkdir -p "$HOME/.local/bin"
cp ./bin/ntm "$HOME/.local/bin/"
cp ./bin/ntm_nc "$HOME/.local/bin/"

确保该目录在你的 PATH 中。大多数 Linux 发行版默认包含 /usr/local/bin。如果你使用了 ~/.local/bin，请确保你的 shell 初始化文件将其添加到 PATH。例如，在 ~/.bashrc 或 ~/.zshrc 中：

# 如果尚未添加，请添加以下内容：
export PATH="$HOME/.local/bin:$PATH"

或者，你可以直接将 bin 目录添加到 shell 初始化文件中：

export PATH="$HOME/path/to/NotaMy/bin:$PATH"

🐚 可选的 Zsh 集成

NotaMy 提供了可选的 Zsh 包装器，可在不修改核心 C 程序的情况下增强用户体验。

该包装器增加了：

• 包装后的 ntm 命令，改进了输出处理
• 通过 bat 实现自动分页
• 正确的 TTY 检测
• fview 函数，用于交互式笔记查看（fzf + bat）
• nocolor 函数，用于去除 ANSI 转义序列
• 通过数字前缀临时切换笔记文件

临时切换笔记文件

该包装器允许你在命令前放置文件编号以临时切换活动文件：

ntm 1 view note

安装

将插件文件添加到你的 ~/.zshrc：

source /path/to/NotaMy/shell/zsh/notamy.plugin.zsh

然后重新加载 shell：

source ~/.zshrc

⚠️ Zsh 集成完全是可选的。 核心 C 应用程序独立运行。

📘 文档

提供了完整的用户手册，包含安装说明、使用示例和支持的所有命令：

📄 阅读 NotaMy 手册

⚖️ 许可证

本程序根据 GNU 通用公共许可证（GPL）条款分发，确保根据自由软件标准重新分发和修改软件的自由。

✍️ 作者

由 Catoni Mirko (IMprojtech) 编写。