nblane · 大佬之路

Human + Agent 共进化。 你和自己的 Agent 是一个长期成长单元； 目标 + 技能 + 证据组成一张可审查的能力图谱。

English

nblane 是给 AI-native 研究者和开发者用的本地优先成长工作台。它把阅读、写作、项目、代码和学习记录沉淀成可审查的证据（evidence），映射到目标、技能树、研究资料、公开作品和 Agent 上下文里。

每个人有一份 SKILL.md：既是成长档案，也是 Agent 的系统提示词。把它交给任何 Agent，Agent 就按你的目标、技能和证据做事；文件更新，Agent 跟着更新。

所有数据都是 profiles/<name>/ 下的 YAML / Markdown 文件，用 Git 备份，没有数据库。

功能

区域	做什么	文档
首页	星图（目标是恒星、技能是星座）、目标、习惯打卡	首页
项目	看板、时间轴、里程碑，任务完成后结晶为证据	项目
技能树	领域技能图、证据支撑的点亮与进阶	技能树
证据	证据池、AI 预填 + 人确认的审阅流程	证据
研究	论文库、PDF 阅读器、翻译、深读、GROBID 结构化抽取	研究台
内容	BlockNote 写作、AI 整理、导出小红书 / X 卡片	内容工作台
求职	结构化简历、PDF 导出	求职工作台
公开站	自我介绍 + 写作 + 作品的静态站，人确认后发布	公开站
助手	OpenClaw 通过 HTTP 读写，写入可撤销，重要操作需确认	助手

快速开始

环境：Python ≥ 3.11、Git、tmux。可选：Chromium（简历 PDF、分享卡片）、Node.js（只在改前端时需要）。

git clone <repo-url> && cd nblane
scripts/install.sh              # 建 .venv、安装依赖、检查环境，然后进入设置向导

向导会问档案名、领域模板、AI 服务和要不要开登录，最后打印启动命令。也可以手动来：

python3 -m venv .venv && .venv/bin/pip install -e .
.venv/bin/nblane setup          # 交互式设置；--help 看非交互参数
.venv/bin/nblane doctor         # 环境自检，每项给出修复提示
scripts/dev-web.sh              # 启动，打开 http://127.0.0.1:8504

AI 是可选的：不配 Key 时 CLI 和规则类功能照常可用。AI 服务也可以之后在「设置 → AI 服务」里配置。

常用 CLI：

nblane status yourname          # 技能树摘要
nblane sync yourname --write    # 刷新 SKILL.md 的生成块
nblane context yourname         # 打印给 Agent 的系统提示词

服务与端口

服务	端口	作用
SPA + API nblane.web_api	8504	网页界面和 /api/v1
Reader API nblane.web_reader_api	8502	论文库、阅读器（SPA 内嵌）、登录交接

远程开发时两个端口都要转发，否则论文库和阅读器是空白。scripts/dev-web.sh --isolated 换用 18504 / 18502 和独立的 .dev-data/，不碰真实数据。

上线

本机单人使用默认不登录。放到服务器上必须开登录（nblane setup 可以创建管理员），服务只绑 127.0.0.1，前面用 Caddy 反代。见 腾讯云部署。

文档

中文文档 docs/zh/ 是事实源。

• 产品总览
• 安装与配置
• Web 总览
• 架构总览
• CLI 参考

贡献者和编码 Agent 请看 AGENTS.md。