JZKK720
diff --git a/‎CONTRIBUTING.zh-CN.md‎
Lines changed: 92 additions & 34 deletions b/‎CONTRIBUTING.zh-CN.md‎
Lines changed: 92 additions & 34 deletions
@@ -1,16 +1,24 @@
-# 雍｡迪ｮ閠�欠蜊暦ｼ�gent Desktop�?
-隹｢隹｢菴譛画э雍｡迪ｮ扈 Agent Desktop�∵裏隶ｺ譏ｯ bug 菫ｮ螟阪∵眠蜉溯�縲∵枚譯｣謾ｹ霑幢ｼ瑚ｿ俶弍荳荳ｪ髞吝ｭ冷披疲ｯ丈ｸ莉ｽ雍｡迪ｮ驛ｽ莉ｷ蛟ｼ霑槫沁縲?
-譛ｬ鬘ｹ逶ｮ蜿 `hermes-desktop` 蜷ｯ蜿托ｼ檎鴫莉?Cubecloud Agent Desktop 逧�錐荵臥ｻｧ扈ｭ蠑蜿托ｼ幄ｴ｡迪ｮ蠎比ｸ Cubecloud 逧�ｺｧ蜩∵婿蜷台ｸ惹ｻ｣遐∬ｧ�激菫晄戟荳閾ｴ縲?
+# 贡献者指南（Agent Desktop）
+
+谢谢你有意贡献给 Agent Desktop！无论是 bug 修复、新功能、文档改进，还是一个错字——每一份贡献都价值连城。
+
+本项目受 `hermes-desktop` 启发，现以 Cubecloud Agent Desktop 的名义继续开发；贡献应与 Cubecloud 的产品方向与代码规范保持一致。
+
 ## 语言
 
 - 英文：`CONTRIBUTING.md`
-- 邂菴謎ｸｭ譁�ｼ啻CONTRIBUTING.zh-CN.md`�域悽譁�ｻｶ�?- 譌･譁�ｼ啻CONTRIBUTING.ja-JP.md`�亥ｰ壽悴鄙ｻ隸托ｼ
+- 简体中文：`CONTRIBUTING.zh-CN.md`（本文件）
+- 日文：`CONTRIBUTING.ja-JP.md`（尚未翻译）
 
-> **隸ｴ譏趣ｼ?*譛ｬ譁�ｻｶ譏ｯ Cubecloud Agentic-OS 蜊穂ｻ鍋噪雍｡迪ｮ閠�帆遲悶?> 螳�ｸ主�鄂ｮ莠瑚ｿ帛宛譁�ｻｶ��agent-desktop/CONTRIBUTING.zh-CN.md`�我ｸ榊酔�
+> **说明：**本文件是 Cubecloud Agentic-OS 单仓的贡献者政策。
+> 它与内置二进制文件（`cubecloud-desktop/CONTRIBUTING.zh-CN.md`）不同，
 > 后者描述二进制文件安装包的贡献者政策。两者通过
-> 蜈ｨ螻 Windows 遑ｬ體ｾ謗･蜈ｱ莠ｫ闍ｱ譁�枚莉ｶ縲?
-## 莉手ｿ咎㈹蠑蟋?
-1. **Fork** 譛ｬ莉灘ｺ難ｼ悟ｹｶ莉･ fork 莉灘ｺ灘惠譛ｬ蝨ｰ蜈矩嚀縲?2. **螳芽｣�ｾ晁ｵ厄ｼ?*
+> 全局 Windows 硬链接共享英文文件。
+
+## 从这里开始
+
+1. **Fork** 本仓库，并以 fork 仓库在本地克隆。
+2. **安装依赖：**
 
    ```bash
    npm install
@@ -24,70 +32,120 @@
 
 ## 进行修改
 
-1. 莉?`main` 蛻�髪蛻帛ｻｺ譁ｰ蛻�髪�
+1. 从 `main` 分支创建新分支：
 
    ```bash
    git checkout -b your-branch-name
    ```
 
