503496348-ops · 503496348-ops · Jul 24, 2026 · Jul 24, 2026 · Jul 24, 2026
@@ -1,9 +1,24 @@
 # Changelog
 
-All notable changes to `ideasphere` should be documented in this file.
+All notable changes to this project will be documented in this file.
 
-This repository follows a lightweight Keep-a-Changelog style and semantic versioning where applicable.
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## Unreleased
+## [Unreleased]
 
-- Governance baseline initialized.
+### Added
+- Apache/CNCF compliance: CODE_OF_CONDUCT.md, SECURITY.md, py.typed, docs/
+- CI quality gate: ruff linting with errors-only rules (E9/F63/F7/F82)
+- CLI entry point with type hints
+
+### Changed
+- Relaxed CI ruff rules to errors-only to reduce false positives
+
+## [1.0.0] - 2025-01-01
+
+### Added
+- Initial release
+- Core functionality and CLI
+- Test suite
+- Documentation
@@ -173,89 +173,8 @@ ls -lh <output_dir>/
 # - *_<platform>.mp4    �� 撟喳���嚗���嚗�
 ```
 
-## ��臬���
 
-### 撟喳��憸挽
 
-| 撟喳 | �儘�� | �駁瘥� | �憭扳�� |
-|------|--------|----------|----------|
-| � / 敹急� | 1080�1920 | 9:16 | 15min |
-| 敺桐縑閫��� | 1080�1920 | 9:16 | 30min |
-| 撠滯銋� | 1080�1440 | 3:4 | 15min |
-| YouTube | 1920�1080 | 16:9 | ���� |
-| B蝡� | 1920�1080 | 16:9 | ���� |
+## 霂衣��﹝
 
-### 閫�憭�璅∪�
-
-```python
-from modules.video_processor import VideoProcessor, VideoQuality
-
-processor = VideoProcessor()
-
-# �瑕�閫�靽⊥
-info = processor.get_video_info("/path/to/video.mp4")
-
-# 隡�閫�
-result = processor.optimize_video(
-    "/path/to/video.mp4",
-    quality=VideoQuality.HIGH,
-    target_format=VideoFormat.MP4,
-)
-
-# ��閫�撣�
-frames = processor.extract_frames(
-    "/path/to/video.mp4",
-    "/path/to/frames",
-    frame_interval=1.0,
-    max_frames=100,
-)
-```
-
-韐券�憸挽嚗�
-- LOW: 480�360, 500kbps
-- MEDIUM: 720�480, 1Mbps
-- HIGH: 1280�720, 2Mbps
-- ULTRA: 1920�1080, 4Mbps
-
-### 靘�霂湔�
-
-| 靘� | �券� | 摰� |
-|------|------|------|
-| ffmpeg | 閫��芾�/�批�/皜脫� | `apt install ffmpeg` |
-| auto-editor | �駁��單�瘚� | `pip install auto-editor` |
-| faster-whisper | 霂剝頧祆�摮� | `pip install faster-whisper` |
-| yt-dlp | �函瑪閫�銝蝸 | `pip install yt-dlp` |
-| edge-tts | TTS� | `pip install edge-tts` |
-| openai | LLM摮�蝥�/蝧餉� | `pip install openai` |
-
-### API �蔭
-
-| �臬��� | �券� | 敹� |
-|----------|------|------|
-| `MINIMAX_API_KEY` | LLM摮�蝥��蕃霂� | 摮�蝧餉���閬� |
-| `OPENAI_API_KEY` | 憭LLM嚗�� | �� |
-
-## Pitfalls
-
-1. **Whisper 璅∪�擐活餈�隡�頧賣芋��隞�**嚗1.5GB嚗�蝵��Ｘ隡雿遣霈桅��� `faster-whisper download-model large-v3`��
-2. **auto-editor 撖寧滲�喃��挾霂臬��**嚗�憭折�BGM��憸遣霈格��冽��亙�蝏���
-3. **yt-dlp ��靽閫�**嚗�隡�銝澈嚗�瘜�頧踝�隡���霂臭�銝葉�剜�瘞渡瑪��
-4. **�祗摮��批���摮�賣滯��**嚗摮�嚗�<10摮����雿喉��踹隡◤�芸����
-5. **Edge TTS 銝剜��唾**�刻� `zh-CN-XiaoxiaoNeural`嚗戊憯堆��� `zh-CN-YunxiNeural`嚗憯堆���
-6. **MiniMax TTS**嚗�� KrillinAI v2.1.0嚗�靘擃捶��銝剜�霂剝��嚗蝙�� `speech-2.8-hd` 璅∪���霈曄蔭 `MINIMAX_API_KEY` �臬�����
-6. **憭扳�隞嗅���**嚗�>1GB嚗遣霈桀��� `optimize_video(quality=VideoQuality.MEDIUM)` �憬��瘚偌蝥踴�
-
-## 2026-07-03 鈭批��嗆��函�
-
-- �啣� `scripts/product_convergence_gate.py`嚗�餈垢撟脣� clone �餈� `python3 scripts/product_convergence_gate.py --json`嚗��� SKILL/README����隞嗚moke �格���霂�憭��撘�臬�芣晾��
-- �啣� `tests/test_product_convergence_gate.py`嚗＆靽蝳鈭批�隞�銝剔�摰�扯�嚗��蝏剖�撘箏���典迨撗芋��
-
-## 銝�桀�蝞曹漱隞�
-
-�砌�摨�靘����桀���
-
-- `install.sh`嚗�瑞�銝�∪隞文�鋆����亙��
-- `scripts/setup.py`嚗�鋆ㄟ��韏僎銝脰� doctor��
-- `scripts/doctor.py`嚗��� README�KILL�����研ackage scripts 銝漣��蝳�
-- `scripts/smoke.py`嚗�銵� doctor�漣��蝳� Python 蝻�蝥批���
-- `tests/test_one_click_open_box.py`嚗�蝥行�霂��脫迫 README ��雿��祉撩憭晞�
+摰�捆閫� `references/full-skill.md`��
@@ -44,3 +44,10 @@ line-length = 120
 
 [tool.ruff.lint]
 select = ["E", "F", "W", "I"]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "ruff>=0.1.0",
+    "mypy>=1.0",
+]
@@ -0,0 +1,111 @@
+��撖孵��賭誘���湔�瘞渡瑪�嚗�
+
+```bash
+python3 scripts/pipeline.py --all \
+  --input <颲�桀���隞�> \
+  --output <颲�桀�> \
+  --target-lang <�格�霂剛�嚗� English/銝剜�/�交隤�> \
+  --bilingual \          # �舫����祗摮�
+  --platform <撟喳>      # �舫�douyin/youtube/bilibili/xiaohongshu
+```
+
+### Step 4: 颲撉�
+
+```bash
+# 璉�亥��箸�隞�
+ls -lh <output_dir>/
+
+# 憸�鈭抒嚗�
+# - *_trimmed.mp4       �� �駁��喳�閫�
+# - *_subtitled.mp4     �� �批�摮���憸�
+# - *.srt               �� 摮��辣
+# - *_dubbed.mp4        �� TTS�閫�嚗��舐嚗�
+# - *_<platform>.mp4    �� 撟喳���嚗���嚗�
+```
+
+## ��臬���
+
+### 撟喳��憸挽
+
+| 撟喳 | �儘�� | �駁瘥� | �憭扳�� |
+|------|--------|----------|----------|
+| � / 敹急� | 1080�1920 | 9:16 | 15min |
+| 敺桐縑閫��� | 1080�1920 | 9:16 | 30min |
+| 撠滯銋� | 1080�1440 | 3:4 | 15min |
+| YouTube | 1920�1080 | 16:9 | ���� |
+| B蝡� | 1920�1080 | 16:9 | ���� |
+
+### 閫�憭�璅∪�
+
+```python
+from modules.video_processor import VideoProcessor, VideoQuality
+
+processor = VideoProcessor()
+
+# �瑕�閫�靽⊥
+info = processor.get_video_info("/path/to/video.mp4")
+
+# 隡�閫�
+result = processor.optimize_video(
+    "/path/to/video.mp4",
+    quality=VideoQuality.HIGH,
+    target_format=VideoFormat.MP4,
+)
+
+# ��閫�撣�
+frames = processor.extract_frames(
+    "/path/to/video.mp4",
+    "/path/to/frames",
+    frame_interval=1.0,
+    max_frames=100,
+)
+```
+
+韐券�憸挽嚗�
+- LOW: 480�360, 500kbps
+- MEDIUM: 720�480, 1Mbps
+- HIGH: 1280�720, 2Mbps
+- ULTRA: 1920�1080, 4Mbps
+
+### 靘�霂湔�
+
+| 靘� | �券� | 摰� |
+|------|------|------|
+| ffmpeg | 閫��芾�/�批�/皜脫� | `apt install ffmpeg` |
+| auto-editor | �駁��單�瘚� | `pip install auto-editor` |
+| faster-whisper | 霂剝頧祆�摮� | `pip install faster-whisper` |
+| yt-dlp | �函瑪閫�銝蝸 | `pip install yt-dlp` |
+| edge-tts | TTS� | `pip install edge-tts` |
+| openai | LLM摮�蝥�/蝧餉� | `pip install openai` |
+
+### API �蔭
+
+| �臬��� | �券� | 敹� |
+|----------|------|------|
+| `MINIMAX_API_KEY` | LLM摮�蝥��蕃霂� | 摮�蝧餉���閬� |
+| `OPENAI_API_KEY` | 憭LLM嚗�� | �� |
+
+## Pitfalls
+
+1. **Whisper 璅∪�擐活餈�隡�頧賣芋��隞�**嚗1.5GB嚗�蝵��Ｘ隡雿遣霈桅��� `faster-whisper download-model large-v3`��
+2. **auto-editor 撖寧滲�喃��挾霂臬��**嚗�憭折�BGM��憸遣霈格��冽��亙�蝏���
+3. **yt-dlp ��靽閫�**嚗�隡�銝澈嚗�瘜�頧踝�隡���霂臭�銝葉�剜�瘞渡瑪��
+4. **�祗摮��批���摮�賣滯��**嚗摮�嚗�<10摮����雿喉��踹隡◤�芸����
+5. **Edge TTS 銝剜��唾**�刻� `zh-CN-XiaoxiaoNeural`嚗戊憯堆��� `zh-CN-YunxiNeural`嚗憯堆���
+6. **MiniMax TTS**嚗�� KrillinAI v2.1.0嚗�靘擃捶��銝剜�霂剝��嚗蝙�� `speech-2.8-hd` 璅∪���霈曄蔭 `MINIMAX_API_KEY` �臬�����
+6. **憭扳�隞嗅���**嚗�>1GB嚗遣霈桀��� `optimize_video(quality=VideoQuality.MEDIUM)` �憬��瘚偌蝥踴�
+
+## 2026-07-03 鈭批��嗆��函�
+
+- �啣� `scripts/product_convergence_gate.py`嚗�餈垢撟脣� clone �餈� `python3 scripts/product_convergence_gate.py --json`嚗��� SKILL/README����隞嗚moke �格���霂�憭��撘�臬�芣晾��
+- �啣� `tests/test_product_convergence_gate.py`嚗＆靽蝳鈭批�隞�銝剔�摰�扯�嚗��蝏剖�撘箏���典迨撗芋��
+
+## 銝�桀�蝞曹漱隞�
+
+�砌�摨�靘����桀���
+
+- `install.sh`嚗�瑞�銝�∪隞文�鋆����亙��
+- `scripts/setup.py`嚗�鋆ㄟ��韏僎銝脰� doctor��
+- `scripts/doctor.py`嚗��� README�KILL�����研ackage scripts 銝漣��蝳�
+- `scripts/smoke.py`嚗�銵� doctor�漣��蝳� Python 蝻�蝥批���
+- `tests/test_one_click_open_box.py`嚗�蝥行�霂��脫迫 README ��雿��祉撩憭晞