prototype

Author: clzoc

CONTRIBUTING.md

@@ -0,0 +1,61 @@
+# Contribution Guidelines
+
+## Development Setup
+
+### Prerequisites
+- Xcode 15+ with command line tools
+- Homebrew (for dependency management)
+- Swift 5.9+
+
+### Environment Configuration
+```bash
+# Install build dependencies
+brew install swiftlint sourcery
+
+# Clone repository
+git clone https://github.com/yourusername/power-suite.git
+cd power-suite
+
+# Install pre-commit hooks
+swiftlint install-hook
+```
+
+## Workflow
+
+1. Create feature branch from `main`
+```bash
+git checkout -b feat/new-power-metric
+```
+
+2. Implement changes following Swift style guide
+```bash
+swiftlint autocorrect # Before committing
+```
+
+3. Update documentation when adding new features
+
+4. Create pull request with:
+- Description of changes
+- Screenshots for UI changes
+- Updated unit tests
+
+## Code Standards
+
+### Swift
+- Follow Apple's Swift API Design Guidelines
+- Use SwiftLint with included .swiftlint.yml
+- Document public APIs using DocC format
+
+### C Code
+- Follow Linux kernel coding style for CLI tools
+- Include Doxygen comments for complex functions
+
+## Testing Requirements
+- 80%+ test coverage for core modules
+- Performance tests for battery monitoring
+- UI tests for power flow visualization
+
+## Review Process
+- All PRs require 2 maintainer approvals
+- CI must pass SwiftPM tests and lint checks
+- Security-sensitive code requires audit

LICENSE