-2. 霑幄｡御ｿｮ謾ｹ縲ゆｿ晄戟謠蝉ｺ､閨夂┬窶披疲ｯ丈ｸｪ謠蝉ｺ､莉�桁蜷ｫ荳鬘ｹ騾ｻ霎台ｿｮ謾ｹ縲?3. 謠蝉ｺ､蜑崎ｿ占｡梧｣譟･�
+2. 进行修改。保持提交聚焦——每个提交仅包含一项逻辑修改。
+3. 提交前运行检查：
 
    ```bash
    npm run lint
    npm run typecheck
    ```
 
-4. 蝨ｨ譛ｬ蝨ｰ菴ｿ逕?`npm run dev` 豬玖ｯ穂ｽ逧�ｿｮ謾ｹ�檎｡ｮ菫昜ｸ蛻��蟶ｸ霑占｡後?
+4. 在本地使用 `npm run dev` 测试你的修改，确保一切照常运行。
+
 ## 提交拉取请求
 
-1. 蟆�ｽ逧��謾ｯ謗ｨ騾∝芦菴逧 fork縲?2. 髓亥ｯｹ荳頑ｸｸ莉灘ｺ鍋?`main` 蠑蜷ｯ諡牙叙隸ｷ豎ゅ?3. 蜀呎�遑ｮ逧�緒霑ｰ�瑚ｯｴ譏惹ｽ謾ｹ莠�ｻ荵井ｻ･蜿贋ｸｺ莉荵医?4. 螯よ棡菴逧 PR 隗｣蜀ｳ莠�汾荳ｪ蟾ｲ謇灘ｼ逧�琉鬚假ｼ瑚ｯｷ蠑慕畑蜈ｶ蜿ｷ�井ｾ句ｦ `Fixes #42`�峨?
+1. 将你的分支推送到你的 fork。
+2. 针对上游仓库的 `main` 开启拉取请求。
+3. 写明确的描述，说明你改了什么以及为什么。
+4. 如果你的 PR 解决了某个已打开的问题，请引用其号（例如 `Fixes #42`）。
+
 ### 保持 PR 的精简
 
-隸ｷ菫晄?PR 逧�ｲｾ邂荳手★辟ｦ窶披泌ｮ�ｻｬ譖ｴ螳ｹ譏楢｢ｫ螳｡譟･荳主粋蟷ｶ縲ゆｽ馴㍼霑�､ｧ縲∵ｷｷ蜈･譌蜈ｳ謾ｹ蜉ｨ逧 PR 蜿ｯ閭ｽ莨夊｢ｫ隕∵ｱよ究蛻�ｼ檎爆閾ｳ荳崎｢ｫ謗･蜿励?
-- 豈丈ｸｪ PR 莉�桁蜷ｫ荳鬘ｹ騾ｻ霎第隼蜉ｨ�井ｸ荳ｪ菫ｮ螟阪∽ｸ荳ｪ蜉溯�縲∽ｸ谺｡驥肴桷�峨?- 螯よ棡菴蜿醍鴫閾ｪ蟾ｱ蜉ｨ莠�ｾ亥､壽裏蜈ｳ譁�ｻｶ�瑚ｯｷ諡��謌仙､壻ｸｪ PR縲?- 驕ｿ蜈榊惠蜷御ｸ PR 荳ｭ豺ｷ蜈･譬ｼ蠑?/ 鬟取ｼ謇ｫ謠丈ｸ主粥閭ｽ諤ｧ謾ｹ蜉ｨ縲?- 譖ｴ蟆冗?PR 莨壽峩蠢ｫ陲ｫ螳｡譟･荳主粋蟷ｶ縲?
-扈ｴ謚､閠�ｼ壼ｮ｡譟･菴逧 PR 蟷ｶ蜿ｯ閭ｽ隕∵ｱゆｿｮ謾ｹ縲ゆｸ譌ｦ闔ｷ謇ｹ�悟ｮ�ｼ夊｢ｫ蜷亥ｹｶ縲?
+请保持 PR 的精简与聚焦——它们更容易被审查与合并。体量过大、混入无关改动的 PR 可能会被要求拆分，甚至不被接受。
+
+- 每个 PR 仅包含一项逻辑改动（一个修复、一个功能、一次重构）。
+- 如果你发现自己动了很多无关文件，请拆分成多个 PR。
+- 避免在同一 PR 中混入格式 / 风格扫描与功能性改动。
+- 更小的 PR 会更快被审查与合并。
+
+维护者会审查你的 PR 并可能要求修改。一旦获批，它会被合并。
+
 ## 报告 bug
 
