# IntraBox

**Repository Path**: xinyi6952/IntraBox

## Basic Information

- **Project Name**: IntraBox
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-06
- **Last Updated**: 2026-10-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# IntraBox（内聚）

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

面向内网工作者与开发者的**绿色免安装聚合效率工具**，纯本地运行、无网络依赖、无遥测。

- **主仓库（版本管理）**：[Gitee](https://gitee.com/xinyi6952/IntraBox)
- **镜像（自动同步）**：[GitHub](https://github.com/xinyi6952/IntraBox)

日常 clone / push / Issue / Pull Request 请走 Gitee。GitHub 由 Gitee 仓库镜像推送同步，不作为日常 origin。说明见 [开源仓库](docs/开源仓库.md)。

> **免责声明**：本工具仅供合法、授权的用途（系统管理、开发调试、安全测试等）。其中包含 Hosts 编辑、端口/文件占用查看、加解密、证书解码等能力，请勿用于任何未经授权的活动，使用者需对自身行为负责。

## 特性

- **兼容 Windows 7 SP1+ x64**（.NET Framework 4.8；`app.manifest` 声明 Win7–Win11 与 PerMonitorV2）
- **绿色免安装**：解压即用，单文件夹部署
- **纯本地**：无网络、无遥测、无自动更新，数据不出本机
- **低资源**：按需加载、用完销毁；工具输入靠历史落盘，不缓存控件
- **49 个实用工具**，覆盖截图 / 文件 / 格式化 / 文本 / 编码 / 安全 / 网络 / 系统等

## 功能清单（49 个，详见[产品设计文档](docs/产品设计文档.md)）

效率工具（6）：剪贴板历史、启动器、任务计划、笔记、账号备忘、工作日历
系统工具（9）：本机信息、环境变量、任务编排、Hosts 编辑器、文件占用查看、窗口置顶、防止睡眠、护眼模式、注册表只读浏览
截图（2）：屏幕截图（含 OCR）、屏幕标尺
文本工具（9）：格式化（JSON/YAML/XML/SQL/HTML/CSS/Markdown/Nginx）、文本比对、正则表达式测试、行处理、命名转换、Markdown 预览、文本统计、正则可视化、文本转 Excel
编码转换（5）：Base64 编解码、URL/HTML/Unicode 编解码、URL 解析、Unicode 字符检查、时间转换
文件管理（5）：文件查找、目录大小、文件整理、批量重命名、重复文件查找
网络工具（2）：端口占用查看、端口连通性测试
安全工具（3）：哈希计算、加解密、证书解析
生成器（3）：ID 与密码生成、二维码生成、JSON 转实体类
图片与设计（3）：图片压缩缩放转换、屏幕取色、色盲模拟
开发工具（2）：JSON Schema 验证、SemVer 版本比较

## 目录结构

```
IntraBox/
├── IntraBox.sln                 解决方案
├── build.bat                    构建脚本（默认保留数据并升号；`test` 打纯净测试包）
├── version.txt                  产品版本（四段，每次打包最后一段 +1）
├── test.bat                     测试脚本（跑 MSTest 单元测试）
├── src/IntraBox/                主项目（net48 WPF）
│   ├── App.xaml(.cs)            应用入口（单实例/托盘/全局异常/热键/剪贴板监听）
│   ├── MainWindow.xaml(.cs)     主窗口（导航 + 工作区 + 状态栏）
│   ├── Core/                    核心框架（模块加载、配置、历史、各类 Helper）
│   ├── Controls/                自定义控件（AvalonEdit 代码编辑器、折叠、括号高亮）
│   └── Modules/                 功能模块（每个工具一个子目录）
├── tests/IntraBox.Tests/        单元测试项目（MSTest）
├── dist/IntraBox/               绿色发布目录（主程序 + 依赖 + 文档）
├── dist/IntraBox.test/          纯净测试包（build.bat test 生成，不入库）
├── redist/                      离线包（不入库，用法见 redist/说明.txt）
├── docs/                        产品设计、测试用例、评审/提交规范、开源仓库说明
└── tools/                       开发辅助脚本（含 fetch-webview2-runtime.ps1、BOM 检查）
```

## 构建

双击 `build.bat` 弹出英文菜单（回车或 `1` 为默认）：

- **[1] Keep user data**：若托盘里 IntraBox 仍在运行会确认结束进程（默认「否」）；确认后**产品版本最后一段 +1**，清 obj/bin 后全量编译，同步到 `dist/IntraBox/`。保留 `datapath.txt` 与 `%LOCALAPPDATA%\IntraBox\Data`（或自定义数据目录），不改用户配置。
- **[2] Clean test package**（或 `build.bat test` / `build.bat 2`）：**不升号**。产出 `dist/IntraBox.test/`，数据写到 `%LOCALAPPDATA%\IntraBox\Data.test`（会清空该测试目录）。不碰用户真实数据，也不读/删 `dist/IntraBox/datapath.txt`。用于测首次引导。
- 选完模式后问是否启动：回车或 `Y` 启动新包（工作目录为发布目录，避免只唤醒托盘里的旧进程），`N` 不启动。成功后构建窗口关掉；失败或启动失败则窗口停住。命令行 `build.bat norun` 等价于默认模式且不启动。

> 运行环境：Win10 1903+ 已预装 .NET Framework 4.8；Win7 SP1 需先装 [.NET Framework 4.8](https://dotnet.microsoft.com/download/dotnet-framework/net48) 与 VC++ 运行库。
>
> Win10/11 的 Markdown / 笔记预览：把 `WebView2Runtime`（内含 `msedgewebview2.exe`）放到 `IntraBox.exe` 旁边即用 Edge，安装包不附带。没有该目录则用 IE。Win7 用 IE，不是降级。用法见 `redist/说明.txt`。

## 测试

双击 `test.bat`，跑 `tests/IntraBox.Tests` 的全部 MSTest 用例。确定性逻辑走自动化测试；交互型功能按 `docs/测试用例.md` 验证；已有功能的防回归见 `docs/代码评审清单.md`。

## 发布

- **Win10 / Win11**：只给 `dist/IntraBox/`。默认用 IE 预览 Markdown。需要 Edge 时，另把 `WebView2Runtime` 文件夹放到 `IntraBox.exe` 旁边。
- **Win7 内网机**：需额外安装 .NET Framework 4.8 与 VC++ 运行库（微软官方下载）：
  - [.NET Framework 4.8 离线安装包](https://dotnet.microsoft.com/download/dotnet-framework/net48)
  - [VC++ 2015-2022 运行库（x64）](https://aka.ms/vs/17/release/vc_redist.x64.exe) / [x86](https://aka.ms/vs/17/release/vc_redist.x86.exe)
- 环境要求与检查方法见 `dist/IntraBox/使用说明.txt`。

## 开发约定

- 新增功能模块：在 `Modules/` 下新建子目录，实现 `UserControl`（可选实现 `IModuleView` 做激活/销毁、`ILeaveGuard` 做离开确认），在 `ModuleRegistry.RegisterDefault()` 注册，并写入 `NavOrder` 的默认分类/工具顺序。
- 确定性逻辑尽量抽成 `Core/*Helper` 纯静态类，便于单元测试。
- 每个模块遵循「按需加载、用完销毁」：切换离开时释放，进入时从 `HistoryManager` 恢复输入。
- 产品设计文档（`docs/产品设计文档.md`）与代码保持同步。

## 许可证

本项目采用 [MIT License](LICENSE)。

## 第三方依赖

本项目使用了多个第三方开源组件，详见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。

## 贡献与安全

- 主仓库在 [Gitee](https://gitee.com/xinyi6952/IntraBox)；GitHub 为镜像。托管说明见 [开源仓库](docs/开源仓库.md)
- 贡献指南见 [CONTRIBUTING.md](CONTRIBUTING.md)；AI 助手见 [AGENTS.md](AGENTS.md)
- 评审见 [代码评审清单](docs/代码评审清单.md)，提交见 [代码提交规范](docs/代码提交规范.md)
- 行为准则见 [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
- 安全漏洞上报见 [SECURITY.md](SECURITY.md)