Skip to content
Back to search

Lzheng-fitness

Lzheng的开源健身 Agent Skill 知识库

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lzheng0411--lzheng-fitness/badge.svg)](/listings/lzheng0411--lzheng-fitness)

HTML

<a href="/listings/lzheng0411--lzheng-fitness"><img src="/api/listings/lzheng0411--lzheng-fitness/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

已有工作台侧栏缺失或更新后仍是旧界面时,直接让 AI:“检查并修复我的工作台侧栏,保留记录和壁纸。”新版提供独立界面升级通道;更新 Skill 与刷新数据不会自动替换旧 HTML。支持的官方旧版经过识别、备份、同路径替换与浏览器验证后才报告界面升级成功。未知自定义会明确停止并给出差异。[升级方法与恢复边界](skills/lzheng-fitness-workbench-builder/references/ui-upgrade.md)。

界面升级的实际写入阶段另需 Node.js、Playwright 与 Chromium,用于真实页面验收;日常使用和只读检查不增加这项依赖。

需要 Python 3.10 或更新版本;不需要第三方 Python 包。

python tools/install.py --platform codex --all

也可安装到隔离目录,便于验证:

python tools/install.py --target-root ./test-agent --all

每次安装都会在复制前后核对完整文件清单和 SHA-256,并把结果记录到 Agent 根目录下的 `.lzheng-fitness/install-state.json`。可以随时只读检查当前安装是否与这份仓库一致:

python tools/install.py --platform codex --all --verify
python tools/install.py --target-root ./test-agent --all --verify

检查会明确列出缺失、被修改和额外出现的文件,不会安装或覆盖任何内容。安装器默认拒绝覆盖已有 Skill;确认替换前先运行 `--verify`,再添加 `--force`。旧目录会完整备份到 Agent 根目录下的 `.lzheng-fitness/backups/<时间>/`,不会留在活动 `skills/` 目录中。需要指定位置时使用 `--backup-root <目录>`;相对路径从 `--target-root` 解析,并且不能放在活动 `skills/` 目录内。

