🔧 中文通—正负数码软件 · 技术开发文档

一、项目概述

基于《汉字正负数码》编码体系（专利号：202610784807.1）的汉字输入法 + 教育 + 生态平台，软件品牌「中文通—正负数码软件」。以正负杂合数编码为核心，覆盖：汉字输入、拼音/释义查询、等级测评（HSK 1–6 级）、长文加密传送（普通 / 蒸馏 / 抗量子）、加密语音、机-机密传、分享注册与推广、中国红码、会员订阅体系、AI 智能客服（5 智能体）、英语键盘、国学文库（9 大类）、华语贡献者体系、学习排行榜、华文书法大赛、商城、数码编程体系（DCIS/DCUL）、正负数 26 进制超级计算架构、编程测试、圈子与学习圈、22 语国际站、军用/商用双站架构。

二、系统架构

┌───────────────────────────────────────────────────────┐
│  前端（纯静态 HTML+JS，无构建，双击即用）              │
│  商用：index.html（主程序） register.html             │
│        forgot.html  usercenter.html  admin.html       │
│        xinhua.html  jigou.html  architecture.html     │
│        codetest.html  circle.html  learn.html         │
│        rank.html（学习排行榜） calligraphy.html（书法大赛）│
│        mall.html（商城） fin_exec.html（财务）        │
│        接口文档.html  使用说明.html  项目介绍说明书.html│
│        技术开发文档.html  商业计划书 syjhs.html        │
│  军用：redflash.html（功能版/简易版）secadmin.html     │
│  库：dcis.js（数码指令集） dcul.js（通用底层库）       │
│       kefu-agent.js / kefu-agent-sec.js（AI 客服）     │
│       qrcode.min.js（本地红色二维码兜底）              │
├───────────────────────────────────────────────────────┤
│  数据层：内嵌字库（window.__DICT__ 7038 字）           │
│          localStorage（词库/视频/设置/打卡/排行）      │
│          IndexedDB（中文字典/词典缓存）                │
│          dict.json / xinhua_cd.json / xinhua_zd.json   │
├───────────────────────────────────────────────────────┤
│  服务端（IIS + ASP.NET .ashx，双站独立部署）           │
│  flashsend.ashx（长文闪送/加密语音/城市审核/myip）     │
│  contributors.ashx（华语贡献者 列表·个人页·头像·申请） │
│  circle.ashx（圈子/学习圈 帖子·文章·会议·话题）        │
│  mall.ashx（商城 商品·下单）  redcode.ashx（中国红码） │
│  api/userapi.ashx（注册登录/会员/推广/排行榜/书法配置）│
│  api/aichat.ashx（AI 客服 5 模型中转）                 │
│  api/jigou.ashx（机构注册/上传/后台管理）              │
│  api/dictapi.ashx（字典/词典数据）                     │
│  api/coopapi.ashx（国家地区合作授权 195 国）           │
│  api/backup.ashx（数据备份）                           │
└───────────────────────────────────────────────────────┘

三、编码原理（正负数码）

• 与数字同形/近形的部件 → 正码 0–9（蓝）；反形/变形部件 → 负码 ⁻0–⁻9（红）
• 26 键方案：正码 0–9 / 负码 n0–n9 / 字母码 Z 言(讠) X 木 C 土(士) B 日 N 金(钅) V 补充码；M 0；一码片 = 5 bit（26 有效 + 6 保留）
• 字库 7038 字，全部实测编码；词组 3.3 规则（最短码 + 扩展码）
• 句码：按标点断句，每句 ≥4 字取前 3 + 末字首码、3 字取首 + 后两各 1、2 字各 1；无重码足码才入库
• 98 组编码组件（正负一码部件速查）内置键位图与速查表；负号显示铁律：对外一律普通形式（-0、-5），负号仅键位图/速查表用上标形式

四、前端模块说明

4.1 主程序 index.html

4.2 账号体系（register.html / forgot.html / usercenter.html）

注册/登录/修改密码/修改邮箱/找回密码走服务端 api/userapi.ashx（用户库 App_Data/users.json）；个人中心含会员状态、推广收益（推广码/链接 + 收益明细）、实名认证等面板。

4.3 xinhua.html（中文字典/词典）

IndexedDB 缓存字典数据（api/dictapi.ashx?f=zd|cd），拼音去声调检索；查询结果正负数码下方自动生成中国红码（复用红码 API + 本地兜底逻辑）。

4.4 admin.html（后台管理）

