diff --git a/docs/00-project-profile.md b/docs/00-project-profile.md index 9aabdc9..c575b26 100644 --- a/docs/00-project-profile.md +++ b/docs/00-project-profile.md @@ -2,8 +2,8 @@ generated: true (请先修改 Gitea Wiki,禁止直接编辑本文件) wiki_page: Project-Profile wiki_url: https://git.ilapage.cn/OPC/lexgo/wiki/Project-Profile.- -wiki_revision: d5832ae249dabbf6ce2515ce350b3adc730fff46 -synchronized_at: 2026-09-10T06:27:39Z +wiki_revision: f994200cf03c5aba762a39432f78c16cbcc222fa +synchronized_at: 2026-09-10T06:28:56Z # LexGo 项目档案 @@ -57,3 +57,9 @@ LinguaCafe 参考基线由现有调研记录为 `c1ea298ce40c65b9dd33e9b26fd2e52 ## 环境、配置与凭据 本地 Windows PowerShell,工作目录 `D:/opc_project/lexgo`。当前 Gitea MCP 指向 `ilaer.eicp.net:8418`,并非用户确认的目标站点;本轮因此使用目标站点 Gitea API。凭据从已配置的安全来源读入进程,不复制进项目。Wiki 配置只保存非敏感地址与页面映射,凭据使用 MCP 安全配置或环境变量。 + +## 治理默认值与已核验主机 + +新项目默认采用轻量模式;本项目同时已获用户明确选择。DevHarness 上游模板自身继续采用标准模式,该模板模式不覆盖 LexGo 的选择。 + +本轮核实本机为 Microsoft Windows 10 企业版 LTSC,使用 PowerShell 7 `pwsh`,版本 7.3.12;Python 工具当前运行于 Python 3.8。该环境记录只证明文档工具运行主机,不代表产品支持矩阵。 diff --git a/docs/04-local-development-and-verification.md b/docs/04-local-development-and-verification.md index dd31a4a..6916902 100644 --- a/docs/04-local-development-and-verification.md +++ b/docs/04-local-development-and-verification.md @@ -2,8 +2,8 @@ generated: true (请先修改 Gitea Wiki,禁止直接编辑本文件) wiki_page: Local-Development-and-Verification wiki_url: https://git.ilapage.cn/OPC/lexgo/wiki/Local-Development-and-Verification.- -wiki_revision: 205b5548e0c2b30a4dd517c9e4cfcef0b823223e -synchronized_at: 2026-09-10T06:27:42Z +wiki_revision: 0497f11b18e9016dd70ee561cc225a46fcc678c3 +synchronized_at: 2026-09-10T06:28:59Z # 本地开发与验证 @@ -41,3 +41,43 @@ synchronized_at: 2026-09-10T06:27:42Z ## 完成修改前 文档检查来源、链接、事实/建议区分和工作量加总;工具运行受影响的现有测试。产品阶段按具体工单测试隔离、Unicode、幂等、复习或恢复,未执行部分如实记录。当前没有 go.mod、package.json 或 Compose,不能声称产品能启动。 + +## 可复制 Shell 示例 + +### PowerShell 语法与外部命令 + +- Windows 环境默认使用当前 PowerShell 语法,不套用 Bash 的 heredoc、变量、路径、引号或反斜杠转义规则。只有明确调用 Bash、WSL 或 Git Bash,并确认路径与编码边界时,才使用 Bash 专用语法。 +- 不需要变量展开的正则和字符串优先用单引号;单引号字符串内部的单引号写成两个单引号。需要变量展开时才使用双引号。 +- 正则同时包含单双引号或转义复杂时,优先赋值给变量、使用 `rg -e`,或拆成语义等价的简单查询;不得为了避开转义改变 AND/OR 条件或重复执行无关搜索。 + +```powershell +rg -n 'error|warning' docs +$pattern = 'can''t match "value"' +rg -n -e $pattern docs +``` + +PowerShell 不支持 Bash heredoc。需要把多行 Python 送入标准输入时,使用单引号 here-string,避免 PowerShell 展开 Python 中的 dollar sign(`$`)等内容。起始标记后必须立即换行,结束标记必须单独占一行: + +```powershell +@' +print("hello") +'@ | python - +``` + +`foreach`、`if` 等语句块不能裸放在管道左侧;需要管道输出时使用 `$()`、`@()` 或先赋值。普通命令输出无需包装: + +```powershell +@(foreach ($number in 1..3) { $number }) | + Measure-Object +``` + +不要把含 `*` 的搜索路径直接作为 `rg` 路径参数。优先传入真实目录,并用 `-g/--glob` 让 ripgrep 筛选路径: + +```powershell +rg -n -g '*.md' 'PowerShell' docs +``` + +只有确实需要把实体路径列表交给其他命令时,才使用 `Get-ChildItem` 展开并传递 `.FullName`;不要把 `Get-ChildItem -Filter` 设为所有 `rg` 搜索的固定前置。 + + +示例预期:Python 输出 hello;Measure-Object 返回 Count 为 3;rg 返回当前文档中匹配 PowerShell 的行(有匹配时退出码 0,无匹配时为 1)。这些是 Shell 使用示例,不是产品测试命令。 diff --git a/docs/09-product-requirements-overview.md b/docs/09-product-requirements-overview.md index 9a6d691..f4b87eb 100644 --- a/docs/09-product-requirements-overview.md +++ b/docs/09-product-requirements-overview.md @@ -2,8 +2,8 @@ generated: true (请先修改 Gitea Wiki,禁止直接编辑本文件) wiki_page: Product-Requirements-Overview wiki_url: https://git.ilapage.cn/OPC/lexgo/wiki/Product-Requirements-Overview.- -wiki_revision: 77035d7811d6df3880b575e91d1ce224dec21e2e -synchronized_at: 2026-09-10T06:27:45Z +wiki_revision: fa9dbb8a07a83a6673e365fbbebb445e3ecc050e +synchronized_at: 2026-09-10T06:29:02Z # 产品需求总览 @@ -64,3 +64,7 @@ synchronized_at: 2026-09-10T06:27:45Z ## 更新时机 范围确认、实际实施状态变化或验收标准变化时更新索引;工单只有实际创建后才填写 URL。 + +## 轻量修改边界 + +目标明确的局部样式或布局、预期行为明确的小 Bug,以及不改变接口、数据结构和权限的单模块调整可直接实施,完成必要验证后报告即可,不为了留痕补建工单。完整独立需求和中高风险变化仍需工单。