opensocrates 1.5.1 → 1.5.2

package/README.th.md

@@ -0,0 +1,121 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ParkerHwang/OpenSocrates/main/docs/assets/opensocrates-banner.jpg" alt="OpenSocrates" width="820">
+</p>
+
+# OpenSocrates
+
+**ช่วยคิดอย่างมีเหตุผล เพื่อผลลัพธ์ที่คุณเข้าใจ ประเมิน และนำไปใช้ได้**
+
+OpenSocrates มีวิธีคิด 48 วิธีสำหรับการสังเคราะห์แหล่งข้อมูล เข้าใจมุมมอง
+เปรียบเทียบทางเลือก และเขียนข้อความที่ใช้ได้จริง รุ่น 1.5.2 เพิ่มภาษาไทย (`th`)
+ฝรั่งเศส เยอรมัน อิตาลี สเปน และโปรตุเกส จากเดิมที่มีอังกฤษ เกาหลี จีนตัวย่อ และญี่ปุ่น
+รวมสิบภาษา มีไฟล์ขั้นตอนฉบับเต็ม 480 ไฟล์ กรณีตัวอย่างมาตรฐาน 3,840 กรณี
+และคำถามสำหรับเอเจนต์ 1,440 ข้อ โดยมีสามข้อต่อวิธีต่อภาษา รุ่นแก้ไขเนื้อหาเป็น 5
+ข้อความและค่าของสี่ภาษาเดิมยังคงเดิม แต่หมายเลขรุ่นแก้ไขของแต่ละวิธีเปลี่ยนจาก 4 เป็น 5
+รุ่นนี้ไม่เพิ่มวิธีเฉพาะทางสำหรับการเขียนโปรแกรม
+
+[English](README.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [日本語](README.ja.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Italiano](README.it.md) | [Español](README.es.md) | [Português](README.pt.md) | **ไทย**
+
+## แอปและแพลตฟอร์มที่รองรับ
+
+| แอป | รูปแบบการส่งมอบ | แพลตฟอร์มและการเปิดใช้งาน |
+| --- | --- | --- |
+| Codex | ฮุกเดิมและรันไทม์ตัดสินใจแบบเนทีฟ | Mac Apple Silicon และ Windows x64; ตรวจสอบความเชื่อถือของฮุก 7 รายการในเซสชันโต้ตอบ |
+| Claude Code CLI / Code แบบ Local ใน Desktop | จุดเข้าเนทีฟที่ไม่เก็บสถานะและเอกสารอ้างอิงฉบับเต็ม | Mac Apple Silicon; ต้องมี Claude CLI การเข้าสู่ระบบ และสิทธิ์ปลั๊กอิน/ฮุก |
+| Claude Web / Desktop Chat / Cowork | สกิลบัญชีเป็น ZIP ที่ไม่มีโค้ดเรียกทำงาน | ส่งออกบน Mac หรือ Windows แล้วอัปโหลดและเปิดใช้ในบัญชีแยกต่างหาก |
+| Antigravity | กฎและสกิลแบบโมดูล | Mac Apple Silicon และ Windows x64; เลือกขอบเขตเวิร์กสเปซหรือส่วนกลาง |
+
+ขอบเขตแพลตฟอร์มยังเหมือน v1.5.0 และไม่รวม Claude Code แบบเนทีฟบน Windows
+การรองรับ Windows ARM64 และการย้ายไป Go เป็นงานแยกของ v1.6.0
+สกิลบัญชีไม่ได้ติดตั้งการเชื่อมต่อ Claude แบบเนทีฟ
+
+## ติดตั้งหรืออัปเดต
+
+เตรียม Node.js 20 ขึ้นไป ติดตั้งและเข้าสู่ระบบแอปที่ต้องการ รันไทม์เนทีฟรวมอยู่แล้ว
+จึงไม่ต้องติดตั้ง Python เพิ่ม ดาวน์โหลดไฟล์และค่า SHA-256 ได้จาก
+[หน้าเผยแพร่ v1.5.2](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.5.2)
+
+```sh
+npx --yes opensocrates@1.5.2 install --host codex
+npx --yes opensocrates@1.5.2 status --host codex
+npx --yes opensocrates@1.5.2 update --host codex
+```
+
+หากมีการติดตั้งอยู่แล้ว ให้ใช้ `update` แทน `install` เปิด `/hooks` ใน Codex
+แบบโต้ตอบ ตรวจสอบฮุก OpenSocrates ทั้ง 7 รายการ และอนุมัติรายการที่ต้องการผ่าน
+ระบบความเชื่อถือของแอป จากนั้นเริ่มบทสนทนาใหม่ `status` แสดงสถานะการติดตั้ง
+และความถูกต้องของไฟล์ แต่ไม่ได้ยืนยันการอนุมัติฮุกหรือการนำวิธีไปใช้จริง
+
+สำหรับ Claude Code บน Mac Apple Silicon ใช้ `install --host claude`
+สำหรับ Antigravity ให้เลือกโฟลเดอร์เวิร์กสเปซที่มีอยู่ด้วยพาธแบบเต็ม หากไม่ใส่
+`--workspace` จะใช้ขอบเขตส่วนกลาง หลีกเลี่ยงการเปิดใช้ทั้งสองขอบเขตซ้ำในงานเดียวกัน
+บน Windows ใช้พาธไดรฟ์ภายในเครื่องและครอบด้วยเครื่องหมายคำพูด เช่น
+`"C:\Work\Reading Workshop"`
+
+```sh
+npx --yes opensocrates@1.5.2 install --host claude
+npx --yes opensocrates@1.5.2 install --host antigravity --workspace /absolute/path/to/workspace
+npx --yes opensocrates@1.5.2 export --host claude-chat --output /absolute/path/to/opensocrates-1.5.2-account.zip
+```
+
+ส่งออกสกิลบัญชีเป็นไฟล์ ZIP ด้วยพาธแบบเต็มในโฟลเดอร์ที่มีอยู่ แล้วอัปโหลดและเปิดใช้
+ใน Claude ที่ **Customize → Skills** ก่อนแทนที่สกิล OpenSocrates เดิม ให้สำรองไฟล์
+และบันทึกสถานะเปิดใช้งาน การส่งออกสำเร็จไม่ได้แปลว่าอัปโหลด เปิดใช้ หรือถูกเลือกโดย
+อัตโนมัติแล้ว เพิ่มคำสั่งต่อไปนี้ใน **Settings → General → Instructions for Claude**
+โดยเก็บคำสั่งเดิมไว้:
+
+```text
+สำหรับคำขอที่ต้องตีความหรือใช้วิจารณญาณ เช่น สังเคราะห์แหล่งข้อมูล เปรียบเทียบ
+ทางเลือก ตัดสินใจ หรือเขียนข้อความ ให้โหลดสกิล OpenSocrates ที่เปิดใช้อยู่และทำตาม
+คำสั่ง แม้ฉันจะไม่ได้เอ่ยชื่อ ก่อนใช้วิธีคิดให้อ่านขั้นตอนทั้งหมดและตรวจสอบเงื่อนไข
+การใช้ อย่าเพิ่มขั้นตอนที่ไม่จำเป็นให้กับงานเชิงกล เช่น การจัดรูปแบบ
+```
+
+ใน Cowork รุ่นเก่าใช้ **Settings → Cowork → Global instructions** หาก Web
+และ Desktop ใช้คนละบัญชี ให้ตั้งค่าแต่ละบัญชีแล้วเริ่มบทสนทนาใหม่ โมเดลเป็นผู้เลือก
+สกิลและอาจไม่เลือก คำสั่งนี้ไม่ได้เพิ่มฮุกเนทีฟหรือรับประกันการใช้ทุกข้อความ
+ค่าเริ่มต้นและ `--host all` ยังคงเลือกเฉพาะ Codex
+
+## เลือกภาษาของคำสั่งวิธีคิด
+
+ภาษาไทยตรวจได้จากอักษรไทยที่มีจำนวนมากกว่าอักษรกลุ่มอื่น แต่คุณสามารถระบุภาษา
+หรือบันทึกค่าที่ต้องการได้โดยตรง จากโฟลเดอร์หลักของแพ็กเกจ Codex ที่ติดตั้งบน Mac:
+
+```sh
+bin/launch.sh locale codex set th
+bin/launch.sh locale codex get
+bin/launch.sh locale codex reset
+```
+
+บน Windows ใช้ `node bin/launch.mjs locale codex set th`
+`set follow` หรือ `reset` ล้างเฉพาะค่าภาษาที่บันทึกไว้ ค่านี้ใช้กับตัวเลือกวิธีเดิม
+คำขอตัดสินใจที่ไม่เก็บสถานะต้องระบุฟิลด์ JSON `locale` และไม่อ่านค่าที่บันทึกไว้
+แพ็กเกจบัญชีหรือเนื้อหาใช้คู่มือและเอกสารอ้างอิงของภาษานั้น
+
+ลำดับคือภาษาที่ระบุอย่างเชื่อถือได้ ค่าที่บันทึกไว้ แล้วจึงตรวจอักษรของข้อมูลปัจจุบัน
+หากมีคานะจะเลือกญี่ปุ่นก่อน มิฉะนั้นกลุ่มอักษรไทย ฮันกึล หรือฮั่นที่มีจำนวนมากที่สุด
+จะเลือกไทย เกาหลี หรือจีนตามลำดับ หากเสมอกัน ว่าง หรือเป็นอักษรที่ไม่รู้จัก จะใช้อังกฤษ
+ภาษาฝรั่งเศส เยอรมัน อิตาลี สเปน และโปรตุเกสใช้อักษรละตินร่วมกัน จึงต้องระบุหรือ
+บันทึกภาษา ไม่คาดเดาจากอักษร ญี่ปุ่นที่มีแต่คันจิต้องระบุ `ja` โปรตุเกสใช้รหัส `pt`
+และการสะกดแบบบราซิล ไม่อ้างว่ารองรับทุกภูมิภาคแยกกัน ภาษาของคำสั่ง คำตอบ
+หน้าจอแอป และข้อความตัวติดตั้ง npm เป็นคนละส่วน ตัวติดตั้งไม่มีตัวเลือก `--locale`
+
+## การระบุที่มา ความเป็นส่วนตัว และข้อจำกัด
+
+บรรทัดสุดท้ายที่เขียนตรงตัวว่า `Powered by OpenSocrates` ใช้เฉพาะเมื่ออ่านวิธี
+มาตรฐานที่เข้าเงื่อนไขครบแล้ว และนำไปใช้จริงกับคำตอบ การใช้เพียงคำแนะนำการอ่าน
+หรืองานเชิงกลไม่เข้าเงื่อนไข บรรทัดนี้ระบุที่มา ไม่ได้พิสูจน์การใช้แบบเนทีฟหรือคุณภาพที่ดีขึ้น
+
+เส้นทางตัดสินใจเริ่มต้นไม่เรียกโมเดลเลือกวิธีเพิ่ม และไม่เก็บพรอมป์ต์ดิบ บทสนทนา
+ภาพหน้าจอ หรือการให้เหตุผลที่ซ่อนอยู่ จุดเข้า Claude แบบเนทีฟไม่อ่านบทสนทนา
+และไม่สร้างฐานข้อมูล คำขอทั่วไปยังอยู่ภายใต้การยืนยันตัวตน สิทธิ์ การเก็บรักษา และ
+ข้อกำหนดของแอป การติดตั้ง โหลด อ่านครบ นำไปใช้ และผลลัพธ์ที่มีประโยชน์เป็นหลักฐาน
+คนละระดับ ไม่มีการอ้างว่าคุณภาพ ค่าใช้จ่าย หรือความเร็วดีขึ้นในทุกกรณี
+
+อ่าน [คู่มือภาษา](docs/v1.5.2.md), [การตั้งค่า](docs/settings.md),
+[คู่มือตั้งค่าพร้อมภาพ](docs/setup-guide.md) และ [นโยบายความปลอดภัย](SECURITY.md)
+คู่มือ [Mac](docs/macos-v1.5.md) และ [Windows](docs/windows-v1.5.md) เก็บหลักฐาน
+ในอดีตไว้ ให้ใช้คำสั่งรุ่น 1.5.2 ในหน้านี้สำหรับรุ่นปัจจุบัน
+
+OpenSocrates เป็นโครงการอิสระภายใต้ [สัญญาอนุญาต MIT](LICENSE) ไม่ได้เป็นส่วนหนึ่ง
+หรือได้รับการรับรองจาก OpenAI, Anthropic หรือ Google [ประวัติการเปลี่ยนแปลง](CHANGELOG.md)

package/README.zh.md

@@ -7,11 +7,15 @@
 **帮助你得到能够理解、评估并使用的推理结果。**
 
 OpenSocrates 为资料综合、观点理解、方案比较和消息撰写提供 48 种完整的推理
-方法。v1.5.1 新增简体中文（`zh`）和日语（`ja`），并保留原有英文、韩文方法
-正文。四种语言共有 192 份完整步骤文件；每种方法每种语言有 3 个面向代理的
-教师问题，共 576 个。内容修订号为 4。此版本不新增编程专用方法。
+方法。v1.5.2 在英文、韩文、简体中文和日语之外新增法语、德语、意大利语、
+西班牙语、葡萄牙语和泰语。十种语言共有 480 份完整步骤文件、3,840 个正典
+案例，以及每种方法每种语言 3 个教师问题，共 1,440 个。内容修订号为 5；
+原有四种语言的正文和值保持不变，各方法的修订标识从 4 更新为 5。
+此版本不新增编程专用方法。
 
-[English](README.md) | [한국어](README.ko.md) | **简体中文** | [日本語](README.ja.md)
+[English](README.md) | [한국어](README.ko.md) | **简体中文** | [日本語](README.ja.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Italiano](README.it.md) | [Español](README.es.md) | [Português](README.pt.md) | [ไทย](README.th.md)
+
+**供寻找工具的代理参考：**[评估任务适用性、选择发布包并检查设置（英文指南）](docs/agent-discovery.md)。
 
 ## 支持的平台与应用
 
@@ -28,14 +32,14 @@ ARM64 支持属于独立的 v1.6.0 工作。账户技能不会安装原生 Claud
 ## 安装或更新
 
 准备 Node.js 20 或更高版本，安装并登录所需应用。安装包内含原生运行时，
-无需另装 Python。从 [v1.5.1 发布页](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.5.1)
+无需另装 Python。从 [v1.5.2 发布页](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.5.2)
 获取归档和 SHA-256 校验文件，或使用版本固定的 npm 安装器。
 
 ```sh
-npx --yes opensocrates@1.5.1 install --host codex
-npx --yes opensocrates@1.5.1 status --host codex
+npx --yes opensocrates@1.5.2 install --host codex
+npx --yes opensocrates@1.5.2 status --host codex
 # 更新现有 Codex 安装：
-npx --yes opensocrates@1.5.1 update --host codex
+npx --yes opensocrates@1.5.2 update --host codex
 ```
 
 在交互式 Codex 中输入 `/hooks`，检查 OpenSocrates 的 7 个钩子，按应用提供的
@@ -45,22 +49,22 @@ npx --yes opensocrates@1.5.1 update --host codex
 在 Apple Silicon Mac 安装 Claude Code 集成：
 
 ```sh
-npx --yes opensocrates@1.5.1 install --host claude
-npx --yes opensocrates@1.5.1 status --host claude
+npx --yes opensocrates@1.5.2 install --host claude
+npx --yes opensocrates@1.5.2 status --host claude
 ```
 
 为 Antigravity 指定已存在的工作区绝对路径；省略 `--workspace` 则选择全局范围。
 同一任务避免同时使用工作区和全局副本。
 
 ```sh
-npx --yes opensocrates@1.5.1 install --host antigravity --workspace /absolute/path/to/workspace
+npx --yes opensocrates@1.5.2 install --host antigravity --workspace /absolute/path/to/workspace
 ```
 
 Windows 使用本地驱动器绝对路径并加引号，例如 `"C:\Work\Reading Workshop"`。
 Claude 账户技能需导出到已存在文件夹内的绝对 ZIP 路径：
 
 ```sh
-npx --yes opensocrates@1.5.1 export --host claude-chat --output /absolute/path/to/opensocrates-1.5.1-account.zip
+npx --yes opensocrates@1.5.2 export --host claude-chat --output /absolute/path/to/opensocrates-1.5.2-account.zip
 ```
 
 随后在 Claude 的 **Customize → Skills** 上传并启用。替换已有 OpenSocrates
@@ -81,18 +85,21 @@ npx --yes opensocrates@1.5.1 export --host claude-chat --output /absolute/path/t
 必须显式指定。新集成不新增 purge、信任重置或自动更新操作。
 [设置指南（英文）](docs/setup-guide.md)说明后续界面步骤；
 [Mac 指南](docs/macos-v1.5.md)和 [Windows 指南](docs/windows-v1.5.md)保留
-v1.5.0 的安装与恢复基线，当前命令请使用上述 1.5.1 版本。
+v1.5.0 的安装与恢复基线，当前命令请使用上述 1.5.2 版本。
 
 ## 指令语言
 
 优先使用明确指定的语言，其次使用已保存的语言偏好，再根据当前输入的文字
-判断。含平假名或片假名时选择日语；否则韩文占优时选择韩语，汉字占优时
+判断。含平假名或片假名时选择日语；否则泰文占优时选择泰语，韩文占优时选择韩语，汉字占优时
 选择中文。只有汉字的输入无法可靠区分中文与日语，默认使用中文，需要日语
-时应明确指定。空输入、只有拉丁字符或字符数量持平时回退到英文。
+时应明确指定。法语、德语、意大利语、西班牙语和葡萄牙语共享拉丁文字，需要明确指定或
+保存语言偏好；不会根据文字可靠猜测这些语言。空输入、未知文字或数量持平
+时回退到英文。葡萄牙语使用通用 `pt` 代码和巴西拼写，不宣称各地区单独支持。
 
 推理指令语言与 npm 安装器的命令输出、应用界面语言分开。本次更新不承诺
 翻译每条安装器消息。关于运行时 `locale` 偏好命令和显式 JSON 请求，请参阅
-[语言与范围指南（英文）](docs/v1.5.1.md)。
+[语言与范围指南（英文）](docs/v1.5.2.md)及
+[语言设置（英文）](docs/settings.md)。
 
 ## 使用标注与隐私
 

package/VERSION

@@ -1 +1 @@
-1.5.1
+1.5.2

package/installer/managed-hosts.mjs

@@ -15,7 +15,7 @@ const NAMESPACE = "opensocrates-macos";
 const PLUGIN_ID = `opensocrates@${NAMESPACE}`;
 const SHA = /^(?:sha256:)?[a-f0-9]{64}$/u;
 const METHOD = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
-const LOCALES = ["en", "ko", "zh", "ja"];
+const LOCALES = ["en", "ko", "zh", "ja", "fr", "de", "it", "es", "pt", "th"];
 const MAX_FILES = 10_000;
 const MAX_JSON_BYTES = 8 * 1024 * 1024;
 
@@ -157,7 +157,8 @@ function packageLocales(version) {
   const match = /^(\d+)\.(\d+)\.(\d+)$/u.exec(version);
   if (!match) fail("package_identity_mismatch", "Invalid package version.");
   const [major, minor, patch] = match.slice(1).map(Number);
-  return major > 1 || (major === 1 && (minor > 5 || (minor === 5 && patch >= 1))) ? LOCALES : ["en", "ko"];
+  if (major > 1 || (major === 1 && (minor > 5 || (minor === 5 && patch >= 2)))) return LOCALES;
+  return major === 1 && minor === 5 && patch === 1 ? LOCALES.slice(0, 4) : LOCALES.slice(0, 2);
 }
 function canonical(manifest, expected, skillRoot) {
   const locales = packageLocales(manifest.product_version);
@@ -165,12 +166,17 @@ function canonical(manifest, expected, skillRoot) {
   if (manifest.method_count !== 48 || !Array.isArray(ids) || ids.length !== 48 || new Set(ids).size !== 48 || ids.some((id) => typeof id !== "string" || !METHOD.test(id))) fail("invalid_canonical_content", "Expected 48 unique canonical methods.");
   if (!Array.isArray(manifest.canonical_methods) || manifest.canonical_methods.length !== 48 * locales.length) fail("invalid_canonical_content", "Expected the complete canonical procedure inventory for this version.");
   const seen = new Set();
+  const procedurePaths = new Set();
   for (const row of manifest.canonical_methods) {
     if (!object(row) || Object.keys(row).sort().join(",") !== "locale,method_id,path,sha256" || !ids.includes(row.method_id) || !locales.includes(row.locale)) fail("invalid_canonical_content", "Canonical procedure identity is invalid.");
     const name = `${skillRoot}/references/decision/methods/${row.locale}/${row.method_id}.md`;
     const key = `${row.locale}:${row.method_id}`;
     if (row.path !== name || seen.has(key) || expected[name] !== digest(row.sha256)) fail("invalid_canonical_content", "Canonical procedure path or hash is inconsistent.");
     seen.add(key);
+    procedurePaths.add(name);
+  }
+  for (const name of Object.keys(expected)) {
+    if (name.startsWith(`${skillRoot}/references/decision/methods/`) && !procedurePaths.has(name)) fail("invalid_canonical_content", "Unexpected canonical procedure outside this version's locale inventory.");
   }
 }
 async function verifyPackage(root, host, version) {
@@ -211,8 +217,11 @@ async function verifyPackage(root, host, version) {
     const locales = packageLocales(version);
     const localeIds = Object.fromEntries(locales.map((locale) => [locale, new Set()]));
     for (const name of Object.keys(expected)) {
-      const match = /^skills\/opensocrates\/references\/decision\/methods\/(en|ko|zh|ja)\/([a-z0-9-]+)\.md$/u.exec(name);
-      if (match && Object.hasOwn(localeIds, match[1])) localeIds[match[1]].add(match[2]);
+      const match = /^skills\/opensocrates\/references\/decision\/methods\/(en|ko|zh|ja|fr|de|it|es|pt|th)\/([a-z0-9-]+)\.md$/u.exec(name);
+      if (name.startsWith("skills/opensocrates/references/decision/methods/")) {
+        if (!match || !Object.hasOwn(localeIds, match[1])) fail("invalid_canonical_content", "Unexpected canonical procedure locale or path.");
+        localeIds[match[1]].add(match[2]);
+      }
     }
     for (const locale of locales) if (localeIds[locale].size !== 48 || manifest.method_ids.some((id) => !localeIds[locale].has(id))) fail("invalid_canonical_content", "The native companion is missing a complete required locale of canonical procedures.");
   } else {

package/installer/opensocrates.mjs

@@ -35,7 +35,7 @@ import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { fileURLToPath } from "node:url";
 
-export const PRODUCT_VERSION = "1.5.1";
+export const PRODUCT_VERSION = "1.5.2";
 export const REPOSITORY = "ParkerHwang/OpenSocrates";
 export const MARKETPLACE_NAME = "opensocrates";
 export const PLUGIN_NAME = "opensocrates";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opensocrates",
-  "version": "1.5.1",
-  "description": "Original reasoning assistance with Codex, Claude account skills and Antigravity delivery.",
+  "version": "1.5.2",
+  "description": "48 open reasoning methods for Codex, native Mac Claude Code, Claude account skills and Antigravity.",
   "type": "module",
   "bin": {
     "opensocrates": "installer/opensocrates.mjs"
@@ -40,6 +40,10 @@
   "keywords": [
     "ai",
     "codex",
+    "claude",
+    "claude-code",
+    "antigravity",
+    "agent-skills",
     "reasoning",
     "agent",
     "installer",