管理员登录（sessionStorage + 服务端校验）；管理面板覆盖：管理员、用户、会员、城市、语言、视频、机构、上传、纠错反馈、语言研究（文章）、会议审核、话题审核、国家合作授权、财务管理（聚合收款配置）、实名证件审核、华语贡献者（四分类 × 状态筛选、添加/编辑/审核/下架/删除、头像上传）、书法大赛配置（奖金池与各国参与人数、五档奖项）。

4.5 华语贡献者体系（contributors.ashx + 首页通栏板块）

首页 wrap 内通栏横向板块（grid-column:1/-1，位于右侧栏之后、footer 之前），四分类副标题：远古文字 / 近代文字 / 当代文字 / 专家学者（键值 ancient / modern / consultant / expert 固定不改）。卡片含头像（无头像以姓名首字空白占位）、姓名、头衔、时代·单位、简介两行截断；点击整卡在新窗口打开个人独立庄重页（contributors.ashx?action=page&id=xx，宣纸底深红金 + 楷书 + 头像大图 + 简介 + 详细介绍分段全文）。

4.6 学习排行榜（rank.html）

以全球用户累计打字字数为准（Top100 + 我的名次 + 前三金银铜徽章 + 手机号/QQ 脱敏）；登录用户练习/测评完成自动上报本次字数（服务端累加 + 10 秒限频防抖）；数据来自 api/userapi.ashx 的 typing_report / typing_rank。

4.7 华文书法大赛（calligraphy.html）

每年一届；三级评审：AI 初选 → 专家团队盲选（匿名）→ 各国排行；组别：楷书 / 行书 / 草书 / 毛体 / 隶书 / 篆书 / 硬笔 / 海外组；特等奖作品必须从毛主席手书「为人类服务」5 字中选出；年度奖金池默认 ¥10 亿，按各国参与中文学习人数占比自动计算各国奖金池，五档奖项金额后台可随时改（配置读写 shufa_cfg_get / shufa_cfg_set，数据 App_Data/shufa_cfg.json）。

4.8 商城与财务（mall.html / fin_exec.html）

商城（mall.ashx + App_Data/mall_products.json、mall_orders.json、mall_imgs/）；财务管理页 fin_exec.html 汇总聚合收款、会员订单（vip_orders.json）、提现（withdraw.json + withdraw_proof/）、流水（ledger.json / ledgercfg.json）与报表（fin_reports.json）。

4.9 编程与学习页

architecture.html（26 进制太极超级计算架构 + 整数⇄正负数 26 进制实时换算器）；codetest.html（编程测试：随机 10 题 + 专项练习，成绩码 26 进制证书 + 本机排行榜）；circle.html（编程圈子）/ learn.html（交流学习圈：学习路线三阶、资源导航、每日打卡 7 天小周天/21 天大周天、答疑互助、语言研究专栏、会议发起）。

4.10 军用站（anquan.arpa.cc）

redflash.html（功能版/简易版，含 ⚛ 抗量子加密）+ secadmin.html（军用后台）；用户/会员库与商用站独立（App_Data/users.json 分离），安全红线（admins.json 公网可读）已记录，对外开放前处理。军用版本不启用华语贡献者板块与书法大赛页。

五、后端接口（.ashx）

※ 接口契约纪律：任何接口改动或升级前先盘点全部调用方与契约影响，改后逐调用方验证输出；调用方未同步前接口行为不得静默变化。

六、数据设计

备份机制：每次部署自动生成 *.yyyyMMdd_HHmmss.dshbak 备份旧文件（保留不回滚即不删）；整站与数据库可一键打包回传（2026-09-10 已生成 zhengfu_site.zip 144.7MB / anquan_site.zip 18.3MB / zhengfu_database.zip 45.5MB / anquan_database.zip）。

七、加密与安全

• 长文闪送加密：文本 → 普通加密 / 蒸馏加密（会员，附收取限制）/ 抗量子加密（24 码 + 先决条件核验）；服务器仅存数码密文、提取即删、不可视、不缓存
• 加密语音：zvcx 魔数 + 长度头 + 每字节 2 码片，纯正负数码密文，服务端无感知
• 机-机密传（本机解码）：计算机间重要信息安全传输——复用蒸馏编码层；密文格式 ZFMD:…（蒸馏档）/ ZFMQ:盐:…（口令档：口令+随机盐拉伸为种子 → 密钥流逐字节异或）；生成/解码全部在本机完成（不经服务器），密文可经任意渠道送达，收取后本机粘贴解码还原；错误口令/损坏密文经启发检测拒绝；商用+军用双站同算法互通
• 提取码派生：按内容唯一派生；12 码（普通/蒸馏）/ 24 码（抗量子）；负码兼容三种形式（-5 / ⁻5 / n5）+ 上标/全角数字归一
• AI 客服密钥：web.config AI_KEY_* 服务端持有，浏览器零接触；.ashx 必须 UTF-8 带 BOM 保存
• 管理员口令：PBKDF2 哈希存储（salt:iter:hash），明文口令不落盘
• 核心技术细节（编码体系/蒸馏/抗量子/26 进制等）依保密纪律另行管理，本文档不展开

