个人工作台 · 绿色版（解压即用）
================================

【想要"正式安装"？】
用 `个人工作台-安装版-v2.1.0.zip`：解压后双击「安装.bat」，选个文件夹就装好，
开始菜单/桌面有快捷方式，控制面板能卸载。不需要管理员权限。详见「18-安装版说明.md」。

【怎么用】
0. 如果这个 zip 是从微信 / QQ / 网盘 / 浏览器下载来的，先做这一步：
   右键 zip → 属性 → 勾选最下面的「解除锁定」→ 确定，然后再解压。
   这样解压出来的文件不带「来自网络」标记，双击不会弹任何安全提示。
   （忘了也没关系：第一次双击选「仍要运行」，程序会自己把标记清掉，之后不再弹。）
   也可以解压后双击「首次使用-解除锁定.bat」，它会一次性清掉整个目录的标记。
1. 把整个 zip 解压到任意文件夹（桌面、D 盘、U 盘都行）。
   ⚠ 别放在 C:\Program Files —— 那里默认不可写，程序会自动把数据落到用户目录。
   ⚠ 解压要完整：exe 旁边的 _launcher 文件夹是启动器的依赖，删了双击就没反应。
2. 双击「个人工作台.exe」。就这一步，没有别的入口。
   屏幕正中会先出现一个小窗：HG 图标 + 「正在启动本地服务…」+ 走马灯进度条 +
   右下角「已等待 x.x 秒」，然后工作台窗口自己弹出来（无地址栏），托盘里出现 HG 图标。
   一般 1~3 秒；第一次在新电脑上启动，杀毒软件要扫一遍，可能到 5 秒左右。
3. 关掉窗口后台还在跑；双击托盘图标可拉回来，右键可「重新扫描 / 退出工作台」。
   再双击 exe 不会重复启动，只是把已有窗口叫到前面（小窗会显示「工作台已在运行」）。
4. 退出：托盘右键 → 退出工作台，或双击「退出工作台.bat」，
   也可以在命令行执行「个人工作台.exe --quit」。

【关于几个 bat】
「启动工作台.bat」「调试启动-可见控制台.bat」都只是排查工具，平时用不到：
- 双击 exe 完全没反应、连启动小窗都不出现 → 用「调试启动-可见控制台.bat」，
  它会留一个黑窗口把报错打出来，拍照发给开发者最有用。
- 「首次使用-解除锁定.bat」只在被 SmartScreen 反复拦的时候用一次。
- 退出更推荐右键托盘图标，不依赖任何文件。

【启动器为什么不是一个单文件 exe】
曾经打过单文件（onefile）版本：8MB，但每次双击都要先把运行时解包到系统临时目录，
在临时目录被清理软件锁住 / 磁盘满 / 杀软拦写的机器上会直接启动失败（静默退出，什么都不显示）。
现在改成 exe + _launcher 文件夹（共约 11MB）：启动不解包、不碰临时目录，
冷启动从 3~5 秒降到 1~3 秒，也没了那类玄学失败。代价是文件夹里多一项，别删它。

【想让 AI 用上它】
看同目录的「AI-接入与使用说明.md」——那份是写给 AI 看的，
内容包括怎么连 MCP、98 个工具各干什么、以及开工前该先读什么。
人只需要在「设置 → 连接 AI」点一次「写入配置」，之后把那份文件丢给 AI 就行。
注意：AI 用之前要先启动工作台（MCP 只是转发，主服务得在跑）。

【不需要装什么】
- 不用装 Python：runtime\ 里自带一份精简 CPython 3.13（约 22 MB）。
- 不用 pip、不用联网、不改系统 PATH、不写注册表（默认）。
- 需要 Edge 或任意浏览器：Win10 1903+ / Win11 自带 Edge，用来开窗口；
  实在没有也可以用系统默认浏览器打开 http://127.0.0.1:7799/。
  WebView2 没法打包进绿色版，这一点是「99% 可用」而不是 100% 自包含。

【数据在哪】
- 默认全部在解压目录的 data\ 里：索引库、日志、导出、示例资料。
- 程序目录不可写时，自动落到 %LOCALAPPDATA%\个人工作台\data，正常启动。
  设置页「数据位置」会显示真实路径，也能一键迁移到别处。