私人 Notion 获取器、账号配置或其他本机适配器不要放进公开 Skill 目录。建议放在 Agent 根目录下的 `.lzheng-fitness/private-adapters/`;安装器不会修改这里。若旧 Skill 内已有额外文件,`--force` 会把它们完整保留在外部备份中,但不会未经审查自动混入新版公开核心。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 178 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Lzheng Fitness Skills
  2. v3.5.0 的公开 HTML 模板已同步维护者当前工作台的背景与 UI:同一背景素材、透明深色界面、桌面侧栏及手机底栏。离线记录、备份和原有数据边界保留。参见[背景与界面说明](docs/Presentation.md)。
  3. 可独立下载、离线运行的个人健身 Agent Skills。v3.4.0 同步最新训练决策、力量周期规则和训练快照读取,同时保留视频学习、独立知识库、三餐规划和受保护升级,支持本机训练完成、训练日历与纠错恢复、餐食和照片保存、手动营养候选与确认入账。AI 计划与复盘需要支持 Skill 的 AI 助手;网页不自带照片识别模型。
  4. 提供个人资料或确认训练计划后,Agent 同轮主动更新工作台;部分字段或重量未知只在对应位置标待填写/待校准,不再阻塞整个真实计划。
  5. 本次更新将云端已记录逐组数据接入 HTML 的只读训练历史,保持草稿场次、实际动作和查询版本;新建工作台仍为空档案。参见[更新与训练记录同步](docs/Training-Snapshot-Sync.md)及[训练知识入口](knowledge/README.md)。更新 Skill、个人网页、公开源码和网站部署分别验收。
  6. 完整的阶段、用户输入、读取文件和产出契约见 [Markdown 文档](SYSTEM-FLOW.md);需要逐项浏览检查时打开 [HTML 检查版](SYSTEM-FLOW.html)。
  7. 第一次接触本地 Agent 或不会写代码,可以直接阅读 [新手小白搭建个人健身系统指南](BEGINNER-GUIDE.md)。它从准备电脑、让 AI 安装,到建档、第一次训练、日常复盘、换壁纸和迁移新电脑逐步说明。
  8. 需要把纯静态网站以零现金成本发布到 CloudBase,可阅读 [CloudBase 免费静态网站上线:Agent 新手教程](docs/CloudBase-Free-Static-Hosting-Beginner.md)。它不依赖 Notion 或本项目的个人数据,默认由 Agent 完成检查、上传、线上核验和回退。
  9. 公开包不含任何个人训练数据、账号信息或绝对路径。工作台使用仓库内置的项目视觉素材,离线安装时会把动态背景和静态兜底一起复制到新项目。
  10. ## 本轮新增:学习、工作台与升级
  11. - 对 Agent 说“学习我收藏里关于某主题的视频”,或直接给视频链接。支持不同主题,先确定范围,再分批准备来源、保存进度、失败重试;机器转写不等于用户学会。
  12. - 知识库支持作者、专题、来源视频、表格和本机学习反馈。默认空白,可选择导入[谭成义饮食学习示例](docs/KNOWLEDGE-EXAMPLE-REVIEW.md),示例不含使用者个人资料,也不会激活饮食计划。
  13. - 手机/桌面常驻饮食与知识入口、自然周日历、本机改期与顺延、三餐目标版本和菜单估算。顺延保留完整处方,未排期不记为休息或完成。
  14. - 文字或照片餐食可以导出给 Agent,导入与餐食版本匹配的分析候选,再由用户确认入账。可选 Codex 适配器支持用户说明、食品标签与图片;网页本身不内置模型。
  15. - 说“帮我升级健身系统,保留记录和壁纸”。Agent 按[升级说明](docs/UPGRADE.md)执行,保留原文件路径、训练数据、知识正文和背景,检查失败回滚;不自动部署网站。
  16. 主体包含 **12 个 MIT 自有 Skill**。另附原版 `dbs-learning` 可选交互学习组件,使用 **CC BY-NC 4.0**,不在主体 `--all` 内默认安装;仓颉使用 MIT,按需安装官方版本。请阅读[第三方许可](THIRD-PARTY-NOTICES.md)。非商业开源分享不意味着所有组件都可商用。
  17. 排期修改、学习反馈与长期偏好目前保存于本机;CloudBase 仍为可选适配。通用升级不复制任何维护者的云环境、账号或个人任务。实际抖音登录、验证码由用户完成;当前发行测试使用匿名来源夹具,不宣称所有收藏、账号或设备均已实测。
  18. ## 包含内容
  19. | Skill | 用途 | 可单独安装 |
  20. | --- | --- | --- |
  21. | `lzheng-fitness-plan` | 训练建档、安全筛查、完整计划与 HTML | 是 |
  22. | `lzheng-training-return` | 停训、漏练或条件变化后的接回 | 是 |
  23. | `lzheng-strength-cycle-planner` | 单个力量动作的 8—12 周周期 | 是 |
  24. | `lzheng-strength-training-review` | 单次、滚动、基准与周训练复盘 | 是 |
  25. | `lzheng-training-expert-library` | 六个来源限定专家模块、选择协议和验证状态 | 是;安装四个专业 Skill 时自动带上 |
  26. | `lzheng-nutrition-system` | 营养建档、日型宏量目标、餐食确认链与两周复盘契约 | 是 |
  27. | `lzheng-video-learning` | 收藏/指定视频来源核对、转写、批次恢复与交互学习衔接 | 是 |
  28. | `douyin-question-distiller` | 指定抖音视频的详细蒸馏和时间段证据检查 | 需 `lzheng-video-learning`;安装器自动带上 |
  29. | `lzheng-video-lessons` | 分段教学、解释视角讲解、播放器生成、知识库接入与发布核验 | 是 |
  30. | `lzheng-knowledge-library` | 多专题知识展示、来源回看与独立更新 | 是 |
  31. | `lzheng-training-system` | 新电脑初始化、迁移、诊断、升级保护和整套校验 | 与工作台构建器配套 |
  32. | `lzheng-fitness-workbench-builder` | 从计划、复盘和可选动态数据生成响应式离线工作台 | 与系统总控配套 |
  33. 计划、周期、复盘、接回与营养是专业能力;专家库是它们共同读取的内部知识层;系统总控与工作台构建器负责把结果收束为单一主源和可离线打开的页面。动态数据连接是可选输入,不要求任何云服务。
  34. 专家库包含 Alan Aragon、Brad Schoenfeld、Brukner 与 Khan、Dan John、Eric Helms 和 Greg Nuckols 六个完整蒸馏模块。每个模块带来源/版本边界、覆盖矩阵、判断框架、问题路由、知识卡、职责边界和真实验证状态;不含原书、文章快照或私人训练数据。安装任一计划、周期、复盘或接回 Skill 时,安装器会自动带上专家库。
  35. 所有单文件 HTML 都使用仓库内固定模板:完整计划、力量周期和健身工作台各有唯一页面结构与职责。AI 只能填写经过校验的计划或工作台数据,不能临时改导航、换视觉主题或手写另一套页面。
  36. 日常计划修改和训练复盘会先调用紧凑只读检查,只加载当前计划、执行基准和本次复盘等必要主源,不把整份大型工作台 HTML、历史目录或无关发布协议塞进 Agent 上下文。完整校验仍由脚本执行,因此节省上下文不会降低数据与页面结构检查。
  37. ## 安装
  38. 已有工作台侧栏缺失或更新后仍是旧界面时,直接让 AI:“检查并修复我的工作台侧栏,保留记录和壁纸。”新版提供独立界面升级通道;更新 Skill 与刷新数据不会自动替换旧 HTML。支持的官方旧版经过识别、备份、同路径替换与浏览器验证后才报告界面升级成功。未知自定义会明确停止并给出差异。[升级方法与恢复边界](skills/lzheng-fitness-workbench-builder/references/ui-upgrade.md)。
  39. 界面升级的实际写入阶段另需 Node.js、Playwright 与 Chromium,用于真实页面验收;日常使用和只读检查不增加这项依赖。
  40. 需要 Python 3.10 或更新版本;不需要第三方 Python 包。
  41. ```bash
  42. python tools/install.py --platform codex --all
  43. ```
  44. 也可安装到隔离目录,便于验证:
  45. ```bash
  46. python tools/install.py --target-root ./test-agent --all
  47. ```
  48. 每次安装都会在复制前后核对完整文件清单和 SHA-256,并把结果记录到 Agent 根目录下的 `.lzheng-fitness/install-state.json`。可以随时只读检查当前安装是否与这份仓库一致:
  49. ```bash
  50. python tools/install.py --platform codex --all --verify
  51. python tools/install.py --target-root ./test-agent --all --verify
  52. ```
  53. 检查会明确列出缺失、被修改和额外出现的文件,不会安装或覆盖任何内容。安装器默认拒绝覆盖已有 Skill;确认替换前先运行 `--verify`,再添加 `--force`。旧目录会完整备份到 Agent 根目录下的 `.lzheng-fitness/backups/<时间>/`,不会留在活动 `skills/` 目录中。需要指定位置时使用 `--backup-root <目录>`;相对路径从 `--target-root` 解析,并且不能放在活动 `skills/` 目录内。
  54. 私人 Notion 获取器、账号配置或其他本机适配器不要放进公开 Skill 目录。建议放在 Agent 根目录下的 `.lzheng-fitness/private-adapters/`;安装器不会修改这里。若旧 Skill 内已有额外文件,`--force` 会把它们完整保留在外部备份中,但不会未经审查自动混入新版公开核心。
  55. ## 安装后直接开始
  56. 不要先阅读 README 或寻找命令。新开一个 AI 对话后,只需说:
  57. ```text
  58. 开始建立我的健身系统。
  59. ```
  60. AI 会先问你想增肌、减脂、提升力量还是综合改善;再完成建档、动作重量校准、正式计划、工作台和后续复盘。没有训练记录时,AI 会逐步指导你为每个动作选出安全的工作重量,不会要求你自行猜测。
  61. ## 新电脑快速验证
  62. 完成安装后,在一个新的空文件夹运行:
  63. ```bash
  64. python <skills目录>/lzheng-training-system/scripts/lzheng_training_system.py bootstrap --target "<空目录>"
  65. python <skills目录>/lzheng-training-system/scripts/lzheng_training_system.py doctor --root "<空目录>"
  66. ```
  67. `bootstrap` 会生成匿名示例工作台、示例计划、复盘索引和全部本地界面资源。它不会生成真实重量;完成建档与动作重量校准后,AI 会接入正式计划并把下一次明确处方写回工作台。
  68. 可直接打开新目录中的 `个人训练系统/健身工作台.html`。页面支持桌面、平板和手机,不依赖在线资源。
  69. 工作台中的“完整训练计划”由按钮直接打开,不要求用户填写路径,也不要求目录是 Obsidian 仓库。复盘、复盘索引和状态档案可以直接在工作台中阅读;安装 Obsidian 后才会额外显示可选编辑入口。整套目录复制、移动或改名后,系统会以当前位置解析文件并自动迁移旧配置。
  70. 初始化后,正式产物优先收进同一个健身知识库:完整计划位于 `个人训练系统/训练与周期/当前周期`,专项力量周期位于 `个人训练系统/训练与周期/力量周期`,复盘位于 `个人训练系统/训练复盘与状态/训练复盘`,状态快照和接回卡位于 `个人训练系统/训练复盘与状态/状态档案`,营养契约位于 `个人训练系统/工作台与工具/饮食工作台`。临时渲染和备份不进入这些目录。
  71. ## 替换工作台壁纸
  72. 已经生成工作台后,可以直接交给 AI 一张图片,或一张图片加一个 MP4。脚本会备份原壁纸、更新页面、自动检查,失败时恢复原版本。
  73. 纯静态背景:
  74. ```bash
  75. python <skills目录>/lzheng-fitness-workbench-builder/scripts/Replace-FitnessWorkbenchBackground.py --project "<个人训练系统目录>" --image "<新壁纸.png>"
  76. ```
  77. 动态背景:
  78. ```bash
  79. python <skills目录>/lzheng-fitness-workbench-builder/scripts/Replace-FitnessWorkbenchBackground.py --project "<个人训练系统目录>" --image "<静态兜底.png>" --video "<动态背景.mp4>"
  80. ```
  81. 只传图片时会关闭旧视频。完整参数、桌面/手机取景和首次初始化用法见 [壁纸替换指南](skills/lzheng-fitness-workbench-builder/references/background-replacement.md)。
  82. ## 使用示例
  83. ```text
  84. 使用 $lzheng-fitness-plan 根据我的目标、近期训练、每周时间和器械条件制定计划。
  85. 使用 $lzheng-strength-cycle-planner 为卧推制定 8 周周期。
  86. 使用 $lzheng-strength-training-review 复盘我今天的训练并给出下一次处方。
  87. 使用 $lzheng-training-expert-library 检查这个问题应读取哪一个来源限定专家模块。
  88. 使用 $lzheng-nutrition-system 根据我的目标、训练日型和饮食环境建立营养起点。
  89. 使用 $lzheng-training-system 帮我在新电脑建立、检查并迁移整个训练系统。
  90. 使用 $lzheng-fitness-workbench-builder 根据我的当前计划和复盘搭建离线健身工作台。
  91. ```
  92. ## 发布前验证
  93. ```bash
  94. python tools/validate_bundle.py
  95. ```
  96. 验证会检查全部 Skill 的元数据、链接、隐私残留和脚本语法,另外核验六个专家模块与营养契约的来源边界、路由、安全分流和匿名默认值;随后渲染 HTML,校验工作台的训练档案、图片、视频、内置文档和计划入口,并在临时目录中完成初始化、改名移动、旧配置迁移、无 Obsidian 发布和故障拦截。
  97. GitHub 自动检查同时运行 Linux 和 Windows 两组任务。两组都检查全部 Skill、隐私、匿名模板、数据库契约、渲染与安装迁移;Windows 组额外实际运行本地 Agent 的安全和并发测试。Linux 明确跳过这些 Windows 专用进程测试,不要求安装 Windows PowerShell;Windows 缺少 PowerShell 或任何一项测试失败仍会阻止检查通过。
  98. ## 本地记录与可选同步
  99. 工作台默认本地运行,不要求登录:完成训练后,逐组实际值和原计划快照进入当前浏览器的 IndexedDB;训练日历可查看肌群工作组统计、纠错和恢复上个版本,不改写原计划。训练未完成时只保留草稿,不计入已完成训练。
  100. 餐食可只写名称和说明,也可保存用户明确选择的照片。未填写营养数值时标记为“未识别”;可以根据标签、自己的估算或外部 AI 结果填写带来源说明的候选,单独确认后才计入合计。饭后情况与实际摄入候选独立保存,餐前估算保留;可撤销入账。不联网、不自动识别、不伪造模型结果。
  101. 浏览器数据不会自动写回 HTML 或跨设备同步。清理站点数据、无痕窗口关闭、浏览器更换或文件位置变化可能导致记录不可访问。请在“指南”导出**本地记录备份**,它包含本机正式训练、餐食和照片;只能导入空的本地记录库,避免覆盖已有数据。此备份不包含云端记录及旧版体重、有氧、体感资料。详细边界见 [离线记录与备份](docs/Offline-Records.md)。备份含私人数据,不能上传开源仓库。
  102. 需要自行部署同步时,阅读 [可选 CloudBase 适配器](integrations/cloudbase/README.md) 和 [一次运行手册](docs/CloudBase-Agent-Runbook.md),先复制其匿名配置示例到仓库外。默认仍为 `local`,CloudBase 与本地 Agent 都是 disabled。网页只在用户点击刷新后读取一次已知任务状态,不做后台轮询。Windows 可选协议也只能触发一次 `-Once` 运行;诊断监听仍有 10 分钟和连续 3 次空队列/失败的硬上限。
  103. 已启用云端但连接失败时,正式云端写入仍会报错,不会悄悄改成另一套本地正式记录。v3.1.1 新增的本机正式训练、餐食和照片不会因登录而自动上传;迁移这些记录和配置私有模型适配需另行明确验收。此前的体重、有氧、体感等可选同步行为不因此改变。
  104. 开发者可额外运行 `npm ci`、`npx playwright install chromium` 和 `npm test`,验证真实浏览器中的本地保存、照片持久化、确认与撤销、事务失败、备份恢复和手机布局。Node.js 与 Playwright 仅用于开发验证,不是用户运行工作台的依赖。
  105. ## 边界
  106. 本项目提供一般训练规划与记录支持,不是医疗诊断或康复建议。出现胸部不适、晕厥、异常气短、锐痛、麻木、放射痛、明显功能受限或症状持续加重时,应停止常规高强度训练并寻求专业评估。
  107. 训练知识来源见 [来源登记](knowledge/06-lzheng-source-register.md)。素材使用说明见 [ASSET-NOTICE.md](ASSET-NOTICE.md)。
  108. ## License
  109. MIT © 2026 Lzheng
  110. 分段课程使用 [lzheng-video-lessons](skills/lzheng-video-lessons/SKILL.md):读取视频 → 核对起止点 → 编号详细讲解 → 生成课程 → 接入知识库 → 按授权发布与线上核验。媒体留在用户 workspace,开源包只含虚构示例。
  111. 指定视频的详细蒸馏使用 [douyin-question-distiller](skills/douyin-question-distiller/SKILL.md):来源工具准备带时间段的转写,Agent 核对原声与画面后撰写报告,脚本检查报告结构和来源版本。安装器会同时安装 `lzheng-video-learning`;账号登录、视频和报告留在使用者自己的 workspace。