@@ -0,0 +1,90 @@
+# Power Management Suite
+
+[![Swift](https://img.shields.io/badge/Swift-5.9-orange.svg)]()
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+
+A comprehensive power monitoring solution for macOS featuring:
+
+- 🖥 GUI application with real-time power flow visualization
+- 🔋 Detailed battery health analytics
+- ⚡️ CLI tools for low-level power monitoring
+- 📊 System load statistics collection
+
+![](image/capture0.png)
+![](image/capture1.png)
+
+## Architecture Overview
+
+```mermaid
+graph TD
+    A[Power Management Suite] --> B{GUI Application}
+    A --> C{CLI Tools}
+    
+    B --> D[PowerFlowView]
+    B --> E[BatteryMonitor]
+    B --> F[SystemStats]
+    
+    C --> G[power_info]
+    C --> H[batt]
+    
+    D --> I[SwiftUI Views]
+    E --> J[IOKit Integration]
+    F --> K[System Load Metrics]
+    G --> L[SMC Access]
+    H --> M[Battery Diagnostics]
+```
+
+## Features
+
+### GUI Application
+- Real-time power flow visualization
+- Battery health monitoring (cycles, capacity, temperature)
+- Adapter power input tracking
+- System load/power consumption correlation
+
+### CLI Tools
+- `power_info`: Low-level SMC access for power metrics
+- `batt`: Advanced battery diagnostics (from [charlie0129/batt](https://github.com/charlie0129/batt))
+
+## Requirements
+
+- macOS 13 Ventura or newer
+- Xcode 15+
+- Administrative privileges for SMC access
+
+## Installation
+
+```bash
+# Clone repository
+git clone https://github.com/yourusername/power-suite.git
+cd power-suite
+
+# Build GUI application
+xcodebuild -workspace app.xcodeproj/project.xcworkspace -scheme app
+
+# Build CLI tools
+cd systemLoad_Claude
+make
+```
+
+## Usage
+
+GUI Application:
+```bash
+open app/build/Release/app.app
+```
+
+CLI Monitoring:
+```bash
+# System power stats
+./systemLoad_Claude/power_info -c
+
+# Battery health check
+./utility/batt health
+```
+
+## Contributing
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+
+## License
+GPLv3 (see [LICENSE](LICENSE))

README.md

@@ -171,7 +171,7 @@
 			attributes = {
 				BuildIndependentTargetsInParallel = 1;
 				LastSwiftUpdateCheck = 1620;
-				LastUpgradeCheck = 1620;
+				LastUpgradeCheck = 1630;
 				TargetAttributes = {
 					9DB688032D8E7A53007083F0 = {
 						CreatedOnToolsVersion = 16.2;
@@ -192,6 +192,7 @@
 			knownRegions = (
 				en,
 				Base,
+				"zh-Hans",
 			);
 			mainGroup = 9DB687FB2D8E7A53007083F0;
 			minimizedProjectReferenceProxies = 1;
@@ -303,6 +304,7 @@
 				CLANG_WARN_UNREACHABLE_CODE = YES;
 				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
 				COPY_PHASE_STRIP = NO;
+				DEAD_CODE_STRIPPING = YES;
 				DEBUG_INFORMATION_FORMAT = dwarf;
 				ENABLE_STRICT_OBJC_MSGSEND = YES;
 				ENABLE_TESTABILITY = YES;
@@ -366,6 +368,7 @@
 				CLANG_WARN_UNREACHABLE_CODE = YES;
 				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
 				COPY_PHASE_STRIP = NO;
+				DEAD_CODE_STRIPPING = YES;
 				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
 				ENABLE_NS_ASSERTIONS = NO;
 				ENABLE_STRICT_OBJC_MSGSEND = YES;
@@ -396,9 +399,11 @@
 				CODE_SIGN_STYLE = Automatic;
 				COMBINE_HIDPI_IMAGES = YES;
 				CURRENT_PROJECT_VERSION = 1;
+				DEAD_CODE_STRIPPING = YES;
 				DEVELOPMENT_ASSET_PATHS = "\"app/Preview Content\"";
 				ENABLE_PREVIEWS = YES;
 				GENERATE_INFOPLIST_FILE = YES;
+				INFOPLIST_KEY_LSUIElement = YES;
 				INFOPLIST_KEY_NSHumanReadableCopyright = "";
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
@@ -421,9 +426,11 @@
 				CODE_SIGN_STYLE = Automatic;
 				COMBINE_HIDPI_IMAGES = YES;
 				CURRENT_PROJECT_VERSION = 1;
+				DEAD_CODE_STRIPPING = YES;
 				DEVELOPMENT_ASSET_PATHS = "\"app/Preview Content\"";
 				ENABLE_PREVIEWS = YES;
 				GENERATE_INFOPLIST_FILE = YES;
+				INFOPLIST_KEY_LSUIElement = YES;
 				INFOPLIST_KEY_NSHumanReadableCopyright = "";
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
@@ -443,6 +450,7 @@
 				BUNDLE_LOADER = "$(TEST_HOST)";
 				CODE_SIGN_STYLE = Automatic;
 				CURRENT_PROJECT_VERSION = 1;
+				DEAD_CODE_STRIPPING = YES;
 				GENERATE_INFOPLIST_FILE = YES;
 				MACOSX_DEPLOYMENT_TARGET = 15.2;
 				MARKETING_VERSION = 1.0;
@@ -460,6 +468,7 @@
 				BUNDLE_LOADER = "$(TEST_HOST)";
 				CODE_SIGN_STYLE = Automatic;
 				CURRENT_PROJECT_VERSION = 1;
+				DEAD_CODE_STRIPPING = YES;
 				GENERATE_INFOPLIST_FILE = YES;
 				MACOSX_DEPLOYMENT_TARGET = 15.2;
 				MARKETING_VERSION = 1.0;
@@ -476,6 +485,7 @@
 			buildSettings = {
 				CODE_SIGN_STYLE = Automatic;
 				CURRENT_PROJECT_VERSION = 1;
+				DEAD_CODE_STRIPPING = YES;
 				GENERATE_INFOPLIST_FILE = YES;
 				MARKETING_VERSION = 1.0;
 				PRODUCT_BUNDLE_IDENTIFIER = clzoc.appUITests;
@@ -491,6 +501,7 @@
 			buildSettings = {
 				CODE_SIGN_STYLE = Automatic;
 				CURRENT_PROJECT_VERSION = 1;
+				DEAD_CODE_STRIPPING = YES;
 				GENERATE_INFOPLIST_FILE = YES;
 				MARKETING_VERSION = 1.0;
 				PRODUCT_BUNDLE_IDENTIFIER = clzoc.appUITests;
@@ -511,7 +522,7 @@
 				9DB688282D8E7A54007083F0 /* Release */,
 			);
 			defaultConfigurationIsVisible = 0;
-			defaultConfigurationName = Release;
+			defaultConfigurationName = Debug;
 		};
 		9DB688292D8E7A54007083F0 /* Build configuration list for PBXNativeTarget "app" */ = {
 			isa = XCConfigurationList;
@@ -520,7 +531,7 @@
 				9DB6882B2D8E7A54007083F0 /* Release */,
 			);
 			defaultConfigurationIsVisible = 0;
-			defaultConfigurationName = Release;
+			defaultConfigurationName = Debug;
 		};
 		9DB6882C2D8E7A54007083F0 /* Build configuration list for PBXNativeTarget "appTests" */ = {
 			isa = XCConfigurationList;
@@ -529,7 +540,7 @@
 				9DB6882E2D8E7A54007083F0 /* Release */,
 			);
 			defaultConfigurationIsVisible = 0;
-			defaultConfigurationName = Release;
+			defaultConfigurationName = Debug;
 		};
 		9DB6882F2D8E7A54007083F0 /* Build configuration list for PBXNativeTarget "appUITests" */ = {
 			isa = XCConfigurationList;
@@ -538,7 +549,7 @@
 				9DB688312D8E7A54007083F0 /* Release */,
 			);
 			defaultConfigurationIsVisible = 0;
-			defaultConfigurationName = Release;
+			defaultConfigurationName = Debug;
 		};
 /* End XCConfigurationList section */
 	};