diff --git a/README.md b/README.md index 5228d8e..4cd16a4 100644 --- a/README.md +++ b/README.md @@ -71,7 +71,7 @@ 从零开始

-[📚 相关文档](#-相关文档与资源) +[📋 工具资源](#-器-工具与资源) [🚀 从零开始](#-从零开始) [🎯 入门指南](#-入门指南) [⚙️ 完整设置流程](#️-完整设置流程) @@ -234,6 +234,22 @@ * [**二哥的Java进阶之路**](https://javabetter.cn/): 包含多种开发工具的详细配置教程。 * [**虚拟卡**](https://www.bybit.com/cards/?ref=YDGAVPN&source=applet_invite): 可用于注册云服务等需要国际支付的场景。 +### 交流社区 + +* [**Telegram 交流群**](https://t.me/glue_coding): Vibe Coding 中文交流群 +* [**Telegram 频道**](https://t.me/tradecat_ai_channel): 项目更新与资讯 + +### 项目内部文档 + +* [**prompts-library 工具说明**](./libs/external/prompts-library/): 支持 Excel 与 Markdown 格式互转，包含数百个精选提示词。 +* [**coding_prompts 集合**](./i18n/zh/prompts/coding_prompts/): 适用于 Vibe Coding 流程的专用提示词。 +* [**系统提示词构建原则**](./i18n/zh/documents/方法论与原则/系统提示词构建原则.md): 构建高效 AI 系统提示词的综合指南。 +* [**开发经验总结**](./i18n/zh/documents/方法论与原则/开发经验.md): 变量命名、文件结构、编码规范、架构原则等。 +* [**通用项目架构模板**](./i18n/zh/documents/模板与资源/通用项目架构模板.md): 多种项目类型的标准目录结构。 +* [**Augment MCP 配置文档**](./i18n/zh/documents/教程与指南/auggie-mcp配置文档.md): Augment 上下文引擎配置说明。 +* [**system_prompts 集合**](./i18n/zh/prompts/system_prompts/): AI 开发的系统提示词，含多版本开发规范。 +* [**外部资源聚合**](./i18n/zh/documents/外部资源聚合/): GitHub 精选仓库、AI 工具平台、提示词资源汇总。 + --- @@ -253,37 +269,6 @@ -
-📚 相关文档与资源 - -## 📚 相关文档与资源 - -* **交流社区**: - * [Telegram 交流群](https://t.me/glue_coding) - * [Telegram 频道](https://t.me/tradecat_ai_channel) -* **个人分享**: - * [我的学习经验](./i18n/zh/documents/方法论与原则/学习经验.md) - * [编程书籍推荐](./i18n/zh/documents/模板与资源/编程书籍推荐.md) -* **核心资源**: - * [**元提示词库**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220): 用于生成提示词的高级提示词集合。 - * [**元技能 (Meta-Skill)**](./i18n/zh/skills/claude-skills/SKILL.md): 用于生成 Skills 的 Skill。 - * [**技能库 (Skills)**](./i18n/zh/skills): 可直接集成的模块化技能仓库。 - * [**技能生成器**](https://github.com/yusufkaraaslan/Skill_Seekers): 将任何资料转化为 Agent 可用技能的工具。 - * [**在线提示词数据库**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=2093180351#gid=2093180351&range=A1): 包含数百个适用于各场景的用户及系统提示词的在线表格。 - * [**第三方系统提示词仓库**](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools): 汇集了多种 AI 工具的系统提示词。 -* **项目内部文档**: - * [**prompts-library 工具说明**](./libs/external/prompts-library/): 该工具支持在 Excel 和 Markdown 格式之间转换提示词，并包含数百个精选提示词。 - * [**coding_prompts 集合**](./i18n/zh/prompts/coding_prompts/): 适用于 Vibe Coding 流程的专用提示词。 - * [**系统提示词构建原则**](./i18n/zh/documents/方法论与原则/系统提示词构建原则.md): 关于如何构建高效、可靠的 AI 系统提示词的综合指南。 - * [**开发经验总结**](./i18n/zh/documents/方法论与原则/开发经验.md): 包含变量命名、文件结构、编码规范、架构原则等实践经验。 - * [**通用项目架构模板**](./i18n/zh/documents/模板与资源/通用项目架构模板.md): 提供多种项目类型的标准目录结构与最佳实践。 - * [**Augment MCP 配置文档**](./i18n/zh/documents/教程与指南/auggie-mcp配置文档.md): Augment 上下文引擎的详细配置说明。 - * [**system_prompts 集合**](./i18n/zh/prompts/system_prompts/): 用于指导 AI 开发的系统提示词，包含多个版本的开发规范与思维框架。 - ---- - -
-
项目目录结构概览 @@ -465,15 +450,16 @@ graph TB gantt title 项目发展路线图 dateFormat YYYY-MM - section 近期 (2025) - 补全演示GIF与示例项目: active, 2025-12, 15d - prompts 索引自动生成脚本: 2025-12, 10d - section 中期 (2026 Q1) + section 进行中 (2025 Q4) + 补全演示GIF与示例项目: active, 2025-12, 30d + 外部资源聚合完善: active, 2025-12, 20d + section 近期 (2026 Q1) + prompts 索引自动生成脚本: 2026-01, 15d 一键演示/验证 CLI 工作流: 2026-01, 15d - 备份脚本增加快照与校验: 2026-01, 10d - section 远期 (2026 Q1-Q2) - 模板化示例项目集: 2026-02, 20d - 多模型对比与评估基线: 2026-02, 20d + 备份脚本增加快照与校验: 2026-02, 10d + section 中期 (2026 Q2) + 模板化示例项目集: 2026-03, 30d + 多模型对比与评估基线: 2026-04, 30d ``` --- @@ -703,9 +689,9 @@ gantt @0XBard_thomas | @Pluvio9yte | @xDinoDeer | -@geekbb -@GitHub_Daily -@BiteyeCN +@geekbb | +@GitHub_Daily | +@BiteyeCN | @CryptoJHK

diff --git a/i18n/zh/documents/项目实战经验/fate-engine-dev/telegram Markdown 代码块格式修复记录 2025-12-15.md b/i18n/zh/documents/项目实战经验/fate-engine-dev/telegram Markdown 代码块格式修复记录 2025-12-15.md new file mode 100644 index 0000000..d5317af --- /dev/null +++ b/i18n/zh/documents/项目实战经验/fate-engine-dev/telegram Markdown 代码块格式修复记录 2025-12-15.md @@ -0,0 +1,41 @@ +# telegram Markdown 代码块格式修复记录 2025-12-15 + +## 问题 + +排盘完成后发送消息报错： +``` +❌ 排盘失败: Can't parse entities: can't find end of the entity starting at byte offset 168 +``` + +## 原因 + +`bot.py` 中 `header` 消息的 Markdown 代码块格式错误。 + +原代码使用字符串拼接，在 ``` 后面加了 `\n`，导致 Telegram Markdown 解析器无法正确识别代码块边界： + +```python +# 错误写法 +header = ( + "```\n" + f"{filename}\n" + "```\n" +) +``` + +## 修复 + +改用三引号字符串，确保 ``` 单独成行： + +```python +# 正确写法 +header = f"""报告见附件 +``` +{filename} +{ai_filename} +``` +""" +``` + +## 修改文件 + +- `services/telegram-service/src/bot.py` 第 293-308 行 diff --git a/i18n/zh/documents/项目实战经验/fate-engine-dev/真太阳时修正经验.md b/i18n/zh/documents/项目实战经验/fate-engine-dev/真太阳时修正经验.md new file mode 100644 index 0000000..845c863 --- /dev/null +++ b/i18n/zh/documents/项目实战经验/fate-engine-dev/真太阳时修正经验.md @@ -0,0 +1,32 @@ +# 真太阳时修正经验（2025-12-16） + +## 背景 +- 新疆用户反馈：报告中“阳历先减2小时，真太阳时再减2小时”，四柱/神煞与对照工具不一致。 +- 根因：出生时间先在调用方计算了一次真太阳时，然后 `BaziCalculator` 内部再次计算，形成“双重扣减”。 + +## 现行策略（已上线） +- **唯一修正点**：所有真太阳时只在 `BaziCalculator` 内部执行一次。 +- **时间基线**：入口出生时间一律视为北京时间（Asia/Shanghai），用 `ensure_cn` 赋予时区后再做真太阳时修正。 +- **计算时间**：核心与扩展模块全部基于 `calc_dt`（真太阳时或用户禁用时的原始北京时），保持一致性。 +- **展示时间**：UI/进度/日志/队列/Help 统一用北京时间；报告字段 `trueSolarTime` 展示经度修正后的时间。 + +## 涉及改动（要点） +- `utils/timezone.py`: `now_cn/ensure_cn/fmt_cn` 固定 Asia/Shanghai。 +- `bot.py`: 去掉外层 `calc_true_solar_time`；时间显示用 `fmt_cn(now_cn())`；队列时间戳用北京时间。 +- `main.py`: API 不再预先修正；`trueSolarTime` 取自 `BaziCalculator` 内部结果。 +- `bazi_calculator.py`: 新增 `use_true_solar_time`，统一 `calc_dt`；扩展模块/命卦/小运等改用 `calc_dt`；元数据时间用北京时间。 +- `liuyao.py`, `qimen.py`, `system_optimization.py`: 时间戳统一北京时间。 +- 文档：`AGENTS.md` 记录“时区统一 Asia/Shanghai”。 + +## 抽象问题与防范 +1. **时区假设不一致**：Naive datetime 若按本地解析会漂移；统一假设“输入即北京时”，先补时区再计算。 +2. **重复校正**：真太阳时公式只允许出现一次；调用链上严禁二次修正。 +3. **基准混用**：展示用北京时，计算用真太阳时（单次修正）。若新增模块，必须复用 `calc_dt`，不得自算。 + +## 验证建议 +- 用新疆样例（乌鲁木齐 87E，08:00）跑一次：阳历应保持 08:00，北京时显示 08:00，真太阳时约 05:4x，仅扣一次。 +- 比对“测测”等对照工具的四柱/神煞，应一致。 + +## 后续准则 +- 如需对外提供 UTC/其他时区，先转为北京时，再按经度做真太阳时，仍然只修正一次。 +- 新增集成模块时，禁止各自重复计算真太阳时；统一接受 `calc_dt`。