八、会员与推广体系

九、🧮 数码编程体系（DCIS / DCUL / 26 进制）

9.1 DCIS 数码指令集（dcis.js，97 编码 × 8 语言）

继承「正负数编码 = 概念唯一编号」思想，为编程原子概念分配正负数数码编号，形成语言无关 IR：01-09 控制流 / 10-19 数据类型 / 20-39 运算赋值 / 40-49 系统 IO / 50-59 数据结构 / 60-69 应用接口 / 70-79 数据库 / 80-89 教学接口 / 90-99 智能体接口。

// 中文 → 数码 IR → 任意语言（智能体可直接用中文写代码）
DCISLib.translate("输出 字符串", "py")    // → print str
DCISLib.zh2code("如果 整数 大于 整数")    // → 01 10 25 10
DCISLib.audit("print str", "py")          // → [04]输出 [12]字符串（可审计）

9.2 DCUL 通用底层库（dcul.js，37 个数码接口）

所有场景接口按数码编号统一调用 DCUL.call("编号", 参数…)：51-55 系统适配 / 33-35 数据存储 / 40-43 翻译接口 / 56-60 教学接口 / 61-70 工具接口（二维码/红码/字典/加密…）/ 90-99 智能体接口。

9.3 26 进制超级计算架构（architecture.html）

正码 0–9（阳）＋负码 ⁻0–⁻9（阴）＋六爻字母 Z X C B N V（变）＝ 26 码片；一码片 = 5 bit（26 有效 + 6 保留），8 码片 = 40 bit 字节对齐；太极 → 两仪（正/负）→ 26 码片的阴阳正负逻辑；负码内建符号 = 冗余有符号数制（免进位链传播可并行）；页面内置「整数 ⇄ 正负数 26 进制」实时换算器（平衡残差法，万例往返零误差）。

9.4 接口文档

接口文档.html 运行时从 dcis.js / dcul.js 注册表自动渲染全部编码与接口（含搜索、示例、调用方式），保证文档与代码永远同步。

十、部署与运维

1. 服务器：Windows + IIS + ASP.NET（.ashx）；商用站 ai.arpa.cc（IIS 站点 zhengfu，目录 C:\inetpub\wwwroot\zhengfu）、军用站 anquan.arpa.cc（IIS 站点 anquan，目录 C:\inetpub\wwwroot\anquan，web.config / App_Data 各自独立）
2. 部署通道：RDP 114.80.110.47:33893（WinRM 5985/5986 与 SMB 445 均不通）；远程登录后保持会话不退出，操作在已打开的命令框内注入执行
3. 部署方式：site_pkg 全量同步 → 覆盖线上文件；部署脚本自动备份旧文件 *.yyyyMMdd_HHmmss.dshbak
4. 应用池：zhengfu 站绑定 DefaultAppPool（与其它项目站点共池）——不可直接回收，.ashx 改动后以 touch（更新）web.config 时间戳触发本站应用域重编译
5. 静态文件（html/js/json）复制即生效；.ashx 改动需触发应用域重编译；.ashx 一律 UTF-8 带 BOM，部署用 .cmd 一律 GBK + CRLF
6. 数据文件：xinhua_cd.json（21MB）、xinhua_zd.json（4.9MB）、dict.json
7. 双副本铁律：软件\ 与 仓库\ 字节一致；文档\ 与 仓库\ 同步；桌面副本一律 .txt 格式
8. 代码同步：本地提交入库 ＋ 工作副本与代码仓库双副本字节一致校验（仅前台代码，web.config 密钥手工核对）
9. 备份纪律：每次更新前先备份、当次备份不回滚即不删、超一周的备份清理需先请示；整站与数据库可随时一键打包回传本地
10. 改线上数据（如 contributors.json）前必须先回拉线上当前文件作底稿，逐字段比对后再改、改后回拉复核

十一、版本历史