- 备份 = 复制 data 文件夹。

【绿色版的纯度】
- 不做安装向导、不写 Program Files、不注册服务、不改 PATH。
- 默认不写注册表。想要开机自启，去「设置 → 绿色版与数据」勾一次；
  取消即删键。挪动文件夹后，下次启动会自动把注册表路径改成新位置。
- 卸载 = 删掉整个文件夹。设置页有「卸载并清理自启」，只清注册表那一行。

【常见问题】
Q: 双击「个人工作台.exe」弹出蓝色的「Windows 已保护你的电脑」？
A: 因为 exe 没买代码签名证书（个人软件都这样），不是病毒。
   点「更多信息」→「仍要运行」即可。**只需要点这一次**——程序启动后会把
   自己和 runtime 里两个 exe 的「来自网络」标记一起删掉，以后再双击不弹。
   想连第一次都不弹：解压前先右键 zip → 属性 → 解除锁定，或解压后双击
   「首次使用-解除锁定.bat」。
   要彻底去掉「未知发布者」字样，只能买代码签名证书（OV 约一千多一年，
   EV 更贵且要硬件密钥）；个人自签名没用，别人的电脑不认。

Q: 为什么会有这个提示？
A: Windows 对「从网上下载 + 没有数字签名 + 还没攒够下载声誉」的程序会拦一下。
   这层信息存在 NTFS 的附加流里（Zone.Identifier），本地生成的文件没有，
   所以你自己打的包在你自己机器上从来不会弹——传给同事才会。

Q: 双击没反应 / 一闪而过？
A: 先确认 exe 旁边有 _launcher 和 runtime 两个文件夹（解压不完整是最常见原因）。
   还有问题就用「调试启动-可见控制台.bat」看报错。

Q: 端口 7799 被占了？
A: 程序会自动挑下一个可用端口；再双击一次 exe 会认出来并打开已有窗口。
   实在不确定就双击托盘图标，或看 data\instance.json 里的 port。

Q: 杀软拦了？
A: 绿色版是 Python 脚本 + 精简运行时，没有加壳 exe。把文件夹加进白名单即可。

Q: 换电脑 / 同事要用？
A: 直接把这个文件夹（或 zip）复制过去，双击 exe 就能用；数据不会跟着走
   （data 在各自机器上），想带走就复制 data 文件夹。

【个人版免费 · 默认离线】
个人版完全离线，一个字节都不发，本地功能一个不少：扫描、索引、看板、报告、导出。
检查更新是唯一例外（只查官方更新源、不传你的资料，而且必须你点「检查更新」）。

【团队版】
联网、团队共享/上报、配置工作台自己的 AI 接口、实时升级、后台管理等是团队版功能。
管理员在管理后台签激活码，你在「设置 → 团队版」粘贴即激活，不需要联网。
激活后到「设置 → 联网」开开关，开关仍然只有你能开；往外发数据仍要你逐次确认。
没激活也能照常用全部本地功能，到期或退出团队版也不会锁你的资料。
产品说明见「16-团队版规划-功能与商业模式.md」，部署见「17-团队版部署与授权运维.md」。

开着也只有你点的时候才发，往外送数据的只有两种：
  · AI 请求 —— 会把要处理的那段文字发给模型（摘要取片段、报告取前 6000 字）
  · 团队汇总上报 —— 只发指标 / 项目进度 / 报告标题，不发路径、不发正文
上报每次都要你在弹窗里点「确认上报」；工作台没有定时上报，
后台任务想传也会被直接拒绝。每一次外发都记在「设置 → 联网 → 看出网流水」里，可逐条核对。

MCP 那一路不受这个开关影响：那是 AI 来调本机的 127.0.0.1，不是工作台往外发。

【能力一览】
概览 / 看板 / 项目 / 报告 / 沉淀 / 资料 / 设置 / 介绍 HGer；
五套形态模板；98 个 MCP 工具（设置 → 连接 AI 写配置）；
单文件 HTML、xlsx、pptx、PDF 导出；做同款、自进化建议、沉底复盘、图片墙。

版本 v2.1.0 · 个人版免费离线 · 团队版解锁协作
