把硬盘上散落的项目
收进同一个工作台
ttFolio 是一个本地的项目工作台。把你机器上的项目文件夹登记进来， 在同一个界面里读源码、看 Git、管文档与架构图、跨项目搜索。 磁盘是真相，数据库只是索引 —— 你的文件原地不动。
先守住你的磁盘，再谈效率
ttFolio 的每一条功能背后都有一条硬约束。这些约束是被机械检查强制执行的，不是宣传语。
纯本地运行
单机单人，服务只监听 127.0.0.1，无遥测、无 CDN、运行期不出网。
被登记目录零改动
除你的显式操作外，项目目录一个字节都不动。删除一律先进回收站，可按原路径恢复。
索引坏了也能自愈
迁移前与每日自动快照，索引库损坏可自愈。清空索引库不会删除任何项目文件。
永不静默覆盖
保存前用 mtime + size + sha256 三元组校验，冲突时给出对比 / 放弃本地 / 覆盖磁盘三选一。
一个界面，覆盖项目全生命周期
从登记一个文件夹开始，到看懂它的语言构成、Git 状态、文档与架构。
项目登记
粘贴路径、系统文件夹对话框、父目录批量登记，三种入口都能用。
- 多行路径 / 引号 / UNC 前缀自动清洗
- 一次登记一个父目录下的全部项目
自动分析
项目类型识别、语言占比、技术栈标签与 Git 摘要，登记后自动完成。
- 按字节统计，对齐 GitHub Linguist 口径
- 90+ 语言，含 Makefile / Dockerfile / .env
文件浏览与编辑
懒加载文件树 + CodeMirror 6 编辑器，草稿强杀进程不丢字。
- 外部修改实时检测，冲突三选一
- UTF-8 / BOM / UTF-16 / GBK 与 CRLF / LF 原样保持
Git（只做本地）
工作区状态、diff、暂存、提交、提交历史与详情、分支切换。
- 一次提交只包含暂存内容
- 不做 push / pull，不存储任何凭据
文档中心
项目内 Markdown 自动发现，也可以把外部文档目录挂载进来。
- 支持系统对话框多选挂载
- 目录大纲跳转 + Markdown 渲染
架构图
登记架构图目录，独立端口只读访问，iframe 沙箱隔离渲染。
- 用户内容与应用不同源
- 支持 HTML 架构图与图片
全局搜索
Ctrl + K 命令面板，一次搜项目名、文件名与文件内容。
- SQLite FTS5，中文友好
- 增量索引，敏感文件不进内容索引
工作台与回收站
项目卡片墙、需要关注的项目、聚合语言构成、跨项目最近提交。
- 删除先进回收站，可恢复到原路径
- 集合归类、标签过滤、六套界面主题
界面一览
所有页面都是真实产品的界面，不是概念图。
工作台总览：一眼看清所有仓库的状态
项目总数、今天动过的项目、有未提交改动的项目、缺设计文档与缺架构图的项目，全部收敛成一屏。 右栏同时给出索引库体积、回收站占用、上次备份时间与文件监听状态。
- 项目卡片墙与最近打开记录
- 「需要处理」把治理问题变成可点击的待办
- 跨项目清单汇总所有项目的待办条目
文件与编辑器：不丢字，也不覆盖你的改动
左侧是懒加载文件树，右侧是 CodeMirror 6 编辑器。草稿以 1 秒防抖落盘，强杀进程后重启仍在。 当文件在磁盘上被外部编辑器改过，界面会先告诉你，再让你决定怎么办。
- 冲突三选一：对比 / 放弃本地 / 覆盖磁盘
- 编码与换行符原样保持，不做隐形转换
- 原子写：同目录临时文件 + fsync + rename
架构图与文档：让项目自己讲清楚自己
把一个架构图目录登记进来，ttFolio 会用独立的只读端口把它渲染在沙箱 iframe 里 —— 用户内容与应用程序不同源，架构图里的脚本碰不到你的索引库。
- 入口识别：index.html 优先，可手动指定
- 图集列表由前端渲染，不往你的目录里落临时文件
- 可新窗口打开、可全屏
写在可靠的轮子上
TypeScript 严格模式贯穿前后端，选型全部为了「离磁盘更近一点」。
现在就把你的项目收进来
桌面版开箱即用，不需要 Node.js 或任何运行环境。
Windows 桌面版
- 安装时可自定义安装目录，中文路径可用，无需管理员权限。
- 数据保存在
%APPDATA%\ttFolio\，卸载软件不会删除你的数据。 - 安装包未做代码签名，首次运行会触发 Windows SmartScreen 提示，请选择「更多信息 → 仍要运行」。
- 首次启动可能被杀毒软件全量扫描而偏慢，第二次启动通常在 4 秒内。
- 系统要求：Windows 10 / 11 x64。安装后程序占用约 420 MB 磁盘空间；无需安装 Node.js 或任何运行环境。
从源码构建
$ git clone https://github.com/TT-Tao178/ttfolio.git
$ cd ttfolio
$ npm install
$ npm run dev
# 打开 http://localhost:5173- 开发模式同时启动后端（
127.0.0.1:7717）与前端（localhost:5173）。 - 未安装 Git 时 Git 相关页签不可用，其余功能不受影响。
npm run verify是发布前的全量门禁：类型检查、Lint、单元与集成测试、构建、端到端用例与机械检查。
你可能想问的
ttFolio 会修改我的项目文件吗？
除你在界面里的显式操作外，被登记目录零改动。分析、浏览、搜索都是只读的；写文件时先写同目录临时文件、fsync 后再 rename 原子替换；删除一律先进回收站而不是真删。
数据存在哪里？换台电脑还能用吗？
数据目录是 %APPDATA%\ttFolio\，里面有 library.db、backups/、trash/、logs/。索引库只是索引 —— 磁盘上的项目文件原地不动，换台机器重新登记与重新分析即可恢复。启动时距上次备份超过 24 小时会自动做一次快照。
它会联网吗？会不会上传我的代码？
不会。服务只监听 127.0.0.1，运行期不出网，没有遥测也没有 CDN 依赖。Git 只做本地操作，不做 push / pull / fetch，也不存储任何凭据。
支持哪些平台？
桌面版当前提供 Windows 10 / 11 x64 的 NSIS 安装包。源码运行对平台没有硬性限制，需要 Node.js ≥ 22（以 Node 24 验证）。
更新日志
下面是最近几个正式版（打开页面时自动从 GitHub 同步）；完整日志见仓库 CHANGELOG。
- 桌面应用图标迭代：圆角加大，去除四角白底
- 安装包、开始菜单与桌面快捷方式同步更新为新图标
- 自研 TT 品牌图标正式落地安装包与桌面图标
- 窗口适配两轮收紧，小尺寸屏幕下的排版更稳定
- 工作台总览四模块上线，分页器增加防漂移处理
- 修复 Git 页「加载更多」时的闪空与跳顶问题
- 首个可安装的 Windows 桌面版发布，采用 NSIS 安装向导
隐私与条款
本站是纯静态介绍页，软件本身也只在本机运行 —— 我们不收集你的任何信息。
隐私声明
我们对你的数据没有任何兴趣，这一点写进了架构里。
- 本站：不设置 Cookie、不加载第三方统计或广告脚本、不采集访问者信息。页面引用的字体、图标与截图全部内置，不向任何外部地址发起请求。
- 软件：ttFolio 只监听
127.0.0.1，运行期不出网，无遥测、无自动更新回传。项目路径、文件内容与 Git 信息不会离开这台机器。 - 安装包：不包含推广组件或捆绑软件，也不在后台常驻联网进程。
- 访问日志：仅由托管服务按其标准策略保留，用于故障排查，我们不做二次分析。