-蜿醍鴫莠?bug�歇謠蝉ｺ､ issue](https://github.com/cubecloud-contributors/cubecloud-agentic-os/issues/new)�碁刋荳奇ｼ
+发现了 bug？[提交 issue](https://github.com/cubecloud-contributors/cubecloud-agentic-os/issues/new)，附上：
+
+- 清晰的标题与描述。
+- 复现该问题的步骤。
+- 你期望发生什么与实际发生了什么。
+- 你的操作系统与应用版本（如果相关）。
 
-- 貂�匆逧��｢倅ｸ取緒霑ｰ縲?- 螟咲鴫隸･髣ｮ鬚倡噪豁･鬪､縲?- 菴譛滓悍蜿醍函莉荵井ｸ主ｮ樣刔蜿醍函莠�ｻ荵医?- 菴逧�桃菴懃ｳｻ扈滉ｸ主ｺ皮畑迚域悽�亥ｦよ棡逶ｸ蜈ｳ�峨?
 ## 提出功能请求
 
 有个创意？[提交 issue](https://github.com/cubecloud-contributors/cubecloud-agentic-os/issues/new)，描述：
 
-- 菴諠ｳ隗｣蜀ｳ逧�琉鬚倥?- 菴譛滓悍螳�ｦゆｽ募ｷ･菴懊?- 菴蟾ｲ閠�剔霑�噪譖ｿ莉｣譁ｹ譯医?
+- 你想解决的问题。
+- 你期望它如何工作。
+- 你已考虑过的替代方案。
+
 ## 项目结构
 
-Cubecloud Agentic-OS 譏ｯ荳荳ｪ蜊穂ｻ難ｼ悟桁蜷ｫ莉･荳倶ｸｻ隕�Κ蛻�ｼ?
-- `apps/desktop-shell/` 窶?豢ｻ霍�?`@cubecloud/desktop-shell` 蟾･菴懷玄縲?- `agent-desktop/` 窶?螳梧紛逧?Electron 莠瑚ｿ帛宛譁�ｻｶ�亥性豐臥ｻｧ逧 hermes-desktop 譯�楔�峨?- `packages/platform-core/` 窶?蜊穂ｻ灘�螻蜈ｱ莠ｫ逧?TS 邀ｻ蝙九?- `docs/handbook/` 窶?謖我ｸｻ鬚倬柄譁�ｼ哂RCHITECTURE / DEVELOPMENT / OPERATIONS / README縲?- `docs/legal/` 窶?TRADEMARK_POLICY縲・ULA縲，OMMERCIAL_LICENSE 遲画ｳ募ｾ区枚莉ｶ縲?- `.agents/skills/` 窶?34 荳ｪ謚閭ｽ蛹�ｼ碁復蜒丞芦 `~/.agents/skills/`縲?
-隸ｦ隗∽ｻ灘ｺ捺ｹ逶ｮ蠖穂ｸ狗?`README.md` 荳?`docs/HANDBOOK.md`縲?
+Cubecloud Agentic-OS 是一个单仓，包含以下主要部分：
+
+- `apps/desktop-shell/` — 活跃的 `@cubecloud/desktop-shell` 工作区。
+- `cubecloud-desktop/` — 完整的 Electron 二进制文件（含沉继的 hermes-desktop 框架）。
+- `packages/platform-core/` — 单仓全局共享的 TS 类型。
+- `docs/handbook/` — 按主题长文：ARCHITECTURE / DEVELOPMENT / OPERATIONS / README。
+- `docs/legal/` — TRADEMARK_POLICY、EULA、COMMERCIAL_LICENSE 等法律文件。
+- `.agents/skills/` — 34 个技能包，镜像到 `~/.agents/skills/`。
+
+详见仓库根目录下的 `README.md` 与 `docs/HANDBOOK.md`。
+
 ## 代码风格
 
-莉｣遐�｣取ｼ隕∵ｱゑｼ?
-- TypeScript�壻ｸ･譬ｼ讓｡蠑上る∩蜈?`any`�碁勁髱樊怏譏守｡ｮ逅�罰縲?- React 19 荳主�謨ｰ扈�ｻｶ縲ゆｼ伜�菴ｿ逕?hooks�瑚碁撼 class 扈�ｻｶ縲?- Electron IPC 隹�畑�壽園譛?IPC 貂驕灘ｿ�｡ｻ譏ｾ蠑丞?`agent-desktop/src/main/ipc/` 荳区ｳｨ蜀後?- 萓晁ｵ厄ｼ壻ｽｿ逕?`npm ci` 莉･菫晁ｯ∽ｸ朱煤螳壽枚莉ｶ荳閾ｴ縲ゆｸ崎ｦ∬ｵｰ `npm install <package>` 閠御ｸ榊酔豁･髞∝ｮ壹?- Lint�壽署莠､蜑崎ｿ占｡ `npm run lint`縲?- 豬玖ｯ包ｼ壻ｸｺ bug 菫ｮ螟堺ｸ取眠蜉溯�豺ｻ蜉蜊募�豬玖ｯ輔?
+代码风格要求：
+
+- TypeScript：严格模式。避免 `any`，除非有明确理由。
+- React 19 与函数组件。优先使用 hooks，而非 class 组件。
+- Electron IPC 调用：所有 IPC 渠道必须显式在 `cubecloud-desktop/src/main/ipc/` 下注册。
+- 依赖：使用 `npm ci` 以保证与锁定文件一致。不要走 `npm install <package>` 而不同步锁定。
+- Lint：提交前运行 `npm run lint`。
+- 测试：为 bug 修复与新功能添加单元测试。
+
 ## 社区
 
-遉ｾ蛹ｺ豐滄夲ｼ夊ｯｷ蜈井ｽｿ逕ｨ [GitHub Issues](https://github.com/cubecloud-contributors/cubecloud-agentic-os/issues)縲?
-莉｣遐∬｡御ｸｺ蜃���壻ｸｾ謇倶ｹ句患�悟ｯｹ莉紋ｺｺ雍ｨ逍大燕蜈磯ｻ倩ｮ､莉紋ｻｬ譏ｯ荳ｺ莠�ｸ荳ｪ蜷育炊逶ｮ逧�ょ渚鬥井ｸｭ蟇ｹ莠ｺ荳崎ｴ溯ｴ｣莉ｻ縲?
+社区沟通：请先使用 [GitHub Issues](https://github.com/cubecloud-contributors/cubecloud-agentic-os/issues)。
+
+代码行为准则：举手之劳，对他人质疑前先默认他们是为了一个合理目的。反馈中对人不负责任。
+
 ## 许可
 
-Cubecloud-original 蟾･菴應ｻ･荳蛾我ｸ逧�曙隶ｸ蜿ｯ蜿大ｸ�ｼ?
-- **AGPL-3.0-or-later**�井ｸｻ�?- **Apache-2.0**�亥�螳ｹ騾蛾｡ｹ�?- **MIT**�亥�螳ｹ騾蛾｡ｹ�?
-豐臥ｻｧ逧?`hermes-desktop` 譯�楔莉｣遐∽ｿ晄戟蜴溷ｧ MIT 隶ｸ蜿ｯ縲?隸ｦ隗∽ｻ灘ｺ捺ｹ逶ｮ蠖穂ｸ狗?[`LICENSE`](../LICENSE) 荳?[`BRANDING_AND_LICENSE.md`](../BRANDING_AND_LICENSE.md)縲?
-## 蠑蜿題�ｯ∽ｹｦ譚･貅撰ｼ�CO�?
-謇譛牙�蠎楢ｴ｡迪ｮ蠢�｡ｻ驕ｵ蠕?**DCO 1.1** 遲ｾ蜷肴ｨ｡蝙九ゆｸ堺ｽｿ逕ｨ CLA縲?豈丈ｸｪ謠蝉ｺ､蠢�｡ｻ蛹�性荳陦?`Signed-off-by:`�梧ｷ萓具ｼ
+Cubecloud-original 工作以三选一的双许可发布：
+
+- **AGPL-3.0-or-later**（主）
+- **Apache-2.0**（兼容选项）
+- **MIT**（兼容选项）
+
+沉继的 `hermes-desktop` 框架代码保持原始 MIT 许可。
+详见仓库根目录下的 [`LICENSE`](../LICENSE) 与 [`BRANDING_AND_LICENSE.md`](../BRANDING_AND_LICENSE.md)。
+
+## 开发者证书来源（DCO）
+
+所有入库贡献必须遵循 **DCO 1.1** 签名模型。不使用 CLA。
+每个提交必须包含一行 `Signed-off-by:`，样例：
 
 ```
 feat(skills): add 3 promoted user-visible skills at first launch
 
 # Signed-off-by: Your Name <your.email@example.com>
 ```
 
-菴ｿ逕ｨ `git commit -s` 閾ｪ蜉ｨ霑ｽ蜉隸･陦後ょｦよ棡蠢倅ｺ?`-s`�悟惠謗ｨ騾∝燕菴ｿ逕ｨ `git commit --amend -s` 郛冶ｾ第署莠､菫｡諱ｯ縲?
-雍｡迪ｮ閠�ｻ｣遐�怙隕∝次蛻帑ｽ懆�ｸｪ莠ｺ蜷梧э�井ｸｪ莠ｺ雍｡迪ｮ�画�閠�弍菴諡･譛牙粋豕墓揀蛻ｩ謠蝉ｺ､逧�ｽ懷刀�亥ｷ･菴應ｺｧ蜃ｺ�峨?
+使用 `git commit -s` 自动追加该行。如果忘了 `-s`，在推送前使用 `git commit --amend -s` 编辑提交信息。
+
+贡献者代码需要原创作者个人同意（个人贡献）或者是你拥有合法权利提交的作品（工作产出）。
+
 ## 报告漏洞
 
-螳牙�謚･蜻願ｯｷ驕ｵ蠕?[`SECURITY.md`](../SECURITY.md)窶碑ｯｷ蜍ｿ蝨ｨ蜈ｬ蠑髣ｮ鬚倅ｸｭ蜿大ｸ�≡荵ｦ縲、PI 蟇�徴縲∫ｧ∽ｺｺ譌･蠢励∽ｸｪ莠ｺ譁�｡｣謌門�蜈ｱ IP 縲?螳牙�菫ｮ螟埼�蠕ｪ荳主粥閭ｽ謠蝉ｺ､逶ｸ蜷檎噪 DCO 遲ｾ蜷崎ｧ���帶慮髣､荳肴弍隶ｸ蜿ｯ隸∫ｩｺ蟄舌?
+安全报告请遵循 [`SECURITY.md`](../SECURITY.md)—请勿在公开问题中发布凑书、API 密钥、私人日志、个人文档或公共 IP 。
+安全修复遵循与功能提交相同的 DCO 签名规则；时闤不是许可证空子。
+
 ## 致谢
 
-荳頑ｸｸ菴懆�ｸ守､ｾ蛹ｺ雍｡迪ｮ閠�噪螳梧紛蜷榊黒菴堺ｺ [`ACKNOWLEDGMENTS.md`](../ACKNOWLEDGMENTS.md)縲?隨ｬ荳画婿蠖貞ｱ樒岼蠖穂ｽ堺ｺ?[`NOTICE`](../NOTICE)縲?螯よ棡菴逧�ｴ｡迪ｮ蝓ｺ莠主悪莠ｺ逧�ｷ･菴懶ｼ域擂閾ｪ荳頑ｸｸ鬘ｹ逶ｮ逧�ｿｮ螟阪∵擂閾ｪ蜿り�ｻ｣遐∝ｺ鍋噪讓｡蠑上∬ｽｬ霑ｰ逧�ｮ玲ｳ包ｼ会ｼ瑚ｯｷ蝨ｨ菴逧�署莠､菫｡諱ｯ荳ｭ扈吩ｺ亥ｽ貞ｱ橸ｼ悟ｹｶ蝨ｨ蠢�ｦ∵慮蟆�ｻ紋ｻｬ蜉蜈･ `NOTICE`縲?
+上游作者与社区贡献者的完整名单位于 [`ACKNOWLEDGMENTS.md`](../ACKNOWLEDGMENTS.md)。
+第三方归属目录位于 [`NOTICE`](../NOTICE)。
+如果你的贡献基于别人的工作（来自上游项目的修复、来自参考代码库的模式、转述的算法），请在你的提交信息中给予归属，并在必要时将他们加入 `NOTICE`。