skills/lzheng-fitness-workbench-builder/scripts/Prepare-FitnessWorkbenchEncryptedRelease.py · Bundled script · 390 lines · 1 finding marked
  1. #!/usr/bin/env python3
  2. # -*- coding: utf-8 -*-
  3. """Build a password-encrypted, static-hosting-safe private workbench release.
  4. The source must be a checked ``private-portable`` schema-2 release. Personal
  5. HTML and every referenced local asset are first collapsed into one HTML byte
  6. stream, then encrypted with PBKDF2-HMAC-SHA256 + AES-256-GCM. CloudBase only
  7. receives a public login shell, ciphertext, and a non-sensitive manifest.
  8. The passphrase is never accepted on the command line. ``--initialize-secret``
  9. opens a local masked GUI and stores the passphrase with Windows DPAPI outside
  10. the project. Normal Agent runs can reuse that DPAPI-protected secret without
  11. printing it or writing it to a receipt.
  12. """
  13. from __future__ import annotations
  14. import argparse
  15. import base64
  16. import ctypes
  17. import hashlib
  18. import json
  19. import mimetypes
  20. import os
  21. import re
  22. import secrets
  23. import shutil
  24. import sys
  25. import tempfile
  26. from ctypes import wintypes
  27. from pathlib import Path, PurePosixPath
  28. from typing import Any
  29. from urllib.parse import quote
  30. from cryptography.hazmat.primitives import hashes
  31. from cryptography.hazmat.primitives.ciphers.aead import AESGCM
  32. from cryptography.hazmat.primitives.kdf.pbkdf2 import PBKDF2HMAC
  33. SCRIPT_VERSION = "1.0.0"
  34. SOURCE_SCHEMA = 2
  35. SOURCE_KIND = "lzheng-fitness-workbench-release"
  36. SOURCE_PRODUCER = "Prepare-FitnessWorkbenchRelease.py"
  37. OUTPUT_SCHEMA = 1
  38. OUTPUT_KIND = "lzheng-fitness-workbench-encrypted-release"
  39. OUTPUT_PRODUCER = "Prepare-FitnessWorkbenchEncryptedRelease.py"
  40. PAYLOAD_NAME = "private-payload.json"
  41. MANIFEST_NAME = "release-manifest.json"
  42. ITERATIONS = 600_000
  43. AAD = b"lzheng-fitness-workbench-private-v1"
  44. DPAPI_ENTROPY = b"lzheng-fitness-workbench-dpapi-v1"
  45. PRIVATE_MARKERS = ("obsidian://", "notion://", "E:\\obsidian", "C:\\Users\\", "/Users/", "/home/")
  46. class ReleaseError(RuntimeError):
  47. pass
  48. class DATA_BLOB(ctypes.Structure):
  49. _fields_ = [("cbData", wintypes.DWORD), ("pbData", ctypes.POINTER(ctypes.c_ubyte))]
  50. def sha256_bytes(value: bytes) -> str:
  51. return hashlib.sha256(value).hexdigest()
  52. def sha256_file(path: Path) -> str:
  53. digest = hashlib.sha256()
  54. with path.open("rb") as handle:
  55. for chunk in iter(lambda: handle.read(1024 * 1024), b""):
  56. digest.update(chunk)
  57. return digest.hexdigest()
  58. def default_secret_file() -> Path:
  59. base = Path(os.environ.get("LOCALAPPDATA") or Path.home() / "AppData" / "Local")
  60. return base / "LzhengFitness" / "cloudbase-private.secret.json"
  61. def _blob(value: bytes) -> tuple[DATA_BLOB, Any]:
  62. buffer = (ctypes.c_ubyte * len(value)).from_buffer_copy(value)
  63. return DATA_BLOB(len(value), ctypes.cast(buffer, ctypes.POINTER(ctypes.c_ubyte))), buffer
  64. def _dpapi_libraries() -> tuple[Any, Any]:
  65. crypt32 = ctypes.windll.crypt32
  66. kernel32 = ctypes.windll.kernel32
  67. crypt32.CryptProtectData.argtypes = [ctypes.POINTER(DATA_BLOB), ctypes.c_wchar_p, ctypes.POINTER(DATA_BLOB), ctypes.c_void_p, ctypes.c_void_p, wintypes.DWORD, ctypes.POINTER(DATA_BLOB)]
  68. crypt32.CryptProtectData.restype = wintypes.BOOL
  69. crypt32.CryptUnprotectData.argtypes = [ctypes.POINTER(DATA_BLOB), ctypes.c_void_p, ctypes.POINTER(DATA_BLOB), ctypes.c_void_p, ctypes.c_void_p, wintypes.DWORD, ctypes.POINTER(DATA_BLOB)]
  70. crypt32.CryptUnprotectData.restype = wintypes.BOOL
  71. kernel32.LocalFree.argtypes = [ctypes.c_void_p]
  72. kernel32.LocalFree.restype = ctypes.c_void_p
  73. return crypt32, kernel32
  74. def dpapi_protect(value: bytes) -> bytes:
  75. if os.name != "nt":
  76. raise ReleaseError("私人发布密钥只允许存入 Windows DPAPI")
  77. crypt32, kernel32 = _dpapi_libraries()
  78. source, source_buffer = _blob(value)
  79. entropy, entropy_buffer = _blob(DPAPI_ENTROPY)
  80. output = DATA_BLOB()
  81. if not crypt32.CryptProtectData(ctypes.byref(source), "Lzheng Fitness", ctypes.byref(entropy), None, None, 0x1, ctypes.byref(output)):
  82. raise ReleaseError("Windows DPAPI 无法保护私人发布密钥")
  83. try:
  84. return ctypes.string_at(output.pbData, output.cbData)
  85. finally:
  86. kernel32.LocalFree(ctypes.cast(output.pbData, ctypes.c_void_p))
  87. del source_buffer, entropy_buffer
  88. def dpapi_unprotect(value: bytes) -> bytes:
  89. if os.name != "nt":
  90. raise ReleaseError("私人发布密钥只允许从 Windows DPAPI 读取")
  91. crypt32, kernel32 = _dpapi_libraries()
  92. source, source_buffer = _blob(value)
  93. entropy, entropy_buffer = _blob(DPAPI_ENTROPY)
  94. output = DATA_BLOB()
  95. if not crypt32.CryptUnprotectData(ctypes.byref(source), None, ctypes.byref(entropy), None, None, 0x1, ctypes.byref(output)):
  96. raise ReleaseError("Windows DPAPI 无法解密私人发布密钥;请使用创建它的 Windows 用户")
  97. try:
  98. return ctypes.string_at(output.pbData, output.cbData)
  99. finally:
  100. kernel32.LocalFree(ctypes.cast(output.pbData, ctypes.c_void_p))
  101. del source_buffer, entropy_buffer
  102. def strong_passphrase(value: str) -> bool:
  103. if len(value) < 24 or len(value) > 256:
  104. return False
  105. classes = sum(bool(re.search(pattern, value)) for pattern in (r"[a-z]", r"[A-Z]", r"\d", r"[^A-Za-z0-9]"))
  106. return classes == 4
  107. def initialize_secret(path: Path, rotate: bool = False) -> None:
  108. if path.exists() and not rotate:
  109. raise ReleaseError("私人发布密钥已经存在;为避免旧网站失效,本工具拒绝静默覆盖")
  110. try:
  111. import tkinter as tk
  112. from tkinter import messagebox, simpledialog
  113. except ImportError as exc:
  114. raise ReleaseError("当前 Python 缺少本地安全输入窗口") from exc
  115. root = tk.Tk()
  116. root.withdraw()
  117. try:
  118. first = simpledialog.askstring("健身工作台私有密码", "请粘贴密码管理器生成的唯一随机密码(至少24位,含大小写字母、数字和符号):", show="*", parent=root)
  119. if first is None:
  120. raise ReleaseError("用户取消了私人密码初始化")
  121. second = simpledialog.askstring("确认私有密码", "请再次输入同一个密码:", show="*", parent=root)
  122. if first != second:
  123. raise ReleaseError("两次输入的密码不一致")
  124. if not strong_passphrase(first):
  125. raise ReleaseError("密码强度不足:至少24位,并同时包含大小写字母、数字和符号")
  126. if not messagebox.askyesno("确认高熵密码", "请确认:这是密码管理器生成、仅用于本网站且已安全保存的随机密码。", parent=root):
  127. raise ReleaseError("用户未确认使用密码管理器生成的唯一随机密码")
  128. protected = dpapi_protect(first.encode("utf-8"))
  129. payload = {"schema": 1, "kind": "lzheng_fitness_workbench_private_secret", "protection": "windows-dpapi-current-user", "high_entropy_acknowledged": True, "ciphertext": base64.b64encode(protected).decode("ascii")}
  130. path.parent.mkdir(parents=True, exist_ok=True)
  131. staging = path.with_name("." + path.name + ".tmp")
  132. staging.write_text(json.dumps(payload, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
  133. os.replace(staging, path)
  134. messagebox.showinfo("初始化完成", "私人密码已保存到当前 Windows 用户的加密区。请牢记该密码,打开网站时需要输入。", parent=root)
  135. finally:
  136. root.destroy()
  137. def load_secret(path: Path) -> str:
  138. try:
  139. payload = json.loads(path.read_text(encoding="utf-8-sig"))
  140. protected = base64.b64decode(payload["ciphertext"], validate=True)
  141. except (OSError, KeyError, ValueError, json.JSONDecodeError) as exc:
  142. raise ReleaseError("私人发布密钥不存在或格式损坏;请先执行 --initialize-secret") from exc
  143. if payload.get("schema") != 1 or payload.get("kind") != "lzheng_fitness_workbench_private_secret" or payload.get("high_entropy_acknowledged") is not True:
  144. raise ReleaseError("私人发布密钥格式不受支持")
  145. try:
  146. value = dpapi_unprotect(protected).decode("utf-8")
  147. except UnicodeDecodeError as exc:
  148. raise ReleaseError("私人发布密钥解码失败") from exc
  149. if not strong_passphrase(value):
  150. raise ReleaseError("私人发布密钥未达到当前强度要求")
  151. return value
  152. def safe_rel(value: Any) -> str | None:
  153. if not isinstance(value, str) or not value or "\\" in value:
  154. return None
  155. rel = PurePosixPath(value)
  156. if rel.is_absolute() or ".." in rel.parts or "." in rel.parts:
  157. return None
  158. return rel.as_posix()
  159. def validate_source(root: Path) -> dict[str, Any]:
  160. manifest_path = root / MANIFEST_NAME
  161. if not root.is_dir() or not manifest_path.is_file():
  162. raise ReleaseError("私人源发布目录不存在或缺少 release-manifest.json")
  163. try:
  164. manifest = json.loads(manifest_path.read_text(encoding="utf-8-sig"))
  165. except (OSError, json.JSONDecodeError) as exc:
  166. raise ReleaseError("私人源发布 manifest 无法解析") from exc
  167. if (manifest.get("schema"), manifest.get("kind"), manifest.get("producer")) != (SOURCE_SCHEMA, SOURCE_KIND, SOURCE_PRODUCER):
  168. raise ReleaseError("只接受受管 schema-2 私人发布副本")
  169. if manifest.get("release_mode") != "private-portable" or manifest.get("contains_personal_data") is not True or manifest.get("required_access") != "private-authenticated":
  170. raise ReleaseError("源发布副本没有声明 private-portable 私人访问边界")
  171. allowed = [safe_rel(item) for item in manifest.get("allowed_files", [])]
  172. if any(item is None for item in allowed) or len(allowed) != len(set(allowed)):
  173. raise ReleaseError("私人源 manifest allowed_files 无效")
  174. actual = {path.relative_to(root).as_posix(): path for path in root.rglob("*") if path.is_file()}
  175. if set(allowed) != set(actual):
  176. raise ReleaseError("私人源发布树与 manifest allowed_files 不一致")
  177. entries = manifest.get("files")
  178. if not isinstance(entries, list):
  179. raise ReleaseError("私人源 manifest 缺少文件哈希")
  180. by_path = {entry.get("path"): entry for entry in entries if isinstance(entry, dict)}
  181. if set(by_path) != set(allowed) - {MANIFEST_NAME}:
  182. raise ReleaseError("私人源 manifest 文件哈希列表不完整")
  183. for rel, entry in by_path.items():
  184. path = actual[rel]
  185. if entry.get("sha256") != sha256_file(path) or entry.get("bytes") != path.stat().st_size:
  186. raise ReleaseError("私人源文件哈希不一致: " + rel)
  187. return manifest
  188. def data_uri(path: Path) -> str:
  189. mime = mimetypes.guess_type(path.name)[0] or "application/octet-stream"
  190. return f"data:{mime};base64," + base64.b64encode(path.read_bytes()).decode("ascii")
  191. def inline_private_html(root: Path, manifest: dict[str, Any]) -> bytes:
  192. index = root / "index.html"
  193. html = index.read_text(encoding="utf-8-sig")
  194. for rel in manifest["allowed_files"]:
  195. if rel in {"index.html", MANIFEST_NAME}:
  196. continue
  197. references = tuple(dict.fromkeys((rel, quote(rel, safe="/"))))
  198. count = sum(html.count(reference) for reference in references)
  199. if count == 0:
  200. raise ReleaseError("私人源包含未被 index.html 引用的文件: " + rel)
  201. uri = data_uri(root / PurePosixPath(rel))
  202. for reference in references:
  203. html = html.replace(reference, uri)
  204. for rel in manifest["allowed_files"]:
  205. if rel not in {"index.html", MANIFEST_NAME}:
  206. references = (rel, quote(rel, safe="/"))
  207. if any(reference in html for reference in references):
  208. raise ReleaseError("私人单文件仍残留本地资源引用: " + rel)
  209. return html.encode("utf-8")
  210. def derive_key(passphrase: str, salt: bytes) -> bytes:
  211. kdf = PBKDF2HMAC(algorithm=hashes.SHA256(), length=32, salt=salt, iterations=ITERATIONS)
  212. return kdf.derive(passphrase.encode("utf-8"))
  213. def launcher_html(title: str = "个人健身工作台") -> str:
  214. title_json = json.dumps(title, ensure_ascii=False)
  215. return r'''<!doctype html>
  216. <html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
  217. <meta name="robots" content="noindex,nofollow,noarchive"><title>__TITLE__ · 私人访问</title>
  218. <style>:root{color-scheme:dark}*{box-sizing:border-box}body{margin:0;min-height:100vh;display:grid;place-items:center;background:#090d16;color:#edf3ff;font-family:system-ui,-apple-system,"Microsoft YaHei",sans-serif}.card{width:min(92vw,420px);padding:32px;border:1px solid #26334d;border-radius:22px;background:rgba(18,26,43,.96);box-shadow:0 24px 80px #0008}h1{margin:0 0 10px;font-size:25px}p{color:#9fb0c9;line-height:1.65}label{display:block;margin:22px 0 8px}input,button{width:100%;height:48px;border-radius:12px;font-size:16px}input{padding:0 14px;color:#fff;background:#0b1220;border:1px solid #40506c}button{margin-top:14px;border:0;background:#2f68ff;color:#fff;font-weight:700;cursor:pointer}button:disabled{opacity:.6;cursor:wait}.status{min-height:24px;margin-top:14px;color:#ffb4a8}.hint{font-size:13px}iframe{position:fixed;inset:0;width:100%;height:100%;border:0;background:#fff}</style></head>
  219. <body><main class="card"><h1>__TITLE__</h1><p>这是加密的私人工作台。密码只在本机浏览器中用于解密,不会发送到网站。</p><label for="password">私人访问密码</label><input id="password" type="password" autocomplete="current-password" minlength="16"><button id="open">解密并打开</button><div id="status" class="status" role="status"></div><p class="hint">忘记密码时,云端内容无法恢复;请回到已授权电脑重新发布。</p></main>
  220. <script>
  221. const te=new TextEncoder(),td=new TextDecoder();
  222. const b64=s=>Uint8Array.from(atob(s),c=>c.charCodeAt(0));
  223. async function openWorkbench(){
  224. const button=document.getElementById('open'),input=document.getElementById('password'),status=document.getElementById('status');
  225. if(input.value.length<16){status.textContent='密码至少需要16位。';return}
  226. button.disabled=true;status.textContent='正在校验和解密…';
  227. try{
  228. const response=await fetch('private-payload.json',{cache:'no-store'});if(!response.ok)throw new Error('PAYLOAD');
  229. const p=await response.json();if(p.schema!==1||p.kind!=='lzheng_fitness_workbench_encrypted_payload')throw new Error('FORMAT');
  230. const material=await crypto.subtle.importKey('raw',te.encode(input.value),'PBKDF2',false,['deriveKey']);
  231. const key=await crypto.subtle.deriveKey({name:'PBKDF2',hash:'SHA-256',salt:b64(p.salt),iterations:p.iterations},material,{name:'AES-GCM',length:256},false,['decrypt']);
  232. const plain=await crypto.subtle.decrypt({name:'AES-GCM',iv:b64(p.nonce),additionalData:te.encode(p.aad)},key,b64(p.ciphertext));
  233. input.value='';const frame=document.createElement('iframe');frame.setAttribute('title',__TITLE_JSON__);frame.srcdoc=td.decode(plain);document.body.replaceChildren(frame);
  234. }catch(error){status.textContent='密码错误,或发布内容已损坏。';button.disabled=false;input.focus()}
  235. }
  236. document.getElementById('open').addEventListener('click',openWorkbench);document.getElementById('password').addEventListener('keydown',event=>{if(event.key==='Enter')openWorkbench()});
  237. </script></body></html>'''.replace("__TITLE__", title).replace("__TITLE_JSON__", title_json)
  238. def tree_files(root: Path) -> list[dict[str, Any]]:
  239. return [{"path": path.relative_to(root).as_posix(), "bytes": path.stat().st_size, "sha256": sha256_file(path)} for path in sorted((item for item in root.rglob("*") if item.is_file()), key=lambda item: item.as_posix())]
  240. def promote(staging: Path, output: Path) -> None:
  241. previous = output.with_name("." + output.name + ".previous")
  242. if previous.exists():
  243. raise ReleaseError("加密发布目录旁存在未处理的 previous 目录,拒绝覆盖")
  244. if output.exists():
  245. try:
  246. old = json.loads((output / MANIFEST_NAME).read_text(encoding="utf-8-sig"))
  247. except (OSError, json.JSONDecodeError) as exc:
  248. raise ReleaseError("目标目录不是受管加密发布目录,拒绝覆盖") from exc
  249. if old.get("kind") != OUTPUT_KIND:
  250. raise ReleaseError("目标目录不是受管加密发布目录,拒绝覆盖")
  251. os.replace(output, previous)
  252. try:
  253. os.replace(staging, output)
  254. if previous.exists():
  255. shutil.rmtree(previous)
  256. except Exception:
  257. if not output.exists() and previous.exists():
  258. os.replace(previous, output)
  259. raise
  260. def build(source: Path, output: Path, secret_file: Path) -> dict[str, Any]:
  261. source = source.resolve()
  262. output = output.expanduser().absolute().resolve()
  263. if source == output or source in output.parents or output in source.parents:
  264. raise ReleaseError("私人源目录与加密输出目录不得重叠")
  265. manifest = validate_source(source)
  266. passphrase = load_secret(secret_file)
  267. private_html = inline_private_html(source, manifest)
  268. salt, nonce = secrets.token_bytes(16), secrets.token_bytes(12)
  269. ciphertext = AESGCM(derive_key(passphrase, salt)).encrypt(nonce, private_html, AAD)
    • Dismissed after review: Encrypts files across folders and removes the originals, as ransomware does
    • Line 317 on GitHub
  270. # Immediate cryptographic round-trip: a release is never promoted on a
  271. # merely successful encrypt() call.
  272. if AESGCM(derive_key(passphrase, salt)).decrypt(nonce, ciphertext, AAD) != private_html:
  273. raise ReleaseError("加密发布回读校验失败")
  274. parent = output.parent
  275. parent.mkdir(parents=True, exist_ok=True)
  276. staging = Path(tempfile.mkdtemp(prefix="." + output.name + ".candidate-", dir=parent))
  277. try:
  278. payload = {"schema": 1, "kind": "lzheng_fitness_workbench_encrypted_payload", "crypto": "AES-256-GCM", "kdf": "PBKDF2-HMAC-SHA256", "iterations": ITERATIONS, "salt": base64.b64encode(salt).decode("ascii"), "nonce": base64.b64encode(nonce).decode("ascii"), "aad": AAD.decode("ascii"), "ciphertext": base64.b64encode(ciphertext).decode("ascii")}
  279. (staging / "index.html").write_text(launcher_html(), encoding="utf-8")
  280. (staging / PAYLOAD_NAME).write_text(json.dumps(payload, ensure_ascii=False, separators=(",", ":")), encoding="utf-8")
  281. source_files = tree_files(source)
  282. source_tree = sha256_bytes(json.dumps(source_files, ensure_ascii=False, separators=(",", ":"), sort_keys=True).encode("utf-8"))
  283. output_manifest = {"schema": OUTPUT_SCHEMA, "kind": OUTPUT_KIND, "producer": OUTPUT_PRODUCER, "producer_version": SCRIPT_VERSION, "release_mode": "private-encrypted", "contains_personal_data": True, "personal_data_encrypted": True, "required_access": "strong-passphrase", "entrypoint": "index.html", "allowed_files": ["index.html", PAYLOAD_NAME, MANIFEST_NAME], "source_release": {"mode": "private-portable", "manifest_sha256": sha256_file(source / MANIFEST_NAME), "tree_sha256": source_tree}, "crypto": {"name": "AES-256-GCM", "kdf": "PBKDF2-HMAC-SHA256", "iterations": ITERATIONS, "salt_bytes": 16, "nonce_bytes": 12}, "files": tree_files(staging)}
  284. (staging / MANIFEST_NAME).write_text(json.dumps(output_manifest, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
  285. public_text = (staging / "index.html").read_text(encoding="utf-8") + (staging / PAYLOAD_NAME).read_text(encoding="utf-8") + (staging / MANIFEST_NAME).read_text(encoding="utf-8")
  286. if any(marker.lower() in public_text.lower() for marker in PRIVATE_MARKERS):
  287. raise ReleaseError("加密发布明文文件仍包含私人路径或深链")
  288. promote(staging, output)
  289. except Exception:
  290. if staging.exists():
  291. shutil.rmtree(staging)
  292. raise
  293. return {"status": "PASS", "release_dir": str(output), "mode": "private-encrypted", "files": [entry["path"] for entry in tree_files(output)], "manifest_sha256": sha256_file(output / MANIFEST_NAME), "payload_sha256": sha256_file(output / PAYLOAD_NAME), "plaintext_bytes": len(private_html), "ciphertext_bytes": len(ciphertext), "secret_storage": "windows-dpapi-current-user"}
  294. def main(argv: list[str] | None = None) -> int:
  295. parser = argparse.ArgumentParser(description="Prepare a password-encrypted private workbench release")
  296. parser.add_argument("--private-release")
  297. parser.add_argument("--out")
  298. parser.add_argument("--secret-file", default=str(default_secret_file()))
  299. parser.add_argument("--receipt", help="可选的项目外非敏感加密发布回执")
  300. parser.add_argument("--initialize-secret", action="store_true")
  301. parser.add_argument("--rotate-secret", action="store_true")
  302. args = parser.parse_args(argv)
  303. secret_file = Path(args.secret_file).expanduser().absolute()
  304. receipt_path = Path(args.receipt).expanduser().absolute() if args.receipt else None
  305. result: dict[str, Any]
  306. try:
  307. if args.initialize_secret or args.rotate_secret:
  308. if args.private_release or args.out:
  309. raise ReleaseError("密钥初始化或轮换必须单独执行")
  310. if args.initialize_secret and args.rotate_secret:
  311. raise ReleaseError("--initialize-secret 与 --rotate-secret 不能同时使用")
  312. initialize_secret(secret_file, rotate=args.rotate_secret)
  313. result = {"status": "PASS", "secret_initialized": True, "secret_rotated": bool(args.rotate_secret), "protection": "windows-dpapi-current-user", "high_entropy_acknowledged": True}
  314. print(json.dumps(result, ensure_ascii=False))
  315. return 0
  316. if not args.private_release or not args.out:
  317. raise ReleaseError("生成加密发布必须同时指定 --private-release 与 --out")
  318. result = build(Path(args.private_release), Path(args.out), secret_file)
  319. if receipt_path:
  320. receipt_path.parent.mkdir(parents=True, exist_ok=True)
  321. receipt_payload = {"schema": 1, "kind": "lzheng_fitness_workbench_encrypted_release_receipt", "claims": {"formal_refreshed": False, "release_prepared": True, "deployed": False, "online_verified": False}, "result": result}
  322. staging = receipt_path.with_name("." + receipt_path.name + ".tmp")
  323. staging.write_text(json.dumps(receipt_payload, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
  324. os.replace(staging, receipt_path)
  325. print(json.dumps(result, ensure_ascii=False))
  326. return 0
  327. except (ReleaseError, OSError, ValueError) as exc:
  328. result = {"status": "FAIL", "error": str(exc)}
  329. if receipt_path:
  330. try:
  331. receipt_path.parent.mkdir(parents=True, exist_ok=True)
  332. receipt_path.write_text(json.dumps({"schema": 1, "kind": "lzheng_fitness_workbench_encrypted_release_receipt", "claims": {"formal_refreshed": False, "release_prepared": False, "deployed": False, "online_verified": False}, "result": result}, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
  333. except OSError:
  334. pass
  335. print(json.dumps(result, ensure_ascii=False), file=sys.stderr)
  336. return 1
  337. if __name__ == "__main__":
  338. raise SystemExit(main())

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.