translate-pseudocn

name	translate-pseudocn
description	为文档撰写技能提供伪中国语（pcn）语言支持。以日语汉字词汇为基础、剥离平假名与片假名、保留日语语序的伪本地化。可被 write-project-docs 自动发现调用。
language_code	pcn
display_name	偽中国語
base_language	ja

伪中国语翻译

为 NixKits 文档体系提供 pcn（伪中国语）语言。

自动发现契约

write-project-docs / write-maintenance-log 通过扫描 skills/translate-*/SKILL.md frontmatter 自动发现：

字段	值	用途
language_code	pcn	目录名、文件扩展名
display_name	偽中国語	语言切换器标签
base_language	ja	源语言

设计原则

伪中国语是日语文本剥离假名后的视觉结果，不是中文翻译。

• 基于智能体自然语言理解进行转换，不使用自动化脚本/正则替换。理解句子结构后再做转换。
• 语序转换为中文语序（SOV → SVO）
• 日文汉字名词保持原样
• 片假名外来语优先查词典映射为日本汉字，未命中则剥离
• 禁止使用简体中文或繁体中文汉字（如「软件」「安装」「模块」）

替换规则

1. 剥离假名

去除所有平假名（あ-ん）。片假名（ア-ン）按以下优先级处理：

1. 查 dictionary.md 映射为日本汉字
2. 未命中 → 剥离（仅保留上下文中的日文汉字）

2. 保留日文汉字

日文汉字名词原样保留，包括：

示例	保留形式	说明
開発	開発	日文汉字，非「开发」
環境	環境	日文汉字
管理	管理	日文汉字
提供	提供	日文汉字
設定	設定	日文汉字
情報	情報	日文汉字

3. 保留日语语序

日语 SOV 语序转换为中文 SVO 语序（主-动-宾）。

4. 助词转换（最小化）

助词适当保留以增加文本丰富性，仅剥离无实义的语法标记：

日文	変換	条件
の	之	所有/所属
と	與	并列连接
に	於	方向/目标
で	以	手段/场所
から	自	起点
まで	至	终点
は	(剥离)	主题标记，无实义
が	(剥离)	主语标记，无实义
を	(剥离)	宾语标记，无实义

5. 标点

日文标点保持原样（、 。 不转换）。

6. 代码块保护

• Nix 代码块：仅翻译 # 注释行
• Bash 代码块：全部不动
• 先按 ``` 边界提取代码块，仅对非代码区域应用规则

验证

翻译完成后，使用以下脚本检查输出文件是否残留假名：

import re

def check_kana(path):
    with open(path) as f:
        text = f.read()
    blocks = re.split(r'```', text)
    outside = ''.join(blocks[i] for i in range(0, len(blocks), 2))
    kata = re.findall(r'[\u30A0-\u30FF]{2,}', outside)
    hira = re.findall(r'[\u3040-\u309F]{2,}', outside)
    if kata: print(f'残片假名: {kata}')
    if hira: print(f'残平假名: {hira}')

词典

片假名→日本汉字映射见 dictionary.md。仅包含有对应日本汉字词的片假名外来语。

注意事项

• 伪中国语是视觉伪本地化，外观是「汉字+符号」的日文文本
• 禁止使用简体中文汉字（如「软件」「安装」「模块」「设置」）
• 语言切换器生成：从日文源提取路径逐个精确构造
• 日本語→[日本語]（加链接），自身标签 偽中国語（纯文本）
• 验证发现的残留片假名应立即翻译并加入 dictionary.md，然后重新生成所有 pcn 文档

常见陷阱与修复（实战经验）

1. 片假名词典映射必须优先于剥离

所有片假名在剥离前必须先查词典。常见遗漏项及对应日文汉字：

片假名	日文汉字	常见出现问题
タイプ	種別	基本信息表格的类型行变为空列
アイコン	図標	图标行显示空值
タイル	磁貼	标题行丢失
サービス	服務	服务模块描述缺失主体

验证方法：翻译完成后，对所有 pcn 文件运行残留假名检查脚本（见上方「验证」节）。 同时额外检查表格中是否存在空列（grep '^| |' docs/pcn/*.md）。

2. 语言切换器必须双向更新

新增 pcn 文件后，所有现有语言版本的同一文档都需要追加 [偽中国語] 链接。 仅更新 pcn 文件自身的切换器是不够的——zh/en/ja 的切换器行同样需要新增条目。

3. 禁止使用简体中文汉字

日文汉字「開発」「環境」「設定」「情報」必须原样保留，绝不能替换为简体中文的「开发」「环境」「设置」「信息」。

4. 标点保持日文

日文标点 、 。 不转换为中文 ， 。。

5. 子代理生成文件的切换器必须包含全部语言

子代理生成新语言文件时，容易只输出 3 条目切换器（如 [中文] | [English] | [偽中国語]），缺少其他已安装的扩展语言链接（如 [日本語]）。父代理在接收子代理输出后，必须验证并补全切换器至所有已发现语言。

验证命令：

# 检查切换器是否包含全部 5 语言
for f in docs/pcn/*.md; do
  line=$(grep '^\[中文\]' "$f")
    echo "$line" | grep -q "$expected" || echo "MISSING $expected in $f"
  done
done

6. 本地化文档内链必须指向同语言版本

模块文档表格中的链接指向源语言文档。转换为 pcn 后必须改为指向 pcn 版。例如 ](ja/nginx.md) → ](./nginx.md)。同时注意顶层文档的跨深度链接调整（../LICENSE → ../../LICENSE）。